@jini-ai/ui-kit 0.0.0-stage → 0.1.1

package/dist/kit.spec.d.ts

@@ -0,0 +1,491 @@
+/** Contract semver is independent of the npm package version. Only implemented entries may be required. */
+export declare const KIT_CONTRACT: {
+    readonly id: "@jini-ai/ui-kit";
+    readonly version: "1.0.0";
+};
+export interface KitComponentSpec {
+    readonly status: 'implemented' | 'planned';
+    readonly tier: 'control' | 'composite' | 'layout';
+    readonly since: string | null;
+    readonly parts: readonly string[];
+    readonly focusTarget: string;
+    readonly portal: 'none' | 'overlay';
+    readonly safety: boolean;
+    readonly behaviors: readonly string[];
+    readonly props: readonly string[];
+    readonly events: readonly string[];
+    readonly variants: readonly string[];
+    readonly states: readonly string[];
+}
+export declare const kitSpec: {
+    readonly Button: {
+        readonly status: "implemented";
+        readonly tier: "control";
+        readonly since: "1.0.0";
+        readonly parts: readonly ["kit.button"];
+        readonly focusTarget: "button";
+        readonly portal: "none";
+        readonly safety: false;
+        readonly behaviors: readonly ["press", "disabled-blocks-press", "attrs-on-focus-target"];
+        readonly props: readonly ["attrs", "className", "children", "disabled", "pending", "variant", "type", "ref", "onPress"];
+        readonly events: readonly ["onPress"];
+        readonly variants: readonly ["primary", "secondary", "danger", "warning", "ghost"];
+        readonly states: readonly ["disabled", "pending"];
+    };
+    readonly IconButton: {
+        readonly status: "implemented";
+        readonly tier: "control";
+        readonly since: "1.0.0";
+        readonly parts: readonly ["kit.icon-button"];
+        readonly focusTarget: "button";
+        readonly portal: "none";
+        readonly safety: false;
+        readonly behaviors: readonly ["accessible-label", "press", "attrs-on-focus-target"];
+        readonly props: readonly ["attrs", "className", "children", "disabled", "pending", "variant", "type", "ref", "onPress", "label"];
+        readonly events: readonly ["onPress"];
+        readonly variants: readonly ["primary", "secondary", "danger", "warning", "ghost"];
+        readonly states: readonly ["disabled", "pending"];
+    };
+    readonly TextField: {
+        readonly status: "implemented";
+        readonly tier: "control";
+        readonly since: "1.0.0";
+        readonly parts: readonly ["kit.text-field", "kit.field-label"];
+        readonly focusTarget: "input";
+        readonly portal: "none";
+        readonly safety: false;
+        readonly behaviors: readonly ["value-change", "labelled-control", "attrs-on-focus-target"];
+        readonly props: readonly ["attrs", "className", "label", "value", "disabled", "required", "placeholder", "type", "ref", "onValueChange"];
+        readonly events: readonly ["onValueChange"];
+        readonly variants: readonly [];
+        readonly states: readonly ["disabled"];
+    };
+    readonly TextArea: {
+        readonly status: "implemented";
+        readonly tier: "control";
+        readonly since: "1.0.0";
+        readonly parts: readonly ["kit.text-area", "kit.field-label"];
+        readonly focusTarget: "textarea";
+        readonly portal: "none";
+        readonly safety: false;
+        readonly behaviors: readonly ["value-change", "labelled-control", "attrs-on-focus-target"];
+        readonly props: readonly ["attrs", "className", "label", "value", "disabled", "required", "placeholder", "ref", "onValueChange", "rows"];
+        readonly events: readonly ["onValueChange"];
+        readonly variants: readonly [];
+        readonly states: readonly ["disabled"];
+    };
+    readonly Select: {
+        readonly status: "implemented";
+        readonly tier: "control";
+        readonly since: "1.0.0";
+        readonly parts: readonly ["kit.select", "kit.field-label"];
+        readonly focusTarget: "select";
+        readonly portal: "none";
+        readonly safety: false;
+        readonly behaviors: readonly ["native-select", "value-change", "attrs-on-focus-target"];
+        readonly props: readonly ["attrs", "className", "label", "value", "disabled", "required", "ref", "onValueChange", "options"];
+        readonly events: readonly ["onValueChange"];
+        readonly variants: readonly [];
+        readonly states: readonly ["disabled"];
+    };
+    readonly Checkbox: {
+        readonly status: "implemented";
+        readonly tier: "control";
+        readonly since: "1.0.0";
+        readonly parts: readonly ["kit.checkbox"];
+        readonly focusTarget: "input";
+        readonly portal: "none";
+        readonly safety: false;
+        readonly behaviors: readonly ["checked-change", "labelled-control", "attrs-on-focus-target"];
+        readonly props: readonly ["attrs", "className", "label", "checked", "disabled", "ref", "onCheckedChange"];
+        readonly events: readonly ["onCheckedChange"];
+        readonly variants: readonly [];
+        readonly states: readonly ["disabled"];
+    };
+    readonly Switch: {
+        readonly status: "implemented";
+        readonly tier: "control";
+        readonly since: "1.0.0";
+        readonly parts: readonly ["kit.switch"];
+        readonly focusTarget: "input";
+        readonly portal: "none";
+        readonly safety: false;
+        readonly behaviors: readonly ["checked-change", "switch-role", "attrs-on-focus-target"];
+        readonly props: readonly ["attrs", "className", "label", "checked", "disabled", "ref", "onCheckedChange"];
+        readonly events: readonly ["onCheckedChange"];
+        readonly variants: readonly [];
+        readonly states: readonly ["disabled"];
+    };
+    readonly Dialog: {
+        readonly status: "implemented";
+        readonly tier: "composite";
+        readonly since: "1.0.0";
+        readonly parts: readonly ["kit.dialog", "kit.dialog-title", "kit.dialog-close", "kit.overlay"];
+        readonly focusTarget: "dialog";
+        readonly portal: "overlay";
+        readonly safety: false;
+        readonly behaviors: readonly ["escape-dismissal", "pending-blocks-dismissal", "focus-restore"];
+        readonly props: readonly ["attrs", "className", "open", "title", "children", "pending", "closeLabel", "ref", "onClose"];
+        readonly events: readonly ["onClose"];
+        readonly variants: readonly [];
+        readonly states: readonly ["disabled", "pending"];
+    };
+    readonly ConfirmDialog: {
+        readonly status: "implemented";
+        readonly tier: "composite";
+        readonly since: "1.0.0";
+        readonly parts: readonly ["confirm.dialog", "confirm.title", "confirm.body", "confirm.actions", "confirm.cancel", "confirm.confirm"];
+        readonly focusTarget: "cancel";
+        readonly portal: "overlay";
+        readonly safety: true;
+        readonly behaviors: readonly ["pending-blocks-every-dismissal", "cancel-first-focus", "agent-confirm-withheld", "consequence-label"];
+        readonly props: readonly ["attrs", "className", "open", "title", "body", "confirmLabel", "cancelLabel", "tone", "pending", "consequence", "agentHandle", "agentMayConfirm", "errorLabel", "actionAccessibleNames", "onConfirm", "onCancel"];
+        readonly events: readonly ["onConfirm", "onCancel"];
+        readonly variants: readonly ["default", "warning", "danger"];
+        readonly states: readonly ["disabled", "pending"];
+    };
+    readonly Tabs: {
+        readonly status: "implemented";
+        readonly tier: "composite";
+        readonly since: "1.0.0";
+        readonly parts: readonly ["kit.tabs", "kit.tab", "kit.tab-panel"];
+        readonly focusTarget: "active-tab";
+        readonly portal: "none";
+        readonly safety: false;
+        readonly behaviors: readonly ["roving-tabs", "labelled-panel"];
+        readonly props: readonly ["attrs", "className", "label", "value", "items", "onValueChange"];
+        readonly events: readonly ["onValueChange"];
+        readonly variants: readonly [];
+        readonly states: readonly [];
+    };
+    readonly Menu: {
+        readonly status: "implemented";
+        readonly tier: "composite";
+        readonly since: "1.0.0";
+        readonly parts: readonly ["kit.menu-trigger", "kit.menu", "kit.menu-item"];
+        readonly focusTarget: "trigger-and-item";
+        readonly portal: "none";
+        readonly safety: false;
+        readonly behaviors: readonly ["roving-menu", "escape-dismissal", "focus-restore"];
+        readonly props: readonly ["attrs", "className", "label", "items", "disabled"];
+        readonly events: readonly [];
+        readonly variants: readonly [];
+        readonly states: readonly ["open"];
+    };
+    readonly Toast: {
+        readonly status: "implemented";
+        readonly tier: "composite";
+        readonly since: "1.0.0";
+        readonly parts: readonly ["kit.toast", "kit.toast-dismiss", "kit.toast-region"];
+        readonly focusTarget: "dismiss";
+        readonly portal: "overlay";
+        readonly safety: false;
+        readonly behaviors: readonly ["live-region", "dismiss-toast"];
+        readonly props: readonly ["attrs", "className", "message", "tone", "dismissLabel", "onDismiss"];
+        readonly events: readonly ["onDismiss"];
+        readonly variants: readonly ["info", "success", "warning", "danger"];
+        readonly states: readonly [];
+    };
+    readonly Tooltip: {
+        readonly status: "implemented";
+        readonly tier: "composite";
+        readonly since: "1.0.0";
+        readonly parts: readonly ["kit.tooltip-trigger", "kit.tooltip"];
+        readonly focusTarget: "trigger";
+        readonly portal: "none";
+        readonly safety: false;
+        readonly behaviors: readonly ["focus-tooltip", "hover-tooltip", "escape-dismissal"];
+        readonly props: readonly ["attrs", "className", "content", "children", "label"];
+        readonly events: readonly [];
+        readonly variants: readonly [];
+        readonly states: readonly ["open"];
+    };
+    readonly Notice: {
+        readonly status: "implemented";
+        readonly tier: "control";
+        readonly since: "1.0.0";
+        readonly parts: readonly ["kit.notice"];
+        readonly focusTarget: "root";
+        readonly portal: "none";
+        readonly safety: false;
+        readonly behaviors: readonly ["status-region"];
+        readonly props: readonly ["attrs", "className", "children", "tone"];
+        readonly events: readonly [];
+        readonly variants: readonly ["info", "success", "warning", "danger"];
+        readonly states: readonly [];
+    };
+    readonly Spinner: {
+        readonly status: "implemented";
+        readonly tier: "control";
+        readonly since: "1.0.0";
+        readonly parts: readonly ["kit.spinner"];
+        readonly focusTarget: "root";
+        readonly portal: "none";
+        readonly safety: false;
+        readonly behaviors: readonly ["accessible-label"];
+        readonly props: readonly ["attrs", "className", "label"];
+        readonly events: readonly [];
+        readonly variants: readonly [];
+        readonly states: readonly [];
+    };
+    readonly Badge: {
+        readonly status: "implemented";
+        readonly tier: "control";
+        readonly since: "1.0.0";
+        readonly parts: readonly ["kit.badge"];
+        readonly focusTarget: "root";
+        readonly portal: "none";
+        readonly safety: false;
+        readonly behaviors: readonly ["text-content"];
+        readonly props: readonly ["attrs", "className", "children", "tone"];
+        readonly events: readonly [];
+        readonly variants: readonly ["info", "success", "warning", "danger"];
+        readonly states: readonly [];
+    };
+    readonly Link: {
+        readonly status: "planned";
+        readonly tier: "composite";
+        readonly since: null;
+        readonly parts: readonly [];
+        readonly focusTarget: "planned";
+        readonly portal: "none";
+        readonly safety: false;
+        readonly behaviors: readonly [];
+        readonly props: readonly [];
+        readonly events: readonly [];
+        readonly variants: readonly [];
+        readonly states: readonly [];
+    };
+    readonly Icon: {
+        readonly status: "planned";
+        readonly tier: "composite";
+        readonly since: null;
+        readonly parts: readonly [];
+        readonly focusTarget: "planned";
+        readonly portal: "none";
+        readonly safety: false;
+        readonly behaviors: readonly [];
+        readonly props: readonly [];
+        readonly events: readonly [];
+        readonly variants: readonly [];
+        readonly states: readonly [];
+    };
+    readonly RadioGroup: {
+        readonly status: "planned";
+        readonly tier: "composite";
+        readonly since: null;
+        readonly parts: readonly [];
+        readonly focusTarget: "planned";
+        readonly portal: "none";
+        readonly safety: false;
+        readonly behaviors: readonly [];
+        readonly props: readonly [];
+        readonly events: readonly [];
+        readonly variants: readonly [];
+        readonly states: readonly [];
+    };
+    readonly Field: {
+        readonly status: "planned";
+        readonly tier: "composite";
+        readonly since: null;
+        readonly parts: readonly [];
+        readonly focusTarget: "planned";
+        readonly portal: "none";
+        readonly safety: false;
+        readonly behaviors: readonly [];
+        readonly props: readonly [];
+        readonly events: readonly [];
+        readonly variants: readonly [];
+        readonly states: readonly [];
+    };
+    readonly Card: {
+        readonly status: "planned";
+        readonly tier: "composite";
+        readonly since: null;
+        readonly parts: readonly [];
+        readonly focusTarget: "planned";
+        readonly portal: "none";
+        readonly safety: false;
+        readonly behaviors: readonly [];
+        readonly props: readonly [];
+        readonly events: readonly [];
+        readonly variants: readonly [];
+        readonly states: readonly [];
+    };
+    readonly Table: {
+        readonly status: "planned";
+        readonly tier: "composite";
+        readonly since: null;
+        readonly parts: readonly [];
+        readonly focusTarget: "planned";
+        readonly portal: "none";
+        readonly safety: false;
+        readonly behaviors: readonly [];
+        readonly props: readonly [];
+        readonly events: readonly [];
+        readonly variants: readonly [];
+        readonly states: readonly [];
+    };
+    readonly Popover: {
+        readonly status: "planned";
+        readonly tier: "composite";
+        readonly since: null;
+        readonly parts: readonly [];
+        readonly focusTarget: "planned";
+        readonly portal: "none";
+        readonly safety: false;
+        readonly behaviors: readonly [];
+        readonly props: readonly [];
+        readonly events: readonly [];
+        readonly variants: readonly [];
+        readonly states: readonly [];
+    };
+    readonly Combobox: {
+        readonly status: "planned";
+        readonly tier: "composite";
+        readonly since: null;
+        readonly parts: readonly [];
+        readonly focusTarget: "planned";
+        readonly portal: "none";
+        readonly safety: false;
+        readonly behaviors: readonly [];
+        readonly props: readonly [];
+        readonly events: readonly [];
+        readonly variants: readonly [];
+        readonly states: readonly [];
+    };
+    readonly Stack: {
+        readonly status: "planned";
+        readonly tier: "layout";
+        readonly since: null;
+        readonly parts: readonly [];
+        readonly focusTarget: "planned";
+        readonly portal: "none";
+        readonly safety: false;
+        readonly behaviors: readonly [];
+        readonly props: readonly [];
+        readonly events: readonly [];
+        readonly variants: readonly [];
+        readonly states: readonly [];
+    };
+    readonly Grid: {
+        readonly status: "planned";
+        readonly tier: "layout";
+        readonly since: null;
+        readonly parts: readonly [];
+        readonly focusTarget: "planned";
+        readonly portal: "none";
+        readonly safety: false;
+        readonly behaviors: readonly [];
+        readonly props: readonly [];
+        readonly events: readonly [];
+        readonly variants: readonly [];
+        readonly states: readonly [];
+    };
+    readonly ShellLayout: {
+        readonly status: "planned";
+        readonly tier: "layout";
+        readonly since: null;
+        readonly parts: readonly [];
+        readonly focusTarget: "planned";
+        readonly portal: "none";
+        readonly safety: false;
+        readonly behaviors: readonly [];
+        readonly props: readonly [];
+        readonly events: readonly [];
+        readonly variants: readonly [];
+        readonly states: readonly [];
+    };
+    readonly Sidebar: {
+        readonly status: "planned";
+        readonly tier: "layout";
+        readonly since: null;
+        readonly parts: readonly [];
+        readonly focusTarget: "planned";
+        readonly portal: "none";
+        readonly safety: false;
+        readonly behaviors: readonly [];
+        readonly props: readonly [];
+        readonly events: readonly [];
+        readonly variants: readonly [];
+        readonly states: readonly [];
+    };
+    readonly NavItem: {
+        readonly status: "planned";
+        readonly tier: "layout";
+        readonly since: null;
+        readonly parts: readonly [];
+        readonly focusTarget: "planned";
+        readonly portal: "none";
+        readonly safety: false;
+        readonly behaviors: readonly [];
+        readonly props: readonly [];
+        readonly events: readonly [];
+        readonly variants: readonly [];
+        readonly states: readonly [];
+    };
+    readonly PageHeader: {
+        readonly status: "planned";
+        readonly tier: "layout";
+        readonly since: null;
+        readonly parts: readonly [];
+        readonly focusTarget: "planned";
+        readonly portal: "none";
+        readonly safety: false;
+        readonly behaviors: readonly [];
+        readonly props: readonly [];
+        readonly events: readonly [];
+        readonly variants: readonly [];
+        readonly states: readonly [];
+    };
+    readonly Section: {
+        readonly status: "planned";
+        readonly tier: "layout";
+        readonly since: null;
+        readonly parts: readonly [];
+        readonly focusTarget: "planned";
+        readonly portal: "none";
+        readonly safety: false;
+        readonly behaviors: readonly [];
+        readonly props: readonly [];
+        readonly events: readonly [];
+        readonly variants: readonly [];
+        readonly states: readonly [];
+    };
+    readonly EmptyState: {
+        readonly status: "planned";
+        readonly tier: "layout";
+        readonly since: null;
+        readonly parts: readonly [];
+        readonly focusTarget: "planned";
+        readonly portal: "none";
+        readonly safety: false;
+        readonly behaviors: readonly [];
+        readonly props: readonly [];
+        readonly events: readonly [];
+        readonly variants: readonly [];
+        readonly states: readonly [];
+    };
+    readonly OverlayHost: {
+        readonly status: "planned";
+        readonly tier: "layout";
+        readonly since: null;
+        readonly parts: readonly [];
+        readonly focusTarget: "planned";
+        readonly portal: "none";
+        readonly safety: false;
+        readonly behaviors: readonly [];
+        readonly props: readonly [];
+        readonly events: readonly [];
+        readonly variants: readonly [];
+        readonly states: readonly [];
+    };
+};
+export type KitComponentName = keyof typeof kitSpec;
+export type ImplementedComponentName = {
+    [K in KitComponentName]: typeof kitSpec[K]['status'] extends 'implemented' ? K : never;
+}[KitComponentName];
+export type KitPart = typeof kitSpec[ImplementedComponentName]['parts'][number];
+export declare const implementedComponents: readonly ImplementedComponentName[];
+export declare const kitParts: readonly KitPart[];
+//# sourceMappingURL=kit.spec.d.ts.map

