@oods/component-contracts 0.3.3 → 0.4.1

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 declare const COMPONENT_CLASSIFICATIONS: readonly ["native", "recipe", "alias", "authoring-only", "merged", "retired"];
 type ComponentClassification = (typeof COMPONENT_CLASSIFICATIONS)[number];
-declare const NUCLEUS_COMPONENT_IDS: readonly ["AddressCollectionPanel", "AddressEditor", "AddressSummaryBadge", "AddressValidationTimeline", "ArchiveEvent", "ArchivePill", "ArchiveSummary", "ArchivedRowOverlay", "AuditEvent", "AuditSummaryCard", "AuditTimeline", "Badge", "Banner", "BillingAmountInput", "BillingCardMeta", "BillingIntervalSelector", "BillingSummaryBadge", "Button", "CancellationBadge", "CancellationEvent", "CancellationForm", "CancellationSummary", "Card", "CardHeader", "Checkbox", "ClassificationBadge", "ClassificationEditor", "ClassificationPanel", "ColorStatePicker", "ColorSwatch", "ColorizedBadge", "CommunicationDetailPanel", "CycleProgressCard", "DatePicker", "DetailHeader", "FilterPanel", "FormLabelGroup", "GeoFieldMappingForm", "GeoResolutionBadge", "GeocodablePreview", "Grid", "InlineLabel", "Input", "LabelCell", "MembershipAuditTimeline", "MembershipPanel", "MessageEventTimeline", "MessageStatusBadge", "OwnerBadge", "OwnershipMeta", "OwnershipSummary", "PaginationBar", "PaymentEventTimeline", "PaymentTimeline", "PreferenceEditor", "PreferencePanel", "PreferenceSummaryBadge", "PreferenceTimeline", "PriceBadge", "PriceCardMeta", "PriceSummary", "RelativeTimestamp", "RoleAssignmentForm", "RoleBadgeList", "SearchInput", "Select", "SortIndicator", "Stack", "StateTransitionEvent", "StatusBadge", "StatusColorLegend", "StatusSelector", "StatusTimeline", "Table", "Tabs", "TagInput", "TagManager", "TagPills", "TagSummary", "TemplatePicker", "Text", "Textarea", "TimelineEntryLabel", "VizAreaControls", "VizAreaPreview", "VizAxisControls", "VizAxisSummary", "VizColorControls", "VizColorLegendConfig", "VizEncodingBadge", "VizGraphPreview", "VizHeatmapControls", "VizHeatmapPreview", "VizLineControls", "VizLinePreview", "VizMarkControls", "VizMarkPreview", "VizOpacityControls", "VizOpacitySummary", "VizPointControls", "VizPointPreview", "VizRoleBadge", "VizScaleControls", "VizScaleSummary", "VizScatterControls", "VizScatterPreview", "VizShapeControls", "VizShapeLegend", "VizSizeControls", "VizSizeSummary"];
+declare const NUCLEUS_COMPONENT_IDS: readonly ["AddressCollectionPanel", "AddressEditor", "AddressSummaryBadge", "AddressValidationTimeline", "ArchiveEvent", "ArchivePill", "ArchiveSummary", "ArchivedRowOverlay", "AuditEvent", "AuditSummaryCard", "AuditTimeline", "Badge", "Banner", "BillingAmountInput", "BillingCardMeta", "BillingIntervalSelector", "BillingSummaryBadge", "Button", "CancellationBadge", "CancellationEvent", "CancellationForm", "CancellationSummary", "Card", "CardHeader", "Checkbox", "ClassificationBadge", "ClassificationEditor", "ClassificationPanel", "ColorStatePicker", "ColorSwatch", "ColorizedBadge", "Combobox", "CommunicationDetailPanel", "CycleProgressCard", "DatePicker", "DetailHeader", "Dialog", "FilterPanel", "FormLabelGroup", "GeoFieldMappingForm", "GeoResolutionBadge", "GeocodablePreview", "Grid", "InlineLabel", "Input", "LabelCell", "MembershipAuditTimeline", "MembershipPanel", "MessageEventTimeline", "MessageStatusBadge", "OwnerBadge", "OwnershipMeta", "OwnershipSummary", "PaginationBar", "PaymentEventTimeline", "PaymentTimeline", "PreferenceEditor", "PreferencePanel", "PreferenceSummaryBadge", "PreferenceTimeline", "PriceBadge", "PriceCardMeta", "PriceSummary", "RelativeTimestamp", "RoleAssignmentForm", "RoleBadgeList", "SearchInput", "SegmentedControl", "Select", "SortIndicator", "Stack", "StateTransitionEvent", "StatusBadge", "StatusColorLegend", "StatusSelector", "StatusTimeline", "Switch", "Table", "Tabs", "TagInput", "TagManager", "TagPills", "TagSummary", "TemplatePicker", "Text", "Textarea", "TimelineEntryLabel", "VizAreaControls", "VizAreaPreview", "VizAxisControls", "VizAxisSummary", "VizColorControls", "VizColorLegendConfig", "VizEncodingBadge", "VizGraphPreview", "VizHeatmapControls", "VizHeatmapPreview", "VizLineControls", "VizLinePreview", "VizMarkControls", "VizMarkPreview", "VizOpacityControls", "VizOpacitySummary", "VizPointControls", "VizPointPreview", "VizRoleBadge", "VizScaleControls", "VizScaleSummary", "VizScatterControls", "VizScatterPreview", "VizShapeControls", "VizShapeLegend", "VizSizeControls", "VizSizeSummary"];
 type NucleusComponentId = (typeof NUCLEUS_COMPONENT_IDS)[number];
 declare const HISTORICAL_PORTED_COMPONENT_IDS: readonly ["AuditTimeline", "CancellationSummary", "PaginationBar", "PriceBadge", "RelativeTimestamp", "SearchInput", "StatusBadge", "StatusTimeline"];
 /** @deprecated Historical compatibility cohort; all members belong to NucleusComponentId. */
