@jini-ai/ui 0.3.14 → 0.4.0

package/dist/features/execution/react/components/LocalCliAgentList.js

@@ -14,7 +14,7 @@ export function LocalCliAgentList({ agents, config, scan, onSelect, onModelChang
     const t = useT();
     const installed = agents.filter((agent) => agent.installed);
     const scope = scopeLabel ?? t('Runs a code-agent CLI detected by the host.');
-    const cardHandles = agentHandle ? buildAgentListHandles(agentHandle, agents.map((agent) => agent.id)) : undefined;
-    return (_jsxs("section", { className: "jini-settings-section jini-local-cli", children: [_jsxs("div", { className: "jini-section-head", children: [_jsxs("div", { className: "jini-section-head-text", children: [_jsxs("h4", { className: "jini-agent-group-head", children: [t('Your CLIs'), " (", installed.length, ")"] }), _jsx("p", { className: "jini-field-hint", children: t('Pick the CLI that runs your prompts.') })] }), onRescan ? (_jsx("button", { type: "button", className: "jini-btn jini-local-cli-rescan", disabled: scan.status === 'scanning', onClick: onRescan, ...agentHandleProps(agentHandle, { action: 'rescan', role: 'button', label: t('Rescan') }), children: scan.status === 'scanning' ? t('Scanning…') : t('↻ Rescan') })) : null] }), _jsx("p", { className: "jini-field-hint jini-local-cli-scope", children: scope }), scan.status === 'error' ? (_jsx("p", { className: "jini-field-hint is-error", role: "alert", children: scan.message })) : null, scan.status === 'scanning' ? (_jsxs("div", { className: "jini-agent-scan-card", role: "status", "aria-live": "polite", children: [_jsx("span", { className: "jini-agent-scan-ring", "aria-hidden": "true" }), _jsx("strong", { children: t('Scanning for installed agents…') })] })) : agents.length === 0 ? (scan.status === 'error' ? null : (_jsx("div", { className: "jini-empty-card", children: t('No agent CLIs detected.') }))) : (_jsx("div", { className: "jini-agent-grid", children: agents.map((agent, index) => (_jsx(LocalCliAgentCard, { agent: agent, config: config, selected: config.agentId === agent.id, onSelect: onSelect, onModelChange: onModelChange, onReasoningChange: onReasoningChange, onEnvChange: onEnvChange, cliEnvFields: cliEnvFields, renderIcon: renderAgentIcon, onTest: onTest, agentTest: agentTest, onRescan: onRescan, ...(cardHandles?.[index] ? { agentHandle: cardHandles[index] } : {}) }, agent.id))) }))] }));
+    const cardHandles = agentHandle ? buildAgentListHandles({ prefix: agentHandle, ids: agents.map((agent) => agent.id) }) : undefined;
+    return (_jsxs("section", { className: "jini-settings-section jini-local-cli", children: [_jsxs("div", { className: "jini-section-head", children: [_jsxs("div", { className: "jini-section-head-text", children: [_jsxs("h4", { className: "jini-agent-group-head", children: [t('Your CLIs'), " (", installed.length, ")"] }), _jsx("p", { className: "jini-field-hint", children: t('Pick the CLI that runs your prompts.') })] }), onRescan ? (_jsx("button", { type: "button", className: "jini-btn jini-local-cli-rescan", disabled: scan.status === 'scanning', onClick: onRescan, ...agentHandleProps({}, { base: agentHandle, ...({ action: 'rescan', role: 'button', label: t('Rescan') }) }), children: scan.status === 'scanning' ? t('Scanning…') : t('↻ Rescan') })) : null] }), _jsx("p", { className: "jini-field-hint jini-local-cli-scope", children: scope }), scan.status === 'error' ? (_jsx("p", { className: "jini-field-hint is-error", role: "alert", children: scan.message })) : null, scan.status === 'scanning' ? (_jsxs("div", { className: "jini-agent-scan-card", role: "status", "aria-live": "polite", children: [_jsx("span", { className: "jini-agent-scan-ring", "aria-hidden": "true" }), _jsx("strong", { children: t('Scanning for installed agents…') })] })) : agents.length === 0 ? (scan.status === 'error' ? null : (_jsx("div", { className: "jini-empty-card", children: t('No agent CLIs detected.') }))) : (_jsx("div", { className: "jini-agent-grid", children: agents.map((agent, index) => (_jsx(LocalCliAgentCard, { agent: agent, config: config, selected: config.agentId === agent.id, onSelect: onSelect, onModelChange: onModelChange, onReasoningChange: onReasoningChange, onEnvChange: onEnvChange, cliEnvFields: cliEnvFields, renderIcon: renderAgentIcon, onTest: onTest, agentTest: agentTest, onRescan: onRescan, ...(cardHandles?.[index] ? { agentHandle: cardHandles[index] } : {}) }, agent.id))) }))] }));
 }
 //# sourceMappingURL=LocalCliAgentList.js.map

package/dist/features/execution/react/components/ProviderChipGroup.js

@@ -12,7 +12,7 @@ export function ProviderChipGroup({ label, presets, selectedPresetId, configured
     if (presets.length === 0)
         return null;
     const chipHandles = agentHandle
-        ? buildAgentListHandles(agentHandle, presets.map((preset) => preset.id))
+        ? buildAgentListHandles({ prefix: agentHandle, ids: presets.map((preset) => preset.id) })
         : undefined;
     return (_jsxs("div", { className: "jini-provider-chip-row", role: "tablist", "aria-label": label, children: [_jsx("span", { className: "jini-provider-chip-row-label", children: label }), _jsx("div", { className: "jini-provider-chip-options", children: presets.map((preset, index) => {
                     const active = selectedPresetId === preset.id;
@@ -20,7 +20,7 @@ export function ProviderChipGroup({ label, presets, selectedPresetId, configured
                     return (_jsxs("button", { type: "button", role: "tab", "aria-selected": active, className: 'jini-provider-chip' + (active ? ' active' : ''), title: `${preset.title} — ${configured ? configuredLabel : unsetLabel}`, onClick: () => {
                             if (!active)
                                 onSelect(preset);
-                        }, ...agentHandleProps(chipHandles?.[index], { role: 'button', label: preset.title }), children: [_jsx("span", { className: `jini-provider-chip-status${configured ? ' is-configured' : ' is-unset'}`, "aria-hidden": "true" }), _jsx("span", { children: preset.title })] }, preset.id));
+                        }, ...agentHandleProps({}, { base: chipHandles?.[index], ...({ role: 'button', label: preset.title }) }), children: [_jsx("span", { className: `jini-provider-chip-status${configured ? ' is-configured' : ' is-unset'}`, "aria-hidden": "true" }), _jsx("span", { children: preset.title })] }, preset.id));
                 }) })] }));
 }
 //# sourceMappingURL=ProviderChipGroup.js.map

