@aglyn/plugins-forms 1.0.0-beta.143

package/src/lib/components/form-submissions-card.component.js

@@ -0,0 +1,104 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ 'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { listConsoleWidgets, pluginDocsHelp } from "@aglyn/aglyn";
+import { useConsoleWidgetSlot } from "@aglyn/aglyn/app-utils/console-widget-slot-context";
+import { CardDisplay } from "@aglyn/shared-ui-jsx";
+import { Button, Stack, Typography } from "@mui/material";
+import { useState } from "react";
+import { FORM_SUBMISSIONS_ZONE } from "./form-zones.js";
+/**
+ * THE SUBMISSIONS TO ONE FORM — behind an ask, not on mount.
+ *
+ * ## Why the reader has to press something
+ *
+ * `formSubmissions` is the collection that grows without bound and the one
+ * the customer is billed on. Every other number on this page is a counter
+ * that rode a write which was happening anyway, so opening a form costs the
+ * form document and its versions and nothing else — a ceiling
+ * `forms-console-read-cost.spec.tsx` asserts in documents.
+ *
+ * A table that mounted its own paged listener would put a page of that
+ * collection on every visit to the surface, including the many visits that
+ * are about renaming a form, checking where its submissions route, or
+ * publishing a version. None of those asked to read anybody's messages. The
+ * ask is one click and it buys a live, paged reader; not asking would buy the
+ * same reader for every visit that did not want it.
+ *
+ * ## Why the reader is a zone, not a table written here
+ *
+ * The reader this page wants already exists: it walks the collection with
+ * `orderBy('createdAt')` and a page window, opens a submission, marks it read,
+ * deletes, replies and shows attribution. A second implementation would be a
+ * second place for the unordered `limit()` defect to come back. It belongs to
+ * the plugin that reads submissions, so this card hosts the
+ * `formSubmissions` zone and that plugin draws its reader there, scoped to
+ * this form. Neither plugin imports the other.
+ *
+ * A workspace with no such plugin loaded has nothing to read them with, and
+ * the card says so rather than offering a button that opens an empty space.
+ */ export function FormSubmissionsCard(props) {
+    const { hostId, formId } = props;
+    const [asked, setAsked] = useState(false);
+    const Zone = useConsoleWidgetSlot();
+    // Read at render, after the shell has loaded its plugins: whether anything
+    // in this workspace registered a reader for one form's submissions.
+    const hasReader = Zone !== null && listConsoleWidgets(FORM_SUBMISSIONS_ZONE.id).length > 0;
+    if (asked && Zone) {
+        return /*#__PURE__*/ _jsx(Zone, {
+            slot: FORM_SUBMISSIONS_ZONE.id,
+            hostId: hostId,
+            formId: formId
+        });
+    }
+    return /*#__PURE__*/ _jsx(CardDisplay, {
+        header: "Submissions to this form",
+        help: pluginDocsHelp('forms', {
+            anchor: '#one-forms-own-page',
+            excerpt: 'The same table the Inbox shows, narrowed to this form, and loaded ' + 'when you ask rather than on every visit to this page.'
+        }),
+        contentGutterX: true,
+        contentGutterY: true,
+        children: /*#__PURE__*/ _jsxs(Stack, {
+            spacing: 2,
+            sx: {
+                alignItems: 'flex-start'
+            },
+            children: [
+                /*#__PURE__*/ _jsx(Typography, {
+                    variant: "body2",
+                    color: "text.secondary",
+                    children: 'The messages this form collected, newest first. Reading them is ' + 'a query over the submissions collection, so it runs when you ' + 'ask rather than on every visit to this page.'
+                }),
+                hasReader ? /*#__PURE__*/ _jsx(Button, {
+                    variant: "outlined",
+                    size: "small",
+                    onClick: ()=>setAsked(true),
+                    children: 'Show submissions'
+                }) : /*#__PURE__*/ _jsx(Typography, {
+                    variant: "body2",
+                    color: "text.secondary",
+                    children: 'Submissions are read in the Inbox, which is switched off for ' + 'this workspace or this site. They are still being collected.'
+                })
+            ]
+        })
+    });
+}
+FormSubmissionsCard.displayName = 'FormSubmissionsCard';
+export default FormSubmissionsCard;
+
+//# sourceMappingURL=form-submissions-card.component.js.map

