@jini-ai/admin 0.4.4 → 0.4.5

package/dist/forms/react/index.js

@@ -2,6 +2,9 @@ import { createElement } from 'react';
 import { bindReact } from '../../core/react/bind-react.js';
 import { formsModule } from '../forms.module.js';
 import { FormsPortsContext, FormsOptionsContext } from './hooks/FormsPorts.hooks.js';
+// The list must mount its bounded API read even when long-lived streams occupy every socket.
+// A native dynamic import would queue before that read and leave the loading notice forever.
+import { FormsList } from './pages/FormsList.js';
 export { FormsPortsContext, FormsOptionsContext, useFormsPorts } from './hooks/FormsPorts.hooks.js';
 export { useFormsList } from './hooks/use-forms-list.hooks.js';
 export { useFormEditor } from './hooks/use-form-editor.hooks.js';
@@ -9,7 +12,6 @@ export { useFormEditor } from './hooks/use-form-editor.hooks.js';
 export function forms(_required, options = {}) {
     const react = bindReact({ module: formsModule, views: {
             list: { page: async () => {
-                    const { FormsList } = await import('./pages/FormsList.js');
                     return { default: (_props) => createElement(FormsList) };
                 }, tabs: {} },
             editor: { page: async () => {

package/dist/react/components/ConfirmDialog/ConfirmDialog.hooks.d.ts

@@ -87,7 +87,9 @@ export declare function useConfirmDialogCancelLabel(_requiredArgs: Record<string
  * Focus moves to the *cancel* action on open, not confirm — an operator whose first keystroke after
  * a slow read-through is Enter should land on the safe action, not the destructive one.
  *
- * @complexity O(1) per open/close transition — one `showModal`/`close` call and one focus move.
+ * Native modal lifecycle restores the opener; panel-kit's shared trap contains Tab/Shift+Tab,
+ * including in DOM environments using the open-attribute fallback, and handles nested traps.
+ * @complexity O(1) per open/close transition; Tab boundaries scan focusable dialog content.
  */
 export declare function useConfirmDialog({ open, onCancel, document }: {
     readonly open: boolean;

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

@@ -1,6 +1,7 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { createContext, useContext, useMemo, useRef, } from 'react';
 import { useNativeDialog } from '@jini-ai/ui-kit/react/native';
+import { useFocusTrap } from '@jini-ai/ui/panel-kit';
 /** Empty object, not `undefined` — {@link useConfirmDialogCancelLabel} can always read `cancelLabel`
  *  off it without an extra null check, whether or not a provider is mounted. */
 const ConfirmDialogDefaultsContext = createContext({});
@@ -51,7 +52,9 @@ export function useConfirmDialogCancelLabel(_requiredArgs, { explicit } = {}) {
  * Focus moves to the *cancel* action on open, not confirm — an operator whose first keystroke after
  * a slow read-through is Enter should land on the safe action, not the destructive one.
  *
- * @complexity O(1) per open/close transition — one `showModal`/`close` call and one focus move.
+ * Native modal lifecycle restores the opener; panel-kit's shared trap contains Tab/Shift+Tab,
+ * including in DOM environments using the open-attribute fallback, and handles nested traps.
+ * @complexity O(1) per open/close transition; Tab boundaries scan focusable dialog content.
  */
 export function useConfirmDialog({ open, onCancel, document }, { pending } = {}) {
     // `useId()`, not a string literal — a hardcoded id breaks the moment a screen mounts two
@@ -78,6 +81,7 @@ export function useConfirmDialog({ open, onCancel, document }, { pending } = {})
     const cancelRef = useRef(null);
     const vm = useNativeDialog({ open, title: '', onClose: () => onCancel(), ...(pending === undefined ? {} : { pending }) }, { document, initialFocus: () => cancelRef.current?.focus() });
     const titleId = vm.titleId, dialogRef = vm.props.ref;
+    useFocusTrap({ containerRef: dialogRef }, { active: open });
     const handleNativeCancel = vm.props.onCancel, handleBackdropClick = vm.props.onClick;
     return { titleId, dialogRef, cancelRef, handleNativeCancel, handleBackdropClick };
 }

package/dist/react/components/ConfirmDialog/use-confirm-request.d.ts

@@ -0,0 +1,22 @@
+import type { ConfirmDialogProps } from './ConfirmDialog.js';
+/** Host copy and consequence styling; ConfirmDialog remains the owner of focus and dismissal. */
+export type ConfirmRequestPresentation = Pick<ConfirmDialogProps, 'title' | 'body' | 'confirmLabel' | 'cancelLabel' | 'tone'>;
+export interface ConfirmRequestController {
+    confirm: (required: {
+        dialog: ConfirmRequestPresentation;
+    }, optional?: Record<string, never>) => Promise<boolean>;
+    /** Keep the shared dialog mounted, including while closed. */
+    dialog: ConfirmDialogProps;
+}
+/**
+ * Adapts an async confirmation callback to the shared controlled ConfirmDialog.
+ * Replacing a request or unmounting denies the outstanding action; stale answers cannot accept
+ * a newer request. No destructive effect runs here: the caller acts only after receiving true.
+ * @param _required - No required host dependencies.
+ * @param _optional - Reserved options.
+ * @returns Promise confirmer and props for one always-mounted ConfirmDialog.
+ * @example const approval = useConfirmRequest({}); // <ConfirmDialog {...approval.dialog} />
+ * @complexity O(1) time and space per request; at most one unresolved request.
+ */
+export declare function useConfirmRequest(_required: Record<string, never>, _optional?: Record<string, never>): ConfirmRequestController;
+//# sourceMappingURL=use-confirm-request.d.ts.map

package/dist/react/components/ConfirmDialog/use-confirm-request.js

@@ -0,0 +1,53 @@
+import { useCallback, useEffect, useRef, useState } from 'react';
+/**
+ * Adapts an async confirmation callback to the shared controlled ConfirmDialog.
+ * Replacing a request or unmounting denies the outstanding action; stale answers cannot accept
+ * a newer request. No destructive effect runs here: the caller acts only after receiving true.
+ * @param _required - No required host dependencies.
+ * @param _optional - Reserved options.
+ * @returns Promise confirmer and props for one always-mounted ConfirmDialog.
+ * @example const approval = useConfirmRequest({}); // <ConfirmDialog {...approval.dialog} />
+ * @complexity O(1) time and space per request; at most one unresolved request.
+ */
+export function useConfirmRequest(_required, _optional = {}) {
+    const [request, setRequest] = useState(null);
+    const pending = useRef(null);
+    const mounted = useRef(true);
+    useEffect(() => {
+        mounted.current = true;
+        return () => {
+            mounted.current = false;
+            pending.current?.resolve(false);
+            pending.current = null;
+        };
+    }, []);
+    /** Opens one request, denying any replaced request; retained callbacks fail closed after unmount. */
+    const confirm = useCallback(({ dialog }, _options = {}) => {
+        if (!mounted.current)
+            return Promise.resolve(false);
+        pending.current?.resolve(false);
+        return new Promise((resolve) => {
+            const next = { presentation: dialog, resolve };
+            pending.current = next;
+            setRequest(next);
+        });
+    }, []);
+    /** Only the dialog that opened this request may settle it, once; delayed older clicks are ignored. */
+    function settle(accepted) {
+        if (!request || pending.current !== request)
+            return;
+        pending.current = null;
+        setRequest(null);
+        request.resolve(accepted);
+    }
+    return {
+        confirm,
+        dialog: {
+            ...(request?.presentation ?? { title: '', body: '', confirmLabel: '' }),
+            open: request !== null,
+            onConfirm: () => settle(true),
+            onCancel: () => settle(false),
+        },
+    };
+}
+//# sourceMappingURL=use-confirm-request.js.map

package/dist/react/index.d.ts

@@ -37,6 +37,8 @@ export { ConfirmButton } from './components/ConfirmButton/ConfirmButton.js';
 export type { ConfirmButtonProps } from './components/ConfirmButton/ConfirmButton.js';
 export { ConfirmDialog } from './components/ConfirmDialog/ConfirmDialog.js';
 export type { ConfirmDialogProps } from './components/ConfirmDialog/ConfirmDialog.js';
+export { useConfirmRequest } from './components/ConfirmDialog/use-confirm-request.js';
+export type { ConfirmRequestController, ConfirmRequestPresentation } from './components/ConfirmDialog/use-confirm-request.js';
 export type { ConfirmDialogController, UseConfirmDialog } from './components/ConfirmDialog/ConfirmDialog.hooks.js';
 export { ConfirmDialogDefaultsProvider } from './components/ConfirmDialog/ConfirmDialog.hooks.js';
 export type { ConfirmDialogDefaults, ConfirmDialogDefaultsProviderProps, } from './components/ConfirmDialog/ConfirmDialog.hooks.js';

package/dist/react/index.js

@@ -36,6 +36,7 @@
 export { resolveTone, toneClassName } from './types.js';
 export { ConfirmButton } from './components/ConfirmButton/ConfirmButton.js';
 export { ConfirmDialog } from './components/ConfirmDialog/ConfirmDialog.js';
+export { useConfirmRequest } from './components/ConfirmDialog/use-confirm-request.js';
 // Host-wide `ConfirmDialog` defaults (today just a translated `cancelLabel`), set once at an app
 // root rather than passed at every call site — see `ConfirmDialogDefaultsProvider`'s doc comment.
 export { ConfirmDialogDefaultsProvider } from './components/ConfirmDialog/ConfirmDialog.hooks.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jini-ai/admin",
-  "version": "0.4.4",
+  "version": "0.4.5",
   "description": "Composable admin surface for Jini-hosted products: framework-free contracts, panel registry, and route model in `/core`; React shell and panels in `/react`. Import only the layers you need.",
   "license": "Apache-2.0",
   "repository": {
@@ -428,10 +428,10 @@
     "react": "^18.3.0 || ^19.0.0",
     "react-dom": "^18.3.0 || ^19.0.0",
     "@jini-ai/agentic": "^0.4.2",
-    "@jini-ai/ui": "^0.4.5",
+    "@jini-ai/ui": "^0.4.7",
     "@jini-ai/ui-kit": "^0.1.1",
     "@jini-ai/agent-plugins": "^0.4.1",
-    "@jini-ai/cms": "^0.5.2",
+    "@jini-ai/cms": "^0.5.5",
     "@jini-ai/core": "^0.4.2"
   },
   "peerDependenciesMeta": {
@@ -470,12 +470,12 @@
     "react": "^19.2.0",
     "react-dom": "^19.2.0",
     "@testing-library/user-event": "^14.6.1",
-    "@jini-ai/agentic": "^0.4.3",
-    "@jini-ai/ui": "^0.4.6",
     "@jini-ai/ui-kit": "^0.1.2",
-    "@jini-ai/core": "^0.4.2",
-    "@jini-ai/cms": "^0.5.4",
-    "@jini-ai/agent-plugins": "^0.4.2"
+    "@jini-ai/cms": "^0.5.5",
+    "@jini-ai/agentic": "^0.4.3",
+    "@jini-ai/agent-plugins": "^0.4.2",
+    "@jini-ai/ui": "^0.4.7",
+    "@jini-ai/core": "^0.4.2"
   },
   "typesVersions": {
     "*": {