@oods/component-contracts 0.4.0 → 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", "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"];
+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" | "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>>;
+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"];
@@ -174,7 +183,7 @@ declare const SEVERITY_TONES: readonly ["positive", "success", "warning", "criti
  * 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 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>>;
@@ -305,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;
@@ -316,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;
 
@@ -1712,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: {
@@ -2201,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: {
@@ -3220,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, 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 };
+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 };

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", "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"];
+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" | "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>>;
+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"];
@@ -174,7 +183,7 @@ declare const SEVERITY_TONES: readonly ["positive", "success", "warning", "criti
  * 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 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>>;
@@ -305,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;
@@ -316,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;
 
@@ -1712,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: {
@@ -2201,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: {
@@ -3220,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, 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 };
+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 };