@aglyn/plugins-forms 1.0.0-beta.143

package/src/lib/components/use-form-promote-api.d.ts

@@ -0,0 +1,48 @@
+import type { FormContractViolation } from '@aglyn/aglyn';
+/**
+ * What the route refused with, or what it did.
+ *
+ * ONE shape rather than a discriminated union: `strictNullChecks` is off in
+ * this repo, so narrowing on an `ok: true | false` discriminant does not
+ * happen and every read of `message` would need a cast. A caller reads
+ * `message` and `violations` only after seeing `ok === false`, and both are
+ * always populated on a refusal — `violations` as an empty array when the
+ * refusal was not about the contract at all (a role denial, a lockdown, a
+ * version with no design).
+ */
+export interface PromoteFormResult {
+    ok: boolean;
+    /**
+     * Author-facing, and stated by the ROUTE. Present on a refusal.
+     */
+    message?: string;
+    /**
+     * The contract violations, verbatim.
+     *
+     * The codes and sentences are `checkFormContract`'s own, so the page renders
+     * exactly what the besigner renders and neither side parses prose.
+     */
+    violations?: FormContractViolation[];
+}
+/** Promote one version of one form, by id — no design crosses the wire. */
+export type PromoteForm = (options: {
+    hostId: string;
+    formId: string;
+    versionId: string;
+}) => Promise<PromoteFormResult>;
+/**
+ * Makes one version of a form the version the site serves.
+ *
+ * Server-side, and never a client `updateDoc`, because promotion is where the
+ * form's contract is enforced: `/api/hosts/forms/promote` re-reads the stored
+ * version, runs `checkFormContract` on the tree it is about to write, and
+ * refuses with a 422 rather than publishing a design whose submissions would
+ * silently stop arriving. A console-side check is advice; that route is the
+ * enforcement, so this hook sends three ids and no design at all.
+ *
+ * Resolves rather than throws on a refusal: a broken contract is an ordinary
+ * outcome an author is expected to see and fix, and the violations are the
+ * payload, not an error message.
+ */
+export declare function useFormPromoteApi(): PromoteForm;
+export default useFormPromoteApi;

package/src/lib/components/use-form-promote-api.js

@@ -0,0 +1,63 @@
+/**
+ * @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 { useUser } from "@aglyn/tenant-feature-instance";
+import { authorizedFetch } from "@aglyn/shared-util-http/authorized-token";
+import { useCallback } from "react";
+/**
+ * Makes one version of a form the version the site serves.
+ *
+ * Server-side, and never a client `updateDoc`, because promotion is where the
+ * form's contract is enforced: `/api/hosts/forms/promote` re-reads the stored
+ * version, runs `checkFormContract` on the tree it is about to write, and
+ * refuses with a 422 rather than publishing a design whose submissions would
+ * silently stop arriving. A console-side check is advice; that route is the
+ * enforcement, so this hook sends three ids and no design at all.
+ *
+ * Resolves rather than throws on a refusal: a broken contract is an ordinary
+ * outcome an author is expected to see and fix, and the violations are the
+ * payload, not an error message.
+ */ export function useFormPromoteApi() {
+    const { data: user } = useUser();
+    return useCallback(async ({ hostId, formId, versionId })=>{
+        var _ref;
+        const response = await authorizedFetch(user, '/api/hosts/forms/promote', {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json'
+            },
+            body: JSON.stringify({
+                hostId,
+                formId,
+                versionId
+            })
+        });
+        const payload = await response.json().catch(()=>({}));
+        if (response.ok) return {
+            ok: true
+        };
+        return {
+            ok: false,
+            message: String((_ref = payload == null ? void 0 : payload.error) != null ? _ref : 'Publish failed'),
+            violations: Array.isArray(payload == null ? void 0 : payload.violations) ? payload.violations : []
+        };
+    }, [
+        user
+    ]);
+}
+export default useFormPromoteApi;
+
+//# sourceMappingURL=use-form-promote-api.js.map

