@jini-ai/admin 0.4.2 → 0.4.4

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

@@ -0,0 +1,452 @@
+import type { ModulePageProps } from '../../core/react/bind-react.js';
+import type { AdminInstance } from '../../core/module/types.js';
+import type { ReactNode } from 'react';
+import type { FormsReactOptions } from './hooks/FormsPorts.hooks.js';
+export type { FormsReactOptions, FormsPorts } from './hooks/FormsPorts.hooks.js';
+export { FormsPortsContext, FormsOptionsContext, useFormsPorts } from './hooks/FormsPorts.hooks.js';
+export { useFormsList } from './hooks/use-forms-list.hooks.js';
+export { useFormEditor } from './hooks/use-form-editor.hooks.js';
+export type { FormsListProps } from './pages/FormsList.js';
+export type { FormEditorProps } from './pages/FormEditor.js';
+export type { FieldAttributesDialogProps } from './components/FieldAttributesDialog.js';
+export interface FormsModulePageProps extends ModulePageProps {
+    readonly formId?: string;
+    readonly params?: Readonly<Record<string, unknown>>;
+}
+/** One scoped module factory; page sections share their draft across route-derived tab changes. */
+export declare function forms(_required: Record<string, never>, options?: FormsReactOptions): {
+    id: "forms";
+    requires: {
+        readonly formsApi: import("../../core/module/token.js").AdminPortToken<import("../ports.js").AdminFormsPort, "admin.forms.api">;
+        readonly formsTrash: import("../../core/module/token.js").AdminPortToken<import("../ports.js").FormsTrashPort, "admin.forms.trash">;
+    };
+    optional: {
+        readonly formsEvents: import("../../core/module/token.js").AdminPortToken<import("../ports.js").FormsEventsPort, "admin.forms.events">;
+        readonly formsNavigation: import("../../core/module/token.js").AdminPortToken<import("../ports.js").FormsNavigationPort, "admin.forms.navigation">;
+    };
+    messages: {
+        readonly "Created / Updated": "Created / Updated";
+        readonly "Created {created} \u00B7 Updated {updated}": "Created {created} · Updated {updated}";
+        readonly "Created {date}": "Created {date}";
+        readonly "Updated {date}": "Updated {date}";
+        readonly Builder: "Builder";
+        readonly HTML: "HTML";
+        readonly "Form authoring mode": "Form authoring mode";
+        readonly "Form HTML": "Form HTML";
+        readonly "Copy HTML embed": "Copy HTML embed";
+        readonly "Copied!": "Copied!";
+        readonly "Could not copy embed": "Could not copy embed";
+        readonly Send: "Send";
+        readonly Back: "Back";
+        readonly Content: "Content";
+        readonly Forms: "Forms";
+        readonly "Manage the forms embedded across the site and their submissions.": "Manage the forms embedded across the site and their submissions.";
+        readonly "New form": "New form";
+        readonly "No forms yet.": "No forms yet.";
+        readonly "Create your first form to start collecting submissions.": "Create your first form to start collecting submissions.";
+        readonly Name: "Name";
+        readonly Slug: "Slug";
+        readonly Status: "Status";
+        readonly Fields: "Fields";
+        readonly Notify: "Notify";
+        readonly More: "More";
+        readonly off: "off";
+        readonly Edit: "Edit";
+        readonly Disable: "Disable";
+        readonly Enable: "Enable";
+        readonly "Move to trash?": "Move to trash?";
+        readonly "Move to trash": "Move to trash";
+        readonly Move: "Move";
+        readonly "to trash? It will disappear from the site and from this list.": "to trash? It will disappear from the site and from this list.";
+        readonly "Field attributes \u2014": "Field attributes —";
+        readonly "CSS classes": "CSS classes";
+        readonly "HTML attributes": "HTML attributes";
+        readonly Value: "Value";
+        readonly Remove: "Remove";
+        readonly "Add attribute": "Add attribute";
+        readonly Save: "Save";
+        readonly Cancel: "Cancel";
+        readonly ID: "ID";
+        readonly Label: "Label";
+        readonly Type: "Type";
+        readonly Req: "Req";
+        readonly "Max length": "Max length";
+        readonly "Add field": "Add field";
+        readonly "Back to submissions": "Back to submissions";
+        readonly "Submitted at": "Submitted at";
+        readonly "Source IP": "Source IP";
+        readonly "Delete submission": "Delete submission";
+        readonly "Confirm delete": "Confirm delete";
+        readonly "Delete permanently?": "Delete permanently?";
+        readonly "This cannot be undone.": "This cannot be undone.";
+        readonly "It will disappear from this list. You can restore it from the Trash.": "It will disappear from this list. You can restore it from the Trash.";
+        readonly View: "View";
+        readonly "Load more": "Load more";
+        readonly "Loading\u2026": "Loading…";
+        readonly "No submissions yet.": "No submissions yet.";
+        readonly "Create form": "Create form";
+        readonly Form: "Form";
+        readonly "Configure a new form's fields.": "Configure a new form's fields.";
+        readonly "Configure this form's fields, or review its submissions.": "Configure this form's fields, or review its submissions.";
+        readonly Submissions: "Submissions";
+        readonly "Back to forms": "Back to forms";
+        readonly "Actions for form \"{name}\"": "Actions for form \"{name}\"";
+        readonly "Loading forms\u2026": "Loading forms…";
+        readonly Delete: "Delete";
+        readonly "See more about field attributes": "See more about field attributes";
+        readonly "Add CSS classes and HTML attributes to this field\u2019s input. Classes are unrestricted \u2014 Tailwind utility classes like ": "Add CSS classes and HTML attributes to this field’s input. Classes are unrestricted — Tailwind utility classes like ";
+        readonly "or ": "or ";
+        readonly " work as expected. Attribute names are limited to a safe allowlist (": " work as expected. Attribute names are limited to a safe allowlist (";
+        readonly ", ": ", ";
+        readonly ", and a fixed list of layout/behavior attributes) \u2014 anything else, including event handlers like ": ", and a fixed list of layout/behavior attributes) — anything else, including event handlers like ";
+        readonly ", is rejected.": ", is rejected.";
+        readonly Attribute: "Attribute";
+        readonly "e.g. Enter your work email": "e.g. Enter your work email";
+        readonly "Existing fields cannot be removed once created": "Existing fields cannot be removed once created";
+        readonly "Loading submission\u2026": "Loading submission…";
+        readonly "Loading submissions\u2026": "Loading submissions…";
+        readonly "Form sections": "Form sections";
+        readonly "Loading form\u2026": "Loading form…";
+        readonly "failed to delete form": "failed to delete form";
+        readonly "This item changed since you loaded it. Reload and try again.": "This item changed since you loaded it. Reload and try again.";
+        readonly "failed to update form status": "failed to update form status";
+        readonly "failed to load forms": "failed to load forms";
+        readonly "save failed": "save failed";
+        readonly "status update failed": "status update failed";
+        readonly "failed to load form": "failed to load form";
+        readonly recipient: "recipient";
+        readonly recipients: "recipients";
+        readonly "failed to load submissions": "failed to load submissions";
+        readonly "failed to load submission": "failed to load submission";
+        readonly "delete failed": "delete failed";
+        readonly "Unknown field": "Unknown field";
+    };
+    pages: {
+        readonly list: {
+            readonly path: "/forms";
+            readonly label: "Forms";
+            readonly permissions: readonly ["admin.forms.manage"];
+            readonly agentReachable: true;
+            readonly nav: {
+                readonly group: "content";
+                readonly icon: "forms";
+            };
+            readonly tabs: {};
+        };
+        readonly editor: {
+            readonly path: "/forms/:formId";
+            readonly label: "Form";
+            readonly permissions: readonly ["admin.forms.manage"];
+            readonly agentReachable: true;
+            readonly tabs: {
+                readonly fields: {
+                    readonly label: "Fields";
+                    readonly agentReachable: true;
+                };
+                readonly submissions: {
+                    readonly label: "Submissions";
+                    readonly agentReachable: true;
+                };
+            };
+        };
+    };
+} & {
+    react: {
+        Provider: ({ admin, children, options: liveOptions }: {
+            admin: AdminInstance;
+            children: ReactNode;
+            options?: FormsReactOptions;
+        }) => import("react").FunctionComponentElement<{
+            admin: AdminInstance;
+            children: ReactNode;
+        }>;
+        module: {
+            readonly id: "forms";
+            readonly requires: {
+                readonly formsApi: import("../../core/module/token.js").AdminPortToken<import("../ports.js").AdminFormsPort, "admin.forms.api">;
+                readonly formsTrash: import("../../core/module/token.js").AdminPortToken<import("../ports.js").FormsTrashPort, "admin.forms.trash">;
+            };
+            readonly optional: {
+                readonly formsEvents: import("../../core/module/token.js").AdminPortToken<import("../ports.js").FormsEventsPort, "admin.forms.events">;
+                readonly formsNavigation: import("../../core/module/token.js").AdminPortToken<import("../ports.js").FormsNavigationPort, "admin.forms.navigation">;
+            };
+            readonly messages: {
+                readonly "Created / Updated": "Created / Updated";
+                readonly "Created {created} \u00B7 Updated {updated}": "Created {created} · Updated {updated}";
+                readonly "Created {date}": "Created {date}";
+                readonly "Updated {date}": "Updated {date}";
+                readonly Builder: "Builder";
+                readonly HTML: "HTML";
+                readonly "Form authoring mode": "Form authoring mode";
+                readonly "Form HTML": "Form HTML";
+                readonly "Copy HTML embed": "Copy HTML embed";
+                readonly "Copied!": "Copied!";
+                readonly "Could not copy embed": "Could not copy embed";
+                readonly Send: "Send";
+                readonly Back: "Back";
+                readonly Content: "Content";
+                readonly Forms: "Forms";
+                readonly "Manage the forms embedded across the site and their submissions.": "Manage the forms embedded across the site and their submissions.";
+                readonly "New form": "New form";
+                readonly "No forms yet.": "No forms yet.";
+                readonly "Create your first form to start collecting submissions.": "Create your first form to start collecting submissions.";
+                readonly Name: "Name";
+                readonly Slug: "Slug";
+                readonly Status: "Status";
+                readonly Fields: "Fields";
+                readonly Notify: "Notify";
+                readonly More: "More";
+                readonly off: "off";
+                readonly Edit: "Edit";
+                readonly Disable: "Disable";
+                readonly Enable: "Enable";
+                readonly "Move to trash?": "Move to trash?";
+                readonly "Move to trash": "Move to trash";
+                readonly Move: "Move";
+                readonly "to trash? It will disappear from the site and from this list.": "to trash? It will disappear from the site and from this list.";
+                readonly "Field attributes \u2014": "Field attributes —";
+                readonly "CSS classes": "CSS classes";
+                readonly "HTML attributes": "HTML attributes";
+                readonly Value: "Value";
+                readonly Remove: "Remove";
+                readonly "Add attribute": "Add attribute";
+                readonly Save: "Save";
+                readonly Cancel: "Cancel";
+                readonly ID: "ID";
+                readonly Label: "Label";
+                readonly Type: "Type";
+                readonly Req: "Req";
+                readonly "Max length": "Max length";
+                readonly "Add field": "Add field";
+                readonly "Back to submissions": "Back to submissions";
+                readonly "Submitted at": "Submitted at";
+                readonly "Source IP": "Source IP";
+                readonly "Delete submission": "Delete submission";
+                readonly "Confirm delete": "Confirm delete";
+                readonly "Delete permanently?": "Delete permanently?";
+                readonly "This cannot be undone.": "This cannot be undone.";
+                readonly "It will disappear from this list. You can restore it from the Trash.": "It will disappear from this list. You can restore it from the Trash.";
+                readonly View: "View";
+                readonly "Load more": "Load more";
+                readonly "Loading\u2026": "Loading…";
+                readonly "No submissions yet.": "No submissions yet.";
+                readonly "Create form": "Create form";
+                readonly Form: "Form";
+                readonly "Configure a new form's fields.": "Configure a new form's fields.";
+                readonly "Configure this form's fields, or review its submissions.": "Configure this form's fields, or review its submissions.";
+                readonly Submissions: "Submissions";
+                readonly "Back to forms": "Back to forms";
+                readonly "Actions for form \"{name}\"": "Actions for form \"{name}\"";
+                readonly "Loading forms\u2026": "Loading forms…";
+                readonly Delete: "Delete";
+                readonly "See more about field attributes": "See more about field attributes";
+                readonly "Add CSS classes and HTML attributes to this field\u2019s input. Classes are unrestricted \u2014 Tailwind utility classes like ": "Add CSS classes and HTML attributes to this field’s input. Classes are unrestricted — Tailwind utility classes like ";
+                readonly "or ": "or ";
+                readonly " work as expected. Attribute names are limited to a safe allowlist (": " work as expected. Attribute names are limited to a safe allowlist (";
+                readonly ", ": ", ";
+                readonly ", and a fixed list of layout/behavior attributes) \u2014 anything else, including event handlers like ": ", and a fixed list of layout/behavior attributes) — anything else, including event handlers like ";
+                readonly ", is rejected.": ", is rejected.";
+                readonly Attribute: "Attribute";
+                readonly "e.g. Enter your work email": "e.g. Enter your work email";
+                readonly "Existing fields cannot be removed once created": "Existing fields cannot be removed once created";
+                readonly "Loading submission\u2026": "Loading submission…";
+                readonly "Loading submissions\u2026": "Loading submissions…";
+                readonly "Form sections": "Form sections";
+                readonly "Loading form\u2026": "Loading form…";
+                readonly "failed to delete form": "failed to delete form";
+                readonly "This item changed since you loaded it. Reload and try again.": "This item changed since you loaded it. Reload and try again.";
+                readonly "failed to update form status": "failed to update form status";
+                readonly "failed to load forms": "failed to load forms";
+                readonly "save failed": "save failed";
+                readonly "status update failed": "status update failed";
+                readonly "failed to load form": "failed to load form";
+                readonly recipient: "recipient";
+                readonly recipients: "recipients";
+                readonly "failed to load submissions": "failed to load submissions";
+                readonly "failed to load submission": "failed to load submission";
+                readonly "delete failed": "delete failed";
+                readonly "Unknown field": "Unknown field";
+            };
+            readonly pages: {
+                readonly list: {
+                    readonly path: "/forms";
+                    readonly label: "Forms";
+                    readonly permissions: readonly ["admin.forms.manage"];
+                    readonly agentReachable: true;
+                    readonly nav: {
+                        readonly group: "content";
+                        readonly icon: "forms";
+                    };
+                    readonly tabs: {};
+                };
+                readonly editor: {
+                    readonly path: "/forms/:formId";
+                    readonly label: "Form";
+                    readonly permissions: readonly ["admin.forms.manage"];
+                    readonly agentReachable: true;
+                    readonly tabs: {
+                        readonly fields: {
+                            readonly label: "Fields";
+                            readonly agentReachable: true;
+                        };
+                        readonly submissions: {
+                            readonly label: "Submissions";
+                            readonly agentReachable: true;
+                        };
+                    };
+                };
+            };
+        };
+        pages: {
+            readonly list: {
+                Page: import("react").LazyExoticComponent<import("react").ComponentType<ModulePageProps>>;
+                tabs: {};
+            };
+            readonly editor: {
+                Page: import("react").LazyExoticComponent<import("react").ComponentType<ModulePageProps>>;
+                tabs: {
+                    readonly fields: import("react").LazyExoticComponent<import("react").ComponentType<import("../../react/bind-react.js").TabViewProps>>;
+                    readonly submissions: import("react").LazyExoticComponent<import("react").ComponentType<import("../../react/bind-react.js").TabViewProps>>;
+                };
+            };
+        };
+        usePorts: (_required?: Record<string, never>, _optional?: Record<string, never>) => import("../../core/module/types.js").ScopedPorts<{
+            readonly id: "forms";
+            readonly requires: {
+                readonly formsApi: import("../../core/module/token.js").AdminPortToken<import("../ports.js").AdminFormsPort, "admin.forms.api">;
+                readonly formsTrash: import("../../core/module/token.js").AdminPortToken<import("../ports.js").FormsTrashPort, "admin.forms.trash">;
+            };
+            readonly optional: {
+                readonly formsEvents: import("../../core/module/token.js").AdminPortToken<import("../ports.js").FormsEventsPort, "admin.forms.events">;
+                readonly formsNavigation: import("../../core/module/token.js").AdminPortToken<import("../ports.js").FormsNavigationPort, "admin.forms.navigation">;
+            };
+            readonly messages: {
+                readonly "Created / Updated": "Created / Updated";
+                readonly "Created {created} \u00B7 Updated {updated}": "Created {created} · Updated {updated}";
+                readonly "Created {date}": "Created {date}";
+                readonly "Updated {date}": "Updated {date}";
+                readonly Builder: "Builder";
+                readonly HTML: "HTML";
+                readonly "Form authoring mode": "Form authoring mode";
+                readonly "Form HTML": "Form HTML";
+                readonly "Copy HTML embed": "Copy HTML embed";
+                readonly "Copied!": "Copied!";
+                readonly "Could not copy embed": "Could not copy embed";
+                readonly Send: "Send";
+                readonly Back: "Back";
+                readonly Content: "Content";
+                readonly Forms: "Forms";
+                readonly "Manage the forms embedded across the site and their submissions.": "Manage the forms embedded across the site and their submissions.";
+                readonly "New form": "New form";
+                readonly "No forms yet.": "No forms yet.";
+                readonly "Create your first form to start collecting submissions.": "Create your first form to start collecting submissions.";
+                readonly Name: "Name";
+                readonly Slug: "Slug";
+                readonly Status: "Status";
+                readonly Fields: "Fields";
+                readonly Notify: "Notify";
+                readonly More: "More";
+                readonly off: "off";
+                readonly Edit: "Edit";
+                readonly Disable: "Disable";
+                readonly Enable: "Enable";
+                readonly "Move to trash?": "Move to trash?";
+                readonly "Move to trash": "Move to trash";
+                readonly Move: "Move";
+                readonly "to trash? It will disappear from the site and from this list.": "to trash? It will disappear from the site and from this list.";
+                readonly "Field attributes \u2014": "Field attributes —";
+                readonly "CSS classes": "CSS classes";
+                readonly "HTML attributes": "HTML attributes";
+                readonly Value: "Value";
+                readonly Remove: "Remove";
+                readonly "Add attribute": "Add attribute";
+                readonly Save: "Save";
+                readonly Cancel: "Cancel";
+                readonly ID: "ID";
+                readonly Label: "Label";
+                readonly Type: "Type";
+                readonly Req: "Req";
+                readonly "Max length": "Max length";
+                readonly "Add field": "Add field";
+                readonly "Back to submissions": "Back to submissions";
+                readonly "Submitted at": "Submitted at";
+                readonly "Source IP": "Source IP";
+                readonly "Delete submission": "Delete submission";
+                readonly "Confirm delete": "Confirm delete";
+                readonly "Delete permanently?": "Delete permanently?";
+                readonly "This cannot be undone.": "This cannot be undone.";
+                readonly "It will disappear from this list. You can restore it from the Trash.": "It will disappear from this list. You can restore it from the Trash.";
+                readonly View: "View";
+                readonly "Load more": "Load more";
+                readonly "Loading\u2026": "Loading…";
+                readonly "No submissions yet.": "No submissions yet.";
+                readonly "Create form": "Create form";
+                readonly Form: "Form";
+                readonly "Configure a new form's fields.": "Configure a new form's fields.";
+                readonly "Configure this form's fields, or review its submissions.": "Configure this form's fields, or review its submissions.";
+                readonly Submissions: "Submissions";
+                readonly "Back to forms": "Back to forms";
+                readonly "Actions for form \"{name}\"": "Actions for form \"{name}\"";
+                readonly "Loading forms\u2026": "Loading forms…";
+                readonly Delete: "Delete";
+                readonly "See more about field attributes": "See more about field attributes";
+                readonly "Add CSS classes and HTML attributes to this field\u2019s input. Classes are unrestricted \u2014 Tailwind utility classes like ": "Add CSS classes and HTML attributes to this field’s input. Classes are unrestricted — Tailwind utility classes like ";
+                readonly "or ": "or ";
+                readonly " work as expected. Attribute names are limited to a safe allowlist (": " work as expected. Attribute names are limited to a safe allowlist (";
+                readonly ", ": ", ";
+                readonly ", and a fixed list of layout/behavior attributes) \u2014 anything else, including event handlers like ": ", and a fixed list of layout/behavior attributes) — anything else, including event handlers like ";
+                readonly ", is rejected.": ", is rejected.";
+                readonly Attribute: "Attribute";
+                readonly "e.g. Enter your work email": "e.g. Enter your work email";
+                readonly "Existing fields cannot be removed once created": "Existing fields cannot be removed once created";
+                readonly "Loading submission\u2026": "Loading submission…";
+                readonly "Loading submissions\u2026": "Loading submissions…";
+                readonly "Form sections": "Form sections";
+                readonly "Loading form\u2026": "Loading form…";
+                readonly "failed to delete form": "failed to delete form";
+                readonly "This item changed since you loaded it. Reload and try again.": "This item changed since you loaded it. Reload and try again.";
+                readonly "failed to update form status": "failed to update form status";
+                readonly "failed to load forms": "failed to load forms";
+                readonly "save failed": "save failed";
+                readonly "status update failed": "status update failed";
+                readonly "failed to load form": "failed to load form";
+                readonly recipient: "recipient";
+                readonly recipients: "recipients";
+                readonly "failed to load submissions": "failed to load submissions";
+                readonly "failed to load submission": "failed to load submission";
+                readonly "delete failed": "delete failed";
+                readonly "Unknown field": "Unknown field";
+            };
+            readonly pages: {
+                readonly list: {
+                    readonly path: "/forms";
+                    readonly label: "Forms";
+                    readonly permissions: readonly ["admin.forms.manage"];
+                    readonly agentReachable: true;
+                    readonly nav: {
+                        readonly group: "content";
+                        readonly icon: "forms";
+                    };
+                    readonly tabs: {};
+                };
+                readonly editor: {
+                    readonly path: "/forms/:formId";
+                    readonly label: "Form";
+                    readonly permissions: readonly ["admin.forms.manage"];
+                    readonly agentReachable: true;
+                    readonly tabs: {
+                        readonly fields: {
+                            readonly label: "Fields";
+                            readonly agentReachable: true;
+                        };
+                        readonly submissions: {
+                            readonly label: "Submissions";
+                            readonly agentReachable: true;
+                        };
+                    };
+                };
+            };
+        }>;
+    };
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/forms/react/index.js

@@ -0,0 +1,35 @@
+import { createElement } from 'react';
+import { bindReact } from '../../core/react/bind-react.js';
+import { formsModule } from '../forms.module.js';
+import { FormsPortsContext, FormsOptionsContext } from './hooks/FormsPorts.hooks.js';
+export { FormsPortsContext, FormsOptionsContext, useFormsPorts } from './hooks/FormsPorts.hooks.js';
+export { useFormsList } from './hooks/use-forms-list.hooks.js';
+export { useFormEditor } from './hooks/use-form-editor.hooks.js';
+/** One scoped module factory; page sections share their draft across route-derived tab changes. */
+export function forms(_required, options = {}) {
+    const react = bindReact({ module: formsModule, views: {
+            list: { page: async () => {
+                    const { FormsList } = await import('./pages/FormsList.js');
+                    return { default: (_props) => createElement(FormsList) };
+                }, tabs: {} },
+            editor: { page: async () => {
+                    const { FormEditor } = await import('./pages/FormEditor.js');
+                    return { default: (props) => {
+                            const formId = props.formId ?? props.params?.formId;
+                            if (typeof formId !== 'string' || !formId)
+                                throw new Error('Forms editor page requires formId');
+                            return createElement(FormEditor, { formId, tab: props.requestedTab === 'submissions' ? 'submissions' : 'fields' });
+                        } };
+                },
+                // The editor owns one persistent draft for both route tabs. Section rendering stays in
+                // that page; mounting an independent tab view would split or reset the draft.
+                tabs: { fields: async () => ({ default: () => null }), submissions: async () => ({ default: () => null }) } },
+        } }, { context: FormsPortsContext });
+    // Options live above lazy pages so a host locale update changes copy without replacing the
+    // page/component identity or discarding its working draft. The factory defaults still apply.
+    function Provider({ admin, children, options: liveOptions = options }) {
+        return createElement(react.Provider, { admin, children: createElement(FormsOptionsContext.Provider, { value: liveOptions }, children) });
+    }
+    return Object.assign({ ...formsModule }, { react: { ...react, Provider } });
+}
+//# sourceMappingURL=index.js.map

package/dist/forms/react/pages/FormEditor.d.ts

@@ -0,0 +1,19 @@
+import { useWiredFormEditor } from "../hooks/use-form-editor.hooks.js";
+export interface FormEditorProps {
+    formId: string;
+    /** Which tab is active, derived from the route by `panels.tsx` (`/forms/:formId` -> `"fields"`,
+     *  `/forms/:formId/submissions` -> `"submissions"`) — ADR-063. Ignored while `isNew`/tabs aren't
+     *  shown. */
+    tab: "fields" | "submissions";
+    /** Dependency injection seam for tests — see `PostsProps.usePostsHook` for the convention. */
+    useFormEditorHook?: typeof useWiredFormEditor;
+}
+/** The name/slug fields, the field-definition table, and the status-toggle/save action row —
+ * shared verbatim between the "new form" view (no tabs) and the
+ * "existing form, Fields tab" view (see `FormEditor`'s own `fieldsBody` comment for why it's one
+ * JSX value rather than two copies). Split into its own top-level component, not just a local
+ * `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 declare function FormEditor({ formId, tab, useFormEditorHook }: FormEditorProps, _optional?: Record<string, never>): import("react").JSX.Element;
+export default FormEditor;
+//# sourceMappingURL=FormEditor.d.ts.map

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

@@ -0,0 +1,40 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { agentHandle } from '@jini-ai/agentic';
+import { useWiredFormEditor } from "../hooks/use-form-editor.hooks.js";
+import { FormEditorFieldsBody } from "../components/FormEditorFieldsBody.js";
+import { FormEditorHeaderText } from "../components/FormEditorHeaderText.js";
+import { FormEditorTabStrip } from "../components/FormEditorTabStrip.js";
+import { FormEditorMainPanel } from "../components/FormEditorMainPanel.js";
+/** The name/slug fields, the field-definition table, and the status-toggle/save action row —
+ * shared verbatim between the "new form" view (no tabs) and the
+ * "existing form, Fields tab" view (see `FormEditor`'s own `fieldsBody` comment for why it's one
+ * JSX value rather than two copies). Split into its own top-level component, not just a local
+ * `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 });
+    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
+    // failed and set `error`, `!error` here goes false and rendering fell through to the full,
+    // empty, live-saveable editor below (audit blocker, exec summary #3: a bogus form id showed
+    // "form definition 'X' was not found" AND a working Save button underneath it). This guard is
+    // safe to add as a second, separate check rather than merging into the one above: it only fires
+    // while `form` is still null, so a load failure has to happen before the form ever loaded —
+    // once `form` is set, it stays set, so a LATER failure (e.g. a failed Save) never re-enters
+    // this branch and never blanks a screen the operator is already editing (same "a later failure
+    // must not erase what already rendered" principle as `Pages.tsx`/`Posts.tsx`'s `error && !data`
+    // guard — see `CollectionEntryEditor.tsx`'s sequential loading → not-found guards for the
+    // reference shape this now matches).
+    if (!isNew && !form && error)
+        return _jsx("div", { className: "notice error", children: error });
+    // Shared between the "new form" (no tabs, always visible) and "existing form, Fields tab"
+    // views — kept as one JSX value instead of two copies so the two paths can't drift.
+    const fieldsBody = (_jsx(FormEditorFieldsBody, { mode: mode, onModeChange: onModeChange, html: html, onHtmlChange: setHtml, onCopyEmbed: copyEmbed, copyFeedback: copyFeedback, name: name, onNameChange: setName, slug: slug, onSlugChange: setSlug, isNew: isNew, fields: fields, existingFieldIds: existingFieldIds, onFieldsChange: setFields, form: form, saving: saving, onStatusToggle: handleStatusToggle, onSave: handleSave, t: t }));
+    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 })] }));
+}
+export default FormEditor;
+//# sourceMappingURL=FormEditor.js.map

package/dist/forms/react/pages/FormsList.d.ts

@@ -0,0 +1,39 @@
+import { useWiredFormsList } from '../hooks/use-forms-list.hooks.js';
+/**
+ * @file Forms list screen (SPEC-010 ui.spec.md §2.1/§3.1) — the `/admin/forms` route.
+ * Mirrors `Menus.tsx`/`Posts.tsx`'s fetch/loading/error/table convention. Layout now follows the
+ * Posts/Media page-primitive pass (`.page`/`.page-header`/`.card`/`.table-scroll`/`.empty-state`,
+ * see `styles.css`) instead of the bare `.editor-header` this screen used before — see
+ * `FormEditor.tsx`'s file comment for the fuller rationale (both screens were audited together).
+ *
+ * Row actions: `Posts.tsx`/`Pages.tsx`'s `RowMenu` pattern, INCLUDING a Delete item (T7a,
+ * 2026-09-21) — `api.ts`'s generic `trash` route (`POST /trash/items`, `type: "form"`) now covers
+ * forms, so there is a server capability to wire. Reached through `RowMenu`'s "Delete" ->
+ * `ConfirmDialog` ("Move to trash?") -> `useFormsList`'s `removeForm`, the same three-step gate
+ * `Posts.tsx`/`Pages.tsx` already use for their own row deletes; see `use-forms-list.hooks.ts`'s own
+ * doc for why a click alone can never delete. What ALSO exists (unchanged by this pass) is
+ * `api.updateForm`'s `status` patch, the exact call `FormEditor.tsx`'s own Disable/Enable button
+ * already makes — surfaced here too so an operator doesn't have to open the editor just to toggle
+ * it. That action stays un-confirmed: `FormEditor.tsx` treats it as reversible either direction (no
+ * confirm step there either), so this list doesn't invent a heavier gate the editor itself doesn't
+ * have. `.btn-warning`'s tone applies only going active -> disabled, same asymmetry as
+ * `FormEditor.tsx`'s "Re-enabling is the safe direction" comment.
+ *
+ * ## Markup only
+ *
+ * State, the load effect, and the `api.*` calls live in `hooks/use-forms-list.hooks.ts`. That hook
+ * was written during the hooks extraction but never wired — this component kept a byte-identical
+ * inline copy of the same logic, so the hook was dead code and this screen was never actually
+ * markup-only. Wired here; the duplicate is gone. The two copies had NOT drifted, so this is a
+ * pure de-duplication with no behaviour change.
+ */
+export interface FormsListProps {
+    /**
+     * Dependency injection seam for tests — see `RedirectsProps.useRedirectsHook` for the
+     * convention. Defaulted to the real hook, so `panels.tsx` passes nothing.
+     */
+    useFormsListHook?: typeof useWiredFormsList;
+}
+export declare function FormsList({ useFormsListHook }?: FormsListProps, _optional?: Record<string, never>): import("react").JSX.Element;
+export default FormsList;
+//# sourceMappingURL=FormsList.d.ts.map