/// changelog
Changelog
Notable changes to @protocore/pds, newest first. The system follows semantic versioning — breaking changes land only in a major release.
v1.6.9Initial release2026-07-03
The first public release of the Protocore Design System — the complete web library, theming, and machine-readable docs.
Components
- 101 components across layout, typography, inputs, media, cards, data-display, feedback, overlay, navigation, charts, and utilities.
- 6 hooks —
useTheme,useMediaQuery,useControllableState,useCopyToClipboard,useReducedMotion, anduseDensity. - A frozen component contract:
variant/size/tonevocabulary,classNamepassthrough,asChildpolymorphism, and full keyboard a11y.
Mobile (preview)
@protocore/pds-mobile(preview): 24 core components — the React Native sibling library (Button, IconButton, Text, Heading, Display, Card, Input, Field, Switch, Badge, Tag, Chip, StatusDot, Callout, InlineMessage, Spinner, LoadingSkeleton, EmptyState, and more), built onPressable/StyleSheetwith a matchingPdsProviderand theme.- No device-level QA yet — the API mirrors the web components but the package ships as a preview. See Installation and the Mobile switch on each component page.
Theming
- Dark and light themes on a shared token layer, dark-first by design.
- Five curated accents (green, blue, red, amber, violet), a compact density mode, and environment chrome — all driven by
data-*attributes.
Charts
- An optional
@protocore/pds/chartssubpath withrechartsas an opt-in peer, so chart-free apps carry no chart dependency.
AI & docs
- Machine-readable docs —
llms.txt,llms-full.txt, the/ai/registry.jsonand/ai/<category>/<slug>.mdendpoints, and Copy-for-LLM on every page. - An MCP server,
@protocore/pds-mcp, exposing the system as tools. See Building with AI.