@aglyn/besigner-ui 1.0.0-beta.143

package/src/lib/contexts/media-picker-context.d.ts

@@ -0,0 +1,88 @@
+/**
+ * @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 { PickMediaOptions } from '@aglyn/aglyn';
+/**
+ * Host-app-provided media browser (AGL-106): elements with a `src`
+ * attribute get a "Browse media" action in the Attributes panel when the
+ * host supplies this callback (the console opens its media-picker dialog);
+ * the designer stays storage-agnostic and hides the control otherwise.
+ */
+export interface MediaPickerContextValue {
+    /**
+     * `onPick` receives the value the attribute should STORE, which is not
+     * necessarily a URL: the console hands back a `media:{scope}/{mediaId}`
+     * reference for library assets (AGL-1215) and a raw URL only for assets
+     * that have no CDN path. The designer writes it through verbatim — what
+     * the persisted form means is the host app's and the renderer's business,
+     * which is the same reason this context exists at all.
+     *
+     * `asset` carries the chosen asset's own authored metadata (AGL-1896) so a
+     * surface can DEFAULT a companion attribute from it — `alt`, which the DAM
+     * has stored since AGL-173 and which nothing ever read back, and the pixel
+     * `width`/`height` captured at upload. Structural and optional on purpose:
+     * the designer stays storage-agnostic, a host that supplies no metadata is
+     * unchanged, and this stays one extra argument rather than a second picker
+     * mechanism. Use `Aglyn.inheritedMediaAlt` to decide what to do with the
+     * alt — never inline the rule, or the override precedence drifts per
+     * surface.
+     *
+     * The dimensions are copied at PICK TIME because no tenant render path
+     * reads an image's media document (AGL-2486). Resolving them while
+     * rendering would put a per-image Firestore read on the hottest cached
+     * path; carrying them on the node costs two numbers and is read like any
+     * other prop. They are best-effort at upload, so either may be absent.
+     *
+     * `video` and `poster` are the video half of the same bargain (AGL-2749),
+     * and they are the DOCUMENT's own records rather than anything flattened on
+     * the way here — a video's dimensions live inside `video` precisely so a
+     * reader can tell a browser's report from a server measurement, and
+     * flattening them into `width`/`height` above would throw that distinction
+     * away at the seam. `Aglyn.videoMediaProps` owns what happens to them; a
+     * host that sends neither leaves every element exactly as it was.
+     *
+     * `options.kind` narrows the browser to the one kind of file the attribute
+     * can hold (AGL-2953), such as a Video element's source. Only `kind` is
+     * offered: a page cannot place a private asset, so the designer has no use
+     * for `allowPrivate`. A host that ignores it shows its whole library.
+     */
+    onPickMedia?: (onPick: (value: string, asset?: {
+        alt?: string;
+        width?: number;
+        height?: number;
+        /** The asset's `video` record: `durationMs`, `width`, `height`. */
+        video?: unknown;
+        /** The asset's generated `poster` record, when the DAM made one. */
+        poster?: unknown;
+    }) => void, options?: Pick<PickMediaOptions, 'kind'>) => void;
+    /**
+     * External image hosts this site's owner has approved (AGL-1152).
+     *
+     * Carried here rather than fetched by the field, because the designer must
+     * not read Firestore: it renders inside a plugin sandbox and the host doc is
+     * the console's to know. The provider that already takes `hostId` supplies
+     * it.
+     *
+     * ABSENT means "not known", NOT "nothing approved" — a field that cannot see
+     * the list must warn about nothing rather than warn about everything. The
+     * warning exists to tell an author something true before they publish; one
+     * that fires on every external URL because the list failed to load teaches
+     * them to ignore it, which is worse than silence.
+     */
+    approvedImageHosts?: readonly string[];
+}
+export declare const MediaPickerContext: import("react").Context<MediaPickerContextValue>;
+export default MediaPickerContext;

package/src/lib/contexts/media-picker-context.js

