@brokui/brok-design-language 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,1192 @@
+export { themeMetadata, themePresets, type DesignTokenPath, type ThemeBrand, type ThemeMode, } from "./tokens.js";
+export interface InteractionContract {
+    readonly version: number;
+    readonly id: `IC-${number}`;
+    readonly slug: string;
+    readonly title: string;
+    readonly requirement: string;
+    readonly appliesTo: readonly string[];
+    readonly helpers: readonly string[];
+    readonly evidence: readonly string[];
+}
+export interface VisualAccessibilityCheck {
+    readonly criterion: string;
+    readonly level: "A" | "AA" | "AAA";
+    readonly name: string;
+    readonly applicability: "required" | "advisory" | "when-present" | "when-authentication-present";
+    readonly requirement: string;
+}
+export interface VisualPatternContract {
+    readonly version: number;
+    readonly id: `VC-${number}`;
+    readonly pattern: string;
+    readonly title: string;
+    readonly required: readonly string[];
+    readonly states: readonly string[];
+    readonly responsive: {
+        readonly mobile: string;
+        readonly desktop: string;
+    };
+    readonly interactionContractIds: readonly `IC-${number}`[];
+    readonly accessibility: {
+        readonly wcagTarget: "WCAG 2.2 AA";
+        readonly keyboardFlow: readonly string[];
+        readonly checks: readonly VisualAccessibilityCheck[];
+    };
+}
+export interface ComponentSemanticContract {
+    readonly version: number;
+    readonly id: `CS-${number}`;
+    readonly name: string;
+    readonly semanticRole: string;
+    readonly purpose: string;
+    readonly states: readonly string[];
+    readonly actions: readonly string[];
+    readonly interactionContractIds: readonly `IC-${number}`[];
+    readonly accessibilityRequirements: readonly string[];
+    readonly lifecycle: {
+        readonly status: "proposed" | "experimental" | "stable" | "deprecated" | "removed";
+        readonly owner: string;
+        readonly introducedIn: string;
+        readonly deprecatedIn: string | null;
+        readonly replacementId: `CS-${number}` | null;
+    };
+}
+export interface TelemetryContract {
+    readonly version: number;
+    readonly runtimeSchemaVersion: number;
+    readonly events: readonly string[];
+    readonly componentIdentity: {
+        readonly required: readonly string[];
+        readonly optional: readonly string[];
+    };
+    readonly outcomes: readonly string[];
+    readonly ratings: readonly string[];
+    readonly privacy: {
+        readonly prohibited: readonly string[];
+    };
+}
+export interface PlatformAdapterImplementation {
+    readonly name: string;
+    readonly runtime: "blade" | "livewire";
+    readonly primary: boolean;
+}
+export interface PlatformAdapterMapping {
+    readonly semanticContractId: `CS-${number}`;
+    readonly implementations: readonly PlatformAdapterImplementation[];
+}
+export declare const interactionContracts: {
+    readonly "IC-001": {
+        readonly version: 2;
+        readonly id: "IC-001";
+        readonly slug: "destructive-confirmation";
+        readonly title: "Confirm destructive actions";
+        readonly requirement: "Every destructive or hard-to-reverse action requires an explicit confirmation surface before the write starts.";
+        readonly appliesTo: readonly ["delete", "destroy", "remove", "revoke", "bulk destructive action"];
+        readonly helpers: readonly ["alert-dialog", "livewire-confirm"];
+        readonly evidence: readonly ["lint", "feature-test", "browser-test", "review-check"];
+    };
+    readonly "IC-002": {
+        readonly version: 2;
+        readonly id: "IC-002";
+        readonly slug: "async-feedback";
+        readonly title: "Expose async progress";
+        readonly requirement: "Every asynchronous action exposes a named loading state, blocks repeat activation, and leaves unrelated controls enabled.";
+        readonly appliesTo: readonly ["Livewire action", "form submit", "upload", "client request"];
+        readonly helpers: readonly ["button", "spinner"];
+        readonly evidence: readonly ["lint", "feature-test", "browser-test", "review-check"];
+    };
+    readonly "IC-003": {
+        readonly version: 2;
+        readonly id: "IC-003";
+        readonly slug: "overlay-focus-return";
+        readonly title: "Restore overlay focus";
+        readonly requirement: "An overlay that moves focus returns focus to its invoking control after every close path.";
+        readonly appliesTo: readonly ["modal", "alert dialog", "sheet", "drawer", "menu", "focus-moving popover"];
+        readonly helpers: readonly ["dialog", "alert-dialog", "sheet", "drawer", "popover", "dropdown"];
+        readonly evidence: readonly ["contract-test", "browser-test", "review-check"];
+    };
+    readonly "IC-004": {
+        readonly version: 2;
+        readonly id: "IC-004";
+        readonly slug: "server-validation";
+        readonly title: "Render server validation consistently";
+        readonly requirement: "A persisted form renders the server error summary, keeps submitted values, and associates each field error with its control.";
+        readonly appliesTo: readonly ["POST form", "PUT form", "PATCH form", "Livewire persisted form"];
+        readonly helpers: readonly ["form", "field", "input", "textarea", "select"];
+        readonly evidence: readonly ["lint", "feature-test", "browser-test", "review-check"];
+    };
+    readonly "IC-005": {
+        readonly version: 2;
+        readonly id: "IC-005";
+        readonly slug: "notification-lifecycle";
+        readonly title: "Use one notification lifecycle";
+        readonly requirement: "Notifications use the shared queue, urgency vocabulary, announcement behavior, timeout policy, manual dismissal, and timer cleanup.";
+        readonly appliesTo: readonly ["toast", "Livewire toast", "flash-to-toast bridge"];
+        readonly helpers: readonly ["toast", "livewire-toast"];
+        readonly evidence: readonly ["feature-test", "browser-test", "review-check"];
+    };
+    readonly "IC-006": {
+        readonly version: 2;
+        readonly id: "IC-006";
+        readonly slug: "table-states";
+        readonly title: "Use common table states";
+        readonly requirement: "Data tables use the shared announced loading row and actionable empty row while they keep the table shape stable.";
+        readonly appliesTo: readonly ["client data table", "server data table", "Livewire data table"];
+        readonly helpers: readonly ["table.state", "data-table", "livewire-data-table"];
+        readonly evidence: readonly ["contract-test", "browser-test", "review-check"];
+    };
+    readonly "IC-007": {
+        readonly version: 2;
+        readonly id: "IC-007";
+        readonly slug: "keyboard-navigation";
+        readonly title: "Support keyboard navigation";
+        readonly requirement: "Navigation uses native links and buttons or implements the complete keyboard model for its ARIA pattern.";
+        readonly appliesTo: readonly ["navigation", "menu", "tabs", "listbox", "command palette"];
+        readonly helpers: readonly ["navigation-menu", "menubar", "dropdown", "tabs", "command"];
+        readonly evidence: readonly ["lint", "contract-test", "browser-test", "review-check"];
+    };
+    readonly "IC-008": {
+        readonly version: 2;
+        readonly id: "IC-008";
+        readonly slug: "unsaved-changes";
+        readonly title: "Warn about unsaved changes";
+        readonly requirement: "A persisted form uses the shared dirty guard for document navigation and cancelable client-router navigation, then clears it only for a valid submit or explicit reset.";
+        readonly appliesTo: readonly ["create form", "edit form", "wizard", "settings form", "file selection"];
+        readonly helpers: readonly ["form.guard"];
+        readonly evidence: readonly ["lint", "feature-test", "browser-test", "review-check"];
+    };
+    readonly "IC-009": {
+        readonly version: 2;
+        readonly id: "IC-009";
+        readonly slug: "failed-request-recovery";
+        readonly title: "Recover from failed requests";
+        readonly requirement: "A failed, interrupted, timed-out, offline, or session-expired request preserves safe user input, removes the busy state, announces the failure, and offers a retry path.";
+        readonly appliesTo: readonly ["form submit", "Livewire action", "upload", "client request"];
+        readonly helpers: readonly ["form.guard", "button"];
+        readonly evidence: readonly ["feature-test", "browser-test", "review-check"];
+    };
+    readonly "IC-010": {
+        readonly version: 2;
+        readonly id: "IC-010";
+        readonly slug: "idempotent-writes";
+        readonly title: "Make repeat writes idempotent";
+        readonly requirement: "A retried create or side-effecting request uses a stable operation key or an equivalent database invariant so one user intent produces one durable effect.";
+        readonly appliesTo: readonly ["create request", "payment", "notification-producing action", "webhook"];
+        readonly helpers: readonly ["form", "server idempotency store"];
+        readonly evidence: readonly ["feature-test", "database-test", "review-check"];
+    };
+    readonly "IC-011": {
+        readonly version: 2;
+        readonly id: "IC-011";
+        readonly slug: "history-restoration";
+        readonly title: "Restore history navigation state";
+        readonly requirement: "Back, forward, and back-forward-cache restoration remove stale busy states and restore safe draft values without repeating a write.";
+        readonly appliesTo: readonly ["persisted form", "client router", "paginated view", "filter state"];
+        readonly helpers: readonly ["form.guard", "URL-backed state"];
+        readonly evidence: readonly ["browser-test", "review-check"];
+    };
+    readonly "IC-012": {
+        readonly version: 2;
+        readonly id: "IC-012";
+        readonly slug: "concurrent-edit-conflicts";
+        readonly title: "Detect concurrent edit conflicts";
+        readonly requirement: "An update sends the version that the user edited and the server rejects a stale version without overwriting the newer record.";
+        readonly appliesTo: readonly ["edit form", "settings update", "bulk edit", "stale browser tab"];
+        readonly helpers: readonly ["form", "server version check"];
+        readonly evidence: readonly ["feature-test", "database-test", "browser-test", "review-check"];
+    };
+    readonly "IC-013": {
+        readonly version: 2;
+        readonly id: "IC-013";
+        readonly slug: "javascript-fallback";
+        readonly title: "Honor the JavaScript fallback contract";
+        readonly requirement: "Each component has an explicit no-JavaScript classification, keeps meaningful server-rendered content, and supplies a native path or a clear unavailable-interaction message.";
+        readonly appliesTo: readonly ["Alpine component", "Livewire component", "client-rendered control"];
+        readonly helpers: readonly ["component API contract", "noscript fallback"];
+        readonly evidence: readonly ["contract-test", "browser-test", "review-check"];
+    };
+    readonly "IC-014": {
+        readonly version: 2;
+        readonly id: "IC-014";
+        readonly slug: "assistive-preferences";
+        readonly title: "Honor assistive technology preferences";
+        readonly requirement: "Interactive behavior keeps a screen-reader navigation path and honors reduced-motion preferences without removing status or focus feedback.";
+        readonly appliesTo: readonly ["interactive component", "animated component", "navigation", "form"];
+        readonly helpers: readonly ["semantic HTML", "motion tokens", "live region"];
+        readonly evidence: readonly ["accessibility-test", "browser-test", "manual-screen-reader-test", "review-check"];
+    };
+    readonly "IC-015": {
+        readonly version: 2;
+        readonly id: "IC-015";
+        readonly slug: "content-and-direction";
+        readonly title: "Support content expansion and direction";
+        readonly requirement: "Components keep actions and content usable with long translated text, unbroken values, narrow widths, and right-to-left document direction.";
+        readonly appliesTo: readonly ["text content", "localized label", "URL", "right-to-left locale"];
+        readonly helpers: readonly ["logical layout utilities", "showcase state matrix"];
+        readonly evidence: readonly ["contract-test", "browser-test", "visual-test", "review-check"];
+    };
+    readonly "IC-016": {
+        readonly version: 2;
+        readonly id: "IC-016";
+        readonly slug: "dataset-boundaries";
+        readonly title: "Define dataset boundaries";
+        readonly requirement: "A data component states its client-side row limit and uses server pagination beyond that limit while keeping query, memory, and pagination behavior bounded.";
+        readonly appliesTo: readonly ["table", "list", "search", "select", "activity feed"];
+        readonly helpers: readonly ["data-table", "livewire-data-table"];
+        readonly evidence: readonly ["feature-test", "performance-test", "browser-test", "review-check"];
+    };
+};
+export declare const visualPatternContracts: {
+    readonly "VC-001": {
+        readonly version: 1;
+        readonly id: "VC-001";
+        readonly pattern: "application-shell";
+        readonly title: "Application shell";
+        readonly required: readonly ["desktop sidebar", "top bar", "content outlet"];
+        readonly states: readonly ["sidebar collapsed", "mobile navigation open"];
+        readonly responsive: {
+            readonly mobile: "Use a disclosed navigation surface and one scrollable content column.";
+            readonly desktop: "Keep persistent navigation, global actions, and the content outlet in a stable frame.";
+        };
+        readonly interactionContractIds: readonly ["IC-003", "IC-007"];
+        readonly accessibility: {
+            readonly wcagTarget: "WCAG 2.2 AA";
+            readonly keyboardFlow: readonly ["Reach the skip link first.", "Move through global navigation before page actions.", "Return focus to the navigation trigger after the mobile surface closes."];
+            readonly checks: readonly [{
+                readonly criterion: "2.4.7";
+                readonly level: "AA";
+                readonly name: "Focus Visible";
+                readonly applicability: "required";
+                readonly requirement: "Every keyboard focus indicator is visible.";
+            }, {
+                readonly criterion: "2.4.11";
+                readonly level: "AA";
+                readonly name: "Focus Not Obscured (Minimum)";
+                readonly applicability: "required";
+                readonly requirement: "Sticky and overlay content does not fully hide the focused control.";
+            }, {
+                readonly criterion: "2.4.13";
+                readonly level: "AAA";
+                readonly name: "Focus Appearance";
+                readonly applicability: "advisory";
+                readonly requirement: "Prefer a focus indicator that also meets the WCAG 2.2 AAA area and contrast measure.";
+            }, {
+                readonly criterion: "2.5.7";
+                readonly level: "AA";
+                readonly name: "Dragging Movements";
+                readonly applicability: "when-present";
+                readonly requirement: "Every drag interaction has a non-dragging pointer and keyboard alternative.";
+            }, {
+                readonly criterion: "2.5.8";
+                readonly level: "AA";
+                readonly name: "Target Size (Minimum)";
+                readonly applicability: "required";
+                readonly requirement: "Targets meet the 24 by 24 CSS pixel minimum or the spacing exception.";
+            }, {
+                readonly criterion: "3.2.6";
+                readonly level: "A";
+                readonly name: "Consistent Help";
+                readonly applicability: "when-present";
+                readonly requirement: "Repeated help controls stay in the same relative order.";
+            }, {
+                readonly criterion: "3.3.8";
+                readonly level: "AA";
+                readonly name: "Accessible Authentication (Minimum)";
+                readonly applicability: "when-authentication-present";
+                readonly requirement: "Authentication does not require a cognitive function test unless an accessible alternative or support mechanism is available.";
+            }];
+        };
+    };
+    readonly "VC-002": {
+        readonly version: 1;
+        readonly id: "VC-002";
+        readonly pattern: "navigation";
+        readonly title: "Navigation";
+        readonly required: readonly ["desktop sidebar", "mobile navigation sheet", "breadcrumb"];
+        readonly states: readonly ["mobile navigation open"];
+        readonly responsive: {
+            readonly mobile: "Replace persistent navigation with a labelled disclosure or sheet.";
+            readonly desktop: "Expose the current location in persistent navigation.";
+        };
+        readonly interactionContractIds: readonly ["IC-003", "IC-007"];
+        readonly accessibility: {
+            readonly wcagTarget: "WCAG 2.2 AA";
+            readonly keyboardFlow: readonly ["Use native links for destinations.", "Expose the current destination without relying on color.", "Restore focus after a disclosed navigation surface closes."];
+            readonly checks: readonly [{
+                readonly criterion: "2.4.7";
+                readonly level: "AA";
+                readonly name: "Focus Visible";
+                readonly applicability: "required";
+                readonly requirement: "Every keyboard focus indicator is visible.";
+            }, {
+                readonly criterion: "2.4.11";
+                readonly level: "AA";
+                readonly name: "Focus Not Obscured (Minimum)";
+                readonly applicability: "required";
+                readonly requirement: "Sticky and overlay content does not fully hide the focused control.";
+            }, {
+                readonly criterion: "2.4.13";
+                readonly level: "AAA";
+                readonly name: "Focus Appearance";
+                readonly applicability: "advisory";
+                readonly requirement: "Prefer a focus indicator that also meets the WCAG 2.2 AAA area and contrast measure.";
+            }, {
+                readonly criterion: "2.5.7";
+                readonly level: "AA";
+                readonly name: "Dragging Movements";
+                readonly applicability: "when-present";
+                readonly requirement: "Every drag interaction has a non-dragging pointer and keyboard alternative.";
+            }, {
+                readonly criterion: "2.5.8";
+                readonly level: "AA";
+                readonly name: "Target Size (Minimum)";
+                readonly applicability: "required";
+                readonly requirement: "Targets meet the 24 by 24 CSS pixel minimum or the spacing exception.";
+            }, {
+                readonly criterion: "3.2.6";
+                readonly level: "A";
+                readonly name: "Consistent Help";
+                readonly applicability: "when-present";
+                readonly requirement: "Repeated help controls stay in the same relative order.";
+            }, {
+                readonly criterion: "3.3.8";
+                readonly level: "AA";
+                readonly name: "Accessible Authentication (Minimum)";
+                readonly applicability: "when-authentication-present";
+                readonly requirement: "Authentication does not require a cognitive function test unless an accessible alternative or support mechanism is available.";
+            }];
+        };
+    };
+    readonly "VC-003": {
+        readonly version: 1;
+        readonly id: "VC-003";
+        readonly pattern: "page-header";
+        readonly title: "Page header";
+        readonly required: readonly ["heading", "query-controls", "primary-action"];
+        readonly states: readonly ["unfiltered", "filtered"];
+        readonly responsive: {
+            readonly mobile: "Stack context, controls, and the primary action in reading order.";
+            readonly desktop: "Keep context and the primary action visually distinct in one header region.";
+        };
+        readonly interactionContractIds: readonly ["IC-002", "IC-007"];
+        readonly accessibility: {
+            readonly wcagTarget: "WCAG 2.2 AA";
+            readonly keyboardFlow: readonly ["Reach the page heading before page controls.", "Keep the primary action after its explanatory context."];
+            readonly checks: readonly [{
+                readonly criterion: "2.4.7";
+                readonly level: "AA";
+                readonly name: "Focus Visible";
+                readonly applicability: "required";
+                readonly requirement: "Every keyboard focus indicator is visible.";
+            }, {
+                readonly criterion: "2.4.11";
+                readonly level: "AA";
+                readonly name: "Focus Not Obscured (Minimum)";
+                readonly applicability: "required";
+                readonly requirement: "Sticky and overlay content does not fully hide the focused control.";
+            }, {
+                readonly criterion: "2.4.13";
+                readonly level: "AAA";
+                readonly name: "Focus Appearance";
+                readonly applicability: "advisory";
+                readonly requirement: "Prefer a focus indicator that also meets the WCAG 2.2 AAA area and contrast measure.";
+            }, {
+                readonly criterion: "2.5.7";
+                readonly level: "AA";
+                readonly name: "Dragging Movements";
+                readonly applicability: "when-present";
+                readonly requirement: "Every drag interaction has a non-dragging pointer and keyboard alternative.";
+            }, {
+                readonly criterion: "2.5.8";
+                readonly level: "AA";
+                readonly name: "Target Size (Minimum)";
+                readonly applicability: "required";
+                readonly requirement: "Targets meet the 24 by 24 CSS pixel minimum or the spacing exception.";
+            }, {
+                readonly criterion: "3.2.6";
+                readonly level: "A";
+                readonly name: "Consistent Help";
+                readonly applicability: "when-present";
+                readonly requirement: "Repeated help controls stay in the same relative order.";
+            }, {
+                readonly criterion: "3.3.8";
+                readonly level: "AA";
+                readonly name: "Accessible Authentication (Minimum)";
+                readonly applicability: "when-authentication-present";
+                readonly requirement: "Authentication does not require a cognitive function test unless an accessible alternative or support mechanism is available.";
+            }];
+        };
+    };
+    readonly "VC-004": {
+        readonly version: 1;
+        readonly id: "VC-004";
+        readonly pattern: "form";
+        readonly title: "Form";
+        readonly required: readonly ["heading", "fields", "form-actions"];
+        readonly states: readonly ["submitting", "validation-error", "success"];
+        readonly responsive: {
+            readonly mobile: "Use one field column and keep actions in source order.";
+            readonly desktop: "Use multiple columns only when field relationships stay clear.";
+        };
+        readonly interactionContractIds: readonly ["IC-002", "IC-004", "IC-008"];
+        readonly accessibility: {
+            readonly wcagTarget: "WCAG 2.2 AA";
+            readonly keyboardFlow: readonly ["Move from the form heading to the error summary and then to fields.", "Associate every error with its control.", "Keep submit feedback announced and focusable."];
+            readonly checks: readonly [{
+                readonly criterion: "2.4.7";
+                readonly level: "AA";
+                readonly name: "Focus Visible";
+                readonly applicability: "required";
+                readonly requirement: "Every keyboard focus indicator is visible.";
+            }, {
+                readonly criterion: "2.4.11";
+                readonly level: "AA";
+                readonly name: "Focus Not Obscured (Minimum)";
+                readonly applicability: "required";
+                readonly requirement: "Sticky and overlay content does not fully hide the focused control.";
+            }, {
+                readonly criterion: "2.4.13";
+                readonly level: "AAA";
+                readonly name: "Focus Appearance";
+                readonly applicability: "advisory";
+                readonly requirement: "Prefer a focus indicator that also meets the WCAG 2.2 AAA area and contrast measure.";
+            }, {
+                readonly criterion: "2.5.7";
+                readonly level: "AA";
+                readonly name: "Dragging Movements";
+                readonly applicability: "when-present";
+                readonly requirement: "Every drag interaction has a non-dragging pointer and keyboard alternative.";
+            }, {
+                readonly criterion: "2.5.8";
+                readonly level: "AA";
+                readonly name: "Target Size (Minimum)";
+                readonly applicability: "required";
+                readonly requirement: "Targets meet the 24 by 24 CSS pixel minimum or the spacing exception.";
+            }, {
+                readonly criterion: "3.2.6";
+                readonly level: "A";
+                readonly name: "Consistent Help";
+                readonly applicability: "when-present";
+                readonly requirement: "Repeated help controls stay in the same relative order.";
+            }, {
+                readonly criterion: "3.3.8";
+                readonly level: "AA";
+                readonly name: "Accessible Authentication (Minimum)";
+                readonly applicability: "when-authentication-present";
+                readonly requirement: "Authentication does not require a cognitive function test unless an accessible alternative or support mechanism is available.";
+            }];
+        };
+    };
+    readonly "VC-005": {
+        readonly version: 1;
+        readonly id: "VC-005";
+        readonly pattern: "table";
+        readonly title: "Table";
+        readonly required: readonly ["query-toolbar", "data-table", "pagination"];
+        readonly states: readonly ["populated", "empty", "selected"];
+        readonly responsive: {
+            readonly mobile: "Keep header and cell relationships intact in a labelled scroll region.";
+            readonly desktop: "Keep query, selection, table, and pagination controls in a predictable order.";
+        };
+        readonly interactionContractIds: readonly ["IC-001", "IC-002", "IC-006", "IC-007"];
+        readonly accessibility: {
+            readonly wcagTarget: "WCAG 2.2 AA";
+            readonly keyboardFlow: readonly ["Reach query controls before table content.", "Keep row actions keyboard operable.", "Announce loading, empty, and selection changes."];
+            readonly checks: readonly [{
+                readonly criterion: "2.4.7";
+                readonly level: "AA";
+                readonly name: "Focus Visible";
+                readonly applicability: "required";
+                readonly requirement: "Every keyboard focus indicator is visible.";
+            }, {
+                readonly criterion: "2.4.11";
+                readonly level: "AA";
+                readonly name: "Focus Not Obscured (Minimum)";
+                readonly applicability: "required";
+                readonly requirement: "Sticky and overlay content does not fully hide the focused control.";
+            }, {
+                readonly criterion: "2.4.13";
+                readonly level: "AAA";
+                readonly name: "Focus Appearance";
+                readonly applicability: "advisory";
+                readonly requirement: "Prefer a focus indicator that also meets the WCAG 2.2 AAA area and contrast measure.";
+            }, {
+                readonly criterion: "2.5.7";
+                readonly level: "AA";
+                readonly name: "Dragging Movements";
+                readonly applicability: "when-present";
+                readonly requirement: "Every drag interaction has a non-dragging pointer and keyboard alternative.";
+            }, {
+                readonly criterion: "2.5.8";
+                readonly level: "AA";
+                readonly name: "Target Size (Minimum)";
+                readonly applicability: "required";
+                readonly requirement: "Targets meet the 24 by 24 CSS pixel minimum or the spacing exception.";
+            }, {
+                readonly criterion: "3.2.6";
+                readonly level: "A";
+                readonly name: "Consistent Help";
+                readonly applicability: "when-present";
+                readonly requirement: "Repeated help controls stay in the same relative order.";
+            }, {
+                readonly criterion: "3.3.8";
+                readonly level: "AA";
+                readonly name: "Accessible Authentication (Minimum)";
+                readonly applicability: "when-authentication-present";
+                readonly requirement: "Authentication does not require a cognitive function test unless an accessible alternative or support mechanism is available.";
+            }];
+        };
+    };
+    readonly "VC-006": {
+        readonly version: 1;
+        readonly id: "VC-006";
+        readonly pattern: "detail-page";
+        readonly title: "Detail page";
+        readonly required: readonly ["breadcrumb", "page-header", "overview", "related-content"];
+        readonly states: readonly ["populated", "empty-activity"];
+        readonly responsive: {
+            readonly mobile: "Use one reading column and keep key actions near the heading.";
+            readonly desktop: "Separate primary details from related and historical content.";
+        };
+        readonly interactionContractIds: readonly ["IC-001", "IC-002", "IC-007"];
+        readonly accessibility: {
+            readonly wcagTarget: "WCAG 2.2 AA";
+            readonly keyboardFlow: readonly ["Reach the breadcrumb and page heading before record actions.", "Keep related content after the primary record details."];
+            readonly checks: readonly [{
+                readonly criterion: "2.4.7";
+                readonly level: "AA";
+                readonly name: "Focus Visible";
+                readonly applicability: "required";
+                readonly requirement: "Every keyboard focus indicator is visible.";
+            }, {
+                readonly criterion: "2.4.11";
+                readonly level: "AA";
+                readonly name: "Focus Not Obscured (Minimum)";
+                readonly applicability: "required";
+                readonly requirement: "Sticky and overlay content does not fully hide the focused control.";
+            }, {
+                readonly criterion: "2.4.13";
+                readonly level: "AAA";
+                readonly name: "Focus Appearance";
+                readonly applicability: "advisory";
+                readonly requirement: "Prefer a focus indicator that also meets the WCAG 2.2 AAA area and contrast measure.";
+            }, {
+                readonly criterion: "2.5.7";
+                readonly level: "AA";
+                readonly name: "Dragging Movements";
+                readonly applicability: "when-present";
+                readonly requirement: "Every drag interaction has a non-dragging pointer and keyboard alternative.";
+            }, {
+                readonly criterion: "2.5.8";
+                readonly level: "AA";
+                readonly name: "Target Size (Minimum)";
+                readonly applicability: "required";
+                readonly requirement: "Targets meet the 24 by 24 CSS pixel minimum or the spacing exception.";
+            }, {
+                readonly criterion: "3.2.6";
+                readonly level: "A";
+                readonly name: "Consistent Help";
+                readonly applicability: "when-present";
+                readonly requirement: "Repeated help controls stay in the same relative order.";
+            }, {
+                readonly criterion: "3.3.8";
+                readonly level: "AA";
+                readonly name: "Accessible Authentication (Minimum)";
+                readonly applicability: "when-authentication-present";
+                readonly requirement: "Authentication does not require a cognitive function test unless an accessible alternative or support mechanism is available.";
+            }];
+        };
+    };
+    readonly "VC-007": {
+        readonly version: 1;
+        readonly id: "VC-007";
+        readonly pattern: "dashboard";
+        readonly title: "Dashboard";
+        readonly required: readonly ["welcome header", "quick actions", "KPI grid", "sales chart", "recent invoices table"];
+        readonly states: readonly ["default", "empty metrics", "loading chart", "empty invoices"];
+        readonly responsive: {
+            readonly mobile: "Stack summary, actions, charts, and tables in task order.";
+            readonly desktop: "Use a stable grid without changing the semantic reading order.";
+        };
+        readonly interactionContractIds: readonly ["IC-002", "IC-006", "IC-007"];
+        readonly accessibility: {
+            readonly wcagTarget: "WCAG 2.2 AA";
+            readonly keyboardFlow: readonly ["Reach the page summary before quick actions.", "Provide a text equivalent for every chart.", "Keep table controls next to their table."];
+            readonly checks: readonly [{
+                readonly criterion: "2.4.7";
+                readonly level: "AA";
+                readonly name: "Focus Visible";
+                readonly applicability: "required";
+                readonly requirement: "Every keyboard focus indicator is visible.";
+            }, {
+                readonly criterion: "2.4.11";
+                readonly level: "AA";
+                readonly name: "Focus Not Obscured (Minimum)";
+                readonly applicability: "required";
+                readonly requirement: "Sticky and overlay content does not fully hide the focused control.";
+            }, {
+                readonly criterion: "2.4.13";
+                readonly level: "AAA";
+                readonly name: "Focus Appearance";
+                readonly applicability: "advisory";
+                readonly requirement: "Prefer a focus indicator that also meets the WCAG 2.2 AAA area and contrast measure.";
+            }, {
+                readonly criterion: "2.5.7";
+                readonly level: "AA";
+                readonly name: "Dragging Movements";
+                readonly applicability: "when-present";
+                readonly requirement: "Every drag interaction has a non-dragging pointer and keyboard alternative.";
+            }, {
+                readonly criterion: "2.5.8";
+                readonly level: "AA";
+                readonly name: "Target Size (Minimum)";
+                readonly applicability: "required";
+                readonly requirement: "Targets meet the 24 by 24 CSS pixel minimum or the spacing exception.";
+            }, {
+                readonly criterion: "3.2.6";
+                readonly level: "A";
+                readonly name: "Consistent Help";
+                readonly applicability: "when-present";
+                readonly requirement: "Repeated help controls stay in the same relative order.";
+            }, {
+                readonly criterion: "3.3.8";
+                readonly level: "AA";
+                readonly name: "Accessible Authentication (Minimum)";
+                readonly applicability: "when-authentication-present";
+                readonly requirement: "Authentication does not require a cognitive function test unless an accessible alternative or support mechanism is available.";
+            }];
+        };
+    };
+    readonly "VC-008": {
+        readonly version: 1;
+        readonly id: "VC-008";
+        readonly pattern: "notifications";
+        readonly title: "Notifications";
+        readonly required: readonly ["filters", "notification-list", "pagination"];
+        readonly states: readonly ["populated", "empty", "unread-filter"];
+        readonly responsive: {
+            readonly mobile: "Stack filters and keep each notification action next to its message.";
+            readonly desktop: "Keep filters, status, messages, and actions in a stable reading order.";
+        };
+        readonly interactionContractIds: readonly ["IC-002", "IC-005", "IC-007"];
+        readonly accessibility: {
+            readonly wcagTarget: "WCAG 2.2 AA";
+            readonly keyboardFlow: readonly ["Reach filters before messages.", "Announce unread and read-state changes.", "Keep dismissal and destination actions independently named."];
+            readonly checks: readonly [{
+                readonly criterion: "2.4.7";
+                readonly level: "AA";
+                readonly name: "Focus Visible";
+                readonly applicability: "required";
+                readonly requirement: "Every keyboard focus indicator is visible.";
+            }, {
+                readonly criterion: "2.4.11";
+                readonly level: "AA";
+                readonly name: "Focus Not Obscured (Minimum)";
+                readonly applicability: "required";
+                readonly requirement: "Sticky and overlay content does not fully hide the focused control.";
+            }, {
+                readonly criterion: "2.4.13";
+                readonly level: "AAA";
+                readonly name: "Focus Appearance";
+                readonly applicability: "advisory";
+                readonly requirement: "Prefer a focus indicator that also meets the WCAG 2.2 AAA area and contrast measure.";
+            }, {
+                readonly criterion: "2.5.7";
+                readonly level: "AA";
+                readonly name: "Dragging Movements";
+                readonly applicability: "when-present";
+                readonly requirement: "Every drag interaction has a non-dragging pointer and keyboard alternative.";
+            }, {
+                readonly criterion: "2.5.8";
+                readonly level: "AA";
+                readonly name: "Target Size (Minimum)";
+                readonly applicability: "required";
+                readonly requirement: "Targets meet the 24 by 24 CSS pixel minimum or the spacing exception.";
+            }, {
+                readonly criterion: "3.2.6";
+                readonly level: "A";
+                readonly name: "Consistent Help";
+                readonly applicability: "when-present";
+                readonly requirement: "Repeated help controls stay in the same relative order.";
+            }, {
+                readonly criterion: "3.3.8";
+                readonly level: "AA";
+                readonly name: "Accessible Authentication (Minimum)";
+                readonly applicability: "when-authentication-present";
+                readonly requirement: "Authentication does not require a cognitive function test unless an accessible alternative or support mechanism is available.";
+            }];
+        };
+    };
+    readonly "VC-009": {
+        readonly version: 1;
+        readonly id: "VC-009";
+        readonly pattern: "empty-error-states";
+        readonly title: "Empty and error states";
+        readonly required: readonly ["state-heading", "state-body", "recovery-action", "ready-content"];
+        readonly states: readonly ["loading", "empty", "error", "ready"];
+        readonly responsive: {
+            readonly mobile: "Keep the state message and recovery action in one narrow column.";
+            readonly desktop: "Keep state feedback close to the content region that it replaces.";
+        };
+        readonly interactionContractIds: readonly ["IC-002", "IC-007"];
+        readonly accessibility: {
+            readonly wcagTarget: "WCAG 2.2 AA";
+            readonly keyboardFlow: readonly ["Announce state changes without an unexpected focus move.", "Place the recovery action after the error explanation."];
+            readonly checks: readonly [{
+                readonly criterion: "2.4.7";
+                readonly level: "AA";
+                readonly name: "Focus Visible";
+                readonly applicability: "required";
+                readonly requirement: "Every keyboard focus indicator is visible.";
+            }, {
+                readonly criterion: "2.4.11";
+                readonly level: "AA";
+                readonly name: "Focus Not Obscured (Minimum)";
+                readonly applicability: "required";
+                readonly requirement: "Sticky and overlay content does not fully hide the focused control.";
+            }, {
+                readonly criterion: "2.4.13";
+                readonly level: "AAA";
+                readonly name: "Focus Appearance";
+                readonly applicability: "advisory";
+                readonly requirement: "Prefer a focus indicator that also meets the WCAG 2.2 AAA area and contrast measure.";
+            }, {
+                readonly criterion: "2.5.7";
+                readonly level: "AA";
+                readonly name: "Dragging Movements";
+                readonly applicability: "when-present";
+                readonly requirement: "Every drag interaction has a non-dragging pointer and keyboard alternative.";
+            }, {
+                readonly criterion: "2.5.8";
+                readonly level: "AA";
+                readonly name: "Target Size (Minimum)";
+                readonly applicability: "required";
+                readonly requirement: "Targets meet the 24 by 24 CSS pixel minimum or the spacing exception.";
+            }, {
+                readonly criterion: "3.2.6";
+                readonly level: "A";
+                readonly name: "Consistent Help";
+                readonly applicability: "when-present";
+                readonly requirement: "Repeated help controls stay in the same relative order.";
+            }, {
+                readonly criterion: "3.3.8";
+                readonly level: "AA";
+                readonly name: "Accessible Authentication (Minimum)";
+                readonly applicability: "when-authentication-present";
+                readonly requirement: "Authentication does not require a cognitive function test unless an accessible alternative or support mechanism is available.";
+            }];
+        };
+    };
+    readonly "VC-010": {
+        readonly version: 1;
+        readonly id: "VC-010";
+        readonly pattern: "settings-page";
+        readonly title: "Settings page";
+        readonly required: readonly ["heading", "section-navigation", "feedback", "settings-sections"];
+        readonly states: readonly ["dirty", "submitting", "validation-error", "success"];
+        readonly responsive: {
+            readonly mobile: "Stack section navigation, feedback, and form sections.";
+            readonly desktop: "Use section navigation beside one readable form column.";
+        };
+        readonly interactionContractIds: readonly ["IC-002", "IC-004", "IC-007", "IC-008"];
+        readonly accessibility: {
+            readonly wcagTarget: "WCAG 2.2 AA";
+            readonly keyboardFlow: readonly ["Reach the page title and section navigation before settings fields.", "Move validation focus to the error summary or first invalid field.", "Announce saved feedback without removing focus."];
+            readonly checks: readonly [{
+                readonly criterion: "2.4.7";
+                readonly level: "AA";
+                readonly name: "Focus Visible";
+                readonly applicability: "required";
+                readonly requirement: "Every keyboard focus indicator is visible.";
+            }, {
+                readonly criterion: "2.4.11";
+                readonly level: "AA";
+                readonly name: "Focus Not Obscured (Minimum)";
+                readonly applicability: "required";
+                readonly requirement: "Sticky and overlay content does not fully hide the focused control.";
+            }, {
+                readonly criterion: "2.4.13";
+                readonly level: "AAA";
+                readonly name: "Focus Appearance";
+                readonly applicability: "advisory";
+                readonly requirement: "Prefer a focus indicator that also meets the WCAG 2.2 AAA area and contrast measure.";
+            }, {
+                readonly criterion: "2.5.7";
+                readonly level: "AA";
+                readonly name: "Dragging Movements";
+                readonly applicability: "when-present";
+                readonly requirement: "Every drag interaction has a non-dragging pointer and keyboard alternative.";
+            }, {
+                readonly criterion: "2.5.8";
+                readonly level: "AA";
+                readonly name: "Target Size (Minimum)";
+                readonly applicability: "required";
+                readonly requirement: "Targets meet the 24 by 24 CSS pixel minimum or the spacing exception.";
+            }, {
+                readonly criterion: "3.2.6";
+                readonly level: "A";
+                readonly name: "Consistent Help";
+                readonly applicability: "when-present";
+                readonly requirement: "Repeated help controls stay in the same relative order.";
+            }, {
+                readonly criterion: "3.3.8";
+                readonly level: "AA";
+                readonly name: "Accessible Authentication (Minimum)";
+                readonly applicability: "when-authentication-present";
+                readonly requirement: "Authentication does not require a cognitive function test unless an accessible alternative or support mechanism is available.";
+            }];
+        };
+    };
+};
+export declare const componentSemantics: {
+    readonly button: {
+        readonly version: 2;
+        readonly id: "CS-001";
+        readonly name: "button";
+        readonly semanticRole: "action";
+        readonly purpose: "Start an immediate action or follow a destination with explicit button or link semantics.";
+        readonly states: readonly ["enabled", "disabled", "loading"];
+        readonly actions: readonly ["activate"];
+        readonly interactionContractIds: readonly ["IC-002", "IC-007"];
+        readonly accessibilityRequirements: readonly ["Expose an accessible name.", "Preserve native activation semantics.", "Expose disabled and busy state without color alone."];
+        readonly lifecycle: {
+            readonly status: "stable";
+            readonly owner: "platform-ui";
+            readonly introducedIn: "1.0.0";
+            readonly deprecatedIn: null;
+            readonly replacementId: null;
+        };
+    };
+    readonly "text-input": {
+        readonly version: 2;
+        readonly id: "CS-002";
+        readonly name: "text-input";
+        readonly semanticRole: "text-entry";
+        readonly purpose: "Collect one bounded text value with a persistent label and validation relationship.";
+        readonly states: readonly ["empty", "filled", "disabled", "read-only", "invalid"];
+        readonly actions: readonly ["focus", "edit", "clear"];
+        readonly interactionContractIds: readonly ["IC-004", "IC-007"];
+        readonly accessibilityRequirements: readonly ["Expose a persistent accessible label.", "Associate help and error text with the field.", "Expose invalid, required, disabled, and read-only state programmatically."];
+        readonly lifecycle: {
+            readonly status: "stable";
+            readonly owner: "platform-ui";
+            readonly introducedIn: "1.0.0";
+            readonly deprecatedIn: null;
+            readonly replacementId: null;
+        };
+    };
+    readonly checkbox: {
+        readonly version: 2;
+        readonly id: "CS-003";
+        readonly name: "checkbox";
+        readonly semanticRole: "independent-selection";
+        readonly purpose: "Select zero or more independent options or acknowledge one boolean value.";
+        readonly states: readonly ["unchecked", "checked", "mixed", "disabled", "invalid"];
+        readonly actions: readonly ["toggle"];
+        readonly interactionContractIds: readonly ["IC-004", "IC-007"];
+        readonly accessibilityRequirements: readonly ["Expose checked or mixed state programmatically.", "Keep the label inside the activation target when possible."];
+        readonly lifecycle: {
+            readonly status: "stable";
+            readonly owner: "platform-ui";
+            readonly introducedIn: "1.0.0";
+            readonly deprecatedIn: null;
+            readonly replacementId: null;
+        };
+    };
+    readonly "radio-group": {
+        readonly version: 2;
+        readonly id: "CS-004";
+        readonly name: "radio-group";
+        readonly semanticRole: "exclusive-selection";
+        readonly purpose: "Choose exactly one value from a small visible set.";
+        readonly states: readonly ["unselected", "selected", "disabled", "invalid"];
+        readonly actions: readonly ["select", "move-next", "move-previous"];
+        readonly interactionContractIds: readonly ["IC-004", "IC-007"];
+        readonly accessibilityRequirements: readonly ["Expose one group label.", "Expose each option label and selected state.", "Support the platform radio-group keyboard model."];
+        readonly lifecycle: {
+            readonly status: "stable";
+            readonly owner: "platform-ui";
+            readonly introducedIn: "1.0.0";
+            readonly deprecatedIn: null;
+            readonly replacementId: null;
+        };
+    };
+    readonly switch: {
+        readonly version: 2;
+        readonly id: "CS-005";
+        readonly name: "switch";
+        readonly semanticRole: "immediate-setting";
+        readonly purpose: "Change one setting that takes effect immediately.";
+        readonly states: readonly ["off", "on", "disabled", "loading"];
+        readonly actions: readonly ["toggle"];
+        readonly interactionContractIds: readonly ["IC-002", "IC-007"];
+        readonly accessibilityRequirements: readonly ["Expose the current on or off state.", "Use a stable label that does not change with state."];
+        readonly lifecycle: {
+            readonly status: "stable";
+            readonly owner: "platform-ui";
+            readonly introducedIn: "1.0.0";
+            readonly deprecatedIn: null;
+            readonly replacementId: null;
+        };
+    };
+    readonly select: {
+        readonly version: 2;
+        readonly id: "CS-006";
+        readonly name: "select";
+        readonly semanticRole: "constrained-selection";
+        readonly purpose: "Choose one value from a bounded option set when showing every option at once is not suitable.";
+        readonly states: readonly ["closed", "open", "selected", "disabled", "invalid", "empty"];
+        readonly actions: readonly ["open", "close", "select", "move-next", "move-previous"];
+        readonly interactionContractIds: readonly ["IC-003", "IC-004", "IC-007"];
+        readonly accessibilityRequirements: readonly ["Expose a label, selected value, and expanded state.", "Keep the complete option keyboard model.", "Restore focus after the option surface closes."];
+        readonly lifecycle: {
+            readonly status: "stable";
+            readonly owner: "platform-ui";
+            readonly introducedIn: "1.0.0";
+            readonly deprecatedIn: null;
+            readonly replacementId: null;
+        };
+    };
+    readonly dialog: {
+        readonly version: 2;
+        readonly id: "CS-007";
+        readonly name: "dialog";
+        readonly semanticRole: "modal-task";
+        readonly purpose: "Temporarily contain one focused task that requires context from the current surface.";
+        readonly states: readonly ["closed", "opening", "open", "closing"];
+        readonly actions: readonly ["open", "close", "confirm", "cancel"];
+        readonly interactionContractIds: readonly ["IC-003", "IC-007"];
+        readonly accessibilityRequirements: readonly ["Expose a dialog name.", "Trap focus while modal.", "Close with Escape when dismissal is allowed.", "Restore focus to the invoking control."];
+        readonly lifecycle: {
+            readonly status: "stable";
+            readonly owner: "platform-ui";
+            readonly introducedIn: "1.0.0";
+            readonly deprecatedIn: null;
+            readonly replacementId: null;
+        };
+    };
+    readonly "alert-dialog": {
+        readonly version: 2;
+        readonly id: "CS-008";
+        readonly name: "alert-dialog";
+        readonly semanticRole: "critical-confirmation";
+        readonly purpose: "Require an explicit decision before a destructive or hard-to-reverse action.";
+        readonly states: readonly ["closed", "open", "submitting", "failed"];
+        readonly actions: readonly ["open", "confirm", "cancel"];
+        readonly interactionContractIds: readonly ["IC-001", "IC-002", "IC-003", "IC-007"];
+        readonly accessibilityRequirements: readonly ["Expose a clear consequence in the name or description.", "Place initial focus on the safest suitable action.", "Restore focus after cancellation or completion."];
+        readonly lifecycle: {
+            readonly status: "stable";
+            readonly owner: "platform-ui";
+            readonly introducedIn: "1.0.0";
+            readonly deprecatedIn: null;
+            readonly replacementId: null;
+        };
+    };
+    readonly tabs: {
+        readonly version: 2;
+        readonly id: "CS-009";
+        readonly name: "tabs";
+        readonly semanticRole: "view-selection";
+        readonly purpose: "Switch between peer content views without changing the page context.";
+        readonly states: readonly ["selected", "unselected", "disabled"];
+        readonly actions: readonly ["select", "move-next", "move-previous", "move-first", "move-last"];
+        readonly interactionContractIds: readonly ["IC-007"];
+        readonly accessibilityRequirements: readonly ["Associate each tab with one panel.", "Expose selected state.", "Support the platform tab keyboard model."];
+        readonly lifecycle: {
+            readonly status: "stable";
+            readonly owner: "platform-ui";
+            readonly introducedIn: "1.0.0";
+            readonly deprecatedIn: null;
+            readonly replacementId: null;
+        };
+    };
+    readonly form: {
+        readonly version: 2;
+        readonly id: "CS-010";
+        readonly name: "form";
+        readonly semanticRole: "data-submission";
+        readonly purpose: "Collect, validate, and submit a related set of values to a server-owned boundary.";
+        readonly states: readonly ["pristine", "dirty", "submitting", "invalid", "succeeded", "failed"];
+        readonly actions: readonly ["edit", "submit", "reset", "leave"];
+        readonly interactionContractIds: readonly ["IC-002", "IC-004", "IC-008"];
+        readonly accessibilityRequirements: readonly ["Use persistent labels and associated errors.", "Expose a server error summary.", "Announce submission progress and result.", "Warn before losing dirty values."];
+        readonly lifecycle: {
+            readonly status: "stable";
+            readonly owner: "platform-ui";
+            readonly introducedIn: "1.0.0";
+            readonly deprecatedIn: null;
+            readonly replacementId: null;
+        };
+    };
+    readonly "data-table": {
+        readonly version: 2;
+        readonly id: "CS-011";
+        readonly name: "data-table";
+        readonly semanticRole: "tabular-data-exploration";
+        readonly purpose: "Inspect and act on structured records while preserving row and column relationships.";
+        readonly states: readonly ["loading", "populated", "empty", "filtered-empty", "selected", "failed"];
+        readonly actions: readonly ["sort", "filter", "select", "paginate", "activate-row-action"];
+        readonly interactionContractIds: readonly ["IC-002", "IC-006", "IC-007"];
+        readonly accessibilityRequirements: readonly ["Preserve row and column relationships.", "Name sorting, filtering, selection, and row actions.", "Announce loading and empty states.", "Keep a non-dragging alternative for reordering."];
+        readonly lifecycle: {
+            readonly status: "stable";
+            readonly owner: "platform-ui";
+            readonly introducedIn: "1.0.0";
+            readonly deprecatedIn: null;
+            readonly replacementId: null;
+        };
+    };
+};
+export declare const telemetryContract: {
+    readonly version: 1;
+    readonly runtimeSchemaVersion: 2;
+    readonly events: readonly ["accessibility.journey", "client.exception", "component.bundle", "component.exposure", "component.state", "form.abandonment", "form.attempt", "form.submit", "form.validation", "interaction", "livewire.dom-update", "livewire.request", "network.summary", "runtime.init", "server.request", "web-vital"];
+    readonly componentIdentity: {
+        readonly required: readonly ["implementationName", "adapter", "designLanguageRelease"];
+        readonly optional: readonly ["semanticComponentId"];
+    };
+    readonly outcomes: readonly ["success", "failure", "abandoned", "observed"];
+    readonly ratings: readonly ["good", "needs-improvement", "poor"];
+    readonly privacy: {
+        readonly prohibited: readonly ["field values", "user identifiers", "email addresses", "full URLs", "stack traces"];
+    };
+};
+export declare const laravelPlatformAdapter: {
+    readonly version: 1;
+    readonly adapterVersion: "0.1.0";
+    readonly mappings: readonly [{
+        readonly semanticContractId: "CS-001";
+        readonly implementations: readonly [{
+            readonly name: "button";
+            readonly runtime: "blade";
+            readonly primary: true;
+        }];
+    }, {
+        readonly semanticContractId: "CS-002";
+        readonly implementations: readonly [{
+            readonly name: "input";
+            readonly runtime: "blade";
+            readonly primary: true;
+        }];
+    }, {
+        readonly semanticContractId: "CS-003";
+        readonly implementations: readonly [{
+            readonly name: "checkbox";
+            readonly runtime: "blade";
+            readonly primary: true;
+        }];
+    }, {
+        readonly semanticContractId: "CS-004";
+        readonly implementations: readonly [{
+            readonly name: "radio";
+            readonly runtime: "blade";
+            readonly primary: true;
+        }];
+    }, {
+        readonly semanticContractId: "CS-005";
+        readonly implementations: readonly [{
+            readonly name: "switch";
+            readonly runtime: "blade";
+            readonly primary: true;
+        }];
+    }, {
+        readonly semanticContractId: "CS-006";
+        readonly implementations: readonly [{
+            readonly name: "select";
+            readonly runtime: "blade";
+            readonly primary: true;
+        }];
+    }, {
+        readonly semanticContractId: "CS-007";
+        readonly implementations: readonly [{
+            readonly name: "dialog";
+            readonly runtime: "blade";
+            readonly primary: true;
+        }, {
+            readonly name: "livewire-modal";
+            readonly runtime: "livewire";
+            readonly primary: false;
+        }];
+    }, {
+        readonly semanticContractId: "CS-008";
+        readonly implementations: readonly [{
+            readonly name: "alert-dialog";
+            readonly runtime: "blade";
+            readonly primary: true;
+        }, {
+            readonly name: "livewire-confirm";
+            readonly runtime: "livewire";
+            readonly primary: false;
+        }];
+    }, {
+        readonly semanticContractId: "CS-009";
+        readonly implementations: readonly [{
+            readonly name: "tabs";
+            readonly runtime: "blade";
+            readonly primary: true;
+        }, {
+            readonly name: "livewire-tabs";
+            readonly runtime: "livewire";
+            readonly primary: false;
+        }];
+    }, {
+        readonly semanticContractId: "CS-010";
+        readonly implementations: readonly [{
+            readonly name: "form";
+            readonly runtime: "blade";
+            readonly primary: true;
+        }];
+    }, {
+        readonly semanticContractId: "CS-011";
+        readonly implementations: readonly [{
+            readonly name: "data-table";
+            readonly runtime: "blade";
+            readonly primary: true;
+        }, {
+            readonly name: "livewire-data-table";
+            readonly runtime: "livewire";
+            readonly primary: false;
+        }];
+    }];
+};
+export declare const designLanguageRelease: {
+    readonly schemaVersion: 1;
+    readonly releaseVersion: "1.3.0";
+    readonly foundationVersion: "2.0.0";
+    readonly contracts: {
+        readonly interaction: 2;
+        readonly visualPattern: 1;
+        readonly componentSemantic: 2;
+        readonly componentApi: 2;
+        readonly platformAdapter: 1;
+        readonly telemetry: 1;
+    };
+    readonly adapters: {
+        readonly laravel: "0.1.0";
+        readonly typescript: "0.1.0";
+        readonly mcp: "0.1.0";
+    };
+    readonly generatorVersion: 2;
+    readonly sources: {
+        readonly tokens: {
+            readonly sha256: "sha256:05ade47e548b432e15dd2901575447376580c795beeef9d04189436dbb60a541";
+            readonly files: 26;
+        };
+        readonly interactions: "sha256:bab774f918c06dfc6c01a59d1e3b8d4e0ff4f51a3282710039974e696381bc70";
+        readonly visualPatterns: "sha256:ca7d0e659c68748f4cf71f78cd07d8e71c757757ac477e7d89768036d0b6b1d8";
+        readonly componentSemantics: "sha256:bd93376709eceeb32bf5c26c542856162f5e56e2b5a5beb1e6f4698a925981b0";
+        readonly telemetry: "sha256:86b2605c00bf3c6236c96dbaf3008757b6cdf085c9f29661310dfde7f38e8221";
+        readonly laravelAdapter: "sha256:3238c6e8793013afc57490b083beae25e124c0c4ae7d6db24577df4a3dc7efa4";
+    };
+    readonly catalogSha256: "0b7c8a06106aa60b2dae1f2905cc993b686d7e44503d3761cf8ea420ad637b35";
+};
+export type InteractionContractId = keyof typeof interactionContracts;
+export type VisualPatternContractId = keyof typeof visualPatternContracts;
+export type ComponentSemanticName = keyof typeof componentSemantics;
+export type LaravelImplementationName = typeof laravelPlatformAdapter.mappings[number]["implementations"][number]["name"];
+export declare function getInteractionContract(id: InteractionContractId): InteractionContract;
+export declare function getVisualPatternContract(id: VisualPatternContractId): VisualPatternContract;
+export declare function getComponentSemanticContract(name: ComponentSemanticName): ComponentSemanticContract;
+export declare function getLaravelSemanticMapping(implementationName: LaravelImplementationName): PlatformAdapterMapping | undefined;