@hirobius/design-system 0.19.1 → 0.20.0

package/dist/types/src/app/components/inline-code.d.ts

@@ -22,5 +22,4 @@ export type InlineCodeProps = {
 };
 /** @public */
 export declare function InlineCode({ children, style, density, compact, copyable, }: InlineCodeProps): import("react/jsx-runtime").JSX.Element;
-/** @internal — CVA variant helper; compose via InlineCode props instead. */
-export { inlineCodeVariants };
+export {};

package/dist/types/src/app/components/input.d.ts

@@ -2,7 +2,7 @@
  * Input — text field primitive with label, helper, and error slots.
  * @category Inputs
  * @tier primitive
- * @usage Collect a single line of text, a number, an email or a password, with label, helper and error slots.
+ * @usage Collect a single line of text, a number, an email, a password, a date or a time, with label, helper and error slots.
  * @whenNot Multi-line text, or choosing from a fixed list of options.
  * @useInstead Textarea multi-line text
  * @useInstead Select a short fixed list
@@ -16,10 +16,10 @@ declare const inputVariants: (props?: ({
     textStyle?: "body" | "mono" | null | undefined;
     invalid?: boolean | null | undefined;
 } & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
-type InputFieldType = 'text' | 'email' | 'password' | 'search' | 'tel' | 'url' | 'number';
+type InputFieldType = 'text' | 'email' | 'password' | 'search' | 'tel' | 'url' | 'number' | 'date' | 'time' | 'datetime-local';
 /** @public */
 export type InputSize = NonNullable<VariantProps<typeof inputVariants>['size']>;
-export interface InputProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, 'type' | 'disabled' | 'size'> {
+export interface InputProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, 'type' | 'disabled' | 'size' | 'prefix'> {
     /** Native input type. */
     type?: InputFieldType;
     /** Field height tier. */
@@ -34,6 +34,10 @@ export interface InputProps extends Omit<React.InputHTMLAttributes<HTMLInputElem
     leadingVisual?: React.ReactNode;
     /** Optional trailing visual rendered inside the input shell. */
     trailingVisual?: React.ReactNode;
+    /** In-flow content before the value, e.g. `https://` or `$`. Not part of the accessible name. */
+    prefix?: React.ReactNode;
+    /** In-flow content after the value, e.g. a unit such as `kg`. Not part of the accessible name. */
+    suffix?: React.ReactNode;
     /** Disable interaction. */
     disabled?: boolean;
     /** Mark the field as invalid (sets aria-invalid + destructive border). */
@@ -48,5 +52,4 @@ export interface InputProps extends Omit<React.InputHTMLAttributes<HTMLInputElem
     inputClassName?: string;
 }
 export declare const Input: React.ForwardRefExoticComponent<InputProps & React.RefAttributes<HTMLInputElement>>;
-/** @internal — CVA variant helper; compose via Input props instead. */
-export { inputVariants };
+export {};

package/dist/types/src/app/components/kbd.d.ts

@@ -17,5 +17,4 @@ export interface KbdProps extends React.HTMLAttributes<HTMLElement>, KbdVariantP
 }
 /** Renders a keyboard key or shortcut token, e.g. `<Kbd>⌘K</Kbd>`. */
 export declare const Kbd: React.ForwardRefExoticComponent<KbdProps & React.RefAttributes<HTMLElement>>;
-/** @internal — CVA variant helper; compose via Kbd props instead. */
-export { kbdVariants };
+export {};

package/dist/types/src/app/components/metadata-list.d.ts

@@ -39,5 +39,4 @@ export interface MetadataListProps extends Omit<React.HTMLAttributes<HTMLDListEl
 }
 /** Renders object metadata as a semantic `<dl>` of term/description pairs. */
 export declare const MetadataList: React.ForwardRefExoticComponent<MetadataListProps & React.RefAttributes<HTMLDListElement>>;
-/** @internal — CVA variant helper; compose via MetadataList props instead. */
-export { metadataListVariants };
+export {};

package/dist/types/src/app/components/page-header.d.ts

@@ -27,8 +27,6 @@ export interface PageHeaderProps extends Omit<React.HTMLAttributes<HTMLElement>,
  * Screen header: breadcrumb slot, the title at the one canonical page-title size
  * (`heading2`), a status slot and an actions slot. Every screen has exactly one.
  * `display` and `h1` type are reserved for marketing and landing surfaces.
- *
- * Distinct from the docs-only page header in `src/docs-tooling`.
  * @screenPattern
  */
 export declare const PageHeader: React.ForwardRefExoticComponent<PageHeaderProps & React.RefAttributes<HTMLElement>>;

package/dist/types/src/app/components/popover.d.ts

@@ -51,6 +51,14 @@ interface PopoverComponent extends React.FC<React.ComponentProps<typeof PopoverP
 /**
  * Popover root + parts. Controlled via `open`/`onOpenChange`, or uncontrolled
  * with `defaultOpen`.
+ * @usage Anchor interactive content, such as a short form, a filter set or a picker, to a trigger people click to open.
+ * @whenNot A short label on hover or focus, a list of actions, or a decision that must block the page.
+ * @useInstead Tooltip a short label shown on hover or focus
+ * @useInstead Menu a list of actions
+ * @useInstead Dialog a decision that blocks the page
+ * @keyboard Enter/Space Opens the popover from the trigger and moves focus inside it.
+ * @keyboard Escape Closes the popover and returns focus to the trigger.
+ * @keyboard Tab Cycles focus inside the open popover; the page behind stays reachable.
  * @public
  */
 declare const Popover: PopoverComponent;

package/dist/types/src/app/components/progress.d.ts

@@ -1,8 +1,8 @@
 /**
- * Progress - linear progress bar (determinate or indeterminate).
+ * Progress - linear bar or circular ring (determinate or indeterminate).
  * @category Feedback
  * @tier primitive
- * @usage Show how far a task has got, as a bar that is determinate or indeterminate.
+ * @usage Show how far a task has got, as a bar or ring that is determinate or indeterminate.
  * @whenNot A wait of unknown length with no bar, or content that is still loading.
  * @useInstead Spinner a wait of unknown length
  * @useInstead Skeleton placeholder shapes for loading content
@@ -13,18 +13,45 @@ import { type VariantProps } from 'class-variance-authority';
 declare const progressTrackVariants: (props?: ({
     size?: "sm" | "md" | "lg" | null | undefined;
 } & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
+declare const PROGRESS_TONES: {
+    readonly neutral: {
+        readonly bar: "bg-accent";
+        readonly ring: "text-primary";
+    };
+    readonly danger: {
+        readonly bar: "bg-feedback-danger";
+        readonly ring: "text-feedback-danger";
+    };
+    readonly success: {
+        readonly bar: "bg-feedback-success";
+        readonly ring: "text-feedback-success";
+    };
+    readonly warning: {
+        readonly bar: "bg-feedback-warning";
+        readonly ring: "text-feedback-warning";
+    };
+    readonly info: {
+        readonly bar: "bg-feedback-info";
+        readonly ring: "text-feedback-info";
+    };
+};
 type ProgressVariantProps = VariantProps<typeof progressTrackVariants>;
 /** @public */
 export interface ProgressProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'role'>, ProgressVariantProps {
     /**
-     * Completion 0–100. Omit (or pass null) for an indeterminate bar that
+     * Completion 0–max. Omit (or pass null) for an indeterminate bar that
      * animates until the work completes.
      */
     value?: number | null;
+    /** Upper bound for `value`. Defaults to 100. */
+    max?: number;
+    /** Shape: `linear` bar (default) or `circular` ring. */
+    variant?: 'linear' | 'circular';
+    /** Fill color: `neutral` (default) or a feedback tone. */
+    tone?: keyof typeof PROGRESS_TONES;
     /** Accessible label for the progress bar. */
     label?: string;
 }
-/** Linear progress. Determinate when `value` is a number, else indeterminate. */
+/** Linear bar or circular ring. Determinate when `value` is a number, else indeterminate. */
 export declare const Progress: React.ForwardRefExoticComponent<ProgressProps & React.RefAttributes<HTMLDivElement>>;
-/** @internal — CVA variant helper; compose via Progress props instead. */
-export { progressTrackVariants };
+export {};

package/dist/types/src/app/components/segmented-control.d.ts

@@ -1,35 +1,12 @@
 import { type VariantProps } from 'class-variance-authority';
-declare const segmentedControlWrapperVariants: (props?: ({
-    fullWidth?: boolean | null | undefined;
-} & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
-declare const segmentedControlRailVariants: (props?: ({
-    variant?: "primary" | "secondary" | null | undefined;
-    fullWidth?: boolean | null | undefined;
-} & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
 declare const segmentedControlItemVariants: (props?: ({
     size?: "sm" | "md" | null | undefined;
     fullWidth?: boolean | null | undefined;
     variant?: "primary" | "secondary" | null | undefined;
     active?: boolean | null | undefined;
-    interaction?: "rest" | "hover" | "pressed" | null | undefined;
+    interaction?: "hover" | "pressed" | "rest" | null | undefined;
     disabled?: boolean | null | undefined;
 } & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
-declare const segmentedControlIndicatorVariants: (props?: ({
-    variant?: "primary" | "secondary" | null | undefined;
-    active?: boolean | null | undefined;
-    interaction?: "rest" | "hover" | "pressed" | null | undefined;
-    disabled?: boolean | null | undefined;
-} & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
-declare const segmentedControlDescriptionVariants: (props?: ({
-    variant?: "primary" | "secondary" | null | undefined;
-    active?: boolean | null | undefined;
-    interaction?: "rest" | "hover" | "pressed" | null | undefined;
-    disabled?: boolean | null | undefined;
-} & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
-declare const segmentedControlFocusRingVariants: (props?: ({
-    variant?: "primary" | "secondary" | null | undefined;
-} & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
-declare const segmentedControlLabelVariants: (props?: import("class-variance-authority/dist/types").ClassProp | undefined) => string;
 type SegmentedItemVariantProps = VariantProps<typeof segmentedControlItemVariants>;
 interface HdsSegmentedOption {
     /** Value submitted when this option is selected. */
@@ -63,5 +40,4 @@ export interface SegmentedControlProps {
 }
 /** @public */
 export declare const SegmentedControl: import("react").ForwardRefExoticComponent<SegmentedControlProps & import("react").RefAttributes<HTMLDivElement>>;
-/** @internal — CVA variant helpers; compose via SegmentedControl props instead. */
-export { segmentedControlWrapperVariants, segmentedControlRailVariants, segmentedControlItemVariants, segmentedControlIndicatorVariants, segmentedControlDescriptionVariants, segmentedControlFocusRingVariants, segmentedControlLabelVariants, };
+export {};

package/dist/types/src/app/components/select.d.ts

@@ -23,7 +23,7 @@
  * tabs.tsx / command-palette.tsx; `ref` targets the trigger button.
  */
 export interface SelectProps {
-    /** Select label rendered above the control. */
+    /** Select label rendered above the control. It names the trigger, also when hidden. */
     label: string;
     /** Controls whether the label is rendered. */
     showLabel?: boolean;
@@ -41,5 +41,14 @@ export interface SelectProps {
      * overlay inherits its theme; pass `null` to use `document.body`.
      */
     container?: HTMLElement | null;
+    /**
+     * Id of the trigger, so a `<label for>` names it. `FormField` sets it, with
+     * `aria-describedby` and `aria-invalid`.
+     */
+    id?: string;
+    /** Ids of the elements that describe the trigger (helper text, error). */
+    'aria-describedby'?: string;
+    /** Marks the trigger invalid, for example while the field shows an error. */
+    'aria-invalid'?: boolean;
 }
 export declare const Select: import("react").ForwardRefExoticComponent<SelectProps & import("react").RefAttributes<HTMLButtonElement>>;

package/dist/types/src/app/components/skeleton.d.ts

@@ -11,7 +11,7 @@
 import * as React from 'react';
 import { type VariantProps } from 'class-variance-authority';
 declare const skeletonVariants: (props?: ({
-    variant?: "text" | "rectangular" | "circular" | null | undefined;
+    variant?: "text" | "circular" | "rectangular" | null | undefined;
 } & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
 type SkeletonVariantProps = VariantProps<typeof skeletonVariants>;
 /** @public */
@@ -26,5 +26,4 @@ export interface SkeletonProps extends React.HTMLAttributes<HTMLDivElement>, Ske
  * state on the surrounding region (e.g. aria-busy) rather than per skeleton.
  */
 export declare const Skeleton: React.ForwardRefExoticComponent<SkeletonProps & React.RefAttributes<HTMLDivElement>>;
-/** @internal — CVA variant helper; compose via Skeleton props instead. */
-export { skeletonVariants };
+export {};

package/dist/types/src/app/components/spinner.d.ts

@@ -21,5 +21,4 @@ export interface SpinnerProps extends React.HTMLAttributes<HTMLSpanElement>, Spi
 }
 /** Indeterminate spinner. Inherits the surrounding text color via currentColor. */
 export declare const Spinner: React.ForwardRefExoticComponent<SpinnerProps & React.RefAttributes<HTMLSpanElement>>;
-/** @internal — CVA variant helper; compose via Spinner props instead. */
-export { spinnerVariants };
+export {};

package/dist/types/src/app/components/stack.d.ts

@@ -23,7 +23,10 @@ export interface StackProps {
     children: React.ReactNode;
     /** Flex direction for the stack. */
     direction?: 'row' | 'column';
-    /** Gap token: semantic (tight, normal, inset, spacious) or primitive (px4, px8, etc). Defaults to 'tight' (16px). */
+    /**
+     * Gap token: semantic (tight, normal, inset, spacious) or primitive (px4, px8, etc). Defaults to 'tight' (16px).
+     * Not the t-shirt scale: Stack's 'xs' is the 2px subgrid step, while Box `sx` 'xs' is scale.xs (8px), until the 1.0 rename (hds#206).
+     */
     gap?: GapOption;
     /** Cross-axis alignment: start | center | end | stretch. */
     align?: FlexAlign;

package/dist/types/src/app/components/stat.d.ts

@@ -23,5 +23,4 @@ export interface StatProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'c
  * @useInstead StatusTile a titled status with notes and a trailing badge
  */
 export declare const Stat: React.ForwardRefExoticComponent<StatProps & React.RefAttributes<HTMLDivElement>>;
-/** @internal — CVA variant helper; compose via Stat props instead. */
-export { statVariants };
+export {};

package/dist/types/src/app/components/status-dot.d.ts

@@ -10,7 +10,13 @@ declare const statusDotVariants: (props?: ({
     size?: "sm" | "md" | "lg" | null | undefined;
 } & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
 type StatusDotVariantProps = VariantProps<typeof statusDotVariants>;
-/** @public */
+/**
+ * @public
+ * @deprecated Use `BadgeProps` with `dot`: `tone`, `size` and `label` are the
+ * same. Badge takes no `style`, so move a `style` to a wrapper or a
+ * `className` first (MIGRATIONS.md, hds#395).
+ * @removeIn 0.21.0
+ */
 export interface StatusDotProps extends Omit<React.HTMLAttributes<HTMLSpanElement>, 'children'>, StatusDotVariantProps {
     /**
      * Accessible name for the status. When provided the dot is exposed as a
@@ -19,7 +25,15 @@ export interface StatusDotProps extends Omit<React.HTMLAttributes<HTMLSpanElemen
      */
     label?: string;
 }
-/** A small solid dot conveying a semantic status via `tone`. */
+/**
+ * A small solid dot conveying a semantic status via `tone`.
+ *
+ * @deprecated Use `<Badge dot>`: `tone`, `size` and `label` are the same, and
+ * so is the dot. Badge takes no `style`, so move a `style` to a wrapper or a
+ * `className` first (MIGRATIONS.md, hds#395). Kept in 0.20.0 because ops passes
+ * StatusDot a `style` no codemod can carry over.
+ * @removeIn 0.21.0
+ * @useInstead Badge with `dot`
+ */
 export declare const StatusDot: React.ForwardRefExoticComponent<StatusDotProps & React.RefAttributes<HTMLSpanElement>>;
-/** @internal — CVA variant helper; compose via StatusDot props instead. */
-export { statusDotVariants };
+export {};

package/dist/types/src/app/components/status-list-item.d.ts

@@ -21,5 +21,4 @@ export interface StatusListItemProps extends Omit<React.HTMLAttributes<HTMLDivEl
  * Status dot + title row with optional muted notes and trailing slot (e.g. badge).
  */
 export declare const StatusListItem: React.ForwardRefExoticComponent<StatusListItemProps & React.RefAttributes<HTMLDivElement>>;
-/** @internal — CVA variant helper; compose via StatusListItem props instead. */
-export { statusListItemDotVariants };
+export {};

package/dist/types/src/app/components/surface.d.ts

@@ -2,7 +2,7 @@ import React, { type CSSProperties, type HTMLAttributes, type ReactNode } from '
 import { type VariantProps } from 'class-variance-authority';
 import type { PaddingOption } from './surface-padding.js';
 declare const surfaceVariants: (props?: ({
-    padding?: "none" | "item" | "px16" | "px24" | "component" | null | undefined;
+    padding?: "none" | "item" | "component" | "px16" | "px24" | null | undefined;
     shadow?: boolean | null | undefined;
 } & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
 type SurfaceVariantProps = VariantProps<typeof surfaceVariants>;
@@ -26,5 +26,4 @@ export interface SurfaceProps extends Omit<HTMLAttributes<HTMLDivElement>, 'styl
 }
 /** @public */
 export declare const Surface: React.ForwardRefExoticComponent<SurfaceProps & React.RefAttributes<HTMLDivElement>>;
-/** @internal — CVA variant helper; compose via Surface props instead. */
-export { surfaceVariants };
+export {};

package/dist/types/src/app/components/switcher.d.ts

@@ -14,7 +14,7 @@
  * (column) layout once there are more than `limit` children, regardless of
  * container width — use it to stop a row from thinning out into an
  * unreadable N-up strip. Do NOT use Switcher for content that should always
- * wrap in place — use Cluster.
+ * wrap in place — use Stack with `direction="row"` and `wrap="wrap"`.
  *
  * Every Layout reference: https://every-layout.dev/layouts/the-switcher/
  */

package/dist/types/src/app/components/table.d.ts

@@ -9,19 +9,6 @@
  * @figma https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=89-300
  */
 import { type ReactNode } from 'react';
-declare const tableHeaderCellVariants: (props?: ({
-    align?: "center" | "left" | "right" | null | undefined;
-    density?: "compact" | "comfortable" | "follow" | null | undefined;
-    sticky?: boolean | null | undefined;
-} & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
-declare const tableSortButtonVariants: (props?: ({
-    align?: "center" | "left" | "right" | null | undefined;
-} & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
-declare const tableDataCellVariants: (props?: ({
-    align?: "center" | "left" | "right" | null | undefined;
-    density?: "compact" | "comfortable" | "follow" | null | undefined;
-    divider?: boolean | null | undefined;
-} & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
 /** @public */
 export type TableColumnAlign = 'left' | 'center' | 'right';
 /** @public */
@@ -91,5 +78,4 @@ export declare function Table({ columns, rows, caption, captionAction, descripti
     flush?: boolean;
     stickyHeader?: boolean;
 }): import("react/jsx-runtime").JSX.Element;
-/** @internal — CVA variant helpers; compose via Table props instead. */
-export { tableHeaderCellVariants, tableDataCellVariants, tableSortButtonVariants };
+export {};

package/dist/types/src/app/components/tag.d.ts

@@ -20,10 +20,6 @@
  * contract expects, just keyed by selection instead of tone/size/density.
  */
 import * as React from 'react';
-declare const tagButtonVariants: (props?: import("class-variance-authority/dist/types").ClassProp | undefined) => string;
-declare const tagPillVariants: (props?: ({
-    selected?: boolean | null | undefined;
-} & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
 /** @public */
 export interface TagProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, 'children'> {
     /** Tag content displayed inside the pill. */
@@ -33,5 +29,3 @@ export interface TagProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElem
 }
 /** @public */
 export declare const Tag: React.ForwardRefExoticComponent<TagProps & React.RefAttributes<HTMLButtonElement>>;
-/** @internal — CVA variant helpers; compose via Tag props instead. */
-export { tagButtonVariants, tagPillVariants };

package/dist/types/src/app/components/text.d.ts

@@ -32,5 +32,4 @@ export declare const Text: import("react").ForwardRefExoticComponent<{
     className?: string;
     style?: CSSProperties;
 } & HTMLAttributes<HTMLElement> & import("react").RefAttributes<HTMLElement>>;
-/** @internal — CVA variant helper; compose via Text props instead. */
-export { textVariants };
+export {};

package/dist/types/src/app/components/textarea.d.ts

@@ -38,5 +38,4 @@ export interface TextareaProps extends Omit<React.TextareaHTMLAttributes<HTMLTex
     textareaClassName?: string;
 }
 export declare const Textarea: React.ForwardRefExoticComponent<TextareaProps & React.RefAttributes<HTMLTextAreaElement>>;
-/** @internal — CVA variant helper; compose via Textarea props instead. */
-export { textareaVariants };
+export {};

package/dist/types/src/app/components/toast.d.ts

@@ -63,5 +63,4 @@ export interface ToastProviderProps {
  * @public
  */
 export declare function ToastProvider({ children, duration, swipeDirection, }: ToastProviderProps): import("react/jsx-runtime").JSX.Element;
-/** @internal — CVA variant helper; compose via ToastOptions.tone instead. */
-export { toastIconVariants };
+export {};

package/dist/types/src/app/components/tooltip.d.ts

@@ -5,7 +5,7 @@
 /**
  * ExpandTooltip — HDS image interaction tooltip
  *
- * A pill-shaped label (brand blue / white text) that indicates an image
+ * A pill-shaped label (accent fill / onAccent text) that indicates an image
  * is expandable. Supports two render modes:
  *
  *   'cursor'   — fixed-positioned portal tracking the mouse cursor.

package/dist/types/src/app/context/DemoStateContext.d.ts

@@ -1,7 +1,7 @@
 /**
  * DemoStateContext — React context for freezing HDS component demos into a fixed visual state.
  *
- * Replaces the forceHover/forceFocus/forcePressed prop trio on Button and NavItem.
+ * Replaces the forceHover/forceFocus/forcePressed prop trio on Button.
  * Wrap any demo with <FreezeState state="hover"> and every HDS component inside will
  * render that visual state without wiring individual force props.
  *

package/dist/types/src/app/context/RouterContext.d.ts

@@ -8,17 +8,17 @@
  *      falls back to window.location. Drop-in for apps with no router
  *      (e.g. job-hunt, a plain Vite/React app).
  *   2. react-router consumers — wrap the app once in <HdsRouterProvider> with an
- *      adapter that bridges useNavigate()/useLocation()/<Link>. The docs site
- *      does this internally via ReactRouterBridge (NOT exported).
+ *      adapter that bridges useNavigate()/useLocation()/<Link>.
  *   3. Next.js / other routers — same seam: provide an adapter mapping to that
  *      router's navigation + Link.
  *
  * IMPORTANT: this module MUST NOT import react-router (or any router). It is the
  * router-free contract every consumer can satisfy.
  *
- * @doc-ignore — provider/hook seam (like ThemeProvider et al.), not a visual
- *   component; it carries no Figma specimen or docs page, so manifest discovery
- *   must skip it despite the Hds* name prefix.
+ * @category Theming
+ * @tier primitive
+ * @usage Wrap the app root once so HDS links and navigation use your client router; with no provider they stay plain anchors.
+ * @doc-exempt: provider/hook seam like HdsThemeProvider, not a visual component; no Figma node or docs page, documented in README.md and docs/CONSUMING.md
  */
 import { type AnchorHTMLAttributes, type ReactNode } from 'react';
 /** Options forwarded to a router's navigate call (state preserved for SPA nav). */

package/dist/types/src/app/data/manifest-types.d.ts

@@ -93,12 +93,13 @@ export type ManifestComponentSpec = {
     usage?: ManifestUsage;
     keyboard?: ManifestKeyboardEntry[];
     aiRules?: string;
+    /** Deprecation notice from the component's `@deprecated` JSDoc tag (hds#390). */
+    deprecated?: string;
+    /** Release that removes the deprecated component, from `@removeIn`. */
+    removeIn?: string;
+    /** Replacement for the deprecated component, from `@useInstead` in the same block. */
+    useInstead?: string;
 };
-/**
- * Alias of ManifestComponentSpec for hds-search.ts back-compat.
- * @deprecated Use ManifestComponentSpec directly in new code.
- */
-export type ManifestSpec = ManifestComponentSpec;
 /** The root SystemManifest shape (virtual:hds-manifest). */
 export type SystemManifest = {
     name?: string;

package/dist/types/src/app/design-system/generated-token-refs.d.ts

@@ -203,6 +203,7 @@ export declare const tokenRefs: {
             readonly "64": "var(--primitive-size-64)";
             readonly "80": "var(--primitive-size-80)";
             readonly "96": "var(--primitive-size-96)";
+            readonly "120": "var(--primitive-size-120)";
             readonly interactive: {
                 readonly min: "var(--primitive-size-interactive-min)";
                 readonly minCompact: "var(--primitive-size-interactive-minCompact)";
@@ -304,6 +305,11 @@ export declare const tokenRefs: {
                     readonly inProgress: "var(--semantic-color-feedback-bg-inProgress)";
                 };
             };
+            readonly state: {
+                readonly pressed: {
+                    readonly overlay: "var(--semantic-color-state-pressed-overlay)";
+                };
+            };
         };
         readonly space: {
             readonly scale: {
@@ -511,6 +517,7 @@ export declare const tokenRefs: {
                 readonly lg: "var(--semantic-size-icon-lg)";
             };
             readonly avatar: "var(--semantic-size-avatar)";
+            readonly tile: "var(--semantic-size-tile)";
             readonly row: {
                 readonly compact: "var(--semantic-size-row-compact)";
                 readonly comfortable: "var(--semantic-size-row-comfortable)";
@@ -641,6 +648,7 @@ export declare const tokenRefs: {
         readonly "card-foreground": "var(--role-card-foreground)";
         readonly popover: "var(--role-popover)";
         readonly scrim: "var(--role-scrim)";
+        readonly "pressed-overlay": "var(--role-pressed-overlay)";
         readonly "popover-foreground": "var(--role-popover-foreground)";
         readonly primary: "var(--role-primary)";
         readonly "primary-foreground": "var(--role-primary-foreground)";

package/dist/types/src/app/design-system/generated-token-values.d.ts

@@ -204,6 +204,7 @@ export declare const tokenValues: {
             readonly "64": "64px";
             readonly "80": "80px";
             readonly "96": "96px";
+            readonly "120": "120px";
             readonly interactive: {
                 readonly min: "44px";
                 readonly minCompact: "24px";

package/dist/types/src/app/design-system/tokens.d.ts

@@ -124,16 +124,25 @@ declare const hds: {
                 xs: string;
             };
             component: {
-                /** @deprecated hds#206 — use `semantic.space.surface.padding`. */
+                /**
+                 * @deprecated hds#206 — use `semantic.space.surface.padding`.
+                 * @removeIn 1.0.0
+                 */
                 padding: string;
-                /** @deprecated hds#206 — use `semantic.space.scale.xs`. */
+                /**
+                 * @deprecated hds#206 — use `semantic.space.scale.xs`.
+                 * @removeIn 1.0.0
+                 */
                 gap: string;
             };
             stack: {
                 gap: string;
             };
             layout: {
-                /** @deprecated hds#206 — use `semantic.space.region.gutter`. */
+                /**
+                 * @deprecated hds#206 — use `semantic.space.region.gutter`.
+                 * @removeIn 1.0.0
+                 */
                 gutter: string;
                 gap: string;
                 section: string;
@@ -192,6 +201,16 @@ declare const hds: {
         medium: string;
         large: string;
     };
+    /**
+     * @deprecated hds#206 — use `hds.semantic.space.scale.*`, which compact density
+     * remaps too. Same pixels at both densities, one step down the name ladder:
+     * `density.sm` → `scale.xs`, `density.md` → `scale.sm`, `density.lg` → `scale.md`,
+     * `density.xl` → `scale.lg`, `density.xl2` → `scale.xl`. `density.xs` (4px),
+     * `density.xl3` (64px) and `density.xl4` (80px) have no scale step:
+     * `hds.space.px4` / `px64` / `px80` keep their comfortable pixels, without the
+     * compact remap.
+     * @removeIn 1.0.0
+     */
     density: {
         xs: string;
         sm: string;

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

@@ -2,7 +2,7 @@
  * @hirobius/design-system/icons
  *
  * A curated subset of Lucide (canonical 0.487.0 names) so a consumer can get
- * an `icon` for IconButton / Icon with nothing extra to install. Bare
+ * an `icon` for Icon (and Button iconOnly through it) with nothing extra to install. Bare
  * re-export from 'lucide-react' (external in the lib build, so it tree-shakes).
  * Legacy aliases (MoreHorizontal, MoreVertical, AlertTriangle, Home, Filter)
  * are intentionally not exported; use Ellipsis, EllipsisVertical,