@@ -0,0 +1,21 @@
+/**
+ * @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 { createContext } from "react";
+export const MediaPickerContext = createContext({});
+MediaPickerContext.displayName = 'MediaPickerContext';
+export default MediaPickerContext;
+
+//# sourceMappingURL=media-picker-context.js.map

package/src/lib/contexts/media-picker-context.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/besigner/feature/designer/src/lib/contexts/media-picker-context.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 { PickMediaOptions } from '@aglyn/aglyn'\nimport { createContext } from 'react'\n\n/**\n * Host-app-provided media browser (AGL-106): elements with a `src`\n * attribute get a \"Browse media\" action in the Attributes panel when the\n * host supplies this callback (the console opens its media-picker dialog);\n * the designer stays storage-agnostic and hides the control otherwise.\n */\nexport interface MediaPickerContextValue {\n  /**\n   * `onPick` receives the value the attribute should STORE, which is not\n   * necessarily a URL: the console hands back a `media:{scope}/{mediaId}`\n   * reference for library assets (AGL-1215) and a raw URL only for assets\n   * that have no CDN path. The designer writes it through verbatim — what\n   * the persisted form means is the host app's and the renderer's business,\n   * which is the same reason this context exists at all.\n   *\n   * `asset` carries the chosen asset's own authored metadata (AGL-1896) so a\n   * surface can DEFAULT a companion attribute from it — `alt`, which the DAM\n   * has stored since AGL-173 and which nothing ever read back, and the pixel\n   * `width`/`height` captured at upload. Structural and optional on purpose:\n   * the designer stays storage-agnostic, a host that supplies no metadata is\n   * unchanged, and this stays one extra argument rather than a second picker\n   * mechanism. Use `Aglyn.inheritedMediaAlt` to decide what to do with the\n   * alt — never inline the rule, or the override precedence drifts per\n   * surface.\n   *\n   * The dimensions are copied at PICK TIME because no tenant render path\n   * reads an image's media document (AGL-2486). Resolving them while\n   * rendering would put a per-image Firestore read on the hottest cached\n   * path; carrying them on the node costs two numbers and is read like any\n   * other prop. They are best-effort at upload, so either may be absent.\n   *\n   * `video` and `poster` are the video half of the same bargain (AGL-2749),\n   * and they are the DOCUMENT's own records rather than anything flattened on\n   * the way here — a video's dimensions live inside `video` precisely so a\n   * reader can tell a browser's report from a server measurement, and\n   * flattening them into `width`/`height` above would throw that distinction\n   * away at the seam. `Aglyn.videoMediaProps` owns what happens to them; a\n   * host that sends neither leaves every element exactly as it was.\n   *\n   * `options.kind` narrows the browser to the one kind of file the attribute\n   * can hold (AGL-2953), such as a Video element's source. Only `kind` is\n   * offered: a page cannot place a private asset, so the designer has no use\n   * for `allowPrivate`. A host that ignores it shows its whole library.\n   */\n  onPickMedia?: (\n    onPick: (\n      value: string,\n      asset?: {\n        alt?: string\n        width?: number\n        height?: number\n        /** The asset's `video` record: `durationMs`, `width`, `height`. */\n        video?: unknown\n        /** The asset's generated `poster` record, when the DAM made one. */\n        poster?: unknown\n      },\n    ) => void,\n    options?: Pick<PickMediaOptions, 'kind'>,\n  ) => void\n  /**\n   * External image hosts this site's owner has approved (AGL-1152).\n   *\n   * Carried here rather than fetched by the field, because the designer must\n   * not read Firestore: it renders inside a plugin sandbox and the host doc is\n   * the console's to know. The provider that already takes `hostId` supplies\n   * it.\n   *\n   * ABSENT means \"not known\", NOT \"nothing approved\" — a field that cannot see\n   * the list must warn about nothing rather than warn about everything. The\n   * warning exists to tell an author something true before they publish; one\n   * that fires on every external URL because the list failed to load teaches\n   * them to ignore it, which is worse than silence.\n   */\n  approvedImageHosts?: readonly string[]\n}\n\nexport const MediaPickerContext = createContext<MediaPickerContextValue>({})\nMediaPickerContext.displayName = 'MediaPickerContext'\n\nexport default MediaPickerContext\n"],"names":["createContext","MediaPickerContext","displayName"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAGD,SAASA,aAAa,QAAQ,QAAO;AA8ErC,OAAO,MAAMC,qBAAqBD,cAAuC,CAAC,GAAE;AAC5EC,mBAAmBC,WAAW,GAAG;AAEjC,eAAeD,mBAAkB"}

package/src/lib/contexts/rendered-canvas-elements.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @license
+ * Copyright 2023 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 { NodeId } from '@aglyn/aglyn';
+import { type RefObject } from 'react';
+export type ElementCanvasRefObject = Dictionary & {
+    $id: NodeId;
+    node: Element;
+    dragHandle: any;
+};
+export type RenderedCanvasElementsType = {
+    elements: RefObject<Record<NodeId, ElementCanvasRefObject>>;
+    setElementRef($id: NodeId, ref: ElementCanvasRefObject): void;
+    deleteElementRef($id: NodeId): void;
+};
+export declare const RenderedCanvasElementsContext: import("react").Context<RenderedCanvasElementsType>;
+export declare const useRenderedCanvasElements: () => RenderedCanvasElementsType;
+export declare const useRenderedCanvasElementRef: ({ $id }: {
+    $id: NodeId;
+}) => ElementCanvasRefObject;
+export interface RenderedCanvasElementsProps {
+    children?: JSX.Children;
+}
+export declare function RenderedCanvasElementsProvider(props: RenderedCanvasElementsProps): import("react").JSX.Element;
+export declare namespace RenderedCanvasElementsProvider {
+    var displayName: string;
+    var aglyn: boolean;
+}
+export default RenderedCanvasElementsProvider;

