@hirobius/design-system 0.16.0 → 0.17.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (89) hide show
  1. package/README.md +25 -69
  2. package/dist/chunks/LanguageContext-CH_bwzCq.js +83 -0
  3. package/dist/chunks/TokenDisplayContext-evZi_214.js +18 -0
  4. package/dist/chunks/activity-feed-C8_e-Btq.js +19955 -0
  5. package/dist/contexts.js +17 -16
  6. package/dist/hirobius-ui.js +3652 -23311
  7. package/dist/manifest.js +5 -5
  8. package/dist/patterns.js +423 -0
  9. package/dist/static.css +4 -4
  10. package/dist/styles.css +1 -1
  11. package/dist/tokens.css +1 -1
  12. package/dist/tokens.js +34 -13
  13. package/dist/types/src/app/components/activity-feed.d.ts +6 -4
  14. package/dist/types/src/app/components/app-shell.d.ts +6 -4
  15. package/dist/types/src/app/components/asset-img.d.ts +3 -1
  16. package/dist/types/src/app/components/avatar-group.d.ts +3 -3
  17. package/dist/types/src/app/components/avatar.d.ts +3 -3
  18. package/dist/types/src/app/components/badge.d.ts +3 -3
  19. package/dist/types/src/app/components/blockquote.d.ts +3 -3
  20. package/dist/types/src/app/components/breadcrumb.d.ts +3 -3
  21. package/dist/types/src/app/components/button-group.d.ts +3 -3
  22. package/dist/types/src/app/components/button.d.ts +6 -6
  23. package/dist/types/src/app/components/calendar.d.ts +3 -1
  24. package/dist/types/src/app/components/callout.d.ts +4 -4
  25. package/dist/types/src/app/components/card.d.ts +5 -5
  26. package/dist/types/src/app/components/carousel.d.ts +6 -4
  27. package/dist/types/src/app/components/checkbox.d.ts +3 -3
  28. package/dist/types/src/app/components/circular-progress.d.ts +3 -3
  29. package/dist/types/src/app/components/code-block.d.ts +20 -18
  30. package/dist/types/src/app/components/command-palette.d.ts +9 -9
  31. package/dist/types/src/app/components/component-instance-matrix.d.ts +1 -1
  32. package/dist/types/src/app/components/disclosure.d.ts +3 -3
  33. package/dist/types/src/app/components/divider.d.ts +4 -4
  34. package/dist/types/src/app/components/doc-link-card.d.ts +6 -4
  35. package/dist/types/src/app/components/error-pattern.d.ts +3 -1
  36. package/dist/types/src/app/components/field.d.ts +4 -4
  37. package/dist/types/src/app/components/file-input.d.ts +7 -5
  38. package/dist/types/src/app/components/hds-tooltip.d.ts +11 -11
  39. package/dist/types/src/app/components/heading-stack.d.ts +6 -6
  40. package/dist/types/src/app/components/hover-card.d.ts +1 -1
  41. package/dist/types/src/app/components/image-lightbox.d.ts +2 -0
  42. package/dist/types/src/app/components/inline-code.d.ts +3 -3
  43. package/dist/types/src/app/components/input-group.d.ts +3 -3
  44. package/dist/types/src/app/components/input.d.ts +5 -5
  45. package/dist/types/src/app/components/kbd.d.ts +3 -3
  46. package/dist/types/src/app/components/metadata-list.d.ts +3 -3
  47. package/dist/types/src/app/components/nav-group.d.ts +3 -3
  48. package/dist/types/src/app/components/nav-item.d.ts +10 -8
  49. package/dist/types/src/app/components/overflow-list.d.ts +3 -1
  50. package/dist/types/src/app/components/page.d.ts +3 -1
  51. package/dist/types/src/app/components/progress.d.ts +3 -3
  52. package/dist/types/src/app/components/radio.d.ts +3 -3
  53. package/dist/types/src/app/components/reveal.d.ts +3 -1
  54. package/dist/types/src/app/components/segmented-control.d.ts +31 -31
  55. package/dist/types/src/app/components/select.d.ts +3 -3
  56. package/dist/types/src/app/components/selectable-card.d.ts +3 -3
  57. package/dist/types/src/app/components/side-nav.d.ts +6 -4
  58. package/dist/types/src/app/components/skeleton.d.ts +3 -3
  59. package/dist/types/src/app/components/slider.d.ts +3 -3
  60. package/dist/types/src/app/components/spinner.d.ts +3 -3
  61. package/dist/types/src/app/components/stacked-card-rail.d.ts +32 -0
  62. package/dist/types/src/app/components/stat.d.ts +3 -3
  63. package/dist/types/src/app/components/status-dot.d.ts +4 -4
  64. package/dist/types/src/app/components/status-list-item.d.ts +3 -3
  65. package/dist/types/src/app/components/stepper.d.ts +6 -4
  66. package/dist/types/src/app/components/surface.d.ts +4 -4
  67. package/dist/types/src/app/components/table.d.ts +22 -11
  68. package/dist/types/src/app/components/tag.d.ts +4 -4
  69. package/dist/types/src/app/components/text.d.ts +3 -3
  70. package/dist/types/src/app/components/textarea.d.ts +4 -4
  71. package/dist/types/src/app/components/time-input.d.ts +3 -3
  72. package/dist/types/src/app/components/toast.d.ts +3 -3
  73. package/dist/types/src/app/components/toggle-button.d.ts +4 -4
  74. package/dist/types/src/app/components/toggle.d.ts +3 -3
  75. package/dist/types/src/app/components/token.d.ts +16 -16
  76. package/dist/types/src/app/components/toolbar.d.ts +1 -1
  77. package/dist/types/src/app/components/tooltip.d.ts +2 -2
  78. package/dist/types/src/app/components/top-nav.d.ts +3 -1
  79. package/dist/types/src/app/components/tree-list.d.ts +3 -1
  80. package/dist/types/src/app/design-system/generated-token-refs.d.ts +36 -0
  81. package/dist/types/src/app/design-system/generated-token-values.d.ts +10 -10
  82. package/dist/types/src/app/design-system/tokens.d.ts +16 -0
  83. package/dist/types/src/index.d.ts +193 -8
  84. package/dist/types/src/patterns.d.ts +37 -0
  85. package/dist/variables.css +42 -22
  86. package/hirobius.tokens.json +178 -57
  87. package/package.json +12 -9
  88. package/public/hds-manifest.json +473 -445
  89. package/dist/chunks/TokenDisplayContext-B3gxyQN7.js +0 -96