package/src/lib/components/use-form-promote-api.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/forms/src/lib/components/use-form-promote-api.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'use client'\n\nimport type { FormContractViolation } from '@aglyn/aglyn'\nimport { useUser } from '@aglyn/tenant-feature-instance'\nimport { authorizedFetch } from '@aglyn/shared-util-http/authorized-token'\nimport { useCallback } from 'react'\n\n/**\n * What the route refused with, or what it did.\n *\n * ONE shape rather than a discriminated union: `strictNullChecks` is off in\n * this repo, so narrowing on an `ok: true | false` discriminant does not\n * happen and every read of `message` would need a cast. A caller reads\n * `message` and `violations` only after seeing `ok === false`, and both are\n * always populated on a refusal — `violations` as an empty array when the\n * refusal was not about the contract at all (a role denial, a lockdown, a\n * version with no design).\n */\nexport interface PromoteFormResult {\n  ok: boolean\n  /**\n   * Author-facing, and stated by the ROUTE. Present on a refusal.\n   */\n  message?: string\n  /**\n   * The contract violations, verbatim.\n   *\n   * The codes and sentences are `checkFormContract`'s own, so the page renders\n   * exactly what the besigner renders and neither side parses prose.\n   */\n  violations?: FormContractViolation[]\n}\n\n/** Promote one version of one form, by id — no design crosses the wire. */\nexport type PromoteForm = (options: {\n  hostId: string\n  formId: string\n  versionId: string\n}) => Promise<PromoteFormResult>\n\n/**\n * Makes one version of a form the version the site serves.\n *\n * Server-side, and never a client `updateDoc`, because promotion is where the\n * form's contract is enforced: `/api/hosts/forms/promote` re-reads the stored\n * version, runs `checkFormContract` on the tree it is about to write, and\n * refuses with a 422 rather than publishing a design whose submissions would\n * silently stop arriving. A console-side check is advice; that route is the\n * enforcement, so this hook sends three ids and no design at all.\n *\n * Resolves rather than throws on a refusal: a broken contract is an ordinary\n * outcome an author is expected to see and fix, and the violations are the\n * payload, not an error message.\n */\nexport function useFormPromoteApi(): PromoteForm {\n  const { data: user } = useUser()\n  return useCallback<PromoteForm>(\n    async ({ hostId, formId, versionId }) => {\n      const response = await authorizedFetch(user, '/api/hosts/forms/promote', {\n        method: 'POST',\n        headers: { 'Content-Type': 'application/json' },\n        body: JSON.stringify({ hostId, formId, versionId }),\n      })\n      const payload = await response.json().catch(() => ({}))\n      if (response.ok) return { ok: true }\n      return {\n        ok: false,\n        message: String(payload?.error ?? 'Publish failed'),\n        violations: Array.isArray(payload?.violations)\n          ? (payload.violations as FormContractViolation[])\n          : [],\n      }\n    },\n    [user],\n  )\n}\n\nexport default useFormPromoteApi\n"],"names":["useUser","authorizedFetch","useCallback","useFormPromoteApi","data","user","hostId","formId","versionId","response","method","headers","body","JSON","stringify","payload","json","catch","ok","message","String","error","violations","Array","isArray"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD;AAGA,SAASA,OAAO,QAAQ,iCAAgC;AACxD,SAASC,eAAe,QAAQ,2CAA0C;AAC1E,SAASC,WAAW,QAAQ,QAAO;AAmCnC;;;;;;;;;;;;;CAaC,GACD,OAAO,SAASC;IACd,MAAM,EAAEC,MAAMC,IAAI,EAAE,GAAGL;IACvB,OAAOE,YACL,OAAO,EAAEI,MAAM,EAAEC,MAAM,EAAEC,SAAS,EAAE;;QAClC,MAAMC,WAAW,MAAMR,gBAAgBI,MAAM,4BAA4B;YACvEK,QAAQ;YACRC,SAAS;gBAAE,gBAAgB;YAAmB;YAC9CC,MAAMC,KAAKC,SAAS,CAAC;gBAAER;gBAAQC;gBAAQC;YAAU;QACnD;QACA,MAAMO,UAAU,MAAMN,SAASO,IAAI,GAAGC,KAAK,CAAC,IAAO,CAAA,CAAC,CAAA;QACpD,IAAIR,SAASS,EAAE,EAAE,OAAO;YAAEA,IAAI;QAAK;QACnC,OAAO;YACLA,IAAI;YACJC,SAASC,eAAOL,2BAAAA,QAASM,KAAK,mBAAI;YAClCC,YAAYC,MAAMC,OAAO,CAACT,2BAAAA,QAASO,UAAU,IACxCP,QAAQO,UAAU,GACnB,EAAE;QACR;IACF,GACA;QAACjB;KAAK;AAEV;AAEA,eAAeF,kBAAiB"}

