@hirobius/design-system 0.13.1 → 0.15.0

package/dist/types/src/index.d.ts

@@ -1,114 +1,114 @@
-export * from './app/components/alert';
-export * from './app/components/asset-img';
-export * from './app/components/avatar';
-export * from './app/components/badge';
-export * from './app/components/box';
-export * from './app/components/button';
-export * from './app/components/callout';
-export * from './app/components/field';
-export * from './app/components/stat';
-export * from './app/components/status-list-item';
-export * from './app/components/card';
-export * from './app/components/cinematic-link';
-export * from './app/components/code-block';
-export * from './app/components/component-instance-matrix';
-export * from './app/components/container';
-export * from './app/components/dialog';
-export * from './app/components/divider';
-export * from './app/components/menu';
-export * from './app/components/popover';
-export * from './app/components/hds-tooltip';
-export * from './app/components/doc-link-card';
-export * from './app/components/grid';
-export * from './app/components/heading-stack';
-export * from './app/components/history-card';
-export * from './app/components/icon';
-export * from './app/components/inline-code';
-export * from './app/components/inline-link';
-export * from './app/components/input';
-export * from './app/components/textarea';
-export * from './app/components/checkbox';
-export * from './app/components/radio';
-export * from './app/components/slider';
-export * from './app/components/toggle';
-export * from './app/components/nav-item';
-export * from './app/components/progress';
-export * from './app/components/skeleton';
-export * from './app/components/spinner';
-export * from './app/components/segmented-control';
-export * from './app/components/stack';
-export * from './app/components/surface';
-export * from './app/components/table';
-export * from './app/components/tag';
-export * from './app/components/text';
-export * from './app/components/token';
-export * from './app/components/kbd';
-export * from './app/components/status-dot';
-export * from './app/components/timestamp';
-export * from './app/components/blockquote';
-export * from './app/components/visually-hidden';
-export * from './app/components/avatar-group';
-export * from './app/components/button-group';
-export * from './app/components/input-group';
-export * from './app/components/circular-progress';
-export * from './app/components/toggle-button';
-export * from './app/components/aspect-ratio';
-export * from './app/components/alert-dialog';
-export * from './app/components/hover-card';
-export * from './app/components/context-menu';
-export * from './app/components/side-nav';
-export * from './app/components/command-palette';
-export * from './app/components/image-lightbox';
-export * from './app/components/metadata-list';
-export * from './app/components/overflow-list';
-export * from './app/components/top-nav';
-export * from './app/components/app-shell';
-export * from './app/components/selectable-card';
-export * from './app/components/tokenizer';
-export * from './app/components/file-input';
-export * from './app/components/multi-selector';
-export * from './app/components/toolbar';
-export * from './app/components/tree-list';
-export * from './app/components/stepper';
-export * from './app/components/carousel';
-export * from './app/components/calendar';
-export * from './app/components/time-input';
-export * from './app/components/date-input';
-export * from './app/components/date-range-input';
-export * from './app/components/date-time-input';
-export * from './app/components/cluster';
-export * from './app/components/center';
-export * from './app/components/sidebar';
-export * from './app/components/switcher';
-export * from './app/components/cover';
-export * from './app/components/frame';
-export * from './app/components/bleed';
-export * from './app/components/reveal';
-export * from './app/components/pin';
-export * from './app/components/page';
-export * from './app/components/empty-state';
-export * from './app/components/error-boundary';
-export * from './app/components/not-found-pattern';
-export * from './app/components/tabs';
-export * from './app/components/tile-grid';
-export * from './app/components/status-tile';
-export * from './app/components/activity-feed';
-export * from './app/components/breadcrumb';
-export * from './app/components/combobox';
-export * from './app/components/disclosure';
-export * from './app/components/form';
-export * from './app/components/foundation-swatch';
-export * from './app/components/icon-button';
-export * from './app/components/nav-group';
-export * from './app/components/pagination';
-export * from './app/components/sketch';
-export * from './app/components/stepper-field';
-export * from './app/components/text-lockup';
-export * from './app/components/toast';
-export * from './app/layouts/CaseStudyLayout';
-export * from './app/components/error-pattern';
-export * from './app/layouts/HdsSystemDocLayout';
-export { default as hds } from './app/design-system/tokens';
+export * from './app/components/alert.js';
+export * from './app/components/asset-img.js';
+export * from './app/components/avatar.js';
+export * from './app/components/badge.js';
+export * from './app/components/box.js';
+export * from './app/components/button.js';
+export * from './app/components/callout.js';
+export * from './app/components/field.js';
+export * from './app/components/stat.js';
+export * from './app/components/status-list-item.js';
+export * from './app/components/card.js';
+export * from './app/components/cinematic-link.js';
+export * from './app/components/code-block.js';
+export * from './app/components/component-instance-matrix.js';
+export * from './app/components/container.js';
+export * from './app/components/dialog.js';
+export * from './app/components/divider.js';
+export * from './app/components/menu.js';
+export * from './app/components/popover.js';
+export * from './app/components/hds-tooltip.js';
+export * from './app/components/doc-link-card.js';
+export * from './app/components/grid.js';
+export * from './app/components/heading-stack.js';
+export * from './app/components/history-card.js';
+export * from './app/components/icon.js';
+export * from './app/components/inline-code.js';
+export * from './app/components/inline-link.js';
+export * from './app/components/input.js';
+export * from './app/components/textarea.js';
+export * from './app/components/checkbox.js';
+export * from './app/components/radio.js';
+export * from './app/components/slider.js';
+export * from './app/components/toggle.js';
+export * from './app/components/nav-item.js';
+export * from './app/components/progress.js';
+export * from './app/components/skeleton.js';
+export * from './app/components/spinner.js';
+export * from './app/components/segmented-control.js';
+export * from './app/components/stack.js';
+export * from './app/components/surface.js';
+export * from './app/components/table.js';
+export * from './app/components/tag.js';
+export * from './app/components/text.js';
+export * from './app/components/token.js';
+export * from './app/components/kbd.js';
+export * from './app/components/status-dot.js';
+export * from './app/components/timestamp.js';
+export * from './app/components/blockquote.js';
+export * from './app/components/visually-hidden.js';
+export * from './app/components/avatar-group.js';
+export * from './app/components/button-group.js';
+export * from './app/components/input-group.js';
+export * from './app/components/circular-progress.js';
+export * from './app/components/toggle-button.js';
+export * from './app/components/aspect-ratio.js';
+export * from './app/components/alert-dialog.js';
+export * from './app/components/hover-card.js';
+export * from './app/components/context-menu.js';
+export * from './app/components/side-nav.js';
+export * from './app/components/command-palette.js';
+export * from './app/components/image-lightbox.js';
+export * from './app/components/metadata-list.js';
+export * from './app/components/overflow-list.js';
+export * from './app/components/top-nav.js';
+export * from './app/components/app-shell.js';
+export * from './app/components/selectable-card.js';
+export * from './app/components/tokenizer.js';
+export * from './app/components/file-input.js';
+export * from './app/components/multi-selector.js';
+export * from './app/components/toolbar.js';
+export * from './app/components/tree-list.js';
+export * from './app/components/stepper.js';
+export * from './app/components/carousel.js';
+export * from './app/components/calendar.js';
+export * from './app/components/time-input.js';
+export * from './app/components/date-input.js';
+export * from './app/components/date-range-input.js';
+export * from './app/components/date-time-input.js';
+export * from './app/components/cluster.js';
+export * from './app/components/center.js';
+export * from './app/components/sidebar.js';
+export * from './app/components/switcher.js';
+export * from './app/components/cover.js';
+export * from './app/components/frame.js';
+export * from './app/components/bleed.js';
+export * from './app/components/reveal.js';
+export * from './app/components/pin.js';
+export * from './app/components/page.js';
+export * from './app/components/empty-state.js';
+export * from './app/components/error-boundary.js';
+export * from './app/components/not-found-pattern.js';
+export * from './app/components/tabs.js';
+export * from './app/components/tile-grid.js';
+export * from './app/components/status-tile.js';
+export * from './app/components/activity-feed.js';
+export * from './app/components/breadcrumb.js';
+export * from './app/components/combobox.js';
+export * from './app/components/disclosure.js';
+export * from './app/components/form.js';
+export * from './app/components/foundation-swatch.js';
+export * from './app/components/icon-button.js';
+export * from './app/components/nav-group.js';
+export * from './app/components/pagination.js';
+export * from './app/components/sketch.js';
+export * from './app/components/stepper-field.js';
+export * from './app/components/text-lockup.js';
+export * from './app/components/toast.js';
+export * from './app/layouts/CaseStudyLayout.js';
+export * from './app/components/error-pattern.js';
+export * from './app/layouts/HdsSystemDocLayout.js';
+export { default as hds } from './app/design-system/tokens.js';
 /** Raw DTCG design tokens (the contents of `hirobius.tokens.json`). */
 export declare const tokens: {
     $schema: string;
@@ -2554,8 +2554,8 @@ export declare const tokens: {
         };
     };
 };
