@hirobius/design-system 0.15.0 → 0.17.0

package/dist/tokens.js

@@ -125,23 +125,20 @@ const a = {
         mono: ["Geist Mono", "Courier New", "monospace"]
       },
       size: {
-        "2xs": "10px",
-        xs: "13px",
-        sm: "15px",
-        base: "17px",
-        lg: "20px",
-        xl: "24px",
-        "2xl": "30px",
-        "3xl": "36px",
-        "4xl": "48px",
-        "5xl": "72px",
-        "6xl": "80px"
+        xs: "12px",
+        sm: "14px",
+        base: "16px",
+        lg: "18px",
+        xl: "20px",
+        "2xl": "24px",
+        "3xl": "30px",
+        "4xl": "36px",
+        "5xl": "48px",
+        "6xl": "60px"
       },
       weight: {
-        light: "300",
         regular: "400",
         medium: "500",
-        semibold: "600",
         bold: "700"
       },
       lineHeight: {
@@ -153,11 +150,8 @@ const a = {
         relaxed: "1.625"
       },
       letterSpacing: {
-        tighter: "-0.02em",
         tight: "-0.01em",
         normal: "0em",
-        wide: "0.01em",
-        wider: "0.02em",
         caps: "0.06em"
       }
     },
@@ -197,10 +191,12 @@ const a = {
       80: "80px",
       96: "96px",
       interactive: {
-        min: "44px"
+        min: "44px",
+        minCompact: "24px"
       },
       width: {
         96: "96px",
+        280: "280px",
         760: "760px",
         1200: "1200px",
         "50ch": "50ch"
@@ -399,8 +395,14 @@ const o = "var(--primitive-typography-family-primary)", n = "var(--primitive-typ
     brandRGB: "30,46,253",
     white: "var(--primitive-color-neutral-white)",
     surface: {
-      page: { dark: "var(--semantic-color-surface-page)", light: "var(--semantic-color-surface-page)" },
-      raised: { dark: "var(--semantic-color-surface-raised)", light: "var(--semantic-color-surface-raised)" }
+      page: {
+        dark: "var(--semantic-color-surface-page)",
+        light: "var(--semantic-color-surface-page)"
+      },
+      raised: {
+        dark: "var(--semantic-color-surface-raised)",
+        light: "var(--semantic-color-surface-raised)"
+      }
     },
     blue: {
       50: "var(--primitive-color-blue-50)",
@@ -416,17 +418,28 @@ const o = "var(--primitive-typography-family-primary)", n = "var(--primitive-typ
       900: "var(--primitive-color-blue-900)"
     },
     feedback: {
-      success: { dark: a.primitive.color.green[400], light: a.primitive.color.green[700] },
-      warning: { dark: a.primitive.color.amber[400], light: a.primitive.color.amber[800] },
-      error: { dark: a.primitive.color.red[400], light: a.primitive.color.red[700] },
-      info: { dark: a.primitive.color.blue[300], light: a.primitive.color.blue[500] }
+      success: {
+        dark: a.primitive.color.green[400],
+        light: a.primitive.color.green[700]
+      },
+      warning: {
+        dark: a.primitive.color.amber[400],
+        light: a.primitive.color.amber[800]
+      },
+      error: {
+        dark: a.primitive.color.red[400],
+        light: a.primitive.color.red[700]
+      },
+      info: {
+        dark: a.primitive.color.blue[300],
+        light: a.primitive.color.blue[500]
+      }
     }
   },
   // ── Typography ───────────────────────────────────────────────────────────────
   fontFamily: o,
   monoFamily: n,
   fontSize: {
-    "2xs": "var(--primitive-typography-size-2xs)",
     xs: "var(--primitive-typography-size-xs)",
     sm: "var(--primitive-typography-size-sm)",
     base: "var(--primitive-typography-size-base)",
@@ -440,7 +453,6 @@ const o = "var(--primitive-typography-family-primary)", n = "var(--primitive-typ
   fontWeight: {
     regular: "var(--primitive-typography-weight-regular)",
     medium: "var(--primitive-typography-weight-medium)",
-    semibold: "var(--primitive-typography-weight-semibold)",
     bold: "var(--primitive-typography-weight-bold)"
   },
   lineHeight: {
@@ -452,11 +464,8 @@ const o = "var(--primitive-typography-family-primary)", n = "var(--primitive-typ
     relaxed: "var(--primitive-typography-lineHeight-relaxed)"
   },
   letterSpacing: {
-    tighter: "var(--primitive-typography-letterSpacing-tighter)",
     tight: "var(--primitive-typography-letterSpacing-tight)",
-    normal: "var(--primitive-typography-letterSpacing-normal)",
-    wide: "var(--primitive-typography-letterSpacing-wide)",
-    wider: "var(--primitive-typography-letterSpacing-wider)"
+    normal: "var(--primitive-typography-letterSpacing-normal)"
   },
   semantic: {
     color: {
@@ -469,20 +478,41 @@ const o = "var(--primitive-typography-family-primary)", n = "var(--primitive-typ
       }
     },
     space: {
+      // hds#206 — canonical t-shirt spacing scale (slice 1: #297). Prefer this
+      // over the deprecated `component`/`layout` aliases below for new code.
+      scale: {
+        xs: "var(--semantic-space-scale-xs)",
+        sm: "var(--semantic-space-scale-sm)",
+        md: "var(--semantic-space-scale-md)",
+        lg: "var(--semantic-space-scale-lg)",
+        xl: "var(--semantic-space-scale-xl)"
+      },
+      // hds#206 slice 3 — the overridable roles. Default scale.md (24px);
+      // tenants.css overrides surface.padding per brand/density and theme.css
+      // sets region.gutter responsively (scale.lg / scale.sm).
+      surface: {
+        padding: "var(--semantic-space-surface-padding)"
+      },
+      region: {
+        gutter: "var(--semantic-space-region-gutter)"
+      },
       subgrid: {
         gap: "var(--semantic-space-subgrid-gap)",
         hairline: "var(--semantic-space-subgrid-hairline)",
         xs: "var(--semantic-space-subgrid-xs)"
       },
       component: {
-        padding: "var(--semantic-space-component-padding)",
-        gap: "var(--semantic-space-component-gap)"
+        /** @deprecated hds#206 — use `semantic.space.surface.padding`. */
+        padding: "var(--semantic-space-surface-padding)",
+        /** @deprecated hds#206 — use `semantic.space.scale.xs`. */
+        gap: "var(--semantic-space-scale-xs)"
       },
       stack: {
         gap: "var(--semantic-space-section-stack)"
       },
       layout: {
-        gutter: "var(--semantic-space-layout-gutter)",
+        /** @deprecated hds#206 — use `semantic.space.region.gutter`. */
+        gutter: "var(--semantic-space-region-gutter)",
         gap: "var(--semantic-space-layout-gap)",
         section: "var(--semantic-layout-section-paddingY)"
       },
@@ -547,12 +577,21 @@ const o = "var(--primitive-typography-family-primary)", n = "var(--primitive-typ
     labelTechnical: i.semantic.typography.mono
   },
   // ── Icons ────────────────────────────────────────────────────────────────────
+  // Sized off primitive.size, NOT the type ramp. An icon is geometry: it sits
+  // beside text, it does not scale with it. These were pointed at
+  // typography.size.base/lg/xl, which happened to read 16/20/24 — so the
+  // coupling was invisible until the ramp moved. Rescaling the ramp (hds#283)
+  // would have silently shrunk every medium icon 20→18 and every large 24→20,
+  // for no typographic reason, and no gate would have said a word.
+  //
+  // component.button.size.*.iconSize already referenced primitive.size; this
+  // brings the global bridge in line with what the component tokens do.
   iconSize: {
-    small: "var(--primitive-typography-size-base)",
+    small: "var(--primitive-size-16)",
     // 16px — default icon size
-    medium: "var(--primitive-typography-size-lg)",
+    medium: "var(--primitive-size-20)",
     // 20px — prominent icons
-    large: "var(--primitive-typography-size-xl)"
+    large: "var(--primitive-size-24)"
     // 24px — hero / large empty states
   },
   // ── Density-aware spacing ────────────────────────────────────────────────────

package/dist/types/src/app/components/activity-feed.d.ts

@@ -60,12 +60,14 @@ export interface ActivityEvent {
 export interface ActivityFeedProps {
     events: ActivityEvent[];
 }
-declare const activityToneVariants: (props?: {
-    tone?: "success" | "danger" | "warning" | "info" | "neutral";
-} & import("class-variance-authority/dist/types").ClassProp) => string;
-declare const activityAvatarVariants: (props?: import("class-variance-authority/dist/types").ClassProp) => string;
+declare const activityToneVariants: (props?: ({
+    tone?: "success" | "danger" | "warning" | "info" | "neutral" | null | undefined;
+} & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
+declare const activityAvatarVariants: (props?: import("class-variance-authority/dist/types").ClassProp | undefined) => string;
 /** @internal — demo placeholder data; supply your own ActivityEvent[] via the events prop. */
 export declare const defaultActivityEvents: ActivityEvent[];
+/**
+ */
 export declare function ActivityFeed({ events }: ActivityFeedProps): import("react/jsx-runtime").JSX.Element;
 /** @internal — CVA variant helpers; compose via ActivityFeed/ActivityEvent props instead. */
 export { activityToneVariants, activityAvatarVariants };

package/dist/types/src/app/components/app-shell.d.ts

@@ -17,9 +17,9 @@
  */
 import * as React from 'react';
 import { type VariantProps } from 'class-variance-authority';
-declare const appShellVariants: (props?: {
-    sidebarWidth?: "sm" | "md" | "lg";
-} & import("class-variance-authority/dist/types").ClassProp) => string;
+declare const appShellVariants: (props?: ({
+    sidebarWidth?: "sm" | "md" | "lg" | null | undefined;
+} & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
 type AppShellVariantProps = VariantProps<typeof appShellVariants>;
 /** @public */
 export interface AppShellProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'children'> {
@@ -32,7 +32,9 @@ export interface AppShellProps extends Omit<React.HTMLAttributes<HTMLDivElement>
     /** Sidebar width token: sm (224px) / md (256px) / lg (288px). Defaults to 'md'. */
     sidebarWidth?: NonNullable<AppShellVariantProps['sidebarWidth']>;
 }
-/** Renders a header/sidebar/main application frame, e.g. `<AppShell sidebar={<Nav />}>...</AppShell>`. */
+/**
+ * Renders a header/sidebar/main application frame, e.g. `<AppShell sidebar={<Nav />}>...</AppShell>`.
+ */
 export declare const AppShell: React.ForwardRefExoticComponent<AppShellProps & React.RefAttributes<HTMLDivElement>>;
 /** @internal — CVA variant helper; compose via AppShell props instead. */
 export { appShellVariants };

package/dist/types/src/app/components/asset-img.d.ts

@@ -49,6 +49,8 @@ export interface AssetImgProps {
  * Display asset frame with fallback placeholder handling.
  * @category Display
  */
-/** @public */
+/**
+ * @public
+ */
 export declare function AssetImg({ src, alt, title, style, className, draggable, isDark: _isDark, naturalWidth, naturalHeight, onClick, onMouseDown, onMouseMove, onMouseUp, onMouseLeave, expandable, expandLabel, context, loading, }: AssetImgProps): import("react/jsx-runtime").JSX.Element;
 export {};

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

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

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

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

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

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

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

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

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

@@ -5,9 +5,9 @@
  * @figma https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=86-159
  */
 import * as React from 'react';
-declare const crumbLabelVariants: (props?: {
-    current?: boolean;
-} & import("class-variance-authority/dist/types").ClassProp) => string;
+declare const crumbLabelVariants: (props?: ({
+    current?: boolean | null | undefined;
+} & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
 /** @public */
 export interface BreadcrumbItem {
     /** Visible label for the crumb. */

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

@@ -5,9 +5,9 @@
  */
 import * as React from 'react';
 import { type VariantProps } from 'class-variance-authority';
-declare const buttonGroupVariants: (props?: {
-    orientation?: "horizontal" | "vertical";
-} & import("class-variance-authority/dist/types").ClassProp) => string;
+declare const buttonGroupVariants: (props?: ({
+    orientation?: "horizontal" | "vertical" | null | undefined;
+} & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
 type ButtonGroupVariantProps = VariantProps<typeof buttonGroupVariants>;
 /** @public */
 export interface ButtonGroupProps extends React.HTMLAttributes<HTMLDivElement>, ButtonGroupVariantProps {

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

@@ -7,12 +7,12 @@
  */
 import * as React from 'react';
 import { type VariantProps } from 'class-variance-authority';
-declare const buttonVariants: (props?: {
-    variant?: "primary" | "secondary" | "tertiary";
-    tone?: "success" | "danger" | "warning" | "info" | "neutral";
-    size?: "sm" | "md" | "lg";
-    iconOnly?: boolean;
-} & import("class-variance-authority/dist/types").ClassProp) => string;
+declare const buttonVariants: (props?: ({
+    variant?: "primary" | "secondary" | "tertiary" | null | undefined;
+    tone?: "success" | "danger" | "warning" | "info" | "neutral" | null | undefined;
+    size?: "sm" | "md" | "lg" | null | undefined;
+    iconOnly?: boolean | null | undefined;
+} & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
 type ButtonVariantProps = VariantProps<typeof buttonVariants>;
 /** @public */
 export interface ButtonProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, 'disabled'>, Omit<ButtonVariantProps, 'iconOnly'> {

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

@@ -16,5 +16,7 @@ import * as React from 'react';
 import { DayPicker } from 'react-day-picker';
 /** @public */
 export type CalendarProps = React.ComponentProps<typeof DayPicker>;
-/** Renders an accessible month grid; compose it inside a Popover for the date inputs. */
+/**
+ * Renders an accessible month grid; compose it inside a Popover for the date inputs.
+ */
 export declare function Calendar({ className, classNames, showOutsideDays, ...props }: CalendarProps): import("react/jsx-runtime").JSX.Element;

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

@@ -6,10 +6,10 @@
 import * as React from 'react';
 import { type VariantProps } from 'class-variance-authority';
 type CalloutTone = 'accent' | 'info' | 'success' | 'warning' | 'danger';
-declare const calloutVariants: (props?: {
-    tone?: "success" | "danger" | "warning" | "info" | "accent";
-    italic?: boolean;
-} & import("class-variance-authority/dist/types").ClassProp) => string;
+declare const calloutVariants: (props?: ({
+    tone?: "success" | "danger" | "warning" | "info" | "accent" | null | undefined;
+    italic?: boolean | null | undefined;
+} & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
 type CalloutVariantProps = VariantProps<typeof calloutVariants>;
 export interface CalloutProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'style'>, Omit<CalloutVariantProps, 'italic'> {
     /** Tone — drives the left rule color and bg tint. */

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

@@ -51,11 +51,11 @@ type GapOption = 'tight' | 'normal' | 'inset' | 'spacious' | keyof typeof hds.sp
 export type CardVariant = 'default' | 'accent';
 /** @public */
 export type CardTone = 'neutral' | 'danger' | 'success' | 'warning' | 'info';
-declare const cardVariants: (props?: {
-    variant?: "default" | "accent";
-    tone?: "success" | "danger" | "warning" | "info" | "neutral";
-    bordered?: boolean;
-} & import("class-variance-authority/dist/types").ClassProp) => string;
+declare const cardVariants: (props?: ({
+    variant?: "default" | "accent" | null | undefined;
+    tone?: "success" | "danger" | "warning" | "info" | "neutral" | null | undefined;
+    bordered?: boolean | null | undefined;
+} & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
 /** @public */
 export interface CardProps extends React.HTMLAttributes<HTMLDivElement> {
     /** Render-as element for the root wrapper. */

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

@@ -6,9 +6,9 @@
  * @public
  */
 import * as React from 'react';
-declare const carouselControlVariants: (props?: {
-    variant?: "next" | "prev";
-} & import("class-variance-authority/dist/types").ClassProp) => string;
+declare const carouselControlVariants: (props?: ({
+    variant?: "next" | "prev" | null | undefined;
+} & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
 /** @public */
 export interface CarouselProps extends React.HTMLAttributes<HTMLDivElement> {
     /** Slides rendered inside the scroll-snap track. */
@@ -18,7 +18,9 @@ export interface CarouselProps extends React.HTMLAttributes<HTMLDivElement> {
     /** Show the Prev/Next scroll affordance buttons. Defaults to true. */
     showControls?: boolean;
 }
-/** Renders children as a snap-scrolling track with Prev/Next scroll buttons. */
+/**
+ * Renders children as a snap-scrolling track with Prev/Next scroll buttons.
+ */
 export declare const Carousel: React.ForwardRefExoticComponent<CarouselProps & React.RefAttributes<HTMLElement>>;
 /** @internal — CVA variant helper; compose via Carousel instead. */
 export { carouselControlVariants };

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

@@ -1,11 +1,11 @@
 /**
- * HdsCheckbox — custom-drawn checkbox with check / indeterminate glyph.
+ * Checkbox — custom-drawn checkbox with check / indeterminate glyph.
  * @category Inputs
  * @tier primitive
  * @figma https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=35-29
  */
 import type { InputHTMLAttributes } from 'react';
-/** HdsCheckbox — custom-drawn checkbox with check / indeterminate glyph. */
+/** Checkbox — custom-drawn checkbox with check / indeterminate glyph. */
 export type HdsCheckboxDemoState = 'rest' | 'hover' | 'focused' | 'pressed' | 'disabled';
 export interface CheckboxProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'type' | 'checked' | 'onChange'> {
     /** Checkbox label displayed next to the control. */
@@ -17,4 +17,4 @@ export interface CheckboxProps extends Omit<InputHTMLAttributes<HTMLInputElement
     /** Mixed state — visually a dash; supersedes the check glyph. */
     indeterminate?: boolean;
 }
-export declare const HdsCheckbox: import("react").ForwardRefExoticComponent<CheckboxProps & import("react").RefAttributes<HTMLInputElement>>;
+export declare const Checkbox: import("react").ForwardRefExoticComponent<CheckboxProps & import("react").RefAttributes<HTMLInputElement>>;

package/dist/types/src/app/components/cinematic-link.d.ts

@@ -8,5 +8,11 @@ export interface CinematicLinkProps extends Omit<React.AnchorHTMLAttributes<HTML
     href: string;
     children: string;
 }
-/** @public */
+/**
+ * CinematicLink - cinematic editorial link treatment for portfolio surfaces.
+ *
+ * @public
+ * @deprecated CinematicLink is an HDS docs/lab internal (editorial link treatment for portfolio/case-study specimen surfaces), 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 CinematicLink({ href, children, style, className, ...rest }: CinematicLinkProps): import("react/jsx-runtime").JSX.Element;

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

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

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

@@ -4,23 +4,23 @@
  * @tier primitive
  * @figma https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=89-154
  */
-declare const blockContainerVariants: (props?: import("class-variance-authority/dist/types").ClassProp) => string;
-declare const inlineWrapperVariants: (props?: import("class-variance-authority/dist/types").ClassProp) => string;
-declare const blockHeaderVariants: (props?: import("class-variance-authority/dist/types").ClassProp) => string;
-declare const collapsibleToggleVariants: (props?: import("class-variance-authority/dist/types").ClassProp) => string;
-declare const chevronVariants: (props?: {
-    expanded?: boolean;
-} & import("class-variance-authority/dist/types").ClassProp) => string;
-declare const copyButtonVariants: (props?: {
-    variant?: "block" | "inline";
-} & import("class-variance-authority/dist/types").ClassProp) => string;
-declare const inlineCodeTextVariants: (props?: {
-    truncateFromStart?: boolean;
-} & import("class-variance-authority/dist/types").ClassProp) => string;
-declare const blockCodeTextVariants: (props?: import("class-variance-authority/dist/types").ClassProp) => string;
-declare const prePanelVariants: (props?: {
-    panelBackground?: boolean;
-} & import("class-variance-authority/dist/types").ClassProp) => string;
+declare const blockContainerVariants: (props?: import("class-variance-authority/dist/types").ClassProp | undefined) => string;
+declare const inlineWrapperVariants: (props?: import("class-variance-authority/dist/types").ClassProp | undefined) => string;
+declare const blockHeaderVariants: (props?: import("class-variance-authority/dist/types").ClassProp | undefined) => string;
+declare const collapsibleToggleVariants: (props?: import("class-variance-authority/dist/types").ClassProp | undefined) => string;
+declare const chevronVariants: (props?: ({
+    expanded?: boolean | null | undefined;
+} & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
+declare const copyButtonVariants: (props?: ({
+    variant?: "block" | "inline" | null | undefined;
+} & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
+declare const inlineCodeTextVariants: (props?: ({
+    truncateFromStart?: boolean | null | undefined;
+} & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
+declare const blockCodeTextVariants: (props?: import("class-variance-authority/dist/types").ClassProp | undefined) => string;
+declare const prePanelVariants: (props?: ({
+    panelBackground?: boolean | null | undefined;
+} & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
 export interface CodeBlockProps {
     /** Code string displayed in the block. */
     code: string;
@@ -42,7 +42,9 @@ export interface CodeBlockProps {
     /** Optional class hook for layout-specific styling. */
     className?: string;
 }
-/** @public */
+/**
+ * @public
+ */
 export declare function CodeBlock({ code, variant, truncateFromStart, language, filename, collapsible, defaultExpanded, className, }: CodeBlockProps): import("react/jsx-runtime").JSX.Element;
 /** @internal — CVA variant helpers; compose via CodeBlock props instead. */
 export { blockContainerVariants, inlineWrapperVariants, blockHeaderVariants, collapsibleToggleVariants, copyButtonVariants, inlineCodeTextVariants, blockCodeTextVariants, prePanelVariants, chevronVariants, };

package/dist/types/src/app/components/command-palette.d.ts

@@ -22,15 +22,15 @@
  * stripped before render.
  */
 import * as React from 'react';
-declare const cmdkRowVariants: (props?: {
-    active?: boolean;
-} & import("class-variance-authority/dist/types").ClassProp) => string;
-declare const cmdkKindBadgeVariants: (props?: {
-    active?: boolean;
-} & import("class-variance-authority/dist/types").ClassProp) => string;
-declare const cmdkDescriptionVariants: (props?: {
-    active?: boolean;
-} & import("class-variance-authority/dist/types").ClassProp) => string;
+declare const cmdkRowVariants: (props?: ({
+    active?: boolean | null | undefined;
+} & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
+declare const cmdkKindBadgeVariants: (props?: ({
+    active?: boolean | null | undefined;
+} & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
+declare const cmdkDescriptionVariants: (props?: ({
+    active?: boolean | null | undefined;
+} & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
 export interface CommandPaletteProps {
     /** Optional className for the trigger button. */
     className?: string;

package/dist/types/src/app/components/component-instance-matrix.d.ts

@@ -6,7 +6,13 @@
  * @doc-exempt: specimen matrix helper used by docs pages, not a consumer-facing HDS surface.
  */
 import React from 'react';
-/** @public */
+/**
+ * ComponentInstanceMatrix — responsive specimen matrix for variant and state parity.
+ *
+ * @public
+ * @deprecated ComponentInstanceMatrix is an HDS docs/lab internal (specimen matrix helper for the component 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 ComponentInstanceMatrix({ componentName, dimensionX, dimensionY, title, isMobile: _isMobile, rowLabelWidth: _rowLabelWidth, rowLabelTone, freezeRowState, renderInstance, }: {
     componentName: string;
     dimensionX: string;
@@ -18,4 +24,4 @@ export declare function ComponentInstanceMatrix({ componentName, dimensionX, dim
     /** Wrap each row's rendered instance in FreezeState so the visual state is frozen. */
     freezeRowState?: boolean;
     renderInstance: (rowKey: string, columnKey: string) => React.ReactNode;
-}): import("react/jsx-runtime").JSX.Element;
+}): import("react/jsx-runtime").JSX.Element | null;

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

@@ -6,9 +6,9 @@
  */
 import React, { type CSSProperties, type ReactNode } from 'react';
 type DisclosureVariant = 'panel' | 'nav' | 'card';
-declare const disclosureTriggerVariants: (props?: {
-    variant?: "nav" | "panel" | "card";
-} & import("class-variance-authority/dist/types").ClassProp) => string;
+declare const disclosureTriggerVariants: (props?: ({
+    variant?: "nav" | "panel" | "card" | null | undefined;
+} & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
 export type DisclosureProps = {
     /** Summary label rendered in the disclosure trigger. Accepts a string or ReactNode for icon+label combos. */
     label: ReactNode;

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

@@ -6,10 +6,10 @@
  */
 import * as React from 'react';
 import { type VariantProps } from 'class-variance-authority';
-declare const dividerVariants: (props?: {
-    orientation?: "horizontal" | "vertical";
-    variant?: "default" | "strong";
-} & import("class-variance-authority/dist/types").ClassProp) => string;
+declare const dividerVariants: (props?: ({
+    orientation?: "horizontal" | "vertical" | null | undefined;
+    variant?: "default" | "strong" | null | undefined;
+} & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
 type DividerVariantProps = VariantProps<typeof dividerVariants>;
 /** @public */
 export interface DividerProps extends Omit<React.HTMLAttributes<HTMLHRElement>, 'children'>, DividerVariantProps {

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

@@ -21,10 +21,12 @@ export interface DocLinkCardProps {
     /** Directional affordance for the header icon. */
     affordance?: 'up-right' | 'right' | 'left';
 }
-declare const docLinkCardVariants: (props?: {
-    variant?: "feature" | "pager";
-} & import("class-variance-authority/dist/types").ClassProp) => string;
-/** @public */
+declare const docLinkCardVariants: (props?: ({
+    variant?: "feature" | "pager" | null | undefined;
+} & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
+/**
+ * @public
+ */
 export declare function DocLinkCard({ title, description, href, icon: CardIcon, meta, metaStyle, accent, variant, disabled, affordance, }: DocLinkCardProps): import("react/jsx-runtime").JSX.Element;
 /** @internal — CVA variant helper; compose via DocLinkCard props instead. */
 export { docLinkCardVariants };