package/src/lib/constants/bundle-common.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @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.
+ */
+/**
+ * The bundle id, persisted as `pluginId` on every node this bundle places.
+ *
+ * It is not a label. `requiredSitePlugins` reads `pluginId` off each saved
+ * node to decide which bundles must register before first paint, so this
+ * string is the answer to "which chunk does this page need in front of the
+ * render". A node whose `pluginId` names a bundle that no longer registers
+ * its `componentId` still RESOLVES — resolution is by component id alone —
+ * but it resolves a beat late, after the post-hydration load of the rest of
+ * the enabled set.
+ *
+ * `tools/scripts/backfill-node-plugin-ids.mjs` is what keeps the two in
+ * agreement across a bundle move.
+ */
+export declare const BUNDLE_ID = "forms";

package/src/lib/constants/bundle-common.js

@@ -0,0 +1,31 @@
+/**
+ * @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.
+ */ /**
+ * The bundle id, persisted as `pluginId` on every node this bundle places.
+ *
+ * It is not a label. `requiredSitePlugins` reads `pluginId` off each saved
+ * node to decide which bundles must register before first paint, so this
+ * string is the answer to "which chunk does this page need in front of the
+ * render". A node whose `pluginId` names a bundle that no longer registers
+ * its `componentId` still RESOLVES — resolution is by component id alone —
+ * but it resolves a beat late, after the post-hydration load of the rest of
+ * the enabled set.
+ *
+ * `tools/scripts/backfill-node-plugin-ids.mjs` is what keeps the two in
+ * agreement across a bundle move.
+ */ export const BUNDLE_ID = 'forms';
+
+//# sourceMappingURL=bundle-common.js.map

package/src/lib/constants/bundle-common.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/forms/src/lib/constants/bundle-common.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\n/**\n * The bundle id, persisted as `pluginId` on every node this bundle places.\n *\n * It is not a label. `requiredSitePlugins` reads `pluginId` off each saved\n * node to decide which bundles must register before first paint, so this\n * string is the answer to \"which chunk does this page need in front of the\n * render\". A node whose `pluginId` names a bundle that no longer registers\n * its `componentId` still RESOLVES — resolution is by component id alone —\n * but it resolves a beat late, after the post-hydration load of the rest of\n * the enabled set.\n *\n * `tools/scripts/backfill-node-plugin-ids.mjs` is what keeps the two in\n * agreement across a bundle move.\n */\nexport const BUNDLE_ID = 'forms'\n"],"names":["BUNDLE_ID"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;;;;;CAaC,GACD,OAAO,MAAMA,YAAY,QAAO"}

package/src/lib/plugin.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @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.
+ */
+/**
+ * Console half: the Forms catalog and one form's own surface, served by the
+ * shell's generic plugin route.
+ *
+ * `ownsSubtree` because a form's detail URL names a document id rather than a
+ * declared section. Safe to call at console app load — the page is lazy.
+ */
+export declare function registerFormsConsole(): void;
+export * from './site';

package/src/lib/plugin.js