package/src/lib/components/form-submissions-card.component.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/forms/src/lib/components/form-submissions-card.component.tsx"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n'use client'\n\nimport { listConsoleWidgets, pluginDocsHelp } from '@aglyn/aglyn'\nimport { useConsoleWidgetSlot } from '@aglyn/aglyn/app-utils/console-widget-slot-context'\nimport { CardDisplay } from '@aglyn/shared-ui-jsx'\nimport { Button, Stack, Typography } from '@mui/material'\nimport { useState } from 'react'\nimport { FORM_SUBMISSIONS_ZONE } from './form-zones'\n\nexport interface FormSubmissionsCardProps {\n  hostId: string\n  formId: string\n}\n\n/**\n * THE SUBMISSIONS TO ONE FORM — behind an ask, not on mount.\n *\n * ## Why the reader has to press something\n *\n * `formSubmissions` is the collection that grows without bound and the one\n * the customer is billed on. Every other number on this page is a counter\n * that rode a write which was happening anyway, so opening a form costs the\n * form document and its versions and nothing else — a ceiling\n * `forms-console-read-cost.spec.tsx` asserts in documents.\n *\n * A table that mounted its own paged listener would put a page of that\n * collection on every visit to the surface, including the many visits that\n * are about renaming a form, checking where its submissions route, or\n * publishing a version. None of those asked to read anybody's messages. The\n * ask is one click and it buys a live, paged reader; not asking would buy the\n * same reader for every visit that did not want it.\n *\n * ## Why the reader is a zone, not a table written here\n *\n * The reader this page wants already exists: it walks the collection with\n * `orderBy('createdAt')` and a page window, opens a submission, marks it read,\n * deletes, replies and shows attribution. A second implementation would be a\n * second place for the unordered `limit()` defect to come back. It belongs to\n * the plugin that reads submissions, so this card hosts the\n * `formSubmissions` zone and that plugin draws its reader there, scoped to\n * this form. Neither plugin imports the other.\n *\n * A workspace with no such plugin loaded has nothing to read them with, and\n * the card says so rather than offering a button that opens an empty space.\n */\nexport function FormSubmissionsCard(props: FormSubmissionsCardProps) {\n  const { hostId, formId } = props\n  const [asked, setAsked] = useState(false)\n  const Zone = useConsoleWidgetSlot()\n  // Read at render, after the shell has loaded its plugins: whether anything\n  // in this workspace registered a reader for one form's submissions.\n  const hasReader =\n    Zone !== null && listConsoleWidgets(FORM_SUBMISSIONS_ZONE.id).length > 0\n\n  if (asked && Zone) {\n    return (\n      <Zone slot={FORM_SUBMISSIONS_ZONE.id} hostId={hostId} formId={formId} />\n    )\n  }\n\n  return (\n    <CardDisplay\n      header=\"Submissions to this form\"\n      help={pluginDocsHelp('forms', {\n        anchor: '#one-forms-own-page',\n        excerpt:\n          'The same table the Inbox shows, narrowed to this form, and loaded ' +\n          'when you ask rather than on every visit to this page.',\n      })}\n      contentGutterX\n      contentGutterY\n    >\n      <Stack spacing={2} sx={{ alignItems: 'flex-start' }}>\n        <Typography variant=\"body2\" color=\"text.secondary\">\n          {'The messages this form collected, newest first. Reading them is ' +\n            'a query over the submissions collection, so it runs when you ' +\n            'ask rather than on every visit to this page.'}\n        </Typography>\n        {hasReader ? (\n          <Button variant=\"outlined\" size=\"small\" onClick={() => setAsked(true)}>\n            {'Show submissions'}\n          </Button>\n        ) : (\n          <Typography variant=\"body2\" color=\"text.secondary\">\n            {'Submissions are read in the Inbox, which is switched off for ' +\n              'this workspace or this site. They are still being collected.'}\n          </Typography>\n        )}\n      </Stack>\n    </CardDisplay>\n  )\n}\nFormSubmissionsCard.displayName = 'FormSubmissionsCard'\n\nexport default FormSubmissionsCard\n"],"names":["listConsoleWidgets","pluginDocsHelp","useConsoleWidgetSlot","CardDisplay","Button","Stack","Typography","useState","FORM_SUBMISSIONS_ZONE","FormSubmissionsCard","props","hostId","formId","asked","setAsked","Zone","hasReader","id","length","slot","header","help","anchor","excerpt","contentGutterX","contentGutterY","spacing","sx","alignItems","variant","color","size","onClick","displayName"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD;;AAEA,SAASA,kBAAkB,EAAEC,cAAc,QAAQ,eAAc;AACjE,SAASC,oBAAoB,QAAQ,qDAAoD;AACzF,SAASC,WAAW,QAAQ,uBAAsB;AAClD,SAASC,MAAM,EAAEC,KAAK,EAAEC,UAAU,QAAQ,gBAAe;AACzD,SAASC,QAAQ,QAAQ,QAAO;AAChC,SAASC,qBAAqB,QAAQ,kBAAc;AAOpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8BC,GACD,OAAO,SAASC,oBAAoBC,KAA+B;IACjE,MAAM,EAAEC,MAAM,EAAEC,MAAM,EAAE,GAAGF;IAC3B,MAAM,CAACG,OAAOC,SAAS,GAAGP,SAAS;IACnC,MAAMQ,OAAOb;IACb,2EAA2E;IAC3E,oEAAoE;IACpE,MAAMc,YACJD,SAAS,QAAQf,mBAAmBQ,sBAAsBS,EAAE,EAAEC,MAAM,GAAG;IAEzE,IAAIL,SAASE,MAAM;QACjB,qBACE,KAACA;YAAKI,MAAMX,sBAAsBS,EAAE;YAAEN,QAAQA;YAAQC,QAAQA;;IAElE;IAEA,qBACE,KAACT;QACCiB,QAAO;QACPC,MAAMpB,eAAe,SAAS;YAC5BqB,QAAQ;YACRC,SACE,uEACA;QACJ;QACAC,cAAc;QACdC,cAAc;kBAEd,cAAA,MAACpB;YAAMqB,SAAS;YAAGC,IAAI;gBAAEC,YAAY;YAAa;;8BAChD,KAACtB;oBAAWuB,SAAQ;oBAAQC,OAAM;8BAC/B,qEACC,kEACA;;gBAEHd,0BACC,KAACZ;oBAAOyB,SAAQ;oBAAWE,MAAK;oBAAQC,SAAS,IAAMlB,SAAS;8BAC7D;mCAGH,KAACR;oBAAWuB,SAAQ;oBAAQC,OAAM;8BAC/B,kEACC;;;;;AAMd;AACArB,oBAAoBwB,WAAW,GAAG;AAElC,eAAexB,oBAAmB"}

package/src/lib/components/form-zones.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { FormFieldDecl } from '@aglyn/aglyn';
+/**
+ * What the forms plugin hands a widget that reads ONE form's submissions.
+ *
+ * The forms plugin owns the form and the page it is read on; it does not own
+ * the reader. Reading submissions — the paged, ordered walk, the read marks,
+ * the replies, the attribution — is what a plugin like the Inbox is for, and
+ * this zone is where one draws it, scoped to this form, without the forms
+ * plugin importing it.
+ */
+export interface FormSubmissionsZoneProps {
+    hostId: string;
+    formId: string;
+}
+export declare const FORM_SUBMISSIONS_ZONE: import("@aglyn/aglyn/plugin-manager/plugin-zones").PluginZone<FormSubmissionsZoneProps>;
+/**
+ * Where each of a form's fields saves on the person, decided by whichever
+ * plugin keeps people.
+ *
+ * A form declares its fields; what a contact's fields are is another plugin's
+ * to know. This zone sits on the form's page beside routing and the consent
+ * field and hands that plugin the published declaration. A widget here decides
+ * what the declaration should become and calls `saveFields`; the page does the
+ * write, because the form document is this plugin's.
+ */
+export interface FormContactFieldsZoneProps {
+    hostId: string;
+    formId: string;
+    /** The PUBLISHED declaration, as stored on the form document. */
+    fields: readonly FormFieldDecl[];
+    /** True while the form document is still being read. */
+    loading?: boolean;
+    /** Writes the declaration back onto the form document. */
+    saveFields: (fields: FormFieldDecl[]) => Promise<void>;
+}
+export declare const FORM_CONTACT_FIELDS_ZONE: import("@aglyn/aglyn/plugin-manager/plugin-zones").PluginZone<FormContactFieldsZoneProps>;

package/src/lib/components/form-zones.js

@@ -0,0 +1,20 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { definePluginZone } from "@aglyn/aglyn/plugin-manager/plugin-zones";
+export const FORM_SUBMISSIONS_ZONE = definePluginZone('formSubmissions');
+export const FORM_CONTACT_FIELDS_ZONE = definePluginZone('formContactFields');
+
+//# sourceMappingURL=form-zones.js.map

package/src/lib/components/form-zones.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/forms/src/lib/components/form-zones.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { FormFieldDecl } from '@aglyn/aglyn'\nimport { definePluginZone } from '@aglyn/aglyn/plugin-manager/plugin-zones'\n\n/**\n * What the forms plugin hands a widget that reads ONE form's submissions.\n *\n * The forms plugin owns the form and the page it is read on; it does not own\n * the reader. Reading submissions — the paged, ordered walk, the read marks,\n * the replies, the attribution — is what a plugin like the Inbox is for, and\n * this zone is where one draws it, scoped to this form, without the forms\n * plugin importing it.\n */\nexport interface FormSubmissionsZoneProps {\n  hostId: string\n  formId: string\n}\n\nexport const FORM_SUBMISSIONS_ZONE =\n  definePluginZone<FormSubmissionsZoneProps>('formSubmissions')\n\n/**\n * Where each of a form's fields saves on the person, decided by whichever\n * plugin keeps people.\n *\n * A form declares its fields; what a contact's fields are is another plugin's\n * to know. This zone sits on the form's page beside routing and the consent\n * field and hands that plugin the published declaration. A widget here decides\n * what the declaration should become and calls `saveFields`; the page does the\n * write, because the form document is this plugin's.\n */\nexport interface FormContactFieldsZoneProps {\n  hostId: string\n  formId: string\n  /** The PUBLISHED declaration, as stored on the form document. */\n  fields: readonly FormFieldDecl[]\n  /** True while the form document is still being read. */\n  loading?: boolean\n  /** Writes the declaration back onto the form document. */\n  saveFields: (fields: FormFieldDecl[]) => Promise<void>\n}\n\nexport const FORM_CONTACT_FIELDS_ZONE =\n  definePluginZone<FormContactFieldsZoneProps>('formContactFields')\n"],"names":["definePluginZone","FORM_SUBMISSIONS_ZONE","FORM_CONTACT_FIELDS_ZONE"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAGD,SAASA,gBAAgB,QAAQ,2CAA0C;AAgB3E,OAAO,MAAMC,wBACXD,iBAA2C,mBAAkB;AAuB/D,OAAO,MAAME,2BACXF,iBAA6C,qBAAoB"}