package/dist/tokens.js CHANGED
@@ -125,16 +125,16 @@ const a = {
125
125
  mono: ["Geist Mono", "Courier New", "monospace"]
126
126
  },
127
127
  size: {
128
- xs: "13px",
129
- sm: "15px",
130
- base: "17px",
131
- lg: "20px",
132
- xl: "24px",
133
- "2xl": "30px",
134
- "3xl": "36px",
135
- "4xl": "48px",
136
- "5xl": "72px",
137
- "6xl": "80px"
128
+ xs: "12px",
129
+ sm: "14px",
130
+ base: "16px",
131
+ lg: "18px",
132
+ xl: "20px",
133
+ "2xl": "24px",
134
+ "3xl": "30px",
135
+ "4xl": "36px",
136
+ "5xl": "48px",
137
+ "6xl": "60px"
138
138
  },
139
139
  weight: {
140
140
  regular: "400",
@@ -478,20 +478,41 @@ const o = "var(--primitive-typography-family-primary)", n = "var(--primitive-typ
478
478
  }
479
479
  },
480
480
  space: {
481
+ // hds#206 — canonical t-shirt spacing scale (slice 1: #297). Prefer this
482
+ // over the deprecated `component`/`layout` aliases below for new code.
483
+ scale: {
484
+ xs: "var(--semantic-space-scale-xs)",
485
+ sm: "var(--semantic-space-scale-sm)",
486
+ md: "var(--semantic-space-scale-md)",
487
+ lg: "var(--semantic-space-scale-lg)",
488
+ xl: "var(--semantic-space-scale-xl)"
489
+ },
490
+ // hds#206 slice 3 — the overridable roles. Default scale.md (24px);
491
+ // tenants.css overrides surface.padding per brand/density and theme.css
492
+ // sets region.gutter responsively (scale.lg / scale.sm).
493
+ surface: {
494
+ padding: "var(--semantic-space-surface-padding)"
495
+ },
496
+ region: {
497
+ gutter: "var(--semantic-space-region-gutter)"
498
+ },
481
499
  subgrid: {
482
500
  gap: "var(--semantic-space-subgrid-gap)",
483
501
  hairline: "var(--semantic-space-subgrid-hairline)",
484
502
  xs: "var(--semantic-space-subgrid-xs)"
485
503
  },
486
504
  component: {
487
- padding: "var(--semantic-space-component-padding)",
488
- gap: "var(--semantic-space-component-gap)"
505
+ /** @deprecated hds#206 — use `semantic.space.surface.padding`. */
506
+ padding: "var(--semantic-space-surface-padding)",
507
+ /** @deprecated hds#206 — use `semantic.space.scale.xs`. */
508
+ gap: "var(--semantic-space-scale-xs)"
489
509
  },
490
510
  stack: {
491
511
  gap: "var(--semantic-space-section-stack)"
492
512
  },
493
513
  layout: {
494
- gutter: "var(--semantic-space-layout-gutter)",
514
+ /** @deprecated hds#206 — use `semantic.space.region.gutter`. */
515
+ gutter: "var(--semantic-space-region-gutter)",
495
516
  gap: "var(--semantic-space-layout-gap)",
496
517
  section: "var(--semantic-layout-section-paddingY)"
497
518
  },
@@ -60,12 +60,14 @@ export interface ActivityEvent {
60
60
  export interface ActivityFeedProps {
61
61
  events: ActivityEvent[];
62
62
  }
63
- declare const activityToneVariants: (props?: {
64
- tone?: "success" | "danger" | "warning" | "info" | "neutral";
65
- } & import("class-variance-authority/dist/types").ClassProp) => string;
66
- declare const activityAvatarVariants: (props?: import("class-variance-authority/dist/types").ClassProp) => string;
63
+ declare const activityToneVariants: (props?: ({
64
+ tone?: "success" | "danger" | "warning" | "info" | "neutral" | null | undefined;
65
+ } & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
66
+ declare const activityAvatarVariants: (props?: import("class-variance-authority/dist/types").ClassProp | undefined) => string;
67
67
  /** @internal — demo placeholder data; supply your own ActivityEvent[] via the events prop. */
68
68
  export declare const defaultActivityEvents: ActivityEvent[];
69
+ /**
70
+ */
69
71
  export declare function ActivityFeed({ events }: ActivityFeedProps): import("react/jsx-runtime").JSX.Element;
70
72
  /** @internal — CVA variant helpers; compose via ActivityFeed/ActivityEvent props instead. */
71
73
  export { activityToneVariants, activityAvatarVariants };
@@ -17,9 +17,9 @@
17
17
  */
18
18
  import * as React from 'react';
19
19
  import { type VariantProps } from 'class-variance-authority';
20
- declare const appShellVariants: (props?: {
21
- sidebarWidth?: "sm" | "md" | "lg";
22
- } & import("class-variance-authority/dist/types").ClassProp) => string;
20
+ declare const appShellVariants: (props?: ({
21
+ sidebarWidth?: "sm" | "md" | "lg" | null | undefined;
22
+ } & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
23
23
  type AppShellVariantProps = VariantProps<typeof appShellVariants>;
24
24
  /** @public */
25
25
  export interface AppShellProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'children'> {
@@ -32,7 +32,9 @@ export interface AppShellProps extends Omit<React.HTMLAttributes<HTMLDivElement>
32
32
  /** Sidebar width token: sm (224px) / md (256px) / lg (288px). Defaults to 'md'. */
33
33
  sidebarWidth?: NonNullable<AppShellVariantProps['sidebarWidth']>;
34
34
  }
35
- /** Renders a header/sidebar/main application frame, e.g. `<AppShell sidebar={<Nav />}>...</AppShell>`. */
35
+ /**
36
+ * Renders a header/sidebar/main application frame, e.g. `<AppShell sidebar={<Nav />}>...</AppShell>`.
37
+ */
36
38
  export declare const AppShell: React.ForwardRefExoticComponent<AppShellProps & React.RefAttributes<HTMLDivElement>>;
37
39
  /** @internal — CVA variant helper; compose via AppShell props instead. */
38
40
  export { appShellVariants };
@@ -49,6 +49,8 @@ export interface AssetImgProps {
49
49
  * Display asset frame with fallback placeholder handling.
50
50
  * @category Display
51
51
  */
52
- /** @public */
52
+ /**
53
+ * @public
54
+ */
53
55
  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;
54
56
  export {};
@@ -5,9 +5,9 @@
5
5
  */
6
6
  import * as React from 'react';
7
7
  import { type VariantProps } from 'class-variance-authority';
8
- declare const overflowBubbleVariants: (props?: {
9
- size?: "sm" | "md" | "lg";
10
- } & import("class-variance-authority/dist/types").ClassProp) => string;
8
+ declare const overflowBubbleVariants: (props?: ({
9
+ size?: "sm" | "md" | "lg" | null | undefined;
10
+ } & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
11
11
  type OverflowBubbleVariantProps = VariantProps<typeof overflowBubbleVariants>;
12
12
  /** @public */
13
13
  export interface AvatarGroupProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'children'>, OverflowBubbleVariantProps {
@@ -6,9 +6,9 @@
6
6
  */
7
7
  import * as React from 'react';
8
8
  import { type VariantProps } from 'class-variance-authority';
9
- declare const avatarVariants: (props?: {
10
- size?: "sm" | "md" | "lg";
11
- } & import("class-variance-authority/dist/types").ClassProp) => string;
9
+ declare const avatarVariants: (props?: ({
10
+ size?: "sm" | "md" | "lg" | null | undefined;
11
+ } & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
12
12
  type AvatarVariantProps = VariantProps<typeof avatarVariants>;
13
13
  /** @public */
14
14
  export interface AvatarProps extends Omit<React.HTMLAttributes<HTMLSpanElement>, 'children'>, AvatarVariantProps {
@@ -6,9 +6,9 @@
6
6
  */
7
7
  import * as React from 'react';
8
8
  import { type VariantProps } from 'class-variance-authority';
9
- declare const badgeVariants: (props?: {
10
- tone?: "success" | "danger" | "warning" | "info" | "neutral" | "inProgress";
11
- } & import("class-variance-authority/dist/types").ClassProp) => string;
9
+ declare const badgeVariants: (props?: ({
10
+ tone?: "success" | "danger" | "warning" | "info" | "neutral" | "inProgress" | null | undefined;
11
+ } & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
12
12
  type BadgeVariantProps = VariantProps<typeof badgeVariants>;
13
13
  /** @public */
14
14
  export interface BadgeProps extends Omit<React.HTMLAttributes<HTMLSpanElement>, 'style'>, BadgeVariantProps {
@@ -5,9 +5,9 @@
5
5
  */
6
6
  import * as React from 'react';
7
7
  import { type VariantProps } from 'class-variance-authority';
8
- declare const blockquoteVariants: (props?: {
9
- size?: "sm" | "md" | "lg";
10
- } & import("class-variance-authority/dist/types").ClassProp) => string;
8
+ declare const blockquoteVariants: (props?: ({
9
+ size?: "sm" | "md" | "lg" | null | undefined;
10
+ } & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
11
11
  type BlockquoteVariantProps = VariantProps<typeof blockquoteVariants>;
12
12
  /** @public */
13
13
  export interface BlockquoteProps extends React.BlockquoteHTMLAttributes<HTMLQuoteElement>, BlockquoteVariantProps {
@@ -5,9 +5,9 @@
5
5
  * @figma https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=86-159
6
6
  */
7
7
  import * as React from 'react';
8
- declare const crumbLabelVariants: (props?: {
9
- current?: boolean;
10
- } & import("class-variance-authority/dist/types").ClassProp) => string;
8
+ declare const crumbLabelVariants: (props?: ({
9
+ current?: boolean | null | undefined;
10
+ } & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
11
11
  /** @public */
12
12
  export interface BreadcrumbItem {
13
13
  /** Visible label for the crumb. */
@@ -5,9 +5,9 @@
5
5
  */
6
6
  import * as React from 'react';
7
7
  import { type VariantProps } from 'class-variance-authority';
8
- declare const buttonGroupVariants: (props?: {
9
- orientation?: "horizontal" | "vertical";
10
- } & import("class-variance-authority/dist/types").ClassProp) => string;
8
+ declare const buttonGroupVariants: (props?: ({
9
+ orientation?: "horizontal" | "vertical" | null | undefined;
10
+ } & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
11
11
  type ButtonGroupVariantProps = VariantProps<typeof buttonGroupVariants>;
12
12
  /** @public */
13
13
  export interface ButtonGroupProps extends React.HTMLAttributes<HTMLDivElement>, ButtonGroupVariantProps {
@@ -7,12 +7,12 @@
7
7
  */
8
8
  import * as React from 'react';
9
9
  import { type VariantProps } from 'class-variance-authority';
10
- declare const buttonVariants: (props?: {
11
- variant?: "primary" | "secondary" | "tertiary";
12
- tone?: "success" | "danger" | "warning" | "info" | "neutral";
13
- size?: "sm" | "md" | "lg";
14
- iconOnly?: boolean;
15
- } & import("class-variance-authority/dist/types").ClassProp) => string;
10
+ declare const buttonVariants: (props?: ({
11
+ variant?: "primary" | "secondary" | "tertiary" | null | undefined;
12
+ tone?: "success" | "danger" | "warning" | "info" | "neutral" | null | undefined;
13
+ size?: "sm" | "md" | "lg" | null | undefined;
14
+ iconOnly?: boolean | null | undefined;
15
+ } & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
16
16
  type ButtonVariantProps = VariantProps<typeof buttonVariants>;
17
17
  /** @public */
18
18
  export interface ButtonProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, 'disabled'>, Omit<ButtonVariantProps, 'iconOnly'> {
@@ -16,5 +16,7 @@ import * as React from 'react';
16
16
  import { DayPicker } from 'react-day-picker';
17
17
  /** @public */
18
18
  export type CalendarProps = React.ComponentProps<typeof DayPicker>;
19
- /** Renders an accessible month grid; compose it inside a Popover for the date inputs. */
19
+ /**
20
+ * Renders an accessible month grid; compose it inside a Popover for the date inputs.
21
+ */
20
22
  export declare function Calendar({ className, classNames, showOutsideDays, ...props }: CalendarProps): import("react/jsx-runtime").JSX.Element;
@@ -6,10 +6,10 @@
6
6
  import * as React from 'react';
7
7
  import { type VariantProps } from 'class-variance-authority';
8
8
  type CalloutTone = 'accent' | 'info' | 'success' | 'warning' | 'danger';
9
- declare const calloutVariants: (props?: {
10
- tone?: "success" | "danger" | "warning" | "info" | "accent";
11
- italic?: boolean;
12
- } & import("class-variance-authority/dist/types").ClassProp) => string;
9
+ declare const calloutVariants: (props?: ({
10
+ tone?: "success" | "danger" | "warning" | "info" | "accent" | null | undefined;
11
+ italic?: boolean | null | undefined;
12
+ } & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
13
13
  type CalloutVariantProps = VariantProps<typeof calloutVariants>;
14
14
  export interface CalloutProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'style'>, Omit<CalloutVariantProps, 'italic'> {
15
15
  /** Tone — drives the left rule color and bg tint. */
@@ -51,11 +51,11 @@ type GapOption = 'tight' | 'normal' | 'inset' | 'spacious' | keyof typeof hds.sp
51
51
  export type CardVariant = 'default' | 'accent';
52
52
  /** @public */
53
53
  export type CardTone = 'neutral' | 'danger' | 'success' | 'warning' | 'info';
54
- declare const cardVariants: (props?: {
55
- variant?: "default" | "accent";
56
- tone?: "success" | "danger" | "warning" | "info" | "neutral";
57
- bordered?: boolean;
58
- } & import("class-variance-authority/dist/types").ClassProp) => string;
54
+ declare const cardVariants: (props?: ({
55
+ variant?: "default" | "accent" | null | undefined;
56
+ tone?: "success" | "danger" | "warning" | "info" | "neutral" | null | undefined;
57
+ bordered?: boolean | null | undefined;
58
+ } & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
59
59
  /** @public */
60
60
  export interface CardProps extends React.HTMLAttributes<HTMLDivElement> {
61
61
  /** Render-as element for the root wrapper. */
@@ -6,9 +6,9 @@
6
6
  * @public
7
7
  */
8
8
  import * as React from 'react';
9
- declare const carouselControlVariants: (props?: {
10
- variant?: "next" | "prev";
11
- } & import("class-variance-authority/dist/types").ClassProp) => string;
9
+ declare const carouselControlVariants: (props?: ({
10
+ variant?: "next" | "prev" | null | undefined;
11
+ } & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
12
12
  /** @public */
13
13
  export interface CarouselProps extends React.HTMLAttributes<HTMLDivElement> {
14
14
  /** Slides rendered inside the scroll-snap track. */
@@ -18,7 +18,9 @@ export interface CarouselProps extends React.HTMLAttributes<HTMLDivElement> {
18
18
  /** Show the Prev/Next scroll affordance buttons. Defaults to true. */
19
19
  showControls?: boolean;
20
20
  }
21
- /** Renders children as a snap-scrolling track with Prev/Next scroll buttons. */
21
+ /**
22
+ * Renders children as a snap-scrolling track with Prev/Next scroll buttons.
23
+ */
22
24
  export declare const Carousel: React.ForwardRefExoticComponent<CarouselProps & React.RefAttributes<HTMLElement>>;
23
25
  /** @internal — CVA variant helper; compose via Carousel instead. */
24
26
  export { carouselControlVariants };
@@ -1,11 +1,11 @@
1
1
  /**
2
- * HdsCheckbox — custom-drawn checkbox with check / indeterminate glyph.
2
+ * Checkbox — custom-drawn checkbox with check / indeterminate glyph.
3
3
  * @category Inputs
4
4
  * @tier primitive
5
5
  * @figma https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=35-29
6
6
  */
7
7
  import type { InputHTMLAttributes } from 'react';
8
- /** HdsCheckbox — custom-drawn checkbox with check / indeterminate glyph. */
8
+ /** Checkbox — custom-drawn checkbox with check / indeterminate glyph. */
9
9
  export type HdsCheckboxDemoState = 'rest' | 'hover' | 'focused' | 'pressed' | 'disabled';
10
10
  export interface CheckboxProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'type' | 'checked' | 'onChange'> {
11
11
  /** Checkbox label displayed next to the control. */
@@ -17,4 +17,4 @@ export interface CheckboxProps extends Omit<InputHTMLAttributes<HTMLInputElement
17
17
  /** Mixed state — visually a dash; supersedes the check glyph. */
18
18
  indeterminate?: boolean;
19
19
  }
20
- export declare const HdsCheckbox: import("react").ForwardRefExoticComponent<CheckboxProps & import("react").RefAttributes<HTMLInputElement>>;
20
+ export declare const Checkbox: import("react").ForwardRefExoticComponent<CheckboxProps & import("react").RefAttributes<HTMLInputElement>>;
@@ -5,9 +5,9 @@
5
5
  */
6
6
  import * as React from 'react';
7
7
  import { type VariantProps } from 'class-variance-authority';
8
- declare const circularProgressVariants: (props?: {
9
- tone?: "success" | "danger" | "warning" | "info" | "neutral";
10
- } & import("class-variance-authority/dist/types").ClassProp) => string;
8
+ declare const circularProgressVariants: (props?: ({
9
+ tone?: "success" | "danger" | "warning" | "info" | "neutral" | null | undefined;
10
+ } & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
11
11
  type CircularProgressVariantProps = VariantProps<typeof circularProgressVariants>;
12
12
  /** @public */
13
13
  export interface CircularProgressProps extends React.HTMLAttributes<HTMLSpanElement>, CircularProgressVariantProps {
@@ -4,23 +4,23 @@
4
4
  * @tier primitive
5
5
  * @figma https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=89-154
6
6
  */
7
- declare const blockContainerVariants: (props?: import("class-variance-authority/dist/types").ClassProp) => string;
8
- declare const inlineWrapperVariants: (props?: import("class-variance-authority/dist/types").ClassProp) => string;
9
- declare const blockHeaderVariants: (props?: import("class-variance-authority/dist/types").ClassProp) => string;
10
- declare const collapsibleToggleVariants: (props?: import("class-variance-authority/dist/types").ClassProp) => string;
11
- declare const chevronVariants: (props?: {
12
- expanded?: boolean;
13
- } & import("class-variance-authority/dist/types").ClassProp) => string;
14
- declare const copyButtonVariants: (props?: {
15
- variant?: "block" | "inline";
16
- } & import("class-variance-authority/dist/types").ClassProp) => string;
17
- declare const inlineCodeTextVariants: (props?: {
18
- truncateFromStart?: boolean;
19
- } & import("class-variance-authority/dist/types").ClassProp) => string;
20
- declare const blockCodeTextVariants: (props?: import("class-variance-authority/dist/types").ClassProp) => string;
21
- declare const prePanelVariants: (props?: {
22
- panelBackground?: boolean;
23
- } & import("class-variance-authority/dist/types").ClassProp) => string;
7
+ declare const blockContainerVariants: (props?: import("class-variance-authority/dist/types").ClassProp | undefined) => string;
8
+ declare const inlineWrapperVariants: (props?: import("class-variance-authority/dist/types").ClassProp | undefined) => string;
9
+ declare const blockHeaderVariants: (props?: import("class-variance-authority/dist/types").ClassProp | undefined) => string;
10
+ declare const collapsibleToggleVariants: (props?: import("class-variance-authority/dist/types").ClassProp | undefined) => string;
11
+ declare const chevronVariants: (props?: ({
12
+ expanded?: boolean | null | undefined;
13
+ } & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
14
+ declare const copyButtonVariants: (props?: ({
15
+ variant?: "block" | "inline" | null | undefined;
16
+ } & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
17
+ declare const inlineCodeTextVariants: (props?: ({
18
+ truncateFromStart?: boolean | null | undefined;
19
+ } & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
20
+ declare const blockCodeTextVariants: (props?: import("class-variance-authority/dist/types").ClassProp | undefined) => string;
21
+ declare const prePanelVariants: (props?: ({
22
+ panelBackground?: boolean | null | undefined;
23
+ } & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
24
24
  export interface CodeBlockProps {
25
25
  /** Code string displayed in the block. */
26
26
  code: string;
@@ -42,7 +42,9 @@ export interface CodeBlockProps {
42
42
  /** Optional class hook for layout-specific styling. */
43
43
  className?: string;
44
44
  }
45
- /** @public */
45
+ /**
46
+ * @public
47
+ */
46
48
  export declare function CodeBlock({ code, variant, truncateFromStart, language, filename, collapsible, defaultExpanded, className, }: CodeBlockProps): import("react/jsx-runtime").JSX.Element;
47
49
  /** @internal — CVA variant helpers; compose via CodeBlock props instead. */
48
50
  export { blockContainerVariants, inlineWrapperVariants, blockHeaderVariants, collapsibleToggleVariants, copyButtonVariants, inlineCodeTextVariants, blockCodeTextVariants, prePanelVariants, chevronVariants, };
@@ -22,15 +22,15 @@
22
22
  * stripped before render.
23
23
  */
24
24
  import * as React from 'react';
25
- declare const cmdkRowVariants: (props?: {
26
- active?: boolean;
27
- } & import("class-variance-authority/dist/types").ClassProp) => string;
28
- declare const cmdkKindBadgeVariants: (props?: {
29
- active?: boolean;
30
- } & import("class-variance-authority/dist/types").ClassProp) => string;
31
- declare const cmdkDescriptionVariants: (props?: {
32
- active?: boolean;
33
- } & import("class-variance-authority/dist/types").ClassProp) => string;
25
+ declare const cmdkRowVariants: (props?: ({
26
+ active?: boolean | null | undefined;
27
+ } & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
28
+ declare const cmdkKindBadgeVariants: (props?: ({
29
+ active?: boolean | null | undefined;
30
+ } & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
31
+ declare const cmdkDescriptionVariants: (props?: ({
32
+ active?: boolean | null | undefined;
33
+ } & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
34
34
  export interface CommandPaletteProps {
35
35
  /** Optional className for the trigger button. */
36
36
  className?: string;
@@ -24,4 +24,4 @@ export declare function ComponentInstanceMatrix({ componentName, dimensionX, dim
24
24
  /** Wrap each row's rendered instance in FreezeState so the visual state is frozen. */
25
25
  freezeRowState?: boolean;
26
26
  renderInstance: (rowKey: string, columnKey: string) => React.ReactNode;
27
- }): import("react/jsx-runtime").JSX.Element;
27
+ }): import("react/jsx-runtime").JSX.Element | null;
@@ -6,9 +6,9 @@
6
6
  */
7
7
  import React, { type CSSProperties, type ReactNode } from 'react';
8
8
  type DisclosureVariant = 'panel' | 'nav' | 'card';
9
- declare const disclosureTriggerVariants: (props?: {
10
- variant?: "nav" | "panel" | "card";
11
- } & import("class-variance-authority/dist/types").ClassProp) => string;
9
+ declare const disclosureTriggerVariants: (props?: ({
10
+ variant?: "nav" | "panel" | "card" | null | undefined;
11
+ } & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
12
12
  export type DisclosureProps = {
13
13
  /** Summary label rendered in the disclosure trigger. Accepts a string or ReactNode for icon+label combos. */
14
14
  label: ReactNode;
@@ -6,10 +6,10 @@
6
6
  */
7
7
  import * as React from 'react';
8
8
  import { type VariantProps } from 'class-variance-authority';
9
- declare const dividerVariants: (props?: {
10
- orientation?: "horizontal" | "vertical";
11
- variant?: "default" | "strong";
12
- } & import("class-variance-authority/dist/types").ClassProp) => string;
9
+ declare const dividerVariants: (props?: ({
10
+ orientation?: "horizontal" | "vertical" | null | undefined;
11
+ variant?: "default" | "strong" | null | undefined;
12
+ } & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
13
13
  type DividerVariantProps = VariantProps<typeof dividerVariants>;
14
14
  /** @public */
15
15
  export interface DividerProps extends Omit<React.HTMLAttributes<HTMLHRElement>, 'children'>, DividerVariantProps {
@@ -21,10 +21,12 @@ export interface DocLinkCardProps {
21
21
  /** Directional affordance for the header icon. */
22
22
  affordance?: 'up-right' | 'right' | 'left';
23
23
  }
24
- declare const docLinkCardVariants: (props?: {
25
- variant?: "feature" | "pager";
26
- } & import("class-variance-authority/dist/types").ClassProp) => string;
27
- /** @public */
24
+ declare const docLinkCardVariants: (props?: ({
25
+ variant?: "feature" | "pager" | null | undefined;
26
+ } & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
27
+ /**
28
+ * @public
29
+ */
28
30
  export declare function DocLinkCard({ title, description, href, icon: CardIcon, meta, metaStyle, accent, variant, disabled, affordance, }: DocLinkCardProps): import("react/jsx-runtime").JSX.Element;
29
31
  /** @internal — CVA variant helper; compose via DocLinkCard props instead. */
30
32
  export { docLinkCardVariants };
@@ -4,5 +4,7 @@ export type ErrorPatternProps = {
4
4
  /** Supporting message explaining the recovery state to the user. */
5
5
  message?: string;
6
6
  };
7
- /** @public */
7
+ /**
8
+ * @public
9
+ */
8
10
  export declare function ErrorPattern({ displayText, message, }: ErrorPatternProps): import("react/jsx-runtime").JSX.Element;
@@ -5,10 +5,10 @@
5
5
  */
6
6
  import * as React from 'react';
7
7
  import { type VariantProps } from 'class-variance-authority';
8
- declare const fieldValueVariants: (props?: {
9
- tone?: "success" | "danger" | "warning" | "info" | "neutral";
10
- mono?: boolean;
11
- } & import("class-variance-authority/dist/types").ClassProp) => string;
8
+ declare const fieldValueVariants: (props?: ({
9
+ tone?: "success" | "danger" | "warning" | "info" | "neutral" | null | undefined;
10
+ mono?: boolean | null | undefined;
11
+ } & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
12
12
  type FieldValueVariantProps = VariantProps<typeof fieldValueVariants>;
13
13
  /** @public */
14
14
  export interface FieldProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'children'>, FieldValueVariantProps {
@@ -6,10 +6,10 @@
6
6
  * @public
7
7
  */
8
8
  import * as React from 'react';
9
- declare const fileInputVariants: (props?: {
10
- dragging?: boolean;
11
- disabled?: boolean;
12
- } & import("class-variance-authority/dist/types").ClassProp) => string;
9
+ declare const fileInputVariants: (props?: ({
10
+ dragging?: boolean | null | undefined;
11
+ disabled?: boolean | null | undefined;
12
+ } & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
13
13
  export interface FileInputProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, 'type' | 'onChange'> {
14
14
  /** Called with the selected (or dropped) files. */
15
15
  onFiles?: (files: File[]) => void;
@@ -22,7 +22,9 @@ export interface FileInputProps extends Omit<React.InputHTMLAttributes<HTMLInput
22
22
  /** Disable interaction. */
23
23
  disabled?: boolean;
24
24
  }
25
- /** A dashed dropzone that opens the native file picker or accepts a drag-and-drop. */
25
+ /**
26
+ * A dashed dropzone that opens the native file picker or accepts a drag-and-drop.
27
+ */
26
28
  export declare const FileInput: React.ForwardRefExoticComponent<FileInputProps & React.RefAttributes<HTMLInputElement>>;
27
29
  /** @internal — CVA variant helper; compose via FileInput props instead. */
28
30
  export { fileInputVariants };
@@ -1,21 +1,21 @@
1
1
  /**
2
- * HdsTooltip — accessible hover/focus tooltip on Radix (Overlays).
2
+ * Tooltip — accessible hover/focus tooltip on Radix (Overlays).
3
3
  * @category Overlays
4
4
  * @tier primitive
5
5
  * @doc-exempt: no Overlays doc page yet — add demo when the overlays page is created
6
6
  *
7
7
  * Radix Tooltip (@radix-ui/react-tooltip) themed with role tokens. Provides
8
8
  * Floating-UI collision-aware positioning, ARIA wiring, keyboard focus support,
9
- * open/close delay, and portal mounting out of the box. Unlike the legacy
10
- * `Tooltip` (an @internal image-expand pill bound to AssetImg), this is the
9
+ * open/close delay, and portal mounting out of the box. Unlike the
10
+ * internal `ExpandTooltip` (an @internal image-expand pill bound to AssetImg), this is the
11
11
  * general-purpose accessible tooltip for labelling controls.
12
12
  *
13
- * <HdsTooltip>
14
- * <HdsTooltip.Trigger asChild>
13
+ * <Tooltip>
14
+ * <Tooltip.Trigger asChild>
15
15
  * <IconButton icon={Link} aria-label="Copy link" />
16
- * </HdsTooltip.Trigger>
17
- * <HdsTooltip.Content>Copy link</HdsTooltip.Content>
18
- * </HdsTooltip>
16
+ * </Tooltip.Trigger>
17
+ * <Tooltip.Content>Copy link</Tooltip.Content>
18
+ * </Tooltip>
19
19
  *
20
20
  * Skin: inverse surface bubble (semantic.color.surface.inverse) + inverse
21
21
  * 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
36
36
  Content: typeof HdsTooltipContent;
37
37
  }
38
38
  /**
39
- * Tooltip root. Bakes in the Radix Provider so a single `<HdsTooltip>` is
39
+ * Tooltip root. Bakes in the Radix Provider so a single `<Tooltip>` is
40
40
  * self-contained — no app-level provider required. Controlled via
41
41
  * `open`/`onOpenChange`, or uncontrolled with `defaultOpen`.
42
42
  * @public
43
43
  */
44
- declare const HdsTooltip: HdsTooltipComponent;
45
- export { HdsTooltip };
44
+ declare const Tooltip: HdsTooltipComponent;
45
+ export { Tooltip };
@@ -18,12 +18,12 @@
18
18
  */
19
19
  import { type ElementType } from 'react';
20
20
  import { type VariantProps } from 'class-variance-authority';
21
- declare const headingStackVariants: (props?: {
22
- gap?: "px4" | "px8";
23
- } & import("class-variance-authority/dist/types").ClassProp) => string;
24
- declare const headingStackLevelVariants: (props?: {
25
- level?: "heading1" | "heading2" | "heading3";
26
- } & import("class-variance-authority/dist/types").ClassProp) => string;
21
+ declare const headingStackVariants: (props?: ({
22
+ gap?: "px4" | "px8" | null | undefined;
23
+ } & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
24
+ declare const headingStackLevelVariants: (props?: ({
25
+ level?: "heading1" | "heading2" | "heading3" | null | undefined;
26
+ } & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
27
27
  type HeadingStackGapVariantProps = VariantProps<typeof headingStackVariants>;
28
28
  type HeadingStackLevelVariantProps = VariantProps<typeof headingStackLevelVariants>;
29
29
  type HdsHeadingLevel = NonNullable<HeadingStackLevelVariantProps['level']>;
@@ -7,7 +7,7 @@
7
7
  * Radix HoverCard (@radix-ui/react-hover-card) themed with the overlay role
8
8
  * tokens to match Menu/Popover. For sighted-pointer preview affordances (user
9
9
  * cards, link previews) — it is NOT a replacement for an accessible tooltip on
10
- * an interactive control; use HdsTooltip for labelling.
10
+ * an interactive control; use Tooltip for labelling.
11
11
  *
12
12
  * <HoverCard>
13
13
  * <HoverCard.Trigger asChild><InlineLink href="…">@ada</InlineLink></HoverCard.Trigger>
@@ -9,4 +9,6 @@ export interface LightboxProps {
9
9
  captionHref?: string;
10
10
  captionLabel?: string;
11
11
  }
12
+ /**
13
+ */
12
14
  export declare function Lightbox({ open, onClose, src, alt, naturalWidth, naturalHeight, caption, captionHref, captionLabel, }: LightboxProps): import("react/jsx-runtime").JSX.Element;