@@ -67,10 +67,19 @@ type ScenarioTrigger = {
     trigger: 'keyboard' | 'pointer';
     target: string;
     key?: string;
+    /**
+     * s223-m02 (#2527 ruling 11): keys pressed first on the target, in the same fresh scenario, before key, whose effect is
+     * asserted. A combobox's Enter, Home and End act on an open list, which a key such as ArrowDown opens.
+     */
+    keys?: readonly string[];
     action?: 'click' | 'select';
     value?: string;
+    /**
+     * active-option (s223-m02): the target's popup is open (aria-expanded true), its aria-activedescendant names the option
+     * whose text is value, and nothing was picked (no event).
+     */
     effect: {
-        kind: 'focus' | 'event' | 'value' | 'selected-tab';
+        kind: 'focus' | 'event' | 'value' | 'selected-tab' | 'active-option';
         value?: unknown;
         target?: string;
     };
@@ -86,7 +95,7 @@ type ComponentBehavior = {
 
 declare const COMPONENT_CONTRACT_VERSION: "1.1.0";
 declare const COMPONENT_CONTRACT_VERSION_1_1: "1.1.0";
-declare const componentContracts: Readonly<Record<"AddressCollectionPanel" | "AddressEditor" | "AddressSummaryBadge" | "AddressValidationTimeline" | "ArchiveEvent" | "ArchivePill" | "ArchiveSummary" | "ArchivedRowOverlay" | "AuditEvent" | "AuditSummaryCard" | "AuditTimeline" | "Badge" | "Banner" | "BillingAmountInput" | "BillingCardMeta" | "BillingIntervalSelector" | "BillingSummaryBadge" | "Button" | "CancellationBadge" | "CancellationEvent" | "CancellationForm" | "CancellationSummary" | "Card" | "CardHeader" | "Checkbox" | "ClassificationBadge" | "ClassificationEditor" | "ClassificationPanel" | "ColorStatePicker" | "ColorSwatch" | "ColorizedBadge" | "CommunicationDetailPanel" | "CycleProgressCard" | "DatePicker" | "DetailHeader" | "FilterPanel" | "FormLabelGroup" | "GeoFieldMappingForm" | "GeoResolutionBadge" | "GeocodablePreview" | "Grid" | "InlineLabel" | "Input" | "LabelCell" | "MembershipAuditTimeline" | "MembershipPanel" | "MessageEventTimeline" | "MessageStatusBadge" | "OwnerBadge" | "OwnershipMeta" | "OwnershipSummary" | "PaginationBar" | "PaymentEventTimeline" | "PaymentTimeline" | "PreferenceEditor" | "PreferencePanel" | "PreferenceSummaryBadge" | "PreferenceTimeline" | "PriceBadge" | "PriceCardMeta" | "PriceSummary" | "RelativeTimestamp" | "RoleAssignmentForm" | "RoleBadgeList" | "SearchInput" | "Select" | "SortIndicator" | "Stack" | "StateTransitionEvent" | "StatusBadge" | "StatusColorLegend" | "StatusSelector" | "StatusTimeline" | "Table" | "Tabs" | "TagInput" | "TagManager" | "TagPills" | "TagSummary" | "TemplatePicker" | "Text" | "Textarea" | "TimelineEntryLabel" | "VizAreaControls" | "VizAreaPreview" | "VizAxisControls" | "VizAxisSummary" | "VizColorControls" | "VizColorLegendConfig" | "VizEncodingBadge" | "VizGraphPreview" | "VizHeatmapControls" | "VizHeatmapPreview" | "VizLineControls" | "VizLinePreview" | "VizMarkControls" | "VizMarkPreview" | "VizOpacityControls" | "VizOpacitySummary" | "VizPointControls" | "VizPointPreview" | "VizRoleBadge" | "VizScaleControls" | "VizScaleSummary" | "VizScatterControls" | "VizScatterPreview" | "VizShapeControls" | "VizShapeLegend" | "VizSizeControls" | "VizSizeSummary", ComponentContract>>;
+declare const componentContracts: Readonly<Record<"AddressCollectionPanel" | "AddressEditor" | "AddressSummaryBadge" | "AddressValidationTimeline" | "ArchiveEvent" | "ArchivePill" | "ArchiveSummary" | "ArchivedRowOverlay" | "AuditEvent" | "AuditSummaryCard" | "AuditTimeline" | "Badge" | "Banner" | "BillingAmountInput" | "BillingCardMeta" | "BillingIntervalSelector" | "BillingSummaryBadge" | "Button" | "CancellationBadge" | "CancellationEvent" | "CancellationForm" | "CancellationSummary" | "Card" | "CardHeader" | "Checkbox" | "ClassificationBadge" | "ClassificationEditor" | "ClassificationPanel" | "ColorStatePicker" | "ColorSwatch" | "ColorizedBadge" | "Combobox" | "CommunicationDetailPanel" | "CycleProgressCard" | "DatePicker" | "DetailHeader" | "Dialog" | "FilterPanel" | "FormLabelGroup" | "GeoFieldMappingForm" | "GeoResolutionBadge" | "GeocodablePreview" | "Grid" | "InlineLabel" | "Input" | "LabelCell" | "MembershipAuditTimeline" | "MembershipPanel" | "MessageEventTimeline" | "MessageStatusBadge" | "OwnerBadge" | "OwnershipMeta" | "OwnershipSummary" | "PaginationBar" | "PaymentEventTimeline" | "PaymentTimeline" | "PreferenceEditor" | "PreferencePanel" | "PreferenceSummaryBadge" | "PreferenceTimeline" | "PriceBadge" | "PriceCardMeta" | "PriceSummary" | "RelativeTimestamp" | "RoleAssignmentForm" | "RoleBadgeList" | "SearchInput" | "SegmentedControl" | "Select" | "SortIndicator" | "Stack" | "StateTransitionEvent" | "StatusBadge" | "StatusColorLegend" | "StatusSelector" | "StatusTimeline" | "Switch" | "Table" | "Tabs" | "TagInput" | "TagManager" | "TagPills" | "TagSummary" | "TemplatePicker" | "Text" | "Textarea" | "TimelineEntryLabel" | "VizAreaControls" | "VizAreaPreview" | "VizAxisControls" | "VizAxisSummary" | "VizColorControls" | "VizColorLegendConfig" | "VizEncodingBadge" | "VizGraphPreview" | "VizHeatmapControls" | "VizHeatmapPreview" | "VizLineControls" | "VizLinePreview" | "VizMarkControls" | "VizMarkPreview" | "VizOpacityControls" | "VizOpacitySummary" | "VizPointControls" | "VizPointPreview" | "VizRoleBadge" | "VizScaleControls" | "VizScaleSummary" | "VizScatterControls" | "VizScatterPreview" | "VizShapeControls" | "VizShapeLegend" | "VizSizeControls" | "VizSizeSummary", ComponentContract>>;
 
 /** Billable's declared defaults; object parameter overrides travel as runtime props. */
 declare const BILLING_INTERVALS: readonly ["monthly", "quarterly", "annual"];
@@ -115,6 +124,11 @@ declare function formatPriceAmount(value: unknown, currency?: unknown, minorUnit
 declare function formatPriceCode(value: unknown): string | undefined;
 
 declare const sharedScenarios: readonly SharedScenario[];
+/**
+ * s222-m03 (#2502 ruling 16): an empty value, which React, Vue and the HTML renderer must show alike, as "Unknown time"
+ * with no empty datetime. It stays out of sharedScenarios, which holds exactly one documented example per component.
+ */
+declare const relativeTimestampEmptyScenario: SharedScenario;
 
 /** @deprecated Historical compatibility view; canonical definitions live in componentContracts. */
 declare const portedComponentContracts: Readonly<Record<"AuditTimeline" | "CancellationSummary" | "PaginationBar" | "PriceBadge" | "RelativeTimestamp" | "SearchInput" | "StatusBadge" | "StatusTimeline", ComponentContract>>;
@@ -163,6 +177,64 @@ declare const RESULT_STATE_TONE: "neutral";
 /** The tones that carry a verdict or a severity; a result state never resolves to any of their colours. */
 declare const SEVERITY_TONES: readonly ["positive", "success", "warning", "critical", "danger"];
 
+/**
+ * s222-m02 (#2502 ruling 11): status marks are SVG icons, not Unicode glyphs, so a badge or banner draws the same mark
+ * in every font and renderer. One 16-unit grid, stroked in the text colour (1.5 wide, round caps and joins), so each
+ * mark keeps the tone's graded text contrast and reads at a badge's 12px and a banner's 16px. React, Vue and HTML all
+ * draw from this table.
+ */
+type StatusIconName = 'check' | 'x' | 'alert' | 'info' | 'clock' | 'dots' | 'refresh' | 'pause' | 'ban' | 'pencil' | 'star' | 'undo' | 'lock' | 'unlock' | 'dot' | 'chevron-down';
+type StatusIconShape = {
+    readonly tag: 'path' | 'circle' | 'rect';
+    readonly attrs: Readonly<Record<string, string>>;
+};
+declare const STATUS_ICON_SHAPES: Readonly<Record<StatusIconName, readonly StatusIconShape[]>>;
+/** The outer svg element's attributes, in the order every renderer writes them. It is 1em square, so it takes the size of
+ * the text it sits in wherever no stylesheet sizes it. */
+declare const STATUS_ICON_SVG_ATTRS: Readonly<Record<string, string>>;
+/** The mark for a registry icon name; an unknown name takes the neutral dot, and no name takes no mark. */
+declare function resolveStatusIcon(iconName: string | undefined): StatusIconName | undefined;
+/** The mark as markup, for renderers that write HTML strings. */
+declare function statusIconMarkup(name: StatusIconName): string;
+
+/**
+ * s222-m02 (#2502 ruling 11): the status registry and its presentation, shared by every renderer. It moved here from
+ * @oods/components-react (which re-exports it unchanged) so the HTML renderer labels, tones and marks a status exactly as
+ * the React components do. The map is the token package's saas-billing status map.
+ *
+ * s222-m03 (#2502 ruling 13): the lifecycle table (registry/lifecycle-status-tones.json) is the StatusBadge contract's
+ * lifecycle status-to-tone table: the `lifecycle` domain, and what any domain's badge reads for a status its own table does
+ * not know. A settled payment is a success and a failed one critical, not neutral.
+ */
+type StatusTone = 'neutral' | 'info' | 'accent' | 'positive' | 'success' | 'warning' | 'critical' | 'danger';
+type StatusDomain = string;
+type StatusTokenSet = {
+    readonly background: string;
+    readonly border: string;
+    readonly foreground: string;
+};
+type StatusPresentation = {
+    readonly domain: StatusDomain;
+    readonly status: string;
+    readonly label: string;
+    readonly description: string;
+    readonly tone: StatusTone;
+    readonly iconName?: string;
+    readonly badge: {
+        readonly subtle: StatusTokenSet;
+        readonly solid: StatusTokenSet;
+    };
+    readonly banner: {
+        readonly subtle: StatusTokenSet;
+        readonly solid: StatusTokenSet;
+    };
+};
+declare const STATUS_DOMAINS: readonly StatusDomain[];
+declare function getStatusPresentation(domain: StatusDomain, status: string): StatusPresentation;
+declare function listStatuses(domain: StatusDomain): readonly StatusPresentation[];
+declare function getToneTokenSet(tone: StatusTone): StatusTokenSet;
+declare function getBannerToneTokenSet(tone: StatusTone): StatusTokenSet;
+
 interface BillingCycleValues {
     progress?: number;
     periodStart?: string;
@@ -242,8 +314,15 @@ interface CollectionEvent {
 }
 /** Invalid dates cannot participate in a chronological view; ties retain source order. */
 declare function chronologicalEvents(events: readonly CollectionEvent[]): CollectionEvent[];
+/** A number's declared display format (a field's ui_hints.format). */
+type NumberDisplayFormat = 'percent' | 'quantity';
+/**
+ * s223-m01 (#2527 ruling 4): a declared number reads as a person writes it. percent holds percent units (12.5 reads
+ * 12.5%, -41 reads -41%); quantity is grouped (86420 reads 86,420). Undefined for a value that is not a finite number.
+ */
+declare function formatDeclaredNumber(value: unknown, format: NumberDisplayFormat): string | undefined;
 /** Format declared scalar display fields without changing the underlying record. */
-declare function formatReadOnlyValue(value: unknown, type: string, code?: boolean): string;
+declare function formatReadOnlyValue(value: unknown, type: string, code?: boolean, format?: NumberDisplayFormat): string;
 /** Workflow apps and standalone previews project the same actual record events. */
 declare function recordCollectionEvents(record: Record<string, unknown>, options?: {
     historyField?: string;
@@ -253,8 +332,20 @@ declare function recordCollectionEvents(record: Record<string, unknown>, options
     }>;
     minorUnits?: number;
 }): CollectionEvent[];
+/**
+ * s223-m02 (#2527 ruling 13i, #2521): the summary an AddressCollectionPanel shows of a record's addresses, one line per
+ * entry (its role, street lines, city, region and postal code) with the entries separated by semicolons, for example
+ * "home, 8 Lake Road, Madison, WI, 53703". A generated workflow's store prints the same line (collectionSummary); a single
+ * screen and the HTML renderer print it from here. A record with no addresses reads as an empty string.
+ */
+declare function addressCollectionSummary(entries: unknown): string;
 /** A label is authoritative only alongside its actual reference; never infer a related entity. */
 declare function formatReferenceLabel(identifier: unknown, label?: unknown, subject?: string): string;
+/**
+ * s223-m01 (#2527 ruling 6): ownership on a card as one phrase, "Owned by Pricing and packaging · team", or by its type
+ * alone when the owner has no name to show ("Team-owned"). Undefined when there is nothing to say.
+ */
+declare function ownershipPhrase(ownerLabel?: unknown, ownerType?: unknown, role?: unknown): string | undefined;
 /** Keep authored record keys and the Transaction fallback; UUIDs belong in technical inspection. */
 declare function formatRecordLabel(value: unknown): string;
 
@@ -266,6 +357,30 @@ declare function assertStaticSvg(svg: string): string;
  * the title as a text element whose whole content is the title.
  */
 declare function svgCarriesTitle(svg: string, title: string | undefined): boolean;
+/** s222-m02 (#2502 ruling 12, F7): the props that carry a placed chart's dark and high-contrast renders. */
+declare const VIZ_THEME_SVG_PROPS: readonly ["svgDark", "svgDarkNarrow", "svgDarkWide", "svgHc", "svgHcNarrow", "svgHcWide"];
+type VizThemeSvgProp = (typeof VIZ_THEME_SVG_PROPS)[number];
+/** Every render prop a placed chart carries: the light (or only) renders, then the dark and hc ones. */
+declare const VIZ_SVG_PROPS: readonly ["svg", "svgNarrow", "svgWide", "svgDark", "svgDarkNarrow", "svgDarkWide", "svgHc", "svgHcNarrow", "svgHcWide"];
+type VizPreviewTheme = 'light' | 'dark' | 'hc';
+type VizRenderAttribute = 'data-viz-svg' | 'data-viz-svg-narrow' | 'data-viz-svg-wide';
+/** One set of a chart's renders: the design size, then the narrow and wide sizes when present. */
+interface VizPreviewLayer {
+    /** The theme the renders are drawn in; absent for a chart with no dark or hc renders, whose renders show in every theme. */
+    readonly theme?: VizPreviewTheme;
+    readonly narrow: boolean;
+    readonly wide: boolean;
+    /** Each render's wrapper attribute and its checked SVG, in document order. */
+    readonly renders: ReadonlyArray<readonly [VizRenderAttribute, string]>;
+}
+/**
+ * The renders a chart preview lays out, which React, Vue and the HTML renderer all read, so the three render one markup.
+ * Without a dark or hc render it is the one unthemed layer the figure has always shown (svg, svgNarrow, svgWide). With
+ * them, a layer per theme (light is svg*), each wrapped in [data-viz-theme]; component-styles shows the one matching the
+ * nearest [data-theme], and each wrapper repeats the figure's data-viz-narrow and data-viz-wide so the size rules apply
+ * inside it. Every SVG passes assertStaticSvg.
+ */
+declare function vizPreviewLayers(props: Readonly<Partial<Record<'svg' | 'svgNarrow' | 'svgWide' | VizThemeSvgProp, unknown>>>): VizPreviewLayer[];
 
 declare const componentBehaviors: {
     readonly VizAreaControls: {
@@ -1625,6 +1740,91 @@ declare const componentBehaviors: {
         readonly interactionReason: "ColorizedBadge presents content and owns no focusable control or action; authored child actions remain the consumer's responsibility.";
         readonly event: readonly [];
     };
+    readonly Combobox: {
+        readonly role: "combobox";
+        readonly name: {
+            readonly strategy: "label";
+            readonly target: "input[role=\"combobox\"]";
+        };
+        readonly keyboard: {
+            readonly Tab: "Move focus to the named native control; an open list closes without picking";
+            readonly x: "Type to filter the options by label";
+            readonly ArrowDown: "Open the list and move to the next option";
+            readonly ArrowUp: "Move to the previous option; with the list closed, open it at the last option";
+            readonly Home: "Move to the first option of an open list";
+            readonly End: "Move to the last option of an open list";
+            readonly Enter: "Pick the active option and close the list";
+            readonly Escape: "Close the list; with the list closed, clear the field";
+        };
+        readonly interaction: "interactive";
+        readonly event: readonly [{
+            readonly trigger: "keyboard";
+            readonly target: "input[role=\"combobox\"]";
+            readonly key: "Tab";
+            readonly effect: {
+                readonly kind: "focus";
+            };
+        }, {
+            readonly trigger: "keyboard";
+            readonly target: "input[role=\"combobox\"]";
+            readonly key: "x";
+            readonly effect: {
+                readonly kind: "value";
+                readonly value: "Canadax";
+            };
+        }, {
+            readonly trigger: "keyboard";
+            readonly target: "input[role=\"combobox\"]";
+            readonly key: "ArrowDown";
+            readonly effect: {
+                readonly kind: "active-option";
+                readonly value: "Australia";
+            };
+        }, {
+            readonly trigger: "keyboard";
+            readonly target: "input[role=\"combobox\"]";
+            readonly key: "ArrowUp";
+            readonly effect: {
+                readonly kind: "active-option";
+                readonly value: "United States";
+            };
+        }, {
+            readonly trigger: "keyboard";
+            readonly target: "input[role=\"combobox\"]";
+            readonly keys: readonly ["ArrowUp"];
+            readonly key: "Home";
+            readonly effect: {
+                readonly kind: "active-option";
+                readonly value: "Australia";
+            };
+        }, {
+            readonly trigger: "keyboard";
+            readonly target: "input[role=\"combobox\"]";
+            readonly keys: readonly ["ArrowDown"];
+            readonly key: "End";
+            readonly effect: {
+                readonly kind: "active-option";
+                readonly value: "United States";
+            };
+        }, {
+            readonly trigger: "keyboard";
+            readonly target: "input[role=\"combobox\"]";
+            readonly keys: readonly ["ArrowDown", "ArrowDown", "ArrowDown"];
+            readonly key: "Enter";
+            readonly effect: {
+                readonly kind: "event";
+                readonly value: "fr";
+            };
+        }, {
+            readonly trigger: "keyboard";
+            readonly target: "input[role=\"combobox\"]";
+            readonly key: "Escape";
+            readonly effect: {
+                readonly kind: "event";
+                readonly value: "";
+            };
+        }];
+    };
     readonly CycleProgressCard: {
         readonly role: "none";
         readonly name: {
@@ -1666,6 +1866,48 @@ declare const componentBehaviors: {
         readonly interactionReason: "DetailHeader presents content and owns no focusable control or action; authored child actions remain the consumer's responsibility.";
         readonly event: readonly [];
     };
+    readonly Dialog: {
+        readonly role: "button";
+        readonly name: {
+            readonly strategy: "aria-label";
+            readonly target: "button[aria-label=\"Close\"]";
+        };
+        readonly keyboard: {
+            readonly Tab: "Move focus to the named native control";
+            readonly Enter: "Activate the control";
+            readonly Escape: "Close the dialog";
+        };
+        readonly interaction: "interactive";
+        readonly event: readonly [{
+            readonly trigger: "keyboard";
+            readonly target: "button[aria-label=\"Close\"]";
+            readonly key: "Tab";
+            readonly effect: {
+                readonly kind: "focus";
+            };
+        }, {
+            readonly trigger: "pointer";
+            readonly target: "button[aria-label=\"Close\"]";
+            readonly effect: {
+                readonly kind: "event";
+            };
+            readonly action: "click";
+        }, {
+            readonly trigger: "keyboard";
+            readonly target: "button[aria-label=\"Close\"]";
+            readonly effect: {
+                readonly kind: "event";
+            };
+            readonly key: "Enter";
+        }, {
+            readonly trigger: "keyboard";
+            readonly target: "button[aria-label=\"Close\"]";
+            readonly effect: {
+                readonly kind: "event";
+            };
+            readonly key: "Escape";
+        }];
+    };
     readonly FilterPanel: {
         readonly role: "button";
         readonly name: {
@@ -2072,6 +2314,69 @@ declare const componentBehaviors: {
             };
         }];
     };
+    readonly SegmentedControl: {
+        readonly role: "radio";
+        readonly name: {
+            readonly strategy: "label";
+            readonly target: "input[type=\"radio\"]:checked";
+        };
+        readonly keyboard: {
+            readonly Tab: "Move focus to the checked option";
+            readonly ArrowRight: "Check and focus the next option";
+            readonly ArrowDown: "Check and focus the next option";
+            readonly ArrowLeft: "Check and focus the previous option";
+            readonly ArrowUp: "Check and focus the previous option";
+        };
+        readonly interaction: "interactive";
+        readonly event: readonly [{
+            readonly trigger: "keyboard";
+            readonly target: "input[type=\"radio\"]:checked";
+            readonly key: "Tab";
+            readonly effect: {
+                readonly kind: "focus";
+            };
+        }, {
+            readonly trigger: "keyboard";
+            readonly target: "input[type=\"radio\"]:checked";
+            readonly key: "ArrowRight";
+            readonly effect: {
+                readonly kind: "event";
+                readonly value: "yearly";
+            };
+        }, {
+            readonly trigger: "keyboard";
+            readonly target: "input[type=\"radio\"]:checked";
+            readonly key: "ArrowDown";
+            readonly effect: {
+                readonly kind: "event";
+                readonly value: "yearly";
+            };
+        }, {
+            readonly trigger: "keyboard";
+            readonly target: "input[type=\"radio\"]:checked";
+            readonly key: "ArrowLeft";
+            readonly effect: {
+                readonly kind: "event";
+                readonly value: "monthly";
+            };
+        }, {
+            readonly trigger: "keyboard";
+            readonly target: "input[type=\"radio\"]:checked";
+            readonly key: "ArrowUp";
+            readonly effect: {
+                readonly kind: "event";
+                readonly value: "monthly";
+            };
+        }, {
+            readonly trigger: "pointer";
+            readonly target: "input[value=\"yearly\"]";
+            readonly effect: {
+                readonly kind: "event";
+                readonly value: "yearly";
+            };
+            readonly action: "click";
+        }];
+    };
     readonly Select: {
         readonly role: "combobox";
         readonly name: {
@@ -2161,6 +2466,51 @@ declare const componentBehaviors: {
         readonly interactionReason: "StatusTimeline presents content and owns no focusable control or action; authored child actions remain the consumer's responsibility.";
         readonly event: readonly [];
     };
+    readonly Switch: {
+        readonly role: "switch";
+        readonly name: {
+            readonly strategy: "label";
+            readonly target: "button[role=\"switch\"]";
+        };
+        readonly keyboard: {
+            readonly Tab: "Move focus to the named native control";
+            readonly " ": "Toggle the switch";
+            readonly Enter: "Toggle the switch";
+        };
+        readonly interaction: "interactive";
+        readonly event: readonly [{
+            readonly trigger: "keyboard";
+            readonly target: "button[role=\"switch\"]";
+            readonly key: "Tab";
+            readonly effect: {
+                readonly kind: "focus";
+            };
+        }, {
+            readonly trigger: "pointer";
+            readonly target: "button[role=\"switch\"]";
+            readonly effect: {
+                readonly kind: "event";
+                readonly value: true;
+            };
+            readonly action: "click";
+        }, {
+            readonly trigger: "keyboard";
+            readonly target: "button[role=\"switch\"]";
+            readonly effect: {
+                readonly kind: "event";
+                readonly value: true;
+            };
+            readonly key: " ";
+        }, {
+            readonly trigger: "keyboard";
+            readonly target: "button[role=\"switch\"]";
+            readonly effect: {
+                readonly kind: "event";
+                readonly value: true;
+            };
+            readonly key: "Enter";
+        }];
+    };
     readonly Table: {
         readonly role: "button";
         readonly name: {
@@ -3046,4 +3396,4 @@ declare function getBaselineCapability(componentId: string): {
     };
 } | undefined;
 
-export { type AuditSummaryValues, BILLING_AMOUNT_ERROR, BILLING_INTERVALS, BILLING_INTERVAL_ERROR, BILLING_MINOR_UNITS, type BillingAmountResult, type BillingCycleValues, type BillingPaymentValues, COMPONENT_CLASSIFICATIONS, COMPONENT_CONTRACT_VERSION, COMPONENT_CONTRACT_VERSION_1_1, type CollectionEvent, type ComponentBehavior, type ComponentClassification, type ComponentContract, DEFAULT_COLOR_STATES, EMISSION_ELIGIBILITY_EVIDENCE_CLASSES, type EmissionEligibilityEvidence, type EmissionEligibilityEvidenceClass, type EvidenceResult, type EvidenceStatus, FOUNDATION_V1_EVIDENCE_CLASSES, type FoundationV1Evidence, type FoundationV1EvidenceClass, GOVERNED_DEFINITION, GOVERNED_SURFACES, type GeoFieldMappingValue, type GovernedComponentId, type GovernedLedgerRow, NO_LAST_PAYMENT, NO_NEXT_PAYMENT, NUCLEUS_COMPONENT_IDS, type NucleusComponentId, type ObligationStatus, PORTED_COMPONENT_IDS, type PortedComponentId, RESULT_STATES, RESULT_STATE_TONE, type ResultState, SEVERITY_TONES, type ScenarioTrigger, type SharedScenario, type SortIndicatorValues, type SortState, type SubstitutionContractReport, type SubstitutionObligation, type TraitEventKind, type TraitEventValues, UI_WORKFLOW_STATES, type UiWorkflowState, VIZ_CONTROL_IDS, VIZ_CONTROL_TITLES, VIZ_PREVIEW_TYPES, VIZ_SUMMARY_IDS, type VizChannel, type VizChartType, type VizColorBinding, type VizControlField, type VizControlId, type VizFieldBinding, type VizIntentFragment, type VizScale, type VizSummaryId, ariaSort, assertStaticSvg, auditSummary, billingAmountMessage, billingAmountText, billingCycle, billingDate, billingIntervalMessage, billingPaymentRows, billingPaymentSummary, billingPeriodEnd, billingSummary, chronologicalEvents, componentBehaviors, componentCapabilityBaseline, componentContracts, componentIntake, componentReconciliationProposal, currencyMinorUnits, dateTimeInputValue, defaultVizIntent, deriveStartingComponentCount, editVizIntent, evaluateEmissionEligibility, evaluateFoundationV1, formatBillingAmount, formatDateTime, formatPriceAmount, formatPriceCode, formatReadOnlyValue, formatRecordLabel, formatReferenceLabel, geoFieldMapping, getBaselineCapability, initialSort, isGovernedComponent, isVizIntentFragment, nextSort, parseBillingAmount, portedComponentContracts, portedScenarios, recipeItemLabels, recordCollectionEvents, restartedBillingPeriod, sharedScenarios, substitutionContractReport, summarizeSubstitutionReport, summaryValue, svgCarriesTitle, traitEventRows, validMinorUnits, validateComponentIntakeDocument, vizControlFields, vizFieldValue, vizSummaryRows };
+export { type AuditSummaryValues, BILLING_AMOUNT_ERROR, BILLING_INTERVALS, BILLING_INTERVAL_ERROR, BILLING_MINOR_UNITS, type BillingAmountResult, type BillingCycleValues, type BillingPaymentValues, COMPONENT_CLASSIFICATIONS, COMPONENT_CONTRACT_VERSION, COMPONENT_CONTRACT_VERSION_1_1, type CollectionEvent, type ComponentBehavior, type ComponentClassification, type ComponentContract, DEFAULT_COLOR_STATES, EMISSION_ELIGIBILITY_EVIDENCE_CLASSES, type EmissionEligibilityEvidence, type EmissionEligibilityEvidenceClass, type EvidenceResult, type EvidenceStatus, FOUNDATION_V1_EVIDENCE_CLASSES, type FoundationV1Evidence, type FoundationV1EvidenceClass, GOVERNED_DEFINITION, GOVERNED_SURFACES, type GeoFieldMappingValue, type GovernedComponentId, type GovernedLedgerRow, NO_LAST_PAYMENT, NO_NEXT_PAYMENT, NUCLEUS_COMPONENT_IDS, type NucleusComponentId, type NumberDisplayFormat, type ObligationStatus, PORTED_COMPONENT_IDS, type PortedComponentId, RESULT_STATES, RESULT_STATE_TONE, type ResultState, SEVERITY_TONES, STATUS_DOMAINS, STATUS_ICON_SHAPES, STATUS_ICON_SVG_ATTRS, type ScenarioTrigger, type SharedScenario, type SortIndicatorValues, type SortState, type StatusDomain, type StatusIconName, type StatusIconShape, type StatusPresentation, type StatusTokenSet, type StatusTone, type SubstitutionContractReport, type SubstitutionObligation, type TraitEventKind, type TraitEventValues, UI_WORKFLOW_STATES, type UiWorkflowState, VIZ_CONTROL_IDS, VIZ_CONTROL_TITLES, VIZ_PREVIEW_TYPES, VIZ_SUMMARY_IDS, VIZ_SVG_PROPS, VIZ_THEME_SVG_PROPS, type VizChannel, type VizChartType, type VizColorBinding, type VizControlField, type VizControlId, type VizFieldBinding, type VizIntentFragment, type VizPreviewLayer, type VizPreviewTheme, type VizRenderAttribute, type VizScale, type VizSummaryId, type VizThemeSvgProp, addressCollectionSummary, ariaSort, assertStaticSvg, auditSummary, billingAmountMessage, billingAmountText, billingCycle, billingDate, billingIntervalMessage, billingPaymentRows, billingPaymentSummary, billingPeriodEnd, billingSummary, chronologicalEvents, componentBehaviors, componentCapabilityBaseline, componentContracts, componentIntake, componentReconciliationProposal, currencyMinorUnits, dateTimeInputValue, defaultVizIntent, deriveStartingComponentCount, editVizIntent, evaluateEmissionEligibility, evaluateFoundationV1, formatBillingAmount, formatDateTime, formatDeclaredNumber, formatPriceAmount, formatPriceCode, formatReadOnlyValue, formatRecordLabel, formatReferenceLabel, geoFieldMapping, getBannerToneTokenSet, getBaselineCapability, getStatusPresentation, getToneTokenSet, initialSort, isGovernedComponent, isVizIntentFragment, listStatuses, nextSort, ownershipPhrase, parseBillingAmount, portedComponentContracts, portedScenarios, recipeItemLabels, recordCollectionEvents, relativeTimestampEmptyScenario, resolveStatusIcon, restartedBillingPeriod, sharedScenarios, statusIconMarkup, substitutionContractReport, summarizeSubstitutionReport, summaryValue, svgCarriesTitle, traitEventRows, validMinorUnits, validateComponentIntakeDocument, vizControlFields, vizFieldValue, vizPreviewLayers, vizSummaryRows };