package/src/lib/contexts/rendered-canvas-elements.js

@@ -0,0 +1,79 @@
+/**
+ * @license
+ * Copyright 2023 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 { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext, useEffect, useMemo, useRef } from "react";
+export const RenderedCanvasElementsContext = /*#__PURE__*/ createContext({
+    elements: {
+        current: null
+    },
+    setElementRef () {},
+    deleteElementRef () {}
+});
+RenderedCanvasElementsContext.displayName = 'RenderedCanvasElementsContext';
+RenderedCanvasElementsContext.aglyn = true;
+export const useRenderedCanvasElements = ()=>{
+    return useContext(RenderedCanvasElementsContext);
+};
+export const useRenderedCanvasElementRef = ({ $id })=>{
+    const { elements } = useRenderedCanvasElements();
+    return useMemo(()=>elements.current[$id] || null, [
+        elements,
+        $id
+    ]);
+};
+export function RenderedCanvasElementsProvider(props) {
+    const { children } = props;
+    const elements = useRef({});
+    const context = useMemo(()=>({
+            elements,
+            setElementRef: ($id, ref)=>{
+                elements.current[$id] = ref;
+            },
+            deleteElementRef: ($id)=>{
+                delete elements.current[$id];
+            }
+        }), []);
+    // The registry, readable from a devtools console (AGL-2486).
+    //
+    // This map had NO writer for its entire existence and nothing said so:
+    // every consumer read `{}`, found nothing, and rendered nothing. Two
+    // features were void for months because the only way to discover an empty
+    // registry was to read the source of everything that touches it.
+    //
+    // `window.AglynCanvasElements()` returns the live ids, so "is the canvas
+    // registered?" is one line in a console instead of an afternoon. Cheap,
+    // dev-only, and it holds no reference the registry does not already hold.
+    useEffect(()=>{
+        if (process.env.NODE_ENV === 'production') return undefined;
+        if (typeof window === 'undefined') return undefined;
+        window['AglynCanvasElements'] = ()=>{
+            var _elements_current;
+            return Object.keys((_elements_current = elements.current) != null ? _elements_current : {});
+        };
+        return ()=>{
+            delete window['AglynCanvasElements'];
+        };
+    }, []);
+    return /*#__PURE__*/ _jsx(RenderedCanvasElementsContext.Provider, {
+        value: context,
+        children: children
+    });
+}
+RenderedCanvasElementsProvider.displayName = 'RenderedCanvasElementsProvider';
+RenderedCanvasElementsProvider.aglyn = true;
+export default RenderedCanvasElementsProvider;
+
+//# sourceMappingURL=rendered-canvas-elements.js.map