-export { cn } from './lib/utils';
-export { HdsThemeProvider, useHdsTheme } from './app/context/hds-theme';
-export type { HdsTheme, HdsDensity, HdsThemeValue, HdsThemeProviderProps, } from './app/context/hds-theme';
-export { HdsRouterProvider, useHdsRouter } from './app/context/RouterContext';
-export type { HdsRouterAdapter, HdsRouterProviderProps, HdsLinkComponent, HdsLinkProps, HdsNavigateOptions, } from './app/context/RouterContext';
+export { cn } from './lib/utils.js';
+export { HdsThemeProvider, useHdsTheme } from './app/context/hds-theme.js';
+export type { HdsTheme, HdsDensity, HdsThemeValue, HdsThemeProviderProps, } from './app/context/hds-theme.js';
+export { HdsRouterProvider, useHdsRouter } from './app/context/RouterContext.js';
+export type { HdsRouterAdapter, HdsRouterProviderProps, HdsLinkComponent, HdsLinkProps, HdsNavigateOptions, } from './app/context/RouterContext.js';

package/dist/types/src/lib/env.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Build-environment checks that survive being published.
+ *
+ * Shipped library code must never read `import.meta.env`. Vite's library build
+ * evaluates it at HDS's build time, not the consumer's, so `import.meta.env.DEV`
+ * bakes to `false` and `.PROD` to `true` inside `dist/` — turning every guard
+ * written against them into a constant for everyone who installs the package.
+ *
+ * `process.env.NODE_ENV` is the replacement because consumer bundlers
+ * substitute that exact member expression at THEIR build time, which is the
+ * moment that actually knows the answer. Vite, webpack, Next and esbuild all do
+ * it by default; plain Rollup needs `@rollup/plugin-replace` configured, so this
+ * is a convention rather than a guarantee, and the fallback below is what makes
+ * it safe when nobody substituted anything.
+ *
+ * READ THE SHAPE BEFORE CHANGING IT. The substitution replaces the member
+ * expression and nothing around it, so wrapping the read in `typeof process !==
+ * 'undefined' && ...` leaves a runtime check that a browser bundle always fails,
+ * inverting the answer in a production build. The bare read inside a `try` is
+ * substituted cleanly and the `catch` covers the one runtime that has no
+ * `process` at all: native ESM in a browser with no bundler. That runtime is
+ * always a real page, never a dev build, so it resolves to production and gets
+ * no warnings. Measured output and the reasoning live in `env.test.ts`, which
+ * fails if this shape is undone.
+ *
+ * Guarded by `src/lib/env.test.ts` and `tests/no-shipped-import-meta-env.test.ts`.
+ */
+/** True when the CONSUMER built for production, or when there is no build at all. */
+export declare function isProduction(): boolean;
+/** True outside a consumer production build — the gate for dev-only warnings. */
+export declare function isDevelopment(): boolean;

