@hirobius/design-system 0.15.0 → 0.17.0

package/package.json

@@ -17,9 +17,10 @@
     "type": "git",
     "url": "git+https://github.com/hirobius/hds.git"
   },
+  "author": "Adrian Milsap",
   "license": "SEE LICENSE IN NOTICE.md",
   "private": false,
-  "version": "0.15.0",
+  "version": "0.17.0",
   "engines": {
     "node": ">=20",
     "pnpm": ">=8"
@@ -85,6 +86,11 @@
       "import": "./dist/scroll.js",
       "default": "./dist/scroll.js"
     },
+    "./patterns": {
+      "types": "./dist/types/src/patterns.d.ts",
+      "import": "./dist/patterns.js",
+      "default": "./dist/patterns.js"
+    },
     "./package.json": "./package.json"
   },
   "files": [
@@ -166,6 +172,7 @@
     "@tailwindcss/vite": "^4.2.4",
     "@testing-library/dom": "^10.4.0",
     "@testing-library/react": "^16.1.0",
+    "@testing-library/user-event": "^14.6.7",
     "@types/react": "^18.3.0",
     "@types/react-dom": "^18.3.0",
     "@types/three": "^0.183.1",
@@ -227,10 +234,10 @@
   },
   "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.",
+    "_comment:editorconfig-version": "check:mojibake routes through scripts/lib/mojibake.mjs, which pins EC_VERSION=v3.7.0. The editorconfig-checker@6.1.x npm wrapper expects binary v3.7.0 but downloads the latest Go release (v3.8.0, 2026-06-25), so a fresh install fails with a version mismatch (binary != config). Pinning the download to the wrapper's expected version keeps CI + pre-commit green. Bump both together when upgrading the npm package. The wrapper also SKIPS gracefully (like check:secrets) when the binary download is network-blocked (remote agent sessions), so hooks no longer need --no-verify (#18/#52); the gate still enforces wherever the binary is present.",
     "_comment:link-integrity": "check:doc-refs and check:routes both validate internal link integrity (different surfaces: doc refs vs route links). Kept dormant/manual-only to prevent pre-commit cascade.",
     "_comment:security-baseline": "check:security validates OWASP baseline patterns. Dormant/manual-only — candidate for integration into security-focused CI lane, not pretest.",
     "_comment:token-integrity": "check:css-values, check:token-structure validate token system correctness. Dormant/manual-only due to overlapping scope with check:fast and existing token validators.",
-    "_comment:editorconfig-version": "check:mojibake routes through scripts/lib/mojibake.mjs, which pins EC_VERSION=v3.7.0. The editorconfig-checker@6.1.x npm wrapper expects binary v3.7.0 but downloads the latest Go release (v3.8.0, 2026-06-25), so a fresh install fails with a version mismatch (binary != config). Pinning the download to the wrapper's expected version keeps CI + pre-commit green. Bump both together when upgrading the npm package. The wrapper also SKIPS gracefully (like check:secrets) when the binary download is network-blocked (remote agent sessions), so hooks no longer need --no-verify (#18/#52); the gate still enforces wherever the binary is present.",
     "api:check": "node scripts/audit-component-integrity.mjs --api",
     "api:update": "node scripts/audit-component-integrity.mjs --api --update-baseline",
     "audit:bundle": "node scripts/audit-bundle.mjs",
@@ -238,6 +245,7 @@
     "audit:sbom": "node scripts/audit-sbom.mjs",
     "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/embed-fonts.mjs && node scripts/build-styles-css.mjs && node scripts/build-static-css.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",
@@ -245,12 +253,6 @@
     "changeset": "changeset",
     "changeset:add": "changeset",
     "changeset:version": "changeset version",
-    "storybook": "storybook dev -p 6006",
-    "build-storybook": "storybook build",
-    "storybook:deploy": "node scripts/deploy-storybook.mjs",
-    "chromatic": "chromatic --exit-zero-on-changes",
-    "readme:counts": "node scripts/build-readme-counts.mjs",
-    "release": "pnpm build:lib && pnpm smoke:consumer --skip-build && changeset publish",
     "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",
