@assure-one/design-system 1.34.0 → 1.35.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.
package/dist/index.d.ts CHANGED
@@ -1,5 +1,4 @@
1
- import { S as SystemTokens, i as iconSizes } from './system-BDU18fVg.js';
2
- export { C as ColorName, R as ReferenceTokens, c as colors, r as radii, a as reference, s as shadows, b as spacing, d as surfaces, e as systemTokens, t as typography } from './system-BDU18fVg.js';
1
+ export { C as ColorName, R as ReferenceTokens, S as SystemTokens, c as colors, r as radii, a as reference, s as shadows, d as spacing, e as surfaces, f as systemTokens, t as typography } from './system-lyhOUTpa.js';
3
2
  import * as React$1 from 'react';
4
3
  import { ReactNode, CSSProperties } from 'react';
5
4
  import * as AccordionPrimitive from '@radix-ui/react-accordion';
@@ -9,6 +8,8 @@ import * as class_variance_authority_types from 'class-variance-authority/types'
9
8
  import { VariantProps } from 'class-variance-authority';
10
9
  import * as AspectRatioPrimitive from '@radix-ui/react-aspect-ratio';
11
10
  import * as AvatarPrimitive from '@radix-ui/react-avatar';
11
+ import { V as Variant, I as Intent, C as ControlSize, S as Shape } from './index-B3OiMlQv.js';
12
+ export { A as AlertCircleIcon, a as AlertTriangleIcon, b as AlertTriangleSolidIcon, c as ArchiveIcon, d as ArrowDownIcon, e as ArrowLeftIcon, f as ArrowRightIcon, g as ArrowRightSmallIcon, h as ArrowUpIcon, i as AtSignIcon, B as BarChartIcon, j as BellIcon, k as BoldIcon, l as BrainIcon, m as BriefcaseIcon, n as Building2Icon, o as BuildingIcon, p as CalendarIcon, q as ChatBubbleIcon, r as CheckCircle2Icon, s as CheckCircleSolidIcon, t as CheckIcon, u as ChevronDownIcon, v as ChevronLeftIcon, w as ChevronRightIcon, x as ChevronUpIcon, y as ChevronsDownUpIcon, z as ChevronsUpDownIcon, D as CircleDotIcon, E as CircleIcon, F as ClipboardCheckIcon, G as ClockIcon, H as CloseIcon, J as CommandIcon, K as CopyIcon, L as CornerDownLeftIcon, M as CreditCardIcon, N as DocumentIcon, O as DollarSignIcon, P as DownloadIcon, Q as ExternalLinkIcon, R as ExtractIcon, T as EyeIcon, U as EyeOffIcon, W as FileIcon, X as FileReturnIcon, Y as FileTextIcon, Z as FilterIcon, _ as FlagIcon, $ as FolderClosedIcon, a0 as FolderOpenIcon, a1 as FolderPlusIcon, a2 as FolderUpIcon, a3 as GlobeIcon, a4 as GoogleBrandIcon, a5 as GripVerticalIcon, a6 as HelpCircleIcon, a7 as HistoryIcon, a8 as HomeIcon, a9 as IconComponent, aa as IconDefinition, ab as IconProps, ac as IconSize, ad as InboxIcon, ae as InfoCircleSolidIcon, af as InfoIcon, ag as ItalicIcon, ah as KanbanIcon, ai as KeyIcon, aj as LandmarkIcon, ak as LayersIcon, al as LayoutDashboardIcon, am as LayoutGridIcon, an as LayoutListIcon, ao as LightningIcon, ap as Link2Icon, aq as LinkIcon, ar as ListChecksIcon, as as ListIcon, at as ListOrderedIcon, au as LoaderIcon, av as LockIcon, aw as LockKeyholeIcon, ax as LockOpenIcon, ay as LogOutIcon, az as MailIcon, aA as MapPinIcon, aB as MaximizeIcon, aC as MenuIcon, aD as MessageCircleIcon, aE as MessageCircleWarningIcon, aF as MicIcon, aG as MicrosoftBrandIcon, aH as MinimizeIcon, aI as MinusIcon, aJ as MonitorIcon, aK as MoonIcon, aL as MoreHorizontalIcon, aM as MoveIcon, aN as PaletteIcon, aO as PanelLeftCloseIcon, aP as PanelLeftIcon, aQ as PanelRightIcon, aR as PaperclipIcon, aS as PauseIcon, aT as PenSignIcon, aU as PenToolIcon, aV as PencilIcon, aW as PhoneIcon, aX as PlayIcon, aY as PlusIcon, aZ as ReceiptIcon, a_ as RefreshCwIcon, a$ as ReplyIcon, b0 as RotateCcwIcon, b1 as SaveIcon, b2 as SearchIcon, b3 as SendIcon, b4 as SettingsIcon, b5 as ShieldIcon, b6 as SigmaIcon, b7 as SlashIcon, b8 as SmartphoneIcon, b9 as SparkleIcon, ba as SparklesIcon, bb as StarIcon, bc as StopIcon, bd as StrikethroughIcon, be as SunIcon, bf as TableIcon, bg as TagIcon, bh as TeamIcon, bi as ThumbsDownIcon, bj as ThumbsUpIcon, bk as TimerIcon, bl as Trash2Icon, bm as TrashIcon, bn as TrashSolidIcon, bo as TrendingDownIcon, bp as TrendingUpIcon, bq as UnderlineIcon, br as UploadIcon, bs as UserCircleIcon, bt as UserIcon, bu as UsersIcon, bv as VideoIcon, bw as Volume2Icon, bx as VolumeXIcon, by as WorkflowIcon, bz as XCircleSolidIcon, bA as XIcon, bB as ZoomInIcon, bC as ZoomOutIcon, bD as createIcon } from './index-B3OiMlQv.js';
12
13
  import { DayPickerProps } from 'react-day-picker';
13
14
  import * as CheckboxPrimitive from '@radix-ui/react-checkbox';
14
15
  import * as CollapsiblePrimitive from '@radix-ui/react-collapsible';
@@ -52,6 +53,16 @@ type CodeSlot = "root" | "content";
52
53
  * @experimental Slot names are experimental until ADR-008 is accepted (W2-18).
53
54
  */
54
55
  type KbdSlot = "root";
56
+ /**
57
+ * `Pressable` has one part, its root, stamped as `data-slot="pressable"`
58
+ * (ADR-008): the element that carries the button behaviour, whether that is
59
+ * the `<button>` it renders or the child it wraps with `asChild`. State on the
60
+ * root: `data-disabled`, `data-pressed`. Components that compose it (`Button`
61
+ * once it adopts the behaviour, a clickable `Surface`) declare their own parts.
62
+ *
63
+ * @experimental Slot names are experimental until ADR-008 is accepted (W3-03).
64
+ */
65
+ type PressableSlot = "root";
55
66
  /**
56
67
  * `Button` parts, stamped as `data-slot="button[-<part>]"` (ADR-008).
57
68
  * States on the root: `data-variant`, `data-size`, `data-disabled`, and the
@@ -352,6 +363,58 @@ type InlineSlot = "root";
352
363
  * @experimental Slot names are experimental until ADR-008 is accepted (W2-16).
353
364
  */
354
365
  type SurfaceSlot = "root";
366
+ /**
367
+ * `Avatar` parts, stamped as `data-slot="avatar[-<part>]"` (ADR-008, W3-16).
368
+ * `root` is the outer positioning wrapper — the element a consumer's
369
+ * `shrink-0` / `mt-0.5` overrides are aimed at and `classNames.root` reaches;
370
+ * `frame` is the circle (the Radix root: image and fallback clip to it), and
371
+ * the element `className` and `ref` keep landing on behind the compatibility
372
+ * entry (target architecture §29.1, ADR-008 decision 6 — the landing does not
373
+ * move silently). `image` and `fallback` are the Radix image and fallback;
374
+ * `status` is the corner dot, rendered only when `status` is set.
375
+ * States on the root: `data-size`, `data-variant`.
376
+ *
377
+ * @experimental Slot names are experimental until ADR-008 is accepted (W3-16).
378
+ */
379
+ type AvatarSlot = "root" | "frame" | "image" | "fallback" | "status";
380
+ /**
381
+ * `Card` parts, stamped as `data-slot="card[-<part>]"` (ADR-008, W3-17). The
382
+ * root is a `Surface` (W2-16) that stamps `card` over `surface`: a composite
383
+ * declares its own parts. Each part is a real JSX component (`CardHeader`,
384
+ * `CardTitle`, …) and takes `className` itself, so `Card` has no `classNames`
385
+ * (ADR-008 decision 4). States on the root: `data-variant`.
386
+ *
387
+ * @experimental Slot names are experimental until ADR-008 is accepted (W3-17).
388
+ */
389
+ type CardSlot = "root" | "header" | "title" | "description" | "action" | "content" | "footer";
390
+ /**
391
+ * `StatusBadge` parts, stamped as `data-slot="status-badge[-<part>]"`
392
+ * (ADR-008): the root, the `indicator` (dot, icon or spinner — one at a time)
393
+ * and the `label`. States on the root: `data-variant`, `data-intent`,
394
+ * `data-size`, `data-loading`.
395
+ *
396
+ * @experimental Slot names are experimental until ADR-008 is accepted (W3-14).
397
+ */
398
+ type StatusBadgeSlot = "root" | "indicator" | "label";
399
+ /**
400
+ * `IconButton` parts, stamped as `data-slot="icon-button[-<part>]"` (ADR-008):
401
+ * the square root, the `icon` box and the `spinner` that replaces it while
402
+ * loading. States on the root: `data-variant`, `data-intent`, `data-size`,
403
+ * `data-disabled`, `data-loading`, `data-pressed`.
404
+ *
405
+ * @experimental Slot names are experimental until ADR-008 is accepted (W3-09).
406
+ */
407
+ type IconButtonSlot = "root" | "icon" | "spinner";
408
+ /**
409
+ * `Chip` parts, stamped as `data-slot="chip[-<part>]"` (ADR-008): the root
410
+ * (the pressable itself, or the group that holds a pressable label and the
411
+ * `remove` button), the leading `icon`, the `label`, the `count` and the
412
+ * `remove` button. States on the root: `data-variant`, `data-intent`,
413
+ * `data-size`, `data-disabled`, `data-pressed`.
414
+ *
415
+ * @experimental Slot names are experimental until ADR-008 is accepted (W3-15).
416
+ */
417
+ type ChipSlot = "root" | "icon" | "label" | "count" | "remove";
355
418
 
356
419
  declare const AlertDialog: React$1.FC<AlertDialogPrimitive.AlertDialogProps>;
357
420
  declare const AlertDialogTrigger: React$1.ForwardRefExoticComponent<AlertDialogPrimitive.AlertDialogTriggerProps & React$1.RefAttributes<HTMLButtonElement>>;
@@ -474,24 +537,111 @@ declare const statusStyles: {
474
537
  readonly busy: "ds:bg-danger-fg";
475
538
  readonly offline: "ds:bg-fg-4";
476
539
  };
540
+
541
+ /**
542
+ * Props of `Avatar`. Everything not listed spreads onto the frame (the Radix
543
+ * root), as it always has.
544
+ */
477
545
  interface AvatarProps extends Omit<React$1.ComponentPropsWithoutRef<typeof AvatarPrimitive.Root>, "children">, VariantProps<typeof avatarVariants> {
478
546
  src?: string | null;
479
547
  alt?: string;
480
548
  name?: string;
481
549
  status?: keyof typeof statusStyles;
550
+ /**
551
+ * One class per part, keyed by `AvatarSlot` (ADR-008 decision 4). `root` is
552
+ * the outer wrapper — where a `shrink-0` or a margin belongs; `frame` is the
553
+ * circle, the same element `className` lands on. Each part's class comes
554
+ * after the design system's own and, on the frame, before `className`, so a
555
+ * consumer's `className` keeps winning exactly as it does today.
556
+ *
557
+ * Spelled out as `Partial<Record<AvatarSlot, string>>` rather than through the
558
+ * internal `SlotClassNames` helper so the public declaration names no
559
+ * unexported type.
560
+ *
561
+ * @experimental
562
+ */
563
+ classNames?: Partial<Record<AvatarSlot, string>>;
482
564
  }
483
565
  declare const Avatar: React$1.ForwardRefExoticComponent<AvatarProps & React$1.RefAttributes<HTMLSpanElement>>;
484
566
 
567
+ /** The emphasis subset a badge offers. @experimental */
568
+ type BadgeVariant = Extract<Variant, "solid" | "soft" | "outline">;
569
+ /** The badge's own size scale, spelled with the shared names (§17). @experimental */
570
+ type BadgeSize = Extract<ControlSize, "xs" | "sm" | "md">;
571
+ /** Corner treatment; omitted keeps today's corner (D1). @experimental */
572
+ type BadgeShape = Extract<Shape, "rounded" | "pill">;
485
573
  /**
486
- * Badge status atom. Pill-family variants. Default variant is the
487
- * neutral pill.
574
+ * The one-axis words Badge accepted before W3-13. Each resolves to a
575
+ * `{ variant, intent }` pair through `resolveBadgeAppearance` and renders the
576
+ * same classes it always did.
577
+ *
578
+ * @deprecated Use `variant` (`solid | soft | outline`) with `intent` instead:
579
+ * `default` → `solid` + `brand`, `secondary` → `soft` + `neutral`,
580
+ * `destructive` → `soft` + `danger`, `success | warning | info` → `soft` +
581
+ * the same word. `outline` is already an emphasis and is not deprecated.
488
582
  */