package/src/lib/contexts/rendered-canvas-elements.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/besigner/feature/designer/src/lib/contexts/rendered-canvas-elements.tsx"],"sourcesContent":["/**\n * @license\n * Copyright 2023 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 { NodeId } from '@aglyn/aglyn'\nimport {\n  createContext,\n  type RefObject,\n  useContext,\n  useEffect,\n  useMemo,\n  useRef,\n} from 'react'\n\nexport type ElementCanvasRefObject = Dictionary & {\n  $id: NodeId\n  node: Element\n  dragHandle: any\n}\n\nexport type RenderedCanvasElementsType = {\n  elements: RefObject<Record<NodeId, ElementCanvasRefObject>>\n  setElementRef($id: NodeId, ref: ElementCanvasRefObject): void\n  deleteElementRef($id: NodeId): void\n}\n\nexport const RenderedCanvasElementsContext =\n  createContext<RenderedCanvasElementsType>({\n    elements: { current: null } as any,\n    setElementRef() {},\n    deleteElementRef() {},\n  })\nRenderedCanvasElementsContext.displayName = 'RenderedCanvasElementsContext'\nRenderedCanvasElementsContext.aglyn = true\n\nexport const useRenderedCanvasElements = () => {\n  return useContext(RenderedCanvasElementsContext)\n}\n\nexport const useRenderedCanvasElementRef = ({ $id }: { $id: NodeId }) => {\n  const { elements } = useRenderedCanvasElements()\n  return useMemo(() => elements.current[$id] || null, [elements, $id])\n}\n\nexport interface RenderedCanvasElementsProps {\n  children?: JSX.Children\n}\n\nexport function RenderedCanvasElementsProvider(\n  props: RenderedCanvasElementsProps,\n) {\n  const { children } = props\n  const elements = useRef<Record<NodeId, ElementCanvasRefObject>>({})\n  const context = useMemo<RenderedCanvasElementsType>(\n    () => ({\n      elements,\n      setElementRef: ($id, ref): void => {\n        elements.current[$id] = ref\n      },\n      deleteElementRef: ($id): void => {\n        delete elements.current[$id]\n      },\n    }),\n    [],\n  )\n\n  // The registry, readable from a devtools console (AGL-2486).\n  //\n  // This map had NO writer for its entire existence and nothing said so:\n  // every consumer read `{}`, found nothing, and rendered nothing. Two\n  // features were void for months because the only way to discover an empty\n  // registry was to read the source of everything that touches it.\n  //\n  // `window.AglynCanvasElements()` returns the live ids, so \"is the canvas\n  // registered?\" is one line in a console instead of an afternoon. Cheap,\n  // dev-only, and it holds no reference the registry does not already hold.\n  useEffect(() => {\n    if (process.env.NODE_ENV === 'production') return undefined\n    if (typeof window === 'undefined') return undefined\n    ;(window as unknown as Record<string, unknown>)['AglynCanvasElements'] =\n      () => Object.keys(elements.current ?? {})\n    return () => {\n      delete (window as unknown as Record<string, unknown>)[\n        'AglynCanvasElements'\n      ]\n    }\n  }, [])\n\n  return (\n    <RenderedCanvasElementsContext.Provider value={context}>\n      {children}\n    </RenderedCanvasElementsContext.Provider>\n  )\n}\n\nRenderedCanvasElementsProvider.displayName = 'RenderedCanvasElementsProvider'\nRenderedCanvasElementsProvider.aglyn = true\n\nexport default RenderedCanvasElementsProvider\n"],"names":["createContext","useContext","useEffect","useMemo","useRef","RenderedCanvasElementsContext","elements","current","setElementRef","deleteElementRef","displayName","aglyn","useRenderedCanvasElements","useRenderedCanvasElementRef","$id","RenderedCanvasElementsProvider","props","children","context","ref","process","env","NODE_ENV","undefined","window","Object","keys","Provider","value"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC;AAGD,SACEA,aAAa,EAEbC,UAAU,EACVC,SAAS,EACTC,OAAO,EACPC,MAAM,QACD,QAAO;AAcd,OAAO,MAAMC,8CACXL,cAA0C;IACxCM,UAAU;QAAEC,SAAS;IAAK;IAC1BC,kBAAiB;IACjBC,qBAAoB;AACtB,GAAE;AACJJ,8BAA8BK,WAAW,GAAG;AAC5CL,8BAA8BM,KAAK,GAAG;AAEtC,OAAO,MAAMC,4BAA4B;IACvC,OAAOX,WAAWI;AACpB,EAAC;AAED,OAAO,MAAMQ,8BAA8B,CAAC,EAAEC,GAAG,EAAmB;IAClE,MAAM,EAAER,QAAQ,EAAE,GAAGM;IACrB,OAAOT,QAAQ,IAAMG,SAASC,OAAO,CAACO,IAAI,IAAI,MAAM;QAACR;QAAUQ;KAAI;AACrE,EAAC;AAMD,OAAO,SAASC,+BACdC,KAAkC;IAElC,MAAM,EAAEC,QAAQ,EAAE,GAAGD;IACrB,MAAMV,WAAWF,OAA+C,CAAC;IACjE,MAAMc,UAAUf,QACd,IAAO,CAAA;YACLG;YACAE,eAAe,CAACM,KAAKK;gBACnBb,SAASC,OAAO,CAACO,IAAI,GAAGK;YAC1B;YACAV,kBAAkB,CAACK;gBACjB,OAAOR,SAASC,OAAO,CAACO,IAAI;YAC9B;QACF,CAAA,GACA,EAAE;IAGJ,6DAA6D;IAC7D,EAAE;IACF,uEAAuE;IACvE,qEAAqE;IACrE,0EAA0E;IAC1E,iEAAiE;IACjE,EAAE;IACF,yEAAyE;IACzE,wEAAwE;IACxE,0EAA0E;IAC1EZ,UAAU;QACR,IAAIkB,QAAQC,GAAG,CAACC,QAAQ,KAAK,cAAc,OAAOC;QAClD,IAAI,OAAOC,WAAW,aAAa,OAAOD;QACxCC,MAA6C,CAAC,sBAAsB,GACpE;gBAAkBlB;mBAAZmB,OAAOC,IAAI,EAACpB,oBAAAA,SAASC,OAAO,YAAhBD,oBAAoB,CAAC;;QACzC,OAAO;YACL,OAAO,AAACkB,MAA6C,CACnD,sBACD;QACH;IACF,GAAG,EAAE;IAEL,qBACE,KAACnB,8BAA8BsB,QAAQ;QAACC,OAAOV;kBAC5CD;;AAGP;AAEAF,+BAA+BL,WAAW,GAAG;AAC7CK,+BAA+BJ,KAAK,GAAG;AAEvC,eAAeI,+BAA8B"}

package/src/lib/contexts/repeat-record-context.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @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 { RepeatableDataset } from '@aglyn/aglyn/app-utils/expand-repeatables';
+import type { DatasetModel } from '@aglyn/aglyn/app-utils/dataset-models';
+/**
+ * The record the canvas nodes below this point are DRAWING (AGL-3111).
+ *
+ * Set by a repeating element around the template an author edits, so its
+ * `{{item.*}}` tokens render the first record's values the way the published
+ * page will. Nothing under it is changed — it decides render copies only.
+ *
+ * ABSENT everywhere else, which is the ordinary case: an element outside any
+ * repeat shows its props as written.
+ */
+export interface RepeatRecordContextValue {
+    /** The record's value map, with `$id` (AGL-180 hops resolve through it). */
+    record: Record<string, unknown>;
+    /** Model of the repeated rows; a reference hop needs its field configs. */
+    model?: DatasetModel;
+    /** Rows by key, so `{{item.author.name}}` resolves on the canvas too. */
+    datasetsByKey?: Record<string, RepeatableDataset | undefined>;
+}
+export declare const RepeatRecordContext: import("react").Context<RepeatRecordContextValue>;
+export default RepeatRecordContext;

