@jini-ai/ui-kit 0.1.3 → 0.1.5

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @jini-ai/ui-kit
 
+## 0.1.5 — 2026-10-22
+
+- 2026-10-22: Complexity refactors, coverage.
+
+## 0.1.4 — 2026-10-13
+
+- Break facade/native import cycles: native dialogs pick the provider's Button through a context-only lookup (`NativeButton` fallback; `nativeActions` still forces native), and `ToastRegion` creates its Toast elements. No API change.
+
 ## 0.1.2
 
 ### Patch Changes

package/dist/confirm.js

@@ -1,6 +1,9 @@
+const defaultConsequences = new Map([
+    ['warning', 'changes access, but is reversible'], ['danger', 'cannot be undone'],
+]);
 export function planConfirm(required, _optional = {}) {
     const pending = required.pending === true, tone = required.tone ?? 'default';
-    const consequence = required.consequence?.trim() || (tone === 'danger' ? 'cannot be undone' : tone === 'warning' ? 'changes access, but is reversible' : undefined);
+    const consequence = required.consequence?.trim() || defaultConsequences.get(tone);
     const confirmLabel = `${required.confirmLabel} — ${required.title}${consequence ? `; ${consequence}` : ''}`;
     const cancelLabel = required.cancelLabel ?? 'Cancel';
     const agent = (action, label) => required.agentHandle === undefined ? undefined :

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-export { KIT_CONTRACT, kitSpec, kitParts, implementedComponents } from './kit.spec.js';
-export type { KitComponentName, ImplementedComponentName, KitPart } from './kit.spec.js';
+export { KIT_CONTRACT, kitSpec, kitParts, implementedComponents } from './kit-contract.js';
+export type { KitComponentName, ImplementedComponentName, KitPart } from './kit-contract.js';
 export type { KitAttrs, AgentSpec, AgentAttrsPort } from './attrs.js';
 export { needs, assertKitContract, KitConfigError } from './needs.js';
 export type { KitNeeds } from './needs.js';

package/dist/index.js

@@ -1,4 +1,4 @@
-export { KIT_CONTRACT, kitSpec, kitParts, implementedComponents } from './kit.spec.js';
+export { KIT_CONTRACT, kitSpec, kitParts, implementedComponents } from './kit-contract.js';
 export { needs, assertKitContract, KitConfigError } from './needs.js';
 export { planConfirm, createConfirmController } from './confirm.js';
 export { createToastService } from './toast.js';

package/dist/{kit.spec.d.ts → kit-contract.d.ts}

@@ -488,4 +488,4 @@ export type ImplementedComponentName = {
 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
+//# sourceMappingURL=kit-contract.d.ts.map

package/dist/{kit.spec.js → kit-contract.js}

@@ -37,4 +37,4 @@ export const kitSpec = {
 };
 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
+//# sourceMappingURL=kit-contract.js.map

package/dist/needs.d.ts

@@ -1,4 +1,4 @@
-import { type KitComponentName } from './kit.spec.js';
+import { type KitComponentName } from './kit-contract.js';
 export interface KitNeeds<N extends KitComponentName = KitComponentName> {
     readonly id: string;
     readonly contract: string;

package/dist/needs.js

@@ -1,4 +1,4 @@
-import { KIT_CONTRACT, kitSpec } from './kit.spec.js';
+import { KIT_CONTRACT, kitSpec } from './kit-contract.js';
 export class KitConfigError extends Error {
     code = 'KIT_CONFIG';
     issues;

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

@@ -1,5 +1,5 @@
 import type { ReactNode } from 'react';
-import { type ImplementedComponentName } from '../kit.spec.js';
+import { type ImplementedComponentName } from '../kit-contract.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;
@@ -25,6 +25,7 @@ export declare function useFacade<K extends Exclude<ImplementedComponentName, 'C
     };
 };
 export declare function useToast(_required?: Record<string, never>, _optional?: Record<string, never>): import("../toast.js").ToastService;
+/** Observe toast messages and disposal-owned service state; ToastRegion owns element creation. */
 export declare function useToastRegion(required: {
     service?: ReturnType<typeof createToastService>;
     attrs?: ToastProps['attrs'];
@@ -34,6 +35,7 @@ export declare function useToastRegion(required: {
         id?: string;
         'data-jini-part': string;
     };
-    children: import("react").FunctionComponentElement<ToastProps>[];
+    messages: readonly import("../toast.js").ToastMessage[];
+    service: import("../toast.js").ToastService;
 };
 //# sourceMappingURL=Kit.hooks.d.ts.map

package/dist/react/Kit.hooks.js

@@ -1,17 +1,16 @@
-import { useContext, useEffect, useMemo, useRef, useState, useSyncExternalStore, createElement } from 'react';
+import { useEffect, useMemo, useRef, useState, useSyncExternalStore } from 'react';
 import { createPortal } from 'react-dom';
-import { KitContext } from './context.js';
+import { useKitContext } from './context.js';
 import { createKit } from './kit.js';
 import { assertKitContract, KitConfigError } from '../needs.js';
-import { kitSpec } from '../kit.spec.js';
+import { kitSpec } from '../kit-contract.js';
 import { createToastService } from '../toast.js';
-import { Toast } from './facade.js';
 let defaultValue;
 function getDefault() {
     return defaultValue ??= { kit: createKit({}), agent: undefined, overlayContainer: null, toast: undefined, cancelLabel: 'Cancel', guard: 'fallback' };
 }
 export function useKit(_required = {}, _optional = {}) {
-    return useContext(KitContext) ?? getDefault();
+    return useKitContext({}) ?? getDefault();
 }
 export function useKitProvider(required, _optional = {}) {
     const fallback = useMemo(() => createKit({}), []);
@@ -74,14 +73,13 @@ export function useToast(_required = {}, _optional = {}) {
         throw new KitConfigError({ issues: ['useToast requires a KitProvider or an injected toast service'] });
     return service;
 }
+/** Observe toast messages and disposal-owned service state; ToastRegion owns element creation. */
 export function useToastRegion(required, _optional = {}) {
     const context = useKit({});
     const service = required.service ?? context.toast;
     if (!service)
         throw new KitConfigError({ issues: ['ToastRegion requires a KitProvider or a service'] });
     const messages = useSyncExternalStore(listener => service.subscribe({ listener }), () => service.snapshot({}), () => service.snapshot({}));
-    const children = messages.map(message => createElement(Toast, { key: message.id, message: message.message,
-        ...(message.tone ? { tone: message.tone } : {}), onDismiss: () => service.dismiss({ id: message.id }) }));
-    return { container: useOverlayContainer({}), attrs: { 'data-jini-part': 'kit.toast-region', ...required.attrs }, children };
+    return { container: useOverlayContainer({}), attrs: { 'data-jini-part': 'kit.toast-region', ...required.attrs }, messages, service };
 }
 //# sourceMappingURL=Kit.hooks.js.map

package/dist/react/KitProvider.js

@@ -1,4 +1,5 @@
 import { jsx as _jsx } from "react/jsx-runtime";
+import { Toast } from './facade.js';
 import { KitContext } from './context.js';
 import { useKitProvider, useToastRegion, renderOverlay } from './Kit.hooks.js';
 export function KitProvider(props, _optional = {}) {
@@ -10,6 +11,6 @@ export function Overlay(props, _optional = {}) {
 }
 export function ToastRegion(props, _optional = {}) {
     const vm = useToastRegion(props);
-    return _jsx(Overlay, { container: vm.container, children: _jsx("div", { ...vm.attrs, "aria-live": "polite", "aria-relevant": "additions removals", children: vm.children }) });
+    return _jsx(Overlay, { container: vm.container, children: _jsx("div", { ...vm.attrs, "aria-live": "polite", "aria-relevant": "additions removals", children: vm.messages.map(message => _jsx(Toast, { message: message.message, ...(message.tone ? { tone: message.tone } : {}), onDismiss: () => vm.service.dismiss({ id: message.id }) }, message.id)) }) });
 }
 //# sourceMappingURL=KitProvider.js.map

package/dist/react/confirm/ConfirmDialog.hooks.js

@@ -17,12 +17,15 @@ export function useConfirmController(required, optional = {}) {
         onCancel: () => latest.current.onCancel({}), onConfirm: () => latest.current.onConfirm({}) }), []);
     const pending = !!required.pending || executing;
     const plan = planConfirm({ ...required, cancelLabel: required.cancelLabel ?? context.cancelLabel, pending });
-    function actionAttrs(part, spec, label) {
+    const actionState = pending ? 'pending' : 'ready';
+    function actionAttrs(input, _optional = {}) {
+        const { part, spec } = input;
+        const label = input.label ?? spec?.label ?? input.fallbackLabel;
         const agent = optional.agent ?? context.agent;
         const attrs = spec && agent ? agent({ handle: spec.handle }, { role: spec.role, label: spec.label }) : {};
         return Object.freeze({ ...attrs, 'data-jini-part': part, 'aria-label': label,
             ...(required.actionAccessibleNames && plan.consequence ? { 'aria-describedby': consequenceId } : {}),
-            'aria-busy': pending, 'data-jini-state': pending ? 'pending' : 'ready' });
+            'aria-busy': pending, 'data-jini-state': actionState });
     }
     async function onPress() {
         if (model.isExecuting({}) || !latest.current.open || latest.current.pending)
@@ -47,10 +50,10 @@ export function useConfirmController(required, optional = {}) {
             'aria-labelledby': titleId, 'aria-modal': true, 'aria-busy': pending }),
         titleAttrs: { id: titleId, 'data-jini-part': 'confirm.title' },
         consequenceAttrs: { id: consequenceId, 'data-jini-part': 'confirm.consequence' },
-        cancel: Object.freeze({ attrs: actionAttrs('confirm.cancel', plan.cancel, required.actionAccessibleNames?.cancel ?? plan.cancel?.label ?? `${plan.cancelLabel} — no action taken`),
+        cancel: Object.freeze({ attrs: actionAttrs({ part: 'confirm.cancel', spec: plan.cancel, label: required.actionAccessibleNames?.cancel, fallbackLabel: `${plan.cancelLabel} — no action taken` }),
             ref: cancelRef, disabled: pending, variant: 'secondary', children: plan.cancelLabel,
             onPress: () => { model.requestDismiss({ reason: 'cancel-button' }); } }),
-        confirm: Object.freeze({ attrs: actionAttrs('confirm.confirm', plan.confirm, required.actionAccessibleNames?.confirm ?? plan.confirmLabel), disabled: pending, pending,
+        confirm: Object.freeze({ attrs: actionAttrs({ part: 'confirm.confirm', spec: plan.confirm, label: required.actionAccessibleNames?.confirm, fallbackLabel: plan.confirmLabel }), disabled: pending, pending,
             variant: plan.confirmVariant, children: required.confirmLabel, onPress }),
         boundaryRef, overlayContainer: useOverlayContainer({}), agentMayConfirm: required.agentMayConfirm !== false,
         requestDismiss: model.requestDismiss,

package/dist/react/confirm/guard.js

@@ -6,49 +6,73 @@ function visible(element) {
     }
     return true;
 }
-/** Checks real mounted DOM. jsdom cannot prove layout or browser top-layer behavior; those are browser scenarios. */
-export function inspectConfirm(required, _optional = {}) {
-    const c = required.controller, issues = [];
-    const frame = c.frameAttrs.id ? document.getElementById(c.frameAttrs.id) : null;
-    if (!frame)
-        return ['missing confirm frame'];
+function inspectFrame({ controller: c, frame }, _optional = {}) {
+    const issues = [];
     if (frame.dataset.jiniPart !== 'confirm.dialog' || frame.getAttribute('role') !== 'alertdialog')
         issues.push('missing alertdialog semantics');
     if (!c.overlayContainer?.contains(frame))
         issues.push('frame outside overlay container');
     if (frame.getAttribute('aria-labelledby') !== c.frameAttrs['aria-labelledby'])
         issues.push('missing title association');
-    const cancel = frame.querySelector('[data-jini-part="confirm.cancel"]');
-    const confirm = frame.querySelector('[data-jini-part="confirm.confirm"]');
-    for (const [name, element, bag] of [['cancel', cancel, c.cancel], ['confirm', confirm, c.confirm]]) {
-        if (!element) {
-            issues.push(`missing ${name} action`);
-            continue;
-        }
-        if (!element.matches('button,input,[role="button"][tabindex]'))
-            issues.push(`${name} part is not on a focusable action`);
-        if (!visible(element))
-            issues.push(`${name} action hidden`);
-        for (const [key, value] of Object.entries(bag.attrs ?? {})) {
-            if (value !== undefined && element.getAttribute(key) !== String(value))
-                issues.push(`${name} did not forward ${key}`);
-        }
-        if (c.pending && !element.matches(':disabled') && element.getAttribute('aria-disabled') !== 'true')
-            issues.push(`${name} enabled while pending`);
+    return issues;
+}
+function inspectForwardedAttrs({ name, element, attrs }, _optional = {}) {
+    const issues = [];
+    for (const [key, value] of Object.entries(attrs ?? {})) {
+        if (value !== undefined && element.getAttribute(key) !== String(value))
+            issues.push(`${name} did not forward ${key}`);
     }
-    if (!c.pending && required.checkFocus && cancel && document.activeElement !== cancel)
+    return issues;
+}
+function inspectAction({ name, element, bag, pending }, _optional = {}) {
+    if (!element)
+        return [`missing ${name} action`];
+    const issues = [];
+    if (!element.matches('button,input,[role="button"][tabindex]'))
+        issues.push(`${name} part is not on a focusable action`);
+    if (!visible(element))
+        issues.push(`${name} action hidden`);
+    issues.push(...inspectForwardedAttrs({ name, element, attrs: bag.attrs }));
+    if (pending && !element.matches(':disabled') && element.getAttribute('aria-disabled') !== 'true')
+        issues.push(`${name} enabled while pending`);
+    return issues;
+}
+function inspectInteraction({ controller: c, checkFocus, cancel, confirm, activeElement }, _optional = {}) {
+    const issues = [];
+    if (!c.pending && checkFocus && cancel && activeElement !== cancel)
         issues.push('initial focus is not cancel');
     if (!c.agentMayConfirm && confirm && [confirm, ...confirm.querySelectorAll('*')].some(element => element.getAttributeNames().some(name => name.startsWith('data-agent-'))))
         issues.push('human-only confirm published agent metadata');
-    if (c.consequence && confirm && !confirm.getAttribute('aria-label')?.includes(c.consequence)) {
-        // A concise action name still has to expose the real, visible consequence as its
-        // description. An override dropping the associated paragraph must fail the guard.
-        const description = c.consequenceAttrs?.id ? document.getElementById(c.consequenceAttrs.id) : null;
-        const describedIds = confirm.getAttribute('aria-describedby')?.split(/\s+/) ?? [];
-        if (!description || !frame.contains(description) || !visible(description) ||
-            !describedIds.includes(description.id) || !description.textContent?.includes(c.consequence))
-            issues.push('missing consequence label');
-    }
+    return issues;
+}
+function inspectDescription({ description, frame, confirm, consequence }, _optional = {}) {
+    const describedIds = confirm.getAttribute('aria-describedby')?.split(/\s+/) ?? [];
+    if (!description || !frame.contains(description) || !visible(description) ||
+        !describedIds.includes(description.id) || !description.textContent?.includes(consequence))
+        return ['missing consequence label'];
+    return [];
+}
+function inspectConsequence({ controller: c, frame, confirm, document: dom }, _optional = {}) {
+    if (!c.consequence || !confirm || confirm.getAttribute('aria-label')?.includes(c.consequence))
+        return [];
+    // A concise action name still has to expose the real, visible consequence as its
+    // description. An override dropping the associated paragraph must fail the guard.
+    const description = c.consequenceAttrs?.id ? dom.getElementById(c.consequenceAttrs.id) : null;
+    return inspectDescription({ description, frame, confirm, consequence: c.consequence });
+}
+/** Checks real mounted DOM. jsdom cannot prove layout or browser top-layer behavior; those are browser scenarios. */
+export function inspectConfirm(required, _optional = {}) {
+    const c = required.controller;
+    const frame = c.frameAttrs.id ? document.getElementById(c.frameAttrs.id) : null;
+    if (!frame)
+        return ['missing confirm frame'];
+    const issues = inspectFrame({ controller: c, frame });
+    const cancel = frame.querySelector('[data-jini-part="confirm.cancel"]');
+    const confirm = frame.querySelector('[data-jini-part="confirm.confirm"]');
+    issues.push(...inspectAction({ name: 'cancel', element: cancel, bag: c.cancel, pending: c.pending }));
+    issues.push(...inspectAction({ name: 'confirm', element: confirm, bag: c.confirm, pending: c.pending }));
+    issues.push(...inspectInteraction({ controller: c, checkFocus: required.checkFocus, cancel, confirm, activeElement: document.activeElement }));
+    issues.push(...inspectConsequence({ controller: c, frame, confirm, document }));
     return issues;
 }
 //# sourceMappingURL=guard.js.map

package/dist/react/context.d.ts

@@ -6,4 +6,8 @@ export declare function getSharedKitContext(required: {
     version: string;
 }, _optional?: Record<string, never>): Context<KitContextValue | null>;
 export declare const KitContext: Context<KitContextValue | null>;
+/** Context-only lookup for native views: no default-kit assembly or facade dependency.
+ * @returns The nearest provider binding, or null so a native view can use its own defaults.
+ */
+export declare function useKitContext(_required?: Record<string, never>, _optional?: Record<string, never>): KitContextValue | null;
 //# sourceMappingURL=context.d.ts.map

package/dist/react/context.js

@@ -1,4 +1,4 @@
-import { createContext } from 'react';
+import { createContext, useContext } from 'react';
 const CONTEXT_KEY = Symbol.for('@jini-ai/ui-kit/react/context@1');
 export function isDevelopment(_required, _optional = {}) {
     // Keep the standard expression intact for bundlers to replace. A typeof-process shortcut would
@@ -21,4 +21,10 @@ export function getSharedKitContext(required, _optional = {}) {
     return slot.context;
 }
 export const KitContext = getSharedKitContext({ version: '0.1.0' });
+/** Context-only lookup for native views: no default-kit assembly or facade dependency.
+ * @returns The nearest provider binding, or null so a native view can use its own defaults.
+ */
+export function useKitContext(_required = {}, _optional = {}) {
+    return useContext(KitContext);
+}
 //# sourceMappingURL=context.js.map

package/dist/react/kit.d.ts

@@ -1,4 +1,4 @@
-import { type ImplementedComponentName } from '../kit.spec.js';
+import { type ImplementedComponentName } from '../kit-contract.js';
 import type { GuardMode, ReactKit, ResolvedKit } from './types.js';
 type KitOptions = {
     id?: string;

package/dist/react/kit.js

@@ -1,4 +1,4 @@
-import { KIT_CONTRACT, implementedComponents, kitSpec } from '../kit.spec.js';
+import { KIT_CONTRACT, implementedComponents, kitSpec } from '../kit-contract.js';
 import { assertKitContract, KitConfigError } from '../needs.js';
 import { nativeKit } from './native/index.js';
 export function createKit(required, optional = {}) {

package/dist/react/native/Dialog.hooks.d.ts

@@ -1,5 +1,5 @@
 import type { MouseEvent, SyntheticEvent } from 'react';
-import type { DialogProps, ConfirmViewProps } from '../types.js';
+import type { DialogProps, ConfirmViewProps, ReactKit } from '../types.js';
 /** Native modal lifecycle shared by kit views and compatibility adapters; DOM effects are O(1).
  * The document port preserves hosts' focus injection seam without introducing another lifecycle.
  * @example useNativeDialog({ open, title, onClose }, { initialFocus: () => cancelRef.current?.focus() })
@@ -33,9 +33,17 @@ export declare function useNativeDialog(required: DialogProps, optional?: {
         'aria-labelledby': string;
     };
 };
-export declare function useNativeConfirm(required: ConfirmViewProps, _optional?: Record<string, never>): {
+/** Native confirmation lifecycle with the view-selected Button. A failed conformance guard
+ * forces native actions even when a provider supplied a custom Button.
+ * @param required The shared confirmation controller.
+ * @param options Button selected by the native view's context-only lookup.
+ * @returns Dialog bindings and the action component that preserves the safety override.
+ */
+export declare function useNativeConfirm(required: ConfirmViewProps, { Button }?: {
+    Button?: ReactKit['Button'];
+}): {
     controller: import("../types.js").ConfirmController;
-    Button: import("react").ForwardRefExoticComponent<Omit<import("../types.js").ButtonProps, "ref"> & import("react").RefAttributes<HTMLButtonElement>>;
+    Button: import("react").ForwardRefExoticComponent<Omit<import("../types.js").ButtonProps, "ref"> & import("react").RefAttributes<HTMLButtonElement>> | import("react").ComponentType<import("../types.js").ButtonProps>;
     props: {
         className: string;
         role: string;

package/dist/react/native/Dialog.hooks.js

@@ -1,5 +1,4 @@
 import { useId, useImperativeHandle, useLayoutEffect, useRef } from 'react';
-import { Button } from '../facade.js';
 import { NativeButton } from './Controls.js';
 /** Native modal lifecycle shared by kit views and compatibility adapters; DOM effects are O(1).
  * The document port preserves hosts' focus injection seam without introducing another lifecycle.
@@ -13,8 +12,7 @@ export function useNativeDialog(required, optional = {}) {
         if (!dialog)
             return;
         if (!required.open) {
-            if (opener.current instanceof HTMLElement && opener.current.isConnected)
-                opener.current.focus({ preventScroll: true });
+            restoreDialogFocus({ opener: opener.current });
             return;
         }
         opener.current = (optional.document ?? document).activeElement;
@@ -36,8 +34,7 @@ export function useNativeDialog(required, optional = {}) {
             }
             else
                 dialog.removeAttribute('open');
-            if (opener.current instanceof HTMLElement && opener.current.isConnected)
-                opener.current.focus({ preventScroll: true });
+            restoreDialogFocus({ opener: opener.current });
         };
         // Open is the transition boundary: editing content must not recapture the original trigger.
     }, [required.open]);
@@ -55,6 +52,10 @@ export function useNativeDialog(required, optional = {}) {
             onClick: (event) => { if (event.target === event.currentTarget && !required.pending && isOutsideBox(event))
                 required.onClose({}); } } };
 }
+function restoreDialogFocus({ opener }, _optional = {}) {
+    if (opener instanceof HTMLElement && opener.isConnected)
+        opener.focus({ preventScroll: true });
+}
 /** True when the pointer is outside the dialog's own rectangle, i.e. on the ::backdrop. A click with no
  *  coordinates (keyboard activation, synthetic test clicks) keeps the old target-only behaviour. */
 function isOutsideBox(event) {
@@ -64,7 +65,13 @@ function isOutsideBox(event) {
     const r = event.currentTarget.getBoundingClientRect();
     return x < r.left || x > r.right || y < r.top || y > r.bottom;
 }
-export function useNativeConfirm(required, _optional = {}) {
+/** Native confirmation lifecycle with the view-selected Button. A failed conformance guard
+ * forces native actions even when a provider supplied a custom Button.
+ * @param required The shared confirmation controller.
+ * @param options Button selected by the native view's context-only lookup.
+ * @returns Dialog bindings and the action component that preserves the safety override.
+ */
+export function useNativeConfirm(required, { Button = NativeButton } = {}) {
     const c = required.controller;
     const vm = useNativeDialog({ open: c.open, title: c.title, pending: c.pending, onClose: () => c.requestDismiss({ reason: 'close' }) }, { initialFocus: () => c.focusInitial({}) });
     return { ...vm, controller: c, Button: c.nativeActions ? NativeButton : Button,

package/dist/react/native/Dialog.js

@@ -1,13 +1,16 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { forwardRef } from 'react';
 import { useNativeDialog, useNativeConfirm } from './Dialog.hooks.js';
-import { Button } from '../facade.js';
+import { useKitContext } from '../context.js';
+import { NativeButton } from './Controls.js';
 export const NativeDialog = forwardRef(function NativeDialog(props, ref) {
+    const Button = useKitContext({})?.kit.components.Button ?? NativeButton;
     const vm = useNativeDialog({ ...props, ref });
     return _jsxs("dialog", { ...vm.props, children: [_jsx("h2", { className: "jini-dialog-title", id: vm.titleId, "data-jini-part": "kit.dialog-title", children: vm.title }), vm.children, _jsx(Button, { ...vm.closeProps, children: vm.closeLabel })] });
 });
 export function NativeConfirmDialog(props, _optional = {}) {
-    const vm = useNativeConfirm(props);
+    const Button = useKitContext({})?.kit.components.Button ?? NativeButton;
+    const vm = useNativeConfirm(props, { Button });
     return _jsxs("dialog", { ...vm.props, children: [_jsx("h2", { className: "jini-confirm-dialog-title", ...vm.controller.titleAttrs, children: vm.controller.title }), _jsxs("div", { className: "jini-confirm-dialog-body", "data-jini-part": "confirm.body", children: [vm.controller.body, _jsx("p", { className: "jini-confirm-dialog-consequence", ...vm.controller.consequenceAttrs, children: vm.controller.consequence }), vm.controller.error] }), _jsxs("div", { className: "jini-confirm-dialog-actions", "data-jini-part": "confirm.actions", children: [_jsx(vm.Button, { ...vm.controller.cancel }), _jsx(vm.Button, { ...vm.controller.confirm })] })] });
 }
 //# sourceMappingURL=Dialog.js.map

package/dist/react/native/Navigation.hooks.js

@@ -1,13 +1,21 @@
 import { createElement, useId, useRef, useState, useEffect, useLayoutEffect } from 'react';
 import { createPortal } from 'react-dom';
+function navigationIndex(required, _optional = {}) {
+    switch (required.key) {
+        case 'Home': return 0;
+        case 'End': return required.count - 1;
+        case required.forward: return (required.current + 1) % required.count;
+        case required.backward: return (required.current - 1 + required.count) % required.count;
+        default: return undefined;
+    }
+}
 export function useNativeTabs(required, _optional = {}) {
     const prefix = useId(), root = useRef(null);
     const enabled = required.items.filter(item => !item.disabled);
     const active = enabled.find(item => item.id === required.value) ?? enabled[0];
     function onKeyDown(event) {
         const index = enabled.findIndex(item => item.id === event.currentTarget.dataset.tabId);
-        const next = event.key === 'Home' ? 0 : event.key === 'End' ? enabled.length - 1 :
-            event.key === 'ArrowRight' ? (index + 1) % enabled.length : event.key === 'ArrowLeft' ? (index - 1 + enabled.length) % enabled.length : undefined;
+        const next = navigationIndex({ key: event.key, current: index, count: enabled.length, forward: 'ArrowRight', backward: 'ArrowLeft' });
         if (next === undefined || !enabled[next])
             return;
         event.preventDefault();
@@ -69,8 +77,7 @@ export function useNativeMenu(required, _optional = {}) {
             setOpen(false);
             return;
         }
-        const next = event.key === 'Home' ? 0 : event.key === 'End' ? enabled.length - 1 :
-            event.key === 'ArrowDown' ? (current + 1) % enabled.length : event.key === 'ArrowUp' ? (current - 1 + enabled.length) % enabled.length : undefined;
+        const next = navigationIndex({ key: event.key, current, count: enabled.length, forward: 'ArrowDown', backward: 'ArrowUp' });
         if (next !== undefined) {
             event.preventDefault();
             focus(next);

package/dist/react/testing/driver.d.ts

@@ -1,6 +1,6 @@
 import type { AgentAttrsPort } from '../../attrs.js';
 import type { KitScenario } from '../../testing/scenarios.js';
-import type { ImplementedComponentName } from '../../kit.spec.js';
+import type { ImplementedComponentName } from '../../kit-contract.js';
 import type { ResolvedKit } from '../types.js';
 export interface KitConformanceResult {
     readonly id: string;

package/dist/react/testing/driver.js

@@ -28,14 +28,15 @@ function check(expectation, root, calls) {
         return `missing ${expectation.selector}`;
     if (expectation.type === 'attribute')
         return element.getAttribute(expectation.name) === expectation.value ? undefined : `${expectation.selector} did not forward ${expectation.name}=${expectation.value}`;
-    if (expectation.type === 'focused')
-        return element === document.activeElement ? undefined : `${expectation.selector} not focused`;
-    if (expectation.type === 'disabled')
-        return element.matches(':disabled') || element.getAttribute('aria-disabled') === 'true' ? undefined : `${expectation.selector} not disabled`;
-    if (expectation.type === 'native-select')
-        return element instanceof HTMLSelectElement ? undefined : 'Select must render HTMLSelectElement';
-    if (expectation.type === 'focusable')
-        return element.matches('button,input,select,textarea,[tabindex]') ? undefined : `${expectation.selector} is not focusable`;
+    return checkElementState({ expectation, element });
+}
+function checkElementState({ expectation, element }, _optional) {
+    switch (expectation.type) {
+        case 'focused': return element === document.activeElement ? undefined : `${expectation.selector} not focused`;
+        case 'disabled': return element.matches(':disabled') || element.getAttribute('aria-disabled') === 'true' ? undefined : `${expectation.selector} not disabled`;
+        case 'native-select': return element instanceof HTMLSelectElement ? undefined : 'Select must render HTMLSelectElement';
+        case 'focusable': return element.matches('button,input,select,textarea,[tabindex]') ? undefined : `${expectation.selector} is not focusable`;
+    }
 }
 export const reactConformanceDriver = {
     async run({ kit, scenario, agent }) {
@@ -82,10 +83,14 @@ export const reactConformanceDriver = {
         return errors;
     },
 };
-export async function runKitConformance(required, optional = {}) {
-    const driver = optional.driver ?? reactConformanceDriver;
-    if (optional.includeBrowser && driver === reactConformanceDriver)
+function resolveConformanceDriver(required, _optional) {
+    const driver = required.driver ?? reactConformanceDriver;
+    if (required.includeBrowser && driver === reactConformanceDriver)
         throw new Error('Browser cases require a real browser driver');
+    return driver;
+}
+export async function runKitConformance(required, optional = {}) {
+    const driver = resolveConformanceDriver(optional);
     const results = [];
     for (const scenario of optional.scenarios ?? kitConformanceScenarios) {
         if (optional.only && !optional.only.includes(scenario.component))

package/dist/react/types.d.ts

@@ -1,7 +1,7 @@
 import type { ComponentType, ReactNode, Ref, RefObject, HTMLAttributes } from 'react';
 import type { KitAttrs, AgentAttrsPort } from '../attrs.js';
 import type { ConfirmInput, DismissReason } from '../confirm.js';
-import type { ImplementedComponentName } from '../kit.spec.js';
+import type { ImplementedComponentName } from '../kit-contract.js';
 import type { KitNeeds } from '../needs.js';
 import type { ToastService } from '../toast.js';
 export interface BaseProps {

package/dist/testing/scenarios.d.ts

@@ -1,4 +1,4 @@
-import type { ImplementedComponentName } from '../kit.spec.js';
+import type { ImplementedComponentName } from '../kit-contract.js';
 export type ConformanceAction = {
     readonly type: 'click' | 'cancel' | 'focus' | 'key';
     readonly selector: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jini-ai/ui-kit",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Framework-free UI contract, injected React facades and native defaults.",
   "license": "Apache-2.0",
   "repository": {