@@ -265,14 +267,15 @@
     "check:doc-refs": "node scripts/check-link-integrity.mjs --doc-refs-only",
     "check:docs": "node scripts/audit-component-integrity.mjs --docs && node scripts/check-token-descriptions.mjs --no-missing --quality",
     "check:exemptions": "node scripts/check-exemptions.mjs",
-    "check:figma-mapping": "node scripts/check-figma-mapping.mjs",
     "check:fast": "node scripts/validate-manifest.mjs && node scripts/check-manifest-drift.mjs && node scripts/build-tokens.mjs && node scripts/verify-tokens.mjs && node scripts/audit-tokens.mjs --full && pnpm typecheck && node scripts/check-css-integrity.mjs && node scripts/audit-component-integrity.mjs --tokens && pnpm check:docs && node scripts/check-ref-forwarding.mjs && node scripts/check-hardcoded-spacing.mjs && node scripts/check-dimensions.mjs && node scripts/check-hardcoded-breakpoints.mjs && node scripts/check-typography-discipline.mjs && pnpm check:mojibake && node scripts/check-style-discipline.mjs --style-props-only && node scripts/check-tier-bypass.mjs && node scripts/check-link-integrity.mjs --doc-refs-only && node scripts/check-brand.mjs && node scripts/check-registry.mjs && node scripts/check-template-source-of-truth.mjs",
+    "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: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",
     "check:forbidden-overrides": "node scripts/audit-tokens.mjs --forbidden",
     "check:format": "pnpm exec lint-staged",
-    "check:figma-drift": "node scripts/check-figma-drift.mjs",
     "check:full": "node scripts/validate-manifest.mjs && node scripts/check-manifest-drift.mjs && node scripts/build-tokens.mjs && node scripts/verify-tokens.mjs && node scripts/audit-tokens.mjs --full && pnpm typecheck && node scripts/check-css-integrity.mjs && node scripts/audit-component-integrity.mjs --tokens && pnpm check:docs && node scripts/check-contrast.mjs && node scripts/check-focus-states.mjs && node scripts/check-reduced-motion.mjs && node scripts/check-ref-forwarding.mjs && node scripts/check-hardcoded-spacing.mjs && node scripts/check-dimensions.mjs && node scripts/check-hardcoded-breakpoints.mjs && node scripts/check-unresponsive-grids.mjs && node scripts/check-motion.mjs && node scripts/check-typography-discipline.mjs && pnpm check:mojibake && node scripts/check-style-discipline.mjs && node scripts/check-hardcoded-colors.mjs && node scripts/check-tier-bypass.mjs && node scripts/check-token-structure.mjs && node scripts/check-security-baseline.mjs && node scripts/check-attributions.mjs && node scripts/check-exemptions.mjs && node scripts/check-brand.mjs && node scripts/check-registry.mjs && node scripts/audit-component-integrity.mjs --api && node scripts/check-token-descriptions.mjs --no-missing && node scripts/check-token-renames.mjs && node scripts/check-tailwind-token-coverage.mjs",
     "check:ghost-tokens": "node scripts/audit-tokens.mjs --full",
     "check:grids": "node scripts/check-unresponsive-grids.mjs",
@@ -289,13 +292,21 @@
     "check:refs": "node scripts/check-ref-forwarding.mjs",
     "check:registry": "node scripts/check-registry.mjs",
     "check:release": "pnpm check:full && node scripts/check-style-discipline.mjs && pnpm build:lib && pnpm check:size",
+    "check:rendered-geometry": "node scripts/check-rendered-geometry.mjs",
+    "check:rendered-geometry:update": "node scripts/check-rendered-geometry.mjs --update-baseline",
     "check:routes": "node scripts/check-link-integrity.mjs --route-links-only",
     "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 && size-limit",