package/src/lib/contexts/repeat-record-context.js

@@ -0,0 +1,21 @@
+/**
+ * @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 { createContext } from "react";
+export const RepeatRecordContext = createContext(undefined);
+RepeatRecordContext.displayName = 'RepeatRecordContext';
+export default RepeatRecordContext;
+
+//# sourceMappingURL=repeat-record-context.js.map

package/src/lib/contexts/repeat-record-context.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/besigner/feature/designer/src/lib/contexts/repeat-record-context.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 { RepeatableDataset } from '@aglyn/aglyn/app-utils/expand-repeatables'\nimport type { DatasetModel } from '@aglyn/aglyn/app-utils/dataset-models'\nimport { createContext } from 'react'\n\n/**\n * The record the canvas nodes below this point are DRAWING (AGL-3111).\n *\n * Set by a repeating element around the template an author edits, so its\n * `{{item.*}}` tokens render the first record's values the way the published\n * page will. Nothing under it is changed — it decides render copies only.\n *\n * ABSENT everywhere else, which is the ordinary case: an element outside any\n * repeat shows its props as written.\n */\nexport interface RepeatRecordContextValue {\n  /** The record's value map, with `$id` (AGL-180 hops resolve through it). */\n  record: Record<string, unknown>\n  /** Model of the repeated rows; a reference hop needs its field configs. */\n  model?: DatasetModel\n  /** Rows by key, so `{{item.author.name}}` resolves on the canvas too. */\n  datasetsByKey?: Record<string, RepeatableDataset | undefined>\n}\n\nexport const RepeatRecordContext = createContext<\n  RepeatRecordContextValue | undefined\n>(undefined)\nRepeatRecordContext.displayName = 'RepeatRecordContext'\n\nexport default RepeatRecordContext\n"],"names":["createContext","RepeatRecordContext","undefined","displayName"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAID,SAASA,aAAa,QAAQ,QAAO;AAqBrC,OAAO,MAAMC,sBAAsBD,cAEjCE,WAAU;AACZD,oBAAoBE,WAAW,GAAG;AAElC,eAAeF,oBAAmB"}

