@hirobius/design-system 0.15.0 → 0.17.0

package/dist/types/src/app/components/error-pattern.d.ts

@@ -4,5 +4,7 @@ export type ErrorPatternProps = {
     /** Supporting message explaining the recovery state to the user. */
     message?: string;
 };
-/** @public */
+/**
+ * @public
+ */
 export declare function ErrorPattern({ displayText, message, }: ErrorPatternProps): import("react/jsx-runtime").JSX.Element;

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

@@ -5,10 +5,10 @@
  */
 import * as React from 'react';
 import { type VariantProps } from 'class-variance-authority';
-declare const fieldValueVariants: (props?: {
-    tone?: "success" | "danger" | "warning" | "info" | "neutral";
-    mono?: boolean;
-} & import("class-variance-authority/dist/types").ClassProp) => string;
+declare const fieldValueVariants: (props?: ({
+    tone?: "success" | "danger" | "warning" | "info" | "neutral" | null | undefined;
+    mono?: boolean | null | undefined;
+} & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
 type FieldValueVariantProps = VariantProps<typeof fieldValueVariants>;
 /** @public */
 export interface FieldProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'children'>, FieldValueVariantProps {

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

@@ -6,10 +6,10 @@
  * @public
  */
 import * as React from 'react';
-declare const fileInputVariants: (props?: {
-    dragging?: boolean;
-    disabled?: boolean;
-} & import("class-variance-authority/dist/types").ClassProp) => string;
+declare const fileInputVariants: (props?: ({
+    dragging?: boolean | null | undefined;
+    disabled?: boolean | null | undefined;
+} & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
 export interface FileInputProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, 'type' | 'onChange'> {
     /** Called with the selected (or dropped) files. */
     onFiles?: (files: File[]) => void;
@@ -22,7 +22,9 @@ export interface FileInputProps extends Omit<React.InputHTMLAttributes<HTMLInput
     /** Disable interaction. */
     disabled?: boolean;
 }
-/** A dashed dropzone that opens the native file picker or accepts a drag-and-drop. */
+/**
+ * A dashed dropzone that opens the native file picker or accepts a drag-and-drop.
+ */
 export declare const FileInput: React.ForwardRefExoticComponent<FileInputProps & React.RefAttributes<HTMLInputElement>>;
 /** @internal — CVA variant helper; compose via FileInput props instead. */
 export { fileInputVariants };

package/dist/types/src/app/components/foundation-swatch.d.ts

@@ -35,5 +35,11 @@ export type FoundationSwatchProps = {
     /** Explicit color value (hex or CSS var name) to pin the token chip's swatch square, overriding auto-resolution from tokenPath. */
     swatchVar?: string;
 };
+/**
+ * FoundationSwatch - governed foundation specimen for color and semantic role previews.
+ *
+ * @deprecated FoundationSwatch is an HDS docs/lab internal (foundation specimen preview for the token/foundation doc pages), not a consumer-facing HDS surface. It will be retiered to `utility` (dropped from the published barrel) at the named major.
+ * @removeIn 1.0.0
+ */
 export declare function FoundationSwatch({ label, hidePreviewLabel, tokenPath, tokenDisplayPreset, previewPosition, background, value, details, foreground, specimen, note, bordered, swatchVar, }: FoundationSwatchProps): import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -1,21 +1,21 @@
 /**
- * HdsTooltip — accessible hover/focus tooltip on Radix (Overlays).
+ * Tooltip — accessible hover/focus tooltip on Radix (Overlays).
  * @category Overlays
  * @tier primitive
  * @doc-exempt: no Overlays doc page yet — add demo when the overlays page is created
  *
  * Radix Tooltip (@radix-ui/react-tooltip) themed with role tokens. Provides
  * Floating-UI collision-aware positioning, ARIA wiring, keyboard focus support,
- * open/close delay, and portal mounting out of the box. Unlike the legacy
- * `Tooltip` (an @internal image-expand pill bound to AssetImg), this is the
+ * open/close delay, and portal mounting out of the box. Unlike the
+ * internal `ExpandTooltip` (an @internal image-expand pill bound to AssetImg), this is the
  * general-purpose accessible tooltip for labelling controls.
  *
- *   <HdsTooltip>
- *     <HdsTooltip.Trigger asChild>
+ *   <Tooltip>
+ *     <Tooltip.Trigger asChild>
  *       <IconButton icon={Link} aria-label="Copy link" />
- *     </HdsTooltip.Trigger>
- *     <HdsTooltip.Content>Copy link</HdsTooltip.Content>
- *   </HdsTooltip>
+ *     </Tooltip.Trigger>
+ *     <Tooltip.Content>Copy link</Tooltip.Content>
+ *   </Tooltip>
  *
  * Skin: inverse surface bubble (semantic.color.surface.inverse) + inverse
  * content text (semantic.color.content.inverse) — these are a designed pair, so
@@ -36,10 +36,10 @@ interface HdsTooltipComponent extends React.FC<React.ComponentProps<typeof Toolt
     Content: typeof HdsTooltipContent;
 }
 /**
- * Tooltip root. Bakes in the Radix Provider so a single `<HdsTooltip>` is
+ * Tooltip root. Bakes in the Radix Provider so a single `<Tooltip>` is
  * self-contained — no app-level provider required. Controlled via
  * `open`/`onOpenChange`, or uncontrolled with `defaultOpen`.
  * @public
  */
-declare const HdsTooltip: HdsTooltipComponent;
-export { HdsTooltip };
+declare const Tooltip: HdsTooltipComponent;
+export { Tooltip };

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

@@ -18,12 +18,12 @@
  */
 import { type ElementType } from 'react';
 import { type VariantProps } from 'class-variance-authority';
-declare const headingStackVariants: (props?: {
-    gap?: "px4" | "px8";
-} & import("class-variance-authority/dist/types").ClassProp) => string;
-declare const headingStackLevelVariants: (props?: {
-    level?: "heading1" | "heading2" | "heading3";
-} & import("class-variance-authority/dist/types").ClassProp) => string;
+declare const headingStackVariants: (props?: ({
+    gap?: "px4" | "px8" | null | undefined;
+} & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
+declare const headingStackLevelVariants: (props?: ({
+    level?: "heading1" | "heading2" | "heading3" | null | undefined;
+} & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
 type HeadingStackGapVariantProps = VariantProps<typeof headingStackVariants>;
 type HeadingStackLevelVariantProps = VariantProps<typeof headingStackLevelVariants>;
 type HdsHeadingLevel = NonNullable<HeadingStackLevelVariantProps['level']>;

package/dist/types/src/app/components/hover-card.d.ts

@@ -7,7 +7,7 @@
  * Radix HoverCard (@radix-ui/react-hover-card) themed with the overlay role
  * tokens to match Menu/Popover. For sighted-pointer preview affordances (user
  * cards, link previews) — it is NOT a replacement for an accessible tooltip on
- * an interactive control; use HdsTooltip for labelling.
+ * an interactive control; use Tooltip for labelling.
  *
  *   <HoverCard>
  *     <HoverCard.Trigger asChild><InlineLink href="…">@ada</InlineLink></HoverCard.Trigger>

package/dist/types/src/app/components/image-lightbox.d.ts

@@ -9,4 +9,6 @@ export interface LightboxProps {
     captionHref?: string;
     captionLabel?: string;
 }
+/**
+ */
 export declare function Lightbox({ open, onClose, src, alt, naturalWidth, naturalHeight, caption, captionHref, captionLabel, }: LightboxProps): import("react/jsx-runtime").JSX.Element;

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

@@ -1,8 +1,8 @@
 import type { CSSProperties, ReactNode } from 'react';
 import { type VariantProps } from 'class-variance-authority';
-declare const inlineCodeVariants: (props?: {
-    density?: "compact" | "comfortable";
-} & import("class-variance-authority/dist/types").ClassProp) => string;
+declare const inlineCodeVariants: (props?: ({
+    density?: "compact" | "comfortable" | null | undefined;
+} & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
 type InlineCodeVariantProps = VariantProps<typeof inlineCodeVariants>;
 export type InlineCodeProps = {
     children: ReactNode;

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

@@ -5,9 +5,9 @@
  */
 import * as React from 'react';
 import { type VariantProps } from 'class-variance-authority';
-declare const inputGroupVariants: (props?: {
-    size?: "sm" | "md" | "lg";
-} & import("class-variance-authority/dist/types").ClassProp) => string;
+declare const inputGroupVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
 type InputGroupVariantProps = VariantProps<typeof inputGroupVariants>;
 /** @public */
 export interface InputGroupProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, 'size'>, InputGroupVariantProps {

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

@@ -6,11 +6,11 @@
  */
 import * as React from 'react';
 import { type VariantProps } from 'class-variance-authority';
-declare const inputVariants: (props?: {
-    size?: "sm" | "md" | "lg";
-    textStyle?: "body" | "mono";
-    invalid?: boolean;
-} & import("class-variance-authority/dist/types").ClassProp) => string;
+declare const inputVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+    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';
 /** @public */
 export type InputSize = NonNullable<VariantProps<typeof inputVariants>['size']>;

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

@@ -5,9 +5,9 @@
  */
 import * as React from 'react';
 import { type VariantProps } from 'class-variance-authority';
-declare const kbdVariants: (props?: {
-    size?: "sm" | "md" | "lg";
-} & import("class-variance-authority/dist/types").ClassProp) => string;
+declare const kbdVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
 type KbdVariantProps = VariantProps<typeof kbdVariants>;
 /** @public */
 export interface KbdProps extends React.HTMLAttributes<HTMLElement>, KbdVariantProps {

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

@@ -7,9 +7,9 @@
  */
 import * as React from 'react';
 import { type VariantProps } from 'class-variance-authority';
-declare const metadataListVariants: (props?: {
-    orientation?: "horizontal" | "vertical";
-} & import("class-variance-authority/dist/types").ClassProp) => string;
+declare const metadataListVariants: (props?: ({
+    orientation?: "horizontal" | "vertical" | null | undefined;
+} & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
 type MetadataListVariantProps = VariantProps<typeof metadataListVariants>;
 /** A single term/description pair rendered by MetadataList. */
 export interface MetadataListItem {

package/dist/types/src/app/components/nav-group.d.ts

@@ -7,9 +7,9 @@ type NavItem = {
     disabled?: boolean;
 };
 type NavGroupVariant = 'side' | 'toc';
-declare const navGroupLabelVariants: (props?: {
-    variant?: "side" | "toc";
-} & import("class-variance-authority/dist/types").ClassProp) => string;
+declare const navGroupLabelVariants: (props?: ({
+    variant?: "side" | "toc" | null | undefined;
+} & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
 export type NavGroupProps = {
     label?: string;
     variant?: NavGroupVariant;

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

@@ -1,13 +1,13 @@
 import type { AnchorHTMLAttributes, MouseEvent } from 'react';
 import { type VariantProps } from 'class-variance-authority';
 import { type NavLevel } from '../lib/navLevels.js';
-declare const navItemVariants: (props?: {
-    variant?: "side" | "toc";
-    state?: "default" | "active" | "disabled" | "focus" | "hover";
-} & import("class-variance-authority/dist/types").ClassProp) => string;
-declare const navIndicatorVariants: (props?: {
-    state?: "default" | "active" | "disabled" | "focus" | "hover";
-} & import("class-variance-authority/dist/types").ClassProp) => string;
+declare const navItemVariants: (props?: ({
+    variant?: "side" | "toc" | null | undefined;
+    state?: "default" | "active" | "disabled" | "focus" | "hover" | null | undefined;
+} & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
+declare const navIndicatorVariants: (props?: ({
+    state?: "default" | "active" | "disabled" | "focus" | "hover" | null | undefined;
+} & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
 type NavItemVariantProps = VariantProps<typeof navItemVariants>;
 type NavVariant = NonNullable<NavItemVariantProps['variant']>;
 type NavNativeProps = Omit<AnchorHTMLAttributes<HTMLAnchorElement>, 'children' | 'onClick'>;
@@ -25,7 +25,9 @@ export interface NavProps extends NavNativeProps {
     /** Navigation callback fired before the browser follows the link. */
     onNavigate?: (event: MouseEvent<HTMLAnchorElement>) => void;
 }
-/** @public */
+/**
+ * @public
+ */
 export declare function NavItem({ variant, label, href, active, disabled, level, onNavigate, className, style, onFocus, onMouseEnter, onMouseLeave, onPointerDown, onPointerUp, onPointerCancel, onBlur, ...rest }: NavProps): import("react/jsx-runtime").JSX.Element;
 /** @internal — CVA variant helpers; compose via NavItem props instead. */
 export { navItemVariants, navIndicatorVariants };

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

@@ -15,5 +15,7 @@ export interface OverflowListProps extends React.HTMLAttributes<HTMLDivElement>
     /** Custom renderer for the overflow node. Defaults to a muted `+N` chip. */
     renderOverflow?: (count: number) => React.ReactNode;
 }
-/** Renders up to `max` children followed by a `+N` overflow chip (or custom node). */
+/**
+ * Renders up to `max` children followed by a `+N` overflow chip (or custom node).
+ */
 export declare const OverflowList: React.ForwardRefExoticComponent<OverflowListProps & React.RefAttributes<HTMLDivElement>>;

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

@@ -38,6 +38,8 @@ export interface PageProps {
     style?: CSSProperties;
     className?: string;
 }
-/** @public */
+/**
+ * @public
+ */
 export declare function Page({ children, maxWidth, paddingY, style, className, }: PageProps): import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -6,9 +6,9 @@
  */
 import * as React from 'react';
 import { type VariantProps } from 'class-variance-authority';
-declare const progressTrackVariants: (props?: {
-    size?: "sm" | "md" | "lg";
-} & import("class-variance-authority/dist/types").ClassProp) => string;
+declare const progressTrackVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
 type ProgressVariantProps = VariantProps<typeof progressTrackVariants>;
 /** @public */
 export interface ProgressProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'role'>, ProgressVariantProps {

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

@@ -1,11 +1,11 @@
 /**
- * HdsRadio — radio button with animated selection indicator.
+ * Radio — radio button with animated selection indicator.
  * @category Inputs
  * @tier primitive
  * @figma https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=36-17
  */
 import type { InputHTMLAttributes } from 'react';
-/** HdsRadio — radio button with animated selection indicator. */
+/** Radio — radio button with animated selection indicator. */
 export type HdsRadioDemoState = 'rest' | 'hover' | 'focused' | 'pressed' | 'disabled';
 export interface RadioProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'type' | 'checked' | 'onChange'> {
     /** Radio label displayed next to the control. */
@@ -15,4 +15,4 @@ export interface RadioProps extends Omit<InputHTMLAttributes<HTMLInputElement>,
     /** Called when the radio changes. */
     onChange: (v: boolean) => void;
 }
-export declare const HdsRadio: import("react").ForwardRefExoticComponent<RadioProps & import("react").RefAttributes<HTMLInputElement>>;
+export declare const Radio: import("react").ForwardRefExoticComponent<RadioProps & import("react").RefAttributes<HTMLInputElement>>;

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

@@ -26,5 +26,7 @@ export interface RevealProps {
     /** Element rendered as the wrapper. Defaults to 'div'. */
     as?: React.ElementType;
 }
-/** @public */
+/**
+ * @public
+ */
 export declare const Reveal: React.ForwardRefExoticComponent<RevealProps & React.RefAttributes<HTMLDivElement>>;

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

@@ -1,35 +1,35 @@
 import { type VariantProps } from 'class-variance-authority';
-declare const segmentedControlWrapperVariants: (props?: {
-    fullWidth?: boolean;
-} & import("class-variance-authority/dist/types").ClassProp) => string;
-declare const segmentedControlRailVariants: (props?: {
-    variant?: "primary" | "secondary";
-    fullWidth?: boolean;
-} & import("class-variance-authority/dist/types").ClassProp) => string;
-declare const segmentedControlItemVariants: (props?: {
-    size?: "sm" | "md";
-    fullWidth?: boolean;
-    variant?: "primary" | "secondary";
-    active?: boolean;
-    interaction?: "rest" | "hover" | "pressed";
-    disabled?: boolean;
-} & import("class-variance-authority/dist/types").ClassProp) => string;
-declare const segmentedControlIndicatorVariants: (props?: {
-    variant?: "primary" | "secondary";
-    active?: boolean;
-    interaction?: "rest" | "hover" | "pressed";
-    disabled?: boolean;
-} & import("class-variance-authority/dist/types").ClassProp) => string;
-declare const segmentedControlDescriptionVariants: (props?: {
-    variant?: "primary" | "secondary";
-    active?: boolean;
-    interaction?: "rest" | "hover" | "pressed";
-    disabled?: boolean;
-} & import("class-variance-authority/dist/types").ClassProp) => string;
-declare const segmentedControlFocusRingVariants: (props?: {
-    variant?: "primary" | "secondary";
-} & import("class-variance-authority/dist/types").ClassProp) => string;
-declare const segmentedControlLabelVariants: (props?: import("class-variance-authority/dist/types").ClassProp) => string;
+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;
+    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. */

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

@@ -0,0 +1,29 @@
+/**
+ * Select — dropdown selector built on Radix Select.
+ * @category Inputs
+ * @tier primitive
+ * @figma https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=82-49
+ */
+/**
+ * Select — dropdown selector built on Radix Select (ADR-001 Radix convention).
+ * Radix owns the listbox a11y contract: managed focus + active-descendant, typeahead,
+ * full keyboard (Home/End/PageUp-Down/wrap), Popper collision/flip positioning, and
+ * dismissal. The HDS surface is styled with the token-backed Tailwind idiom used by
+ * tabs.tsx / command-palette.tsx; `ref` targets the trigger button.
+ */
+export interface SelectProps {
+    /** Select label rendered above the control. */
+    label: string;
+    /** Controls whether the label is rendered. */
+    showLabel?: boolean;
+    /** Select options displayed in the dropdown. */
+    options: {
+        value: string;
+        label: string;
+    }[];
+    /** Currently selected value. */
+    value: string;
+    /** Called when the user picks a different option. */
+    onChange: (v: string) => void;
+}
+export declare const Select: import("react").ForwardRefExoticComponent<SelectProps & import("react").RefAttributes<HTMLButtonElement>>;

package/dist/types/src/app/components/selectable-card.d.ts

@@ -10,9 +10,9 @@
  */
 import * as React from 'react';
 import { type VariantProps } from 'class-variance-authority';
-declare const selectableCardVariants: (props?: {
-    selected?: boolean;
-} & import("class-variance-authority/dist/types").ClassProp) => string;
+declare const selectableCardVariants: (props?: ({
+    selected?: boolean | null | undefined;
+} & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
 type SelectableCardVariantProps = VariantProps<typeof selectableCardVariants>;
 /** @public */
 export interface SelectableCardProps extends Omit<React.HTMLAttributes<HTMLButtonElement>, 'onSelect'>, Omit<SelectableCardVariantProps, 'selected'> {

package/dist/types/src/app/components/side-nav.d.ts

@@ -12,10 +12,12 @@ export interface SideNavProps {
     indent?: boolean | number;
     onNavigate?: (event: MouseEvent<HTMLAnchorElement>) => void;
 }
-declare const sideNavVariants: (props?: {
-    level?: "root" | "nested";
-    state?: "default" | "active" | "disabled" | "focus" | "hover";
-} & import("class-variance-authority/dist/types").ClassProp) => string;
+declare const sideNavVariants: (props?: ({
+    level?: "root" | "nested" | null | undefined;
+    state?: "default" | "active" | "disabled" | "focus" | "hover" | null | undefined;
+} & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
+/**
+ */
 export declare function SideNav({ label, href, active, disabled, titleLabel, level, indent, onNavigate, }: SideNavProps): import("react/jsx-runtime").JSX.Element;
 /** @internal — CVA variant helper; compose via SideNav props instead. */
 export { sideNavVariants };

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

@@ -6,9 +6,9 @@
  */
 import * as React from 'react';
 import { type VariantProps } from 'class-variance-authority';
-declare const skeletonVariants: (props?: {
-    variant?: "text" | "rectangular" | "circular";
-} & import("class-variance-authority/dist/types").ClassProp) => string;
+declare const skeletonVariants: (props?: ({
+    variant?: "text" | "rectangular" | "circular" | null | undefined;
+} & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
 type SkeletonVariantProps = VariantProps<typeof skeletonVariants>;
 /** @public */
 export interface SkeletonProps extends React.HTMLAttributes<HTMLDivElement>, SkeletonVariantProps {

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

@@ -10,4 +10,10 @@ export interface SketchProps {
     children: ReactNode;
     controls?: ReactNode;
 }
+/**
+ * Sketch — shared shell for generative canvases and WebGL sketches.
+ *
+ * @deprecated Sketch is an HDS docs/lab internal (shell for generative canvas/WebGL specimen pages), not a consumer-facing HDS surface. It will be retiered to `utility` (dropped from the published barrel) at the named major.
+ * @removeIn 1.0.0
+ */
 export declare function Sketch({ title, children, controls }: SketchProps): import("react/jsx-runtime").JSX.Element;

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

@@ -1,10 +1,10 @@
 /**
- * HdsSlider — range slider with label and value display.
+ * Slider — range slider with label and value display.
  * @category Inputs
  * @tier primitive
  * @figma https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=82-265
  */
-/** HdsSlider — range slider with label and value display. */
+/** Slider — range slider with label and value display. */
 export interface SliderProps {
     /** Slider label. */
     label: string;
@@ -19,4 +19,4 @@ export interface SliderProps {
     /** Called when the slider value changes. */
     onChange: (v: number) => void;
 }
-export declare const HdsSlider: import("react").ForwardRefExoticComponent<SliderProps & import("react").RefAttributes<HTMLInputElement>>;
+export declare const Slider: import("react").ForwardRefExoticComponent<SliderProps & import("react").RefAttributes<HTMLInputElement>>;

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

@@ -6,9 +6,9 @@
  */
 import * as React from 'react';
 import { type VariantProps } from 'class-variance-authority';
-declare const spinnerVariants: (props?: {
-    size?: "sm" | "md" | "lg";
-} & import("class-variance-authority/dist/types").ClassProp) => string;
+declare const spinnerVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
 type SpinnerVariantProps = VariantProps<typeof spinnerVariants>;
 /** @public */
 export interface SpinnerProps extends React.HTMLAttributes<HTMLSpanElement>, SpinnerVariantProps {

package/dist/types/src/app/components/stacked-card-rail.d.ts

@@ -0,0 +1,32 @@
+/**
+ * StackedCardRail — horizontally-scrolling stacked card carousel.
+ *
+ * Scroll mechanism: vertical scroll on an absolutely-positioned inner container
+ * is mapped to horizontal scroll on a sticky inner strip via a single scroll
+ * event listener. Cards use CSS scroll-driven animation (animation-timeline:
+ * view(x …)) for the stack/unstack effect where the browser supports it;
+ * a plain horizontal rail is the graceful fallback.
+ *
+ * Browser compat note:
+ *   - animation-timeline: view() — Chrome 115+, Firefox 110+ (behind flag until
+ *     v114), Safari 18+ (TP only as of 2025). The @supports guard ensures the
+ *     stacking animation is only applied when the feature is available; all other
+ *     browsers get a clean scrollable row.
+ *   - :has() selector (neighbour shift on hover) — Chrome 105+, FF 121+, Safari 15.4+.
+ *     Gated with @supports selector(:has(+ *)).
+ *
+ * @category Display
+ * @tier pattern
+ */
+export interface StackedCardRailCard {
+    id: string;
+    title: string;
+    category?: string;
+    coverImage?: string;
+    href?: string;
+}
+export interface StackedCardRailProps {
+    cards: StackedCardRailCard[];
+}
+export declare function StackedCardRail({ cards }: StackedCardRailProps): import("react/jsx-runtime").JSX.Element;
+export default StackedCardRail;

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

@@ -5,9 +5,9 @@
  */
 import * as React from 'react';
 import { type VariantProps } from 'class-variance-authority';
-declare const statVariants: (props?: {
-    tone?: "success" | "danger" | "warning" | "info" | "neutral";
-} & import("class-variance-authority/dist/types").ClassProp) => string;
+declare const statVariants: (props?: ({
+    tone?: "success" | "danger" | "warning" | "info" | "neutral" | null | undefined;
+} & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
 type StatVariantProps = VariantProps<typeof statVariants>;
 /** @public */
 export interface StatProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'children'>, StatVariantProps {

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

@@ -5,10 +5,10 @@
  */
 import * as React from 'react';
 import { type VariantProps } from 'class-variance-authority';
-declare const statusDotVariants: (props?: {
-    tone?: "success" | "danger" | "warning" | "info" | "neutral" | "inProgress";
-    size?: "sm" | "md" | "lg";
-} & import("class-variance-authority/dist/types").ClassProp) => string;
+declare const statusDotVariants: (props?: ({
+    tone?: "success" | "danger" | "warning" | "info" | "neutral" | "inProgress" | null | undefined;
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
 type StatusDotVariantProps = VariantProps<typeof statusDotVariants>;
 /** @public */
 export interface StatusDotProps extends Omit<React.HTMLAttributes<HTMLSpanElement>, 'children'>, StatusDotVariantProps {

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

@@ -5,9 +5,9 @@
  */
 import * as React from 'react';
 import { type VariantProps } from 'class-variance-authority';
-declare const statusListItemDotVariants: (props?: {
-    tone?: "success" | "danger" | "warning" | "info" | "neutral";
-} & import("class-variance-authority/dist/types").ClassProp) => string;
+declare const statusListItemDotVariants: (props?: ({
+    tone?: "success" | "danger" | "warning" | "info" | "neutral" | null | undefined;
+} & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
 type StatusListItemVariantProps = VariantProps<typeof statusListItemDotVariants>;
 /** @public */
 export type StatusListItemTone = NonNullable<StatusListItemVariantProps['tone']>;