@jini-ai/ui-kit 0.6.15-rc.2 → 0.6.15

package/dist/confirm.js

@@ -4,7 +4,8 @@ const defaultConsequences = new Map([
 export function planConfirm(required, _optional = {}) {
     const pending = required.pending === true, tone = required.tone ?? 'default';
     const consequence = required.consequence?.trim() || defaultConsequences.get(tone);
-    const confirmLabel = `${required.confirmLabel} — ${required.title}${consequence ? `; ${consequence}` : ''}`;
+    const consequenceLabel = consequence ? '; ' + consequence : '';
+    const confirmLabel = `${required.confirmLabel} — ${required.title}${consequenceLabel}`;
     const cancelLabel = required.cancelLabel ?? 'Cancel';
     const agent = (action, label) => required.agentHandle === undefined ? undefined :
         { handle: `${required.agentHandle}-${action}`, role: 'button', label };
@@ -26,7 +27,9 @@ export function createConfirmController(required, _optional = {}) {
         },
         async confirm(input = {}, _optional = {}) {
             const policy = required.read({});
-            if (executing || !policy.open || policy.pending || (input.actor === 'agent' && policy.agentMayConfirm === false))
+            if (executing || !policy.open || policy.pending)
+                return false;
+            if (input.actor === 'agent' && policy.agentMayConfirm === false)
                 return false;
             // Set synchronously before calling the port: two clicks in one React frame must not execute twice.
             executing = true;

package/dist/kit-contract.js

@@ -1,13 +1,14 @@
 /** 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' };
+const ATTRS_ON_FOCUS_TARGET = 'attrs-on-focus-target';
 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", "kit.secret-toggle"], "focusTarget": "input", "portal": "none", "safety": false, "behaviors": ["value-change", "labelled-control", "attrs-on-focus-target", "secret-reveal"], "props": ["attrs", "className", "label", "value", "disabled", "required", "placeholder", "type", "ref", "onValueChange", "secretToggleLabels"], "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"] },
+    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", "kit.secret-toggle"], "focusTarget": "input", "portal": "none", "safety": false, "behaviors": ["value-change", "labelled-control", ATTRS_ON_FOCUS_TARGET, "secret-reveal"], "props": ["attrs", "className", "label", "value", "disabled", "required", "placeholder", "type", "ref", "onValueChange", "secretToggleLabels"], "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": [] },

package/dist/needs.js

@@ -13,8 +13,12 @@ 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;
+    let compatible = contract === KIT_CONTRACT.version;
+    if (match) {
+        const requestedMinor = Number(match[2] ?? 0);
+        const withinMinor = requestedMinor < minor || (requestedMinor === minor && Number(match[3] ?? 0) <= patch);
+        compatible = Number(match[1]) === major && withinMinor;
+    }
     if (!compatible)
         throw new KitConfigError({ issues: [`contract ${contract} is incompatible with ${KIT_CONTRACT.version}`] });
 }

package/dist/react/Kit.hooks.js

@@ -7,7 +7,8 @@ import { kitSpec } from '../kit-contract.js';
 import { createToastService } from '../toast.js';
 let defaultValue;
 function getDefault() {
-    return defaultValue ??= { kit: createKit({}), agent: undefined, overlayContainer: null, toast: undefined, cancelLabel: 'Cancel', guard: 'fallback' };
+    defaultValue ??= { kit: createKit({}), agent: undefined, overlayContainer: null, toast: undefined, cancelLabel: 'Cancel', guard: 'fallback' };
+    return defaultValue;
 }
 export function useKit(_required = {}, _optional = {}) {
     return useKitContext({}) ?? getDefault();
@@ -42,7 +43,7 @@ function useOverlayRoot(required) {
     useEffect(() => {
         if (required.supplied) {
             setRoot(required.supplied);
-            return;
+            return undefined;
         }
         const element = document.createElement('div');
         element.dataset.jiniPart = 'kit.overlay';

package/dist/react/SecretInput.d.ts

@@ -0,0 +1,15 @@
+import { type InputHTMLAttributes } from 'react';
+import { type SecretRevealOptional } from './secret-reveal.hooks.js';
+export interface SecretInputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'type'>, SecretRevealOptional {
+    readonly label: string;
+    readonly toggleLabels?: {
+        readonly show: string;
+        readonly hide: string;
+    };
+    readonly toggleAttrs?: Readonly<Record<string, string | boolean | undefined>>;
+}
+/** Masked native input with controlled or local reveal state. Keep its toggle outside a label:
+ * the toggle's name must never join the input's accessible name. Hosts own styling and copy.
+ * @complexity O(1). */
+export declare const SecretInput: import("react").ForwardRefExoticComponent<SecretInputProps & import("react").RefAttributes<HTMLInputElement>>;
+//# sourceMappingURL=SecretInput.d.ts.map

package/dist/react/SecretInput.js

@@ -0,0 +1,14 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { forwardRef } from 'react';
+import { useSecretReveal } from './secret-reveal.hooks.js';
+import { eyeIcon } from './native/Controls.hooks.js';
+/** Masked native input with controlled or local reveal state. Keep its toggle outside a label:
+ * the toggle's name must never join the input's accessible name. Hosts own styling and copy.
+ * @complexity O(1). */
+export const SecretInput = forwardRef(function SecretInput(props, ref) {
+    // The toggle props are pulled off so they never reach the DOM `<input>`.
+    const { label, toggleLabels, toggleAttrs, revealed, onRevealedChange, ...inputProps } = props;
+    const reveal = useSecretReveal({ value: inputProps.value, labels: toggleLabels ?? { show: `Show ${label}`, hide: `Hide ${label}` } }, { ...(revealed === undefined ? {} : { revealed }), ...(onRevealedChange ? { onRevealedChange } : {}) });
+    return _jsxs("span", { className: "jini-secret", children: [_jsx("input", { ...inputProps, spellCheck: false, ref: ref, type: reveal.inputType }), _jsx("button", { ...toggleAttrs, type: "button", className: "jini-secret-toggle", "aria-label": reveal.toggleLabel, title: reveal.toggleLabel, disabled: inputProps.disabled, onClick: reveal.toggle, children: eyeIcon({ revealed: reveal.revealed }) })] });
+});
+//# sourceMappingURL=SecretInput.js.map

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

@@ -75,7 +75,7 @@ export function useConfirmFacade(required, _optional = {}) {
             // React restores selection between cleanup and layout setup; restore the trigger after that step.
             if (opener.current instanceof HTMLElement && opener.current.isConnected)
                 opener.current.focus();
-            return;
+            return undefined;
         }
         c.focusInitial({});
         return () => { if (opener.current instanceof HTMLElement && opener.current.isConnected)
@@ -83,9 +83,9 @@ export function useConfirmFacade(required, _optional = {}) {
     }, [c.open, Component]);
     useEffect(() => {
         if (!c.open || failed || context.guard === 'off' || !isDevelopment({}))
-            return;
+            return undefined;
         if (!context.kit.overrides.includes('ConfirmDialog') && !context.kit.overrides.includes('Button'))
-            return;
+            return undefined;
         // After the committed view's effects, including library portal/focus synchronization.
         const timer = setTimeout(() => {
             const reasons = inspectConfirm({ controller: c, checkFocus: initial.current });

package/dist/react/confirm/guard.js

@@ -1,7 +1,9 @@
 function visible(element) {
     for (let current = element; current; current = current.parentElement) {
         const style = getComputedStyle(current);
-        if (current.hidden || current.getAttribute('aria-hidden') === 'true' || style.display === 'none' || style.visibility === 'hidden' || style.visibility === 'collapse' || style.opacity === '0')
+        if (current.hidden || current.getAttribute('aria-hidden') === 'true' || style.display === 'none')
+            return false;
+        if (style.visibility === 'hidden' || style.visibility === 'collapse' || style.opacity === '0')
             return false;
     }
     return true;
@@ -47,8 +49,9 @@ function inspectInteraction({ controller: c, checkFocus, cancel, confirm, active
 }
 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))
+    if (!description || !frame.contains(description) || !visible(description))
+        return ['missing consequence label'];
+    if (!describedIds.includes(description.id) || !description.textContent?.includes(consequence))
         return ['missing consequence label'];
     return [];
 }

package/dist/react/index.d.ts

@@ -5,4 +5,6 @@ export { Button, IconButton, TextField, TextArea, Select, Checkbox, Switch, Dial
 export { ConfirmDialog } from './confirm/ConfirmDialog.js';
 export { useConfirmController } from './confirm/ConfirmDialog.hooks.js';
 export type * from './types.js';
+export { SecretInput, type SecretInputProps } from './SecretInput.js';
+export { useSecretReveal, type SecretRevealRequired, type SecretRevealOptional } from './secret-reveal.hooks.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/react/index.js

@@ -4,4 +4,6 @@ export { useKit, useKitComponent, useOverlayContainer, useToast } from './Kit.ho
 export { Button, IconButton, TextField, TextArea, Select, Checkbox, Switch, Dialog, Tabs, Menu, Toast, Tooltip, Notice, Spinner, Badge } from './facade.js';
 export { ConfirmDialog } from './confirm/ConfirmDialog.js';
 export { useConfirmController } from './confirm/ConfirmDialog.hooks.js';
+export { SecretInput } from './SecretInput.js';
+export { useSecretReveal } from './secret-reveal.hooks.js';
 //# sourceMappingURL=index.js.map

package/dist/react/kit.js

@@ -35,8 +35,14 @@ export function extendKit(required, optional = {}) {
 }
 export function describeKit(required, _optional = {}) {
     const { kit } = required;
-    const coverage = implementedComponents.map(name => ({ component: name, parts: kitSpec[name].parts,
-        source: kit.failed.has(name) ? 'native-guard' : kit.overrides.includes(name) ? 'override' : 'native' }));
+    const coverage = implementedComponents.map(name => {
+        let source = 'native';
+        if (kit.overrides.includes(name))
+            source = 'override';
+        if (kit.failed.has(name))
+            source = 'native-guard';
+        return { component: name, parts: kitSpec[name].parts, source };
+    });
     return { id: kit.id, contract: kit.contract, coverage,
         fallbacks: coverage.filter(entry => entry.source !== 'override').map(entry => entry.component),
         violations: kit.violations.map(violation => ({ ...violation, reasons: [...violation.reasons] })) };

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

@@ -31,6 +31,9 @@ export declare function useNativeIconButton(required: IconButtonProps, _optional
     };
     children: import("react").ReactNode;
 };
+export declare function eyeIcon(required: {
+    revealed: boolean;
+}, _optional?: Record<string, never>): import("react").ReactSVGElement;
 export declare function useNativeTextField(required: TextFieldProps, _optional?: Record<string, never>): {
     toggle: {
         'data-jini-part': string;
@@ -127,7 +130,7 @@ export declare function useNativeToast(required: ToastProps, _optional?: Record<
         className: string;
         role: string;
         tabIndex: number;
-        'data-jini-variant': "warning" | "danger" | "info" | "success";
+        'data-jini-variant': NonNullable<"warning" | "danger" | "info" | "success" | undefined>;
         id?: string;
         'data-jini-part': string;
     };
@@ -146,7 +149,7 @@ export declare function useNativeNotice(required: NoticeProps, _optional?: Recor
         className: string;
         tabIndex: number;
         role: string;
-        'data-jini-variant': "warning" | "danger" | "info" | "success";
+        'data-jini-variant': NonNullable<"warning" | "danger" | "info" | "success" | undefined>;
         id?: string;
         'data-jini-part': string;
     };
@@ -166,7 +169,7 @@ export declare function useNativeBadge(required: BadgeProps, _optional?: Record<
     props: {
         className: string;
         tabIndex: number;
-        'data-jini-variant': "warning" | "danger" | "info" | "success";
+        'data-jini-variant': NonNullable<"warning" | "danger" | "info" | "success" | undefined>;
         id?: string;
         'data-jini-part': string;
     };

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

@@ -1,9 +1,10 @@
 import { createElement, useId, useState } from 'react';
 export function useNativeButton(required, _optional = {}) {
+    const readyState = required.disabled ? 'disabled' : 'ready';
     return { children: required.children, props: { 'data-jini-part': 'kit.button', ref: required.ref, className: `jini-btn jini-btn-${required.variant ?? 'primary'} ${required.className ?? ''}`.trim(),
             type: required.type ?? 'button', disabled: !!required.disabled || !!required.pending,
             'aria-busy': required.pending, 'data-jini-variant': required.variant ?? 'primary',
-            'data-jini-state': required.pending ? 'pending' : required.disabled ? 'disabled' : 'ready',
+            'data-jini-state': required.pending ? 'pending' : readyState,
             onClick: () => { if (!required.disabled && !required.pending)
                 required.onPress?.({}); },
             // Opaque metadata wins over generated metadata; behavioral props cannot be supplied through attrs.
@@ -21,7 +22,7 @@ function useField(required) {
 /** Eye / eye-off glyphs, decorative: the button's aria-label carries the meaning. */
 const EYE_PATHS = ['M2 12s3.5-7 10-7 10 7 10 7-3.5 7-10 7S2 12 2 12z', 'M12 9a3 3 0 1 0 0 6 3 3 0 1 0 0-6z'];
 const EYE_OFF_PATHS = ['M9.9 4.24A9.1 9.1 0 0 1 12 4c6.5 0 10 7 10 7a17.8 17.8 0 0 1-2.16 3.19M6.6 6.6C3.9 8.4 2 12 2 12s3.5 7 10 7a9.7 9.7 0 0 0 5.4-1.6M14.12 14.12a3 3 0 1 1-4.24-4.24', 'M2 2l20 20'];
-function eyeIcon(required, _optional = {}) {
+export function eyeIcon(required, _optional = {}) {
     const paths = (required.revealed ? EYE_OFF_PATHS : EYE_PATHS).map(d => createElement('path', { key: d, d }));
     return createElement('svg', { 'aria-hidden': true, focusable: 'false', viewBox: '0 0 24 24', width: 18, height: 18, fill: 'none', stroke: 'currentColor', strokeWidth: 2, strokeLinecap: 'round', strokeLinejoin: 'round' }, paths);
 }

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

@@ -10,10 +10,10 @@ export function useNativeDialog(required, optional = {}) {
     useLayoutEffect(() => {
         const dialog = dialogRef.current;
         if (!dialog)
-            return;
+            return undefined;
         if (!required.open) {
             restoreDialogFocus({ opener: opener.current });
-            return;
+            return undefined;
         }
         opener.current = (optional.document ?? document).activeElement;
         if (typeof dialog.showModal === 'function') {

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

@@ -39,7 +39,7 @@ export function useNativeMenu(required, _optional = {}) {
     const [position, setPosition] = useState({ top: 0, left: 0 });
     useLayoutEffect(() => {
         if (!open || !trigger.current || !menu.current)
-            return;
+            return undefined;
         // Portals escape the preview card's overflow clipping. Follow the anchor on scroll/resize.
         const update = () => {
             const anchor = trigger.current.getBoundingClientRect();
@@ -57,7 +57,7 @@ export function useNativeMenu(required, _optional = {}) {
     function focus(index) { menu.current?.querySelectorAll('[role="menuitem"]:not(:disabled)')[index]?.focus(); }
     useEffect(() => {
         if (!open)
-            return;
+            return undefined;
         focus(0);
         const dismiss = (event) => {
             if (event.target instanceof Node && !menu.current?.contains(event.target) && !trigger.current?.contains(event.target))

package/dist/react/secret-reveal.hooks.d.ts

@@ -0,0 +1,26 @@
+export interface SecretRevealRequired {
+    /** The input's current value. A transition to `''` re-hides (the usual sign a save succeeded). */
+    readonly value: unknown;
+    /** The toggle's full accessible names, translated ("Show API key" / "Hide API key"). */
+    readonly labels: {
+        readonly show: string;
+        readonly hide: string;
+    };
+}
+export interface SecretRevealOptional {
+    /** Controlled mode: the host owns the shown/hidden state (e.g. to reset it per provider). */
+    readonly revealed?: boolean;
+    readonly onRevealedChange?: (revealed: boolean) => void;
+}
+/**
+ * The show/hide state behind `SecretInput`'s eye toggle. Starts hidden. Uncontrolled, it re-hides on
+ * the value's transition to empty only — an empty field may still be revealed before pasting.
+ * @complexity O(1).
+ */
+export declare function useSecretReveal(required: SecretRevealRequired, optional?: SecretRevealOptional): {
+    readonly revealed: boolean;
+    readonly inputType: "text" | "password";
+    readonly toggleLabel: string;
+    readonly toggle: () => void;
+};
+//# sourceMappingURL=secret-reveal.hooks.d.ts.map

package/dist/react/secret-reveal.hooks.js

@@ -0,0 +1,25 @@
+import { useState } from 'react';
+/**
+ * The show/hide state behind `SecretInput`'s eye toggle. Starts hidden. Uncontrolled, it re-hides on
+ * the value's transition to empty only — an empty field may still be revealed before pasting.
+ * @complexity O(1).
+ */
+export function useSecretReveal(required, optional = {}) {
+    const [ownRevealed, setOwnRevealed] = useState(false);
+    const [lastValue, setLastValue] = useState(required.value);
+    if (required.value !== lastValue) {
+        setLastValue(required.value);
+        if (required.value === '')
+            setOwnRevealed(false);
+    }
+    const revealed = optional.revealed ?? ownRevealed;
+    const toggleLabel = revealed ? required.labels.hide : required.labels.show;
+    const toggle = () => {
+        if (optional.onRevealedChange)
+            optional.onRevealedChange(!revealed);
+        else
+            setOwnRevealed(!revealed);
+    };
+    return { revealed, inputType: revealed ? 'text' : 'password', toggleLabel, toggle };
+}
+//# sourceMappingURL=secret-reveal.hooks.js.map

package/dist/react/testing/driver.js

@@ -97,10 +97,11 @@ export async function runKitConformance(required, optional = {}) {
             continue;
         if (scenario.browserOnly && !optional.includeBrowser) {
             results.push({ id: scenario.id, status: 'skipped', errors: ['requires real browser driver'] });
-            continue;
         }
-        const errors = await driver.run({ kit: required.kit, scenario, agent: optional.agent ?? testingAgent });
-        results.push({ id: scenario.id, status: errors.length ? 'failed' : 'passed', errors });
+        else {
+            const errors = await driver.run({ kit: required.kit, scenario, agent: optional.agent ?? testingAgent });
+            results.push({ id: scenario.id, status: errors.length ? 'failed' : 'passed', errors });
+        }
     }
     return results;
 }

package/dist/react/types.d.ts

@@ -3,7 +3,7 @@ import type { KitAttrs, AgentAttrsPort } from '../attrs.js';
 import type { ConfirmInput, DismissReason } from '../confirm.js';
 import type { ImplementedComponentName } from '../kit-contract.js';
 import type { KitNeeds } from '../needs.js';
-import type { ToastService } from '../toast.js';
+import type { ToastMessage, ToastService } from '../toast.js';
 export interface BaseProps {
     readonly attrs?: KitAttrs;
     readonly className?: string;
@@ -139,7 +139,7 @@ export interface MenuProps extends BaseProps {
 }
 export interface ToastProps extends BaseProps {
     readonly message: string;
-    readonly tone?: 'info' | 'success' | 'warning' | 'danger';
+    readonly tone?: NonNullable<ToastMessage['tone']>;
     readonly onDismiss?: ActionPort;
     readonly dismissLabel?: string;
 }
@@ -150,14 +150,14 @@ export interface TooltipProps extends BaseProps {
 }
 export interface NoticeProps extends BaseProps {
     readonly children: ReactNode;
-    readonly tone?: 'info' | 'success' | 'warning' | 'danger';
+    readonly tone?: NonNullable<ToastMessage['tone']>;
 }
 export interface SpinnerProps extends BaseProps {
     readonly label?: string;
 }
 export interface BadgeProps extends BaseProps {
     readonly children: ReactNode;
-    readonly tone?: 'info' | 'success' | 'warning' | 'danger';
+    readonly tone?: NonNullable<ToastMessage['tone']>;
 }
 export interface ReactKitProps {
     Button: ButtonProps;

package/dist/testing/scenarios.js

@@ -1,3 +1,4 @@
+const CONFIRM_CANCEL = '[data-jini-part="confirm.cancel"]';
 /** Serializable cases can drive another framework or a real-browser fixture without importing React. */
 export const kitConformanceScenarios = Object.freeze([
     ...['Button', 'IconButton', 'TextField', 'TextArea', 'Select', 'Checkbox', 'Switch', 'Dialog', 'Tabs', 'Menu', 'Toast', 'Tooltip', 'Notice', 'Spinner', 'Badge'].map(component => ({
@@ -8,21 +9,21 @@ export const kitConformanceScenarios = Object.freeze([
     })),
     { id: 'Select:native-semantics', component: 'Select', props: {}, actions: [], expectations: [{ type: 'native-select', selector: '[data-jini-part="kit.select"]' }] },
     { id: 'Button:disabled-blocks-press', component: 'Button', props: { disabled: true }, actions: [{ type: 'click', selector: 'button' }], expectations: [{ type: 'calls', name: 'press', count: 0 }] },
-    { id: 'ConfirmDialog:cancel-first-focus', component: 'ConfirmDialog', safety: true, props: {}, actions: [], expectations: [{ type: 'focused', selector: '[data-jini-part="confirm.cancel"]' }] },
+    { id: 'ConfirmDialog:cancel-first-focus', component: 'ConfirmDialog', safety: true, props: {}, actions: [], expectations: [{ type: 'focused', selector: CONFIRM_CANCEL }] },
     { id: 'ConfirmDialog:pending-blocks-every-dismissal', component: 'ConfirmDialog', safety: true, props: { pending: true },
         actions: [{ type: 'cancel', selector: '[data-jini-part="confirm.dialog"]' }, { type: 'click', selector: '[data-jini-part="confirm.dialog"]' },
-            { type: 'click', selector: '[data-jini-part="confirm.cancel"]' }, { type: 'click', selector: '[data-jini-part="confirm.confirm"]' }],
+            { type: 'click', selector: CONFIRM_CANCEL }, { type: 'click', selector: '[data-jini-part="confirm.confirm"]' }],
         expectations: [{ type: 'calls', name: 'cancel', count: 0 }, { type: 'calls', name: 'confirm', count: 0 },
-            { type: 'disabled', selector: '[data-jini-part="confirm.cancel"]' }, { type: 'disabled', selector: '[data-jini-part="confirm.confirm"]' }] },
+            { type: 'disabled', selector: CONFIRM_CANCEL }, { type: 'disabled', selector: '[data-jini-part="confirm.confirm"]' }] },
     { id: 'ConfirmDialog:agent-confirm-withheld', component: 'ConfirmDialog', safety: true, props: { agentHandle: 'erase', agentMayConfirm: false }, actions: [],
         expectations: [{ type: 'absent', selector: '[data-agent-element="erase-confirm"]' },
-            { type: 'attribute', selector: '[data-jini-part="confirm.cancel"]', name: 'data-agent-element', value: 'erase-cancel' }] },
+            { type: 'attribute', selector: CONFIRM_CANCEL, name: 'data-agent-element', value: 'erase-cancel' }] },
     { id: 'ConfirmDialog:consequence-label', component: 'ConfirmDialog', safety: true, props: { agentHandle: 'erase', tone: 'danger' }, actions: [],
         expectations: [{ type: 'attribute', selector: '[data-jini-part="confirm.confirm"]', name: 'data-agent-label', value: 'Delete — Delete record?; cannot be undone' },
             { type: 'attribute', selector: '[data-jini-part="confirm.confirm"]', name: 'aria-label', value: 'Delete — Delete record?; cannot be undone' }] },
     { id: 'ConfirmDialog:browser-escape', component: 'ConfirmDialog', safety: true, browserOnly: true, props: {},
-        actions: [{ type: 'key', selector: '[data-jini-part="confirm.cancel"]', key: 'Escape' }], expectations: [{ type: 'calls', name: 'cancel', count: 1 }] },
+        actions: [{ type: 'key', selector: CONFIRM_CANCEL, key: 'Escape' }], expectations: [{ type: 'calls', name: 'cancel', count: 1 }] },
     { id: 'ConfirmDialog:browser-modal-focus', component: 'ConfirmDialog', safety: true, browserOnly: true, props: {}, actions: [],
-        expectations: [{ type: 'focused', selector: '[data-jini-part="confirm.cancel"]' }] },
+        expectations: [{ type: 'focused', selector: CONFIRM_CANCEL }] },
 ]);
 //# sourceMappingURL=scenarios.js.map

package/dist/toast.js

@@ -23,7 +23,9 @@ export function createToastService(_required, optional = {}) {
         push(input, opts = {}) {
             if (disposed)
                 throw new Error('Toast service is disposed');
-            const id = opts.id ?? `toast-${++sequence}`;
+            if (opts.id == null)
+                sequence += 1;
+            const id = opts.id ?? `toast-${sequence}`;
             dismiss({ id });
             messages = Object.freeze([...messages, Object.freeze({ ...input, id })]);
             emit();

package/package.json

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