package/src/lib/contexts/repeat-rows-context.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 type { RepeatRowsAnswer } from '@aglyn/aglyn/app-utils/repeat-sources';
+import { type HeldAnswersSource, type HeldAnswersStore } from '../utils/held-answers-store';
+/**
+ * The rows a canvas repeat is drawn from (AGL-3111).
+ *
+ * A repeating element holds its source and key here; the host app renders one
+ * reader per held request, which asks the registered repeat source for the
+ * rows and files the answer back under {@link repeatRowsKey}. The canvas then
+ * draws the copies and the badge from that answer, through the published
+ * page's own expansion.
+ *
+ * ABSENT when no host app reads rows: every repeat then draws its template
+ * once, as the canvas always did.
+ */
+export interface RepeatRowsRequest {
+    /** The registered repeat source's id. */
+    sourceId: string;
+    /** The key exactly as the node stores it, trimmed. */
+    key: string;
+}
+export type RepeatRowsSource = HeldAnswersSource<RepeatRowsRequest, RepeatRowsAnswer>;
+export type RepeatRowsStore = HeldAnswersStore<RepeatRowsRequest, RepeatRowsAnswer>;
+/**
+ * Where a request's answer is filed.
+ *
+ * NUL joins the two parts because it cannot appear in a source id or in a
+ * stored repeat key, so no pair can forge another pair's key. It is written
+ * as the `\x00` ESCAPE and never as a raw NUL byte (AGL-1890): a literal NUL
+ * in the first 8000 bytes makes the whole file BINARY to git, which leaves it
+ * with no diff, no blame and nothing for `grep` to find. The escape parses to
+ * the identical one-character string, so nothing about the key changes.
+ */
+export declare function repeatRowsKey(request: RepeatRowsRequest): string;
+/** An in-memory store. How each request is read is the host app's business. */
+export declare function createRepeatRowsStore(): RepeatRowsStore;
+export declare const RepeatRowsContext: import("react").Context<RepeatRowsSource>;
+export default RepeatRowsContext;

package/src/lib/contexts/repeat-rows-context.js

@@ -0,0 +1,38 @@
+/**
+ * @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.
+ */ // By path: which sources exist is editor business, kept out of every barrel.
+import { createContext } from "react";
+import { createHeldAnswersStore } from "../utils/held-answers-store.js";
+/**
+ * Where a request's answer is filed.
+ *
+ * NUL joins the two parts because it cannot appear in a source id or in a
+ * stored repeat key, so no pair can forge another pair's key. It is written
+ * as the `\x00` ESCAPE and never as a raw NUL byte (AGL-1890): a literal NUL
+ * in the first 8000 bytes makes the whole file BINARY to git, which leaves it
+ * with no diff, no blame and nothing for `grep` to find. The escape parses to
+ * the identical one-character string, so nothing about the key changes.
+ */ export function repeatRowsKey(request) {
+    return `${request.sourceId}\x00${request.key}`;
+}
+/** An in-memory store. How each request is read is the host app's business. */ export function createRepeatRowsStore() {
+    return createHeldAnswersStore(repeatRowsKey);
+}
+export const RepeatRowsContext = createContext(undefined);
+RepeatRowsContext.displayName = 'RepeatRowsContext';
+export default RepeatRowsContext;
+
+//# sourceMappingURL=repeat-rows-context.js.map

package/src/lib/contexts/repeat-rows-context.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/besigner/feature/designer/src/lib/contexts/repeat-rows-context.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// By path: which sources exist is editor business, kept out of every barrel.\nimport type { RepeatRowsAnswer } from '@aglyn/aglyn/app-utils/repeat-sources'\nimport { createContext } from 'react'\nimport {\n  createHeldAnswersStore,\n  type HeldAnswersSource,\n  type HeldAnswersStore,\n} from '../utils/held-answers-store'\n\n/**\n * The rows a canvas repeat is drawn from (AGL-3111).\n *\n * A repeating element holds its source and key here; the host app renders one\n * reader per held request, which asks the registered repeat source for the\n * rows and files the answer back under {@link repeatRowsKey}. The canvas then\n * draws the copies and the badge from that answer, through the published\n * page's own expansion.\n *\n * ABSENT when no host app reads rows: every repeat then draws its template\n * once, as the canvas always did.\n */\nexport interface RepeatRowsRequest {\n  /** The registered repeat source's id. */\n  sourceId: string\n  /** The key exactly as the node stores it, trimmed. */\n  key: string\n}\n\nexport type RepeatRowsSource = HeldAnswersSource<\n  RepeatRowsRequest,\n  RepeatRowsAnswer\n>\nexport type RepeatRowsStore = HeldAnswersStore<\n  RepeatRowsRequest,\n  RepeatRowsAnswer\n>\n\n/**\n * Where a request's answer is filed.\n *\n * NUL joins the two parts because it cannot appear in a source id or in a\n * stored repeat key, so no pair can forge another pair's key. It is written\n * as the `\\x00` ESCAPE and never as a raw NUL byte (AGL-1890): a literal NUL\n * in the first 8000 bytes makes the whole file BINARY to git, which leaves it\n * with no diff, no blame and nothing for `grep` to find. The escape parses to\n * the identical one-character string, so nothing about the key changes.\n */\nexport function repeatRowsKey(request: RepeatRowsRequest): string {\n  return `${request.sourceId}\\x00${request.key}`\n}\n\n/** An in-memory store. How each request is read is the host app's business. */\nexport function createRepeatRowsStore(): RepeatRowsStore {\n  return createHeldAnswersStore<RepeatRowsRequest, RepeatRowsAnswer>(\n    repeatRowsKey,\n  )\n}\n\nexport const RepeatRowsContext = createContext<RepeatRowsSource | undefined>(\n  undefined,\n)\nRepeatRowsContext.displayName = 'RepeatRowsContext'\n\nexport default RepeatRowsContext\n"],"names":["createContext","createHeldAnswersStore","repeatRowsKey","request","sourceId","key","createRepeatRowsStore","RepeatRowsContext","undefined","displayName"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,6EAA6E;AAE7E,SAASA,aAAa,QAAQ,QAAO;AACrC,SACEC,sBAAsB,QAGjB,iCAA6B;AA8BpC;;;;;;;;;CASC,GACD,OAAO,SAASC,cAAcC,OAA0B;IACtD,OAAO,GAAGA,QAAQC,QAAQ,CAAC,IAAI,EAAED,QAAQE,GAAG,EAAE;AAChD;AAEA,6EAA6E,GAC7E,OAAO,SAASC;IACd,OAAOL,uBACLC;AAEJ;AAEA,OAAO,MAAMK,oBAAoBP,cAC/BQ,WACD;AACDD,kBAAkBE,WAAW,GAAG;AAEhC,eAAeF,kBAAiB"}