+    "check:size": "pnpm build:lib && node scripts/build-button-probe.mjs && 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",
+    "check:storybook-axe": "node scripts/check-storybook-axe.mjs",
     "check:style-props": "node scripts/check-style-discipline.mjs --style-props-only",
+    "check:sync-map": "node scripts/check-sync-map.mjs",
+    "check:status-claims": "node scripts/check-status-claims.mjs --check",
+    "check:record-freshness": "node scripts/check-record-freshness.mjs",
     "check:tailwind": "pnpm lint --rule '{\"tailwindcss/no-custom-classname\":\"error\"}'",
     "check:tailwind-arbitrary": "pnpm lint --rule '{\"tailwindcss/no-arbitrary-value\":\"error\"}'",
     "check:tailwind-token-coverage": "node scripts/check-tailwind-token-coverage.mjs",
@@ -306,22 +317,31 @@
     "check:token-structure": "node scripts/check-token-structure.mjs",
     "check:tokens": "node scripts/check-hardcoded-colors.mjs && pnpm lint --rule '{\"tailwindcss/no-custom-classname\":\"error\"}' && node scripts/audit-tokens.mjs --forbidden && node scripts/check-tier-bypass.mjs && node scripts/check-hardcoded-spacing.mjs && node scripts/check-typography-discipline.mjs --fonts-only",
     "check:type-coverage": "pnpm exec type-coverage --at-least 99.9",
+    "chromatic": "chromatic --exit-zero-on-changes",
     "closure:plan": "node scripts/run-gates.mjs --channel pre-commit --emit-inventory docs/guardrails/full-strictness-inventory.json && node scripts/generate-closure-plan.mjs",
     "closure:plan:check": "node scripts/generate-closure-plan.mjs --check",
     "docs:api": "node scripts/generate-component-api.mjs",
     "docs:changelogs": "node scripts/generate-component-changelogs.mjs",
+    "docs:component": "node scripts/generate-component-page.mjs",
     "docs:llms": "node scripts/generate-llms-txt.mjs",
+    "docs:site": "node scripts/generate-component-page.mjs --all --clean",
+    "docs:site:inline": "node scripts/generate-component-page.mjs --all --clean --inline",
+    "docs:site:shots": "node scripts/generate-component-page.mjs --all --clean --shots",
     "figma-variables": "node scripts/build-figma-variables.mjs",
     "figma:connect:check": "node scripts/check-code-connect.mjs",
     "figma:connect:generate": "node scripts/generate-code-connect.mjs",
     "figma:connect:parse": "figma connect parse --exit-on-unreadable-files --skip-update-check",
-    "figma:links": "node scripts/figma-links.mjs",
     "figma:disposition": "node scripts/figma-disposition.mjs",
+    "figma:inventory": "node scripts/figma-inventory.mjs",
+    "figma:links": "node scripts/figma-links.mjs",
     "figma:model": "node scripts/build-figma-model.mjs",
     "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",
     "heal": "node scripts/self-heal.mjs",
     "heal:smoke": "node scripts/self-heal.mjs --smoke",
     "health-commit": "pnpm check:semantic-report && node scripts/print-health-commit.mjs",
@@ -332,27 +352,29 @@
     "llms:generate": "node scripts/generate-llms-txt.mjs",
     "manifest:generate": "node scripts/generate-manifest.mjs && node scripts/generate-component-api.mjs && node scripts/enrich-manifest.mjs",
     "manifest:project": "node scripts/generate-manifest-projection.mjs",
+    "prebuild-storybook": "node scripts/generate-component-api.mjs",
     "prebuild:lib": "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/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",
+    "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/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",
+    "pretypecheck": "node scripts/audit-tokens.mjs --report-only",
+    "preview:build": "vite build --config preview/vite.config.mjs",
     "promote": "node scripts/promote.mjs",
-    "hds:new": "node scripts/scaffold-component.mjs",
+    "readme:counts": "node scripts/build-readme-counts.mjs",
+    "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",
     "smoke:consumer": "node scripts/smoke-consumer.mjs && node scripts/check-published-types.mjs && node scripts/check-rsc-directives.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",