package/dist/kit.spec.js

@@ -0,0 +1,40 @@
+/** Contract semver is independent of the npm package version. Only implemented entries may be required. */
+export const KIT_CONTRACT = { id: '@jini-ai/ui-kit', version: '1.0.0' };
+export const kitSpec = {
+    Button: { "status": "implemented", "tier": "control", "since": "1.0.0", "parts": ["kit.button"], "focusTarget": "button", "portal": "none", "safety": false, "behaviors": ["press", "disabled-blocks-press", "attrs-on-focus-target"], "props": ["attrs", "className", "children", "disabled", "pending", "variant", "type", "ref", "onPress"], "events": ["onPress"], "variants": ["primary", "secondary", "danger", "warning", "ghost"], "states": ["disabled", "pending"] },
+    IconButton: { "status": "implemented", "tier": "control", "since": "1.0.0", "parts": ["kit.icon-button"], "focusTarget": "button", "portal": "none", "safety": false, "behaviors": ["accessible-label", "press", "attrs-on-focus-target"], "props": ["attrs", "className", "children", "disabled", "pending", "variant", "type", "ref", "onPress", "label"], "events": ["onPress"], "variants": ["primary", "secondary", "danger", "warning", "ghost"], "states": ["disabled", "pending"] },
+    TextField: { "status": "implemented", "tier": "control", "since": "1.0.0", "parts": ["kit.text-field", "kit.field-label"], "focusTarget": "input", "portal": "none", "safety": false, "behaviors": ["value-change", "labelled-control", "attrs-on-focus-target"], "props": ["attrs", "className", "label", "value", "disabled", "required", "placeholder", "type", "ref", "onValueChange"], "events": ["onValueChange"], "variants": [], "states": ["disabled"] },
+    TextArea: { "status": "implemented", "tier": "control", "since": "1.0.0", "parts": ["kit.text-area", "kit.field-label"], "focusTarget": "textarea", "portal": "none", "safety": false, "behaviors": ["value-change", "labelled-control", "attrs-on-focus-target"], "props": ["attrs", "className", "label", "value", "disabled", "required", "placeholder", "ref", "onValueChange", "rows"], "events": ["onValueChange"], "variants": [], "states": ["disabled"] },
+    Select: { "status": "implemented", "tier": "control", "since": "1.0.0", "parts": ["kit.select", "kit.field-label"], "focusTarget": "select", "portal": "none", "safety": false, "behaviors": ["native-select", "value-change", "attrs-on-focus-target"], "props": ["attrs", "className", "label", "value", "disabled", "required", "ref", "onValueChange", "options"], "events": ["onValueChange"], "variants": [], "states": ["disabled"] },
+    Checkbox: { "status": "implemented", "tier": "control", "since": "1.0.0", "parts": ["kit.checkbox"], "focusTarget": "input", "portal": "none", "safety": false, "behaviors": ["checked-change", "labelled-control", "attrs-on-focus-target"], "props": ["attrs", "className", "label", "checked", "disabled", "ref", "onCheckedChange"], "events": ["onCheckedChange"], "variants": [], "states": ["disabled"] },
+    Switch: { "status": "implemented", "tier": "control", "since": "1.0.0", "parts": ["kit.switch"], "focusTarget": "input", "portal": "none", "safety": false, "behaviors": ["checked-change", "switch-role", "attrs-on-focus-target"], "props": ["attrs", "className", "label", "checked", "disabled", "ref", "onCheckedChange"], "events": ["onCheckedChange"], "variants": [], "states": ["disabled"] },
+    Dialog: { "status": "implemented", "tier": "composite", "since": "1.0.0", "parts": ["kit.dialog", "kit.dialog-title", "kit.dialog-close", "kit.overlay"], "focusTarget": "dialog", "portal": "overlay", "safety": false, "behaviors": ["escape-dismissal", "pending-blocks-dismissal", "focus-restore"], "props": ["attrs", "className", "open", "title", "children", "pending", "closeLabel", "ref", "onClose"], "events": ["onClose"], "variants": [], "states": ["disabled", "pending"] },
+    ConfirmDialog: { "status": "implemented", "tier": "composite", "since": "1.0.0", "parts": ["confirm.dialog", "confirm.title", "confirm.body", "confirm.actions", "confirm.cancel", "confirm.confirm"], "focusTarget": "cancel", "portal": "overlay", "safety": true, "behaviors": ["pending-blocks-every-dismissal", "cancel-first-focus", "agent-confirm-withheld", "consequence-label"], "props": ["attrs", "className", "open", "title", "body", "confirmLabel", "cancelLabel", "tone", "pending", "consequence", "agentHandle", "agentMayConfirm", "errorLabel", "actionAccessibleNames", "onConfirm", "onCancel"], "events": ["onConfirm", "onCancel"], "variants": ["default", "warning", "danger"], "states": ["disabled", "pending"] },
+    Tabs: { "status": "implemented", "tier": "composite", "since": "1.0.0", "parts": ["kit.tabs", "kit.tab", "kit.tab-panel"], "focusTarget": "active-tab", "portal": "none", "safety": false, "behaviors": ["roving-tabs", "labelled-panel"], "props": ["attrs", "className", "label", "value", "items", "onValueChange"], "events": ["onValueChange"], "variants": [], "states": [] },
+    Menu: { "status": "implemented", "tier": "composite", "since": "1.0.0", "parts": ["kit.menu-trigger", "kit.menu", "kit.menu-item"], "focusTarget": "trigger-and-item", "portal": "none", "safety": false, "behaviors": ["roving-menu", "escape-dismissal", "focus-restore"], "props": ["attrs", "className", "label", "items", "disabled"], "events": [], "variants": [], "states": ["open"] },
+    Toast: { "status": "implemented", "tier": "composite", "since": "1.0.0", "parts": ["kit.toast", "kit.toast-dismiss", "kit.toast-region"], "focusTarget": "dismiss", "portal": "overlay", "safety": false, "behaviors": ["live-region", "dismiss-toast"], "props": ["attrs", "className", "message", "tone", "dismissLabel", "onDismiss"], "events": ["onDismiss"], "variants": ["info", "success", "warning", "danger"], "states": [] },
+    Tooltip: { "status": "implemented", "tier": "composite", "since": "1.0.0", "parts": ["kit.tooltip-trigger", "kit.tooltip"], "focusTarget": "trigger", "portal": "none", "safety": false, "behaviors": ["focus-tooltip", "hover-tooltip", "escape-dismissal"], "props": ["attrs", "className", "content", "children", "label"], "events": [], "variants": [], "states": ["open"] },
+    Notice: { "status": "implemented", "tier": "control", "since": "1.0.0", "parts": ["kit.notice"], "focusTarget": "root", "portal": "none", "safety": false, "behaviors": ["status-region"], "props": ["attrs", "className", "children", "tone"], "events": [], "variants": ["info", "success", "warning", "danger"], "states": [] },
+    Spinner: { "status": "implemented", "tier": "control", "since": "1.0.0", "parts": ["kit.spinner"], "focusTarget": "root", "portal": "none", "safety": false, "behaviors": ["accessible-label"], "props": ["attrs", "className", "label"], "events": [], "variants": [], "states": [] },
+    Badge: { "status": "implemented", "tier": "control", "since": "1.0.0", "parts": ["kit.badge"], "focusTarget": "root", "portal": "none", "safety": false, "behaviors": ["text-content"], "props": ["attrs", "className", "children", "tone"], "events": [], "variants": ["info", "success", "warning", "danger"], "states": [] },
+    Link: { "status": "planned", "tier": "composite", "since": null, "parts": [], "focusTarget": "planned", "portal": "none", "safety": false, "behaviors": [], "props": [], "events": [], "variants": [], "states": [] },
+    Icon: { "status": "planned", "tier": "composite", "since": null, "parts": [], "focusTarget": "planned", "portal": "none", "safety": false, "behaviors": [], "props": [], "events": [], "variants": [], "states": [] },
+    RadioGroup: { "status": "planned", "tier": "composite", "since": null, "parts": [], "focusTarget": "planned", "portal": "none", "safety": false, "behaviors": [], "props": [], "events": [], "variants": [], "states": [] },
+    Field: { "status": "planned", "tier": "composite", "since": null, "parts": [], "focusTarget": "planned", "portal": "none", "safety": false, "behaviors": [], "props": [], "events": [], "variants": [], "states": [] },
+    Card: { "status": "planned", "tier": "composite", "since": null, "parts": [], "focusTarget": "planned", "portal": "none", "safety": false, "behaviors": [], "props": [], "events": [], "variants": [], "states": [] },
+    Table: { "status": "planned", "tier": "composite", "since": null, "parts": [], "focusTarget": "planned", "portal": "none", "safety": false, "behaviors": [], "props": [], "events": [], "variants": [], "states": [] },
+    Popover: { "status": "planned", "tier": "composite", "since": null, "parts": [], "focusTarget": "planned", "portal": "none", "safety": false, "behaviors": [], "props": [], "events": [], "variants": [], "states": [] },
+    Combobox: { "status": "planned", "tier": "composite", "since": null, "parts": [], "focusTarget": "planned", "portal": "none", "safety": false, "behaviors": [], "props": [], "events": [], "variants": [], "states": [] },
+    Stack: { "status": "planned", "tier": "layout", "since": null, "parts": [], "focusTarget": "planned", "portal": "none", "safety": false, "behaviors": [], "props": [], "events": [], "variants": [], "states": [] },
+    Grid: { "status": "planned", "tier": "layout", "since": null, "parts": [], "focusTarget": "planned", "portal": "none", "safety": false, "behaviors": [], "props": [], "events": [], "variants": [], "states": [] },
+    ShellLayout: { "status": "planned", "tier": "layout", "since": null, "parts": [], "focusTarget": "planned", "portal": "none", "safety": false, "behaviors": [], "props": [], "events": [], "variants": [], "states": [] },
+    Sidebar: { "status": "planned", "tier": "layout", "since": null, "parts": [], "focusTarget": "planned", "portal": "none", "safety": false, "behaviors": [], "props": [], "events": [], "variants": [], "states": [] },
+    NavItem: { "status": "planned", "tier": "layout", "since": null, "parts": [], "focusTarget": "planned", "portal": "none", "safety": false, "behaviors": [], "props": [], "events": [], "variants": [], "states": [] },
+    PageHeader: { "status": "planned", "tier": "layout", "since": null, "parts": [], "focusTarget": "planned", "portal": "none", "safety": false, "behaviors": [], "props": [], "events": [], "variants": [], "states": [] },
+    Section: { "status": "planned", "tier": "layout", "since": null, "parts": [], "focusTarget": "planned", "portal": "none", "safety": false, "behaviors": [], "props": [], "events": [], "variants": [], "states": [] },
+    EmptyState: { "status": "planned", "tier": "layout", "since": null, "parts": [], "focusTarget": "planned", "portal": "none", "safety": false, "behaviors": [], "props": [], "events": [], "variants": [], "states": [] },
+    OverlayHost: { "status": "planned", "tier": "layout", "since": null, "parts": [], "focusTarget": "planned", "portal": "none", "safety": false, "behaviors": [], "props": [], "events": [], "variants": [], "states": [] },
+};
+export const implementedComponents = Object.freeze(Object.keys(kitSpec).filter((name) => kitSpec[name].status === 'implemented'));
+export const kitParts = Object.freeze([...new Set(implementedComponents.flatMap(name => [...kitSpec[name].parts]))]);
+//# sourceMappingURL=kit.spec.js.map

