@jini-ai/admin 0.4.5 → 0.4.7

package/dist/forms/react/index.d.ts

@@ -84,6 +84,8 @@ export declare function forms(_required: Record<string, never>, options?: FormsR
         readonly "Load more": "Load more";
         readonly "Loading\u2026": "Loading…";
         readonly "No submissions yet.": "No submissions yet.";
+        readonly Yes: "Yes";
+        readonly No: "No";
         readonly "Create form": "Create form";
         readonly Form: "Form";
         readonly "Configure a new form's fields.": "Configure a new form's fields.";
@@ -120,6 +122,76 @@ export declare function forms(_required: Record<string, never>, options?: FormsR
         readonly "failed to load submission": "failed to load submission";
         readonly "delete failed": "delete failed";
         readonly "Unknown field": "Unknown field";
+        readonly "Short text": "Short text";
+        readonly Paragraph: "Paragraph";
+        readonly Email: "Email";
+        readonly Phone: "Phone";
+        readonly "Website address": "Website address";
+        readonly Number: "Number";
+        readonly Slider: "Slider";
+        readonly Date: "Date";
+        readonly Time: "Time";
+        readonly "Date and time": "Date and time";
+        readonly Dropdown: "Dropdown";
+        readonly "Multi-select list": "Multi-select list";
+        readonly "Radio buttons": "Radio buttons";
+        readonly Checkbox: "Checkbox";
+        readonly Checkboxes: "Checkboxes";
+        readonly "Toggle switch": "Toggle switch";
+        readonly "File upload": "File upload";
+        readonly "Hidden value": "Hidden value";
+        readonly Text: "Text";
+        readonly Choices: "Choices";
+        readonly "Numbers and dates": "Numbers and dates";
+        readonly Other: "Other";
+        readonly "Field settings \u2014": "Field settings —";
+        readonly "Settings for field \"{name}\"": "Settings for field \"{name}\"";
+        readonly "CSS classes and HTML attributes": "CSS classes and HTML attributes";
+        readonly Required: "Required";
+        readonly Settings: "Settings";
+        readonly Placeholder: "Placeholder";
+        readonly "Help text": "Help text";
+        readonly "Shown under the field and read out by screen readers.": "Shown under the field and read out by screen readers.";
+        readonly Options: "Options";
+        readonly "The label is what visitors see. The value is what the submission stores; it follows the label until you edit it.": "The label is what visitors see. The value is what the submission stores; it follows the label until you edit it.";
+        readonly "Option {n} label": "Option {n} label";
+        readonly "Option {n} value": "Option {n} value";
+        readonly "Option {n} selected by default": "Option {n} selected by default";
+        readonly "Move option {n} up": "Move option {n} up";
+        readonly "Move option {n} down": "Move option {n} down";
+        readonly "Remove option {n}": "Remove option {n}";
+        readonly "Add option": "Add option";
+        readonly Default: "Default";
+        readonly "Checked by default": "Checked by default";
+        readonly None: "None";
+        readonly Length: "Length";
+        readonly "Min length": "Min length";
+        readonly Min: "Min";
+        readonly Max: "Max";
+        readonly Pattern: "Pattern";
+        readonly "Optional. The whole answer must match it, e.g. [0-9]+ for digits only. Groups, | and repeating more than once are not supported.": "Optional. The whole answer must match it, e.g. [0-9]+ for digits only. Groups, | and repeating more than once are not supported.";
+        readonly Range: "Range";
+        readonly Step: "Step";
+        readonly Files: "Files";
+        readonly "Leave all unticked to accept every safe type: images, video and PDF.": "Leave all unticked to accept every safe type: images, video and PDF.";
+        readonly Images: "Images";
+        readonly Videos: "Videos";
+        readonly PDF: "PDF";
+        readonly "Max size (MB)": "Max size (MB)";
+        readonly "Length must be a whole number.": "Length must be a whole number.";
+        readonly "Minimum must not be above maximum.": "Minimum must not be above maximum.";
+        readonly "That pattern isn't supported.": "That pattern isn't supported.";
+        readonly "Enter numbers for min, max and step.": "Enter numbers for min, max and step.";
+        readonly "Step must be above 0.": "Step must be above 0.";
+        readonly "Add at least one option.": "Add at least one option.";
+        readonly "Each option needs a label and a unique value.": "Each option needs a label and a unique value.";
+        readonly "Default must be a number.": "Default must be a number.";
+        readonly "Max size must be up to 10 MB.": "Max size must be up to 10 MB.";
+        readonly "Discard unsaved changes?": "Discard unsaved changes?";
+        readonly "Your changes to this form have not been saved.": "Your changes to this form have not been saved.";
+        readonly "Discard changes": "Discard changes";
+        readonly "Keep editing": "Keep editing";
+        readonly "Classes are unrestricted, e.g. Tailwind md:col-span-2. Attribute names must be aria-*, data-* or a safe layout attribute; event handlers like onclick are rejected.": "Classes are unrestricted, e.g. Tailwind md:col-span-2. Attribute names must be aria-*, data-* or a safe layout attribute; event handlers like onclick are rejected.";
     };
     pages: {
         readonly list: {
@@ -230,6 +302,8 @@ export declare function forms(_required: Record<string, never>, options?: FormsR
                 readonly "Load more": "Load more";
                 readonly "Loading\u2026": "Loading…";
                 readonly "No submissions yet.": "No submissions yet.";
+                readonly Yes: "Yes";
+                readonly No: "No";
                 readonly "Create form": "Create form";
                 readonly Form: "Form";
                 readonly "Configure a new form's fields.": "Configure a new form's fields.";
@@ -266,6 +340,76 @@ export declare function forms(_required: Record<string, never>, options?: FormsR
                 readonly "failed to load submission": "failed to load submission";
                 readonly "delete failed": "delete failed";
                 readonly "Unknown field": "Unknown field";
+                readonly "Short text": "Short text";
+                readonly Paragraph: "Paragraph";
+                readonly Email: "Email";
+                readonly Phone: "Phone";
+                readonly "Website address": "Website address";
+                readonly Number: "Number";
+                readonly Slider: "Slider";
+                readonly Date: "Date";
+                readonly Time: "Time";
+                readonly "Date and time": "Date and time";
+                readonly Dropdown: "Dropdown";
+                readonly "Multi-select list": "Multi-select list";
+                readonly "Radio buttons": "Radio buttons";
+                readonly Checkbox: "Checkbox";
+                readonly Checkboxes: "Checkboxes";
+                readonly "Toggle switch": "Toggle switch";
+                readonly "File upload": "File upload";
+                readonly "Hidden value": "Hidden value";
+                readonly Text: "Text";
+                readonly Choices: "Choices";
+                readonly "Numbers and dates": "Numbers and dates";
+                readonly Other: "Other";
+                readonly "Field settings \u2014": "Field settings —";
+                readonly "Settings for field \"{name}\"": "Settings for field \"{name}\"";
+                readonly "CSS classes and HTML attributes": "CSS classes and HTML attributes";
+                readonly Required: "Required";
+                readonly Settings: "Settings";
+                readonly Placeholder: "Placeholder";
+                readonly "Help text": "Help text";
+                readonly "Shown under the field and read out by screen readers.": "Shown under the field and read out by screen readers.";
+                readonly Options: "Options";
+                readonly "The label is what visitors see. The value is what the submission stores; it follows the label until you edit it.": "The label is what visitors see. The value is what the submission stores; it follows the label until you edit it.";
+                readonly "Option {n} label": "Option {n} label";
+                readonly "Option {n} value": "Option {n} value";
+                readonly "Option {n} selected by default": "Option {n} selected by default";
+                readonly "Move option {n} up": "Move option {n} up";
+                readonly "Move option {n} down": "Move option {n} down";
+                readonly "Remove option {n}": "Remove option {n}";
+                readonly "Add option": "Add option";
+                readonly Default: "Default";
+                readonly "Checked by default": "Checked by default";
+                readonly None: "None";
+                readonly Length: "Length";
+                readonly "Min length": "Min length";
+                readonly Min: "Min";
+                readonly Max: "Max";
+                readonly Pattern: "Pattern";
+                readonly "Optional. The whole answer must match it, e.g. [0-9]+ for digits only. Groups, | and repeating more than once are not supported.": "Optional. The whole answer must match it, e.g. [0-9]+ for digits only. Groups, | and repeating more than once are not supported.";
+                readonly Range: "Range";
+                readonly Step: "Step";
+                readonly Files: "Files";
+                readonly "Leave all unticked to accept every safe type: images, video and PDF.": "Leave all unticked to accept every safe type: images, video and PDF.";
+                readonly Images: "Images";
+                readonly Videos: "Videos";
+                readonly PDF: "PDF";
+                readonly "Max size (MB)": "Max size (MB)";
+                readonly "Length must be a whole number.": "Length must be a whole number.";
+                readonly "Minimum must not be above maximum.": "Minimum must not be above maximum.";
+                readonly "That pattern isn't supported.": "That pattern isn't supported.";
+                readonly "Enter numbers for min, max and step.": "Enter numbers for min, max and step.";
+                readonly "Step must be above 0.": "Step must be above 0.";
+                readonly "Add at least one option.": "Add at least one option.";
+                readonly "Each option needs a label and a unique value.": "Each option needs a label and a unique value.";
+                readonly "Default must be a number.": "Default must be a number.";
+                readonly "Max size must be up to 10 MB.": "Max size must be up to 10 MB.";
+                readonly "Discard unsaved changes?": "Discard unsaved changes?";
+                readonly "Your changes to this form have not been saved.": "Your changes to this form have not been saved.";
+                readonly "Discard changes": "Discard changes";
+                readonly "Keep editing": "Keep editing";
+                readonly "Classes are unrestricted, e.g. Tailwind md:col-span-2. Attribute names must be aria-*, data-* or a safe layout attribute; event handlers like onclick are rejected.": "Classes are unrestricted, e.g. Tailwind md:col-span-2. Attribute names must be aria-*, data-* or a safe layout attribute; event handlers like onclick are rejected.";
             };
             readonly pages: {
                 readonly list: {
@@ -380,6 +524,8 @@ export declare function forms(_required: Record<string, never>, options?: FormsR
                 readonly "Load more": "Load more";
                 readonly "Loading\u2026": "Loading…";
                 readonly "No submissions yet.": "No submissions yet.";
+                readonly Yes: "Yes";
+                readonly No: "No";
                 readonly "Create form": "Create form";
                 readonly Form: "Form";
                 readonly "Configure a new form's fields.": "Configure a new form's fields.";
@@ -416,6 +562,76 @@ export declare function forms(_required: Record<string, never>, options?: FormsR
                 readonly "failed to load submission": "failed to load submission";
                 readonly "delete failed": "delete failed";
                 readonly "Unknown field": "Unknown field";
+                readonly "Short text": "Short text";
+                readonly Paragraph: "Paragraph";
+                readonly Email: "Email";
+                readonly Phone: "Phone";
+                readonly "Website address": "Website address";
+                readonly Number: "Number";
+                readonly Slider: "Slider";
+                readonly Date: "Date";
+                readonly Time: "Time";
+                readonly "Date and time": "Date and time";
+                readonly Dropdown: "Dropdown";
+                readonly "Multi-select list": "Multi-select list";
+                readonly "Radio buttons": "Radio buttons";
+                readonly Checkbox: "Checkbox";
+                readonly Checkboxes: "Checkboxes";
+                readonly "Toggle switch": "Toggle switch";
+                readonly "File upload": "File upload";
+                readonly "Hidden value": "Hidden value";
+                readonly Text: "Text";
+                readonly Choices: "Choices";
+                readonly "Numbers and dates": "Numbers and dates";
+                readonly Other: "Other";
+                readonly "Field settings \u2014": "Field settings —";
+                readonly "Settings for field \"{name}\"": "Settings for field \"{name}\"";
+                readonly "CSS classes and HTML attributes": "CSS classes and HTML attributes";
+                readonly Required: "Required";
+                readonly Settings: "Settings";
+                readonly Placeholder: "Placeholder";
+                readonly "Help text": "Help text";
+                readonly "Shown under the field and read out by screen readers.": "Shown under the field and read out by screen readers.";
+                readonly Options: "Options";
+                readonly "The label is what visitors see. The value is what the submission stores; it follows the label until you edit it.": "The label is what visitors see. The value is what the submission stores; it follows the label until you edit it.";
+                readonly "Option {n} label": "Option {n} label";
+                readonly "Option {n} value": "Option {n} value";
+                readonly "Option {n} selected by default": "Option {n} selected by default";
+                readonly "Move option {n} up": "Move option {n} up";
+                readonly "Move option {n} down": "Move option {n} down";
+                readonly "Remove option {n}": "Remove option {n}";
+                readonly "Add option": "Add option";
+                readonly Default: "Default";
+                readonly "Checked by default": "Checked by default";
+                readonly None: "None";
+                readonly Length: "Length";
+                readonly "Min length": "Min length";
+                readonly Min: "Min";
+                readonly Max: "Max";
+                readonly Pattern: "Pattern";
+                readonly "Optional. The whole answer must match it, e.g. [0-9]+ for digits only. Groups, | and repeating more than once are not supported.": "Optional. The whole answer must match it, e.g. [0-9]+ for digits only. Groups, | and repeating more than once are not supported.";
+                readonly Range: "Range";
+                readonly Step: "Step";
+                readonly Files: "Files";
+                readonly "Leave all unticked to accept every safe type: images, video and PDF.": "Leave all unticked to accept every safe type: images, video and PDF.";
+                readonly Images: "Images";
+                readonly Videos: "Videos";
+                readonly PDF: "PDF";
+                readonly "Max size (MB)": "Max size (MB)";
+                readonly "Length must be a whole number.": "Length must be a whole number.";
+                readonly "Minimum must not be above maximum.": "Minimum must not be above maximum.";
+                readonly "That pattern isn't supported.": "That pattern isn't supported.";
+                readonly "Enter numbers for min, max and step.": "Enter numbers for min, max and step.";
+                readonly "Step must be above 0.": "Step must be above 0.";
+                readonly "Add at least one option.": "Add at least one option.";
+                readonly "Each option needs a label and a unique value.": "Each option needs a label and a unique value.";
+                readonly "Default must be a number.": "Default must be a number.";
+                readonly "Max size must be up to 10 MB.": "Max size must be up to 10 MB.";
+                readonly "Discard unsaved changes?": "Discard unsaved changes?";
+                readonly "Your changes to this form have not been saved.": "Your changes to this form have not been saved.";
+                readonly "Discard changes": "Discard changes";
+                readonly "Keep editing": "Keep editing";
+                readonly "Classes are unrestricted, e.g. Tailwind md:col-span-2. Attribute names must be aria-*, data-* or a safe layout attribute; event handlers like onclick are rejected.": "Classes are unrestricted, e.g. Tailwind md:col-span-2. Attribute names must be aria-*, data-* or a safe layout attribute; event handlers like onclick are rejected.";
             };
             readonly pages: {
                 readonly list: {

package/dist/forms/react/pages/FormEditor.js

@@ -1,5 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { agentHandle } from '@jini-ai/agentic';
+import { ConfirmDialog } from '../../../react/components/ConfirmDialog/ConfirmDialog.js';
 import { useWiredFormEditor } from "../hooks/use-form-editor.hooks.js";
 import { FormEditorFieldsBody } from "../components/FormEditorFieldsBody.js";
 import { FormEditorHeaderText } from "../components/FormEditorHeaderText.js";
@@ -12,7 +13,7 @@ import { FormEditorMainPanel } from "../components/FormEditorMainPanel.js";
  * `const`, because a `const` assigned inside `FormEditor` still executes in that function's own
  * scope — every branch inside it would still count toward `FormEditor`'s own complexity score. */
 export function FormEditor({ formId, tab, useFormEditorHook = useWiredFormEditor }, _optional = {}) {
-    const { answerColumns, mode, onModeChange, html, setHtml, copyEmbed, copyFeedback, isNew, form, name, setName, slug, setSlug, fields, setFields, tab: activeTab, onTabChange, error, saving, existingFieldIds, showTabs, tabRefs, onTabsKeyDown, handleSave, handleStatusToggle, t, } = useFormEditorHook({ formId, tab });
+    const { answerColumns, mode, onModeChange, html, setHtml, copyEmbed, copyFeedback, isNew, form, name, setName, slug, setSlug, fields, setFields, tab: activeTab, onTabChange, error, saving, existingFieldIds, showTabs, tabRefs, onTabsKeyDown, handleSave, handleStatusToggle, leave, t, } = useFormEditorHook({ formId, tab });
     if (!isNew && !form && !error)
         return _jsx("div", { className: "notice", children: t("Loading form…") });
     // Previously this was the ONLY guard, and it only covers the pre-error case — once the load
@@ -34,7 +35,7 @@ export function FormEditor({ formId, tab, useFormEditorHook = useWiredFormEditor
     return (_jsxs("div", { className: "page", children: [_jsxs("div", { className: "page-header page-header-split", ...agentHandle({ handle: "form-editor-header" }, {
                     role: "region",
                     label: "Form editor header — title and the Back to forms link",
-                }), children: [_jsx("div", { className: "page-header-lead", children: _jsxs("a", { className: "btn-secondary", href: "/admin/forms", "aria-label": t("Back to forms"), ...agentHandle({ handle: "form-editor-back" }, { role: "link", label: "Back to the list of all forms" }), children: ["\u2190 ", t("Back")] }) }), _jsx(FormEditorHeaderText, { isNew: isNew, name: name, t: t })] }), error ? _jsx("div", { className: "notice error", children: error }) : null, _jsx(FormEditorTabStrip, { showTabs: showTabs, tab: activeTab, onTabChange: onTabChange, tabRefs: tabRefs, onTabsKeyDown: onTabsKeyDown, t: t }), _jsx(FormEditorMainPanel, { isNew: isNew, tab: activeTab, formId: formId, fieldsBody: fieldsBody, t: t, answerColumns: answerColumns })] }));
+                }), children: [_jsx("div", { className: "page-header-lead", children: _jsxs("a", { className: "btn-secondary", href: "/admin/forms", "aria-label": t("Back to forms"), onClick: leave.onBack, ...agentHandle({ handle: "form-editor-back" }, { role: "link", label: "Back to the list of all forms" }), children: ["\u2190 ", t("Back")] }) }), _jsx(FormEditorHeaderText, { isNew: isNew, name: name, t: t })] }), error ? _jsx("div", { className: "notice error", children: error }) : null, _jsx(FormEditorTabStrip, { showTabs: showTabs, tab: activeTab, onTabChange: onTabChange, tabRefs: tabRefs, onTabsKeyDown: onTabsKeyDown, t: t }), _jsx(FormEditorMainPanel, { isNew: isNew, tab: activeTab, formId: formId, fieldsBody: fieldsBody, t: t, answerColumns: answerColumns }), _jsx(ConfirmDialog, { open: leave.confirmOpen, agentHandle: "form-editor-leave-confirm", title: t("Discard unsaved changes?"), body: _jsx("p", { children: t("Your changes to this form have not been saved.") }), confirmLabel: t("Discard changes"), cancelLabel: t("Keep editing"), tone: "danger", onConfirm: leave.confirm, onCancel: leave.cancel })] }));
 }
 export default FormEditor;
 //# sourceMappingURL=FormEditor.js.map

package/dist/forms/rules.d.ts

@@ -1,6 +1,7 @@
 import type { RowMenuItem } from "../react/components/RowMenu/RowMenu.js";
 import type { AdminFormDefinition, AdminFormField } from "./models.js";
 import type { QueryKey } from "@jini-ai/ui/fetch-query";
+import { type FieldType } from "@jini-ai/cms/forms";
 /**
  * @file Pure logic for the `forms` feature (`FormEditor.tsx` — see `FormsList.tsx`'s own
  * `rules.ts`/hook for the list screen's extraction) — everything that computes a value rather than
@@ -183,7 +184,8 @@ export declare function formRowMenuItems({ form, handlers, t }: {
     handlers: FormRowMenuHandlers;
     t: (key: string) => string;
 }, _optional?: Record<string, never>): RowMenuItem[];
-export declare const FIELD_TYPES: readonly ["text", "email", "textarea", "checkbox"];
+/** Every registered field type, in registry order; the picker groups them via `field-settings.ts`. */
+export declare const FIELD_TYPES: FieldType[];
 /** The two tab-panel views on an existing form's editor (`formId !== "new"`). */
 export declare const FORM_TABS: readonly [{
     readonly id: "fields";
@@ -216,6 +218,13 @@ export declare function updateFormField({ fields, index, patch }: {
     index: number;
     patch: Partial<AdminFormField>;
 }, _optional?: Record<string, never>): AdminFormField[];
+/** Swap in a whole field (a type change drops settings, which a merge would keep).
+ *  @complexity O(n) in `fields.length`. */
+export declare function replaceFormField({ fields, index, field }: {
+    fields: AdminFormField[];
+    index: number;
+    field: AdminFormField;
+}, _optional?: Record<string, never>): AdminFormField[];
 /** @complexity O(n) in `fields.length`. */
 export declare function addFormField({ fields }: {
     fields: AdminFormField[];

package/dist/forms/rules.js

@@ -1,5 +1,6 @@
 import { AdminApiError as ApiError, describeApiError as describeCoreApiError } from "../core/transport/errors.js";
 const describeApiError = (e, fallback) => describeCoreApiError({ e, fallback });
+import { FIELD_TYPE_REGISTRY } from "@jini-ai/cms/forms";
 /**
  * @file Pure logic for the `forms` feature (`FormEditor.tsx` — see `FormsList.tsx`'s own
  * `rules.ts`/hook for the list screen's extraction) — everything that computes a value rather than
@@ -199,7 +200,8 @@ export function formRowMenuItems({ form, handlers, t }, _optional = {}) {
         { key: "delete", label: t("Delete"), tone: "danger", onSelect: () => handlers.onDelete(form) },
     ];
 }
-export const FIELD_TYPES = ["text", "email", "textarea", "checkbox"];
+/** Every registered field type, in registry order; the picker groups them via `field-settings.ts`. */
+export const FIELD_TYPES = Object.keys(FIELD_TYPE_REGISTRY);
 /** The two tab-panel views on an existing form's editor (`formId !== "new"`). */
 export const FORM_TABS = [
     { id: "fields", label: "Fields" },
@@ -235,6 +237,11 @@ export function fieldDisplayName({ field, index }, _optional = {}) {
 export function updateFormField({ fields, index, patch }, _optional = {}) {
     return fields.map((f, i) => (i === index ? { ...f, ...patch } : f));
 }
+/** Swap in a whole field (a type change drops settings, which a merge would keep).
+ *  @complexity O(n) in `fields.length`. */
+export function replaceFormField({ fields, index, field }, _optional = {}) {
+    return fields.map((f, i) => (i === index ? field : f));
+}
 /** @complexity O(n) in `fields.length`. */
 export function addFormField({ fields }, _optional = {}) {
     return [...fields, blankField()];

package/dist/media/controllers/library.controller.d.ts

@@ -22,6 +22,10 @@ export declare function createLibraryController({ api }: {
         listener: () => void;
     }) => () => void;
     load: (_required?: Record<string, never>, _optional?: Record<string, never>) => Promise<void>;
+    settleLibrary: ({ all, error }: {
+        all?: readonly MediaAsset[];
+        error?: Error | null;
+    }, _optional?: Record<string, never>) => void;
     setQuery({ query }: {
         query: MediaQuery;
     }, _optional?: Record<string, never>): Promise<void>;

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

@@ -69,6 +69,18 @@ export function createLibraryController({ api }, { query = {} } = {}) {
                 store.set({ patch: { loading: false } });
         }
     }
+    // A reactive cache observer may refresh this library without calling load again. Keep
+    // filtering/counts in the headless domain; accepting cache data must spend no extra read.
+    function settleLibrary({ all, error }, _optional = {}) {
+        if (store.signal.aborted)
+            return;
+        if (all) {
+            library = all;
+            store.set({ patch: { items: queryMedia({ media: all, query: store.getSnapshot().query }), counts: countMediaTabs({ media: all }), hasUntyped: all.some(item => item.contentType === null), error: null } });
+        }
+        if (error)
+            store.set({ patch: { error: error.message } });
+    }
     let writes = Promise.resolve();
     let exclusiveWrite = false;
     function write(run, id) {
@@ -114,6 +126,7 @@ export function createLibraryController({ api }, { query = {} } = {}) {
         getSnapshot: store.getSnapshot,
         subscribe: store.subscribe,
         load,
+        settleLibrary,
         async setQuery({ query }, _optional = {}) {
             // Already-fetched full library owns display order/filtering. Tab/search/order changes
             // never spend another request or flash a loading zero badge.

package/dist/media/react/components/MediaPicker.js

@@ -1,10 +1,10 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { MediaDialog } from './MediaDialog.js';
-import { Button, TextField } from '@jini-ai/ui-kit/react';
+import { Button, IconButton, TextField } from '@jini-ai/ui-kit/react';
 import { useMediaPicker } from '../hooks/MediaPicker.hooks.js';
 import { MediaGrid } from './MediaGrid.js';
 export function MediaPicker(props, _optional = {}) {
     const vm = useMediaPicker(props);
-    return (_jsxs(MediaDialog, { className: "jini-media-picker-dialog", attrs: { 'data-jini-part': 'media.picker' }, title: "Choose media", open: true, onClose: vm.onClose, children: [_jsx(TextField, { attrs: { 'data-jini-part': 'media.picker.search' }, label: "Search media", value: vm.search, onValueChange: vm.onSearch }), vm.snapshot?.error && _jsxs("div", { className: "jini-notice jini-notice-error", children: [_jsx("p", { className: "jini-notice-text", role: "alert", children: vm.snapshot.error }), _jsx(Button, { onPress: vm.onRetry, children: "Retry" })] }), vm.loading ? (_jsx("p", { className: "jini-notice", role: "status", children: "Loading media\u2026" })) : (_jsx(MediaGrid, { actions: vm.actions, api: vm.api })), _jsx(Button, { attrs: { 'data-jini-part': 'media.picker.cancel', 'data-jini-autofocus': true }, onPress: vm.onClose, children: "Cancel" })] }));
+    return (_jsxs(MediaDialog, { className: "jini-media-picker-dialog", attrs: { 'data-jini-part': 'media.picker' }, title: "Choose media", open: true, onClose: vm.onClose, children: [_jsx(TextField, { attrs: { 'data-jini-part': 'media.picker.search' }, label: "Search media", value: vm.search, onValueChange: vm.onSearch }), vm.snapshot?.error && _jsxs("div", { className: "jini-notice jini-notice-error", children: [_jsx("p", { className: "jini-notice-text", role: "alert", children: vm.snapshot.error }), _jsx(Button, { onPress: vm.onRetry, children: "Retry" })] }), vm.loading ? (_jsx("p", { className: "jini-notice", role: "status", children: "Loading media\u2026" })) : (_jsx(MediaGrid, { actions: vm.actions, api: vm.api })), _jsxs("div", { className: "jini-media-picker-footer", "data-jini-part": "media.picker.footer", children: [_jsx(IconButton, { className: "jini-media-picker-back", label: "Back", attrs: { 'data-jini-part': 'media.picker.back' }, onPress: vm.onClose, children: "\u2190" }), _jsx(Button, { attrs: { 'data-jini-part': 'media.picker.cancel', 'data-jini-autofocus': true }, onPress: vm.onClose, children: "Cancel" })] })] }));
 }
 //# sourceMappingURL=MediaPicker.js.map

package/dist/media/react/hooks/EditMediaPanel.hooks.js

@@ -1,12 +1,14 @@
+import { useMediaLibraryQuery } from './MediaQuery.hooks.js';
 import { useEffect, useLayoutEffect, useRef, useState } from 'react';
 import { useController } from '../../../core/react/use-controller.js';
 import { createEditMediaController } from '../../controllers/edit-media.controller.js';
 import { canReplaceMedia, mediaEmbedSnippet, parseOptionalPixelSize, safeMediaUrl } from '../../rules.js';
 import { parseMediaHtmlAttributes, describeMediaHtmlAttributeError } from '../../html-attributes.js';
 export function useEditMediaPanel(props, _optional = {}) {
+    const cached = useMediaLibraryQuery({ api: props.api }, { enabled: false });
     const { controller, snapshot } = useController({
-        create: () => createEditMediaController({ api: props.api, item: props.item }),
-        dependencies: [props.api, props.item.id],
+        create: () => createEditMediaController({ api: cached.api, item: props.item }),
+        dependencies: [cached.api, props.item.id],
     });
     const [copied, setCopied] = useState({});
     const timers = useRef(new Map());

package/dist/media/react/hooks/GallerySelection.hooks.d.ts

@@ -0,0 +1,31 @@
+export interface GallerySelectionImage {
+    readonly mediaId: string;
+    readonly alt: string;
+    readonly caption: string;
+}
+/** Controlled gallery selection: metadata follows media ids through reordering and deduplication.
+ * The host owns persistence and media loading; these callbacks only derive the next ordered value.
+ * @complexity O(n+m) time/space per action; the default bound is 50 images.
+ */
+export declare function useGallerySelection({ images, onChange }: {
+    images: readonly GallerySelectionImage[];
+    onChange: (images: GallerySelectionImage[]) => void;
+}, { maxImages }?: {
+    maxImages?: number;
+}): {
+    add({ images: additions }: {
+        images: readonly GallerySelectionImage[];
+    }, _optional?: Record<string, never>): void;
+    update({ mediaId, patch }: {
+        mediaId: string;
+        patch: Partial<Pick<GallerySelectionImage, "alt" | "caption">>;
+    }, _optional?: Record<string, never>): void;
+    remove({ mediaId }: {
+        mediaId: string;
+    }, _optional?: Record<string, never>): void;
+    move({ mediaId, beforeId }: {
+        mediaId: string;
+        beforeId: string;
+    }, _optional?: Record<string, never>): void;
+};
+//# sourceMappingURL=GallerySelection.hooks.d.ts.map

package/dist/media/react/hooks/GallerySelection.hooks.js

@@ -0,0 +1,32 @@
+/** Controlled gallery selection: metadata follows media ids through reordering and deduplication.
+ * The host owns persistence and media loading; these callbacks only derive the next ordered value.
+ * @complexity O(n+m) time/space per action; the default bound is 50 images.
+ */
+export function useGallerySelection({ images, onChange }, { maxImages = 50 } = {}) {
+    return {
+        add({ images: additions }, _optional = {}) {
+            const next = new Map(images.map(image => [image.mediaId, image]));
+            for (const image of additions)
+                if (!next.has(image.mediaId))
+                    next.set(image.mediaId, image);
+            if (next.size > maxImages)
+                throw new Error(`Choose at most ${maxImages} gallery images`);
+            onChange([...next.values()]);
+        },
+        update({ mediaId, patch }, _optional = {}) {
+            onChange(images.map(image => image.mediaId === mediaId ? { ...image, ...patch } : image));
+        },
+        remove({ mediaId }, _optional = {}) { onChange(images.filter(image => image.mediaId !== mediaId)); },
+        move({ mediaId, beforeId }, _optional = {}) {
+            if (mediaId === beforeId)
+                return;
+            const source = images.find(image => image.mediaId === mediaId);
+            if (!source || !images.some(image => image.mediaId === beforeId))
+                return;
+            const next = images.filter(image => image.mediaId !== mediaId);
+            next.splice(next.findIndex(image => image.mediaId === beforeId), 0, source);
+            onChange(next);
+        },
+    };
+}
+//# sourceMappingURL=GallerySelection.hooks.js.map

package/dist/media/react/hooks/LibraryTab.hooks.d.ts

@@ -18,6 +18,10 @@ export declare function useLibraryTab({ params, permissions }: TabViewProps, _op
             listener: () => void;
         }) => () => void;
         load: (_required?: Record<string, never>, _optional?: Record<string, never>) => Promise<void>;
+        settleLibrary: ({ all, error }: {
+            all?: readonly MediaAsset[];
+            error?: Error | null;
+        }, _optional?: Record<string, never>) => void;
         setQuery({ query }: {
             query: import("../../models.js").MediaQuery;
         }, _optional?: Record<string, never>): Promise<void>;

package/dist/media/react/hooks/LibraryTab.hooks.js

@@ -1,3 +1,5 @@
+import { useInvalidate } from '@jini-ai/ui/fetch-query';
+import { MEDIA_QUERY_KEYS, useMediaLibraryQuery } from './MediaQuery.hooks.js';
 import { useEffect, useLayoutEffect, useRef, useState } from 'react';
 import { useController } from '../../../core/react/use-controller.js';
 import { createLibraryController } from '../../controllers/library.controller.js';
@@ -9,9 +11,11 @@ export function useLibraryTab({ params, permissions = [] }, _optional = {}) {
     const { mediaApi, mediaEvents } = useMediaPorts();
     const filter = params.filter === 'images' || params.filter === 'videos' ? params.filter : 'all';
     const shared = useSharedMediaLibrary();
+    const cached = useMediaLibraryQuery({ api: mediaApi }, { enabled: !shared });
+    const invalidate = useInvalidate();
     const local = useController({
-        create: () => createLibraryController({ api: mediaApi }, { query: { filter } }),
-        dependencies: [mediaApi, filter],
+        create: () => createLibraryController({ api: cached.api }, { query: { filter } }),
+        dependencies: [cached.api, filter],
     }, {
         start: ({ controller }) => {
             if (!shared)
@@ -19,7 +23,9 @@ export function useLibraryTab({ params, permissions = [] }, _optional = {}) {
         },
     });
     const { controller, snapshot } = shared ?? local;
-    useEffect(() => !shared ? mediaEvents?.subscribe({ onRefresh: () => { void controller?.load(); } }) : undefined, [mediaEvents, controller, shared]);
+    useEffect(() => !shared ? mediaEvents?.subscribe({ onRefresh: () => invalidate({ key: MEDIA_QUERY_KEYS.root }) }) : undefined, [mediaEvents, controller, shared, invalidate]);
+    useEffect(() => { if (!shared)
+        local.controller?.settleLibrary({ ...(cached.query.data ? { all: cached.query.data } : {}), error: cached.query.error }); }, [shared, local.controller, cached.query.data, cached.query.error]);
     const gridRef = useRef(null);
     const [success, setSuccess] = useState(null);
     const [focusAfterAction, setFocusAfterAction] = useState(null);

package/dist/media/react/hooks/MediaCard.hooks.d.ts

@@ -59,7 +59,7 @@ export declare function useMediaCard(props: MediaCardProps, _optional?: Record<s
         disabled: boolean;
     })[];
     src: string | undefined;
-    stage: "image" | "video" | "unsupported";
+    stage: "video" | "image" | "unsupported";
     image: boolean | "" | undefined;
     video: boolean | "" | undefined;
     onImageError: () => void;
@@ -67,7 +67,7 @@ export declare function useMediaCard(props: MediaCardProps, _optional?: Record<s
     alt: string;
     statusClassName: string;
     statusLabel: "active" | "trashed";
-    statusTone: "success" | "warning";
+    statusTone: "warning" | "success";
     trashed: boolean;
     item: MediaAsset;
     handleBase?: string;

package/dist/media/react/hooks/MediaGrid.hooks.d.ts

@@ -10,10 +10,10 @@ export interface MediaGridProps {
 export declare function useMediaGrid(props: MediaGridProps, _optional?: Record<string, never>): {
     actions: {
         handleBase: string;
+        item: import("../../models.js").MediaAsset;
+        locale?: string;
         busy?: boolean;
         onPurge?: () => void;
-        locale?: string;
-        item: import("../../models.js").MediaAsset;
         onEdit?: () => void;
         onPreview?: () => void;
         onTrash?: () => void;

package/dist/media/react/hooks/MediaPage.hooks.d.ts

@@ -21,6 +21,10 @@ export declare function useMediaPage(props: MediaPageProps, _optional?: Record<s
                 listener: () => void;
             }) => () => void;
             load: (_required?: Record<string, never>, _optional?: Record<string, never>) => Promise<void>;
+            settleLibrary: ({ all, error }: {
+                all?: readonly import("../../models.js").MediaAsset[];
+                error?: Error | null;
+            }, _optional?: Record<string, never>) => void;
             setQuery({ query }: {
                 query: import("../../models.js").MediaQuery;
             }, _optional?: Record<string, never>): Promise<void>;

package/dist/media/react/hooks/MediaPage.hooks.js

@@ -1,3 +1,5 @@
+import { useInvalidate } from '@jini-ai/ui/fetch-query';
+import { MEDIA_QUERY_KEYS, useMediaLibraryQuery, useMediaProvidersQuery } from './MediaQuery.hooks.js';
 import { createElement, createContext, useContext, useEffect, useState } from 'react';
 import { useController } from '../../../core/react/use-controller.js';
 import { createLibraryController } from '../../controllers/library.controller.js';
@@ -11,20 +13,15 @@ export function useSharedMediaLibrary(_required = {}, _optional = {}) {
 export function useMediaPage(props, _optional = {}) {
     const [localTab, setLocalTab] = useState('all');
     const { mediaApi, mediaEvents, mediaProviders } = useMediaPorts();
-    const library = useController({ create: () => createLibraryController({ api: mediaApi }, { query: { filter: requestedFilter({ tabId: props.requestedTab ?? localTab }) } }), dependencies: [mediaApi] }, { start: ({ controller }) => { if (props.description.visible)
+    const cached = useMediaLibraryQuery({ api: mediaApi }, { enabled: props.description.visible });
+    const providers = useMediaProvidersQuery({ port: mediaProviders }, { enabled: props.description.visible && props.description.grants.includes('media.providers') });
+    const invalidate = useInvalidate();
+    const library = useController({ create: () => createLibraryController({ api: cached.api }, { query: { filter: requestedFilter({ tabId: props.requestedTab ?? localTab }) } }), dependencies: [cached.api] }, { start: ({ controller }) => { if (props.description.visible)
             void controller.load(); } });
-    useEffect(() => props.description.visible ? mediaEvents?.subscribe({ onRefresh: () => { void library.controller?.load(); } }) : undefined, [props.description.visible, mediaEvents, library.controller]);
-    const [providerCount, setProviderCount] = useState(null);
-    useEffect(() => {
-        if (!props.description.visible || !mediaProviders || !props.description.grants.includes('media.providers'))
-            return;
-        const abort = new AbortController();
-        void mediaProviders.list({}, { signal: abort.signal }).then(items => {
-            if (!abort.signal.aborted && items)
-                setProviderCount(items.length);
-        }).catch(() => { });
-        return () => abort.abort();
-    }, [mediaProviders, props.description.grants, props.description.visible]);
+    useEffect(() => props.description.visible ? mediaEvents?.subscribe({ onRefresh: () => { invalidate({ key: MEDIA_QUERY_KEYS.root }); } }) : undefined, [props.description.visible, mediaEvents, library.controller, invalidate]);
+    useEffect(() => { library.controller?.settleLibrary({ ...(cached.query.data ? { all: cached.query.data } : {}), error: cached.query.error }); }, [library.controller, cached.query.data, cached.query.error]);
+    /* An unavailable read is not evidence of a zero catalogue. */
+    const providerCount = providers.query.data?.length ?? null;
     const visible = props.description.visible
         ? props.description.tabs.filter((tab) => tab.visible)
         : [];