@jini-ai/admin 0.6.15-rc.2 → 0.6.16

package/dist/seo/react/hooks/use-seo.hooks.js

@@ -27,7 +27,7 @@ export function useSeo({ api }, { t, events } = {}) {
     }, [controller, cached.query.data]);
     useEffect(() => {
         if (!controller || !events)
-            return;
+            return undefined;
         return events.subscribe({ onRefresh: () => { invalidate({ key: SEO_KEYS.settings }); } });
     }, [controller, events, invalidate]);
     return {

package/dist/seo/react/hooks/use-share-image-warning.hooks.js

@@ -18,7 +18,7 @@ export function useShareImageWarning({ value, previewUrl, api }, { t = key => ke
     useEffect(() => {
         const inspect = api.inspectShareImage;
         if (!previewUrl || !inspect || !isBrowserSameOrigin({ url: previewUrl }))
-            return;
+            return undefined;
         const controller = new AbortController();
         let active = true;
         const timeout = setTimeout(() => {

package/dist/seo/react/hooks/use-sitemap-modal.hooks.js

@@ -4,10 +4,18 @@ import { useController } from '../../../core/react/use-controller.js';
 import { createSitemapController } from '../../controllers/sitemap.controller.js';
 import { parseSitemapXml, filterSitemapEntries } from '../../rules.js';
 import { useSeoPorts } from './SeoPorts.hooks.js';
+/** Disabled outranks a failed fetch, which outranks a loaded document; anything else is still loading. */
+function sitemapStatus({ enabled, query }) {
+    if (!enabled)
+        return 'disabled';
+    if (query.error)
+        return 'error';
+    return query.data ? 'ready' : 'loading';
+}
 export function useSitemapModal({ api, enabled }, _optional = {}) {
     const cached = useSitemapQuery({ api, enabled });
     const { controller, snapshot } = useController({ create: () => createSitemapController({ api: cached.api, enabled }), dependencies: [cached.api, enabled] }, { start: ({ controller }) => { void controller.load({}); } });
-    const state = { ...(snapshot ?? { filter: '', view: 'table' }), status: !enabled ? 'disabled' : cached.query.error ? 'error' : cached.query.data ? 'ready' : 'loading', error: cached.query.error?.message ?? null, xmlText: cached.query.data?.text ?? '' };
+    const state = { ...(snapshot ?? { filter: '', view: 'table' }), status: sitemapStatus({ enabled, query: cached.query }), error: cached.query.error?.message ?? null, xmlText: cached.query.data?.text ?? '' };
     // Parse only when text/status changes, never on each filter keystroke.
     const entries = useMemo(() => state.status === 'ready' ? parseSitemapXml({ xmlText: state.xmlText }) : [], [state.status, state.xmlText]);
     const filteredEntries = useMemo(() => filterSitemapEntries({ entries, query: state.filter }), [entries, state.filter]);

package/dist/seo/react/pages/SeoPage.js

@@ -52,6 +52,12 @@ function EntryPicker({ locale, entryId, onChange, useEntryPickerHook = useWiredE
        than leaving a placeholder-only control with no name at all. The i18n key is unchanged. */
     return (_jsx("div", { className: "jini-seo-entry-picker", children: _jsx(Select, { value: entryId, onChange: onChange, options: options ?? [], placeholder: t({ locale: locale, key: "Choose an entry…" }), "aria-label": t({ locale: locale, key: "Entry" }), agentHandle: "seo-entry-picker", translate: (key) => t({ locale, key }) }) }));
 }
+/** Status-chip modifier for an issue: errors read as failures, warnings as warnings, anything else as success. */
+function issueStatusClass(severity) {
+    if (severity === "error")
+        return "failure";
+    return severity === "warning" ? "warning" : "success";
+}
 /** Read-only score + issues view (REQ-07) — exact field names read off `SeoAnalysis`/`SeoIssue`
  * (`src/seo/types.ts`), not guessed. No state of its own — only the severity sort, which lives in
  * `rules.ts` as `sortIssuesBySeverity`. */
@@ -62,7 +68,7 @@ function AnalyzePanel(props) {
     /* Heading + score pill on one line, issues as a compact list (owner, 2026-10-15: the bare
        "Score: 100 / No issues." read as unstyled text). The pill reuses the issue pills' status
        tones, so the score and the issues under it speak one colour language. */
-    return (_jsxs("section", { className: "jini-seo-analyze-panel", "aria-labelledby": "seo-analysis-heading", children: [_jsxs("div", { className: "jini-seo-analyze-head", children: [_jsx("h3", { id: "seo-analysis-heading", children: t({ locale: locale, key: "Analysis" }) }), _jsxs("span", { className: `jini-status jini-status-${tone} jini-seo-score`, children: [t({ locale: locale, key: "Score:" }), " ", _jsx("strong", { children: props.analysis.score })] })] }), sortedIssues.length === 0 ? (_jsx("p", { className: "jini-seo-analyze-empty", children: t({ locale: locale, key: "No issues." }) })) : (_jsx("ul", { className: "jini-seo-issues", children: sortedIssues.map((issue, i) => (_jsxs("li", { className: "jini-seo-issue", children: [_jsx("span", { className: `jini-status jini-status-${issue.severity === "error" ? "failure" : issue.severity === "warning" ? "warning" : "success"}`, children: issue.severity }), _jsxs("span", { className: "jini-seo-issue-text", children: [issue.message, issue.field ? _jsxs("span", { className: "jini-muted-cell", children: [" (", issue.field, ")"] }) : null] })] }, `${issue.code}-${i}`))) }))] }));
+    return (_jsxs("section", { className: "jini-seo-analyze-panel", "aria-labelledby": "seo-analysis-heading", children: [_jsxs("div", { className: "jini-seo-analyze-head", children: [_jsx("h3", { id: "seo-analysis-heading", children: t({ locale: locale, key: "Analysis" }) }), _jsxs("span", { className: `jini-status jini-status-${tone} jini-seo-score`, children: [t({ locale: locale, key: "Score:" }), " ", _jsx("strong", { children: props.analysis.score })] })] }), sortedIssues.length === 0 ? (_jsx("p", { className: "jini-seo-analyze-empty", children: t({ locale: locale, key: "No issues." }) })) : (_jsx("ul", { className: "jini-seo-issues", children: sortedIssues.map((issue, i) => (_jsxs("li", { className: "jini-seo-issue", children: [_jsx("span", { className: `jini-status jini-status-${issueStatusClass(issue.severity)}`, children: issue.severity }), _jsxs("span", { className: "jini-seo-issue-text", children: [issue.message, issue.field ? _jsxs("span", { className: "jini-muted-cell", children: [" (", issue.field, ")"] }) : null] })] }, `${issue.code}-${i}`))) }))] }));
 }
 /** Per-entry overrides edit form (REQ-06). Pre-fills from `getSeoEntry`'s resolved meta, but
  * tracks which fields the user actually touched so `putSeoEntry` only ever sends a genuine

package/dist/source-control/adapters/memory.js

@@ -3,28 +3,44 @@ export function createMemorySourceControlApi({ providers = [], credentials = []
     const catalog = Object.freeze(providers.map(p => Object.freeze({ ...p, ...(p.credential ? { credential: Object.freeze({ ...p.credential, fields: Object.freeze(p.credential.fields.map(f => Object.freeze({ ...f }))) }) } : {}) })));
     const rows = new Map(credentials.map(row => [row.id, sourceControlSummary({ row })]));
     let sequence = 0;
+    const nextSequence = () => { sequence += 1; return sequence; };
     function fail(code) { throw Object.assign(new Error(code), { code }); }
-    function checkLabel(providerId, label, id) { if (!label.trim())
-        fail('VALIDATION'); if ([...rows.values()].some(r => r.providerId === providerId && r.label === label.trim() && r.id !== id))
-        fail('DUPLICATE_LABEL'); }
+    function checkLabel(providerId, label, id) {
+        if (!label.trim())
+            fail('VALIDATION');
+        if ([...rows.values()].some(r => r.providerId === providerId && r.label === label.trim() && r.id !== id))
+            fail('DUPLICATE_LABEL');
+    }
     function validate(input) { const info = sourceControlProviders({ providers: catalog, credentials: [] }).find(p => p.id === input.providerId); if (!info || !sourceControlReady({ info, draft: { ...blankSourceControlDraft({}), token: input.token, values: input } }))
         fail('VALIDATION'); }
-    function setDefault(row) { if (row.isDefault)
-        for (const old of rows.values())
-            if (old.providerId === row.providerId && old.id !== row.id && old.isDefault)
-                rows.set(old.id, sourceControlSummary({ row: { ...old, isDefault: false } })); rows.set(row.id, sourceControlSummary({ row })); return rows.get(row.id); }
+    function setDefault(row) {
+        if (row.isDefault)
+            for (const old of rows.values())
+                if (old.providerId === row.providerId && old.id !== row.id && old.isDefault)
+                    rows.set(old.id, sourceControlSummary({ row: { ...old, isDefault: false } }));
+        rows.set(row.id, sourceControlSummary({ row }));
+        return rows.get(row.id);
+    }
     return {
         async providers(_r, o = {}) { o.signal?.throwIfAborted(); return catalog; },
         async list(_r, o = {}) { o.signal?.throwIfAborted(); return Object.freeze([...rows.values()]); },
         async create(input, o = {}) { o.signal?.throwIfAborted(); validate(input.connection); const providerId = input.connection.providerId, label = input.label.trim(); checkLabel(providerId, label); let id; do {
-            id = `memory-source-${++sequence}`;
+            id = `memory-source-${nextSequence()}`;
         } while (rows.has(id)); const timestamp = now(); return setDefault({ id, providerId, label, configured: true, isDefault: input.isDefault ?? ![...rows.values()].some(r => r.providerId === providerId), createdAt: timestamp, updatedAt: timestamp }); },
-        async update({ id, patch }, o = {}) { o.signal?.throwIfAborted(); const old = rows.get(id); if (!old)
-            fail('NOT_FOUND'); if (patch.connection) {
-            validate(patch.connection);
-            if (patch.connection.providerId !== old.providerId)
-                fail('VALIDATION');
-        } const label = (patch.label ?? old.label).trim(); checkLabel(old.providerId, label, id); return setDefault({ ...old, label, isDefault: patch.isDefault ?? old.isDefault, updatedAt: now() }); },
+        async update({ id, patch }, o = {}) {
+            o.signal?.throwIfAborted();
+            const old = rows.get(id);
+            if (!old)
+                fail('NOT_FOUND');
+            if (patch.connection) {
+                validate(patch.connection);
+                if (patch.connection.providerId !== old.providerId)
+                    fail('VALIDATION');
+            }
+            const label = (patch.label ?? old.label).trim();
+            checkLabel(old.providerId, label, id);
+            return setDefault({ ...old, label, isDefault: patch.isDefault ?? old.isDefault, updatedAt: now() });
+        },
         async remove({ id }, o = {}) { o.signal?.throwIfAborted(); const old = rows.get(id); rows.delete(id); if (old?.isDefault) {
             const next = [...rows.values()].find(r => r.providerId === old.providerId);
             if (next)

package/dist/source-control/controllers/source-control.controller.js

@@ -4,7 +4,9 @@ import { blankSourceControlDraft, sourceControlProviders, defaultSourceControlCr
 function readySaveTarget({ state, providerId }) {
     const draft = state.drafts[providerId] ?? blankSourceControlDraft({});
     const info = sourceControlProviders({ providers: state.providers, credentials: state.credentials }).find(p => p.id === providerId);
-    return state.loaded && !draft.saving && info && sourceControlReady({ info, draft }) ? { info, draft } : null;
+    if (!state.loaded || draft.saving || !info)
+        return null;
+    return sourceControlReady({ info, draft }) ? { info, draft } : null;
 }
 /** Replaces the row with `summary`'s id in place, or appends `summary` when it is new. */
 function spliceCredential({ credentials, summary }) {
@@ -20,7 +22,8 @@ export function createSourceControlController({ api, permissions = [] }, _option
     async function load(_required, _optional = {}) {
         if (!canRead())
             return;
-        const ticket = ++generation, revision = credentialRevision;
+        generation += 1;
+        const ticket = generation, revision = credentialRevision;
         store.set({ patch: { loading: true } });
         // Catalog failure must not hide saved connections; retain each successful store independently.
         await Promise.all([

package/dist/source-control/react/components/SourceControlProviderRow.js

@@ -1,7 +1,12 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { Notice } from '@jini-ai/ui-kit/react';
 import { SourceControlCredentialFields } from './SourceControlCredentialFields.js';
+function providerRowBody(row) {
+    if (row.unlisted)
+        return _jsx(Notice, { children: "Its plugin is off or missing. Manage this token on the Access tokens page." });
+    return row.canEdit ? _jsx(SourceControlCredentialFields, { row: row }) : _jsx(Notice, { children: "Read-only connection" });
+}
 export function SourceControlProviderRow({ row }, _optional = {}) {
-    return _jsxs("details", { name: "jini-source-control-provider", open: row.defaultOpen, "data-jini-part": "source-control.provider", children: [_jsxs("summary", { children: [_jsx("h2", { children: row.heading }), row.saved && _jsxs(_Fragment, { children: [_jsx("span", { children: "Token saved" }), _jsxs("span", { children: ["Saved ", row.saved.updatedAt] }), _jsx("span", { children: "Replace token \u25BE" })] }), !row.saved && _jsx("span", { children: "Expand \u25BE" })] }), row.unlisted ? _jsx(Notice, { children: "Its plugin is off or missing. Manage this token on the Access tokens page." }) : row.canEdit ? _jsx(SourceControlCredentialFields, { row: row }) : _jsx(Notice, { children: "Read-only connection" })] });
+    return _jsxs("details", { name: "jini-source-control-provider", open: row.defaultOpen, "data-jini-part": "source-control.provider", children: [_jsxs("summary", { children: [_jsx("h2", { children: row.heading }), row.saved && _jsxs(_Fragment, { children: [_jsx("span", { children: "Token saved" }), _jsxs("span", { children: ["Saved ", row.saved.updatedAt] }), _jsx("span", { children: "Replace token \u25BE" })] }), !row.saved && _jsx("span", { children: "Expand \u25BE" })] }), providerRowBody(row)] });
 }
 //# sourceMappingURL=SourceControlProviderRow.js.map

package/dist/source-control/react/hooks/SourceControlPorts.hooks.js

@@ -1,6 +1,10 @@
 import { createContext, useContext } from 'react';
 import { AdminConfigError } from '../../../core/module/index.js';
 export const SourceControlPortsContext = createContext(null);
-export function useSourceControlPorts(_required = {}, _optional = {}) { const ports = useContext(SourceControlPortsContext); if (!ports)
-    throw new AdminConfigError({ issues: ['React scope unavailable: source-control'] }); return ports; }
+export function useSourceControlPorts(_required = {}, _optional = {}) {
+    const ports = useContext(SourceControlPortsContext);
+    if (!ports)
+        throw new AdminConfigError({ issues: ['React scope unavailable: source-control'] });
+    return ports;
+}
 //# sourceMappingURL=SourceControlPorts.hooks.js.map

package/dist/source-control/rules.js

@@ -22,9 +22,15 @@ export function buildSourceControlConnection({ info, draft }, _optional = {}) {
 }
 /** Explicit projection prevents accidental token, ciphertext or username disclosure. */
 export function sourceControlSummary({ row }, _optional = {}) { return Object.freeze({ id: row.id, providerId: row.providerId, label: row.label, configured: true, isDefault: row.isDefault, createdAt: row.createdAt, updatedAt: row.updatedAt }); }
-export function sourceControlErrorMessage({ error }, _optional = {}) { const e = error; const marker = e?.code ?? e?.message; if (marker === 'DUPLICATE_LABEL')
-    return 'This connection was already saved — reload and try again.'; if (marker === 'VALIDATION')
-    return 'Check the required credential fields.'; return 'Unable to save connection'; }
+export function sourceControlErrorMessage({ error }, _optional = {}) {
+    const e = error;
+    const marker = e?.code ?? e?.message;
+    if (marker === 'DUPLICATE_LABEL')
+        return 'This connection was already saved — reload and try again.';
+    if (marker === 'VALIDATION')
+        return 'Check the required credential fields.';
+    return 'Unable to save connection';
+}
 export function safeSourceControlUrl({ url }, _optional = {}) { try {
     const parsed = new URL(url);
     return parsed.protocol === 'https:' || parsed.protocol === 'http:' ? url : undefined;

package/dist/widgets/adapters/http.js

@@ -1,3 +1,4 @@
+import { querySuffix } from '../../core/transport/query-suffix.js';
 /** basePath is the host workspace root; the adapter adds /widgets and the shared /trash/items. */
 export function createHttpWidgetsApi({ transport, basePath }, _optional = {}) {
     const root = basePath.replace(/\/$/, '');
@@ -14,7 +15,7 @@ export function createHttpWidgetsApi({ transport, basePath }, _optional = {}) {
             if (includeInactive)
                 query.set('includeInactive', 'true');
             const suffix = query.toString();
-            return request(`${base}${suffix ? `?${suffix}` : ''}`, 'GET', undefined, options);
+            return request(`${base}${querySuffix(suffix)}`, 'GET', undefined, options);
         },
         getWidget({ id }, options = {}) { return request(`${base}/${encodeURIComponent(id)}`, 'GET', undefined, options); },
         createWidget(input, options = {}) { return request(base, 'POST', input, options); },

package/dist/widgets/adapters/memory.js

@@ -32,7 +32,8 @@ export function createMemoryWidgetsApi({ widgets = [], regions = [], areas = {},
             options.signal?.throwIfAborted();
             let id;
             do {
-                id = `fake-${++widgetSequence}`;
+                widgetSequence += 1;
+                id = `fake-${widgetSequence}`;
             } while (rows.some(w => w.id === id || w.slug === `fake-slug-${widgetSequence}`));
             const widget = { id, workspaceId, slug: `fake-slug-${widgetSequence}`, title: input.title, status: 'active', widgetType: input.widgetType, config: copy(input.config), updatedAt: now(), version: 1 };
             rows.push(widget);
@@ -61,7 +62,8 @@ export function createMemoryWidgetsApi({ widgets = [], regions = [], areas = {},
                 fail('WIDGETS_REGION_BOUND', 'Region already bound');
             let id;
             do {
-                id = `fake-area-${++areaSequence}`;
+                areaSequence += 1;
+                id = `fake-area-${areaSequence}`;
             } while (bindings.some(b => b.areaEntryId === id) || [...regionRows.values()].some(r => r.area.id === id));
             const area = { id, workspaceId, regionKey, updatedAt: now(), version: 1 };
             bindings.push({ workspaceId, regionKey, areaEntryId: id, updatedAt: area.updatedAt, placementCount: 0 });

package/dist/widgets/conformance/widgets-api.conformance.js

@@ -1,8 +1,11 @@
 /** Mutates an isolated adapter. Returns named checks and throws at the first contract failure. */
 export async function runWidgetsApiConformance({ api }, _optional = {}) {
     const checks = [];
-    function assert(condition, name) { if (!condition)
-        throw new Error(`Widgets API conformance: ${name}`); checks.push(name); }
+    function assert(condition, name) {
+        if (!condition)
+            throw new Error(`Widgets API conformance: ${name}`);
+        checks.push(name);
+    }
     async function rejects(run, name) { let rejected = false; try {
         await run();
     }

package/dist/widgets/controllers/instance-editor.controller.js

@@ -17,7 +17,8 @@ export function createWidgetInstanceEditorController({ api, params: initialParam
     const isLiveLoad = ({ ticket }) => ticket === generation && !store.signal.aborted;
     const isLiveSave = ({ savingFor }) => currentKey() === savingFor && !store.signal.aborted;
     async function load(_required = {}, _optional = {}) {
-        const ticket = ++generation;
+        generation += 1;
+        const ticket = generation;
         const isNew = params.widgetId === null;
         store.set({ patch: { isNew, saving: false } });
         if (isNew) {
@@ -58,7 +59,7 @@ export function createWidgetInstanceEditorController({ api, params: initialParam
         try {
             if (isNew)
                 await createAndOpen({ widgetType, title, config });
-            else if (widget)
+            if (!isNew && widget)
                 await updateExisting({ widget, title, config, savingFor });
         }
         catch (error) {

package/dist/widgets/controllers/library.controller.js

@@ -8,7 +8,8 @@ export function createWidgetsLibraryController({ api }, { t = widgetsEnglish } =
     let generation = 0;
     const isLiveRead = ({ ticket }) => ticket === generation && !store.signal.aborted;
     async function load(_required = {}, _optional = {}) {
-        const ticket = ++generation;
+        generation += 1;
+        const ticket = generation;
         try {
             // No includeInactive: trashed widgets belong to the shared Trash screen.
             const result = await api.listWidgets({}, { signal: store.signal });

package/dist/widgets/controllers/region-editor.controller.js

@@ -8,7 +8,8 @@ export function createWidgetRegionEditorController({ api, regionKey: initialKey
     let regionKey = initialKey, generation = 0;
     const isLiveRead = ({ ticket }) => ticket === generation && !store.signal.aborted;
     async function load(_required = {}, _optional = {}) {
-        const ticket = ++generation;
+        generation += 1;
+        const ticket = generation;
         store.set({ patch: { loading: true, error: null, saving: false } });
         try {
             const result = await api.getWidgetRegion({ regionKey }, { signal: store.signal });

package/dist/widgets/controllers/regions.controller.js

@@ -7,7 +7,8 @@ export function createWidgetRegionsController({ api }, { t = widgetsEnglish, nav
     const store = createControllerStore({ initial: { regions: null, error: null, newRegionKey: '', binding: false } });
     let generation = 0;
     async function load(_required = {}, _optional = {}) {
-        const ticket = ++generation;
+        generation += 1;
+        const ticket = generation;
         try {
             const result = await api.listWidgetRegions({}, { signal: store.signal });
             if (ticket === generation && !store.signal.aborted)

package/dist/widgets/react/components/WidgetInstanceNotices.d.ts

@@ -10,5 +10,5 @@ import type { WidgetInstanceGuard } from '../../rules.js';
 export declare function WidgetInstanceGuardNotice({ guard, t }: {
     guard: WidgetInstanceGuard;
     t: (key: string) => string;
-}): import("react").JSX.Element;
+}): import("react").JSX.Element | null;
 //# sourceMappingURL=WidgetInstanceNotices.d.ts.map

package/dist/widgets/react/components/WidgetInstanceNotices.js

@@ -20,6 +20,8 @@ export function WidgetInstanceGuardNotice({ guard, t }) {
             return _jsx("div", { className: "notice error", children: t("No widget type specified.") });
         case "unknown-type":
             return _jsxs("div", { className: "notice error", children: [t('Unknown widget type "'), guard.widgetType, "\"."] });
+        default:
+            return null;
     }
 }
 //# sourceMappingURL=WidgetInstanceNotices.js.map

package/dist/widgets/react/hooks/use-widget-regions.hooks.js

@@ -13,8 +13,11 @@ export function useWidgetRegions({ api }, { t = widgetsEnglish, events, navigate
     const latest = useRef({ t, navigate });
     latest.current = { t, navigate };
     const { controller, snapshot } = useController({ create: () => createWidgetRegionsController({ api: cached.api }, { t: key => latest.current.t(key), navigate: path => latest.current.navigate?.(path) }), dependencies: [cached.api] }, { start: ({ controller }) => { void controller.load(); } });
-    useEffect(() => { if (!controller)
-        return; return events?.subscribe({ resource: WIDGETS_REGIONS_RESOURCE, onRefresh: () => invalidate({ key: WIDGET_QUERY_KEYS.regions }) }); }, [controller, events, invalidate]);
+    useEffect(() => {
+        if (!controller)
+            return undefined;
+        return events?.subscribe({ resource: WIDGETS_REGIONS_RESOURCE, onRefresh: () => invalidate({ key: WIDGET_QUERY_KEYS.regions }) });
+    }, [controller, events, invalidate]);
     return { ...mergeRegionsState({ snapshot, data: cached.query.data, queryError: cached.query.error }), setNewRegionKey: value => controller?.setNewRegionKey({ value }), bind: async () => { await controller?.bind(); }, t };
 }
 const EMPTY_REGIONS_STATE = { regions: null, error: null, newRegionKey: '', binding: false };

package/dist/widgets/react/hooks/use-widgets-library.hooks.js

@@ -12,8 +12,11 @@ export function useWidgetsLibrary({ api }, { t = widgetsEnglish, locale = 'en',
     const latestT = useRef(t);
     latestT.current = t;
     const { controller, snapshot } = useController({ create: () => createWidgetsLibraryController({ api: cached.api }, { t: key => latestT.current(key) }), dependencies: [cached.api] }, { start: ({ controller }) => { void controller.load(); } });
-    useEffect(() => { if (!controller)
-        return; return events?.subscribe({ resource: WIDGETS_LIBRARY_RESOURCE, onRefresh: () => invalidate({ key: WIDGET_QUERY_KEYS.library }) }); }, [controller, events, invalidate]);
+    useEffect(() => {
+        if (!controller)
+            return undefined;
+        return events?.subscribe({ resource: WIDGETS_LIBRARY_RESOURCE, onRefresh: () => invalidate({ key: WIDGET_QUERY_KEYS.library }) });
+    }, [controller, events, invalidate]);
     return { ...mergeLibraryState({ snapshot, data: cached.query.data, queryError: cached.query.error }),
         setCreateType: type => controller?.setCreateType({ type }), requestTrash: widget => controller?.requestTrash({ widget }),
         confirmTrash: async () => { await controller?.confirmTrash(); }, cancelTrash: () => controller?.cancelTrash(), t, locale };

package/dist/widgets/react/pages/WidgetInstanceEditor.js

@@ -18,7 +18,7 @@ import { WhereUsedBanner, WidgetInstanceGuardNotice } from '../components/Widget
 export function WidgetInstanceEditor(props) {
     const { slots: { ConfigFields: WidgetConfigFields }, widgetTypes } = useWidgetsOptions();
     const { widgetId, widgetType: queryWidgetType, useWidgetInstanceEditorHook = useWiredWidgetInstanceEditor } = props;
-    const { isNew, widget, whereUsed, title, setTitle, config, setConfig, message, error, fieldErrors, loading, saving, save, confirmLeave, t, locale, gate, onBackClick, } = useWidgetInstanceEditorView({ widgetId, widgetType: queryWidgetType, useWidgetInstanceEditorHook, widgetTypes });
+    const { isNew, widget, whereUsed, title, setTitle, config, setConfig, message, error, fieldErrors, saving, save, t, gate, onBackClick, } = useWidgetInstanceEditorView({ widgetId, widgetType: queryWidgetType, useWidgetInstanceEditorHook, widgetTypes });
     if (gate.guard !== null)
         return _jsx(WidgetInstanceGuardNotice, { guard: gate.guard, t: t });
     // `widgetInstanceGuard`'s "no-type" case already covers a null `widgetType` above, but TS can't

package/dist/widgets/react/pages/WidgetRegionEditor.js

@@ -9,7 +9,7 @@ import { WidgetRegionEditorHeaderActions } from '../components/WidgetRegionEdito
 export function WidgetRegionEditor(props) {
     const { slots: { AddControl: WidgetAddControl }, widgetTypes } = useWidgetsOptions();
     const { regionKey, useWidgetRegionEditorHook = useWiredWidgetRegionEditor } = props;
-    const { area, placements, message, error, loading, saving, removeAt, moveAt, toggleEnabled, addPlacement, save, t, locale, placementHandles } = useWidgetRegionEditorView({ regionKey, useWidgetRegionEditorHook });
+    const { area, placements, message, error, loading, saving, removeAt, moveAt, toggleEnabled, addPlacement, save, t, placementHandles } = useWidgetRegionEditorView({ regionKey, useWidgetRegionEditorHook });
     if (error && !area)
         return _jsx("div", { className: "notice error", children: error });
     if (loading)

package/dist/widgets/react/pages/WidgetsLibrary.js

@@ -11,7 +11,7 @@ export { WidgetsLibraryNotices } from '../components/WidgetsLibraryNotices.js';
 import { WidgetsLibraryNotices } from '../components/WidgetsLibraryNotices.js';
 export function WidgetsLibrary({ useWidgetsLibraryHook = useWiredWidgetsLibrary } = {}) {
     const { widgetTypes, headerActions, statusLabel } = useWidgetsOptions();
-    const { widgets, error, skippedCount, skippedIds, createType, setCreateType, pendingTrash, trashing, requestTrash, confirmTrash, cancelTrash, t, locale, rowHandleById, } = useWidgetsLibraryView({ useWidgetsLibraryHook });
+    const { widgets, error, skippedCount, skippedIds, createType, setCreateType, pendingTrash, trashing, requestTrash, confirmTrash, cancelTrash, t, rowHandleById, } = useWidgetsLibraryView({ useWidgetsLibraryHook });
     if (error && !widgets)
         return _jsx("div", { className: "notice error", children: error });
     if (!widgets)

package/dist/widgets/rules.js

@@ -43,8 +43,12 @@ export function movePlacement({ items, index, direction }, _optional = {}) {
 }
 // Distinguishes draft keys created in the same millisecond without randomUUID.
 let draftPlacementSequence = 0;
+function fallbackDraftPlacementId() {
+    draftPlacementSequence += 1;
+    return `p-${Date.now()}-${draftPlacementSequence}`;
+}
 /** Draft identity survives reorder/remove/toggle until the server accepts the ordered placements. */
-export function buildDraftPlacement({ widgetInstanceId }, { id = () => globalThis.crypto?.randomUUID?.() ?? `p-${Date.now()}-${++draftPlacementSequence}` } = {}) {
+export function buildDraftPlacement({ widgetInstanceId }, { id = () => globalThis.crypto?.randomUUID?.() ?? fallbackDraftPlacementId() } = {}) {
     return { placementId: id(), widgetEntryId: widgetInstanceId, enabled: true, widgetTitle: null, widgetType: null, broken: false };
 }
 /** Conflict copy is domain-specific; other failures use the existing admin error describer. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jini-ai/admin",
-  "version": "0.6.15-rc.2",
+  "version": "0.6.16",
   "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": {
@@ -95,6 +95,16 @@
           "react-dom"
         ]
       }
+    },
+    "optionalPeers": {
+      "@jini-ai/agentic": "opt-in: agent-aware ui and protocols; import @jini-ai/admin/react — Agent-aware UI and protocols could not load @jini-ai/agentic. Install @jini-ai/agentic to enable this feature, or check its installed version and native binaries.",
+      "@jini-ai/ui": "opt-in: ui integrations; import @jini-ai/admin/react — UI integrations could not load @jini-ai/ui. Install @jini-ai/ui to enable this feature, or check its installed version and native binaries.",
+      "@jini-ai/ui-kit": "opt-in: ui kit integrations; import @jini-ai/admin/react — UI kit integrations could not load @jini-ai/ui-kit. Install @jini-ai/ui-kit to enable this feature, or check its installed version and native binaries.",
+      "@jini-ai/agent-plugins": "opt-in: agent plugin integrations — Agent plugin integrations could not load @jini-ai/agent-plugins. Install @jini-ai/agent-plugins to enable this feature, or check its installed version and native binaries.",
+      "@jini-ai/cms": "opt-in: cms integrations; import @jini-ai/admin/media — CMS integrations could not load @jini-ai/cms. Install @jini-ai/cms to enable this feature, or check its installed version and native binaries.",
+      "@jini-ai/core": "opt-in: core module integrations; import @jini-ai/admin/react — Core module integrations could not load @jini-ai/core. Install @jini-ai/core to enable this feature, or check its installed version and native binaries.",
+      "react": "opt-in: react admin bindings; import @jini-ai/admin/react — React admin bindings could not load react. Install react to enable this feature, or check its installed version.",
+      "react-dom": "opt-in: react admin bindings; import @jini-ai/admin/react — React admin bindings could not load react-dom. Install react-dom to enable this feature, or check its installed version."
     }
   },
   "type": "module",
@@ -448,20 +458,38 @@
   "peerDependencies": {
     "react": "^18.3.0 || ^19.0.0",
     "react-dom": "^18.3.0 || ^19.0.0",
-    "@jini-ai/agentic": "^0.6.15-rc.2",
-    "@jini-ai/ui": "^0.6.15-rc.2",
-    "@jini-ai/ui-kit": "^0.6.15-rc.2",
-    "@jini-ai/agent-plugins": "^0.6.15-rc.2",
-    "@jini-ai/cms": "^0.6.15-rc.2",
-    "@jini-ai/core": "^0.6.15-rc.2"
+    "@jini-ai/agentic": "^0.6.10",
+    "@jini-ai/ui": "^0.6.10",
+    "@jini-ai/ui-kit": "^0.6.10",
+    "@jini-ai/agent-plugins": "^0.6.10",
+    "@jini-ai/cms": "^0.6.10",
+    "@jini-ai/core": "^0.6.10"
+  },
+  "devDependencies": {
+    "@testing-library/jest-dom": "^6.6.3",
+    "@testing-library/react": "^16.3.0",
+    "@types/react": "^19.2.0",
+    "@types/react-dom": "^19.2.0",
+    "@vitest/coverage-v8": "^2.1.9",
+    "jsdom": "^25.0.1",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0",
+    "@testing-library/user-event": "^14.6.1",
+    "@jini-ai/ui-kit": "^0.6.16",
+    "@jini-ai/agent-plugins": "^0.6.16",
+    "@jini-ai/cms": "^0.6.16",
+    "@jini-ai/agentic": "^0.6.16",
+    "@jini-ai/ui": "^0.6.16",
+    "@jini-ai/core": "^0.6.16"
+  },
+  "typesVersions": {
+    "*": {
+      "core/react": [
+        "./dist/core/react/index.d.ts"
+      ]
+    }
   },
   "peerDependenciesMeta": {
-    "react": {
-      "optional": true
-    },
-    "react-dom": {
-      "optional": true
-    },
     "@jini-ai/agentic": {
       "optional": true
     },
@@ -479,30 +507,12 @@
     },
     "@jini-ai/core": {
       "optional": true
-    }
-  },
-  "devDependencies": {
-    "@testing-library/jest-dom": "^6.6.3",
-    "@testing-library/react": "^16.3.0",
-    "@types/react": "^19.2.0",
-    "@types/react-dom": "^19.2.0",
-    "@vitest/coverage-v8": "^2.1.9",
-    "jsdom": "^25.0.1",
-    "react": "^19.2.0",
-    "react-dom": "^19.2.0",
-    "@testing-library/user-event": "^14.6.1",
-    "@jini-ai/agentic": "^0.6.15-rc.2",
-    "@jini-ai/core": "^0.6.15-rc.2",
-    "@jini-ai/agent-plugins": "^0.6.15-rc.2",
-    "@jini-ai/cms": "^0.6.15-rc.2",
-    "@jini-ai/ui": "^0.6.15-rc.2",
-    "@jini-ai/ui-kit": "^0.6.15-rc.2"
-  },
-  "typesVersions": {
-    "*": {
-      "core/react": [
-        "./dist/core/react/index.d.ts"
-      ]
+    },
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
     }
   },
   "scripts": {