@jini-ai/admin 0.4.5 → 0.4.6

package/dist/agent-plugins/package-file-tree.d.ts

@@ -41,7 +41,9 @@ export interface PackageFileTreeRow {
  */
 export declare function buildPackageFileTree({ paths }: {
     paths: readonly string[];
-}, _optional?: {}): PackageFileTreeNode[];
+}, optional?: {
+    locale?: string | string[];
+}): PackageFileTreeNode[];
 /**
  * The path of the tree's top file row once every folder on the way is open — the first file in
  * display order (files before folders, so a root file wins over anything nested); `null` for no files.

package/dist/agent-plugins/package-file-tree.js

@@ -8,20 +8,20 @@
  */
 const collator = new Intl.Collator("en", { numeric: true, sensitivity: "base" });
 /** Files first, then folders, each alphabetical (owner's call, 2026-09-29 — VS Code's default is the reverse). */
-function compareNodes(a, b) {
+function compareNodes(a, b, sorter = collator) {
     if (a.kind !== b.kind)
         return a.kind === "file" ? -1 : 1;
-    return collator.compare(a.name, b.name) || (a.name < b.name ? -1 : a.name > b.name ? 1 : 0);
+    return sorter.compare(a.name, b.name) || (a.name < b.name ? -1 : a.name > b.name ? 1 : 0);
 }
-function freeze(folder, prefix) {
+function freeze(folder, prefix, sorter = collator) {
     const nodes = [];
     for (const [name, child] of folder.folders) {
         const path = prefix ? `${prefix}/${name}` : name;
-        nodes.push({ kind: "folder", name, path, children: freeze(child, path) });
+        nodes.push({ kind: "folder", name, path, children: freeze(child, path, sorter) });
     }
     for (const file of folder.files)
         nodes.push({ kind: "file", ...file });
-    return nodes.sort(compareNodes);
+    return nodes.sort((a, b) => compareNodes(a, b, sorter));
 }
 /**
  * Groups flat package-relative paths into a folder tree. Empty segments (a leading, trailing or
@@ -30,7 +30,7 @@ function freeze(folder, prefix) {
  *
  * @complexity O(n·d + n log n) for n paths of depth d.
  */
-export function buildPackageFileTree({ paths }, _optional = {}) {
+export function buildPackageFileTree({ paths }, optional = {}) {
     const root = { folders: new Map(), files: [] };
     const seen = new Set();
     for (const path of paths) {
@@ -53,7 +53,7 @@ export function buildPackageFileTree({ paths }, _optional = {}) {
         seen.add(normalized);
         folder.files.push({ name: fileName, path });
     }
-    return freeze(root, "");
+    return freeze(root, "", optional.locale === undefined ? collator : new Intl.Collator(optional.locale, { numeric: true, sensitivity: "base" }));
 }
 /**
  * The path of the tree's top file row once every folder on the way is open — the first file in

package/dist/comments/controllers/comment-queue.controller.d.ts

@@ -11,9 +11,13 @@ import { type CommentsTranslator } from '../messages.en.js';
 export declare function createCommentQueueController({ api, permissions }: {
     api: AdminCommentsPort;
     permissions?: readonly string[];
-}, { t, onInvalidate }?: {
+}, { t, onInvalidate, loadPage }?: {
     t?: CommentsTranslator;
     onInvalidate?: () => void;
+    loadPage?: (required: {
+        status: CommentStatus;
+        cursor: string;
+    }) => Promise<AdminCommentsQueuePage>;
 }): {
     getSnapshot: () => Readonly<CommentQueueState>;
     subscribe: ({ listener }: {

package/dist/comments/controllers/comment-queue.controller.js

@@ -9,7 +9,7 @@ import { englishComments } from '../messages.en.js';
  * @param optional Translator and an invalidation callback for every cached status.
  * @returns An instance-scoped store and actions; dispose makes pending settlements inert.
  */
-export function createCommentQueueController({ api, permissions = [] }, { t = englishComments, onInvalidate } = {}) {
+export function createCommentQueueController({ api, permissions = [] }, { t = englishComments, onInvalidate, loadPage } = {}) {
     const store = createControllerStore({ initial: {
             status: 'pending', items: null, nextCursor: null, error: null, loadingMore: false,
             rowState: {}, pendingPurge: null,
@@ -91,7 +91,7 @@ export function createCommentQueueController({ api, permissions = [] }, { t = en
         store.set({ patch: { loadingMore: true } });
         publishPages();
         try {
-            const page = await api.listCommentsQueue({}, { status, cursor: nextCursor });
+            const page = await (loadPage ? loadPage({ status, cursor: nextCursor }) : api.listCommentsQueue({}, { status, cursor: nextCursor }));
             if (generation !== pageGeneration || store.signal.aborted)
                 return;
             morePages = [...morePages, ...page.items];

package/dist/comments/react/hooks/use-comment-queue.hooks.js

@@ -1,5 +1,5 @@
-import { useCallback, useEffect } from 'react';
-import { useFetchQuery, useInvalidate } from '@jini-ai/ui/fetch-query';
+import { useCallback, useEffect, useMemo, useRef } from 'react';
+import { useCachedLoader, useFetchQuery, useInvalidate } from '@jini-ai/ui/fetch-query';
 import { useController } from '../../../core/react/use-controller.js';
 import { createCommentQueueController } from '../../controllers/comment-queue.controller.js';
 import { KEYS, emptyRowState } from '../../rules.js';
@@ -13,12 +13,23 @@ const NO_GRANTS = [];
 export function useCommentQueue({ api, permissions = NO_GRANTS }, { t = englishComments, events } = {}) {
     const invalidate = useInvalidate();
     const invalidateQueue = useCallback(() => invalidate({ key: KEYS.queueRoot }), [invalidate]);
+    const loadPageRef = useRef(null);
     const { controller, snapshot } = useController({
-        create: () => createCommentQueueController({ api, permissions }, { t, onInvalidate: invalidateQueue }),
+        create: () => createCommentQueueController({ api, permissions }, { t, onInvalidate: invalidateQueue, loadPage: required => loadPageRef.current(required) }),
         dependencies: [api, invalidateQueue],
     });
     useEffect(() => { controller?.configure({ permissions, t }); }, [controller, permissions, t]);
     const status = snapshot?.status ?? 'pending';
+    const cursor = snapshot?.nextCursor ?? '';
+    const cursorKey = useMemo(() => [...KEYS.queue(status), 'cursor', cursor], [status, cursor]);
+    const fetchCursor = useCallback(() => api.listCommentsQueue({}, { status, cursor }), [api, status, cursor]);
+    const cursorLoader = useCachedLoader({ key: cursorKey, fetch: fetchCursor }, { staleTime: 0 });
+    // The gesture remains controller-owned, including its same-tick lock and generation fence.
+    // Only I/O changes: cursor pages now share page one's provider and status invalidation prefix.
+    loadPageRef.current = ({ status: requestedStatus, cursor: requestedCursor }) => cursorLoader.load({
+        key: [...KEYS.queue(requestedStatus), 'cursor', requestedCursor],
+        fetch: () => api.listCommentsQueue({}, { status: requestedStatus, cursor: requestedCursor }),
+    });
     const firstPage = useFetchQuery({ key: KEYS.queue(status), fetch: () => api.listCommentsQueue({}, { status }) });
     useEffect(() => { controller?.settleFirstPage({ page: firstPage.data ?? null, error: firstPage.error, status }); }, [controller, firstPage.data, firstPage.error, status]);
     // Stable identity avoids resubscribing on every render. The host filters out unrelated

package/dist/consent/react/ConsentSettingsPanel.d.ts

@@ -0,0 +1,27 @@
+/** The host's settings controller uses its existing ledger lifecycle. */
+export interface ConsentSettingsView {
+    enabled: boolean;
+    regionMode: 'auto' | 'opt-in' | 'opt-out';
+    policyVersion: string;
+    privacyPolicyUrl: string;
+    title: string;
+    message: string;
+    acceptLabel: string;
+    rejectLabel: string;
+    preferencesLabel: string;
+}
+export interface ConsentSettingsPanelProps {
+    value: ConsentSettingsView;
+    onChange(required: {
+        patch: Partial<ConsentSettingsView>;
+    }, optional?: Record<string, never>): void;
+    loading: boolean;
+    error: string | null;
+    status: string;
+    /** Host translations keyed by the exact fallback copy; unspecified entries use English. */
+    dictionary?: Readonly<Record<string, string>>;
+}
+/** Shared jini settings classes keep the panel in the host's design language.
+ * Native labels/selects/checkboxes support keyboard use at desktop and narrow widths. */
+export declare function ConsentSettingsPanel({ value, onChange, loading, error, status, dictionary }: ConsentSettingsPanelProps): import("react").JSX.Element;
+//# sourceMappingURL=ConsentSettingsPanel.d.ts.map

package/dist/consent/react/ConsentSettingsPanel.js

@@ -0,0 +1,24 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useId } from 'react';
+import { useConsentSettingsPanel, usePolicyVersionInput } from './settings-panel.hooks.js';
+const TEXT_FIELDS = [
+    ['title', 'Banner title', 2000], ['message', 'Banner message', 2000],
+    ['acceptLabel', 'Accept button text', 2000], ['rejectLabel', 'Reject button text', 2000],
+    ['preferencesLabel', 'Preferences label', 2000], ['policyVersion', 'Policy version', 128],
+    ['privacyPolicyUrl', 'Privacy policy page URL', 2000],
+];
+/** Shared jini settings classes keep the panel in the host's design language.
+ * Native labels/selects/checkboxes support keyboard use at desktop and narrow widths. */
+export function ConsentSettingsPanel({ value, onChange, loading, error, status, dictionary = {} }) {
+    const id = useId();
+    const t = (text) => dictionary[text] ?? text;
+    const handlers = useConsentSettingsPanel({ value, onChange });
+    return _jsxs("section", { className: "jini-settings-section", "aria-labelledby": `${id}-heading`, children: [_jsx("div", { className: "jini-section-head", children: _jsxs("div", { children: [_jsx("h4", { id: `${id}-heading`, children: t('Site cookie consent') }), _jsx("p", { className: "jini-hint", children: t('Provides the consent mechanism, not legal advice. Review your texts, categories, and privacy policy for your site.') })] }) }), _jsx("p", { className: "jini-hint", children: t('Off by default. In opt-in regions, optional scripts stay paused until a visitor chooses. Unclassified third-party scripts use the marketing category. Global Privacy Control disables analytics and marketing.') }), _jsxs("button", { type: "button", className: value.enabled ? 'jini-toggle-row on' : 'jini-toggle-row', role: "switch", "aria-checked": value.enabled, "aria-labelledby": `${id}-enabled`, "aria-describedby": `${id}-hint`, disabled: loading, onClick: handlers.toggle, children: [_jsxs("span", { className: "jini-toggle-row-text", children: [_jsx("span", { id: `${id}-enabled`, className: "jini-toggle-row-label", children: t('Enable cookie consent on this site') }), _jsx("span", { id: `${id}-hint`, className: "jini-toggle-row-hint", children: t('Applies to published site pages.') })] }), _jsx("span", { className: "jini-toggle-row-switch", "aria-hidden": "true" })] }), _jsxs("fieldset", { disabled: loading, className: "jini-consent-settings-fields", children: [_jsx("legend", { children: t('Banner settings') }), _jsxs("label", { className: "jini-consent-settings-field", children: [_jsx("span", { className: "jini-field-label", children: t('Region mode') }), _jsxs("select", { className: "jini-input", value: value.regionMode, onChange: handlers.region, children: [_jsx("option", { value: "auto", children: t('Automatic (unknown region: opt-in)') }), _jsx("option", { value: "opt-in", children: t('Opt-in everywhere (EU / UK)') }), _jsx("option", { value: "opt-out", children: t('Opt-out everywhere (California)') })] })] }), _jsx("p", { className: "jini-hint", children: t('Automatic uses a trusted request-region header when configured. California permits optional categories until opt-out; Global Privacy Control always disables analytics and marketing.') }), TEXT_FIELDS.map(([key, label, maxLength]) => _jsxs("label", { className: "jini-consent-settings-field", children: [_jsx("span", { className: "jini-field-label", children: t(label) }), key === 'policyVersion' ? _jsx(PolicyVersionInput, { value: value.policyVersion, onChange: onChange }) : key === 'message' ? _jsx("textarea", { className: "jini-input", value: value[key], maxLength: maxLength, rows: 3, onChange: handlers.text(key) }) : _jsx("input", { className: "jini-input", type: "text", value: value[key], maxLength: maxLength, onChange: handlers.text(key) })] }, key)), _jsx("p", { className: "jini-hint", children: t('Link a published privacy policy page with its URL, such as /privacy. Change the policy version to ask visitors to choose again.') })] }), error && _jsx("p", { className: "jini-hint jini-hint-error", role: "alert", children: error }), _jsx("p", { className: "jini-hint", role: "status", children: status })] });
+}
+/** Keep transient empty edits local; only a valid policy version reaches autosave.
+ * Native validity gives keyboard users an actionable error. @complexity O(version length), <=128. */
+function PolicyVersionInput({ value, onChange }) {
+    const { draft, change, blur } = usePolicyVersionInput({ value, onChange });
+    return _jsx("input", { className: "jini-input", type: "text", value: draft, required: true, pattern: String.raw `.*\S.*`, maxLength: 128, onChange: change, onBlur: blur });
+}
+//# sourceMappingURL=ConsentSettingsPanel.js.map

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

@@ -0,0 +1,3 @@
+export { ConsentSettingsPanel } from './ConsentSettingsPanel.js';
+export type { ConsentSettingsPanelProps, ConsentSettingsView } from './ConsentSettingsPanel.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/consent/react/index.js

@@ -0,0 +1,2 @@
+export { ConsentSettingsPanel } from './ConsentSettingsPanel.js';
+//# sourceMappingURL=index.js.map

package/dist/consent/react/settings-panel.hooks.d.ts

@@ -0,0 +1,19 @@
+import { type ChangeEvent, type FocusEvent } from 'react';
+import type { ConsentSettingsPanelProps, ConsentSettingsView } from './ConsentSettingsPanel.js';
+/** Keep value conversions and toggle behavior out of the view. React owns event signatures. */
+export declare function useConsentSettingsPanel({ value, onChange }: Pick<ConsentSettingsPanelProps, 'value' | 'onChange'>, _options?: {}): {
+    toggle: () => void;
+    region: (event: ChangeEvent<HTMLSelectElement>) => void;
+    text: (key: keyof ConsentSettingsView) => (event: ChangeEvent<HTMLInputElement | HTMLTextAreaElement>) => void;
+};
+/** Keep transient empty edits local; only a valid policy version reaches autosave.
+ * Native validity gives keyboard users an actionable error. Valid edits save before navigation.
+ * @complexity O(version length), <=128. */
+export declare function usePolicyVersionInput({ value, onChange }: Pick<ConsentSettingsPanelProps, 'onChange'> & {
+    value: string;
+}, _options?: {}): {
+    draft: string;
+    change: (event: ChangeEvent<HTMLInputElement>) => void;
+    blur: (event: FocusEvent<HTMLInputElement>) => void;
+};
+//# sourceMappingURL=settings-panel.hooks.d.ts.map

package/dist/consent/react/settings-panel.hooks.js

@@ -0,0 +1,30 @@
+import { useEffect, useState } from 'react';
+/** Keep value conversions and toggle behavior out of the view. React owns event signatures. */
+export function useConsentSettingsPanel({ value, onChange }, _options = {}) {
+    return {
+        toggle: () => onChange({ patch: { enabled: !value.enabled } }),
+        region: (event) => onChange({ patch: { regionMode: event.target.value } }),
+        text: (key) => (event) => onChange({ patch: { [key]: event.target.value } }),
+    };
+}
+/** Keep transient empty edits local; only a valid policy version reaches autosave.
+ * Native validity gives keyboard users an actionable error. Valid edits save before navigation.
+ * @complexity O(version length), <=128. */
+export function usePolicyVersionInput({ value, onChange }, _options = {}) {
+    const [draft, setDraft] = useState(value);
+    useEffect(() => setDraft(value), [value]);
+    return {
+        draft,
+        change: (event) => {
+            const next = event.currentTarget.value;
+            setDraft(next);
+            if (event.currentTarget.checkValidity())
+                onChange({ patch: { policyVersion: next } });
+        },
+        blur: (event) => {
+            if (!event.currentTarget.checkValidity())
+                event.currentTarget.reportValidity();
+        },
+    };
+}
+//# sourceMappingURL=settings-panel.hooks.js.map

package/dist/core/ports/forms.d.ts

@@ -54,9 +54,9 @@
  *
  * `FormFieldType` and `FormDefinitionStatus` are reference-implementation-specific vocabularies — OPEN, via the
  * `T | (string & {})` idiom `seo.ts`'s file header introduces for this port set. `FormFieldType` in
- * particular is a small, deliberately-not-yet-exhaustive set on the reference implementation (four
- * field kinds today); a host offering a richer form builder needs room to add its own without this
- * contract standing in the way.
+ * particular names only the original four kinds; the reference implementation's field registry
+ * (`@jini-ai/cms/forms` `FIELD_TYPE_REGISTRY`) now owns the full vocabulary, and a host offering a
+ * richer form builder needs room to add its own without this contract standing in the way.
  */
 /** A form field's input kind — open, see file header. */
 export type FormFieldType = "text" | "email" | "textarea" | "checkbox" | (string & {});
@@ -71,6 +71,21 @@ export interface AdminFormField {
     readonly maxLength?: number | null;
     readonly className?: string | undefined;
     readonly attributes?: Readonly<Record<string, string>> | undefined;
+    readonly placeholder?: string | undefined;
+    readonly helpText?: string | undefined;
+    readonly default?: string | number | boolean | readonly string[] | undefined;
+    readonly options?: ReadonlyArray<{
+        readonly value: string;
+        readonly label: string;
+    }> | undefined;
+    readonly minLength?: number | undefined;
+    readonly pattern?: string | undefined;
+    readonly min?: number | string | undefined;
+    readonly max?: number | string | undefined;
+    readonly step?: number | undefined;
+    readonly accept?: readonly string[] | undefined;
+    readonly maxFileSize?: number | undefined;
+    readonly checkboxValue?: string | undefined;
 }
 export interface AdminFormNotifyConfig {
     readonly enabled: boolean;
@@ -150,5 +165,10 @@ export interface AdminFormsPort {
         formId: string;
         submissionId: string;
     }, optionalArgs?: Record<string, never>): Promise<void>;
+    /** Download URL for a file answer's stored media. Optional: without it the view shows the
+     * filename as plain text. */
+    submissionFileUrl?(requiredArgs: {
+        mediaId: string;
+    }, optionalArgs?: Record<string, never>): string;
 }
 //# sourceMappingURL=forms.d.ts.map

package/dist/core/ports/forms.js

@@ -54,9 +54,9 @@
  *
  * `FormFieldType` and `FormDefinitionStatus` are reference-implementation-specific vocabularies — OPEN, via the
  * `T | (string & {})` idiom `seo.ts`'s file header introduces for this port set. `FormFieldType` in
- * particular is a small, deliberately-not-yet-exhaustive set on the reference implementation (four
- * field kinds today); a host offering a richer form builder needs room to add its own without this
- * contract standing in the way.
+ * particular names only the original four kinds; the reference implementation's field registry
+ * (`@jini-ai/cms/forms` `FIELD_TYPE_REGISTRY`) now owns the full vocabulary, and a host offering a
+ * richer form builder needs room to add its own without this contract standing in the way.
  */
 export {};
 //# sourceMappingURL=forms.js.map

package/dist/core/ports/seo.d.ts

@@ -74,6 +74,8 @@ export interface AdminSeoOpenGraph {
     readonly url: string;
     /** Already resolved to a renderable URL — never a media ref. */
     readonly image?: string;
+    /** Source reference before resizing, used to diagnose the selected share image. */
+    readonly imageRef?: string;
     readonly siteName?: string;
 }
 export interface AdminSeoTwitterCard {
@@ -81,6 +83,8 @@ export interface AdminSeoTwitterCard {
     readonly title: string;
     readonly description?: string;
     readonly image?: string;
+    /** Source reference before resizing, used to diagnose the selected share image. */
+    readonly imageRef?: string;
     readonly site?: string;
 }
 export interface AdminSeoRobotsDirective {
@@ -172,6 +176,19 @@ export interface AdminSeoPort {
     }): Promise<{
         text: string;
     }>;
+    /** Optional host-bound probe: byte size is unknown when Content-Length is unavailable. */
+    inspectShareImage?(required: {
+        url: string;
+    }, optional?: {
+        signal?: AbortSignal;
+    }): Promise<{
+        status: number;
+        byteSize: number | null;
+    }>;
+    /** Resolve local rendered share URLs back to their original source for image diagnostics. */
+    mediaPreviewUrl?(required: {
+        value: string;
+    }, optional?: Record<string, never>): string | null;
     /** Original thumbnail URL; media-reference resolution stays on the server. */
     mediaOriginalUrl(requiredArgs: {
         id: string;

package/dist/forms/adapters/http.d.ts

@@ -13,11 +13,14 @@ export interface FormsTransportPort {
         path: string;
     }, optional?: Record<string, never>): string;
 }
-/** Preserve the existing forms wire, including its data envelopes and explicit authoring route. */
+/** Preserve the existing forms wire, including its data envelopes and explicit authoring route.
+ * `mediaBasePath` (the host's media collection path) enables file-answer download links. */
 export declare function createHttpFormsApi({ transport, basePath }: {
     transport: FormsTransportPort;
     basePath: string;
-}, _optional?: Record<string, never>): AdminFormsPort;
+}, { mediaBasePath }?: {
+    mediaBasePath?: string;
+}): AdminFormsPort;
 /** The same generic POST used by both host screens; no form lifecycle is reimplemented here. */
 export declare function createHttpFormsTrash({ transport, basePath }: {
     transport: FormsTransportPort;

package/dist/forms/adapters/http.js

@@ -1,9 +1,14 @@
-/** Preserve the existing forms wire, including its data envelopes and explicit authoring route. */
-export function createHttpFormsApi({ transport, basePath }, _optional = {}) {
+/** Preserve the existing forms wire, including its data envelopes and explicit authoring route.
+ * `mediaBasePath` (the host's media collection path) enables file-answer download links. */
+export function createHttpFormsApi({ transport, basePath }, { mediaBasePath } = {}) {
     const base = basePath.replace(/\/$/, '');
     const formPath = (id) => `${base}/${encodeURIComponent(id)}`;
     const submissionPath = (formId, submissionId) => `${formPath(formId)}/submissions${submissionId === undefined ? '' : `/${encodeURIComponent(submissionId)}`}`;
+    const mediaBase = mediaBasePath?.replace(/\/$/, '');
     return {
+        ...(mediaBase === undefined ? {} : {
+            submissionFileUrl: ({ mediaId }, _optional = {}) => transport.url({ path: `${mediaBase}/${encodeURIComponent(mediaId)}/original` }),
+        }),
         async listFormDefinitions(_required, _optional = {}) {
             return (await transport.request({ path: base, method: 'GET' })).data;
         },

package/dist/forms/controllers/field-attributes-dialog.controller.d.ts

@@ -1,8 +1,11 @@
 import type { AdminFormField } from "../models.js";
 import { type AttrRow } from "../rules.js";
+import { type FieldSettingsForm, type OptionRow } from "../field-settings.js";
 export interface FieldAttributesDialogState {
     className: string;
     rows: AttrRow[];
+    /** The type's builder settings (field-settings.ts), edited as text until Save. */
+    settings: FieldSettingsForm;
     error: string | null;
 }
 export declare function initialFieldAttributesDialogState({ field }: {
@@ -12,6 +15,31 @@ export declare function initialFieldAttributesDialogState({ field }: {
 export declare function createFieldAttributesDialogController({ field }: {
     field: AdminFormField;
 }, _optional?: {}): {
+    setSettings({ patch }: {
+        patch: Partial<FieldSettingsForm>;
+    }, _options?: {}): void;
+    /** `single` replaces the selection: a dropdown or radio group has one default. */
+    toggleDefaultChoice({ value, on, single }: {
+        value: string;
+        on: boolean;
+        single: boolean;
+    }, _options?: {}): void;
+    toggleAccept({ value, on }: {
+        value: string;
+        on: boolean;
+    }, _options?: {}): void;
+    updateOption({ rowId, patch }: {
+        rowId: number;
+        patch: Partial<Pick<OptionRow, "value" | "label">>;
+    }, _options?: {}): void;
+    addOption(_required: Record<string, never>, _options?: {}): void;
+    removeOption({ rowId }: {
+        rowId: number;
+    }, _options?: {}): void;
+    moveOption({ rowId, offset }: {
+        rowId: number;
+        offset: -1 | 1;
+    }, _options?: {}): void;
     updateRow({ rowId, patch }: {
         rowId: number;
         patch: Partial<AttrRow>;
@@ -20,7 +48,37 @@ export declare function createFieldAttributesDialogController({ field }: {
         rowId: number;
     }, _options?: {}): void;
     addRow(_required: Record<string, never>, _options?: {}): void;
-    submit(_required: Record<string, never>, _options?: {}): import("../rules.js").FieldAttributesSubmitResult;
+    /** Settings are checked first: they sit above the attribute rows in the dialog. */
+    submit(_required: Record<string, never>, _options?: {}): {
+        ok: false;
+        error: string;
+    } | {
+        ok: true;
+        patch: {
+            id?: string;
+            label?: string;
+            type?: import("../../core/index.js").FormFieldType;
+            required?: boolean;
+            maxLength?: number | null;
+            className?: string | undefined;
+            attributes?: (Readonly<Record<string, string>> & Record<string, string>) | undefined;
+            placeholder?: string | undefined;
+            helpText?: string | undefined;
+            default?: string | number | boolean | readonly string[] | undefined;
+            options?: ReadonlyArray<{
+                readonly value: string;
+                readonly label: string;
+            }> | undefined;
+            minLength?: number | undefined;
+            pattern?: string | undefined;
+            min?: number | string | undefined;
+            max?: number | string | undefined;
+            step?: number | undefined;
+            accept?: readonly string[] | undefined;
+            maxFileSize?: number | undefined;
+            checkboxValue?: string | undefined;
+        };
+    };
     getSnapshot: () => Readonly<FieldAttributesDialogState>;
     subscribe: ({ listener }: {
         listener: () => void;

package/dist/forms/controllers/field-attributes-dialog.controller.js

@@ -1,13 +1,34 @@
 import { createFormsDraftStore } from "./draft-store.js";
 import { attrRowsFromField, updateAttrRow, removeAttrRow, addAttrRow, buildFieldAttributesPatch } from "../rules.js";
+import { addOptionRow, buildFieldSettingsPatch, moveOptionRow, removeOptionRow, settingsFormFromField, updateOptionRow } from "../field-settings.js";
 export function initialFieldAttributesDialogState({ field }, _optional = {}) {
-    return { className: field.className ?? "", rows: attrRowsFromField({ field }), error: null };
+    return { className: field.className ?? "", rows: attrRowsFromField({ field }), settings: settingsFormFromField({ field }), error: null };
 }
+/** Add or remove one value from a list setting (accepted uploads, default choices). */
+const toggled = (values, value, on) => on ? (values.includes(value) ? values : [...values, value]) : values.filter((item) => item !== value);
 /** A headless section store. React owns subscriptions/effects, never this state. */
 export function createFieldAttributesDialogController({ field }, _optional = {}) {
     const store = createFormsDraftStore({ initial: initialFieldAttributesDialogState({ field }) });
+    const editSettings = (change) => store.update({ key: 'settings', value: change });
+    const editOptions = (change) => editSettings(settings => ({ ...settings, options: change(settings.options) }));
     return {
         ...store,
+        setSettings({ patch }, _options = {}) {
+            editSettings(settings => ({ ...settings, ...patch }));
+        },
+        /** `single` replaces the selection: a dropdown or radio group has one default. */
+        toggleDefaultChoice({ value, on, single }, _options = {}) {
+            editSettings(settings => ({ ...settings, defaultChoices: single ? (on && value ? [value] : []) : toggled(settings.defaultChoices, value, on) }));
+        },
+        toggleAccept({ value, on }, _options = {}) {
+            editSettings(settings => ({ ...settings, accept: toggled(settings.accept, value, on) }));
+        },
+        updateOption({ rowId, patch }, _options = {}) {
+            editOptions(rows => updateOptionRow({ rows, rowId, patch }));
+        },
+        addOption(_required, _options = {}) { editOptions(rows => addOptionRow({ rows })); },
+        removeOption({ rowId }, _options = {}) { editOptions(rows => removeOptionRow({ rows, rowId })); },
+        moveOption({ rowId, offset }, _options = {}) { editOptions(rows => moveOptionRow({ rows, rowId, offset })); },
         updateRow({ rowId, patch }, _options = {}) {
             store.update({ key: 'rows', value: rows => updateAttrRow({ rows, rowId, patch }) });
         },
@@ -17,8 +38,12 @@ export function createFieldAttributesDialogController({ field }, _optional = {})
         addRow(_required, _options = {}) {
             store.update({ key: 'rows', value: rows => addAttrRow({ rows }) });
         },
+        /** Settings are checked first: they sit above the attribute rows in the dialog. */
         submit(_required, _options = {}) {
-            const result = buildFieldAttributesPatch(store.getSnapshot());
+            const snapshot = store.getSnapshot();
+            const settings = buildFieldSettingsPatch({ form: snapshot.settings, field });
+            const attributes = buildFieldAttributesPatch(snapshot);
+            const result = !settings.ok ? settings : !attributes.ok ? attributes : { ok: true, patch: { ...settings.patch, ...attributes.patch } };
             store.update({ key: 'error', value: result.ok ? null : result.error });
             return result;
         },