package/dist/needs.d.ts

@@ -0,0 +1,24 @@
+import { type KitComponentName } from './kit.spec.js';
+export interface KitNeeds<N extends KitComponentName = KitComponentName> {
+    readonly id: string;
+    readonly contract: string;
+    readonly components: readonly N[];
+}
+export declare class KitConfigError extends Error {
+    readonly code = "KIT_CONFIG";
+    readonly issues: readonly string[];
+    constructor(required: {
+        issues: readonly string[];
+    }, _optional?: Record<string, never>);
+}
+/** Exact contract versions and ^major[.minor[.patch]] are deliberately the whole supported grammar. */
+export declare function assertKitContract(required: {
+    contract: string;
+}, _optional?: Record<string, never>): void;
+export declare function needs<const N extends readonly KitComponentName[]>(required: {
+    id: string;
+    components: N;
+}, optional?: {
+    contract?: string;
+}): KitNeeds<N[number]>;
+//# sourceMappingURL=needs.d.ts.map

package/dist/needs.js

@@ -0,0 +1,29 @@
+import { KIT_CONTRACT, kitSpec } from './kit.spec.js';
+export class KitConfigError extends Error {
+    code = 'KIT_CONFIG';
+    issues;
+    constructor(required, _optional = {}) {
+        super(`Invalid UI kit: ${required.issues.join('; ')}`);
+        this.name = 'KitConfigError';
+        this.issues = Object.freeze([...required.issues]);
+    }
+}
+/** Exact contract versions and ^major[.minor[.patch]] are deliberately the whole supported grammar. */
+export function assertKitContract(required, _optional = {}) {
+    const { contract } = required;
+    const match = /^\^(\d+)(?:\.(\d+))?(?:\.(\d+))?$/.exec(contract);
+    const [major, minor, patch] = KIT_CONTRACT.version.split('.').map(Number);
+    const compatible = match ? Number(match[1]) === major && (Number(match[2] ?? 0) < minor ||
+        (Number(match[2] ?? 0) === minor && Number(match[3] ?? 0) <= patch)) : contract === KIT_CONTRACT.version;
+    if (!compatible)
+        throw new KitConfigError({ issues: [`contract ${contract} is incompatible with ${KIT_CONTRACT.version}`] });
+}
+export function needs(required, optional = {}) {
+    const contract = optional.contract ?? '^1';
+    assertKitContract({ contract });
+    const issues = required.components.filter(name => kitSpec[name]?.status !== 'implemented').map(name => `${name} is planned, not implemented`);
+    if (issues.length)
+        throw new KitConfigError({ issues });
+    return Object.freeze({ ...required, components: Object.freeze([...required.components]), contract });
+}
+//# sourceMappingURL=needs.js.map