489
- declare const badgeVariants: (props?: ({
490
- variant?: "info" | "success" | "warning" | "outline" | "default" | "destructive" | "secondary" | null | undefined;
491
- size?: "sm" | "md" | null | undefined;
492
- } & class_variance_authority_types.ClassProp) | undefined) => string;
493
- interface BadgeProps extends React.HTMLAttributes<HTMLSpanElement>, VariantProps<typeof badgeVariants> {
583
+ type BadgeLegacyVariant = "default" | "secondary" | "destructive" | "success" | "warning" | "info";
584
+ /** A resolved `{ variant, intent }` pair. @experimental */
585
+ interface BadgeAppearance {
586
+ variant: BadgeVariant;
587
+ intent: Intent;
588
+ }
589
+ /** What a badge can be asked for: the two axes, either one, or a legacy word. @experimental */
590
+ interface BadgeAppearanceInput {
591
+ variant?: BadgeVariant | BadgeLegacyVariant | null | undefined;
592
+ intent?: Intent | null | undefined;
593
+ }
594
+ /**
595
+ * Resolves what a consumer asked for into the pair the class table is keyed by.
596
+ *
597
+ * - both axes: taken as given (a legacy `variant` word with an explicit
598
+ * `intent` keeps the word's emphasis and takes the intent);
599
+ * - `variant` only: the per-variant default intent, or the legacy pair;
600
+ * - `intent` only: the per-intent default variant;
601
+ * - nothing: `solid` + `brand`, today's default.
602
+ *
603
+ * @experimental
604
+ */
605
+ declare function resolveBadgeAppearance({ variant, intent, }?: BadgeAppearanceInput): BadgeAppearance;
606
+ /** The inputs `badgeVariants` accepts (the legacy `variant` words included). @experimental */
607
+ interface BadgeVariantsProps extends BadgeAppearanceInput {
608
+ size?: BadgeSize | null | undefined;
609
+ shape?: BadgeShape | null | undefined;
610
+ class?: string | null | undefined;
611
+ className?: string | null | undefined;
612
+ }
613
+ /**
614
+ * The badge's class string, for consumers that style their own element.
615
+ * Same call shape as before W3-13 (`variant`, `size`, `class`/`className`),
616
+ * plus `intent` and `shape`; a legacy `variant` word yields the string it
617
+ * always did.
618
+ */
619
+ declare function badgeVariants({ variant, intent, size, shape, class: classValue, className, }?: BadgeVariantsProps): string;
620
+ interface BadgeProps extends React.HTMLAttributes<HTMLSpanElement> {
621
+ /**
622
+ * Visual emphasis: `solid` (filled), `soft` (tinted, the status look) or
623
+ * `outline`. Omitted, it follows `intent` (brand is solid, the rest soft);
624
+ * with neither prop the badge is `solid` + `brand`, as it always was.
625
+ * The legacy one-axis words are accepted and deprecated (`BadgeLegacyVariant`).
626
+ */
627
+ variant?: BadgeVariant | BadgeLegacyVariant;
628
+ /**
629
+ * Semantic meaning → colour family. Omitted, it follows `variant`
630
+ * (`solid` is brand, `soft` and `outline` are neutral).
631
+ * @experimental
632
+ */
633
+ intent?: Intent;
634
+ /** `xs` (10px text, W3-13), `sm` (default) or `md`. */
635
+ size?: BadgeSize;
636
+ /**
637
+ * Corner treatment. Omitted keeps today's corner (`--radius-pill`);
638
+ * `rounded` is the `radius.badge` role, `pill` is `radius.full` (D1).
639
+ * @experimental
640
+ */
641
+ shape?: BadgeShape;
642
+ /** Leading status dot, drawn in the text colour. */
494
643
  dot?: boolean;
644
+ /** Leading 14px glyph. */
495
645
  icon?: React.ReactNode;
496
646
  }
497
647
  declare const Badge: React$1.ForwardRefExoticComponent<BadgeProps & React$1.RefAttributes<HTMLSpanElement>>;
@@ -536,38 +686,231 @@ type BreadcrumbSeparatorProps = React.HTMLAttributes<HTMLSpanElement>;
536
686
  declare const BreadcrumbSeparator: React$1.ForwardRefExoticComponent<BreadcrumbSeparatorProps & React$1.RefAttributes<HTMLSpanElement>>;
537
687
 
538
688
  /**
539
- * Button action atom.
540
- *
541
- * Variants:
542
- * - primary → bg-brand (suite accent)
543
- * - secondary → ghost surface bg-bg-2
544
- * - destructive bg-danger-fg
545
- * - success → bg-success-fg
546
- * - ghost → transparent, hover:bg-bg-2
547
- * - outline → bordered surface
548
- * - link → text-accent (cyan) with underline-on-hover
549
- * - accent → stable suite-level cyan CTA (does not follow product scope)
550
- * - dashed → full-bleed "+ Add another" CTA, transparent fill + dashed border
551
- *
552
- * Control text scale (shared across the button-family control primitives
553
- * Button / MultiFilterPill / FilterChip): sm = 13px, md = 14px, lg = 16px.
554
- * `sm` is the dense tier used in toolbars; `md` is the default. (SearchInput
555
- * keeps its own one-step-denser inputSize scale, 12/13/14.)
556
- * Use `asChild` to render as a different element (e.g. an anchor / next/link).
557
- */
558
- declare const buttonVariants: (props?: ({
559
- variant?: "accent" | "success" | "outline" | "ghost" | "link" | "dashed" | "destructive" | "primary" | "secondary" | null | undefined;
560
- size?: "sm" | "md" | "lg" | "default" | "compact" | "icon" | "comfortable" | "icon-xs" | "icon-sm" | null | undefined;
561
- } & class_variance_authority_types.ClassProp) | undefined) => string;
562
- type ButtonVariant = NonNullable<VariantProps<typeof buttonVariants>["variant"]>;
563
- type ButtonSize = NonNullable<VariantProps<typeof buttonVariants>["size"]>;
689
+ * L1a behaviour primitive (private). Not exported from the package.
690
+ *
691
+ * `buttonBase` — the one class recipe every button-shaped control renders
692
+ * (W3-03; target architecture §4 L1a, §30), and the `variant` + `intent`
693
+ * resolver in front of it (W3-02; ADR-007). `Button`, `LinkButton` and
694
+ * `SubmitButton` read both through the public `buttonVariants`;
695
+ * `IconButton` (W3-09) and `Chip` (W3-15) read them next, so the geometry,
696
+ * the focus ring, the disabled treatment, the press feedback and the colour
697
+ * table of an action are written once.
698
+ *
699
+ * Two axes, one table: `variant` says how loudly (`solid · soft · outline ·
700
+ * ghost · link`), `intent` says what it means (`brand · neutral · success ·
701
+ * danger`), and every pair has one row in {@link BUTTON_LOOKS}. The legacy
702
+ * single-axis words (`primary`, `secondary`, `destructive`, `success`,
703
+ * `accent`, `dashed`) resolve to a pair through {@link LEGACY_BUTTON_VARIANTS}
704
+ * and produce the class string they always did:
705
+ * `src/primitives/__tests__/button-legacy-classes.test.tsx` pins every legacy
706
+ * `variant` × `size` to the output recorded from `main` before W3-02.
707
+ *
708
+ * No React, no client directive: plain functions of props to a string, so a
709
+ * Server Component can call them once the root entry is server-safe (S3).
710
+ */
711
+ /**
712
+ * The emphases a Button offers: all five of the shared vocabulary.
713
+ *
714
+ * @experimental
715
+ */
716
+ type ButtonEmphasis = Variant;
717
+ /**
718
+ * The intents a Button offers (ADR-007 §1; `info` and `warning` are not actions).
719
+ *
720
+ * @experimental
721
+ */
722
+ type ButtonIntent = Extract<Intent, "brand" | "neutral" | "success" | "danger">;
723
+ /**
724
+ * `destructive` is accepted where an intent is expected, as an alias of
725
+ * `danger`, until decision D4 settles the canonical word (ADR-007 §5).
726
+ *
727
+ * @deprecated Use `intent="danger"`.
728
+ * @experimental
729
+ */
730
+ type ButtonIntentAlias = "destructive";
731
+ /**
732
+ * The single-axis words Button accepted before W3-02, each a fixed
733
+ * `{ variant, intent }` pair (ADR-007 §4, target architecture §28):
734
+ *
735
+ * - `primary` → `solid` + `brand` (the default; nothing to migrate)
736
+ * - `secondary` → `soft` + `neutral`
737
+ * - `destructive` → `solid` + `danger`
738
+ * - `success` → `solid` + `success`
739
+ * - `accent` → `solid` + `brand` in the suite-action colour; folds into
740
+ * `intent="brand"` and is dropped in 2.0 (decision D13)
741
+ * - `dashed` → `outline` + `neutral` with a dashed 2px border; kept for the
742
+ * 2.x line
743
+ *
744
+ * `ghost`, `outline` and `link` are not legacy: they already are emphases.
745
+ *
746
+ * @deprecated Pass `variant` (emphasis) and `intent` (meaning) instead. The
747
+ * codemod CM-04 rewrites call sites mechanically.
748
+ * @experimental
749
+ */
750
+ type ButtonLegacyVariant = "primary" | "secondary" | "destructive" | "success" | "accent" | "dashed";
751
+ /** What `variant` accepts on the Button family: the vocabulary plus the deprecated aliases. */
752
+ type ButtonVariant = ButtonEmphasis | ButtonLegacyVariant;
753
+ /**
754
+ * A row of the colour table: a `variant`/`intent` pair or one of the two
755
+ * legacy-only looks. The separator is `/`, not `-`: the keys of the table are
756
+ * text Tailwind scans, and an `outline` emphasis joined to an intent with a
757
+ * hyphen would compile to an outline-colour utility nobody asked for.
758
+ *
759
+ * @experimental
760
+ */
761
+ type ButtonLook = `${ButtonEmphasis}/${ButtonIntent}` | "accent" | "dashed";
762
+ /**
763
+ * The resolved appearance of a Button.
764
+ *
765
+ * @experimental
766
+ */
767
+ interface ButtonStyle {
768
+ variant: ButtonEmphasis;
769
+ intent: ButtonIntent;
770
+ /** The row of the colour table the pair renders. */
771
+ look: ButtonLook;
772
+ }
773
+ /**
774
+ * Resolve what a Button renders from the two-axis props, accepting every
775
+ * legacy word (W3-02, ADR-007 §4).
776
+ *
777
+ * - No `variant`: `solid` + `brand` (what `primary` always rendered).
778
+ * - A legacy `variant` alone: its fixed pair; `accent` and `dashed` keep
779
+ * their own look.
780
+ * - A legacy `variant` with an explicit `intent`: the alias contributes its
781
+ * emphasis, the intent is the caller's (`variant="primary" intent="danger"`
782
+ * is a solid danger button). `accent`'s and `dashed`'s own looks apply only
783
+ * without a competing intent.
784
+ * - `intent="destructive"` is `danger` (deprecated alias, D4).
785
+ *
786
+ * @experimental
787
+ */
788
+ declare function resolveButtonStyle({ variant, intent, }: {
789
+ variant?: ButtonVariant | null;
790
+ intent?: ButtonIntent | ButtonIntentAlias | null;
791
+ }): ButtonStyle;
792
+ /**
793
+ * The size names the recipe knows (W3-05, ADR-013): the shared control scale
794
+ * `xs · sm · md · lg · xl` (`ControlSize`), the 1.31 aliases
795
+ * `compact` / `default` / `comfortable` of `sm` / `md` / `lg`, and the square
796
+ * icon-only steps `icon-xs` / `icon-sm` / `icon` (C-BTN-SIZE-ICON).
797
+ *
798
+ * `xs` and `xl` are new in W3-05 and read the shared scale
799
+ * (`--control-*-{xs,xl}`: 28px and 48px tall), so they follow the density
800
+ * scope. `md` (40px) and `lg` (48px) are the two A1 mismatches recorded in
801
+ * `baselines/size-geometry.json`: they keep today's pixels through the
802
+ * D5-gated compat tokens `--button-height-md` / `--button-height-lg` and
803
+ * their padding, gap and label size stay on Tailwind's scale — nothing about
804
+ * them moves until decision D5 (W2-05, CM-03). `sm` (32px) already agrees
805
+ * with the scale's `sm` step, so it reads the shared row like `xs`/`xl`.
806
+ */
807
+ type ButtonSize = ControlSize | ButtonSizeAlias | ButtonIconSize;
808
+ /**
809
+ * The 1.31 aliases of `sm` / `md` / `lg` (C-BTN-SIZE-ALIAS). No known consumer
810
+ * uses them; they leave in 2.0.
811
+ *
812
+ * @deprecated Use `size="sm"`, `"md"` or `"lg"`.
813
+ * @experimental
814
+ */
815
+ type ButtonSizeAlias = "compact" | "default" | "comfortable";
816
+ /**
817
+ * The icon-only squares (C-BTN-SIZE-ICON): 24 / 28 / 40px. `IconButton`
818
+ * (W3-09) owns icon-only geometry; the codemod CM-03 rewrites the call sites.
819
+ * Removed in 3.0.
820
+ *
821
+ * @deprecated Use `IconButton`.
822
+ * @experimental
823
+ */
824
+ type ButtonIconSize = "icon-xs" | "icon-sm" | "icon";
825
+ /**
826
+ * What {@link buttonVariants} takes: the two axes, the size and cva's class
827
+ * pass-through.
828
+ *
829
+ * @experimental
830
+ */
831
+ interface ButtonVariantsProps {
832
+ variant?: ButtonVariant | null;
833
+ intent?: ButtonIntent | ButtonIntentAlias | null;
834
+ size?: ButtonSize | null;
835
+ class?: string | null;
836
+ className?: string | null;
837
+ }
838
+ /**
839
+ * The public recipe of the Button family: resolves `variant` + `intent`
840
+ * (legacy words included) and renders the row with the size. Same name and
841
+ * output as before W3-02 for every call that existed; `intent` is the one
842
+ * addition. Server-safe.
843
+ */
844
+ declare function buttonVariants({ variant, intent, size, class: classProp, className, }?: ButtonVariantsProps): string;
845
+ /**
846
+ * The icon slots of the Button family (W3-07). `iconStart` / `iconEnd` are
847
+ * logical — start is the left in LTR and the right in RTL, because the button
848
+ * is a flex row and the slot follows the writing direction. `iconLeft` /
849
+ * `iconRight` are the names consumers use today (140 call sites) and stay as
850
+ * aliases of the same slots.
851
+ *
852
+ * @experimental
853
+ */
854
+ interface ButtonIconProps {
855
+ /** Icon before the label (logical start). */
856
+ iconStart?: ReactNode;
857
+ /** Icon after the label (logical end). */
858
+ iconEnd?: ReactNode;
859
+ /**
860
+ * Alias of `iconStart`. The codemod CM-05 renames it.
861
+ *
862
+ * @deprecated Use `iconStart`.
863
+ */
864
+ iconLeft?: ReactNode;
865
+ /**
866
+ * Alias of `iconEnd`. The codemod CM-05 renames it.
867
+ *
868
+ * @deprecated Use `iconEnd`.
869
+ */
870
+ iconRight?: ReactNode;
871
+ }
564
872
 
565
- interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement>, VariantProps<typeof buttonVariants> {
873
+ interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement>, ButtonIconProps {
874
+ /**
875
+ * Visual emphasis: `solid` (default) · `soft` · `outline` · `ghost` · `link`.
876
+ * The legacy words (`primary`, `secondary`, `destructive`, `success`,
877
+ * `accent`, `dashed`) are deprecated aliases — see {@link ButtonLegacyVariant}.
878
+ */
879
+ variant?: ButtonVariant;
880
+ /**
881
+ * Meaning → colour family: `brand` · `neutral` · `success` · `danger`.
882
+ * Defaults per variant so an omitted prop renders what it always did.
883
+ * `destructive` is a deprecated alias of `danger` (decision D4).
884
+ *
885
+ * @experimental
886
+ */
887
+ intent?: ButtonIntent | ButtonIntentAlias;
888
+ /**
889
+ * The shared control scale `xs · sm · md · lg · xl` (ADR-013). Default `md`
890
+ * (40px); `xs` and `xl` are new in W3-05. The icon-only squares `icon-xs` ·
891
+ * `icon-sm` · `icon` are deprecated in favour of `IconButton`
892
+ * ({@link ButtonIconSize}), and `compact` / `default` / `comfortable` are
893
+ * deprecated aliases of `sm` / `md` / `lg` ({@link ButtonSizeAlias}).
894
+ */
895
+ size?: ButtonSize;
566
896
  /** Render as the child element via Radix `Slot` (shadcn pattern). */
567
897
  asChild?: boolean;
568
898
  loading?: boolean;
569
- iconLeft?: React.ReactNode;
570
- iconRight?: React.ReactNode;
899
+ /**
900
+ * Stretch to the container's width (`w-full`). A prop instead of a
901
+ * `className`, so the codemods and the dashboard can see it.
902
+ *
903
+ * @experimental
904
+ */
905
+ fullWidth?: boolean;
906
+ /**
907
+ * Toggle state (a boolean prop, never a variant — ADR-007 §2). Reflected as
908
+ * `aria-pressed` and, when true, `data-pressed`. Leave undefined for an
909
+ * action that does not toggle.
910
+ *
911
+ * @experimental
912
+ */
913
+ pressed?: boolean;
571
914
  }
572
915
  declare const Button: React$1.ForwardRefExoticComponent<ButtonProps & React$1.RefAttributes<HTMLButtonElement>>;
573
916
 
@@ -591,23 +934,197 @@ declare namespace Calendar {
591
934
  }
592
935
 
593
936
  /**
594
- * Card surface container. 12px radius, 1px rule border, surface bg.
595
- * Three variants:
937
+ * Inner padding of a `Surface`, as a `surface.padding` role (W2-02): 16 / 20 /
938
+ * 24px — the three card and panel paddings the library and its consumers
939
+ * already write — or `none` for a surface whose content pads itself (a table,
940
+ * an image, a list with its own row padding).
941
+ *
942
+ * @experimental
943
+ */
944
+ type SurfacePadding = "none" | "sm" | "md" | "lg";
945
+ /**
946
+ * Corner radius of a `Surface`, as a radius role (W2-07, target architecture
947
+ * §18): `surface` for cards, dialogs and sheets, `surface-sm` for popovers,
948
+ * tooltips, toasts and small cards, or `none`. Control and badge radii are not
949
+ * offered: a surface is never a control.
950
+ *
951
+ * @experimental
952
+ */
953
+ type SurfaceRadius = "none" | "surface-sm" | "surface";
954
+ /**
955
+ * Elevation of a `Surface`, as an elevation role (W2-08, target architecture
956
+ * §19): `flat` (resting, border-led — today's `Card`), `raised` (resting
957
+ * lift), `floating` (anchored transient surfaces), `overlay` (modal surfaces),
958
+ * or `none` for no shadow at all — which is what the hand-rolled card boxes in
959
+ * every product render, and the default. `flat` is kept distinct from `none`
960
+ * because today's `flat` role still aliases the hairline `shadow-quiet` (gated
961
+ * on D1); when D1 lands the two coincide and nothing here changes.
962
+ *
963
+ * @experimental
964
+ */
965
+ type SurfaceElevation = "none" | "flat" | "raised" | "floating" | "overlay";
966
+
967
+ /**
968
+ * Props of `Surface`.
969
+ *
970
+ * Tokenised props for exactly the three things a surface is (padding, radius,
971
+ * elevation) and nothing else: no `gap`/`align`/`direction` (that is a `Stack`
972
+ * inside it), no `bg`, `border`, `shadow`, `rounded`, `p`/`m`/`px`/`mt`,
973
+ * `color`, `width`, `height`, `sx` or `css`, and no numeric or length values.
974
+ * `className` and `style` land on the root element (§29.1).
975
+ *
976
+ * @experimental
977
+ */
978
+ interface SurfaceProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "color"> {
979
+ /**
980
+ * Inner padding, as a `surface.padding` role.
981
+ * @default "sm"
982
+ */
983
+ padding?: SurfacePadding;
984
+ /**
985
+ * Corner radius, as a radius role.
986
+ * @default "surface"
987
+ */
988
+ radius?: SurfaceRadius;
989
+ /**
990
+ * Shadow, as an elevation role.
991
+ * @default "none"
992
+ */
993
+ elevation?: SurfaceElevation;
994
+ }
995
+ /**
996
+ * Surface — the bordered box content sits on (W2-16, target architecture §23).
997
+ * It is the primitive behind the 367 (Pro) / 119 (Portal) / 96 (Tax)
998
+ * hand-rolled card boxes of the consumer usage audit (the class string is
999
+ * `HAND_ROLLED_CARD` in the stories; it is not spelled here because Tailwind
1000
+ * would compile it from this comment) and the `.surface` helper class: with no
1001
+ * props it renders that box — surface background, 1px rule border,
1002
+ * `radius.surface`, `surface.padding.sm`, no shadow — and every knob is a
1003
+ * role, never a value. `Card` (W3-17) is built on it and adds anatomy.
1004
+ *
1005
+ * Deferred, deliberately:
1006
+ * - `interactive`: a clickable surface renders through `Pressable` (W3-03) so
1007
+ * it gets keyboard activation, `data-pressed` and a focus ring for free; a
1008
+ * `cursor-pointer` hover treatment here would be a click target with no
1009
+ * keyboard semantics. Until then, put a `Button asChild` or a link inside
1010
+ * the surface.
1011
+ * - `asChild`: waits for the design system's own `Slot` (a11y primitives).
1012
+ *
1013
+ * Server-safe: no hooks, no client directive, renders a plain `div` and stamps
1014
+ * `data-slot="surface"`.
1015
+ *
1016
+ * Under a consumer's shadcn theme the hand-rolled box and this primitive differ
1017
+ * on purpose in two places the parity story makes visible: the products'
1018
+ * `rounded-xl` is `--radius` + 4px (16px) where `radius.surface` is 12px, and
1019
+ * their `--border` is not the design system's rule colour. Both are decision
1020
+ * D1 (target architecture §18); `Surface` follows the roles.
1021
+ *
1022
+ * @experimental Shipped in Wave 2 as a new export nobody is forced to use; the
1023
+ * prop shapes may still change before the wave's exit review.
1024
+ */
1025
+ declare const Surface: React$1.ForwardRefExoticComponent<SurfaceProps & React$1.RefAttributes<HTMLDivElement>>;
1026
+
1027
+ /**
1028
+ * The document-outline level: which of `<h1>`…`<h6>` renders. Semantic only —
1029
+ * it says where the heading sits in the outline, not how large it is.
1030
+ *
1031
+ * @experimental W2-13.
1032
+ */
1033
+ type HeadingLevel = 1 | 2 | 3 | 4 | 5 | 6;
1034
+ /**
1035
+ * The visual role of a heading: one of the four title roles of target
1036
+ * architecture §15. Independent of `level`. Written out as a literal union so
1037
+ * the public API report records the names.
1038
+ *
1039
+ * @experimental W2-13.
1040
+ */
1041
+ type HeadingSize = "display" | "title-page" | "title-section" | "title-sub";
1042
+ /**
1043
+ * Props of `Heading`. `level` is required on purpose: a heading without an
1044
+ * outline level is the hard-coded `h3`/`h1`/`h4` this component exists to end
1045
+ * (target architecture §15.2, current-state audit §14).
1046
+ *
1047
+ * @experimental W2-13.
1048
+ */
1049
+ interface HeadingProps extends React.HTMLAttributes<HTMLHeadingElement> {
1050
+ /** The outline level: renders `<h{level}>`. Required. */
1051
+ level: HeadingLevel;
1052
+ /**
1053
+ * The visual role, independent of `level`. Defaults from the level
1054
+ * (`1` → `title-page`, `2` → `title-section`, `3`–`6` → `title-sub`), so an
1055
+ * `<h3>` that must look like a section title says `size="title-section"`
1056
+ * instead of becoming an `<h2>`.
1057
+ */
1058
+ size?: HeadingSize;
1059
+ }
1060
+ /**
1061
+ * `Heading` — an `<h1>`…`<h6>` whose outline level and visual size are two
1062
+ * separate props (W2-13, target architecture §15.2).
1063
+ *
1064
+ * `level` is required and picks the element; `size` picks the title role and
1065
+ * defaults from the level. Because the two are independent, a card title can
1066
+ * be the `<h3>` the document outline needs and still render at the section
1067
+ * scale, and a page can keep exactly one `<h1>` without every other title
1068
+ * shrinking. Every size is a role token; there is no pixel size.
1069
+ *
1070
+ * Renders in the display family (`font-display`) and the heading ink (`fg`),
1071
+ * as the base `h1`–`h4` rules do today, so an `<h5>` at `title-sub` matches an
1072
+ * `<h4>` at `title-sub`.
596
1073
  *
597
- * default — settled card on the page (current behavior, unchanged)
598
- * interactive — clickable card; hover darkens the border
599
- * flat — borderless / shadowless transparent surface, for nesting
600
- * inside Dialog/Sheet/Card without double-border
1074
+ * Server-safe: no hooks, no client directive, no effects.
1075
+ *
1076
+ * Anatomy: one part, `data-slot="heading"`, which is also where `className`
1077
+ * and `style` land.
1078
+ *
1079
+ * @example
1080
+ * ```tsx
1081
+ * <Heading level={1}>Engagements</Heading>
1082
+ * <Heading level={3} size="title-section">Documents</Heading>
1083
+ * ```
1084
+ *
1085
+ * @experimental New export (W2-13); its size vocabulary may change while
1086
+ * decision D1 (visual source of truth) is open.
1087
+ */
1088
+ declare const Heading: React$1.ForwardRefExoticComponent<HeadingProps & React$1.RefAttributes<HTMLHeadingElement>>;
1089
+
1090
+ /**
1091
+ * The full card look as one class string, for a consumer that styles its own
1092
+ * element as a card (`KpiCard`'s `<button>` does). Unchanged by W3-17: it
1093
+ * still spells the settled box itself, because a `Surface` cannot be applied
1094
+ * to someone else's element. `Card` itself renders a `Surface` and layers only
1095
+ * the variant slice on it.
601
1096
  */
602
1097
  declare const cardVariants: (props?: ({
603
1098
  variant?: "flat" | "default" | "interactive" | null | undefined;
604
1099
  } & class_variance_authority_types.ClassProp) | undefined) => string;
605
1100
  type CardVariants = VariantProps<typeof cardVariants>;
1101
+
1102
+ /** Props of `Card`. */
606
1103
  interface CardProps extends React.HTMLAttributes<HTMLDivElement>, CardVariants {
1104
+ /**
1105
+ * Inner padding of the root, as a `surface.padding` role (16 / 20 / 24px) —
1106
+ * the `p-4` / `p-5` / `p-6` override 88 % of cards carry today, as a prop.
1107
+ * `none` is today's default: the root has no padding of its own and
1108
+ * `CardHeader` / `CardContent` / `CardFooter` pad themselves, so set a
1109
+ * padding only on a card whose content is bare (no parts).
1110
+ * @default "none"
1111
+ */
1112
+ padding?: SurfacePadding;
607
1113
  }
608
1114
  declare const Card: React$1.ForwardRefExoticComponent<CardProps & React$1.RefAttributes<HTMLDivElement>>;
609
1115
  declare const CardHeader: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
610
- declare const CardTitle: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLHeadingElement> & React$1.RefAttributes<HTMLHeadingElement>>;
1116
+ /** Props of `CardTitle`. */
1117
+ interface CardTitleProps extends React.HTMLAttributes<HTMLHeadingElement> {
1118
+ /**
1119
+ * The document-outline level: which of `<h1>`…`<h6>` the title renders. The
1120
+ * visual size does not change with it. Defaults to `3`, the tag the title
1121
+ * always rendered; a section card directly under a page `<h1>` wants `2`
1122
+ * (target architecture §15: "every titled component gains `headingLevel`").
1123
+ * @default 3
1124
+ */
1125
+ headingLevel?: HeadingLevel;
1126
+ }
1127
+ declare const CardTitle: React$1.ForwardRefExoticComponent<CardTitleProps & React$1.RefAttributes<HTMLHeadingElement>>;
611
1128
  declare const CardDescription: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLParagraphElement> & React$1.RefAttributes<HTMLParagraphElement>>;
612
1129
  declare const CardContent: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
613
1130
  declare const CardFooter: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
@@ -914,10 +1431,10 @@ declare const DialogFooter: {
914
1431
  declare const DialogTitle: React$1.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogTitleProps & React$1.RefAttributes<HTMLHeadingElement>, "ref"> & React$1.RefAttributes<HTMLHeadingElement>>;
915
1432
  declare const DialogDescription: React$1.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogDescriptionProps & React$1.RefAttributes<HTMLParagraphElement>, "ref"> & React$1.RefAttributes<HTMLParagraphElement>>;
916
1433
 
917
- declare const chipVariants: (props?: ({
1434
+ declare const chipVariants$1: (props?: ({
918
1435
  variant?: "neutral" | "primary" | null | undefined;
919
1436
  } & class_variance_authority_types.ClassProp) | undefined) => string;
920
- interface DismissibleChipProps extends Omit<React$1.ButtonHTMLAttributes<HTMLButtonElement>, "onClick" | "children">, VariantProps<typeof chipVariants> {
1437
+ interface DismissibleChipProps extends Omit<React$1.ButtonHTMLAttributes<HTMLButtonElement>, "onClick" | "children">, VariantProps<typeof chipVariants$1> {
921
1438
  label: React$1.ReactNode;
922
1439
  onDismiss: () => void;
923
1440
  }
@@ -1176,21 +1693,67 @@ declare const HoverCardPortal: React$1.FC<HoverCardPrimitive.HoverCardPortalProp
1176
1693
  declare const HoverCardContent: React$1.ForwardRefExoticComponent<Omit<HoverCardPrimitive.HoverCardContentProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
1177
1694
 
1178
1695
  /**
1179
- * IconTile — the recurring tinted rounded-square icon chip. A tone tint fills
1180
- * the square and colors the icon; `grid place-items-center` keeps the glyph
1181
- * centered. Consolidates v2's `.v2-qico` / `.v2-item-ico` / `.nr-ico` /
1696
+ * IconTile — the recurring tinted rounded-square icon chip. An intent tint
1697
+ * fills the square and colors the icon; `grid place-items-center` keeps the
1698
+ * glyph centered. Consolidates v2's `.v2-qico` / `.v2-item-ico` / `.nr-ico` /
1182
1699
  * `.licon` / `.aico` icon-chip pattern into one primitive.
1183
1700
  *
1184
- * tone — `pro` (default), `neutral`, status (`info` | `success` | `warning`
1185
- * | `danger`), and suite tints (`audit` | `books` | `tax`).
1186
- * size `sm` (~30px) | `md` (~38px) | `lg` (~42px). Icon scales with it.
1701
+ * intent — `brand` (default), `neutral`, status (`info` | `success` |
1702
+ * `warning` | `danger`) the ADR-007 vocabulary. `tone` is the
1703
+ * deprecated spelling (`pro` `brand`); the suite tints
1704
+ * (`audit` | `books` | `tax`) are only reachable through `tone`
1705
+ * because product names are never intents (ADR-007 §2).
1706
+ * size — `sm` (30px) | `md` (38px, default) | `lg` (42px) | `xl` (48px).
1707
+ * Each step sets `--ds-icon-size` on the tile from the W2-10 icon
1708
+ * scale (`--icon-size-md` / 18px / `--icon-size-lg`, the legacy
1709
+ * spellings of `--ds-icon-size-*`) and the icon reads it, so a
1710
+ * consumer that needs another glyph size sets the variable instead
1711
+ * of selecting the descendant `svg` (C-DOM-05).
1187
1712
  * badge — optional ReactNode pinned to the top-right corner (e.g. a count).
1188
1713
  */
1714
+ /** Every intent of the shared vocabulary is an IconTile tint. */
1715
+ type IconTileIntent = Intent;
1716
+ /** Legacy `tone` → `intent` (ADR-007 §4) for the values that have one. */
1717
+ declare const ICON_TILE_TONE_TO_INTENT: {
1718
+ readonly pro: "brand";
1719
+ readonly neutral: "neutral";
1720
+ readonly info: "info";
1721
+ readonly success: "success";
1722
+ readonly warning: "warning";
1723
+ readonly danger: "danger";
1724
+ };
1725
+ /**
1726
+ * The pre-W3-21 colour words (compat registry C-TONE).
1727
+ *
1728
+ * @deprecated Use `intent` — `tone="pro"` is `intent="brand"`, the status
1729
+ * values keep their name. The suite tints (`audit`, `books`, `tax`) have no
1730
+ * intent and stay on `tone` until the products own a service → colour
1731
+ * mapping (target architecture §40). Removed in 3.0; CM-06 rewrites the
1732
+ * mappable call sites and lists the rest.
1733
+ */
1734
+ type IconTileTone = keyof typeof ICON_TILE_TONE_TO_INTENT | IconTileSuiteTone;
1735
+ type IconTileSize = "sm" | "md" | "lg" | "xl";
1189
1736
  declare const iconTileVariants: (props?: ({
1190
- tone?: "neutral" | "info" | "success" | "warning" | "danger" | "audit" | "books" | "tax" | "pro" | null | undefined;
1191
- size?: "sm" | "md" | "lg" | null | undefined;
1737
+ intent?: "brand" | "neutral" | "info" | "success" | "warning" | "danger" | null | undefined;
1738
+ suite?: "audit" | "books" | "tax" | null | undefined;
1739
+ size?: "sm" | "md" | "lg" | "xl" | null | undefined;
1192
1740
  } & class_variance_authority_types.ClassProp) | undefined) => string;
1193
- interface IconTileProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof iconTileVariants> {
1741
+ /** Suite tints: product hues that stay on the deprecated `tone` axis. */
1742
+ type IconTileSuiteTone = NonNullable<VariantProps<typeof iconTileVariants>["suite"]>;
1743
+ interface IconTileVariantProps {
1744
+ /** Semantic tint (ADR-007). Default `brand`. Wins over `tone`. */
1745
+ intent?: IconTileIntent | null;
1746
+ /**
1747
+ * @deprecated Use `intent`. `pro` → `brand`; status values keep their name;
1748
+ * `audit` / `books` / `tax` stay here (no intent).
1749
+ */
1750
+ tone?: IconTileTone | null;
1751
+ size?: IconTileSize | null;
1752
+ }
1753
+ /** The IconTile class string. Accepts `intent` or the deprecated `tone`. */
1754
+ declare function resolveIconTileVariants({ intent, tone, size }?: IconTileVariantProps): string;
1755
+
1756
+ interface IconTileProps extends React.HTMLAttributes<HTMLDivElement>, IconTileVariantProps {
1194
1757
  /** The icon (or any node) rendered centered inside the tile. */
1195
1758
  icon: React.ReactNode;
1196
1759
  /** Optional overlay pinned to the top-right corner, e.g. a count badge. */
@@ -1198,351 +1761,6 @@ interface IconTileProps extends React.HTMLAttributes<HTMLDivElement>, VariantPro
1198
1761
  }
1199
1762
  declare const IconTile: React$1.ForwardRefExoticComponent<IconTileProps & React$1.RefAttributes<HTMLDivElement>>;
1200
1763
 
1201
- /**
1202
- * Shared component vocabulary (W3-01, ADR-007, target architecture §28).
1203
- *
1204
- * Every component that offers one of these axes must use *this* type for it,
1205
- * never a private union with the same words. Components that support only a
1206
- * subset narrow with `Extract<…>`; nothing may widen a list. The lists are
1207
- * closed: adding a word is an ADR-007 amendment, not a component change.
1208
- *
1209
- * Types only — this module has no runtime and adds nothing to `dist/index.js`.
1210
- * All four names are `@experimental` until decision D4 (`danger` vs
1211
- * `destructive`) is resolved and the Wave 3 components that adopt them are
1212
- * marked stable (ADR-007 acceptance condition).
1213
- */
1214
-
1215
- /**
1216
- * Semantic meaning → colour family.
1217
- *
1218
- * `intent` says *what the element means*; `variant` says how loudly. A
1219
- * `danger` action, a `danger` badge and a `danger` alert share one colour
1220
- * family (`--ds-color-danger-*`) at three different emphases.
1221
- *
1222
- * `danger` is the canonical word (decision D4, default); `destructive` is
1223
- * accepted by components as a deprecated alias for the 2.x line and is *not*
1224
- * a member of this type.
1225
- *
1226
- * @experimental
1227
- */
1228
- type Intent = "neutral" | "brand" | "info" | "success" | "warning" | "danger";
1229
- /**
1230
- * Visual emphasis — how strongly the element asserts itself, independent of
1231
- * what it means. Actions, badges, alerts and chips each pick the subset that
1232
- * applies (`Extract<Variant, "solid" | "soft" | "outline">` for Badge).
1233
- *
1234
- * - `solid` — filled with the intent colour, contrasting foreground
1235
- * - `soft` — tinted background, intent-coloured foreground
1236
- * - `outline` — border only, transparent background
1237
- * - `ghost` — no border or background until hovered
1238
- * - `link` — inline text, underlined on hover; actions only
1239
- *
1240
- * State (`disabled`, `loading`, `pressed`, `selected`, …) is never a variant:
1241
- * it is a boolean prop reflected as a `data-*` or ARIA attribute.
1242
- *
1243
- * @experimental
1244
- */
1245
- type Variant = "solid" | "soft" | "outline" | "ghost" | "link";
1246
- /**
1247
- * The shared control size step (ADR-013, W2-03): one name means one outer
1248
- * height on every control that offers it, read from
1249
- * `--ds-control-height-{size}`. Derived from the token scale so the type and
1250
- * the tokens cannot disagree; it resolves to `"xs" | "sm" | "md" | "lg" | "xl"`.
1251
- *
1252
- * The pixels behind each step are decision D5; existing components keep
1253
- * today's geometry under these names until 2.0 (compat token per control).
1254
- *
1255
- * @experimental
1256
- */
1257
- type ControlSize = keyof SystemTokens["control"]["height"];
1258
- /**
1259
- * Corner treatment, offered only where it is a real choice (W2-07 radius roles,
1260
- * target architecture §18, §28).
1261
- *
1262
- * - `rounded` — the component's radius role (`--ds-radius-control`,
1263
- * `--ds-radius-badge`, …)
1264
- * - `pill` — `--ds-radius-full`
1265
- * - `square` — no rounding beyond the smallest reference step; icon tiles only
1266
- *
1267
- * A component's *default* shape is whatever it renders today; changing a
1268
- * default is decision D1 and waits for 2.0.
1269
- *
1270
- * @experimental
1271
- */
1272
- type Shape = "rounded" | "pill" | "square";
1273
-
1274
- /**
1275
- * Named icon boxes — the four `--ds-icon-size-*` steps of W2-10 (12 / 14 / 16 /
1276
- * 20 px), spelled with the shared size vocabulary (ADR-007) and derived from the
1277
- * token scale so the type and the tokens cannot disagree.
1278
- */
1279
- type IconSize = Extract<ControlSize, keyof typeof iconSizes>;
1280
- interface IconProps extends React.SVGAttributes<SVGElement> {
1281
- /**
1282
- * The icon box. A size name renders `var(--ds-icon-size-<name>)` — with the
1283
- * legacy `--icon-size-<name>` and then the token's pixel value as fallbacks —
1284
- * so a theme can retune the boxes; a number is a pixel box, as before.
1285
- * Defaults to 24, the grid the glyphs are drawn on.
1286
- */
1287
- size?: IconSize | number;
1288
- /**
1289
- * Stroke width of every stroked element, set once on the root `<svg>` and
1290
- * inherited. Defaults to 1.5, the catalogue's baseline; the few glyphs drawn
1291
- * heavier (`XIcon`, `CheckIcon`, `BoldIcon`) default to their own weight.
1292
- */
1293
- strokeWidth?: number | string;
1294
- /**
1295
- * Accessible name. Icons are decorative (`aria-hidden`); a `title` exposes
1296
- * the svg as `role="img"` with a `<title>` child. (An `aria-label` alone
1297
- * still lands on the hidden svg, as it always has — C-DOM-15 freezes that
1298
- * DOM for Pro; use `title` to name an icon.)
1299
- */
1300
- title?: string;
1301
- }
1302
- /** What every catalogue icon and every `createIcon()` product is. */
1303
- interface IconComponent {
1304
- (props: IconProps): React.JSX.Element;
1305
- displayName?: string;
1306
- }
1307
- interface IconDefinition {
1308
- /** Component name, e.g. `"ArchiveIcon"`; becomes the `displayName`. */
1309
- name: string;
1310
- /**
1311
- * What to draw. Path data strings become `currentColor` strokes with round
1312
- * caps and joins, the catalogue's outline style; pass elements for anything
1313
- * else (filled dots, rects, a mark's fixed colours). Elements must not set
1314
- * their own `strokeWidth` — it lives on the root so the prop works.
1315
- */
1316
- paths: string | readonly string[] | React.ReactNode;
1317
- /** Defaults to `"0 0 24 24"`. A product icon drawn on another grid sets its own. */
1318
- viewBox?: string;
1319
- /** This glyph's default stroke width when the caller passes none. Defaults to 1.5. */
1320
- strokeWidth?: number | string;
1321
- }
1322
- /**
1323
- * Builds an icon component with the catalogue's props, sizing, stroke and
1324
- * accessibility contract from path data or SVG elements. Products use it for
1325
- * icons that are theirs (vendor logos, annotation shapes) without inlining
1326
- * `<svg>` at call sites; the catalogue uses it for its newer glyphs.
1327
- *
1328
- * @example
1329
- * const ArchiveIcon = createIcon({
1330
- * name: "ArchiveIcon",
1331
- * paths: ["M3 3h18a1 1 0 011 1v3a1 1 0 01-1 1H3a1 1 0 01-1-1V4a1 1 0 011-1z", "M4 8v11a2 2 0 002 2h12a2 2 0 002-2V8", "M10 12h4"],
1332
- * });
1333
- */
1334
- declare function createIcon(definition: IconDefinition): IconComponent;
1335
- declare function DocumentIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1336
- declare function ArrowRightIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1337
- declare function StarIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1338
- declare function SparkleIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1339
- /**
1340
- * ExtractIcon — gradient (Pro purple → cyan) tri-sparkle used for AI
1341
- * "Extract" affordances. Unlike the currentColor catalog, the fill is a
1342
- * fixed brand gradient; `size` scales it while preserving the 16:12 ratio.
1343
- * Gradient/clip ids are per-instance (useId) so multiple icons don't clash.
1344
- */
1345
- declare function ExtractIcon({ size, className, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1346
- declare function ChatBubbleIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1347
- declare function LightningIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1348
- declare function UsersIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1349
- declare function FileTextIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1350
- declare function ShieldIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1351
- declare function MenuIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1352
- /**
1353
- * @deprecated Use `XIcon` — the same glyph under its lucide name (the catalogue
1354
- * drew it twice). This alias is the identical component and stays through 2.x.
1355
- */
1356
- declare const CloseIcon: typeof XIcon;
1357
- declare function CheckIcon({ size, strokeWidth, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1358
- declare function LayoutDashboardIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1359
- declare function BuildingIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1360
- /** Landmark / "bank" glyph (columns + pediment) — the accounting service mark. */
1361
- declare function LandmarkIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1362
- /** Folder with an up-arrow — the "upload documents" / document-request mark. */
1363
- declare function FolderUpIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1364
- /** Pen-tool / nibbed signature pen — the e-signature mark. */
1365
- declare function PenToolIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1366
- declare function MapPinIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1367
- declare function FileReturnIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1368
- declare function ClipboardCheckIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1369
- declare function FolderOpenIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1370
- declare function ReceiptIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1371
- declare function CalendarIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1372
- declare function BarChartIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1373
- declare function SettingsIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1374
- declare function PanelLeftIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1375
- declare function PanelLeftCloseIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1376
- declare function SunIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1377
- declare function TeamIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1378
- declare function MoonIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1379
- declare function PaletteIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1380
- declare function MailIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1381
- declare function GlobeIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1382
- declare function BellIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1383
- declare function WorkflowIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1384
- declare function LinkIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1385
- declare function KeyIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1386
- declare function SearchIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1387
- declare function LogOutIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1388
- declare function TagIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1389
- declare function SendIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1390
- declare function TrashIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1391
- declare function Link2Icon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1392
- declare function ChevronUpIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1393
- declare function ChevronDownIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1394
- declare function PlusIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1395
- declare function UserCircleIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1396
- declare function PencilIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1397
- declare function PhoneIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1398
- declare function FolderClosedIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1399
- declare function UploadIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1400
- declare function DownloadIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1401
- declare function MoreHorizontalIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1402
- declare function ChevronRightIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1403
- declare function ChevronLeftIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1404
- declare function FileIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1405
- declare function RotateCcwIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1406
- declare function EyeIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1407
- declare function ClockIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1408
- declare function LayoutListIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1409
- declare function LayoutGridIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1410
- declare function LockIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1411
- declare function FolderPlusIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1412
- declare function MoveIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1413
- declare function LockKeyholeIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1414
- declare function PaperclipIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1415
- declare function AtSignIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1416
- declare function ZoomInIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1417
- declare function ZoomOutIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1418
- declare function XIcon({ size, strokeWidth, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1419
- declare function MessageCircleWarningIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1420
- declare function FlagIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1421
- declare function LockOpenIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1422
- declare function MessageCircleIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1423
- declare function PenSignIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1424
- declare function CopyIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1425
- declare function MonitorIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1426
- declare function SmartphoneIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1427
- declare function AlertTriangleIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1428
- /**
1429
- * @deprecated Use `ArrowRightIcon` — it is the same path; "small" was never a
1430
- * different drawing. This alias is the identical component and stays through 2.x.
1431
- */
1432
- declare const ArrowRightSmallIcon: typeof ArrowRightIcon;
1433
- declare function ArrowLeftIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1434
- declare function CreditCardIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1435
- declare function AlertCircleIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1436
- declare function ArrowDownIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1437
- declare function ArrowUpIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1438
- declare function BriefcaseIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1439
- declare function Building2Icon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1440
- declare function CheckCircle2Icon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1441
- declare function ChevronsUpDownIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1442
- declare function CircleIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1443
- declare function CircleDotIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1444
- declare function CommandIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1445
- declare function CornerDownLeftIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1446
- declare function EyeOffIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1447
- declare function HomeIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1448
- declare function InboxIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1449
- declare function ListChecksIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1450
- declare function MinusIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1451
- declare function SlashIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1452
- declare function SparklesIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1453
- declare function Trash2Icon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1454
- declare function UserIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1455
- declare function BoldIcon({ size, strokeWidth, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1456
- declare function ItalicIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1457
- declare function UnderlineIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1458
- declare function StrikethroughIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1459
- declare function ListIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1460
- declare function ListOrderedIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1461
- declare function InfoIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1462
- declare function HelpCircleIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1463
- declare function DollarSignIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1464
- declare function ReplyIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1465
- declare function KanbanIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1466
- declare function TableIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1467
- declare function HistoryIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1468
- declare function SaveIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1469
- /**
1470
- * LoaderIcon — animated spinner. Render with `className="animate-spin"`
1471
- * (or `motion-safe:animate-spin` if you want to respect `prefers-reduced-
1472
- * motion`; the catalog doesn't gate this itself because the spinner IS
1473
- * the indicator for many flows).
1474
- *
1475
- * Visual contract: a dim full-circle ring + a brighter quarter-arc on top.
1476
- * When rotated, the bright arc creates the "leading edge" of the spinner.
1477
- */
1478
- declare function LoaderIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1479
- /**
1480
- * GoogleBrandIcon — Google four-color "G" mark. Brand-locked colors,
1481
- * does NOT respond to currentColor. Use only in provider-list UIs
1482
- * (OAuth buttons, integration chips). Standard 24-grid.
1483
- */
1484
- declare function GoogleBrandIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1485
- /**
1486
- * MicrosoftBrandIcon — Microsoft four-square mark in red / green / blue /
1487
- * yellow. Brand-locked colors, does NOT respond to currentColor. Use
1488
- * inside Microsoft OAuth signin buttons, Outlook / Office integration
1489
- * chips, and similar provider-list UIs. Standard 24-grid (10×10 squares
1490
- * with 2u gaps).
1491
- */
1492
- declare function MicrosoftBrandIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1493
- /**
1494
- * FilterIcon — funnel mark used for filter popover triggers across list
1495
- * pages (clients, workflow, billing, organizers…). Renders the same
1496
- * lucide-style polygon at any size; pair with a corner notification dot
1497
- * to surface active filter count.
1498
- */
1499
- declare function FilterIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1500
- declare function CheckCircleSolidIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1501
- declare function XCircleSolidIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1502
- declare function AlertTriangleSolidIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1503
- declare function InfoCircleSolidIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1504
- declare function TrendingUpIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1505
- declare function TrendingDownIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1506
- declare function PlayIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1507
- declare function PauseIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1508
- declare function StopIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
1509
- /** Six-dot drag handle for sortable rows and kanban cards. */
1510
- declare const GripVerticalIcon: IconComponent;
1511
- /** Enter full screen / expand a panel — four outward corners. */
1512
- declare const MaximizeIcon: IconComponent;
1513
- /** Leave full screen / shrink a panel — four inward corners. */
1514
- declare const MinimizeIcon: IconComponent;
1515
- declare const ArchiveIcon: IconComponent;
1516
- declare const ThumbsUpIcon: IconComponent;
1517
- declare const ThumbsDownIcon: IconComponent;
1518
- declare const LayersIcon: IconComponent;
1519
- /** Formula / sum — the Greek capital sigma. */
1520
- declare const SigmaIcon: IconComponent;
1521
- /** Video camera; pair with `PlayIcon` for playback. */
1522
- declare const VideoIcon: IconComponent;
1523
- declare const MicIcon: IconComponent;
1524
- /** Speaker with two sound waves — audio on. */
1525
- declare const Volume2Icon: IconComponent;
1526
- /** Speaker with a cross — muted. */
1527
- declare const VolumeXIcon: IconComponent;
1528
- /** Two clockwise arrows — refresh / sync. `RotateCcwIcon` is the single-arrow undo. */
1529
- declare const RefreshCwIcon: IconComponent;
1530
- /** Stopwatch — elapsed time and timers; `ClockIcon` is wall-clock time. */
1531
- declare const TimerIcon: IconComponent;
1532
- declare const BrainIcon: IconComponent;
1533
- /** Pop-out / opens elsewhere — box with an arrow leaving the top-right corner. */
1534
- declare const ExternalLinkIcon: IconComponent;
1535
- /** Dock to the right — the mirror of `PanelLeftIcon`. */
1536
- declare const PanelRightIcon: IconComponent;
1537
- /** Collapse — the pair of `ChevronsUpDownIcon`. */
1538
- declare const ChevronsDownUpIcon: IconComponent;
1539
- /**
1540
- * Filled trash can for destructive affordances inside small round buttons,
1541
- * where the outline `TrashIcon` reads as thin. Same family as the solid status
1542
- * icons: the slots are knockouts.
1543
- */
1544
- declare const TrashSolidIcon: IconComponent;
1545
-
1546
1764
  /**
1547
1765
  * Input variants. Mirrors the raw HTML `<input>` styled per the suite tokens
1548
1766
  * (rule-strong border, surface bg, accent focus ring).
@@ -1602,12 +1820,28 @@ interface LabelProps extends React$1.ComponentPropsWithoutRef<typeof LabelPrimit
1602
1820
  }
1603
1821
  declare const Label: React$1.ForwardRefExoticComponent<LabelProps & React$1.RefAttributes<HTMLLabelElement>>;
1604
1822
 
1605
- interface LinkButtonProps$1 extends Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, "href"> {
1823
+ interface LinkButtonProps$1 extends Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, "href">, ButtonIconProps {
1606
1824
  href: string;
1825
+ /** Visual emphasis; the legacy words are deprecated aliases (see `Button`). */
1607
1826
  variant?: ButtonVariant;
1827
+ /**
1828
+ * Meaning → colour family: `brand` · `neutral` · `success` · `danger`.
1829
+ * Defaults per variant so an omitted prop renders what it always did.
1830
+ *
1831
+ * @experimental
1832
+ */
1833
+ intent?: ButtonIntent | ButtonIntentAlias;
1834
+ /**
1835
+ * The shared control scale (see `Button`). The icon-only squares and the
1836
+ * `compact` / `default` / `comfortable` aliases are deprecated.
1837
+ */
1608
1838
  size?: ButtonSize;
1609
- iconLeft?: React.ReactNode;
1610
- iconRight?: React.ReactNode;
1839
+ /**
1840
+ * Stretch to the container's width (`w-full`).
1841
+ *
1842
+ * @experimental
1843
+ */
1844
+ fullWidth?: boolean;
1611
1845
  children: React.ReactNode;
1612
1846
  className?: string;
1613
1847
  /**
@@ -1621,10 +1855,21 @@ interface LinkButtonProps$1 extends Omit<React.AnchorHTMLAttributes<HTMLAnchorEl
1621
1855
  * `rel="noopener noreferrer"` is applied automatically.
1622
1856
  */
1623
1857
  external?: boolean;
1858
+ /**
1859
+ * A disabled link (W3-08). A link has no native `disabled`, so this renders
1860
+ * `aria-disabled="true"`, `tabIndex={-1}`, `data-disabled`, the disabled
1861
+ * colours and `pointer-events: none`, and swallows the click and Enter /
1862
+ * Space so nothing navigates and `onClick` is not called. `href` stays on
1863
+ * the element: it is still a link, announced as disabled.
1864
+ *
1865
+ * @experimental
1866
+ */
1867
+ disabled?: boolean;
1624
1868
  }
1625
1869
  /**
1626
1870
  * LinkButton — visually identical to `<Button>` but renders a link.
1627
- * Shares `buttonVariants` so styling stays in lock-step.
1871
+ * Shares `buttonVariants` so styling stays in lock-step: the same `variant`
1872
+ * + `intent` axes and the same legacy aliases (W3-02).
1628
1873
  *
1629
1874
  * - Default: renders `next/link` (client-routed internal navigation).
1630
1875
  * - `external`: renders a native `<a>` so the browser handles the request
@@ -1952,6 +2197,50 @@ declare const PopoverPortal: React$1.FC<PopoverPrimitive.PopoverPortalProps>;
1952
2197
  declare const PopoverClose: React$1.ForwardRefExoticComponent<PopoverPrimitive.PopoverCloseProps & React$1.RefAttributes<HTMLButtonElement>>;
1953
2198
  declare const PopoverContent: React$1.ForwardRefExoticComponent<Omit<PopoverPrimitive.PopoverContentProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
1954
2199
 
2200
+ interface PressableProps extends React.ButtonHTMLAttributes<HTMLElement> {
2201
+ /**
2202
+ * Render the child element instead of a `<button>` (Radix `Slot`). The
2203
+ * child keeps its own element and role — an `<a href>` stays a link — and
2204
+ * gains the pressable behaviour: Space activates it like a button, `disabled`
2205
+ * becomes `aria-disabled` + `tabIndex={-1}` with the click swallowed, and
2206
+ * `pressed` is reflected. A child that is neither a `<button>` nor a link
2207
+ * must carry its own `role="button"` and `tabIndex`.
2208
+ */
2209
+ asChild?: boolean;
2210
+ /**
2211
+ * Toggle state (a boolean prop, never a variant — ADR-007 §2). Reflected as
2212
+ * `aria-pressed` and, when true, `data-pressed`. Leave undefined for an
2213
+ * action that does not toggle.
2214
+ */
2215
+ pressed?: boolean;
2216
+ /**
2217
+ * Native `disabled` on a `<button>`; on any other element (`asChild`)
2218
+ * `aria-disabled="true"`, removal from the tab order and a prevented click,
2219
+ * because links and generic elements have no `disabled` attribute.
2220
+ */
2221
+ disabled?: boolean;
2222
+ }
2223
+ /**
2224
+ * The behaviour of a button, without its look (W3-03; target architecture
2225
+ * §30, ADR-008). What every pressable thing in the system needs and what a
2226
+ * `<div onClick>` never gets: keyboard activation with Enter *and* Space, a
2227
+ * visible focus ring, disabled semantics that hold on links, and `pressed`
2228
+ * reflected as ARIA and as a `data-*` hook for styling.
2229
+ *
2230
+ * Unstyled-accessible: the only classes are the cursor, the focus ring and
2231
+ * `pointer-events-none` while disabled. Geometry and colour belong to the
2232
+ * component that composes it (`Button`'s recipe is `buttonBase`; a clickable
2233
+ * `Surface` renders through this).
2234
+ *
2235
+ * State attributes on the root: `data-slot="pressable"`, `data-disabled`,
2236
+ * `data-pressed`. The native element defaults to `type="button"` — a new
2237
+ * primitive has no submit-by-default legacy to keep (Button's own default is
2238
+ * W3-10).
2239
+ *
2240
+ * @experimental
2241
+ */
2242
+ declare const Pressable: React$1.ForwardRefExoticComponent<PressableProps & React$1.RefAttributes<HTMLElement>>;
2243
+
1955
2244
  /**
1956
2245
  * PriorityIcon — priority glyph for the fixed none/low/medium/high/urgent scale.
1957
2246
  *
@@ -1968,11 +2257,45 @@ interface PriorityIconProps extends Omit<React.SVGAttributes<SVGSVGElement>, "co
1968
2257
  }
1969
2258
  declare function PriorityIcon({ priority, size, className, ...props }: PriorityIconProps): react_jsx_runtime.JSX.Element;
1970
2259
 
2260
+ /**
2261
+ * The colour vocabulary shared by the Progress family (W3-21, ADR-007 §4,
2262
+ * compat registry C-PROGRESS).
2263
+ *
2264
+ * `ProgressBar` and `ProgressRing` spelled their colour axis `variant`,
2265
+ * `SegmentedProgress` spelled it `tone`, and all three called the brand
2266
+ * colour `default` and danger `destructive`. The new spelling is `intent`
2267
+ * everywhere; the old words stay accepted as deprecated aliases that resolve
2268
+ * through the table below, and every legacy value keeps its classes.
2269
+ *
2270
+ * The family also **auto-colours by value** when no colour is passed
2271
+ * (`< 50%` brand, `≥ 50%` warning, `≥ 80%` success). That mapping is
2272
+ * business-adjacent (Tax documents it as a gotcha) and is kept **on** until
2273
+ * 2.0 (W9-10); an explicit `intent` switches it off, and CM-19 writes the
2274
+ * intent the rule would have picked into every literal-valued call site.
2275
+ *
2276
+ * Lives in the foundation layer because the four presets (L2, one A2 group)
2277
+ * share it and A2 allows no import between them; the unified `Progress`
2278
+ * module (target architecture §26) folds them together later.
2279
+ */
2280
+ /** Every intent of the shared vocabulary is a Progress colour. */
2281
+ type ProgressIntent = Intent;
2282
+ /**
2283
+ * The pre-W3-21 colour words of `ProgressBar`/`ProgressRing` (`variant`) and
2284
+ * `SegmentedProgress` (`tone`).
2285
+ *
2286
+ * @deprecated Use `intent` — `default` → `brand`, `destructive` → `danger`,
2287
+ * the others keep their name. Removed in 3.0; CM-06 / CM-19 rewrite call sites.
2288
+ */
2289
+ type ProgressLegacyColour = "default" | "success" | "warning" | "destructive" | "info";
2290
+ /** Legacy colour word → `intent` (ADR-007 §4). Classes are identical on both sides. */
2291
+ declare const PROGRESS_LEGACY_TO_INTENT: Readonly<Record<ProgressLegacyColour, ProgressIntent>>;
2292
+
1971
2293
  /**
1972
2294
  * ProgressBar — Radix-driven determinate (or indeterminate) progress meter.
1973
- * Track sits on `bg-3`; fills follow the status palette. Variants are an
1974
- * explicit cva enum; if `variant` is omitted, it auto-resolves from value:
1975
- * <50% → default (brand)
2295
+ * Track sits on `bg-3`; the fill follows `intent` (ADR-007). When neither
2296
+ * `intent` nor the deprecated `variant` is passed, the colour auto-resolves
2297
+ * from the value (kept on until 2.0, W9-10):
2298
+ * <50% → brand
1976
2299
  * ≥50% → warning
1977
2300
  * ≥80% → success
1978
2301
  *
@@ -1980,10 +2303,24 @@ declare function PriorityIcon({ priority, size, className, ...props }: PriorityI
1980
2303
  * Pass `value={null}` (or omit when in-doubt) to render Radix's indeterminate
1981
2304
  * state — but for back-compat we still accept `value: number`.
1982
2305
  */
1983
- declare const progressBarVariants: (props?: ({
1984
- variant?: "info" | "success" | "warning" | "default" | "destructive" | null | undefined;
1985
- } & class_variance_authority_types.ClassProp) | undefined) => string;
1986
- interface ProgressBarProps extends Omit<React.ComponentPropsWithoutRef<typeof ProgressPrimitive.Root>, "value">, VariantProps<typeof progressBarVariants> {
2306
+ /** @deprecated Use `intent`. `default` → `brand`, `destructive` → `danger`. */
2307
+ type ProgressBarVariant = ProgressLegacyColour;
2308
+ interface ProgressBarVariantProps {
2309
+ /**
2310
+ * Semantic fill colour (ADR-007). Passing it switches the value-driven
2311
+ * auto-colour off. Wins over `variant`.
2312
+ */
2313
+ intent?: ProgressIntent | null;
2314
+ /** @deprecated Use `intent`. `default` → `brand`, `destructive` → `danger`. */
2315
+ variant?: ProgressBarVariant | null;
2316
+ }
2317
+ /**
2318
+ * The indicator class string for a resolved colour. Accepts `intent` or the
2319
+ * deprecated `variant`; with neither it renders `brand` (the component itself
2320
+ * auto-colours by value before calling this).
2321
+ */
2322
+ declare function progressBarVariants({ intent, variant }?: ProgressBarVariantProps): string;
2323
+ interface ProgressBarProps extends Omit<React.ComponentPropsWithoutRef<typeof ProgressPrimitive.Root>, "value">, ProgressBarVariantProps {
1987
2324
  /** 0..max. Set to `null` for an indeterminate track. */
1988
2325
  value: number | null;
1989
2326
  max?: number;
@@ -1994,15 +2331,31 @@ declare const ProgressBar: React$1.ForwardRefExoticComponent<ProgressBarProps &
1994
2331
 
1995
2332
  /**
1996
2333
  * ProgressRing — custom SVG ring meter (no Radix equivalent).
1997
- * Track is `bg-3`, the indicator picks up the active variant. Variants and
1998
- * value-driven auto-resolve mirror ProgressBar so consumers can mix freely.
2334
+ * Track is `bg-3`, the indicator picks up the active `intent` (ADR-007).
2335
+ * Colours and the value-driven auto-resolve mirror ProgressBar so consumers
2336
+ * can mix freely; the auto-colour applies only when neither `intent` nor the
2337
+ * deprecated `variant` is passed (kept on until 2.0, W9-10).
1999
2338
  *
2000
2339
  * Public API preserved: `value`, `max`, `size`, `strokeWidth`, `label`, `sublabel`.
2001
2340
  */
2002
- declare const progressRingVariants: (props?: ({
2003
- variant?: "info" | "success" | "warning" | "default" | "destructive" | null | undefined;
2004
- } & class_variance_authority_types.ClassProp) | undefined) => string;
2005
- interface ProgressRingProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof progressRingVariants> {
2341
+ /** @deprecated Use `intent`. `default` → `brand`, `destructive` → `danger`. */
2342
+ type ProgressRingVariant = ProgressLegacyColour;
2343
+ interface ProgressRingVariantProps {
2344
+ /**
2345
+ * Semantic indicator colour (ADR-007). Passing it switches the value-driven
2346
+ * auto-colour off. Wins over `variant`.
2347
+ */
2348
+ intent?: ProgressIntent | null;
2349
+ /** @deprecated Use `intent`. `default` → `brand`, `destructive` → `danger`. */
2350
+ variant?: ProgressRingVariant | null;
2351
+ }
2352
+ /**
2353
+ * The indicator class string for a resolved colour. Accepts `intent` or the
2354
+ * deprecated `variant`; with neither it renders `brand` (the component itself
2355
+ * auto-colours by value before calling this).
2356
+ */
2357
+ declare function progressRingVariants({ intent, variant }?: ProgressRingVariantProps): string;
2358
+ interface ProgressRingProps extends React.HTMLAttributes<HTMLDivElement>, ProgressRingVariantProps {
2006
2359
  value: number;
2007
2360
  max?: number;
2008
2361
  size?: number;
@@ -2254,21 +2607,33 @@ interface SectionHeadProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "t
2254
2607
  }
2255
2608
  declare const SectionHead: React$1.ForwardRefExoticComponent<SectionHeadProps & React$1.RefAttributes<HTMLDivElement>>;
2256
2609
 
2610
+ /** Service tints — product hues, never intents (ADR-007 §2); reachable through `tone` only. */
2611
+ declare const SERVICE_FILL: {
2612
+ tax: string;
2613
+ audit: string;
2614
+ accounting: string;
2615
+ };
2616
+ /** Service tints: product hues that stay on the deprecated `tone` axis. */
2617
+ type SegmentedServiceTone = keyof typeof SERVICE_FILL;
2257
2618
  /**
2258
- * SegmentedProgress discrete step meter rendered as N pill segments, the
2259
- * first `current` of which are filled. Used on engagement cards ("step 2
2260
- * of 5") where a continuous bar would over-state precision.
2619
+ * The pre-W3-21 colour words (compat registry C-TONE).
2261
2620
  *
2262
- * `tone` colors the filled segments. Status tones map to the semantic
2263
- * palette; service tones map to the practice ramp both resolve to a
2264
- * single CSS color so the segment markup stays identical.
2621
+ * @deprecated Use `intent` `default` `brand`, `destructive` `danger`,
2622
+ * the other status words keep their name. The service tones have no intent
2623
+ * and stay here. Removed in 3.0; CM-06 rewrites the mappable call sites.
2265
2624
  */
2266
- type SegmentedTone = "default" | "success" | "warning" | "destructive" | "info" | "tax" | "audit" | "accounting";
2625
+ type SegmentedTone = ProgressLegacyColour | SegmentedServiceTone;
2267
2626
  interface SegmentedProgressProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "children"> {
2268
2627
  /** Total number of segments. */
2269
2628
  steps: number;
2270
2629
  /** How many leading segments are filled. */
2271
2630
  current: number;
2631
+ /** Semantic fill colour (ADR-007). Default `brand`. Wins over `tone`. */
2632
+ intent?: ProgressIntent;
2633
+ /**
2634
+ * @deprecated Use `intent`. `default` → `brand`, `destructive` → `danger`;
2635
+ * `tax` / `audit` / `accounting` stay here (no intent).
2636
+ */
2272
2637
  tone?: SegmentedTone;
2273
2638
  /** Segment height in px. Default 6. */
2274
2639
  thickness?: number;
@@ -2451,11 +2816,43 @@ interface SliderProps extends React$1.ComponentPropsWithoutRef<typeof SliderPrim
2451
2816
  }
2452
2817
  declare const Slider: React$1.ForwardRefExoticComponent<SliderProps & React$1.RefAttributes<HTMLSpanElement>>;
2453
2818
 
2454
- declare const spinnerVariants: (props?: ({
2455
- size?: "xs" | "sm" | "md" | "lg" | null | undefined;
2456
- tone?: "accent" | "success" | "warning" | "current" | "destructive" | "muted" | null | undefined;
2457
- } & class_variance_authority_types.ClassProp) | undefined) => string;
2458
- interface SpinnerProps extends React.HTMLAttributes<HTMLSpanElement>, VariantProps<typeof spinnerVariants> {
2819
+ /**
2820
+ * Spinner indeterminate activity indicator.
2821
+ *
2822
+ * intent omitted (default) inherits `currentColor`, so a Spinner inside a
2823
+ * Button takes the button's ink; `neutral` | `brand` | `info` |
2824
+ * `success` | `warning` | `danger` pick a colour (ADR-007).
2825
+ * `tone` is the deprecated spelling: `muted` → `neutral`,
2826
+ * `accent` → `info`, `destructive` → `danger`, `current` → omit.
2827
+ * size — xs (12px) | sm (16px) | md (20px, default) | lg (24px)
2828
+ */
2829
+ /** Every intent of the shared vocabulary is a Spinner colour. */
2830
+ type SpinnerIntent = Intent;
2831
+ /**
2832
+ * The pre-W3-21 colour words (compat registry C-TONE).
2833
+ *
2834
+ * @deprecated Use `intent` — `muted` → `neutral`, `accent` → `info`,
2835
+ * `destructive` → `danger`; `current` is the default and is simply omitted.
2836
+ * Removed in 3.0; CM-06 rewrites call sites.
2837
+ */
2838
+ type SpinnerTone = "current" | "muted" | "accent" | "success" | "warning" | "destructive";
2839
+ type SpinnerSize = "xs" | "sm" | "md" | "lg";
2840
+ /**
2841
+ * Legacy `tone` → `intent` (ADR-007 §4). `current` maps to no intent: the
2842
+ * spinner inherits `currentColor`, which is also what an omitted `intent`
2843
+ * renders. Classes are identical on both sides.
2844
+ */
2845
+ declare const SPINNER_TONE_TO_INTENT: Readonly<Record<SpinnerTone, SpinnerIntent | undefined>>;
2846
+ interface SpinnerVariantProps {
2847
+ /** Semantic colour (ADR-007). Omitted, the spinner inherits `currentColor`. Wins over `tone`. */
2848
+ intent?: SpinnerIntent | null;
2849
+ /** @deprecated Use `intent`. `muted` → `neutral`, `accent` → `info`, `destructive` → `danger`. */
2850
+ tone?: SpinnerTone | null;
2851
+ size?: SpinnerSize | null;
2852
+ }
2853
+ /** The Spinner class string. Accepts `intent` or the deprecated `tone`. */
2854
+ declare function spinnerVariants({ intent, tone, size }?: SpinnerVariantProps): string;
2855
+ interface SpinnerProps extends React.HTMLAttributes<HTMLSpanElement>, SpinnerVariantProps {
2459
2856
  /**
2460
2857
  * Accessible status text. Omit when adjacent visible copy already names the
2461
2858
  * loading state, such as inside a button labelled "Saving".
@@ -2623,21 +3020,48 @@ declare const Stat: React$1.ForwardRefExoticComponent<StatProps & React$1.RefAtt
2623
3020
  * top-bar bells, list rows, unread markers. (Avatar already renders its own
2624
3021
  * corner presence dot — use that for avatar-attached dots.)
2625
3022
  *
2626
- * tone — danger (default) | warning | info | success | pro | neutral
3023
+ * intent — danger (default) | warning | info | success | brand | neutral
3024
+ * (ADR-007 vocabulary; `tone` is the deprecated spelling)
2627
3025
  * size — sm ~7px (default) | md ~9px
2628
3026
  * ring — adds a 2px solid surface ring so the dot reads when overlaid on
2629
3027
  * icons / avatars (box-shadow, so it never shifts layout)
2630
3028
  * pulse — subtle expanding ping halo; hidden under prefers-reduced-motion
2631
3029
  *
2632
- * The dot fills with `currentColor`, so the ping clone inherits the same tone
2633
- * automatically. `aria-hidden` by default — pass `aria-label` to expose it.
2634
- */
2635
- declare const statusDotVariants: (props?: ({
2636
- tone?: "neutral" | "info" | "success" | "warning" | "danger" | "pro" | null | undefined;
2637
- size?: "sm" | "md" | null | undefined;
2638
- ring?: boolean | null | undefined;
2639
- } & class_variance_authority_types.ClassProp) | undefined) => string;
2640
- interface StatusDotProps extends React.HTMLAttributes<HTMLSpanElement>, VariantProps<typeof statusDotVariants> {
3030
+ * The dot fills with `currentColor`, so the ping clone inherits the same
3031
+ * colour automatically. `aria-hidden` by default — pass `aria-label` to
3032
+ * expose it.
3033
+ */
3034
+ /** Every intent of the shared vocabulary is a StatusDot colour. */
3035
+ type StatusDotIntent = Intent;
3036
+ /** Legacy `tone` `intent` (ADR-007 §4). Classes are identical on both sides. */
3037
+ declare const STATUS_DOT_TONE_TO_INTENT: {
3038
+ readonly danger: "danger";
3039
+ readonly warning: "warning";
3040
+ readonly info: "info";
3041
+ readonly success: "success";
3042
+ readonly pro: "brand";
3043
+ readonly neutral: "neutral";
3044
+ };
3045
+ /**
3046
+ * The pre-W3-21 colour words (compat registry C-TONE). `pro` is the brand
3047
+ * colour spelled as a product name.
3048
+ *
3049
+ * @deprecated Use `intent` — `tone="pro"` is `intent="brand"`, every other
3050
+ * value keeps its name. Removed in 3.0; CM-06 rewrites call sites.
3051
+ */
3052
+ type StatusDotTone = keyof typeof STATUS_DOT_TONE_TO_INTENT;
3053
+ type StatusDotSize = "sm" | "md";
3054
+ interface StatusDotVariantProps {
3055
+ /** Semantic colour (ADR-007). Default `danger`. Wins over `tone`. */
3056
+ intent?: StatusDotIntent | null;
3057
+ /** @deprecated Use `intent`. `pro` → `brand`; other values keep their name. */
3058
+ tone?: StatusDotTone | null;
3059
+ size?: StatusDotSize | null;
3060
+ ring?: boolean | null;
3061
+ }
3062
+ /** The StatusDot class string. Accepts `intent` or the deprecated `tone`. */
3063
+ declare function statusDotVariants({ intent, tone, size, ring }?: StatusDotVariantProps): string;
3064
+ interface StatusDotProps extends React.HTMLAttributes<HTMLSpanElement>, StatusDotVariantProps {
2641
3065
  /** Subtle expanding ping halo. Respects `prefers-reduced-motion`. */
2642
3066
  pulse?: boolean;
2643
3067
  }
@@ -2737,6 +3161,13 @@ declare const StickyActionBar: React$1.ForwardRefExoticComponent<StickyActionBar
2737
3161
  interface SubmitButtonProps extends Omit<ButtonProps, "type" | "loading"> {
2738
3162
  pendingText?: string;
2739
3163
  children: React.ReactNode;
3164
+ /**
3165
+ * A submit button fills its form row by default (what it has always
3166
+ * rendered); pass `fullWidth={false}` for an inline one.
3167
+ *
3168
+ * @experimental
3169
+ */
3170
+ fullWidth?: boolean;
2740
3171
  }
2741
3172
  /**
2742
3173
  * SubmitButton — react-dom `useFormStatus`-aware Button.
@@ -2748,7 +3179,7 @@ declare const SubmitButton: React$1.ForwardRefExoticComponent<SubmitButtonProps
2748
3179
  * SuiteProgress — a discrete, segmented progress meter with a percent readout.
2749
3180
  *
2750
3181
  * Renders `total` equal-width segments in a flex row. Segments before `value`
2751
- * are filled in the suite tone; the rest sit on the `surface-3` track. An
3182
+ * are filled in the meter's colour; the rest sit on the `surface-3` track. An
2752
3183
  * optional numeric percent renders to the right (bold + tabular, with a
2753
3184
  * smaller "%").
2754
3185
  *
@@ -2757,11 +3188,40 @@ declare const SubmitButton: React$1.ForwardRefExoticComponent<SubmitButtonProps
2757
3188
  * pipeline and engagement *completion* (e.g. "3 of 5 — 60%"). Pick the step
2758
3189
  * meter when the count itself is the message; pick this when the percentage is.
2759
3190
  *
3191
+ * `intent` colours the filled segments (ADR-007; default `brand`, which is
3192
+ * what `tone="pro"` rendered). The suite tones (`audit` | `books` | `tax`)
3193
+ * stay on the deprecated `tone` axis: product names are never intents.
3194
+ *
2760
3195
  * Pure presentational — no client runtime required.
2761
3196
  */
2762
- declare const suiteProgressFillVariants: (props?: ({
2763
- tone?: "audit" | "books" | "tax" | "pro" | null | undefined;
2764
- } & class_variance_authority_types.ClassProp) | undefined) => string;
3197
+ /** Legacy `tone` → `intent` (ADR-007 §4): the one suite tone that is a brand colour. */
3198
+ declare const SUITE_PROGRESS_TONE_TO_INTENT: {
3199
+ readonly pro: "brand";
3200
+ };
3201
+ /** Suite tints — product hues, never intents (ADR-007 §2); reachable through `tone` only. */
3202
+ declare const SUITE_FILL: {
3203
+ audit: string;
3204
+ books: string;
3205
+ tax: string;
3206
+ };
3207
+ /** Suite tints: product hues that stay on the deprecated `tone` axis. */
3208
+ type SuiteProgressSuiteTone = keyof typeof SUITE_FILL;
3209
+ /**
3210
+ * The pre-W3-21 colour words (compat registry C-TONE).
3211
+ *
3212
+ * @deprecated Use `intent` — `tone="pro"` is `intent="brand"`. The suite
3213
+ * tones (`audit`, `books`, `tax`) have no intent and stay here. Removed in
3214
+ * 3.0; CM-06 rewrites the mappable call sites.
3215
+ */
3216
+ type SuiteProgressTone = keyof typeof SUITE_PROGRESS_TONE_TO_INTENT | SuiteProgressSuiteTone;
3217
+ interface SuiteProgressFillVariantProps {
3218
+ /** Semantic fill colour (ADR-007). Default `brand`. Wins over `tone`. */
3219
+ intent?: ProgressIntent | null;
3220
+ /** @deprecated Use `intent`. `pro` → `brand`; `audit` / `books` / `tax` stay here. */
3221
+ tone?: SuiteProgressTone | null;
3222
+ }
3223
+ /** The filled-segment class string. Accepts `intent` or the deprecated `tone`. */
3224
+ declare function suiteProgressFillVariants({ intent, tone }?: SuiteProgressFillVariantProps): string;
2765
3225
  declare const SIZE_STYLES: {
2766
3226
  readonly sm: {
2767
3227
  readonly row: "ds:gap-2";
@@ -2777,8 +3237,7 @@ declare const SIZE_STYLES: {
2777
3237
  };
2778
3238
  };
2779
3239
  type SuiteProgressSize = keyof typeof SIZE_STYLES;
2780
- type SuiteProgressTone = NonNullable<VariantProps<typeof suiteProgressFillVariants>["tone"]>;
2781
- interface SuiteProgressProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "role"> {
3240
+ interface SuiteProgressProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "role">, SuiteProgressFillVariantProps {
2782
3241
  /** Number of completed segments. */
2783
3242
  value: number;
2784
3243
  /** Total segment count. */
@@ -2787,8 +3246,6 @@ interface SuiteProgressProps extends Omit<React.HTMLAttributes<HTMLDivElement>,
2787
3246
  showPercent?: boolean;
2788
3247
  /** Override the displayed percent (0–100). Falls back to value/total. */
2789
3248
  percent?: number;
2790
- /** Suite tone for filled segments. Defaults to "pro". */
2791
- tone?: SuiteProgressTone;
2792
3249
  /** Bar height + text scale. Defaults to "md". */
2793
3250
  size?: SuiteProgressSize;
2794
3251
  /** Optional leading label, rendered before the segments. */
@@ -3160,69 +3617,6 @@ interface TextProps extends Omit<React.HTMLAttributes<HTMLElement>, "color"> {
3160
3617
  */
3161
3618
  declare const Text: React$1.ForwardRefExoticComponent<TextProps & React$1.RefAttributes<HTMLElement>>;
3162
3619
 
3163
- /**
3164
- * The document-outline level: which of `<h1>`…`<h6>` renders. Semantic only —
3165
- * it says where the heading sits in the outline, not how large it is.
3166
- *
3167
- * @experimental W2-13.
3168
- */
3169
- type HeadingLevel = 1 | 2 | 3 | 4 | 5 | 6;
3170
- /**
3171
- * The visual role of a heading: one of the four title roles of target
3172
- * architecture §15. Independent of `level`. Written out as a literal union so
3173
- * the public API report records the names.
3174
- *
3175
- * @experimental W2-13.
3176
- */
3177
- type HeadingSize = "display" | "title-page" | "title-section" | "title-sub";
3178
- /**
3179
- * Props of `Heading`. `level` is required on purpose: a heading without an
3180
- * outline level is the hard-coded `h3`/`h1`/`h4` this component exists to end
3181
- * (target architecture §15.2, current-state audit §14).
3182
- *
3183
- * @experimental W2-13.
3184
- */
3185
- interface HeadingProps extends React.HTMLAttributes<HTMLHeadingElement> {
3186
- /** The outline level: renders `<h{level}>`. Required. */
3187
- level: HeadingLevel;
3188
- /**
3189
- * The visual role, independent of `level`. Defaults from the level
3190
- * (`1` → `title-page`, `2` → `title-section`, `3`–`6` → `title-sub`), so an
3191
- * `<h3>` that must look like a section title says `size="title-section"`
3192
- * instead of becoming an `<h2>`.
3193
- */
3194
- size?: HeadingSize;
3195
- }
3196
- /**
3197
- * `Heading` — an `<h1>`…`<h6>` whose outline level and visual size are two
3198
- * separate props (W2-13, target architecture §15.2).
3199
- *
3200
- * `level` is required and picks the element; `size` picks the title role and
3201
- * defaults from the level. Because the two are independent, a card title can
3202
- * be the `<h3>` the document outline needs and still render at the section
3203
- * scale, and a page can keep exactly one `<h1>` without every other title
3204
- * shrinking. Every size is a role token; there is no pixel size.
3205
- *
3206
- * Renders in the display family (`font-display`) and the heading ink (`fg`),
3207
- * as the base `h1`–`h4` rules do today, so an `<h5>` at `title-sub` matches an
3208
- * `<h4>` at `title-sub`.
3209
- *
3210
- * Server-safe: no hooks, no client directive, no effects.
3211
- *
3212
- * Anatomy: one part, `data-slot="heading"`, which is also where `className`
3213
- * and `style` land.
3214
- *
3215
- * @example
3216
- * ```tsx
3217
- * <Heading level={1}>Engagements</Heading>
3218
- * <Heading level={3} size="title-section">Documents</Heading>
3219
- * ```
3220
- *
3221
- * @experimental New export (W2-13); its size vocabulary may change while
3222
- * decision D1 (visual source of truth) is open.
3223
- */
3224
- declare const Heading: React$1.ForwardRefExoticComponent<HeadingProps & React$1.RefAttributes<HTMLHeadingElement>>;
3225
-
3226
3620
  /**
3227
3621
  * The shared vocabulary of the layout primitives (W2-15, target architecture
3228
3622
  * §16, §22, §23): the gap scale, the alignment words, and the one responsive
@@ -3385,95 +3779,233 @@ interface InlineProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "color"
3385
3779
  declare const Inline: React$1.ForwardRefExoticComponent<InlineProps & React$1.RefAttributes<HTMLDivElement>>;
3386
3780
 
3387
3781
  /**
3388
- * Inner padding of a `Surface`, as a `surface.padding` role (W2-02): 16 / 20 /
3389
- * 24px the three card and panel paddings the library and its consumers
3390
- * already write — or `none` for a surface whose content pads itself (a table,
3391
- * an image, a list with its own row padding).
3782
+ * How one status looks, in the shared vocabulary (ADR-007). These are the
3783
+ * presentation props of `StatusBadge`; a map entry is spread straight onto it.
3392
3784
  *
3393
3785
  * @experimental
3394
3786
  */
3395
- type SurfacePadding = "none" | "sm" | "md" | "lg";
3787
+ interface StatusPresentation {
3788
+ /** Semantic meaning → colour family. Required: a status without a meaning is a `Badge`. */
3789
+ intent: Intent;
3790
+ /** Emphasis. `StatusBadge` defaults to `soft`, the status-chip look. */
3791
+ variant?: Extract<Variant, "solid" | "soft" | "outline">;
3792
+ /** Leading dot, for a state where work is in flight or attention is due. */
3793
+ dot?: boolean;
3794
+ /** Spinner in place of the dot or icon, for a state that is still moving. */
3795
+ loading?: boolean;
3796
+ }
3396
3797
  /**
3397
- * Corner radius of a `Surface`, as a radius role (W2-07, target architecture
3398
- * §18): `surface` for cards, dialogs and sheets, `surface-sm` for popovers,
3399
- * tooltips, toasts and small cards, or `none`. Control and badge radii are not
3400
- * offered: a surface is never a control.
3798
+ * A product's status map: one entry per member of its status union, nothing
3799
+ * missing, nothing extra.
3401
3800
  *
3402
3801
  * @experimental
3403
3802
  */
3404
- type SurfaceRadius = "none" | "surface-sm" | "surface";
3803
+ type StatusMap<TStatus extends string, TEntry extends StatusPresentation = StatusPresentation> = Readonly<Record<TStatus, TEntry>>;
3405
3804
  /**
3406
- * Elevation of a `Surface`, as an elevation role (W2-08, target architecture
3407
- * §19): `flat` (resting, border-led today's `Card`), `raised` (resting
3408
- * lift), `floating` (anchored transient surfaces), `overlay` (modal surfaces),
3409
- * or `none` for no shadow at all — which is what the hand-rolled card boxes in
3410
- * every product render, and the default. `flat` is kept distinct from `none`
3411
- * because today's `flat` role still aliases the hairline `shadow-quiet` (gated
3412
- * on D1); when D1 lands the two coincide and nothing here changes.
3805
+ * Rejects keys outside the status union: a plain generic constraint would let
3806
+ * an unknown status through. Part of `defineStatusMap`'s signature only.
3413
3807
  *
3414
3808
  * @experimental
3415
3809
  */
3416
- type SurfaceElevation = "none" | "flat" | "raised" | "floating" | "overlay";
3417
-
3810
+ type OnlyStatuses<TMap, TStatus extends string> = {
3811
+ readonly [K in Exclude<keyof TMap, TStatus>]: never;
3812
+ };
3418
3813
  /**
3419
- * Props of `Surface`.
3814
+ * Declares a status map that is checked for exhaustiveness against the
3815
+ * product's own status union and keeps the literal type of every entry, key
3816
+ * by key.
3420
3817
  *
3421
- * Tokenised props for exactly the three things a surface is (padding, radius,
3422
- * elevation) and nothing else: no `gap`/`align`/`direction` (that is a `Stack`
3423
- * inside it), no `bg`, `border`, `shadow`, `rounded`, `p`/`m`/`px`/`mt`,
3424
- * `color`, `width`, `height`, `sx` or `css`, and no numeric or length values.
3425
- * `className` and `style` land on the root element (§29.1).
3818
+ * Two call shapes:
3819
+ *
3820
+ * ```ts
3821
+ * // The status union is known, the entries are inferred (extra fields kept):
3822
+ * const MEETING = defineStatusMap<MeetingStatus>()({
3823
+ * pending: { intent: "neutral", loading: true, labelKey: "status.pending" },
3824
+ * notesReady: { intent: "success", labelKey: "status.notesReady" },
3825
+ * // ^ a missing or unknown status is a type error
3826
+ * });
3827
+ * MEETING.pending.loading; // true
3828
+ *
3829
+ * // Both are named, when the product already types its entries:
3830
+ * const IMPORTS = defineStatusMap<ImportStatus, ImportMeta>({ … });
3831
+ * ```
3832
+ *
3833
+ * Runtime: returns its argument. The value is the type check.
3426
3834
  *
3427
3835
  * @experimental
3428
3836
  */
3429
- interface SurfaceProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "color"> {
3837
+ declare function defineStatusMap<TStatus extends string>(): <TMap extends StatusMap<TStatus>>(map: TMap & OnlyStatuses<TMap, TStatus>) => Readonly<TMap>;
3838
+ declare function defineStatusMap<TStatus extends string, TEntry extends StatusPresentation>(map: StatusMap<TStatus, TEntry>): StatusMap<TStatus, TEntry>;
3839
+
3840
+ interface StatusBadgeProps extends Omit<React.HTMLAttributes<HTMLSpanElement>, "children">, StatusPresentation {
3841
+ /** The status name, as the product spells it. Always visible. */
3842
+ label: React.ReactNode;
3843
+ /** Leading 14px glyph; ignored while `loading`, replaced by `dot` when both are set. */
3844
+ icon?: React.ReactNode;
3845
+ /** What the status means for the work, shown on hover and focus. */
3846
+ description?: React.ReactNode;
3847
+ /** `xs`, `sm` (default) or `md` — the Badge scale. */
3848
+ size?: BadgeSize;
3849
+ /** Corner treatment, as on `Badge`; omitted keeps the Badge default (D1). */
3850
+ shape?: BadgeShape;
3851
+ }
3852
+ declare const StatusBadge: React$1.ForwardRefExoticComponent<StatusBadgeProps & React$1.RefAttributes<HTMLSpanElement>>;
3853
+
3854
+ /**
3855
+ * The IconButton sizes: the shared control scale, nothing else (A1).
3856
+ *
3857
+ * @experimental
3858
+ */
3859
+ type IconButtonSize = ControlSize;
3860
+ /** Where the default tooltip opens. @experimental */
3861
+ type IconButtonTooltipSide = "top" | "right" | "bottom" | "left";
3862
+ /** @experimental */
3863
+ interface IconButtonProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "aria-label" | "children"> {
3430
3864
  /**
3431
- * Inner padding, as a `surface.padding` role.
3432
- * @default "sm"
3865
+ * The accessible name — what a screen reader says and, by default, what the
3866
+ * tooltip shows. Required: an icon alone is not a name.
3433
3867
  */
3434
- padding?: SurfacePadding;
3868
+ label: string;
3869
+ /** The glyph. `children` is accepted as an alias for `<IconButton label="…"><Icon /></IconButton>`. */
3870
+ icon?: ReactNode;
3871
+ children?: ReactNode;
3435
3872
  /**
3436
- * Corner radius, as a radius role.
3437
- * @default "surface"
3873
+ * Visual emphasis, as on Button: `solid` (default) · `soft` · `outline` ·
3874
+ * `ghost` · `link`. The legacy Button words resolve through the same table.
3438
3875
  */
3439
- radius?: SurfaceRadius;
3876
+ variant?: ButtonVariant;
3440
3877
  /**
3441
- * Shadow, as an elevation role.
3442
- * @default "none"
3878
+ * Meaning colour family: `brand` · `neutral` · `success` · `danger`.
3879
+ * Defaults per variant, as on Button. `destructive` is a deprecated alias
3880
+ * of `danger` (decision D4).
3443
3881
  */
3444
- elevation?: SurfaceElevation;
3882
+ intent?: ButtonIntent | ButtonIntentAlias;
3883
+ /**
3884
+ * Outer size, square, from the shared control scale (A1): `xs` 28 · `sm` 32
3885
+ * · `md` 36 (default; D5-gated token) · `lg` 40 · `xl` 48.
3886
+ */
3887
+ size?: IconButtonSize;
3888
+ /**
3889
+ * `true` (default) shows `label` in a tooltip on hover and focus; `false`
3890
+ * renders no tooltip (the `aria-label` stays); a node replaces the text.
3891
+ * The tooltip is never the only source of the name.
3892
+ */
3893
+ tooltip?: boolean | ReactNode;
3894
+ /** Side the tooltip opens on. Default `top`. */
3895
+ tooltipSide?: IconButtonTooltipSide;
3896
+ /** Render the child element instead of a `<button>` (Radix `Slot`). */
3897
+ asChild?: boolean;
3898
+ /** Replaces the glyph with a spinner, sets `aria-busy` and disables the control. */
3899
+ loading?: boolean;
3900
+ /**
3901
+ * Toggle state (a boolean prop, never a variant — ADR-007 §2). Reflected as
3902
+ * `aria-pressed` and, when true, `data-pressed`.
3903
+ */
3904
+ pressed?: boolean;
3445
3905
  }
3446
3906
  /**
3447
- * Surface the bordered box content sits on (W2-16, target architecture §23).
3448
- * It is the primitive behind the 367 (Pro) / 119 (Portal) / 96 (Tax)
3449
- * hand-rolled card boxes of the consumer usage audit (the class string is
3450
- * `HAND_ROLLED_CARD` in the stories; it is not spelled here because Tailwind
3451
- * would compile it from this comment) and the `.surface` helper class: with no
3452
- * props it renders that box — surface background, 1px rule border,
3453
- * `radius.surface`, `surface.padding.sm`, no shadow — and every knob is a
3454
- * role, never a value. `Card` (W3-17) is built on it and adds anatomy.
3907
+ * The IconButton class recipe: `buttonBase` (look resolved from `variant` +
3908
+ * `intent`, no text-button size row) plus the square control-scale size, so
3909
+ * `IconButton size="sm"` and `Button size="sm"` are the same height by
3910
+ * construction. Server-safe.
3455
3911
  *
3456
- * Deferred, deliberately:
3457
- * - `interactive`: a clickable surface renders through `Pressable` (W3-03) so
3458
- * it gets keyboard activation, `data-pressed` and a focus ring for free; a
3459
- * `cursor-pointer` hover treatment here would be a click target with no
3460
- * keyboard semantics. Until then, put a `Button asChild` or a link inside
3461
- * the surface.
3462
- * - `asChild`: waits for the design system's own `Slot` (a11y primitives).
3912
+ * @experimental
3913
+ */
3914
+ declare function iconButtonVariants({ variant, intent, size, className, }?: {
3915
+ variant?: ButtonVariant | null;
3916
+ intent?: ButtonIntent | ButtonIntentAlias | null;
3917
+ size?: IconButtonSize | null;
3918
+ className?: string | null;
3919
+ }): string;
3920
+ /**
3921
+ * An icon-only action with a required accessible name, a tooltip by default
3922
+ * and the Button family's look on a square control-scale geometry. See the
3923
+ * module comment.
3463
3924
  *
3464
- * Server-safe: no hooks, no client directive, renders a plain `div` and stamps
3465
- * `data-slot="surface"`.
3925
+ * @experimental
3926
+ */
3927
+ declare const IconButton: React$1.ForwardRefExoticComponent<IconButtonProps & React$1.RefAttributes<HTMLButtonElement>>;
3928
+
3929
+ /** The emphasis subset a chip offers. @experimental */
3930
+ type ChipVariant = Extract<Variant, "solid" | "soft" | "outline">;
3931
+ /** The intents a chip offers (the Button family's). @experimental */
3932
+ type ChipIntent = ButtonIntent;
3933
+ /** The chip sizes: the shared control scale (A1). @experimental */
3934
+ type ChipSize = ControlSize;
3935
+ /** @experimental */
3936
+ interface ChipProps extends Omit<React.HTMLAttributes<HTMLElement>, "children" | "onClick"> {
3937
+ /** The label. A string also names the remove button ("Remove {label}"). */
3938
+ children: ReactNode;
3939
+ /** Leading glyph, decorative. */
3940
+ icon?: ReactNode;
3941
+ /** Trailing number. */
3942
+ count?: number;
3943
+ /** Visual emphasis: `soft` (default) · `solid` · `outline`. */
3944
+ variant?: ChipVariant;
3945
+ /**
3946
+ * Meaning → colour family. Default `neutral`, or `brand` while `pressed`.
3947
+ * `destructive` is a deprecated alias of `danger` (decision D4).
3948
+ */
3949
+ intent?: ChipIntent | ButtonIntentAlias;
3950
+ /** Outer height from the shared control scale (A1). Default `sm` (32px). */
3951
+ size?: ChipSize;
3952
+ /**
3953
+ * Toggle state (a boolean prop, never a variant — ADR-007 §2). Controlled:
3954
+ * pair with `onPressedChange`. Reflected as `aria-pressed` / `data-pressed`.
3955
+ */
3956
+ pressed?: boolean;
3957
+ /** Called with the next state when a toggle chip is activated. */
3958
+ onPressedChange?: (pressed: boolean) => void;
3959
+ /** Activation of the chip itself (not of the remove button). */
3960
+ onClick?: React.MouseEventHandler<HTMLButtonElement>;
3961
+ /** Renders a remove button after the label and is called when it is activated. */
3962
+ onRemove?: () => void;
3963
+ /**
3964
+ * The remove button's accessible name. Defaults to "Remove {label}" when
3965
+ * `children` is a string; required otherwise (a development error).
3966
+ */
3967
+ removeLabel?: string;
3968
+ /** Disables the chip and its remove button. */
3969
+ disabled?: boolean;
3970
+ }
3971
+ /**
3972
+ * The chip class recipe: `buttonBase` for the resolved look (no text-button
3973
+ * size row), a pill corner, and the control-scale size. Server-safe.
3466
3974
  *
3467
- * Under a consumer's shadcn theme the hand-rolled box and this primitive differ
3468
- * on purpose in two places the parity story makes visible: the products'
3469
- * `rounded-xl` is `--radius` + 4px (16px) where `radius.surface` is 12px, and
3470
- * their `--border` is not the design system's rule colour. Both are decision
3471
- * D1 (target architecture §18); `Surface` follows the roles.
3975
+ * @experimental
3976
+ */
3977
+ declare function chipVariants({ variant, intent, size, pressed, className, }?: {
3978
+ variant?: ChipVariant | null;
3979
+ intent?: ChipIntent | ButtonIntentAlias | null;
3980
+ size?: ChipSize | null;
3981
+ pressed?: boolean | null;
3982
+ className?: string | null;
3983
+ }): string;
3984
+ /**
3985
+ * The resolved appearance of a chip: the emphasis, the colour family and the
3986
+ * row of the Button colour table they render (see the module comment on the
3987
+ * `intent` default).
3472
3988
  *
3473
- * @experimental Shipped in Wave 2 as a new export nobody is forced to use; the
3474
- * prop shapes may still change before the wave's exit review.
3989
+ * @experimental
3475
3990
  */
3476
- declare const Surface: React$1.ForwardRefExoticComponent<SurfaceProps & React$1.RefAttributes<HTMLDivElement>>;
3991
+ interface ChipStyle {
3992
+ variant: ChipVariant;
3993
+ intent: ChipIntent;
3994
+ look: ButtonLook;
3995
+ }
3996
+ /** Resolves `variant` + `intent` (+ `pressed`) to the row a chip renders. */
3997
+ declare function resolveChipStyle({ variant, intent, pressed, }: {
3998
+ variant?: ChipVariant | null;
3999
+ intent?: ChipIntent | ButtonIntentAlias | null;
4000
+ pressed?: boolean | null;
4001
+ }): ChipStyle;
4002
+ /**
4003
+ * The removable, toggleable or clickable token, on `buttonBase` through
4004
+ * `Pressable`. See the module comment.
4005
+ *
4006
+ * @experimental
4007
+ */
4008
+ declare const Chip: React$1.ForwardRefExoticComponent<ChipProps & React$1.RefAttributes<HTMLElement>>;
3477
4009
 
3478
4010
  /**
3479
4011
  * AgreementViewer — the chrome + navigation shell for a multi-step, branded
@@ -6756,4 +7288,4 @@ interface BrandScopeProps extends React.HTMLAttributes<HTMLDivElement> {
6756
7288
  */
6757
7289
  declare const BrandScope: React$1.ForwardRefExoticComponent<BrandScopeProps & React$1.RefAttributes<HTMLDivElement>>;
6758
7290
 
6759
- export { AIReceiptPanel, type AIReceiptPanelProps, type AIReceiptResult, Accordion, AccordionContent, AccordionItem, AccordionTrigger, type ActivityDotVariant, ActivityEventItem, type ActivityEventItemProps, ActivityItem, type ActivityItemProps, ActivityList, type ActivityListProps, type AgreementFirm, AgreementPaneHeading, type AgreementPaneHeadingProps, type AgreementStatus, type AgreementStep, AgreementViewer, type AgreementViewerProps, AiDraftCard, type AiDraftCardProps, type AiDraftState, Alert, AlertCircleIcon, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, type AlertDialogSlot, AlertDialogTitle, AlertDialogTrigger, type AlertProps, AlertTitle, AlertTriangleIcon, AlertTriangleSolidIcon, AppHeader, AppHeaderActions, type AppHeaderActionsProps, AppHeaderBreadcrumb, type AppHeaderBreadcrumbProps, type AppHeaderProps, AppHeaderSearch, type AppHeaderSearchProps, AppHeaderTitle, type AppHeaderTitleProps, ArchiveIcon, AreaChart, type AreaChartProps, type AreaPoint, ArrowDownIcon, ArrowLeftIcon, ArrowRightIcon, ArrowRightSmallIcon, ArrowUpIcon, AspectRatio, Assignee, AssureAuditBrandIcon, AssureBooksBrandIcon, AssureProBrandIcon, AssureTaxBrandIcon, AtSignIcon, AttachmentChip, type AttachmentChipProps, AttentionItem, type AttentionItemProps, type AttentionUrgency, Avatar, BRAND_PRODUCTS, Badge, type BadgeProps, type BadgeSlot, BarChartIcon, BellIcon, Blockquote, BoldIcon, BottomNav, type BottomNavProps, type BottomNavTab, BrainIcon, type BrandIconProps, type BrandProduct, BrandScope, type BrandScopeProps, BrandScopeProvider, Breadcrumb, BreadcrumbItem, type BreadcrumbItemProps, BreadcrumbLink, type BreadcrumbLinkProps, BreadcrumbList, type BreadcrumbListProps, BreadcrumbPage, type BreadcrumbPageProps, type BreadcrumbProps, BreadcrumbSeparator, type BreadcrumbSeparatorProps, BriefcaseIcon, Building2Icon, BuildingIcon, BulkActionBar, BulkActionBarAction, type BulkActionBarActionProps, type BulkActionBarProps, BulkActionBarSeparator, type BulkActionBarVariant, Button, type ButtonProps, type ButtonSize, type ButtonSlot, type ButtonVariant, COUNTRY_CODES, Calendar, type CalendarCaptionLayout, type CalendarHighlight, type CalendarHighlightColor, CalendarIcon, type CalendarProps, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, type CardVariants, CategoryDivider, type CategoryDividerProps, CategoryTag, type CategoryTagProps, type CategoryTone, type CellValue, type ChannelTabItem, ChannelTabs, type ChannelTabsProps, type ChannelTone, ChatBubbleIcon, CheckCircle2Icon, CheckCircleSolidIcon, CheckIcon, Checkbox, type CheckboxSlot, ChevronDownIcon, ChevronLeftIcon, ChevronRightIcon, ChevronUpIcon, ChevronsDownUpIcon, ChevronsUpDownIcon, CircleDotIcon, CircleIcon, ClientRailGroupHeader, type ClientRailGroupHeaderProps, ClientRailItem, type ClientRailItemProps, ClientSelect, type ClientSelectOption, ClipboardCheckIcon, ClockIcon, CloseIcon, Code, type CodeProps, type CodeSlot, type CodeVariant, Collapsible, CollapsibleContent, CollapsibleTrigger, ComingSoon, type ComingSoonProps, CommandIcon, type CommandItem, CommandPalette, ConfirmActionButton, type ConfirmActionButtonProps, Content, type ContentProps, ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuGroup, ContextMenuItem, ContextMenuLabel, ContextMenuPortal, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuShortcut, type ContextMenuSlot, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, type ControlSize, CopyButton, CopyIcon, CornerDownLeftIcon, type CountryCode, CountryFlag, CountrySelect, CreditCardIcon, DATE_DISPLAY_PLACEHOLDER, DangerAction, type DangerActionProps, Dash, DashGrid, type DashGridProps, type DashWidget, DataItem, DataTable, DataTableBody, type DataTableBodyProps, DataTableCell, DataTableCellDue, type DataTableCellDueProps, DataTableCellId, DataTableCellMono, DataTableCellName, type DataTableCellProps, DataTableCheckbox, type DataTableCheckboxProps, DataTableHead, type DataTableHeadProps, DataTableHeader, type DataTableHeaderProps, DataTablePagination, type DataTablePaginationProps, type DataTableProps, DataTableResultsCount, type DataTableResultsCountProps, DataTableRow, type DataTableRowProps, DataTableSearch, type DataTableSearchProps, type DataTableSlot, DataTableSpacer, type DataTableSpacerProps, DataTableToolbar, type DataTableToolbarProps, DataTableView, type DataTableViewColumn, type DataTableViewFilter, type DataTableViewProps, type DataTableViewSelection, DatePicker, DateRangePicker, type DateRangeValue, DetailGrid, type DetailGridProps, DetailMain, type DetailMainProps, DetailSpine, DetailSpineHeader, type DetailSpineHeaderProps, type DetailSpineProps, DetailSpineSection, type DetailSpineSectionProps, DetailSpineStats, type DetailSpineStatsProps, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, type DialogSlot, DialogTitle, DialogTrigger, DismissibleChip, DisplayMenu, type DisplayMenuOption, type DisplayMenuProps, type DisplayMenuSection, DocumentChecklist, type DocumentChecklistFile, type DocumentChecklistItem, type DocumentChecklistProps, type DocumentChecklistStatus, DocumentDetailActions, type DocumentDetailActionsProps, DocumentDetailBody, type DocumentDetailBodyProps, DocumentDetailHeader, type DocumentDetailHeaderProps, DocumentDetailMetaRow, type DocumentDetailMetaRowProps, DocumentDetailPanel, type DocumentDetailPanelProps, DocumentDetailRequester, type DocumentDetailRequesterProps, DocumentDetailTitle, type DocumentDetailTitleProps, DocumentFileCard, type DocumentFileCardProps, DocumentFileLine, type DocumentFileLineProps, DocumentFileRow, type DocumentFileRowProps, DocumentIcon, type DocumentItemState, DocumentList, type DocumentListProps, DocumentListSection, type DocumentListSectionProps, type DocumentRequestActivityKind, type DocumentRequestAssigneeOption, DocumentRequestCard, type DocumentRequestCardProps, DocumentRequestDetail, type DocumentRequestDetailActivityEvent, type DocumentRequestDetailComment, type DocumentRequestDetailDoc, type DocumentRequestDetailProps, type DocumentRequestDetailTab, DocumentRequestField, type DocumentRequestFieldProps, type DocumentRequestItemSummary, type DocumentRequestRequestedItem, type DocumentRequestReviewStatusOption, type DocumentRequestTone, DocumentRequestUpload, type DocumentRequestUploadFile, type DocumentRequestUploadProps, DocumentRow, type DocumentRowProps, type DocumentSource, DocumentSourceFilter, type DocumentSourceFilterProps, type DocumentSourceFilterValue, DocumentSourceTag, type DocumentSourceTagProps, DocumentsWorkspaceLayout, type DocumentsWorkspaceLayoutProps, DollarSignIcon, DonutChart, type DonutChartProps, type DonutSegment, DownloadIcon, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, type DropdownMenuSlot, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EmailMessageCard, type EmailMessageCardProps, EmptyState, type EmptyStateProps, EngagementCard, type EngagementCardProps, EngagementTimeline, type EngagementTimelineProps, EngagementTimelineStep, type EngagementTimelineStepProps, ExternalLinkIcon, ExtractIcon, EyeIcon, EyeOffIcon, Eyebrow, type EyebrowProps, FileChip, type FileChipProps, FileIcon, type FileKind, FileReturnIcon, FileTextIcon, FileTypeBadge, type FileTypeBadgeProps, type FileTypeTone, FileUpload, type FileUploadSlot, FilterChip, type FilterChipProps, FilterIcon, FlagIcon, FolderClosedIcon, type FolderNode, FolderOpenIcon, FolderPlusIcon, FolderTree, type FolderTreeProps, FolderUpIcon, FormError, FormSection, FormSuccess, GlobeIcon, GoogleBrandIcon, Grid, type GridColumn, type GridInputType, type GridProps, type GridRow, type GridValue, GripVerticalIcon, Heading, type HeadingLevel, type HeadingProps, type HeadingSize, type HeadingSlot, HelpCircleIcon, HistoryIcon, HomeIcon, HoverCard, HoverCardContent, HoverCardPortal, HoverCardTrigger, IconAction, type IconActionProps, type IconComponent, type IconDefinition, type IconProps, type IconSize, IconTile, type IconTileProps, InboxIcon, InfoCircleSolidIcon, InfoIcon, Inline, type InlineProps, type InlineSlot, Input, type InputSlot, type InputVariants, type Intent, IntentBadge, type IntentBadgeProps, type IntentTone, ItalicIcon, Kanban, KanbanCard, type KanbanCardProps, KanbanColumn, type KanbanColumnProps, KanbanIcon, type KanbanProps, Kbd, type KbdGlyph, KbdHint, type KbdHintProps, type KbdProps, type KbdSlot, type KbdVariant, KeyIcon, type KeyboardShortcut, type KeyboardShortcutSection, KeyboardShortcutsDialog, type KeyboardShortcutsDialogProps, KpiCard, type KpiCardProps, type KpiDelta, Label, type LabelSlot, LandmarkIcon, LayersIcon, type LayoutAlign, type LayoutBreakpoint, LayoutDashboardIcon, type LayoutGap, LayoutGridIcon, type LayoutJustify, LayoutListIcon, LightningIcon, Link2Icon, LinkAction, type LinkActionProps, LinkButton, type LinkButtonProps$1 as LinkButtonProps, type LinkButtonSlot, LinkIcon, ListChecksIcon, ListIcon, ListOrderedIcon, LoaderIcon, LoadingRows, LockIcon, LockKeyholeIcon, LockOpenIcon, LogOutIcon, Logo, MailIcon, Main, type MainProps, MapPinIcon, MasterDetailLayout, type MasterDetailLayoutProps, MaximizeIcon, MenuIcon, MessageBubble, MessageBubbleAction, type MessageBubbleActionProps, type MessageBubbleProps, MessageBubbleTombstone, type MessageBubbleTombstoneProps, MessageCircleIcon, MessageCircleWarningIcon, MessageComposer, type MessageComposerProps, MetadataGrid, MicIcon, MicrosoftBrandIcon, MinimizeIcon, MinusIcon, type MissingDocumentItem, MissingDocumentsPanel, type MissingDocumentsPanelProps, MoneyCell, MonitorIcon, MoonIcon, MoreHorizontalIcon, MoveIcon, MultiFilterPill, MultiSelectField, MutedSpec, type MutedSpecProps, NewMenu, type NewMenuAction, type NewMenuGroup, type NewMenuProps, NotificationFilter, type NotificationFilterProps, type NotificationFilterValue, NotificationItem, type NotificationItemProps, NotificationList, type NotificationListProps, NotificationPanel, NotificationPanelFooter, type NotificationPanelFooterProps, NotificationPanelHeader, type NotificationPanelHeaderProps, type NotificationPanelProps, Numeric, type NumericProps, OTPInput, PageHeader, type PageHeaderProps, PageHeaderSep, type PageHeaderSepProps, PageHeaderSpec, type PageHeaderSpecProps, Pagination, type PaginationProps, type PaginationSlot, PaletteIcon, PanelLeftCloseIcon, PanelLeftIcon, PanelRightIcon, PaperclipIcon, PauseIcon, PdfPreview, type PdfPreviewProps, PenSignIcon, PenToolIcon, PencilIcon, PhoneCountryInput, PhoneIcon, PhoneInput, type PillStatus, PlayIcon, PlusIcon, Popover, PopoverAnchor, PopoverClose, PopoverContent, PopoverPortal, type PopoverSlot, PopoverTrigger, PrimaryAction, type PrimaryActionProps, type Priority, PriorityIcon, type PriorityIconProps, ProgressBar, type ProgressBarProps, ProgressRing, type ProgressRingProps, ProposalAddOn, type ProposalAddOnProps, type ProposalBillingMode, type ProposalBillingRow, ProposalBillingTerms, type ProposalBillingTermsProps, ProposalConsentGate, type ProposalConsentGateProps, ProposalCustomPage, type ProposalCustomPageKind, type ProposalCustomPageProps, ProposalNote, type ProposalNoteProps, ProposalPackageCard, type ProposalPackageCardProps, type ProposalPackageMode, ProposalPaymentCapture, type ProposalPaymentCaptureProps, ProposalPricingSummary, type ProposalPricingSummaryProps, ProposalServiceRow, type ProposalServiceRowProps, ProposalSignatureBlock, type ProposalSignatureBlockProps, type ProposalSigner, ProposalSignerList, type ProposalSignerListProps, type ProposalSignerStatus, type QuestionAddressValue, type QuestionFileValue, type QuestionHelp, type QuestionLabeledColumn, type QuestionLabeledRow, type QuestionLabeledValue, type QuestionNameValue, type QuestionOption, type QuestionTableColumn, type QuestionTableRow, type QuestionType, QuestionnairePanel, type QuestionnairePanelGroup, type QuestionnairePanelProps, type QuestionnairePanelSection, type QuestionnairePanelStatus, Questions, type QuestionsProps, type QuickReplyChip, RadioGroup, RadioGroupItem, type RadioGroupSlot, type RankedBar, RankedBars, type RankedBarsProps, ReceiptIcon, RefreshCwIcon, ReplyIcon, type Responsive, ResponsiveDialog, type ResponsiveDialogProps, RotateCcwIcon, RouteTransition, type RouteTransitionProps, SERVICE_TONES, SaveIcon, ScrollArea, ScrollBar, SearchIcon, SearchInput, type SearchInputSlot, type SearchInputVariants, SearchSelect, type SearchSelectOption, SecondaryAction, type SecondaryActionProps, Section, SectionHead, SectionHeader, SegmentedProgress, type SegmentedProgressProps, type SegmentedTone, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, type SelectOption, type SelectProps, SelectRoot, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, type SelectSlot, SelectTrigger, SelectValue, SelectableKpiCard, type SelectableKpiCardProps, SendIcon, Separator, type ServiceTone, SettingsIcon, type Shape, Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetOverlay, SheetPortal, type SheetSlot, SheetTitle, SheetTrigger, Shell, type ShellProps, type ShellSlot, ShieldIcon, SideDrawer, type SideDrawerSlot, Sidebar, SidebarBrand, type SidebarBrandProps, SidebarBrandSwitcher, type SidebarBrandSwitcherExtra, type SidebarBrandSwitcherItem, type SidebarBrandSwitcherProps, type SidebarBrandSwitcherSlot, SidebarBrandSwitcherTile, SidebarBrandText, type SidebarBrandTextProps, SidebarFooter, type SidebarFooterProps, SidebarLink, SidebarLinkAction, type SidebarLinkActionProps, SidebarLinkBadge, type SidebarLinkBadgeProps, type SidebarLinkBadgeVariants, SidebarLinkGroup, type SidebarLinkGroupProps, SidebarLinkLabel, type SidebarLinkLabelProps, type SidebarLinkProps, SidebarPinButton, type SidebarPinButtonProps, type SidebarProps, SidebarProvider, type SidebarProviderProps, SidebarSection, type SidebarSectionProps, type SidebarSlot, type SidebarState, SidebarTrigger, type SidebarTriggerProps, SidebarUser, type SidebarUserProps, SigmaIcon, SignatureEditor, type SignatureEditorProps, Skeleton, SkeletonCircle, SkeletonText, SlashIcon, Slider, SmartphoneIcon, type SortDirection, SparkleIcon, SparklesIcon, Spinner, type SpinnerProps, SpreadsheetPreview, type SpreadsheetPreviewProps, Stack, type StackDirection, type StackProps, type StackSlot, StackedBarChart, type StackedBarChartProps, type StackedBarDatum, type StackedBarSeries, StagePill, StarIcon, StarRating, type StarRatingProps, Stat, StatusDot, type StatusDotProps, StatusIcon, type StatusIconProps, StatusPill, type StatusPillProps, type StatusState, type Step, Stepper, type StepperProps, StickyActionBar, type StickyActionBarProps, StickyStack, StickyStackLayer, type StickyStackLayerProps, type StickyStackProps, StickyStackSectionHeader, type StickyStackSectionHeaderProps, StickyStackSticky, type StickyStackStickyProps, StopIcon, StrikethroughIcon, SubmitButton, SuggestionPills, type SuggestionPillsProps, SuiteProgress, type SuiteProgressProps, type SuiteProgressSize, type SuiteProgressTone, SunIcon, Surface, type SurfaceElevation, type SurfacePadding, type SurfaceProps, type SurfaceRadius, type SurfaceSlot, Switch, type SwitchSlot, SystemTokens, Table, TableBody, type TableBodyProps, TableCaption, type TableCaptionProps, TableCell, type TableCellProps, TableFooter, type TableFooterProps, TableHead, type TableHeadProps, TableHeader, type TableHeaderProps, TableIcon, type TableProps, TableRow, type TableRowData, type TableRowProps, type TableSlot, type TableTone, Tabs, TabsContent, TabsList, TabsTrigger, TagIcon, TagsCell, TeamIcon, TeamMemberSelect, Text, type TextColor, type TextProps, type TextSize, type TextSlot, type TextWeight, Textarea, type TextareaSlot, type TextareaVariants, ThumbsDownIcon, ThumbsUpIcon, TimeLogger, TimeLoggerActions, type TimeLoggerActionsProps, TimeLoggerBillable, type TimeLoggerBillableProps, TimeLoggerContextRow, type TimeLoggerContextRowProps, TimeLoggerEntry, TimeLoggerEntryList, type TimeLoggerEntryListProps, type TimeLoggerEntryProps, TimeLoggerField, type TimeLoggerFieldProps, TimeLoggerFooter, type TimeLoggerFooterProps, TimeLoggerHeader, type TimeLoggerHeaderProps, TimeLoggerNotes, type TimeLoggerNotesProps, type TimeLoggerPhase, type TimeLoggerProps, type TimeLoggerTier, TimeLoggerTimer, type TimeLoggerTimerProps, type TimelineState, TimerIcon, type ToastAction, type ToastContextValue, type ToastOptions, ToastProvider, type ToastSlot, type ToastVariant, ToggleGroup, ToggleGroupItem, Toolbar, type ToolbarProps, Tooltip, TooltipContent, TooltipPortal, TooltipProvider, type TooltipSlot, TooltipTrigger, Trash2Icon, TrashIcon, TrashSolidIcon, TrendingDownIcon, TrendingUpIcon, UnderlineIcon, UploadIcon, type UseStopwatchReturn, UserCircleIcon, UserIcon, UsersIcon, type Variant, VideoIcon, VisuallyHidden, Volume2Icon, VolumeXIcon, WorkflowIcon, XCircleSolidIcon, XIcon, YEAR_DISPLAY_PLACEHOLDER, ZoomInIcon, ZoomOutIcon, alertVariants, applyMask, applyYearMask, assetPath, attachmentChipVariants, badgeVariants, brandLabel, brandScope, buttonVariants, cardVariants, cn, createIcon, dateToIso, displayToIso, fileTypeBadgeVariants, fileTypeFromName, filterChipVariants, formatClock, formatCurrency, formatDuration, getAssetBasePath, getFlagEmoji, iconTileVariants, inputVariants, isoToDate, isoToDisplay, isoToYear, labelVariants, parseDuration, parsePhoneForEditing, progressBarVariants, progressRingVariants, searchInputVariants, serviceToneLabel, serviceToneStyle, setAssetBasePath, sidebarLinkBadgeVariants, spinnerVariants, starRatingVariants, statusDotVariants, suiteProgressFillVariants, textareaVariants, useBrandScope, useSidebarPeekLock, useSidebarState, useStopwatch, useToast, yearToIso };
7291
+ export { AIReceiptPanel, type AIReceiptPanelProps, type AIReceiptResult, Accordion, AccordionContent, AccordionItem, AccordionTrigger, type ActivityDotVariant, ActivityEventItem, type ActivityEventItemProps, ActivityItem, type ActivityItemProps, ActivityList, type ActivityListProps, type AgreementFirm, AgreementPaneHeading, type AgreementPaneHeadingProps, type AgreementStatus, type AgreementStep, AgreementViewer, type AgreementViewerProps, AiDraftCard, type AiDraftCardProps, type AiDraftState, Alert, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, type AlertDialogSlot, AlertDialogTitle, AlertDialogTrigger, type AlertProps, AlertTitle, AppHeader, AppHeaderActions, type AppHeaderActionsProps, AppHeaderBreadcrumb, type AppHeaderBreadcrumbProps, type AppHeaderProps, AppHeaderSearch, type AppHeaderSearchProps, AppHeaderTitle, type AppHeaderTitleProps, AreaChart, type AreaChartProps, type AreaPoint, AspectRatio, Assignee, AssureAuditBrandIcon, AssureBooksBrandIcon, AssureProBrandIcon, AssureTaxBrandIcon, AttachmentChip, type AttachmentChipProps, AttentionItem, type AttentionItemProps, type AttentionUrgency, Avatar, type AvatarProps, type AvatarSlot, BRAND_PRODUCTS, Badge, type BadgeAppearance, type BadgeAppearanceInput, type BadgeLegacyVariant, type BadgeProps, type BadgeShape, type BadgeSize, type BadgeSlot, type BadgeVariant, type BadgeVariantsProps, Blockquote, BottomNav, type BottomNavProps, type BottomNavTab, type BrandIconProps, type BrandProduct, BrandScope, type BrandScopeProps, BrandScopeProvider, Breadcrumb, BreadcrumbItem, type BreadcrumbItemProps, BreadcrumbLink, type BreadcrumbLinkProps, BreadcrumbList, type BreadcrumbListProps, BreadcrumbPage, type BreadcrumbPageProps, type BreadcrumbProps, BreadcrumbSeparator, type BreadcrumbSeparatorProps, BulkActionBar, BulkActionBarAction, type BulkActionBarActionProps, type BulkActionBarProps, BulkActionBarSeparator, type BulkActionBarVariant, Button, type ButtonEmphasis, type ButtonIconProps, type ButtonIconSize, type ButtonIntent, type ButtonIntentAlias, type ButtonLegacyVariant, type ButtonLook, type ButtonProps, type ButtonSize, type ButtonSizeAlias, type ButtonSlot, type ButtonStyle, type ButtonVariant, type ButtonVariantsProps, COUNTRY_CODES, Calendar, type CalendarCaptionLayout, type CalendarHighlight, type CalendarHighlightColor, type CalendarProps, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, type CardProps, type CardSlot, CardTitle, type CardTitleProps, type CardVariants, CategoryDivider, type CategoryDividerProps, CategoryTag, type CategoryTagProps, type CategoryTone, type CellValue, type ChannelTabItem, ChannelTabs, type ChannelTabsProps, type ChannelTone, Checkbox, type CheckboxSlot, Chip, type ChipIntent, type ChipProps, type ChipSize, type ChipSlot, type ChipStyle, type ChipVariant, ClientRailGroupHeader, type ClientRailGroupHeaderProps, ClientRailItem, type ClientRailItemProps, ClientSelect, type ClientSelectOption, Code, type CodeProps, type CodeSlot, type CodeVariant, Collapsible, CollapsibleContent, CollapsibleTrigger, ComingSoon, type ComingSoonProps, type CommandItem, CommandPalette, ConfirmActionButton, type ConfirmActionButtonProps, Content, type ContentProps, ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuGroup, ContextMenuItem, ContextMenuLabel, ContextMenuPortal, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuShortcut, type ContextMenuSlot, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, ControlSize, CopyButton, type CountryCode, CountryFlag, CountrySelect, DATE_DISPLAY_PLACEHOLDER, DangerAction, type DangerActionProps, Dash, DashGrid, type DashGridProps, type DashWidget, DataItem, DataTable, DataTableBody, type DataTableBodyProps, DataTableCell, DataTableCellDue, type DataTableCellDueProps, DataTableCellId, DataTableCellMono, DataTableCellName, type DataTableCellProps, DataTableCheckbox, type DataTableCheckboxProps, DataTableHead, type DataTableHeadProps, DataTableHeader, type DataTableHeaderProps, DataTablePagination, type DataTablePaginationProps, type DataTableProps, DataTableResultsCount, type DataTableResultsCountProps, DataTableRow, type DataTableRowProps, DataTableSearch, type DataTableSearchProps, type DataTableSlot, DataTableSpacer, type DataTableSpacerProps, DataTableToolbar, type DataTableToolbarProps, DataTableView, type DataTableViewColumn, type DataTableViewFilter, type DataTableViewProps, type DataTableViewSelection, DatePicker, DateRangePicker, type DateRangeValue, DetailGrid, type DetailGridProps, DetailMain, type DetailMainProps, DetailSpine, DetailSpineHeader, type DetailSpineHeaderProps, type DetailSpineProps, DetailSpineSection, type DetailSpineSectionProps, DetailSpineStats, type DetailSpineStatsProps, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, type DialogSlot, DialogTitle, DialogTrigger, DismissibleChip, DisplayMenu, type DisplayMenuOption, type DisplayMenuProps, type DisplayMenuSection, DocumentChecklist, type DocumentChecklistFile, type DocumentChecklistItem, type DocumentChecklistProps, type DocumentChecklistStatus, DocumentDetailActions, type DocumentDetailActionsProps, DocumentDetailBody, type DocumentDetailBodyProps, DocumentDetailHeader, type DocumentDetailHeaderProps, DocumentDetailMetaRow, type DocumentDetailMetaRowProps, DocumentDetailPanel, type DocumentDetailPanelProps, DocumentDetailRequester, type DocumentDetailRequesterProps, DocumentDetailTitle, type DocumentDetailTitleProps, DocumentFileCard, type DocumentFileCardProps, DocumentFileLine, type DocumentFileLineProps, DocumentFileRow, type DocumentFileRowProps, type DocumentItemState, DocumentList, type DocumentListProps, DocumentListSection, type DocumentListSectionProps, type DocumentRequestActivityKind, type DocumentRequestAssigneeOption, DocumentRequestCard, type DocumentRequestCardProps, DocumentRequestDetail, type DocumentRequestDetailActivityEvent, type DocumentRequestDetailComment, type DocumentRequestDetailDoc, type DocumentRequestDetailProps, type DocumentRequestDetailTab, DocumentRequestField, type DocumentRequestFieldProps, type DocumentRequestItemSummary, type DocumentRequestRequestedItem, type DocumentRequestReviewStatusOption, type DocumentRequestTone, DocumentRequestUpload, type DocumentRequestUploadFile, type DocumentRequestUploadProps, DocumentRow, type DocumentRowProps, type DocumentSource, DocumentSourceFilter, type DocumentSourceFilterProps, type DocumentSourceFilterValue, DocumentSourceTag, type DocumentSourceTagProps, DocumentsWorkspaceLayout, type DocumentsWorkspaceLayoutProps, DonutChart, type DonutChartProps, type DonutSegment, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, type DropdownMenuSlot, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EmailMessageCard, type EmailMessageCardProps, EmptyState, type EmptyStateProps, EngagementCard, type EngagementCardProps, EngagementTimeline, type EngagementTimelineProps, EngagementTimelineStep, type EngagementTimelineStepProps, Eyebrow, type EyebrowProps, FileChip, type FileChipProps, type FileKind, FileTypeBadge, type FileTypeBadgeProps, type FileTypeTone, FileUpload, type FileUploadSlot, FilterChip, type FilterChipProps, type FolderNode, FolderTree, type FolderTreeProps, FormError, FormSection, FormSuccess, Grid, type GridColumn, type GridInputType, type GridProps, type GridRow, type GridValue, Heading, type HeadingLevel, type HeadingProps, type HeadingSize, type HeadingSlot, HoverCard, HoverCardContent, HoverCardPortal, HoverCardTrigger, ICON_TILE_TONE_TO_INTENT, IconAction, type IconActionProps, IconButton, type IconButtonProps, type IconButtonSize, type IconButtonSlot, type IconButtonTooltipSide, IconTile, type IconTileIntent, type IconTileProps, type IconTileSize, type IconTileSuiteTone, type IconTileTone, type IconTileVariantProps, Inline, type InlineProps, type InlineSlot, Input, type InputSlot, type InputVariants, Intent, IntentBadge, type IntentBadgeProps, type IntentTone, Kanban, KanbanCard, type KanbanCardProps, KanbanColumn, type KanbanColumnProps, type KanbanProps, Kbd, type KbdGlyph, KbdHint, type KbdHintProps, type KbdProps, type KbdSlot, type KbdVariant, type KeyboardShortcut, type KeyboardShortcutSection, KeyboardShortcutsDialog, type KeyboardShortcutsDialogProps, KpiCard, type KpiCardProps, type KpiDelta, Label, type LabelSlot, type LayoutAlign, type LayoutBreakpoint, type LayoutGap, type LayoutJustify, LinkAction, type LinkActionProps, LinkButton, type LinkButtonProps$1 as LinkButtonProps, type LinkButtonSlot, LoadingRows, Logo, Main, type MainProps, MasterDetailLayout, type MasterDetailLayoutProps, MessageBubble, MessageBubbleAction, type MessageBubbleActionProps, type MessageBubbleProps, MessageBubbleTombstone, type MessageBubbleTombstoneProps, MessageComposer, type MessageComposerProps, MetadataGrid, type MissingDocumentItem, MissingDocumentsPanel, type MissingDocumentsPanelProps, MoneyCell, MultiFilterPill, MultiSelectField, MutedSpec, type MutedSpecProps, NewMenu, type NewMenuAction, type NewMenuGroup, type NewMenuProps, NotificationFilter, type NotificationFilterProps, type NotificationFilterValue, NotificationItem, type NotificationItemProps, NotificationList, type NotificationListProps, NotificationPanel, NotificationPanelFooter, type NotificationPanelFooterProps, NotificationPanelHeader, type NotificationPanelHeaderProps, type NotificationPanelProps, Numeric, type NumericProps, OTPInput, type OnlyStatuses, PROGRESS_LEGACY_TO_INTENT, PageHeader, type PageHeaderProps, PageHeaderSep, type PageHeaderSepProps, PageHeaderSpec, type PageHeaderSpecProps, Pagination, type PaginationProps, type PaginationSlot, PdfPreview, type PdfPreviewProps, PhoneCountryInput, PhoneInput, type PillStatus, Popover, PopoverAnchor, PopoverClose, PopoverContent, PopoverPortal, type PopoverSlot, PopoverTrigger, Pressable, type PressableProps, type PressableSlot, PrimaryAction, type PrimaryActionProps, type Priority, PriorityIcon, type PriorityIconProps, ProgressBar, type ProgressBarProps, type ProgressBarVariant, type ProgressBarVariantProps, type ProgressIntent, type ProgressLegacyColour, ProgressRing, type ProgressRingProps, type ProgressRingVariant, type ProgressRingVariantProps, ProposalAddOn, type ProposalAddOnProps, type ProposalBillingMode, type ProposalBillingRow, ProposalBillingTerms, type ProposalBillingTermsProps, ProposalConsentGate, type ProposalConsentGateProps, ProposalCustomPage, type ProposalCustomPageKind, type ProposalCustomPageProps, ProposalNote, type ProposalNoteProps, ProposalPackageCard, type ProposalPackageCardProps, type ProposalPackageMode, ProposalPaymentCapture, type ProposalPaymentCaptureProps, ProposalPricingSummary, type ProposalPricingSummaryProps, ProposalServiceRow, type ProposalServiceRowProps, ProposalSignatureBlock, type ProposalSignatureBlockProps, type ProposalSigner, ProposalSignerList, type ProposalSignerListProps, type ProposalSignerStatus, type QuestionAddressValue, type QuestionFileValue, type QuestionHelp, type QuestionLabeledColumn, type QuestionLabeledRow, type QuestionLabeledValue, type QuestionNameValue, type QuestionOption, type QuestionTableColumn, type QuestionTableRow, type QuestionType, QuestionnairePanel, type QuestionnairePanelGroup, type QuestionnairePanelProps, type QuestionnairePanelSection, type QuestionnairePanelStatus, Questions, type QuestionsProps, type QuickReplyChip, RadioGroup, RadioGroupItem, type RadioGroupSlot, type RankedBar, RankedBars, type RankedBarsProps, type Responsive, ResponsiveDialog, type ResponsiveDialogProps, RouteTransition, type RouteTransitionProps, SERVICE_TONES, SPINNER_TONE_TO_INTENT, STATUS_DOT_TONE_TO_INTENT, ScrollArea, ScrollBar, SearchInput, type SearchInputSlot, type SearchInputVariants, SearchSelect, type SearchSelectOption, SecondaryAction, type SecondaryActionProps, Section, SectionHead, SectionHeader, SegmentedProgress, type SegmentedProgressProps, type SegmentedServiceTone, type SegmentedTone, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, type SelectOption, type SelectProps, SelectRoot, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, type SelectSlot, SelectTrigger, SelectValue, SelectableKpiCard, type SelectableKpiCardProps, Separator, type ServiceTone, Shape, Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetOverlay, SheetPortal, type SheetSlot, SheetTitle, SheetTrigger, Shell, type ShellProps, type ShellSlot, SideDrawer, type SideDrawerSlot, Sidebar, SidebarBrand, type SidebarBrandProps, SidebarBrandSwitcher, type SidebarBrandSwitcherExtra, type SidebarBrandSwitcherItem, type SidebarBrandSwitcherProps, type SidebarBrandSwitcherSlot, SidebarBrandSwitcherTile, SidebarBrandText, type SidebarBrandTextProps, SidebarFooter, type SidebarFooterProps, SidebarLink, SidebarLinkAction, type SidebarLinkActionProps, SidebarLinkBadge, type SidebarLinkBadgeProps, type SidebarLinkBadgeVariants, SidebarLinkGroup, type SidebarLinkGroupProps, SidebarLinkLabel, type SidebarLinkLabelProps, type SidebarLinkProps, SidebarPinButton, type SidebarPinButtonProps, type SidebarProps, SidebarProvider, type SidebarProviderProps, SidebarSection, type SidebarSectionProps, type SidebarSlot, type SidebarState, SidebarTrigger, type SidebarTriggerProps, SidebarUser, type SidebarUserProps, SignatureEditor, type SignatureEditorProps, Skeleton, SkeletonCircle, SkeletonText, Slider, type SortDirection, Spinner, type SpinnerIntent, type SpinnerProps, type SpinnerSize, type SpinnerTone, type SpinnerVariantProps, SpreadsheetPreview, type SpreadsheetPreviewProps, Stack, type StackDirection, type StackProps, type StackSlot, StackedBarChart, type StackedBarChartProps, type StackedBarDatum, type StackedBarSeries, StagePill, StarRating, type StarRatingProps, Stat, StatusBadge, type StatusBadgeProps, type StatusBadgeSlot, StatusDot, type StatusDotIntent, type StatusDotProps, type StatusDotSize, type StatusDotTone, type StatusDotVariantProps, StatusIcon, type StatusIconProps, type StatusMap, StatusPill, type StatusPillProps, type StatusPresentation, type StatusState, type Step, Stepper, type StepperProps, StickyActionBar, type StickyActionBarProps, StickyStack, StickyStackLayer, type StickyStackLayerProps, type StickyStackProps, StickyStackSectionHeader, type StickyStackSectionHeaderProps, StickyStackSticky, type StickyStackStickyProps, SubmitButton, SuggestionPills, type SuggestionPillsProps, SuiteProgress, type SuiteProgressFillVariantProps, type SuiteProgressProps, type SuiteProgressSize, type SuiteProgressSuiteTone, type SuiteProgressTone, Surface, type SurfaceElevation, type SurfacePadding, type SurfaceProps, type SurfaceRadius, type SurfaceSlot, Switch, type SwitchSlot, Table, TableBody, type TableBodyProps, TableCaption, type TableCaptionProps, TableCell, type TableCellProps, TableFooter, type TableFooterProps, TableHead, type TableHeadProps, TableHeader, type TableHeaderProps, type TableProps, TableRow, type TableRowData, type TableRowProps, type TableSlot, type TableTone, Tabs, TabsContent, TabsList, TabsTrigger, TagsCell, TeamMemberSelect, Text, type TextColor, type TextProps, type TextSize, type TextSlot, type TextWeight, Textarea, type TextareaSlot, type TextareaVariants, TimeLogger, TimeLoggerActions, type TimeLoggerActionsProps, TimeLoggerBillable, type TimeLoggerBillableProps, TimeLoggerContextRow, type TimeLoggerContextRowProps, TimeLoggerEntry, TimeLoggerEntryList, type TimeLoggerEntryListProps, type TimeLoggerEntryProps, TimeLoggerField, type TimeLoggerFieldProps, TimeLoggerFooter, type TimeLoggerFooterProps, TimeLoggerHeader, type TimeLoggerHeaderProps, TimeLoggerNotes, type TimeLoggerNotesProps, type TimeLoggerPhase, type TimeLoggerProps, type TimeLoggerTier, TimeLoggerTimer, type TimeLoggerTimerProps, type TimelineState, type ToastAction, type ToastContextValue, type ToastOptions, ToastProvider, type ToastSlot, type ToastVariant, ToggleGroup, ToggleGroupItem, Toolbar, type ToolbarProps, Tooltip, TooltipContent, TooltipPortal, TooltipProvider, type TooltipSlot, TooltipTrigger, type UseStopwatchReturn, Variant, VisuallyHidden, YEAR_DISPLAY_PLACEHOLDER, alertVariants, applyMask, applyYearMask, assetPath, attachmentChipVariants, badgeVariants, brandLabel, brandScope, buttonVariants, cardVariants, chipVariants, cn, dateToIso, defineStatusMap, displayToIso, fileTypeBadgeVariants, fileTypeFromName, filterChipVariants, formatClock, formatCurrency, formatDuration, getAssetBasePath, getFlagEmoji, iconButtonVariants, resolveIconTileVariants as iconTileVariants, inputVariants, isoToDate, isoToDisplay, isoToYear, labelVariants, parseDuration, parsePhoneForEditing, progressBarVariants, progressRingVariants, resolveBadgeAppearance, resolveButtonStyle, resolveChipStyle, searchInputVariants, serviceToneLabel, serviceToneStyle, setAssetBasePath, sidebarLinkBadgeVariants, spinnerVariants, starRatingVariants, statusDotVariants, suiteProgressFillVariants, textareaVariants, useBrandScope, useSidebarPeekLock, useSidebarState, useStopwatch, useToast, yearToIso };