@hirobius/design-system 0.21.0 → 0.23.0

package/mcp/guide.mjs

@@ -13,6 +13,8 @@
  * scripts/__tests__/generate-agents-md.test.mjs enforces it.
  */
 
+import { CORE_COMPONENTS } from './core-set.mjs';
+
 /** Hooks are not components, so component-api.json has no entry for them. */
 export const HOOKS = {
   useToast: {
@@ -257,59 +259,14 @@ export const INTENTS = [
 ];
 
 /**
- * The ratified core set (scripts/lib/core-components.mjs, hds#254). Copied, not
- * imported, because scripts/ does not ship; scripts/__tests__/generate-agents-md.test.mjs
- * pins the two together.
+ * The recommended set: the ratified core (mcp/core-set.mjs, hds#254) plus every
+ * component a need above names, hooks excluded. This is a different set from the
+ * ratified core: it adds the patterns and layout parts the guide steers agents to
+ * (Page, MetricTiles, ...). list_core and AGENTS.md show this one and say so; the
+ * manifest `core` flag, llms.txt and SKILL.md show the ratified core.
  */
-export const RATIFIED_CORE = [
-  'Alert',
-  'Avatar',
-  'Badge',
-  'Box',
-  'Breadcrumb',
-  'Button',
-  'Card',
-  'Checkbox',
-  'Combobox',
-  'Container',
-  'Dialog',
-  'Disclosure',
-  'Divider',
-  'EmptyState',
-  'Field',
-  'Grid',
-  'HdsRouterProvider',
-  'HdsThemeProvider',
-  'Icon',
-  'InlineLink',
-  'Input',
-  'Kbd',
-  'Menu',
-  'Pagination',
-  'Popover',
-  'Progress',
-  'Radio',
-  'SegmentedControl',
-  'Select',
-  'Skeleton',
-  'Slider',
-  'Spinner',
-  'Stack',
-  'Surface',
-  'Table',
-  'Tabs',
-  'Tag',
-  'Text',
-  'Textarea',
-  'ToastProvider',
-  'Toggle',
-  'Tooltip',
-  'VisuallyHidden',
-];
-
-/** The core set agents should prefer: the ratified core plus every `use` above, hooks excluded. */
-export function coreComponents() {
-  const names = new Set(RATIFIED_CORE);
+export function recommendedComponents() {
+  const names = new Set(CORE_COMPONENTS);
   for (const intent of INTENTS) for (const name of intent.use) if (!HOOKS[name]) names.add(name);
   return [...names].sort();
 }

package/package.json

@@ -20,7 +20,7 @@
   "author": "Adrian Milsap",
   "license": "SEE LICENSE IN NOTICE.md",
   "private": false,
-  "version": "0.21.0",
+  "version": "0.23.0",
   "engines": {
     "node": ">=20",
     "pnpm": ">=8"
@@ -110,6 +110,12 @@
     "DESIGN.md",
     "CONSUMING.md",
     "docs/CONSUMING.md",
+    "UPGRADING.md",
+    "MIGRATIONS.md",
+    "CHANGELOG.md",
+    "upgrade/schema.json",
+    "upgrade/index.json",
+    "upgrade/releases/",
     "src/app/data/component-api.json",
     "codemods/patterns-subpath.mjs",
     "codemods/patterns-subpath.names.json",
@@ -119,6 +125,14 @@
     "codemods/jsx-fold.mjs",
     "codemods/not-found-pattern.mjs",
     "codemods/tile-grid.mjs",
+    "codemods/upgrade.mjs",
+    "codemods/registry.mjs",
+    "codemods/lib/atomic-write.mjs",
+    "codemods/lib/installed-version.mjs",
+    "codemods/lib/project.mjs",
+    "codemods/lib/record.mjs",
+    "codemods/lib/scan.mjs",
+    "codemods/lib/semver.mjs",
     "AGENTS.md",
     "mcp/",
     "scripts/eslint-plugin-hds/index.mjs",
@@ -227,6 +241,7 @@
     "pixelmatch": "^7.1.0",
     "playwright": "^1.58.2",
     "pngjs": "^7.0.0",
+    "postcss": "8.5.10",
     "prettier": "^3.8.3",
     "publint": "^0.3.21",
     "react": "18.3.1",
@@ -254,7 +269,9 @@
     "hds-prefix": "codemods/hds-prefix.mjs",
     "hds-not-found-pattern": "codemods/not-found-pattern.mjs",
     "hds-tile-grid": "codemods/tile-grid.mjs",
-    "hds-mcp": "mcp/hds-mcp.mjs"
+    "hds-mcp": "mcp/hds-mcp.mjs",
+    "design-system": "codemods/upgrade.mjs",
+    "hds-upgrade": "codemods/upgrade.mjs"
   },
   "scripts": {
     "_comment:a11y-high-value": "The following check:* validators are high-value accessibility checks that catch real violations (check:focus found 1 missing focus class). Kept dormant/manual-only to avoid pre-commit performance regression. Candidates to wire into pretest after CI stability review.",
@@ -270,13 +287,13 @@
     "audit:sidecar": "node scripts/generate-security-posture.mjs",
     "audit:style-dictionary": "bash scripts/poc/style-dictionary-poc/run.sh",
     "build-storybook": "storybook build",
-    "build:lib": "vite build -c vite.config.lib.ts && pnpm build:types && node scripts/build-vars-css.mjs && node scripts/build-fonts-css.mjs && node scripts/build-styles-css.mjs && node scripts/build-static-css.mjs",
+    "build:lib": "vite build -c vite.config.lib.ts && pnpm build:types && node scripts/build-vars-css.mjs && node scripts/build-fonts-css.mjs && node scripts/build-styles-css.mjs && node scripts/build-static-css.mjs && node scripts/build-css-contract.mjs",
     "build:types": "tsc -p tsconfig.dts.json && node scripts/strip-dts-side-effects.mjs && node scripts/add-dts-extensions.mjs",
     "catalog": "node scripts/generate-visual-catalog.mjs",
     "changelog:generate": "node scripts/generate-changelog.mjs",
     "changeset": "changeset",
     "changeset:add": "changeset",
-    "changeset:version": "changeset version && node scripts/audit-component-integrity.mjs --api --update-baseline",
+    "changeset:version": "changeset version && pnpm build:lib && node scripts/upgrade/compile.mjs --release && node scripts/audit-component-integrity.mjs --api --update-baseline",
     "check": "pnpm check:full",
     "check:a11y": "pnpm lint --rule '{\"jsx-a11y/alt-text\":\"error\",\"jsx-a11y/img-redundant-alt\":\"error\"}'",
     "check:attributions": "node scripts/check-attributions.mjs",
@@ -297,7 +314,7 @@
     "check:figma-coverage": "node scripts/check-figma-coverage.mjs",
     "check:figma-drift": "node scripts/check-figma-drift.mjs",
     "check:figma-mapping": "node scripts/check-figma-mapping.mjs",
-    "check:figma-staging-urls": "node scripts/check-figma-staging-urls.mjs",
+    "check:figma-retired-keys": "node scripts/check-figma-retired-keys.mjs",
     "check:focus": "node scripts/check-focus-states.mjs",
     "check:font-files": "node scripts/check-typography-discipline.mjs --font-files-only",
     "check:fonts": "node scripts/check-typography-discipline.mjs --fonts-only",
@@ -327,7 +344,7 @@
     "check:secrets": "node scripts/check-secrets.mjs",
     "check:security": "node scripts/check-security-baseline.mjs",
     "check:semantic-report": "node scripts/audit-tokens.mjs --report-only",
-    "check:size": "pnpm build:lib && node scripts/build-button-probe.mjs && size-limit",
+    "check:size": "pnpm build:lib && node scripts/build-button-probe.mjs && pnpm size-limit",
     "check:spacing": "node scripts/check-hardcoded-spacing.mjs",
     "check:spacing-vocabulary": "node scripts/check-spacing-vocabulary.mjs",
     "check:story-coverage": "node scripts/check-story-coverage.mjs",
@@ -374,7 +391,6 @@
     "figma:native-import": "node scripts/build-figma-native-import.mjs",
     "figma:push": "node scripts/figma-push.mjs",
     "figma:snapshot": "node scripts/figma-snapshot.mjs",
-    "figma:staging-inventory": "node scripts/generate-staging-inventory.mjs",
     "guardrail:sweep": "node scripts/guardrail-sweep.mjs",
     "harvest:design-md": "node scripts/harvest-design-md.mjs",
     "hds:new": "node scripts/scaffold-component.mjs",
@@ -393,7 +409,7 @@
     "prebuild-storybook": "node scripts/generate-component-api.mjs",
     "prebuild:lib": "node scripts/generate-component-api.mjs",
     "prestorybook": "node scripts/generate-component-api.mjs",
-    "pretest": "node scripts/validate-manifest.mjs && node scripts/check-manifest-drift.mjs && node scripts/check-manifest-schema-semver.mjs && node scripts/audit-component-integrity.mjs --completeness && node scripts/audit-component-integrity.mjs --api && node scripts/check-source-canon.mjs && node scripts/check-binding-drift.mjs && node scripts/check-registry.mjs && node scripts/check-tenant-tokens.mjs && node scripts/check-props-exports.mjs && knip --no-exit-code && node scripts/check-dark-alias-flip.mjs && node scripts/check-focus-states.mjs && node scripts/generate-staging-inventory.mjs --check && node scripts/generate-consumer-skill.mjs --check && node scripts/generate-agents-md.mjs --check && node scripts/check-deprecations.mjs && node scripts/upgrade/schema.mjs --check && node scripts/check-docs.mjs && node --test scripts/check-docs.selftest.mjs",
+    "pretest": "node scripts/validate-manifest.mjs && node scripts/check-manifest-drift.mjs && node scripts/check-manifest-schema-semver.mjs && node scripts/audit-component-integrity.mjs --completeness && node scripts/audit-component-integrity.mjs --api && node scripts/check-source-canon.mjs && node scripts/check-binding-drift.mjs && node scripts/check-registry.mjs && node scripts/check-tenant-tokens.mjs && node scripts/check-props-exports.mjs && knip --no-exit-code && node scripts/check-dark-alias-flip.mjs && node scripts/check-focus-states.mjs && node scripts/generate-consumer-skill.mjs --check && node scripts/generate-agents-md.mjs --check && node scripts/check-deprecations.mjs && node scripts/upgrade/schema.mjs --check && node scripts/upgrade/compile.mjs --check && node scripts/check-docs.mjs && node --test scripts/check-docs.selftest.mjs && node scripts/check-upgrade-ledger.mjs",
     "pretypecheck": "node scripts/audit-tokens.mjs --report-only",
     "preview:build": "vite build --config preview/vite.config.mjs",
     "promote": "node scripts/promote.mjs",
@@ -401,11 +417,11 @@
     "release": "pnpm build:lib && pnpm smoke:consumer --skip-build && changeset publish",
     "scaffold:component": "node scripts/scaffold-component.mjs",
     "scaffold:tenant": "node scripts/scaffold-tenant.mjs",
-    "size-limit": "size-limit --config .size-limit.cjs",
+    "size-limit": "node scripts/run-size-limit.mjs",
     "layout-contract:generate": "node scripts/generate-layout-contract.mjs",
     "status:touch": "node scripts/status-touch.mjs",
     "status:fold": "node scripts/status-fold.mjs",
-    "smoke:consumer": "node scripts/smoke-consumer.mjs && node scripts/check-published-types.mjs && node scripts/check-rsc-directives.mjs && node scripts/check-pack-contents.mjs",
+    "smoke:consumer": "node scripts/smoke-consumer.mjs && node scripts/check-published-types.mjs && node scripts/check-rsc-directives.mjs && node scripts/check-pack-contents.mjs && node scripts/check-upgrade-css.mjs",
     "storybook": "storybook dev -p 6006",
     "storybook:deploy": "node scripts/deploy-storybook.mjs",
     "sync": "node scripts/build-tokens.mjs && node scripts/audit-tokens.mjs --forbidden && node scripts/build-handoff.mjs && node scripts/build-design-md.mjs && node scripts/build-figma-variables.mjs",
@@ -432,6 +448,7 @@
     "upgrade:consumers": "node scripts/upgrade/consumers.mjs",
     "codemod:names": "node scripts/build-codemod-pattern-names.mjs",
     "agents:generate": "node scripts/generate-agents-md.mjs",
-    "check:agents-md": "node scripts/generate-agents-md.mjs --check"
+    "check:agents-md": "node scripts/generate-agents-md.mjs --check",
+    "upgrade:note": "node scripts/upgrade/note.mjs"
   }
 }