package/src/lib/components/form.d.ts

@@ -0,0 +1,186 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import * as Aglyn from '@aglyn/aglyn';
+export declare const FORM_ID: Aglyn.ComponentId;
+export declare const FORM_FIELD_ID: Aglyn.ComponentId;
+/** After-submit outcomes (AGL-557); message is the historical default. */
+export type FormAfterSubmit = 'message' | 'redirect' | 'reveal';
+export interface FormProps {
+    /**
+     * The form entity this node submits as (`docs/specs/reusable-forms.md` §2c).
+     *
+     * THE identity. `formName` below is a caption and always was: it is copied
+     * onto each submission at write time and reconciled with nothing, so
+     * renaming a form split its history in two and two pages sharing a label
+     * were one list. An id survives both.
+     *
+     * This is the whole binding. Reuse across pages needs nothing further —
+     * promote the bound subtree once and the id travels inside the definition,
+     * so every instance writes the same form's submissions without the author
+     * retyping a label. Two instances of one definition are ONE form, which is
+     * the point; an author who wants two forms makes two forms.
+     */
+    formId?: string;
+    /** Identifies the form in the submissions inbox. */
+    formName?: string;
+    /**
+     * Dataset (by id) submissions also append into (AGL-556); the inbox
+     * copy is always written. Renaming the dataset never breaks the binding.
+     */
+    datasetId?: string;
+    /**
+     * Legacy dataset-by-name binding (AGL-141), honored when no `datasetId`
+     * is set; kept so persisted nodes keep working.
+     */
+    datasetName?: string;
+    /**
+     * The dataset binding above, signed by the compose that rendered this form
+     * (AGL-2773). The submit route writes a record only where this says, so the
+     * page, not the request, decides which dataset a submission reaches. Present
+     * on the published site only; the canvas and Preview never submit.
+     */
+    datasetBindingToken?: string;
+    submitLabel?: string;
+    successMessage?: string;
+    /**
+     * What a successful submit does (AGL-557): show the success message
+     * (default), redirect the visitor, or reveal a hidden element.
+     */
+    afterSubmit?: FormAfterSubmit;
+    /** Redirect target screen — rename-safe id, resolved like ScreenLink. */
+    redirectScreenId?: string;
+    /**
+     * Manual redirect target used when no screen is picked: a same-site
+     * `/path` or an absolute https URL (everything else is dropped).
+     */
+    redirectUrl?: string;
+    /** Node revealed on submit; hidden until then (afterSubmit=reveal). */
+    revealNodeId?: string;
+    children?: React.ReactNode;
+}
+/**
+ * Hidden-input prefix a FormField uses to publish its field → dataset
+ * schema-field mapping to the enclosing Form (AGL-556). Rides the DOM so
+ * arbitrary nesting between Form and field needs no React context; the
+ * `__` prefix keeps it out of the submitted fields.
+ */
+export declare const FIELD_MAP_INPUT_PREFIX = "__map__";
+/**
+ * Redirect targets are restricted to same-origin paths (`/thanks`) and
+ * absolute https URLs (AGL-557): stored props reach every visitor's
+ * browser, so `javascript:`/`data:` URLs — and protocol-relative
+ * `//host` forms, which keep the scheme but swap the host — never pass.
+ *
+ * The relative branch asks {@link isSameOriginPath} rather than reading the
+ * string's first two characters (AGL-1881). This site never got the AGL-2486
+ * backslash fix, and the character list would not have been enough anyway:
+ * the URL parser deletes tab/LF/CR before parsing, so `/<TAB>/evil.com`
+ * carries neither `//` nor `\` and `window.location.assign` — which
+ * `formNavigation` below calls — still lands the visitor on `evil.com`. The
+ * absolute branch is unchanged: an explicit `https://` target is a documented
+ * feature, and for absolute input the parser's verdict was never in doubt.
+ */
+export declare const sanitizeRedirectUrl: (url?: string) => string | undefined;
+/**
+ * Where a redirect outcome sends the visitor: the picked screen's
+ * resolved href wins; the manual URL is the fallback, sanitized above.
+ * Undefined (deleted screen, bad URL) degrades to the message outcome.
+ */
+export declare const resolveRedirectTarget: (screenHref: string | undefined, redirectUrl: string | undefined) => string | undefined;
+/**
+ * Navigation seam for the redirect outcome: jsdom's `window.location`
+ * is not patchable, so tests stub this indirection instead.
+ */
+export declare const formNavigation: {
+    assign: (url: string) => void;
+};
+/** DOM event dispatched on every successful submit (AGL-557). */
+export declare const FORM_SUBMITTED_EVENT = "aglyn:form-submitted";
+/**
+ * Report that a bound form was seen, or typed into.
+ *
+ * Fire-and-forget, and deliberately the same instrument the overlay counters
+ * use: `sendBeacon` hands the request to the browser, which delivers it
+ * outside the page's lifetime, so nothing here can delay a render or survive
+ * long enough to fail visibly.
+ *
+ * Requires a bound `formId`. An unbound form has no document to count on, and
+ * an id is never invented: the collector's `update` would find nothing, which
+ * is the right outcome but a pointless request.
+ */
+export declare function sendFormBeacon(hostId: string | undefined, formId: string | undefined, event: 'view' | 'start'): void;
+/**
+ * Lead-capture form (AGL-76): collects its field children's values and
+ * posts them to the tenant's `/api/forms/submit` with the site's host id
+ * from SiteContext. Without a site context (besigner canvas, preview) the
+ * submit is inert, so editing never creates submissions. Includes a
+ * honeypot input for naive bots.
+ */
+declare const Form: import("react").ForwardRefExoticComponent<FormProps & import("react").RefAttributes<HTMLFormElement>>;
+export interface FormFieldProps {
+    /** Submission key; also the input's name attribute. */
+    fieldName?: string;
+    /**
+     * Stable model fieldId of the parent form's dataset this value is
+     * stored under (AGL-556). When unset, values match dataset fields by
+     * name — the legacy behavior.
+     */
+    datasetFieldId?: string;
+    label?: string;
+    /**
+     * Grey hint shown inside the empty input (AGL-1330) — the frames pair a
+     * label above the control with a placeholder inside it. A placeholder is
+     * NOT a label: it disappears the moment the visitor types, so the label
+     * stays the field's accessible name and is never replaced by this.
+     * Ignored by radio, checkbox, and rating fields, which have no text input
+     * to hint inside of.
+     */
+    placeholder?: string;
+    fieldType?: 'text' | 'email' | 'textarea' | 'select' | 'radio' | 'checkbox' | 'rating';
+    /**
+     * Choice list for select/radio/checkbox fields (AGL-544): newline- or
+     * comma-separated. Ignored by the other types.
+     */
+    options?: string;
+    required?: boolean;
+}
+/**
+ * Splits a newline- or comma-separated choice list into trimmed,
+ * non-empty entries (AGL-544).
+ */
+export declare const parseFieldOptions: (options?: string) => string[];
+/**
+ * Single input inside a Form (AGL-76). Survey field types — select,
+ * radio, checkbox group, and star rating — are AGL-544.
+ */
+declare const FormField: import("react").ForwardRefExoticComponent<FormFieldProps & import("react").RefAttributes<HTMLDivElement>>;
+export declare const formSchema: Aglyn.ComponentSchema<FormProps>;
+export declare const formFieldSchema: Aglyn.ComponentSchema<FormFieldProps>;
+export declare const formPresets: Aglyn.PresetSchema[];
+/**
+ * The composed section a form usually arrives inside.
+ *
+ * It lives here rather than with the generic block library because it PLACES
+ * form nodes, and a preset's `data` carries the `pluginId` those nodes are
+ * saved with — so authoring it anywhere else stamps every contact form on
+ * every new site with the wrong bundle. The heading and the stack around it
+ * name `mui`, which is correct: they ARE mui elements, and a page holding this
+ * section needs both bundles registered before it paints.
+ */
+export declare const formBlockPresets: Aglyn.PresetSchema[];
+export { Form, FormField };
+export default Form;