+    "sync-map": "node scripts/check-sync-map.mjs --gaps",
     "sync:health": "node scripts/generate-manifest.mjs && node scripts/generate-component-api.mjs && node scripts/enrich-manifest.mjs && node scripts/build-tokens.mjs && node scripts/audit-tokens.mjs --report-only && node scripts/build-design-md.mjs",
     "test": "vitest run --passWithNoTests",
-    "test:a11y": "echo 'RETIRED (#161): the Playwright browser suite drove the docs SPA deleted in #90 — see tests-archive/README.md. Storybook is the verification surface.' && exit 1",
-    "test:collision": "echo 'RETIRED (#161): the Playwright browser suite drove the docs SPA deleted in #90 — see tests-archive/README.md. Storybook is the verification surface.' && exit 1",
     "test:compiler": "node -e \"import('./scripts/hds-jsx-compiler.mjs').then(m => console.log(JSON.stringify(m.compile(process.argv[1]), null, 2)))\" --",
     "test:coverage": "vitest run --coverage",
     "test:figma": "npx tsx scripts/figma-sync.ts",
-    "test:layout": "echo 'RETIRED (#161): the Playwright browser suite drove the docs SPA deleted in #90 — see tests-archive/README.md. Storybook is the verification surface.' && exit 1",
     "test:phase1": "node scripts/test-phase1.mjs",
-    "test:responsive": "echo 'RETIRED (#161): the Playwright browser suite drove the docs SPA deleted in #90 — see tests-archive/README.md. Storybook is the verification surface.' && exit 1",
-    "test:visual": "echo 'RETIRED (#161): the Playwright browser suite drove the docs SPA deleted in #90 — see tests-archive/README.md. Storybook is the verification surface.' && exit 1",
-    "test:visual:update": "echo 'RETIRED (#161): the Playwright browser suite drove the docs SPA deleted in #90 — see tests-archive/README.md. Storybook is the verification surface.' && exit 1",
     "test:watch": "vitest",
     "tokens": "node scripts/generate-manifest.mjs && node scripts/generate-component-api.mjs && node scripts/enrich-manifest.mjs && node scripts/build-tokens.mjs && node scripts/audit-tokens.mjs --forbidden && node scripts/check-typography-discipline.mjs --overrides-only && node scripts/build-handoff.mjs && node scripts/build-design-md.mjs && node scripts/generate-llms-txt.mjs && node scripts/build-readme-counts.mjs",
     "tokens:audit": "node scripts/audit-component-integrity.mjs --tokens",
@@ -364,13 +386,6 @@
     "validate:manifest": "node scripts/validate-manifest.mjs",
     "visual-ingest": "node scripts/visual-ingest.mjs",
     "watch:guardrails": "nodemon --watch CLAUDE.md --watch .cursorrules --watch eslint.config.js --watch .github/workflows -e md,json,js,yml,yaml --exec \"node scripts/audit-guardrails.js\"",
-    "watch:metrics": "nodemon --watch src/app/components --watch src/app/pages --watch src/app/design-system --watch src/app/styles -e tsx,ts,css --exec \"node scripts/audit-tokens.mjs --full && node scripts/generate-manifest.mjs\"",
-    "prebuild-storybook": "node scripts/generate-component-api.mjs",
-    "prestorybook": "node scripts/generate-component-api.mjs",
-    "pretypecheck": "node scripts/audit-tokens.mjs --report-only",
-    "preview:build": "vite build --config preview/vite.config.mjs",
-    "figma:inventory": "node scripts/figma-inventory.mjs",
-    "check:figma-coverage": "node scripts/check-figma-coverage.mjs",
-    "guardrail:sweep": "node scripts/guardrail-sweep.mjs"
+    "watch:metrics": "nodemon --watch src/app/components --watch src/app/pages --watch src/app/design-system --watch src/app/styles -e tsx,ts,css --exec \"node scripts/audit-tokens.mjs --full && node scripts/generate-manifest.mjs\""
   }
 }