package/dist/react/Kit.hooks.d.ts

@@ -0,0 +1,39 @@
+import type { ReactNode } from 'react';
+import { type ImplementedComponentName } from '../kit.spec.js';
+import type { KitContextValue, KitProviderProps, ReactKitProps, ToastProps } from './types.js';
+import { createToastService } from '../toast.js';
+export declare function useKit(_required?: Record<string, never>, _optional?: Record<string, never>): KitContextValue;
+export declare function useKitProvider(required: KitProviderProps, _optional?: Record<string, never>): KitContextValue;
+export declare function useOverlayContainer(_required?: Record<string, never>, _optional?: Record<string, never>): HTMLElement | null;
+export declare function renderOverlay(required: {
+    children: ReactNode;
+    container: HTMLElement | null;
+}, _optional?: Record<string, never>): ReactNode;
+export declare function useKitComponent<K extends ImplementedComponentName>(required: {
+    name: K;
+}, _optional?: Record<string, never>): import("./types.js").ReactKit[K];
+export declare function useFacade<K extends Exclude<ImplementedComponentName, 'ConfirmDialog'>>(required: {
+    name: K;
+    props: ReactKitProps[K];
+}, _optional?: Record<string, never>): {
+    Component: import("./types.js").ReactKit[K];
+    props: ReactKitProps[K] & {
+        attrs: {
+            id?: string;
+            'data-jini-part': string;
+        };
+    };
+};
+export declare function useToast(_required?: Record<string, never>, _optional?: Record<string, never>): import("../toast.js").ToastService;
+export declare function useToastRegion(required: {
+    service?: ReturnType<typeof createToastService>;
+    attrs?: ToastProps['attrs'];
+}, _optional?: Record<string, never>): {
+    container: HTMLElement | null;
+    attrs: {
+        id?: string;
+        'data-jini-part': string;
+    };
+    children: import("react").FunctionComponentElement<ToastProps>[];
+};
+//# sourceMappingURL=Kit.hooks.d.ts.map