@@ -0,0 +1,76 @@
+/**
+ * @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";
+import { mdiEmailFastOutline } from "@aglyn/shared-data-mdi";
+import { lazy } from "react";
+import { registerPluginZone } from "@aglyn/aglyn/plugin-manager/plugin-zones";
+import { FORM_CONTACT_FIELDS_ZONE, FORM_SUBMISSIONS_ZONE } from "./components/form-zones.js";
+import { BUNDLE_ID } from "./constants/bundle-common.js";
+/** Code-split: the Forms console surface only loads when opened. */ const FormsConsolePage = lazy(()=>import("./components/forms-console-page.js"));
+/**
+ * Console half: the Forms catalog and one form's own surface, served by the
+ * shell's generic plugin route.
+ *
+ * `ownsSubtree` because a form's detail URL names a document id rather than a
+ * declared section. Safe to call at console app load — the page is lazy.
+ */ export function registerFormsConsole() {
+    registerPluginZone({
+        zone: FORM_SUBMISSIONS_ZONE,
+        label: 'One form’s submissions',
+        surface: 'console',
+        description: 'On one form’s page, behind the reader’s ask. A widget here reads the submissions to that form alone; it is handed the site and the form and nothing else.'
+    }, // Named, because a spec calls this registrar without the loader.
+    {
+        pluginId: BUNDLE_ID
+    });
+    registerPluginZone({
+        zone: FORM_CONTACT_FIELDS_ZONE,
+        label: 'Where a form’s fields save on the person',
+        surface: 'console',
+        description: 'On one form’s page, beside routing and consent. A widget here decides which of the person’s fields each form field saves to and hands the new declaration to `saveFields`; the page writes the form document, and the widget writes nothing itself.'
+    }, {
+        pluginId: BUNDLE_ID
+    });
+    Aglyn.registerConsoleExtension({
+        pluginId: BUNDLE_ID,
+        displayName: 'Forms',
+        navItems: [
+            {
+                label: 'Forms',
+                href: '/forms',
+                // The tab id the console has always keyed this surface's active state
+                // on. It carries no release flag: forms is on for every workspace, and
+                // a site that switches it off loses this tab with the rest.
+                navTabId: 'nav-tab-forms',
+                icon: {
+                    path: mdiEmailFastOutline.path
+                },
+                ownsSubtree: true,
+                header: {
+                    title: 'Forms',
+                    icon: {
+                        path: mdiEmailFastOutline.path
+                    },
+                    docsTopic: 'forms'
+                },
+                Component: FormsConsolePage
+            }
+        ]
+    });
+}
+export * from "./site.js";
+
+//# sourceMappingURL=plugin.js.map