package/src/lib/contexts/toolbar-extras-context.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.
+ */
+import { type ReactNode } from 'react';
+/**
+ * Controls the host app adds to the besigner's secondary toolbar, after the
+ * undo and redo controls (AGL-2984).
+ *
+ * The designer stays free of console imports the way the Attributes panel's
+ * section does: the console supplies the node — its plugin widget slot,
+ * rendered with the shell's own gates — and the toolbar draws whatever
+ * arrives, and nothing when the host supplied nothing. Nothing here knows
+ * what a plugin is.
+ */
+export declare const BesignerToolbarExtrasContext: import("react").Context<ReactNode>;
+/** The host-supplied controls, or `null` when the host supplied nothing. */
+export declare function useBesignerToolbarExtras(): ReactNode;
+export default BesignerToolbarExtrasContext;

package/src/lib/contexts/toolbar-extras-context.js

@@ -0,0 +1,33 @@
+/**
+ * @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 { createContext, useContext } from "react";
+/**
+ * Controls the host app adds to the besigner's secondary toolbar, after the
+ * undo and redo controls (AGL-2984).
+ *
+ * The designer stays free of console imports the way the Attributes panel's
+ * section does: the console supplies the node — its plugin widget slot,
+ * rendered with the shell's own gates — and the toolbar draws whatever
+ * arrives, and nothing when the host supplied nothing. Nothing here knows
+ * what a plugin is.
+ */ export const BesignerToolbarExtrasContext = /*#__PURE__*/ createContext(null);
+BesignerToolbarExtrasContext.displayName = 'BesignerToolbarExtrasContext';
+/** The host-supplied controls, or `null` when the host supplied nothing. */ export function useBesignerToolbarExtras() {
+    return useContext(BesignerToolbarExtrasContext);
+}
+export default BesignerToolbarExtrasContext;
+
+//# sourceMappingURL=toolbar-extras-context.js.map

package/src/lib/contexts/toolbar-extras-context.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/besigner/feature/designer/src/lib/contexts/toolbar-extras-context.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\nimport { createContext, useContext, type ReactNode } from 'react'\n\n/**\n * Controls the host app adds to the besigner's secondary toolbar, after the\n * undo and redo controls (AGL-2984).\n *\n * The designer stays free of console imports the way the Attributes panel's\n * section does: the console supplies the node — its plugin widget slot,\n * rendered with the shell's own gates — and the toolbar draws whatever\n * arrives, and nothing when the host supplied nothing. Nothing here knows\n * what a plugin is.\n */\nexport const BesignerToolbarExtrasContext = createContext<ReactNode>(null)\nBesignerToolbarExtrasContext.displayName = 'BesignerToolbarExtrasContext'\n\n/** The host-supplied controls, or `null` when the host supplied nothing. */\nexport function useBesignerToolbarExtras(): ReactNode {\n  return useContext(BesignerToolbarExtrasContext)\n}\n\nexport default BesignerToolbarExtrasContext\n"],"names":["createContext","useContext","BesignerToolbarExtrasContext","displayName","useBesignerToolbarExtras"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,aAAa,EAAEC,UAAU,QAAwB,QAAO;AAEjE;;;;;;;;;CASC,GACD,OAAO,MAAMC,6CAA+BF,cAAyB,MAAK;AAC1EE,6BAA6BC,WAAW,GAAG;AAE3C,0EAA0E,GAC1E,OAAO,SAASC;IACd,OAAOH,WAAWC;AACpB;AAEA,eAAeA,6BAA4B"}

