@oods/component-contracts 0.3.2 → 0.4.0

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", "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", "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. */
@@ -20,6 +20,12 @@ type ComponentContract = {
     id: GovernedComponentId;
     version: '1.0.0' | '1.1.0';
     props: readonly string[];
+    /**
+     * s221-m02 (#2482 ruling 5): saved-schema composition directives the React and Vue components accept, which code
+     * generation consumes (a field binding, a pattern's parts) and the component reads no value from; listed apart from
+     * the props a consumer passes.
+     */
+    directives?: readonly string[];
     /** Public props needed to name or identify a field; substitution must preserve them. */
     requiredProps?: readonly string[];
     slots: readonly string[];
@@ -80,7 +86,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" | "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" | "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"];
@@ -109,6 +115,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>>;
@@ -157,6 +168,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';
+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;
@@ -260,6 +329,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: {
@@ -1660,6 +1753,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: {
@@ -2155,6 +2290,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: {
@@ -3040,4 +3220,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 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, 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, getBannerToneTokenSet, getBaselineCapability, getStatusPresentation, getToneTokenSet, initialSort, isGovernedComponent, isVizIntentFragment, listStatuses, nextSort, parseBillingAmount, portedComponentContracts, portedScenarios, recipeItemLabels, recordCollectionEvents, relativeTimestampEmptyScenario, resolveStatusIcon, restartedBillingPeriod, sharedScenarios, statusIconMarkup, substitutionContractReport, summarizeSubstitutionReport, summaryValue, svgCarriesTitle, traitEventRows, validMinorUnits, validateComponentIntakeDocument, vizControlFields, vizFieldValue, vizPreviewLayers, vizSummaryRows };

package/dist/index.d.ts

@@ -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", "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", "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. */
@@ -20,6 +20,12 @@ type ComponentContract = {
     id: GovernedComponentId;
     version: '1.0.0' | '1.1.0';
     props: readonly string[];
+    /**
+     * s221-m02 (#2482 ruling 5): saved-schema composition directives the React and Vue components accept, which code
+     * generation consumes (a field binding, a pattern's parts) and the component reads no value from; listed apart from
+     * the props a consumer passes.
+     */
+    directives?: readonly string[];
     /** Public props needed to name or identify a field; substitution must preserve them. */
     requiredProps?: readonly string[];
     slots: readonly string[];
@@ -80,7 +86,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" | "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" | "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"];
@@ -109,6 +115,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>>;
@@ -157,6 +168,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';
+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;
@@ -260,6 +329,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: {
@@ -1660,6 +1753,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: {
@@ -2155,6 +2290,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: {
@@ -3040,4 +3220,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 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, 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, getBannerToneTokenSet, getBaselineCapability, getStatusPresentation, getToneTokenSet, initialSort, isGovernedComponent, isVizIntentFragment, listStatuses, nextSort, parseBillingAmount, portedComponentContracts, portedScenarios, recipeItemLabels, recordCollectionEvents, relativeTimestampEmptyScenario, resolveStatusIcon, restartedBillingPeriod, sharedScenarios, statusIconMarkup, substitutionContractReport, summarizeSubstitutionReport, summaryValue, svgCarriesTitle, traitEventRows, validMinorUnits, validateComponentIntakeDocument, vizControlFields, vizFieldValue, vizPreviewLayers, vizSummaryRows };