@jini-ai/admin 0.4.2 → 0.4.4

package/dist/forms/forms.module.d.ts

@@ -0,0 +1,138 @@
+export declare const formsModule: {
+    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=forms.module.d.ts.map

package/dist/forms/forms.module.js

@@ -0,0 +1,17 @@
+import { defineAdminModule } from '../core/module/define-admin-module.js';
+import { formsApiToken, formsTrashToken, formsEventsToken, formsNavigationToken } from './ports.js';
+import { formsMessagesEn } from './messages.en.js';
+export const formsModule = defineAdminModule({
+    id: 'forms',
+    requires: { formsApi: formsApiToken, formsTrash: formsTrashToken },
+    optional: { formsEvents: formsEventsToken, formsNavigation: formsNavigationToken },
+    messages: formsMessagesEn,
+    pages: {
+        list: { path: '/forms', label: 'Forms', permissions: ['admin.forms.manage'], agentReachable: true, nav: { group: 'content', icon: 'forms' }, tabs: {} },
+        editor: { path: '/forms/:formId', label: 'Form', permissions: ['admin.forms.manage'], agentReachable: true, tabs: {
+                fields: { label: 'Fields', agentReachable: true },
+                submissions: { label: 'Submissions', agentReachable: true },
+            } },
+    },
+});
+//# sourceMappingURL=forms.module.js.map

package/dist/forms/html-rules.d.ts

@@ -0,0 +1,34 @@
+import type { AdminFormField, AdminFormSubmission } from "./models.js";
+export interface FormAnswerColumn {
+    key: string;
+    header: string;
+    cell: (submission: AdminFormSubmission) => string;
+}
+/** Persisted descriptors, including those derived from HTML, are the submission table's columns. */
+export declare function formAnswerColumns({ fields }: {
+    fields: readonly AdminFormField[];
+}, _optional?: {}): FormAnswerColumn[];
+/** Detail rows reuse the table's persisted field labels, including HTML-derived descriptors.
+ * Removed fields retain their answers with a plain fallback instead of exposing their IDs.
+ * @complexity O(c + a) time and space for c columns and a submitted answers; no I/O.
+ */
+export declare function formSubmissionRows({ data, answerColumns }: {
+    data: AdminFormSubmission['data'];
+    answerColumns: readonly FormAnswerColumn[];
+}, { unknownFieldLabel }?: {
+    unknownFieldLabel?: string;
+}): Array<{
+    key: string;
+    label: string;
+    value: string;
+}>;
+/** Editable form BODY only: the server supplies the transport and spam-protection wrapper. */
+export declare function formHtmlStarter({ fields }: {
+    fields: readonly AdminFormField[];
+}, { submitLabel }?: {
+    submitLabel?: string;
+}): string;
+export declare function formHtmlEmbed({ slug }: {
+    slug: string;
+}, _optional?: {}): string;
+//# sourceMappingURL=html-rules.d.ts.map

package/dist/forms/html-rules.js

@@ -0,0 +1,34 @@
+/** Persisted descriptors, including those derived from HTML, are the submission table's columns. */
+export function formAnswerColumns({ fields }, _optional = {}) {
+    return fields.map((field) => ({
+        key: `answer:${field.id}`,
+        header: field.label,
+        cell: (submission) => submission.data[field.id] === undefined ? "" : String(submission.data[field.id]),
+    }));
+}
+/** Detail rows reuse the table's persisted field labels, including HTML-derived descriptors.
+ * Removed fields retain their answers with a plain fallback instead of exposing their IDs.
+ * @complexity O(c + a) time and space for c columns and a submitted answers; no I/O.
+ */
+export function formSubmissionRows({ data, answerColumns }, { unknownFieldLabel = "Unknown field" } = {}) {
+    const labels = new Map(answerColumns.map(column => [column.key, column.header]));
+    return Object.entries(data).map(([key, value]) => ({
+        key, label: labels.get(`answer:${key}`)?.trim() || unknownFieldLabel, value: String(value),
+    }));
+}
+function escapeHtml(value) {
+    return value.replace(/[&<>"']/g, (char) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&#39;" })[char]);
+}
+/** Editable form BODY only: the server supplies the transport and spam-protection wrapper. */
+export function formHtmlStarter({ fields }, { submitLabel = "Send" } = {}) {
+    return fields.map((field) => {
+        const attrs = `name="${escapeHtml(field.id)}"${field.required ? " required" : ""}${field.maxLength != null ? ` maxlength="${field.maxLength}"` : ""}`;
+        const control = field.type === "textarea" ? `<textarea ${attrs}></textarea>` : `<input type="${field.type}" ${attrs}>`;
+        return `<label>${escapeHtml(field.label)}\n  ${control}\n</label>`;
+    }).join("\n\n") + `\n\n<button type="submit">${escapeHtml(submitLabel)}</button>`;
+}
+export function formHtmlEmbed({ slug }, _optional = {}) {
+    const config = JSON.stringify({ type: "form", id: slug, mode: "html" }).replace(/'/g, "&#39;");
+    return `<div data-embed-config='${config}'></div>`;
+}
+//# sourceMappingURL=html-rules.js.map

package/dist/forms/index.d.ts

@@ -0,0 +1,14 @@
+export { formsModule } from './forms.module.js';
+export { formsApiToken, formsTrashToken, formsEventsToken, formsNavigationToken } from './ports.js';
+export type { AdminFormsPort, FormsTrashPort, FormsEventsPort, FormsNavigationPort } from './ports.js';
+export type { AdminFormDefinition, AdminFormField, AdminFormNotify, AdminFormSubmission, FormsTranslator } from './models.js';
+export { formsMessagesEn, translateForms } from './messages.en.js';
+export * from './rules.js';
+export * from './html-rules.js';
+export { createFormsListController } from './controllers/forms-list.controller.js';
+export { createFormEditorController } from './controllers/form-editor.controller.js';
+export { createFormFieldsEditorController } from './controllers/form-fields-editor.controller.js';
+export { createFieldAttributesDialogController } from './controllers/field-attributes-dialog.controller.js';
+export { createFormSubmissionsController } from './controllers/form-submissions.controller.js';
+export { createFormSubmissionDetailController } from './controllers/form-submission-detail.controller.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/forms/index.js

@@ -0,0 +1,12 @@
+export { formsModule } from './forms.module.js';
+export { formsApiToken, formsTrashToken, formsEventsToken, formsNavigationToken } from './ports.js';
+export { formsMessagesEn, translateForms } from './messages.en.js';
+export * from './rules.js';
+export * from './html-rules.js';
+export { createFormsListController } from './controllers/forms-list.controller.js';
+export { createFormEditorController } from './controllers/form-editor.controller.js';
+export { createFormFieldsEditorController } from './controllers/form-fields-editor.controller.js';
+export { createFieldAttributesDialogController } from './controllers/field-attributes-dialog.controller.js';
+export { createFormSubmissionsController } from './controllers/form-submissions.controller.js';
+export { createFormSubmissionDetailController } from './controllers/form-submission-detail.controller.js';
+//# sourceMappingURL=index.js.map

package/dist/forms/messages.en.d.ts

@@ -0,0 +1,101 @@
+import type { FormsTranslator } from "./models.js";
+export declare const formsMessagesEn: {
+    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";
+};
+/** Host translators may replace any key; the default preserves the original English bytes. */
+export declare const translateForms: FormsTranslator;
+//# sourceMappingURL=messages.en.d.ts.map

package/dist/forms/messages.en.js

@@ -0,0 +1,105 @@
+export const formsMessagesEn = {
+    "Created / Updated": "Created / Updated",
+    "Created {created} · Updated {updated}": "Created {created} · Updated {updated}",
+    "Created {date}": "Created {date}",
+    "Updated {date}": "Updated {date}",
+    "Builder": "Builder",
+    "HTML": "HTML",
+    "Form authoring mode": "Form authoring mode",
+    "Form HTML": "Form HTML",
+    "Copy HTML embed": "Copy HTML embed",
+    "Copied!": "Copied!",
+    "Could not copy embed": "Could not copy embed",
+    "Send": "Send",
+    "Back": "Back",
+    "Content": "Content",
+    "Forms": "Forms",
+    "Manage the forms embedded across the site and their submissions.": "Manage the forms embedded across the site and their submissions.",
+    "New form": "New form",
+    "No forms yet.": "No forms yet.",
+    "Create your first form to start collecting submissions.": "Create your first form to start collecting submissions.",
+    "Name": "Name",
+    "Slug": "Slug",
+    "Status": "Status",
+    "Fields": "Fields",
+    "Notify": "Notify",
+    "More": "More",
+    "off": "off",
+    "Edit": "Edit",
+    "Disable": "Disable",
+    "Enable": "Enable",
+    "Move to trash?": "Move to trash?",
+    "Move to trash": "Move to trash",
+    "Move": "Move",
+    "to trash? It will disappear from the site and from this list.": "to trash? It will disappear from the site and from this list.",
+    "Field attributes —": "Field attributes —",
+    "CSS classes": "CSS classes",
+    "HTML attributes": "HTML attributes",
+    "Value": "Value",
+    "Remove": "Remove",
+    "Add attribute": "Add attribute",
+    "Save": "Save",
+    "Cancel": "Cancel",
+    "ID": "ID",
+    "Label": "Label",
+    "Type": "Type",
+    "Req": "Req",
+    "Max length": "Max length",
+    "Add field": "Add field",
+    "Back to submissions": "Back to submissions",
+    "Submitted at": "Submitted at",
+    "Source IP": "Source IP",
+    "Delete submission": "Delete submission",
+    "Confirm delete": "Confirm delete",
+    "Delete permanently?": "Delete permanently?",
+    "This cannot be undone.": "This cannot be undone.",
+    "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.",
+    "View": "View",
+    "Load more": "Load more",
+    "Loading…": "Loading…",
+    "No submissions yet.": "No submissions yet.",
+    "Create form": "Create form",
+    "Form": "Form",
+    "Configure a new form's fields.": "Configure a new form's fields.",
+    "Configure this form's fields, or review its submissions.": "Configure this form's fields, or review its submissions.",
+    "Submissions": "Submissions",
+    "Back to forms": "Back to forms",
+    "Actions for form \"{name}\"": "Actions for form \"{name}\"",
+    "Loading forms…": "Loading forms…",
+    "Delete": "Delete",
+    "See more about field attributes": "See more about field attributes",
+    "Add CSS classes and HTML attributes to this field’s input. Classes are unrestricted — Tailwind utility classes like ": "Add CSS classes and HTML attributes to this field’s input. Classes are unrestricted — Tailwind utility classes like ",
+    "or ": "or ",
+    " work as expected. Attribute names are limited to a safe allowlist (": " work as expected. Attribute names are limited to a safe allowlist (",
+    ", ": ", ",
+    ", and a fixed list of layout/behavior attributes) — anything else, including event handlers like ": ", and a fixed list of layout/behavior attributes) — anything else, including event handlers like ",
+    ", is rejected.": ", is rejected.",
+    "Attribute": "Attribute",
+    "e.g. Enter your work email": "e.g. Enter your work email",
+    "Existing fields cannot be removed once created": "Existing fields cannot be removed once created",
+    "Loading submission…": "Loading submission…",
+    "Loading submissions…": "Loading submissions…",
+    "Form sections": "Form sections",
+    "Loading form…": "Loading form…",
+    "failed to delete form": "failed to delete form",
+    "This item changed since you loaded it. Reload and try again.": "This item changed since you loaded it. Reload and try again.",
+    "failed to update form status": "failed to update form status",
+    "failed to load forms": "failed to load forms",
+    "save failed": "save failed",
+    "status update failed": "status update failed",
+    "failed to load form": "failed to load form",
+    "recipient": "recipient",
+    "recipients": "recipients",
+    "failed to load submissions": "failed to load submissions",
+    "failed to load submission": "failed to load submission",
+    "delete failed": "delete failed",
+    "Unknown field": "Unknown field",
+};
+/** Host translators may replace any key; the default preserves the original English bytes. */
+export const translateForms = (key, vars = {}) => {
+    let text = formsMessagesEn[key] ?? key;
+    for (const [name, value] of Object.entries(vars))
+        text = text.replaceAll(`{${name}}`, String(value));
+    return text;
+};
+//# sourceMappingURL=messages.en.js.map

package/dist/forms/models.d.ts

@@ -0,0 +1,29 @@
+import type { AdminFormDefinition as Definition, AdminFormField as Field, AdminFormSubmission as Submission } from '../core/ports/forms.js';
+/** Mutable editor drafts project the core contract; they never define another API. */
+export type AdminFormField = {
+    -readonly [K in keyof Field]: Field[K];
+} & {
+    attributes?: Record<string, string> | undefined;
+};
+export type AdminFormNotify = {
+    enabled: boolean;
+    recipients: string[];
+};
+export type AdminFormDefinition = Omit<Definition, 'fields' | 'notify'> & {
+    workspaceId?: string;
+    fields: AdminFormField[];
+    notify: AdminFormNotify;
+};
+export type AdminFormSubmission = Omit<Submission, 'data'> & {
+    workspaceId?: string;
+    data: Record<string, string | boolean>;
+};
+export type FormsTranslator = (key: string, vars?: Record<string, string | number>) => string;
+/** Copy drafts at the API boundary so editing cannot mutate a repository/cache snapshot. */
+export declare function formView({ form }: {
+    form: Definition;
+}, _optional?: {}): AdminFormDefinition;
+export declare function submissionView({ submission }: {
+    submission: Submission;
+}, _optional?: {}): AdminFormSubmission;
+//# sourceMappingURL=models.d.ts.map

package/dist/forms/models.js

@@ -0,0 +1,8 @@
+/** Copy drafts at the API boundary so editing cannot mutate a repository/cache snapshot. */
+export function formView({ form }, _optional = {}) {
+    return { ...form, fields: form.fields.map(field => ({ ...field, ...(field.attributes ? { attributes: { ...field.attributes } } : {}) })), notify: { ...form.notify, recipients: [...form.notify.recipients] } };
+}
+export function submissionView({ submission }, _optional = {}) {
+    return { ...submission, data: { ...submission.data } };
+}
+//# sourceMappingURL=models.js.map

package/dist/forms/ports.d.ts

@@ -0,0 +1,26 @@
+import type { AdminFormsPort } from '../core/ports/forms.js';
+import type { AdminShellNavigationPort } from '../core/ports/shell.js';
+export type { AdminFormsPort } from '../core/ports/forms.js';
+/** Reversible removal delegates to the host's existing generic Trash service.
+ * This projection preserves the screens' generic POST for definitions and submissions; the
+ * core API also exposes the form-scoped submission DELETE route with the same Trash semantics. */
+export interface FormsTrashPort {
+    trash(required: {
+        type: 'form' | 'form_submission';
+        id: string;
+    }, optional?: Record<string, never>): Promise<{
+        ok: true;
+        version: number | null;
+    }>;
+}
+export interface FormsEventsPort {
+    subscribe(required: {
+        onRefresh: () => void;
+    }, optional?: Record<string, never>): () => void;
+}
+export type FormsNavigationPort = Pick<AdminShellNavigationPort, 'navigate'>;
+export declare const formsApiToken: import("../core/module/token.js").AdminPortToken<AdminFormsPort, "admin.forms.api">;
+export declare const formsTrashToken: import("../core/module/token.js").AdminPortToken<FormsTrashPort, "admin.forms.trash">;
+export declare const formsEventsToken: import("../core/module/token.js").AdminPortToken<FormsEventsPort, "admin.forms.events">;
+export declare const formsNavigationToken: import("../core/module/token.js").AdminPortToken<FormsNavigationPort, "admin.forms.navigation">;
+//# sourceMappingURL=ports.d.ts.map

package/dist/forms/ports.js

@@ -0,0 +1,6 @@
+import { adminPort } from '../core/module/token.js';
+export const formsApiToken = adminPort({ id: 'admin.forms.api' });
+export const formsTrashToken = adminPort({ id: 'admin.forms.trash' });
+export const formsEventsToken = adminPort({ id: 'admin.forms.events' });
+export const formsNavigationToken = adminPort({ id: 'admin.forms.navigation' });
+//# sourceMappingURL=ports.js.map

package/dist/forms/react/components/FieldAttributesDialog.d.ts

@@ -0,0 +1,14 @@
+import type { AdminFormField } from '../../models.js';
+import { useFieldAttributesDialog } from '../hooks/use-field-attributes-dialog.hooks.js';
+export interface FieldAttributesDialogProps {
+    field: AdminFormField;
+    fieldIndex: number;
+    onSave: (patch: Partial<AdminFormField>) => void;
+    onCancel: () => void;
+    /** Dependency injection seam for tests — see `PostsProps.usePostsHook` for the convention. */
+    useFieldAttributesDialogHook?: typeof useFieldAttributesDialog;
+    /** Translator closure — see `FormEditor()`'s own `t`. */
+    t: (key: string) => string;
+}
+export declare function FieldAttributesDialog({ field, fieldIndex, onSave, onCancel, useFieldAttributesDialogHook, t, }: FieldAttributesDialogProps, _optional?: Record<string, never>): import("react").JSX.Element;
+//# sourceMappingURL=FieldAttributesDialog.d.ts.map

package/dist/forms/react/components/FieldAttributesDialog.js

@@ -0,0 +1,47 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useFieldAttributesView } from "../hooks/forms-view.hooks.js";
+import { Dialog } from '@jini-ai/ui-kit/react';
+import { SeeMore } from '@jini-ai/ui/admin-widgets';
+import { agentHandle } from '@jini-ai/agentic';
+import { ATTRIBUTE_NAME_SUGGESTIONS } from '../../rules.js';
+import { useFieldAttributesDialog } from '../hooks/use-field-attributes-dialog.hooks.js';
+export function FieldAttributesDialog({ field, fieldIndex, onSave, onCancel, useFieldAttributesDialogHook = useFieldAttributesDialog, t, }, _optional = {}) {
+    const controller = useFieldAttributesDialogHook({
+        field,
+        onSave,
+        onCancel,
+    });
+    // One dialog is ever open at a time (`editingAttrsIndex` gates a single instance below), so this
+    // needs no per-instance disambiguation — unlike the attribute rows inside it, which are a real
+    // repeated list and do need `buildAgentListHandles`'s uniqueness search. Not `useMemo`d: `rows` is
+    // one field's own CSS-class/HTML-attribute rows (a handful at most), cheap enough that memoizing
+    // it was not judged worth the added indirection.
+    const { className, addRow, error, submit } = controller;
+    const { rows, displayName, onClose, onClassName } = useFieldAttributesView({ field, fieldIndex, controller, onCancel });
+    return (_jsx(Dialog, { open: true, title: `${t("Field attributes —")} ${displayName}`, onClose: onClose, className: "settings-dialog tovu-domain-dialog field-attrs-dialog", children: _jsxs("form", { onSubmit: submit, ...agentHandle({ handle: "form-field-attrs-dialog" }, {
+                role: "region",
+                label: "Field attributes dialog — CSS classes and HTML attributes for one form field",
+            }), children: [_jsxs(SeeMore, { lines: 2, textClassName: "field-attrs-hint", toggleAriaLabel: t("See more about field attributes"), children: [t("Add CSS classes and HTML attributes to this field’s input. Classes are unrestricted — Tailwind utility classes like "), _jsx("code", { children: "md:col-span-2" }), " ", t("or "), _jsx("code", { children: "w-1/2" }), t(" work as expected. Attribute names are limited to a safe allowlist ("), _jsx("code", { children: "aria-*" }), t(", "), _jsx("code", { children: "data-*" }), t(", and a fixed list of layout/behavior attributes) — anything else, including event handlers like "), _jsx("code", { children: "onclick" }), t(", is rejected.")] }), _jsxs("div", { className: "field", children: [_jsx("label", { className: "field-label", htmlFor: "field-attrs-classname", children: t("CSS classes") }), _jsx("input", { id: "field-attrs-classname", "data-jini-autofocus": "", value: className, placeholder: "e.g. md:col-span-2 w-1/2 focus:ring-2", onChange: onClassName, ...agentHandle({ handle: "form-field-attrs-classname" }, {
+                                role: "field",
+                                label: "CSS classes to add to this form field's input",
+                            }) })] }), _jsxs("div", { className: "field-attrs-rows", children: [_jsx("span", { className: "field-label", children: t("HTML attributes") }), _jsx("datalist", { id: "field-attrs-name-suggestions", children: ATTRIBUTE_NAME_SUGGESTIONS.map((name) => (_jsx("option", { value: name }, name))) }), rows.map((row, index) => (_jsxs("fieldset", { className: "collections-field-row", children: [_jsxs("legend", { children: [t("Attribute"), " ", index + 1] }), _jsxs("div", { className: "field", children: [_jsx("label", { className: "field-label", htmlFor: `field-attrs-name-${row._rowId}`, children: t("Name") }), _jsx("input", { id: `field-attrs-name-${row._rowId}`, list: "field-attrs-name-suggestions", value: row.name, placeholder: "e.g. aria-label", onChange: row.onName, ...agentHandle({ handle: `${row.handle}-name` }, {
+                                                role: "field",
+                                                label: "This attribute's name — must be on the allowlisted set (aria-*, data-*, and a few others)",
+                                            }) })] }), _jsxs("div", { className: "field", children: [_jsx("label", { className: "field-label", htmlFor: `field-attrs-value-${row._rowId}`, children: t("Value") }), _jsx("input", { id: `field-attrs-value-${row._rowId}`, value: row.value, placeholder: t("e.g. Enter your work email"), onChange: row.onValue, ...agentHandle({ handle: `${row.handle}-value` }, {
+                                                role: "field",
+                                                label: "This attribute's value",
+                                            }) })] }), _jsx("button", { type: "button", className: "btn-secondary", onClick: row.onRemove, ...agentHandle({ handle: `${row.handle}-remove` }, {
+                                        role: "button",
+                                        label: "Remove this CSS-class/HTML-attribute row",
+                                    }), children: t("Remove") })] }, row._rowId))), _jsx("button", { type: "button", className: "btn-secondary", onClick: addRow, ...agentHandle({ handle: "form-field-attrs-add-row" }, {
+                                role: "button",
+                                label: "Add another HTML attribute row to this field",
+                            }), children: t("Add attribute") })] }), error ? (_jsx("span", { className: "save-error", role: "alert", children: error })) : null, _jsxs("span", { className: "editor-actions", children: [_jsx("button", { type: "submit", ...agentHandle({ handle: "form-field-attrs-save" }, {
+                                role: "button",
+                                label: "Save this field's CSS classes and HTML attributes",
+                            }), children: t("Save") }), _jsx("button", { type: "button", className: "btn-secondary", onClick: onCancel, ...agentHandle({ handle: "form-field-attrs-cancel" }, {
+                                role: "button",
+                                label: "Close this dialog without saving attribute changes",
+                            }), children: t("Cancel") })] })] }) }));
+}
+//# sourceMappingURL=FieldAttributesDialog.js.map