package/dist/types/src/lib/manifest-entry.d.ts

@@ -1,3 +1,3 @@
-import type { SystemManifest } from '../app/data/manifest-types';
+import type { SystemManifest } from '../app/data/manifest-types.js';
 declare const manifest: SystemManifest;
 export default manifest;

package/dist/types/src/scroll/index.d.ts

@@ -11,6 +11,6 @@
  * - `useScrollProgress` — Motion-based 0→1 scroll progress for a target element
  *   (no new dependency; works with or without `SmoothScroll`).
  */
-export { SmoothScroll, type SmoothScrollProps, type SmoothScrollOptions } from './smooth-scroll';
-export { useScrollProgress, type UseScrollProgressOptions, type ScrollOffset, } from './use-scroll-progress';
+export { SmoothScroll, type SmoothScrollProps, type SmoothScrollOptions } from './smooth-scroll.js';
+export { useScrollProgress, type UseScrollProgressOptions, type ScrollOffset, } from './use-scroll-progress.js';
 export { useLenis } from 'lenis/react';

package/hirobius.tokens.json

@@ -213,7 +213,7 @@
           "$value": "#2a1659",
           "$description": "Specific value within the lilac range at a defined lightness step."
         },
-        "$description": "Discrete values within the lilac range at defined lightness steps. Mirrors the blue ramp's stop set; available to downstream brand overlays."
+        "$description": "Lilac ramp at fixed lightness steps. Mirrors the blue ramp's stops; available to brand overlays."
       },
       "amber": {
         "50": {
@@ -1180,7 +1180,7 @@
         },
         "onAccent": {
           "$value": "{primitive.color.neutral.white}",
-          "$description": "Text/icon color on accent fills. Flips to a dark neutral in dark mode, where the accent fill is a light neutral.",
+          "$description": "Text/icon color on accent fills. Flips to a dark neutral in dark mode, where accent fills are light.",
           "$extensions": {
             "com.figma.variables": {
               "modes": {
@@ -1853,7 +1853,7 @@
       "action": {
         "$type": "dimension",
         "$value": "{primitive.radius.8}",
-        "$description": "The shape knob. Corner radius for interactive action elements (buttons, inputs, badges, alerts, segmented items). Tailwind's rounded-md resolves to exactly this value via --role-radius; containers are one step above it at rounded-lg. Override role.radius in a tenant overlay to reshape the whole system from one value."
+        "$description": "Corner radius for action elements (buttons, inputs, badges); Tailwind rounded-md resolves here. Override role.radius to reshape the system."
       }
     },
     "borderWidth": {

package/package.json

@@ -19,7 +19,7 @@
   },
   "license": "SEE LICENSE IN NOTICE.md",
   "private": false,
-  "version": "0.13.1",
+  "version": "0.15.0",
   "engines": {
     "node": ">=20",
     "pnpm": ">=8"
@@ -239,7 +239,7 @@
     "audit:sidecar": "node scripts/generate-security-posture.mjs",
     "audit:style-dictionary": "bash scripts/poc/style-dictionary-poc/run.sh",
     "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",
+    "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",
@@ -316,11 +316,11 @@
     "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: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",
-    "guardrail:firing-stats": "node scripts/refresh-firing-stats.mjs",
     "harvest:design-md": "node scripts/harvest-design-md.mjs",
     "heal": "node scripts/self-heal.mjs",
     "heal:smoke": "node scripts/self-heal.mjs --smoke",
@@ -333,13 +333,13 @@
     "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: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 && knip --no-exit-code",
+    "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",
     "promote": "node scripts/promote.mjs",
     "hds:new": "node scripts/scaffold-component.mjs",
     "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",
+    "smoke:consumer": "node scripts/smoke-consumer.mjs && node scripts/check-published-types.mjs && node scripts/check-rsc-directives.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: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",
@@ -368,6 +368,9 @@
     "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"
+    "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"
   }
 }