@jini-ai/ui-kit 0.1.4 → 0.1.5

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # @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.

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;

package/dist/react/Kit.hooks.js

@@ -3,7 +3,7 @@ import { createPortal } from 'react-dom';
 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';
 let defaultValue;
 function getDefault() {

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/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.js

@@ -12,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;
@@ -35,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]);
@@ -54,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) {

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.4",
+  "version": "0.1.5",
   "description": "Framework-free UI contract, injected React facades and native defaults.",
   "license": "Apache-2.0",
   "repository": {