package/src/lib/drafts/besigner-draft-store.d.ts

@@ -0,0 +1,110 @@
+/**
+ * @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 ProcessableNodes } from '@aglyn/aglyn';
+/**
+ * Local crash net for unsaved besigner work (AGL-1256).
+ *
+ * ## What this is not
+ *
+ * It is deliberately **not** version history. Versioning is a paid feature
+ * (`versioning`, Pro and above): named snapshots of the *saved* document that
+ * you can list, reopen, publish and schedule. A store of dated snapshots in
+ * the browser is one careless design decision away from being a free
+ * imitation of exactly that, so three rules hold the line, and every one of
+ * them is load-bearing rather than incidental:
+ *
+ * 1. **One draft per document, latest wins.** No list, no names, no history.
+ *    There is nothing to browse and nothing to choose between.
+ * 2. **A draft only ever holds work that was never saved.** It is cleared the
+ *    moment a save succeeds, so it can never act as "restore the document to
+ *    how it was before" — that is rollback, and rollback is what versions
+ *    sell. The only thing a draft can give back is the thing that would
+ *    otherwise be gone forever.
+ * 3. **A draft expires.** {@link DRAFT_MAX_AGE_MS} keeps it a recovery window
+ *    rather than an archive.
+ *
+ * Because of those, drafts are ungated: this is data-loss prevention, and
+ * gating it would mean a free org's crash still costs them their afternoon.
+ * A free org gets back exactly what they had in the canvas and not one
+ * revision more.
+ */
+/** Every key this module owns; also the set it may evict from. */
+export declare const BESIGNER_DRAFT_KEY_PREFIX = "aglyn:draft:";
+/**
+ * A week. Long enough to cover "my laptop died on Friday", short enough that
+ * the store never becomes an accumulating pile of restore points.
+ */
+export declare const DRAFT_MAX_AGE_MS: number;
+/**
+ * Which besigner document a draft belongs to.
+ *
+ * Every field is part of the key on purpose. `useBesignerDocument`'s
+ * `documentKey` looks like the natural choice and is not safe as one: both
+ * email editors build it as `${templateKey}:${versionId}`, so a platform
+ * email template and a host's override of the same key — and two different
+ * hosts overriding it — all collide. This is the same trap AGL-1203 hit with
+ * preview snapshots, where screen, layout, component and template ids come
+ * from one generator and live in sibling collections.
+ */
+export interface BesignerDraftIds {
+    /**
+     * Owning host id, or `'platform'` for the staff-owned system documents
+     * that have no host.
+     */
+    scope: string;
+    kind: 'screen' | 'layout' | 'component' | 'template' | 'email' | 'form';
+    docId: string;
+    /**
+     * Which version of the document is open. Keeping this in the key is what
+     * stops a draft taken against version A being offered on version B —
+     * versions are meant to be independent, and a draft that leaked across
+     * them would corrupt the paid feature rather than merely duplicate it.
+     * Templates version but never publish, so they have none.
+     */
+    versionId?: string;
+}
+export interface BesignerDraft {
+    nodes: ProcessableNodes;
+    /**
+     * The stored document's version stamp when this draft was taken, in
+     * `Aglyn.versionStamp` form. Null when the document had not stamped yet.
+     * This is what makes the restore prompt honest about a colleague having
+     * saved in the meantime (AGL-674).
+     */
+    baseStamp: string | null;
+    /** When the draft was last written. */
+    updatedAt: number;
+}
+export declare function besignerDraftKey(ids: BesignerDraftIds): string;
+/**
+ * Writes the draft, replacing any previous one for this document.
+ *
+ * Returns false when storage refused it — the caller carries on editing
+ * either way. Preview snapshots are spent first when the origin is full
+ * (they regenerate on the next Preview click); other documents' drafts only
+ * after that, oldest first.
+ */
+export declare function writeBesignerDraft(ids: BesignerDraftIds, draft: Omit<BesignerDraft, 'updatedAt'>, now?: number): boolean;
+/**
+ * Reads this document's draft, or null when there is none, it is unreadable,
+ * or it has aged out. An expired draft is removed on the way past, so the
+ * store self-prunes on the path everyone takes.
+ */
+export declare function readBesignerDraft(ids: BesignerDraftIds, now?: number): BesignerDraft | null;
+export declare function clearBesignerDraft(ids: BesignerDraftIds): void;
+/** Drops every expired draft, whichever document it belongs to. */
+export declare function pruneBesignerDrafts(now?: number): string[];