package/src/lib/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/plugins/forms/src/lib/plugin.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 * as Aglyn from '@aglyn/aglyn'\nimport { mdiEmailFastOutline } from '@aglyn/shared-data-mdi'\nimport { lazy } from 'react'\nimport { registerPluginZone } from '@aglyn/aglyn/plugin-manager/plugin-zones'\nimport {\n  FORM_CONTACT_FIELDS_ZONE,\n  FORM_SUBMISSIONS_ZONE,\n} from './components/form-zones'\nimport { BUNDLE_ID } from './constants/bundle-common'\n\n/** Code-split: the Forms console surface only loads when opened. */\nconst FormsConsolePage = lazy(() => import('./components/forms-console-page'))\n\n/**\n * Console half: the Forms catalog and one form's own surface, served by the\n * shell's generic plugin route.\n *\n * `ownsSubtree` because a form's detail URL names a document id rather than a\n * declared section. Safe to call at console app load — the page is lazy.\n */\nexport function registerFormsConsole(): void {\n  registerPluginZone(\n    {\n      zone: FORM_SUBMISSIONS_ZONE,\n      label: 'One form’s submissions',\n      surface: 'console',\n      description:\n        'On one form’s page, behind the reader’s ask. A widget here reads the submissions to that form alone; it is handed the site and the form and nothing else.',\n    },\n    // Named, because a spec calls this registrar without the loader.\n    { pluginId: BUNDLE_ID },\n  )\n  registerPluginZone(\n    {\n      zone: FORM_CONTACT_FIELDS_ZONE,\n      label: 'Where a form’s fields save on the person',\n      surface: 'console',\n      description:\n        'On one form’s page, beside routing and consent. A widget here decides which of the person’s fields each form field saves to and hands the new declaration to `saveFields`; the page writes the form document, and the widget writes nothing itself.',\n    },\n    { pluginId: BUNDLE_ID },\n  )\n  Aglyn.registerConsoleExtension({\n    pluginId: BUNDLE_ID,\n    displayName: 'Forms',\n    navItems: [\n      {\n        label: 'Forms',\n        href: '/forms',\n        // The tab id the console has always keyed this surface's active state\n        // on. It carries no release flag: forms is on for every workspace, and\n        // a site that switches it off loses this tab with the rest.\n        navTabId: 'nav-tab-forms',\n        icon: { path: mdiEmailFastOutline.path },\n        ownsSubtree: true,\n        header: {\n          title: 'Forms',\n          icon: { path: mdiEmailFastOutline.path },\n          docsTopic: 'forms',\n        },\n        Component: FormsConsolePage,\n      },\n    ],\n  })\n}\n\nexport * from './site'\n"],"names":["Aglyn","mdiEmailFastOutline","lazy","registerPluginZone","FORM_CONTACT_FIELDS_ZONE","FORM_SUBMISSIONS_ZONE","BUNDLE_ID","FormsConsolePage","registerFormsConsole","zone","label","surface","description","pluginId","registerConsoleExtension","displayName","navItems","href","navTabId","icon","path","ownsSubtree","header","title","docsTopic","Component"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,YAAYA,WAAW,eAAc;AACrC,SAASC,mBAAmB,QAAQ,yBAAwB;AAC5D,SAASC,IAAI,QAAQ,QAAO;AAC5B,SAASC,kBAAkB,QAAQ,2CAA0C;AAC7E,SACEC,wBAAwB,EACxBC,qBAAqB,QAChB,6BAAyB;AAChC,SAASC,SAAS,QAAQ,+BAA2B;AAErD,kEAAkE,GAClE,MAAMC,mBAAmBL,KAAK,IAAM,MAAM,CAAC;AAE3C;;;;;;CAMC,GACD,OAAO,SAASM;IACdL,mBACE;QACEM,MAAMJ;QACNK,OAAO;QACPC,SAAS;QACTC,aACE;IACJ,GACA,iEAAiE;IACjE;QAAEC,UAAUP;IAAU;IAExBH,mBACE;QACEM,MAAML;QACNM,OAAO;QACPC,SAAS;QACTC,aACE;IACJ,GACA;QAAEC,UAAUP;IAAU;IAExBN,MAAMc,wBAAwB,CAAC;QAC7BD,UAAUP;QACVS,aAAa;QACbC,UAAU;YACR;gBACEN,OAAO;gBACPO,MAAM;gBACN,sEAAsE;gBACtE,uEAAuE;gBACvE,4DAA4D;gBAC5DC,UAAU;gBACVC,MAAM;oBAAEC,MAAMnB,oBAAoBmB,IAAI;gBAAC;gBACvCC,aAAa;gBACbC,QAAQ;oBACNC,OAAO;oBACPJ,MAAM;wBAAEC,MAAMnB,oBAAoBmB,IAAI;oBAAC;oBACvCI,WAAW;gBACb;gBACAC,WAAWlB;YACb;SACD;IACH;AACF;AAEA,cAAc,YAAQ"}

package/src/lib/site.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @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';
+/**
+ * The canvas half: the form and the fields inside it.
+ *
+ * `formField` ships beside `form` rather than staying with the generic
+ * elements because it is not a generic input — it publishes its own
+ * name/dataset mapping to the enclosing form through a hidden input, and a
+ * field with no form around it submits nowhere.
+ */
+export declare const FORMS_BUNDLE: Aglyn.FeatureBundleEntry[];
+/**
+ * Forms feature plugin: a canvas element and a console surface, the shape a
+ * capability with both halves takes.
+ *
+ * ## On for every workspace, switchable per site (AGL-3029)
+ *
+ * A form has two halves, and only one of them is this bundle. The bundle
+ * DRAWS the form; its server half is core — `/api/forms/submit` is a core
+ * tenant route and `form-contract.ts` a core module the publish path runs —
+ * because core may not import a plugin. A switch on the bundle alone would
+ * stop only the drawing: a published contact page would render a hole while
+ * the endpoint behind it kept answering.
+ *
+ * So the switch is not the bundle's. `forms` carries `alwaysOnForWorkspace`
+ * in the catalog — the catalog and the submissions already stored belong to
+ * the workspace, and no workspace switch is offered — and a site switches it
+ * off through its ordinary deny-list. Every half asks the site's plugin set
+ * about `FORMS_PLUGIN_ID`, never this package: the submit route refuses, the
+ * contract check refuses to publish a form or a page carrying one, and the
+ * published page stops drawing the element, on the server as on the client.
+ *
+ * On is not the same as loaded. `requiredSitePlugins` narrows the pre-render
+ * set by each node's `pluginId`, so a page with no form on it does not wait
+ * for this bundle — which is the saving the move buys, since every page used
+ * to carry the form element inside `mui`.
+ */
+export declare function registerFormsPlugin(): void;

package/src/lib/site.js

@@ -0,0 +1,83 @@
+/**
+ * @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";
+import { mdiEmailFastOutline } from "@aglyn/shared-data-mdi";
+import * as FormComponents from "./components/form.js";
+import { BUNDLE_ID } from "./constants/bundle-common.js";
+/**
+ * The canvas half: the form and the fields inside it.
+ *
+ * `formField` ships beside `form` rather than staying with the generic
+ * elements because it is not a generic input — it publishes its own
+ * name/dataset mapping to the enclosing form through a hidden input, and a
+ * field with no form around it submits nowhere.
+ */ export const FORMS_BUNDLE = [
+    {
+        component: FormComponents.Form,
+        schema: FormComponents.formSchema,
+        presets: FormComponents.formPresets
+    },
+    {
+        component: FormComponents.FormField,
+        schema: FormComponents.formFieldSchema,
+        // The composed Contact Section, offered under Sections & Blocks. It hangs
+        // off the FIELD entry only because the registry reads presets per entry;
+        // what it places is the form above.
+        presets: FormComponents.formBlockPresets
+    }
+];
+/**
+ * Forms feature plugin: a canvas element and a console surface, the shape a
+ * capability with both halves takes.
+ *
+ * ## On for every workspace, switchable per site (AGL-3029)
+ *
+ * A form has two halves, and only one of them is this bundle. The bundle
+ * DRAWS the form; its server half is core — `/api/forms/submit` is a core
+ * tenant route and `form-contract.ts` a core module the publish path runs —
+ * because core may not import a plugin. A switch on the bundle alone would
+ * stop only the drawing: a published contact page would render a hole while
+ * the endpoint behind it kept answering.
+ *
+ * So the switch is not the bundle's. `forms` carries `alwaysOnForWorkspace`
+ * in the catalog — the catalog and the submissions already stored belong to
+ * the workspace, and no workspace switch is offered — and a site switches it
+ * off through its ordinary deny-list. Every half asks the site's plugin set
+ * about `FORMS_PLUGIN_ID`, never this package: the submit route refuses, the
+ * contract check refuses to publish a form or a page carrying one, and the
+ * published page stops drawing the element, on the server as on the client.
+ *
+ * On is not the same as loaded. `requiredSitePlugins` narrows the pre-render
+ * set by each node's `pluginId`, so a page with no form on it does not wait
+ * for this bundle — which is the saving the move buys, since every page used
+ * to carry the form element inside `mui`.
+ */ export function registerFormsPlugin() {
+    // The canvas half only. The console registers the console half through its
+    // own `console` surface, and a published page must never load console code
+    // (AGL-3116): this runs on every page that places one of these elements.
+    if (Aglyn.plugins.getDependency(BUNDLE_ID)) return;
+    Aglyn.plugins.addDependency(Aglyn.defineUiFeatureBundle({
+        bundleId: BUNDLE_ID,
+        displayName: 'Forms',
+        description: 'Forms and their fields: contact, signup, survey',
+        icon: {
+            path: mdiEmailFastOutline.path
+        },
+        components: FORMS_BUNDLE
+    }, Aglyn.components));
+}
+
+//# sourceMappingURL=site.js.map

package/src/lib/site.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/plugins/forms/src/lib/site.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 * as Aglyn from '@aglyn/aglyn'\nimport { mdiEmailFastOutline } from '@aglyn/shared-data-mdi'\nimport * as FormComponents from './components/form'\nimport { BUNDLE_ID } from './constants/bundle-common'\n\n/**\n * The canvas half: the form and the fields inside it.\n *\n * `formField` ships beside `form` rather than staying with the generic\n * elements because it is not a generic input — it publishes its own\n * name/dataset mapping to the enclosing form through a hidden input, and a\n * field with no form around it submits nowhere.\n */\nexport const FORMS_BUNDLE: Aglyn.FeatureBundleEntry[] = [\n  {\n    component: FormComponents.Form,\n    schema: FormComponents.formSchema,\n    presets: FormComponents.formPresets,\n  },\n  {\n    component: FormComponents.FormField,\n    schema: FormComponents.formFieldSchema,\n    // The composed Contact Section, offered under Sections & Blocks. It hangs\n    // off the FIELD entry only because the registry reads presets per entry;\n    // what it places is the form above.\n    presets: FormComponents.formBlockPresets,\n  },\n]\n\n/**\n * Forms feature plugin: a canvas element and a console surface, the shape a\n * capability with both halves takes.\n *\n * ## On for every workspace, switchable per site (AGL-3029)\n *\n * A form has two halves, and only one of them is this bundle. The bundle\n * DRAWS the form; its server half is core — `/api/forms/submit` is a core\n * tenant route and `form-contract.ts` a core module the publish path runs —\n * because core may not import a plugin. A switch on the bundle alone would\n * stop only the drawing: a published contact page would render a hole while\n * the endpoint behind it kept answering.\n *\n * So the switch is not the bundle's. `forms` carries `alwaysOnForWorkspace`\n * in the catalog — the catalog and the submissions already stored belong to\n * the workspace, and no workspace switch is offered — and a site switches it\n * off through its ordinary deny-list. Every half asks the site's plugin set\n * about `FORMS_PLUGIN_ID`, never this package: the submit route refuses, the\n * contract check refuses to publish a form or a page carrying one, and the\n * published page stops drawing the element, on the server as on the client.\n *\n * On is not the same as loaded. `requiredSitePlugins` narrows the pre-render\n * set by each node's `pluginId`, so a page with no form on it does not wait\n * for this bundle — which is the saving the move buys, since every page used\n * to carry the form element inside `mui`.\n */\nexport function registerFormsPlugin(): void {\n  // The canvas half only. The console registers the console half through its\n  // own `console` surface, and a published page must never load console code\n  // (AGL-3116): this runs on every page that places one of these elements.\n  if (Aglyn.plugins.getDependency(BUNDLE_ID)) return\n  Aglyn.plugins.addDependency(\n    Aglyn.defineUiFeatureBundle(\n      {\n        bundleId: BUNDLE_ID,\n        displayName: 'Forms',\n        description: 'Forms and their fields: contact, signup, survey',\n        icon: { path: mdiEmailFastOutline.path },\n        components: FORMS_BUNDLE,\n      },\n      Aglyn.components,\n    ),\n  )\n}\n"],"names":["Aglyn","mdiEmailFastOutline","FormComponents","BUNDLE_ID","FORMS_BUNDLE","component","Form","schema","formSchema","presets","formPresets","FormField","formFieldSchema","formBlockPresets","registerFormsPlugin","plugins","getDependency","addDependency","defineUiFeatureBundle","bundleId","displayName","description","icon","path","components"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,YAAYA,WAAW,eAAc;AACrC,SAASC,mBAAmB,QAAQ,yBAAwB;AAC5D,YAAYC,oBAAoB,uBAAmB;AACnD,SAASC,SAAS,QAAQ,+BAA2B;AAErD;;;;;;;CAOC,GACD,OAAO,MAAMC,eAA2C;IACtD;QACEC,WAAWH,eAAeI,IAAI;QAC9BC,QAAQL,eAAeM,UAAU;QACjCC,SAASP,eAAeQ,WAAW;IACrC;IACA;QACEL,WAAWH,eAAeS,SAAS;QACnCJ,QAAQL,eAAeU,eAAe;QACtC,0EAA0E;QAC1E,yEAAyE;QACzE,oCAAoC;QACpCH,SAASP,eAAeW,gBAAgB;IAC1C;CACD,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;CAyBC,GACD,OAAO,SAASC;IACd,2EAA2E;IAC3E,2EAA2E;IAC3E,yEAAyE;IACzE,IAAId,MAAMe,OAAO,CAACC,aAAa,CAACb,YAAY;IAC5CH,MAAMe,OAAO,CAACE,aAAa,CACzBjB,MAAMkB,qBAAqB,CACzB;QACEC,UAAUhB;QACViB,aAAa;QACbC,aAAa;QACbC,MAAM;YAAEC,MAAMtB,oBAAoBsB,IAAI;QAAC;QACvCC,YAAYpB;IACd,GACAJ,MAAMwB,UAAU;AAGtB"}

package/src/lib/utils/generate-preset-id.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @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 { ComponentId } from '@aglyn/aglyn';
+/**
+ * Preset ids ARE namespaced by bundle, unlike component ids: the registry
+ * keys presets in one flat record across every registered bundle, so two
+ * bundles offering a "contact form" starter would collapse into one entry
+ * without the prefix.
+ */
+export declare const generatePresetId: (componentId: ComponentId, ...other: string[]) => ComponentId;
+export default generatePresetId;

package/src/lib/utils/generate-preset-id.js

@@ -0,0 +1,30 @@
+/**
+ * @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 { BUNDLE_ID } from "../constants/bundle-common.js";
+/**
+ * Preset ids ARE namespaced by bundle, unlike component ids: the registry
+ * keys presets in one flat record across every registered bundle, so two
+ * bundles offering a "contact form" starter would collapse into one entry
+ * without the prefix.
+ */ export const generatePresetId = (componentId, ...other)=>{
+    return `${BUNDLE_ID}:${[
+        componentId,
+        ...other
+    ].join('.')}`;
+};
+export default generatePresetId;
+
+//# sourceMappingURL=generate-preset-id.js.map

package/src/lib/utils/generate-preset-id.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/forms/src/lib/utils/generate-preset-id.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 { ComponentId } from '@aglyn/aglyn'\nimport { BUNDLE_ID } from '../constants/bundle-common'\n\n/**\n * Preset ids ARE namespaced by bundle, unlike component ids: the registry\n * keys presets in one flat record across every registered bundle, so two\n * bundles offering a \"contact form\" starter would collapse into one entry\n * without the prefix.\n */\nexport const generatePresetId = (\n  componentId: ComponentId,\n  ...other: string[]\n): ComponentId => {\n  return `${BUNDLE_ID}:${[componentId, ...other].join('.')}`\n}\n\nexport default generatePresetId\n"],"names":["BUNDLE_ID","generatePresetId","componentId","other","join"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAGD,SAASA,SAAS,QAAQ,gCAA4B;AAEtD;;;;;CAKC,GACD,OAAO,MAAMC,mBAAmB,CAC9BC,aACA,GAAGC;IAEH,OAAO,GAAGH,UAAU,CAAC,EAAE;QAACE;WAAgBC;KAAM,CAACC,IAAI,CAAC,MAAM;AAC5D,EAAC;AAED,eAAeH,iBAAgB"}