package/dist/features/execution/react/components/SearchableModelSelect.js

@@ -46,7 +46,7 @@ export function SearchableModelSelect({ models, value, onChange, ariaLabel, sear
             setQuery('');
         }
     };
-    return (_jsx("div", { className: "jini-searchable-select", "data-testid": testId, ...agentHandleProps(agentHandle, { role: 'field', label: ariaLabel }), children: _jsx(CustomSelect, { value: value, options: visibleOptions, onChange: onChange, ariaLabel: ariaLabel, className: className, ...(menuClassName === undefined ? {} : { menuClassName }), onOpenChange: handleOpenChange, menuHeader: shouldShowSearch ? (_jsx("div", { className: "jini-searchable-select-search-row", children: _jsx("input", { ref: searchRef, type: "search", className: "jini-input jini-searchable-select-search", value: query, placeholder: searchPlaceholder, "aria-label": searchPlaceholder, "data-testid": searchInputTestId, 
+    return (_jsx("div", { className: "jini-searchable-select", "data-testid": testId, ...agentHandleProps({}, { base: agentHandle, ...({ role: 'field', label: ariaLabel }) }), children: _jsx(CustomSelect, { value: value, options: visibleOptions, onChange: onChange, ariaLabel: ariaLabel, className: className, ...(menuClassName === undefined ? {} : { menuClassName }), onOpenChange: handleOpenChange, menuHeader: shouldShowSearch ? (_jsx("div", { className: "jini-searchable-select-search-row", children: _jsx("input", { ref: searchRef, type: "search", className: "jini-input jini-searchable-select-search", value: query, placeholder: searchPlaceholder, "aria-label": searchPlaceholder, "data-testid": searchInputTestId, 
                     // The popover's own outside-pointerdown/keydown listeners are
                     // scoped to the menu element, so typing here never closes it
                     // — but stopping propagation keeps that explicit rather than

package/dist/features/execution/rules.js

@@ -20,7 +20,7 @@ import { API_KEY_CROSS_VENDOR_WARNING, API_KEY_TOO_SHORT_WARNING, CUSTOM_PRESET_
  * connection time.
  */
 export function isValidApiBaseUrl(raw) {
-    return isAllowedEndpointUrl(raw);
+    return isAllowedEndpointUrl({ raw });
 }
 /** The synthetic "Custom" preset, so the picker always has a manual escape
  *  hatch even when a host supplies zero presets. */

package/dist/features/file-dropzone/react/components/FileDropzone.js

@@ -30,9 +30,11 @@ export function FileDropzone({ label, prompt, helper, accept, directory = false,
     const [lightboxFile, setLightboxFile] = useState(null);
     const dropzone = useFileDropzoneHook({ onFiles, onZoneClick, onError, onProcessingStart, enablePaste });
     const previews = useFileDropzonePreviewsHook(files ?? NO_FILES);
-    useGlobalKeydown((event) => {
-        if (event.key === 'Escape')
-            setLightboxFile(null);
+    useGlobalKeydown({
+        handler: (event) => {
+            if (event.key === 'Escape')
+                setLightboxFile(null);
+        },
     }, { enabled: lightboxFile !== null });
     function onZoneKeyDown(event) {
         if (event.key === 'Enter' || event.key === ' ') {

package/dist/features/file-dropzone/react/hooks/useFileDropzone.d.ts

@@ -37,7 +37,7 @@ export interface UseFileDropzoneResult {
  * cancel-vs-still-loading detection heuristic, via `useFileDialogTracking`),
  * an optional page-wide clipboard-paste listener, and the shared
  * large-selection loading-affordance heuristic that gates all of the above
- * except paste. See `packages/ui/source-map.md` for the full consolidation
+ * except paste. See `packages/ui/archived provenance ledger` for the full consolidation
  * writeup and which origin file contributed which piece.
  */
 export declare function useFileDropzone({ onFiles, onZoneClick, onError, onProcessingStart, enablePaste, }: UseFileDropzoneParams): UseFileDropzoneResult;

package/dist/features/file-dropzone/react/hooks/useFileDropzone.js

@@ -18,7 +18,7 @@ function runAfterNextPaint(callback) {
  * cancel-vs-still-loading detection heuristic, via `useFileDialogTracking`),
  * an optional page-wide clipboard-paste listener, and the shared
  * large-selection loading-affordance heuristic that gates all of the above
- * except paste. See `packages/ui/source-map.md` for the full consolidation
+ * except paste. See `packages/ui/archived provenance ledger` for the full consolidation
  * writeup and which origin file contributed which piece.
  */
 export function useFileDropzone({ onFiles, onZoneClick, onError, onProcessingStart, enablePaste = false, }) {

package/dist/features/file-dropzone/types.d.ts

@@ -2,7 +2,7 @@
  * Pure types for the file-dropzone feature. No React.
  *
  * Consolidates two independent OD file-staging zones into one
- * primitive (see `packages/ui/source-map.md` for the full consolidation
+ * primitive (see `packages/ui/archived provenance ledger` for the full consolidation
  * writeup): `DesignSystemAssetDropzone.tsx` (a rich, kind-aware thumbnail
  * grid over staged `File[]`) and `DesignSystemFlow.tsx`'s `DropZone` (a
  * labeled, prompt-driven zone with a file-dialog cancel-vs-still-loading

package/dist/features/file-dropzone/types.js

@@ -2,7 +2,7 @@
  * Pure types for the file-dropzone feature. No React.
  *
  * Consolidates two independent OD file-staging zones into one
- * primitive (see `packages/ui/source-map.md` for the full consolidation
+ * primitive (see `packages/ui/archived provenance ledger` for the full consolidation
  * writeup): `DesignSystemAssetDropzone.tsx` (a rich, kind-aware thumbnail
  * grid over staged `File[]`) and `DesignSystemFlow.tsx`'s `DropZone` (a
  * labeled, prompt-driven zone with a file-dialog cancel-vs-still-loading

package/dist/features/folder-path-drop/react/hooks/useFolderPathDropCapture.js

@@ -9,10 +9,12 @@ import { captureFolderPathDrop } from '../../rules.js';
  * @complexity Time: O(n) in the number of dragged items per drop; space: O(n).
  */
 export function useFolderPathDropCapture({ port, composer, onFolderPaths, }) {
-    return useStableHandler((event) => {
-        const paths = captureFolderPathDrop({ event, port, composer });
-        if (paths.length > 0)
-            onFolderPaths?.(paths);
+    return useStableHandler({
+        handler: (event) => {
+            const paths = captureFolderPathDrop({ event, port, composer });
+            if (paths.length > 0)
+                onFolderPaths?.(paths);
+        },
     });
 }
 //# sourceMappingURL=useFolderPathDropCapture.js.map

package/dist/features/html-editor/canvas-content-wrapper.js

@@ -26,7 +26,7 @@
 /** Marks the outermost wrapper element this module inserts, so a second call (defensive — the
  *  caller's `load` handler should fire once per mount, but re-entrancy here would otherwise nest a
  *  second copy around the first) detects the existing wrapper and no-ops instead of double-wrapping. */
-const WRAPPER_ROOT_MARKER = 'data-tovu-canvas-wrapper-root';
+const WRAPPER_ROOT_MARKER = 'data-jini-canvas-wrapper-root';
 /**
  * Builds one chain level's element and applies its attributes verbatim via `setAttribute` — plain
  * HTML attribute names/values from the host's own template markup (`class`, `data-reveal`, …), not

package/dist/features/html-editor/canvas-embed-placeholders.js

@@ -41,12 +41,12 @@
 /** Marks a placeholder card's own root, so a later pass (this function called again, or a re-entrant
  *  `load`) can recognize an already-decorated marker via `el.closest` and skip it — see this file's
  *  header. */
-const CARD_ROOT_MARKER = 'data-tovu-embed-placeholder-root';
+const CARD_ROOT_MARKER = 'data-jini-embed-placeholder-root';
 /** Flags every child the card itself builds (icon, text), so the one unflagged child is always the
  *  marker. {@link OVERLAY_RULE} and the stale-card check in `removeStaleCards` both rely on it. */
-const CARD_CHROME_MARKER = 'data-tovu-embed-placeholder-chrome';
+const CARD_CHROME_MARKER = 'data-jini-embed-placeholder-chrome';
 /** Identifies the one `<style>` this module adds to the canvas document's `<head>`. */
-const OVERLAY_STYLE_MARKER = 'data-tovu-embed-placeholder-style';
+const OVERLAY_STYLE_MARKER = 'data-jini-embed-placeholder-style';
 /**
  * Stretches the (empty) marker over its card as a transparent overlay, so a click anywhere on the card
  * lands on the marker element itself. GrapesJS resolves a click by walking up from the event target to
@@ -71,10 +71,10 @@ const CARD_STYLE = [
     'align-items:flex-start',
     'gap:8px',
     'box-sizing:border-box',
-    'border:2px dashed #f59e0b',
+    'border:2px dashed var(--jini-warning)',
     'border-radius:8px',
-    'background:#1f2937',
-    'color:#f9fafb',
+    'background:var(--jini-surface)',
+    'color:var(--jini-text)',
     'padding:10px 12px',
     "font:13px/1.4 -apple-system,BlinkMacSystemFont,'Segoe UI',sans-serif",
 ].join(';');
@@ -89,7 +89,7 @@ function buildPlaceholderIcon(doc) {
     icon.setAttribute('height', '18');
     icon.setAttribute('viewBox', '0 0 24 24');
     icon.setAttribute('fill', 'none');
-    icon.setAttribute('stroke', '#f59e0b');
+    icon.setAttribute('stroke', 'var(--jini-warning)');
     icon.setAttribute('stroke-width', '2');
     icon.setAttribute('style', 'flex-shrink:0;margin-top:1px;');
     const rect = doc.createElementNS(SVG_NS, 'rect');

package/dist/features/html-editor/canvas-style.d.ts

@@ -1,3 +1,4 @@
+import type { AdminTheme, ColorScheme } from '../../theme/types.js';
 /**
  * @file Builds the `canvas.frameStyle` GrapesJS injects into its editing canvas, so a host that
  * supplies its own canvas styling is not silently overruled by GrapesJS's own defaults.
@@ -30,6 +31,9 @@ export interface CanvasContentWrapperNode {
 /** What a host wants the canvas document styled with. All fields optional; supplying none is the
  *  "GrapesJS defaults" case. */
 export interface CanvasStyling {
+    /** Explicit theme data for isolated editor chrome; edited page styles remain host-owned. */
+    adminTheme?: AdminTheme;
+    colorScheme?: ColorScheme;
     /** Stylesheet URLs, appended to the canvas document's `<head>` as `<link>` elements by GrapesJS
      *  (`canvas.styles`). Not included in the editor's exported HTML. */
     stylesheets?: readonly string[];

package/dist/features/html-editor/canvas-style.js

@@ -1,30 +1,15 @@
-/**
- * @file Builds the `canvas.frameStyle` GrapesJS injects into its editing canvas, so a host that
- * supplies its own canvas styling is not silently overruled by GrapesJS's own defaults.
- *
- * GrapesJS injects `canvas.frameStyle` as a `<style>` element in the canvas document's **`<body>`**,
- * after everything `canvas.styles` puts in `<head>` — confirmed live in Chrome by reading
- * `iframe.contentDocument`: the head held only the host's `<link>`, and the `body { background-color:
- * #fff }` rule that beat it sat in a body-level `<style>`. Its default value therefore wins the
- * cascade against any host stylesheet that sets a body background, at equal specificity, purely on
- * document order. Left alone, a host loading a dark theme's stylesheet into the canvas gets that
- * theme's near-white `color` on GrapesJS's hardcoded white background — white-on-white text, which is
- * strictly worse than the unstyled canvas it replaced.
- *
- * So the white body background is emitted only when the host supplies no canvas styling of its own.
- * The scrollbar rules are kept either way: they are chrome for GrapesJS's own scrolling canvas, not a
- * statement about the edited document.
- */
+import { defaultAdminTheme } from '../../theme/default.js';
+import { renderAdminThemeVariables } from '../../theme/stylesheet.js';
 /** GrapesJS's own default scrollbar chrome for the canvas, restated verbatim from its
  *  `canvas.frameStyle` default so overriding that option does not silently drop it. */
 const CANVAS_SCROLLBAR_STYLE = [
-    "* ::-webkit-scrollbar-track { background: rgba(0, 0, 0, 0.1) }",
-    "* ::-webkit-scrollbar-thumb { background: rgba(255, 255, 255, 0.2) }",
+    "* ::-webkit-scrollbar-track { background: color-mix(in srgb, var(--jini-text) 10%, transparent) }",
+    "* ::-webkit-scrollbar-thumb { background: color-mix(in srgb, var(--jini-bg) 20%, transparent) }",
     "* ::-webkit-scrollbar { width: 10px }",
 ].join("\n");
 /** The half of GrapesJS's default `canvas.frameStyle` this module conditionally drops — see the file
  *  header for why it cannot simply be left in place. */
-const CANVAS_DEFAULT_BODY_BACKGROUND = "body { background-color: #fff }";
+const CANVAS_DEFAULT_BODY_BACKGROUND = 'body { background-color: var(--jini-bg) }';
 /**
  * CSS class the canvas body carries while `react/hooks/useInteractiveHtmlEditor.ts`'s
  * `revealCanvasWhenStylesheetsSettle` is still waiting on `canvas.styles`' `<link>` elements to settle
@@ -54,7 +39,7 @@ function hostStylesTheCanvas(styling) {
  * and followed by the host's raw `css` when supplied.
  */
 function buildCanvasFrameStyle(styling) {
-    const rules = [CANVAS_SCROLLBAR_STYLE, CANVAS_STYLES_PENDING_RULE];
+    const rules = [renderAdminThemeVariables({ theme: styling.adminTheme ?? defaultAdminTheme }, { ...(styling.colorScheme ? { colorScheme: styling.colorScheme } : {}) }), CANVAS_SCROLLBAR_STYLE, CANVAS_STYLES_PENDING_RULE];
     if (!hostStylesTheCanvas(styling))
         rules.unshift(CANVAS_DEFAULT_BODY_BACKGROUND);
     if (styling.css)

package/dist/features/html-viewer/constants.d.ts

@@ -1,6 +1,6 @@
 /**
  * A fresh, neutral `postMessage` protocol for deck navigation — deliberately
- * NOT OD's `od:slide`/`od:slide-state` (see `packages/ui/source-map.md`'s
+ * NOT OD's `od:slide`/`od:slide-state` (see `packages/ui/archived provenance ledger`'s
  * `html-viewer` classification: the real bridge's 31 message types across 3
  * naming conventions need a redesign, not a rename). Any sandboxed deck
  * content this feature drives must speak this protocol:

package/dist/features/html-viewer/constants.js

@@ -1,6 +1,6 @@
 /**
  * A fresh, neutral `postMessage` protocol for deck navigation — deliberately
- * NOT OD's `od:slide`/`od:slide-state` (see `packages/ui/source-map.md`'s
+ * NOT OD's `od:slide`/`od:slide-state` (see `packages/ui/archived provenance ledger`'s
  * `html-viewer` classification: the real bridge's 31 message types across 3
  * naming conventions need a redesign, not a rename). Any sandboxed deck
  * content this feature drives must speak this protocol:

package/dist/features/html-viewer/react/components/PresentMenu.js

@@ -7,7 +7,7 @@ export function PresentMenu({ disabled, onPresentInline, onPresentFullscreen, on
     const t = useT();
     const [open, setOpen] = useState(false);
     const wrapRef = useRef(null);
-    useDismissOnOutsideOrEscape(() => setOpen(false), { enabled: open, containerRef: wrapRef });
+    useDismissOnOutsideOrEscape({ onDismiss: () => setOpen(false) }, { enabled: open, containerRef: wrapRef });
     function select(action) {
         setOpen(false);
         action();

package/dist/features/html-viewer/react/components/ZoomMenu.js

@@ -6,7 +6,7 @@ import { useT } from '../../../i18n/index.js';
 export function ZoomMenu({ zoom, levels, isOpen, onToggle, onClose, onSelect }) {
     const t = useT();
     const wrapRef = useRef(null);
-    useDismissOnOutsideOrEscape(onClose, { enabled: isOpen, containerRef: wrapRef });
+    useDismissOnOutsideOrEscape({ onDismiss: onClose }, { enabled: isOpen, containerRef: wrapRef });
     return (_jsxs("div", { className: "jini-zoom-menu", ref: wrapRef, children: [_jsx("button", { type: "button", className: "jini-zoom-trigger", "aria-haspopup": "menu", "aria-expanded": isOpen, title: t('Reset zoom'), onClick: onToggle, children: _jsxs("span", { style: { fontVariantNumeric: 'tabular-nums' }, children: [zoom, "%"] }) }), isOpen ? (_jsx("div", { className: "jini-zoom-menu-popover", role: "menu", children: levels.map((level) => (_jsx("button", { type: "button", className: `jini-zoom-menu-item${zoom === level ? ' active' : ''}`, role: "menuitem", onClick: () => onSelect(level), children: _jsxs("span", { style: { fontVariantNumeric: 'tabular-nums' }, children: [level, "%"] }) }, level))) })) : null] }));
 }
 //# sourceMappingURL=ZoomMenu.js.map

package/dist/features/html-viewer/types.d.ts

@@ -1,6 +1,6 @@
 /**
  * Deck/slide-navigation + zoom + present slice of the classified `HtmlViewer`
- * god-component — see `packages/ui/source-map.md`'s `html-viewer`
+ * god-component — see `packages/ui/archived provenance ledger`'s `html-viewer`
  * classification section for the full disposition. This slice ships only
  * the pieces that classification found GENERIC with low coupling to the
  * rest of `HtmlViewer` (deck navigation, the zoom-percentage control, and

package/dist/features/html-viewer/types.js

@@ -1,6 +1,6 @@
 /**
  * Deck/slide-navigation + zoom + present slice of the classified `HtmlViewer`
- * god-component — see `packages/ui/source-map.md`'s `html-viewer`
+ * god-component — see `packages/ui/archived provenance ledger`'s `html-viewer`
  * classification section for the full disposition. This slice ships only
  * the pieces that classification found GENERIC with low coupling to the
  * rest of `HtmlViewer` (deck navigation, the zoom-percentage control, and

package/dist/features/i18n/dictionaries/index.d.ts

@@ -4,11 +4,10 @@
  * translation.
  *
  * This is a SEPARATE i18n system from any Jini-consuming host's own
- * dictionaries (e.g. a host product's `apps/admin/src/lib/i18n-common.ts` +
- * `apps/admin/src/lib/dictionary-translator.ts` + one `*-i18n.ts` file per
+ * dictionaries (shared host translations, the host's translator and one dictionary per
  * admin feature) -- deliberately so, since this package is meant to be
  * reusable across hosts and a host's own product copy has no reason to ship
- * inside it (see that repo's i18n-common.ts for the fuller reasoning). They
+ * inside it (host copy belongs to the host). They
  * share the same underlying shape/convention (`Record<locale, Record<key,
  * string>>`, translated-value-else-raw-key fallback) by design, so adding a
  * language to one is a close parallel to adding it to the other, but they are

package/dist/features/i18n/dictionaries/settings-dialog.en.d.ts

@@ -3,7 +3,7 @@
  *
  * Covers every literal `t()` key actually called by the 13 tabs the reference
  * implementation (the first host to adopt this) mounts in its admin settings panel, plus every
- * component those tabs compose (see `packages/ui/source-map.md` companion
+ * component those tabs compose (see `packages/ui/archived provenance ledger` companion
  * note in `dictionaries/README` for the enumeration method: a full read of
  * each mounted component's source, cross-checked with a regex extraction
  * pass over every `t('...')`/`t("...")` call site, plus manual tracing of

package/dist/features/i18n/dictionary-translator.d.ts

@@ -0,0 +1,16 @@
+/** A dictionary indexed by caller-defined locale and English source key. */
+export type LocaleDictionary = Readonly<Record<string, Readonly<Record<string, string>>>>;
+/** Locale-bound translation injected into a widget or panel hook. */
+export type Translate = (key: string) => string;
+export type DictionaryTranslator = (required: {
+    locale: string;
+    key: string;
+}) => string;
+/** Feature copy wins over the host's common copy, then falls back to the source key.
+ * No locale context or product dictionary is installed by this helper. */
+export declare function createDictionaryTranslator({ featureDictionary }: {
+    featureDictionary: LocaleDictionary;
+}, { commonDictionary }?: {
+    commonDictionary?: LocaleDictionary | undefined;
+}): DictionaryTranslator;
+//# sourceMappingURL=dictionary-translator.d.ts.map

package/dist/features/i18n/dictionary-translator.js

@@ -0,0 +1,14 @@
+function lookup(dictionary, locale, key) {
+    if (!Object.hasOwn(dictionary, locale))
+        return undefined;
+    const block = dictionary[locale];
+    return block && Object.hasOwn(block, key) ? block[key] : undefined;
+}
+// Centralize fallback once: small feature dictionaries inherit shared Save/Cancel/Delete copy,
+// and misses remain readable English source keys rather than raw dictionary-miss placeholders.
+/** Feature copy wins over the host's common copy, then falls back to the source key.
+ * No locale context or product dictionary is installed by this helper. */
+export function createDictionaryTranslator({ featureDictionary }, { commonDictionary = {} } = {}) {
+    return ({ locale, key }) => lookup(featureDictionary, locale, key) ?? lookup(commonDictionary, locale, key) ?? key;
+}
+//# sourceMappingURL=dictionary-translator.js.map

package/dist/features/i18n/index.d.ts

@@ -5,4 +5,7 @@ export { I18nProvider, useI18n, useT } from './context.js';
 export type { I18nProviderProps, I18nContextValue } from './context.js';
 export { SETTINGS_DIALOG_EN, SETTINGS_DIALOG_ES, SETTINGS_DIALOG_DICTIONARIES, } from './dictionaries/index.js';
 export type { SettingsDialogDict } from './dictionaries/index.js';
+export { createDictionaryTranslator } from './dictionary-translator.js';
+export type { Translate, DictionaryTranslator, LocaleDictionary } from './dictionary-translator.js';
+export { interpolate, splitOnPlaceholders, pickPlural } from './template-i18n.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/features/i18n/index.js

@@ -1,4 +1,6 @@
 export { detectInitialLocale, resolveSystemLocale, defaultDetectSystemLocale, } from './locale.js';
 export { I18nProvider, useI18n, useT } from './context.js';
 export { SETTINGS_DIALOG_EN, SETTINGS_DIALOG_ES, SETTINGS_DIALOG_DICTIONARIES, } from './dictionaries/index.js';
+export { createDictionaryTranslator } from './dictionary-translator.js';
+export { interpolate, splitOnPlaceholders, pickPlural } from './template-i18n.js';
 //# sourceMappingURL=index.js.map

package/dist/features/i18n/locale.d.ts

@@ -5,7 +5,7 @@
  * a React tree.
  *
  * Origin: `i18n/index.tsx`'s `resolveSystemLocale`/`detectInitialLocale` in
- * the vendored OD web tree. Genericized — see `packages/ui/source-map.md`
+ * the vendored OD web tree. Genericized — see `packages/ui/archived provenance ledger`
  * for the full accounting of what was dropped (OD's hard-coded 19-locale
  * list, the desktop-host OS-locale bridge, the manual-vs-auto-detected
  * localStorage tagging).

package/dist/features/i18n/template-i18n.d.ts

@@ -0,0 +1,26 @@
+/** Parameterized messages belong in locale data too: branching on locale in every interpolation
+ * helper would require editing every caller to add a language, instead of adding templates. */
+export declare function interpolate({ template, vars }: {
+    template: string;
+    vars: Record<string, string | number>;
+}): string;
+/**
+ * Split around placeholders when values must be rendered as nodes, such as inline code naming
+ * a destructive action's target; plain string interpolation cannot insert those nodes.
+ * Missing/mistyped locale tokens collapse the remaining text into one segment, followed by
+ * empty segments, so a translation defect does not crash its dialog.
+ */
+export declare function splitOnPlaceholders({ template, tokens }: {
+    template: string;
+    tokens: readonly string[];
+}): string[];
+/** Only singular versus other; this is not full CLDR pluralization. Languages needing more than
+ * two forms require a richer mechanism rather than being forced into these two templates. */
+export declare function pickPlural({ count, forms }: {
+    count: number;
+    forms: {
+        one: string;
+        other: string;
+    };
+}): string;
+//# sourceMappingURL=template-i18n.d.ts.map

package/dist/features/i18n/template-i18n.js

@@ -0,0 +1,36 @@
+/** Parameterized messages belong in locale data too: branching on locale in every interpolation
+ * helper would require editing every caller to add a language, instead of adding templates. */
+export function interpolate({ template, vars }) {
+    return template.replace(/\{(\w+)\}/g, (match, key) => {
+        return key in vars ? String(vars[key]) : match;
+    });
+}
+/**
+ * Split around placeholders when values must be rendered as nodes, such as inline code naming
+ * a destructive action's target; plain string interpolation cannot insert those nodes.
+ * Missing/mistyped locale tokens collapse the remaining text into one segment, followed by
+ * empty segments, so a translation defect does not crash its dialog.
+ */
+export function splitOnPlaceholders({ template, tokens }) {
+    const segments = [];
+    let rest = template;
+    for (const token of tokens) {
+        const index = rest.indexOf(token);
+        if (index === -1) {
+            segments.push(rest);
+            rest = "";
+        }
+        else {
+            segments.push(rest.slice(0, index));
+            rest = rest.slice(index + token.length);
+        }
+    }
+    segments.push(rest);
+    return segments;
+}
+/** Only singular versus other; this is not full CLDR pluralization. Languages needing more than
+ * two forms require a richer mechanism rather than being forced into these two templates. */
+export function pickPlural({ count, forms }) {
+    return count === 1 ? forms.one : forms.other;
+}
+//# sourceMappingURL=template-i18n.js.map

package/dist/features/iframe-pool/react/components/IframeKeepAliveProvider.d.ts

@@ -6,7 +6,7 @@ interface IframeKeepAliveProviderProps {
 }
 /**
  * Caps how many iframes stay mounted at once: attached iframes go live under
- * their host element; released ones are parked off-DOM (hidden, inert)
+ * their host element; released ones are parked in a mounted pool container (hidden, inert)
  * instead of destroyed, so revisiting the same key skips a reload; least-
  * recently-used parked entries are evicted once the pool exceeds
  * `maxMounted`. Active entries are never evicted.

package/dist/features/iframe-pool/react/components/IframeKeepAliveProvider.js

@@ -6,7 +6,7 @@ import { parkIframeElement, unparkIframeElement } from '../dom-sync.js';
 import { IframeKeepAliveContext } from '../pool-context.js';
 /**
  * Caps how many iframes stay mounted at once: attached iframes go live under
- * their host element; released ones are parked off-DOM (hidden, inert)
+ * their host element; released ones are parked in a mounted pool container (hidden, inert)
  * instead of destroyed, so revisiting the same key skips a reload; least-
  * recently-used parked entries are evicted once the pool exceeds
  * `maxMounted`. Active entries are never evicted.

package/dist/features/instructions/react/components/InstructionsTab.js

@@ -12,6 +12,6 @@ export function InstructionsTab({ value, onChange, title, description, placehold
     const resolvedTitle = title ?? t('Custom instructions');
     const resolvedDescription = description ?? t('Extra instructions applied to every conversation, in addition to any per-project instructions.');
     const resolvedPlaceholder = placeholder ?? t('e.g. Always respond concisely and avoid unnecessary caveats.');
-    return (_jsx("section", { className: "jini-settings-section jini-settings-section-card jini-instructions-section", children: _jsxs("div", { className: "jini-field-block jini-instructions-card", children: [_jsx("div", { className: "jini-block-head", children: _jsxs("div", { children: [_jsx("h4", { children: resolvedTitle }), _jsx("p", { className: "jini-hint", children: resolvedDescription })] }) }), _jsx("textarea", { className: "jini-custom-instructions-input jini-instructions-input", rows: rows, maxLength: maxLength, placeholder: resolvedPlaceholder, "aria-label": resolvedTitle, value: value, onChange: (event) => onChange(event.target.value || undefined), ...agentHandleProps(agentHandle, { role: 'field', label: resolvedTitle }) })] }) }));
+    return (_jsx("section", { className: "jini-settings-section jini-settings-section-card jini-instructions-section", children: _jsxs("div", { className: "jini-field-block jini-instructions-card", children: [_jsx("div", { className: "jini-block-head", children: _jsxs("div", { children: [_jsx("h4", { children: resolvedTitle }), _jsx("p", { className: "jini-hint", children: resolvedDescription })] }) }), _jsx("textarea", { className: "jini-custom-instructions-input jini-instructions-input", rows: rows, maxLength: maxLength, placeholder: resolvedPlaceholder, "aria-label": resolvedTitle, value: value, onChange: (event) => onChange(event.target.value || undefined), ...agentHandleProps({}, { base: agentHandle, ...({ role: 'field', label: resolvedTitle }) }) })] }) }));
 }
 //# sourceMappingURL=InstructionsTab.js.map

package/dist/features/integrations/react/components/ClientPicker.js

@@ -14,7 +14,7 @@ export function ClientPicker({ clients, selectedClientId, onSelect, methodLabel,
     const rootRef = useRef(null);
     const selected = clients.find((c) => c.id === selectedClientId) ?? clients[0];
     const optionHandles = agentHandle
-        ? buildAgentListHandles(agentSubHandle(agentHandle, 'option'), clients.map((c) => c.id))
+        ? buildAgentListHandles({ prefix: agentSubHandle({ base: agentHandle, action: 'option' }), ids: clients.map((c) => c.id) })
         : undefined;
     // Close on outside click or Escape — routed through the shared
     // `useDismissOnOutsideOrEscape` toolbox hook (packages/ui/src/browser/)
@@ -23,13 +23,13 @@ export function ClientPicker({ clients, selectedClientId, onSelect, methodLabel,
     // popover/dropdown call site — see that hook's own doc comment), a
     // behaviorally-equivalent upgrade for this same dismiss-on-outside-click
     // pattern.
-    useDismissOnOutsideOrEscape(() => setOpen(false), { enabled: open, containerRef: rootRef });
-    return (_jsxs("div", { className: "jini-picker", ref: rootRef, children: [_jsxs("button", { type: "button", className: `jini-picker-trigger${open ? ' open' : ''}`, onClick: () => setOpen((v) => !v), "aria-haspopup": "listbox", "aria-expanded": open, ...agentHandleProps(agentHandle, { action: 'trigger', role: 'button', label: selected ? t(selected.label) : t('Client') }), children: [_jsxs("span", { className: "jini-picker-meta", children: [_jsx("span", { className: "jini-picker-title", children: selected ? t(selected.label) : '' }), methodLabel ? _jsx("span", { className: "jini-picker-sub", children: methodLabel }) : null] }), _jsx(Icon, { name: "chevron-down", size: 14, className: "jini-picker-chevron", style: { transform: open ? 'rotate(180deg)' : undefined } })] }), open ? (_jsx("div", { className: "jini-picker-popover", role: "listbox", children: _jsx("div", { className: "jini-picker-list", children: clients.map((client, index) => {
+    useDismissOnOutsideOrEscape({ onDismiss: () => setOpen(false) }, { enabled: open, containerRef: rootRef });
+    return (_jsxs("div", { className: "jini-picker", ref: rootRef, children: [_jsxs("button", { type: "button", className: `jini-picker-trigger${open ? ' open' : ''}`, onClick: () => setOpen((v) => !v), "aria-haspopup": "listbox", "aria-expanded": open, ...agentHandleProps({}, { base: agentHandle, ...({ action: 'trigger', role: 'button', label: selected ? t(selected.label) : t('Client') }) }), children: [_jsxs("span", { className: "jini-picker-meta", children: [_jsx("span", { className: "jini-picker-title", children: selected ? t(selected.label) : '' }), methodLabel ? _jsx("span", { className: "jini-picker-sub", children: methodLabel }) : null] }), _jsx(Icon, { name: "chevron-down", size: 14, className: "jini-picker-chevron", style: { transform: open ? 'rotate(180deg)' : undefined } })] }), open ? (_jsx("div", { className: "jini-picker-popover", role: "listbox", children: _jsx("div", { className: "jini-picker-list", children: clients.map((client, index) => {
                         const active = client.id === selectedClientId;
                         return (_jsxs("button", { type: "button", role: "option", "aria-selected": active, className: `jini-picker-item${active ? ' active' : ''}`, onClick: () => {
                                 onSelect(client.id);
                                 setOpen(false);
-                            }, ...agentHandleProps(optionHandles?.[index], { role: 'button', label: t(client.label) }), children: [_jsx("span", { className: "jini-picker-item-title", children: t(client.label) }), methodLabels?.[client.id] ? (_jsx("span", { className: "jini-picker-item-sub", children: methodLabels[client.id] })) : null] }, client.id));
+                            }, ...agentHandleProps({}, { base: optionHandles?.[index], ...({ role: 'button', label: t(client.label) }) }), children: [_jsx("span", { className: "jini-picker-item-title", children: t(client.label) }), methodLabels?.[client.id] ? (_jsx("span", { className: "jini-picker-item-sub", children: methodLabels[client.id] })) : null] }, client.id));
                     }) }) })) : null] }));
 }
 //# sourceMappingURL=ClientPicker.js.map

package/dist/features/integrations/react/components/CodexInstallToggleButton.js

@@ -17,6 +17,6 @@ export function CodexInstallToggleButton({ port, agentHandle }) {
         return (_jsxs("div", { className: "jini-codex-install-row", children: [_jsx("button", { type: "button", className: "jini-button", disabled: true, children: t('One-click install') }), _jsx("span", { className: "jini-hint", children: t('Not available for this daemon.') })] }));
     }
     const label = installed ? t('Uninstall') : t('One-click install');
-    return (_jsxs("div", { className: "jini-codex-install-row", children: [_jsx("button", { type: "button", className: installed ? 'jini-button' : 'jini-button jini-button-primary', disabled: busy, onClick: toggle, ...agentHandleProps(agentHandle, { role: 'button', label }), children: busy ? t('Working…') : label }), error ? _jsx("span", { className: "jini-hint jini-hint-error", children: t('Install failed: {error}', { error }) }) : null, !error && successKind === 'installed' ? _jsx("span", { className: "jini-hint", children: t('MCP server installed.') }) : null, !error && successKind === 'uninstalled' ? _jsx("span", { className: "jini-hint", children: t('MCP server uninstalled.') }) : null] }));
+    return (_jsxs("div", { className: "jini-codex-install-row", children: [_jsx("button", { type: "button", className: installed ? 'jini-button' : 'jini-button jini-button-primary', disabled: busy, onClick: toggle, ...agentHandleProps({}, { base: agentHandle, ...({ role: 'button', label }) }), children: busy ? t('Working…') : label }), error ? _jsx("span", { className: "jini-hint jini-hint-error", children: t('Install failed: {error}', { error }) }) : null, !error && successKind === 'installed' ? _jsx("span", { className: "jini-hint", children: t('MCP server installed.') }) : null, !error && successKind === 'uninstalled' ? _jsx("span", { className: "jini-hint", children: t('MCP server uninstalled.') }) : null] }));
 }
 //# sourceMappingURL=CodexInstallToggleButton.js.map

package/dist/features/integrations/react/components/IntegrationsTab.js

@@ -46,7 +46,7 @@ export function IntegrationsTab({ serverName = DEFAULT_MCP_SERVER_NAME, clients
         t('Pull context into the conversation'),
         t('Use default, safe tool permissions'),
     ];
-    return (_jsxs("section", { className: "jini-settings-section jini-settings-integrations", children: [error ? _jsx("div", { className: "jini-empty-card jini-empty-card-error", children: t('Could not reach the daemon: {error}', { error }) }) : null, _jsxs("div", { className: "jini-mcp-capabilities-card", children: [_jsx("p", { className: "jini-mcp-capabilities-label", children: resolvedCapabilitiesTitle }), _jsx("ul", { className: "jini-mcp-capabilities-list", children: resolvedCapabilities.map((line) => (_jsx("li", { children: line }, line))) })] }), _jsxs("div", { className: "jini-mcp-setup-card", children: [_jsx(ClientPicker, { clients: clients, selectedClientId: clientId, onSelect: setClientId, methodLabel: methodLabel, methodLabels: methodLabels, ...(agentHandle ? { agentHandle: agentSubHandle(agentHandle, 'client') } : {}) }), resolved ? _jsx("p", { className: "jini-mcp-instruction", children: t(resolved.instructionTemplate, resolved.instructionVars) }) : null, client?.id === 'codex' ? (_jsx(CodexInstallToggleButton, { port: resolvedPort, ...(agentHandle ? { agentHandle: agentSubHandle(agentHandle, 'codex-toggle') } : {}) })) : null, resolved?.deeplink && info ? (_jsxs("div", { className: "jini-mcp-deeplink-row", children: [_jsx("a", { className: `jini-button jini-button-primary${isMcpInstallPrerequisiteMissing(info) ? ' jini-button-disabled' : ''}`, 
+    return (_jsxs("section", { className: "jini-settings-section jini-settings-integrations", children: [error ? _jsx("div", { className: "jini-empty-card jini-empty-card-error", children: t('Could not reach the daemon: {error}', { error }) }) : null, _jsxs("div", { className: "jini-mcp-capabilities-card", children: [_jsx("p", { className: "jini-mcp-capabilities-label", children: resolvedCapabilitiesTitle }), _jsx("ul", { className: "jini-mcp-capabilities-list", children: resolvedCapabilities.map((line) => (_jsx("li", { children: line }, line))) })] }), _jsxs("div", { className: "jini-mcp-setup-card", children: [_jsx(ClientPicker, { clients: clients, selectedClientId: clientId, onSelect: setClientId, methodLabel: methodLabel, methodLabels: methodLabels, ...(agentHandle ? { agentHandle: agentSubHandle({ base: agentHandle, action: 'client' }) } : {}) }), resolved ? _jsx("p", { className: "jini-mcp-instruction", children: t(resolved.instructionTemplate, resolved.instructionVars) }) : null, client?.id === 'codex' ? (_jsx(CodexInstallToggleButton, { port: resolvedPort, ...(agentHandle ? { agentHandle: agentSubHandle({ base: agentHandle, action: 'codex-toggle' }) } : {}) })) : null, resolved?.deeplink && info ? (_jsxs("div", { className: "jini-mcp-deeplink-row", children: [_jsx("a", { className: `jini-button jini-button-primary${isMcpInstallPrerequisiteMissing(info) ? ' jini-button-disabled' : ''}`, 
                                 // Origin disables this button via `disabled={!info.cliExists ||
                                 // !info.nodeExists}` — one-click install can't work until the
                                 // daemon/CLI prerequisite is actually built. An `<a>` has no
@@ -57,6 +57,6 @@ export function IntegrationsTab({ serverName = DEFAULT_MCP_SERVER_NAME, clients
                                 href: isMcpInstallPrerequisiteMissing(info) ? undefined : resolved.deeplink, "aria-disabled": isMcpInstallPrerequisiteMissing(info) || undefined, onClick: (event) => {
                                     if (isMcpInstallPrerequisiteMissing(info))
                                         event.preventDefault();
-                                }, rel: "noopener noreferrer", ...agentHandleProps(agentHandle, { action: 'one-click-install', role: 'link', label: t('One-click install') }), children: t('One-click install') }), _jsx("span", { className: "jini-hint", children: t('Your editor will ask you to approve the install.') })] })) : null, _jsx(SnippetBlock, { snippet: resolved?.snippet ?? '', language: resolved?.language ?? 'json', placeholder: loading ? t('Loading install paths…') : error ? t('Could not resolve install paths.') : '' }), info && isMcpInstallPrerequisiteMissing(info) ? (_jsxs("div", { className: "jini-empty-card jini-empty-card-warning", children: [_jsx("strong", { children: !info.cliExists ? t('Build the server first.') : t('Node.js was not found.') }), ' ', info.buildHint ?? t('See your host application for build instructions.')] })) : null, _jsxs("div", { className: "jini-mcp-restart-note", children: [_jsx("strong", { children: t('Restart your client after installing.') }), ' ', _jsx("span", { children: t('Most MCP clients only pick up new servers on restart.') })] })] })] }));
+                                }, rel: "noopener noreferrer", ...agentHandleProps({}, { base: agentHandle, ...({ action: 'one-click-install', role: 'link', label: t('One-click install') }) }), children: t('One-click install') }), _jsx("span", { className: "jini-hint", children: t('Your editor will ask you to approve the install.') })] })) : null, _jsx(SnippetBlock, { snippet: resolved?.snippet ?? '', language: resolved?.language ?? 'json', placeholder: loading ? t('Loading install paths…') : error ? t('Could not resolve install paths.') : '' }), info && isMcpInstallPrerequisiteMissing(info) ? (_jsxs("div", { className: "jini-empty-card jini-empty-card-warning", children: [_jsx("strong", { children: !info.cliExists ? t('Build the server first.') : t('Node.js was not found.') }), ' ', info.buildHint ?? t('See your host application for build instructions.')] })) : null, _jsxs("div", { className: "jini-mcp-restart-note", children: [_jsx("strong", { children: t('Restart your client after installing.') }), ' ', _jsx("span", { children: t('Most MCP clients only pick up new servers on restart.') })] })] })] }));
 }
 //# sourceMappingURL=IntegrationsTab.js.map

package/dist/features/integrations/react/components/SnippetBlock.js

@@ -38,7 +38,7 @@ export function SnippetBlock({ snippet, language, placeholder, copyAriaLabel, co
     // dead duplicate of that same disablement; removed rather than carried
     // forward or tested around.
     async function onCopy() {
-        const ok = await copyToClipboard(snippet);
+        const ok = await copyToClipboard({ text: snippet });
         if (!ok)
             return;
         setCopied(true);

package/dist/features/integrations/types.d.ts

@@ -7,7 +7,7 @@
  * product's own MCP server name as a literal. Parameterized here as
  * `serverName` (a `McpIntegrationsPort`-agnostic caller argument, not a
  * config value) —
- * see `packages/ui/source-map.md` for the full provenance note and the
+ * see `packages/ui/archived provenance ledger` for the full provenance note and the
  * purity-grep result confirming zero hardcoded product-identity strings
  * remain.
  */

package/dist/features/integrations/types.js

@@ -7,7 +7,7 @@
  * product's own MCP server name as a literal. Parameterized here as
  * `serverName` (a `McpIntegrationsPort`-agnostic caller argument, not a
  * config value) —
- * see `packages/ui/source-map.md` for the full provenance note and the
+ * see `packages/ui/archived provenance ledger` for the full provenance note and the
  * purity-grep result confirming zero hardcoded product-identity strings
  * remain.
  */