@aglyn/besigner-ui 1.0.0-beta.143

package/src/lib/components/besigner-conflict-alert.component.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/besigner/feature/designer/src/lib/components/besigner-conflict-alert.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\nimport { Alert, Button } from '@mui/material'\n\nexport interface BesignerConflictAlertProps {\n  /** 'screen', 'layout', 'component', 'template', 'email'. */\n  noun: string\n}\n\n/**\n * The concurrent-save conflict banner (AGL-1301): someone else saved this\n * document while the author was editing, so saving is paused until they\n * reload. Shown as soon as the remote save lands, not on Save — finding\n * out after twenty more minutes of editing is the bad version of this\n * (AGL-674).\n *\n * One component for every besigner editor so the copy names the document\n * kind the author is actually in — the AGL-1301 adoption copy-pasted the\n * banner per page and two editors kept another page's noun. The single\n * action is Reload, deliberately: there is no \"save anyway\" that could\n * silently destroy a teammate's work, and the canvas keeps everything\n * until the reload.\n */\nexport function BesignerConflictAlertComponent(\n  props: BesignerConflictAlertProps,\n) {\n  const { noun } = props\n  return (\n    <Alert\n      severity=\"warning\"\n      sx={{ borderRadius: 0, position: 'relative', zIndex: 'appBar' }}\n      action={\n        <Button\n          color=\"inherit\"\n          size=\"small\"\n          onClick={() => window.location.reload()}\n        >\n          {'Reload'}\n        </Button>\n      }\n    >\n      {`Someone else saved this ${noun} while you were editing. ` +\n        'Saving is paused so their work is not overwritten — ' +\n        'reload to pick up their changes. Nothing you have done ' +\n        'here is lost until you do.'}\n    </Alert>\n  )\n}\n\nexport default BesignerConflictAlertComponent\n"],"names":["Alert","Button","BesignerConflictAlertComponent","props","noun","severity","sx","borderRadius","position","zIndex","action","color","size","onClick","window","location","reload"],"mappings":";AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,KAAK,EAAEC,MAAM,QAAQ,gBAAe;AAO7C;;;;;;;;;;;;;CAaC,GACD,OAAO,SAASC,+BACdC,KAAiC;IAEjC,MAAM,EAAEC,IAAI,EAAE,GAAGD;IACjB,qBACE,KAACH;QACCK,UAAS;QACTC,IAAI;YAAEC,cAAc;YAAGC,UAAU;YAAYC,QAAQ;QAAS;QAC9DC,sBACE,KAACT;YACCU,OAAM;YACNC,MAAK;YACLC,SAAS,IAAMC,OAAOC,QAAQ,CAACC,MAAM;sBAEpC;;kBAIJ,CAAC,wBAAwB,EAAEZ,KAAK,yBAAyB,CAAC,GACzD,yDACA,4DACA;;AAGR;AAEA,eAAeF,+BAA8B"}

package/src/lib/components/besigner-dnd-context.component.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @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 { Modifier } from '@dnd-kit/core';
+import type { BackendFactory } from 'dnd-core';
+export declare const snapDraggingToCursor: Modifier;
+export interface BesignerDndContextProps<BackendContext, BackendOptions> {
+    children?: JSX.Children;
+    backend?: BackendFactory;
+    context?: BackendContext;
+    options?: BackendOptions;
+    debugMode?: boolean;
+}
+export declare function BesignerDndContext<T, U>(props: BesignerDndContextProps<T, U>): import("react").JSX.Element;
+export declare namespace BesignerDndContext {
+    var displayName: string;
+    var aglyn: boolean;
+}
+export default BesignerDndContext;

package/src/lib/components/besigner-dnd-context.component.js

@@ -0,0 +1,75 @@
+/**
+ * @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 { _ as _extends } from "@swc/helpers/_/_extends";
+import { _ as _object_without_properties_loose } from "@swc/helpers/_/_object_without_properties_loose";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { DndContext, KeyboardSensor, MeasuringStrategy, MouseSensor, PointerSensor, pointerWithin, TouchSensor, useSensor, useSensors } from "@dnd-kit/core";
+import { getEventCoordinates } from "@dnd-kit/utilities";
+import { DndProvider } from "react-dnd";
+import { HTML5Backend } from "react-dnd-html5-backend";
+export const snapDraggingToCursor = ({ activatorEvent, draggingNodeRect, transform })=>{
+    if (draggingNodeRect && activatorEvent) {
+        const activatorCoordinates = getEventCoordinates(activatorEvent);
+        if (!activatorCoordinates) return transform;
+        const offsetX = activatorCoordinates.x - draggingNodeRect.left;
+        const offsetY = activatorCoordinates.y - draggingNodeRect.top;
+        return _extends({}, transform, {
+            x: transform.x + offsetX + 2,
+            y: transform.y + offsetY + 2
+        });
+    }
+    return transform;
+};
+export function BesignerDndContext(props) {
+    const { children, options } = props, rest = _object_without_properties_loose(props, [
+        "children",
+        "options"
+    ]);
+    const opts = _extends({
+        enableTouchEvents: true,
+        enableMouseEvents: true,
+        enableKeyboardEvents: true,
+        delay: 0,
+        delayTouchStart: 0,
+        delayMouseStart: 0,
+        touchSlop: 0
+    }, options);
+    const sensors = useSensors(useSensor(MouseSensor), useSensor(PointerSensor), useSensor(TouchSensor), useSensor(KeyboardSensor));
+    return /*#__PURE__*/ _jsx(DndProvider, _extends({
+        backend: HTML5Backend,
+        options: opts
+    }, rest, {
+        debugMode: true,
+        children: /*#__PURE__*/ _jsx(DndContext, {
+            sensors: sensors,
+            modifiers: [
+                snapDraggingToCursor
+            ],
+            collisionDetection: pointerWithin,
+            measuring: {
+                droppable: {
+                    strategy: MeasuringStrategy.Always
+                }
+            },
+            children: children
+        })
+    }));
+}
+BesignerDndContext.displayName = 'BesignerDndContext';
+BesignerDndContext.aglyn = true;
+export default BesignerDndContext;
+
+//# sourceMappingURL=besigner-dnd-context.component.js.map

package/src/lib/components/besigner-dnd-context.component.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/besigner/feature/designer/src/lib/components/besigner-dnd-context.component.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 { Modifier } from '@dnd-kit/core'\nimport {\n  DndContext,\n  KeyboardSensor,\n  MeasuringStrategy,\n  MouseSensor,\n  PointerSensor,\n  pointerWithin,\n  TouchSensor,\n  useSensor,\n  useSensors,\n} from '@dnd-kit/core'\nimport { getEventCoordinates } from '@dnd-kit/utilities'\nimport type { BackendFactory } from 'dnd-core'\nimport { DndProvider } from 'react-dnd'\nimport { HTML5Backend } from 'react-dnd-html5-backend'\n\nexport const snapDraggingToCursor: Modifier = ({\n  activatorEvent,\n  draggingNodeRect,\n  transform,\n}) => {\n  if (draggingNodeRect && activatorEvent) {\n    const activatorCoordinates = getEventCoordinates(activatorEvent)\n    if (!activatorCoordinates) return transform\n\n    const offsetX = activatorCoordinates.x - draggingNodeRect.left\n    const offsetY = activatorCoordinates.y - draggingNodeRect.top\n\n    return {\n      ...transform,\n      x: transform.x + offsetX + 2,\n      y: transform.y + offsetY + 2,\n    }\n  }\n\n  return transform\n}\nexport interface BesignerDndContextProps<BackendContext, BackendOptions> {\n  children?: JSX.Children\n  backend?: BackendFactory\n  context?: BackendContext\n  options?: BackendOptions\n  debugMode?: boolean\n}\n\nexport function BesignerDndContext<T, U>(props: BesignerDndContextProps<T, U>) {\n  const { children, options, ...rest } = props\n  const opts = {\n    enableTouchEvents: true,\n    enableMouseEvents: true,\n    enableKeyboardEvents: true,\n    delay: 0,\n    delayTouchStart: 0,\n    delayMouseStart: 0,\n    touchSlop: 0,\n    ...options,\n  }\n\n  const sensors = useSensors(\n    useSensor(MouseSensor),\n    useSensor(PointerSensor),\n    useSensor(TouchSensor),\n    useSensor(KeyboardSensor),\n  )\n\n  return (\n    <DndProvider backend={HTML5Backend} options={opts} {...rest} debugMode>\n      <DndContext\n        sensors={sensors}\n        modifiers={[snapDraggingToCursor]}\n        collisionDetection={pointerWithin}\n        measuring={{\n          droppable: {\n            strategy: MeasuringStrategy.Always,\n          },\n        }}\n      >\n        {children}\n      </DndContext>\n    </DndProvider>\n  )\n}\nBesignerDndContext.displayName = 'BesignerDndContext'\nBesignerDndContext.aglyn = true\n\nexport default BesignerDndContext\n"],"names":["DndContext","KeyboardSensor","MeasuringStrategy","MouseSensor","PointerSensor","pointerWithin","TouchSensor","useSensor","useSensors","getEventCoordinates","DndProvider","HTML5Backend","snapDraggingToCursor","activatorEvent","draggingNodeRect","transform","activatorCoordinates","offsetX","x","left","offsetY","y","top","BesignerDndContext","props","children","options","rest","opts","enableTouchEvents","enableMouseEvents","enableKeyboardEvents","delay","delayTouchStart","delayMouseStart","touchSlop","sensors","backend","debugMode","modifiers","collisionDetection","measuring","droppable","strategy","Always","displayName","aglyn"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC;;;AAGD,SACEA,UAAU,EACVC,cAAc,EACdC,iBAAiB,EACjBC,WAAW,EACXC,aAAa,EACbC,aAAa,EACbC,WAAW,EACXC,SAAS,EACTC,UAAU,QACL,gBAAe;AACtB,SAASC,mBAAmB,QAAQ,qBAAoB;AAExD,SAASC,WAAW,QAAQ,YAAW;AACvC,SAASC,YAAY,QAAQ,0BAAyB;AAEtD,OAAO,MAAMC,uBAAiC,CAAC,EAC7CC,cAAc,EACdC,gBAAgB,EAChBC,SAAS,EACV;IACC,IAAID,oBAAoBD,gBAAgB;QACtC,MAAMG,uBAAuBP,oBAAoBI;QACjD,IAAI,CAACG,sBAAsB,OAAOD;QAElC,MAAME,UAAUD,qBAAqBE,CAAC,GAAGJ,iBAAiBK,IAAI;QAC9D,MAAMC,UAAUJ,qBAAqBK,CAAC,GAAGP,iBAAiBQ,GAAG;QAE7D,OAAO,aACFP;YACHG,GAAGH,UAAUG,CAAC,GAAGD,UAAU;YAC3BI,GAAGN,UAAUM,CAAC,GAAGD,UAAU;;IAE/B;IAEA,OAAOL;AACT,EAAC;AASD,OAAO,SAASQ,mBAAyBC,KAAoC;IAC3E,MAAM,EAAEC,QAAQ,EAAEC,OAAO,EAAW,GAAGF,OAATG,wCAASH;;;;IACvC,MAAMI,OAAO;QACXC,mBAAmB;QACnBC,mBAAmB;QACnBC,sBAAsB;QACtBC,OAAO;QACPC,iBAAiB;QACjBC,iBAAiB;QACjBC,WAAW;OACRT;IAGL,MAAMU,UAAU5B,WACdD,UAAUJ,cACVI,UAAUH,gBACVG,UAAUD,cACVC,UAAUN;IAGZ,qBACE,KAACS;QAAY2B,SAAS1B;QAAce,SAASE;OAAUD;QAAMW,SAAS;kBACpE,cAAA,KAACtC;YACCoC,SAASA;YACTG,WAAW;gBAAC3B;aAAqB;YACjC4B,oBAAoBnC;YACpBoC,WAAW;gBACTC,WAAW;oBACTC,UAAUzC,kBAAkB0C,MAAM;gBACpC;YACF;sBAECnB;;;AAIT;AACAF,mBAAmBsB,WAAW,GAAG;AACjCtB,mBAAmBuB,KAAK,GAAG;AAE3B,eAAevB,mBAAkB"}

package/src/lib/components/besigner-draft-alert.component.d.ts

@@ -0,0 +1,70 @@
+/**
+ * @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 { BesignerDraftState } from '../hooks/use-besigner-draft';
+export interface BesignerDraftAlertProps {
+    draft: BesignerDraftState;
+    /** 'screen', 'layout', 'component', 'template', 'email'. */
+    noun: string;
+    /**
+     * Someone else saved this document since it loaded, i.e. what
+     * `BesignerConflictAlertComponent` says on its own (AGL-2486).
+     *
+     * Passed in so ONE banner covers the condition. Stacked, the two describe a
+     * single event — a colleague's save — in two voices, and reassure in
+     * opposite directions. An editor that renders this alert must render the
+     * conflict alert only while this one is absent.
+     */
+    remoteChanged?: boolean;
+}
+/** "3 minutes ago" — coarse on purpose; the exact second helps nobody. */
+export declare function describeDraftAge(takenAt: number | null, now: number): string;
+/**
+ * The message this alert carries, given what the draft can and cannot do.
+ *
+ * Exported for its spec: the copy is the product decision in AGL-2486 —
+ * which of two "unsaved" states the author is looking at, and whether the
+ * one in this browser may still be put back — so it is asserted directly
+ * rather than through a rendered tree.
+ */
+export declare function describeDraftOffer(draft: BesignerDraftState, noun: string, now: number, remoteChanged?: boolean): string;
+/**
+ * Offers back unsaved work a crash or reload took away (AGL-1256), and says
+ * when it may not be offered (AGL-2486).
+ *
+ * It asks rather than restoring on its own. Silently replacing a document
+ * with a local snapshot would be a worse bug than the one being fixed — and
+ * the author is the only one who knows whether the version they are looking
+ * at is the one they meant to be in.
+ *
+ * When the room is SHARED this banner does not render at all. Discard never
+ * touches the canvas, so nothing anybody is looking at changes when it is
+ * pressed — but it does delete the draft, in both stores, and a prompt whose
+ * only remaining button is a delete, over a document several people are
+ * mid-edit in, is a question that should not be asked. See `roomIsShared` in
+ * `use-besigner-draft`.
+ *
+ * What is left here is the case where this editor is alone and something
+ * still stands in the way of a restore: a colleague SAVED while the draft
+ * was stranded, or the mirror replayed work onto the canvas while presence
+ * could not report the room. Restoring is a whole-map replace that the
+ * co-edit mirror publishes verbatim, so the older "restoring will not
+ * overwrite their work" was not true from the colleague's side of the
+ * screen: their unsaved node was deleted on their own canvas, and a stale
+ * restore survived the reload this banner asks for.
+ */
+export declare function BesignerDraftAlertComponent(props: BesignerDraftAlertProps): import("react").JSX.Element;
+export default BesignerDraftAlertComponent;

package/src/lib/components/besigner-draft-alert.component.js

@@ -0,0 +1,155 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * @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 { Alert, Button, Stack } from "@mui/material";
+/** "3 minutes ago" — coarse on purpose; the exact second helps nobody. */ export function describeDraftAge(takenAt, now) {
+    if (!takenAt) return 'a moment ago';
+    const minutes = Math.floor(Math.max(0, now - takenAt) / 60000);
+    if (minutes < 1) return 'less than a minute ago';
+    if (minutes === 1) return '1 minute ago';
+    if (minutes < 60) return `${minutes} minutes ago`;
+    const hours = Math.round(minutes / 60);
+    if (hours === 1) return 'about an hour ago';
+    if (hours < 24) return `about ${hours} hours ago`;
+    const days = Math.round(hours / 24);
+    return days === 1 ? 'about a day ago' : `about ${days} days ago`;
+}
+/**
+ * The message this alert carries, given what the draft can and cannot do.
+ *
+ * Exported for its spec: the copy is the product decision in AGL-2486 —
+ * which of two "unsaved" states the author is looking at, and whether the
+ * one in this browser may still be put back — so it is asserted directly
+ * rather than through a rendered tree.
+ */ export function describeDraftOffer(draft, noun, now, remoteChanged = false) {
+    const age = describeDraftAge(draft.takenAt, now);
+    /**
+   * A saved draft whose store recorded no time names no age: "a moment ago"
+   * would claim a recency nobody measured, and a stranded draft described as
+   * brand new reads as somebody's work in progress (AGL-2868).
+   */ const savedFrom = draft.takenAt ? ` from ${age}` : '';
+    /**
+   * The SHARED working draft is a different sentence from the crash net, and
+   * saying the crash net's one over it is the AGL-2508 defect: an author who
+   * pressed Save draft, was told "Draft saved", and came back to
+   * "Unsaved changes … were recovered from this browser" reads a save that
+   * failed and a browser that rescued them. Both halves are wrong — it saved,
+   * and it is on the server — and the reasonable conclusion is that the
+   * editor loses work, which sends people re-doing edits they already have.
+   *
+   * The canvas loads the stored document and the draft is OFFERED rather than
+   * applied, which is the right call and is not what changes here. What
+   * changes is that the offer now says which of the two it is.
+   */ const found = draft.origin === 'shared' ? `This ${noun} has a saved draft${savedFrom} that has not been ` + 'published. It is stored with the site, so anyone who opens this ' + `${noun} sees it offered. ` : `Unsaved changes to this ${noun} from ${age} were recovered from ` + 'this browser. ';
+    switch(draft.restoreBlockedBy){
+        case 'saved-since':
+            /*
+       * A SAVED draft the document has moved past (AGL-2874). The crash-net
+       * sentences below speak of unsaved changes in this browser, and a saved
+       * draft is neither (AGL-2508). What the author needs instead is that it
+       * cannot be opened and that Discard is what stops it being offered.
+       */ if (draft.origin === 'shared') {
+                return `This ${noun} has a saved draft${savedFrom}, but the ${noun} has ` + 'been saved since it was taken, so opening it would undo that save ' + '— it can no longer be opened. ' + (remoteChanged ? `Someone else has also saved this ${noun} since it loaded, so ` + 'saving is paused until you reload.' : 'Discard it once nobody needs it; nothing else is affected.');
+            }
+            // Whether saving is PAUSED is a different fact from whether the draft
+            // may be put back, and only `remoteChanged` can answer it. A draft
+            // stranded by a save that landed before this editor even opened blocks
+            // nothing: the canvas holds the stored document, Save works, and there
+            // is no conflict to reload out of. Claiming otherwise sent authors
+            // reloading a document nobody had touched in days, looking for a
+            // colleague who was not there.
+            if (!remoteChanged) {
+                return `This ${noun} has been saved since the unsaved changes from ${age} ` + 'in this browser were taken, so putting them back would undo that ' + 'save — they are not offered. Nothing else is affected: this ' + 'canvas holds the saved document and saving works as usual.';
+            }
+            // One banner for one event. The conflict half comes first because it
+            // is the thing that already happened; the draft half is what the
+            // author is being told they cannot do about it.
+            return `Someone else saved this ${noun} while you were editing, so saving ` + 'is paused until you reload — nothing on this canvas is lost until ' + `then. Unsaved changes from ${age} were also found in this browser, ` + 'but they pre-date their save: putting them back would roll it ' + 'back, so they are not offered.';
+        default:
+            return found + (remoteChanged ? `Someone else has also saved this ${noun} since it loaded, so ` + 'saving is paused until you reload. Restoring puts your changes ' + 'back on the canvas without saving; you can undo it.' : draft.origin === 'shared' ? 'Opening it puts it back on the canvas; publish when you are ' + 'ready, or discard it to go back to what is live.' : 'Restoring puts them back on the canvas without saving; you ' + 'can undo it.');
+    }
+}
+/**
+ * Offers back unsaved work a crash or reload took away (AGL-1256), and says
+ * when it may not be offered (AGL-2486).
+ *
+ * It asks rather than restoring on its own. Silently replacing a document
+ * with a local snapshot would be a worse bug than the one being fixed — and
+ * the author is the only one who knows whether the version they are looking
+ * at is the one they meant to be in.
+ *
+ * When the room is SHARED this banner does not render at all. Discard never
+ * touches the canvas, so nothing anybody is looking at changes when it is
+ * pressed — but it does delete the draft, in both stores, and a prompt whose
+ * only remaining button is a delete, over a document several people are
+ * mid-edit in, is a question that should not be asked. See `roomIsShared` in
+ * `use-besigner-draft`.
+ *
+ * What is left here is the case where this editor is alone and something
+ * still stands in the way of a restore: a colleague SAVED while the draft
+ * was stranded, or the mirror replayed work onto the canvas while presence
+ * could not report the room. Restoring is a whole-map replace that the
+ * co-edit mirror publishes verbatim, so the older "restoring will not
+ * overwrite their work" was not true from the colleague's side of the
+ * screen: their unsaved node was deleted on their own canvas, and a stale
+ * restore survived the reload this banner asks for.
+ */ export function BesignerDraftAlertComponent(props) {
+    const { draft, noun, remoteChanged = false } = props;
+    if (!draft.available) return null;
+    const blocked = draft.restoreBlockedBy !== null;
+    // The reload is the way out of a CONFLICT, so it is offered exactly while
+    // this banner is standing in for the conflict one. A stranded draft with no
+    // conflict behind it has nothing to reload for — the canvas already holds
+    // the stored document — and a Reload button there reads as an instruction
+    // to fix something that is not broken.
+    const offerReload = remoteChanged;
+    return /*#__PURE__*/ _jsx(Alert, {
+        severity: blocked || remoteChanged ? 'warning' : 'info',
+        sx: {
+            borderRadius: 0,
+            position: 'relative',
+            zIndex: 'appBar'
+        },
+        action: /*#__PURE__*/ _jsxs(Stack, {
+            direction: "row",
+            spacing: 1,
+            children: [
+                offerReload ? /*#__PURE__*/ _jsx(Button, {
+                    color: "inherit",
+                    size: "small",
+                    onClick: ()=>window.location.reload(),
+                    children: 'Reload'
+                }) : null,
+                blocked ? null : /*#__PURE__*/ _jsx(Button, {
+                    color: "inherit",
+                    size: "small",
+                    onClick: draft.restore,
+                    children: draft.origin === 'shared' ? 'Open draft' : 'Restore'
+                }),
+                /*#__PURE__*/ _jsx(Button, {
+                    color: "inherit",
+                    size: "small",
+                    onClick: draft.discard,
+                    children: 'Discard'
+                })
+            ]
+        }),
+        children: describeDraftOffer(draft, noun, Date.now(), remoteChanged)
+    });
+}
+export default BesignerDraftAlertComponent;
+
+//# sourceMappingURL=besigner-draft-alert.component.js.map

package/src/lib/components/besigner-draft-alert.component.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/besigner/feature/designer/src/lib/components/besigner-draft-alert.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\nimport { Alert, Button, Stack } from '@mui/material'\nimport type { BesignerDraftState } from '../hooks/use-besigner-draft'\n\nexport interface BesignerDraftAlertProps {\n  draft: BesignerDraftState\n  /** 'screen', 'layout', 'component', 'template', 'email'. */\n  noun: string\n  /**\n   * Someone else saved this document since it loaded, i.e. what\n   * `BesignerConflictAlertComponent` says on its own (AGL-2486).\n   *\n   * Passed in so ONE banner covers the condition. Stacked, the two describe a\n   * single event — a colleague's save — in two voices, and reassure in\n   * opposite directions. An editor that renders this alert must render the\n   * conflict alert only while this one is absent.\n   */\n  remoteChanged?: boolean\n}\n\n/** \"3 minutes ago\" — coarse on purpose; the exact second helps nobody. */\nexport function describeDraftAge(takenAt: number | null, now: number): string {\n  if (!takenAt) return 'a moment ago'\n  const minutes = Math.floor(Math.max(0, now - takenAt) / 60_000)\n  if (minutes < 1) return 'less than a minute ago'\n  if (minutes === 1) return '1 minute ago'\n  if (minutes < 60) return `${minutes} minutes ago`\n  const hours = Math.round(minutes / 60)\n  if (hours === 1) return 'about an hour ago'\n  if (hours < 24) return `about ${hours} hours ago`\n  const days = Math.round(hours / 24)\n  return days === 1 ? 'about a day ago' : `about ${days} days ago`\n}\n\n/**\n * The message this alert carries, given what the draft can and cannot do.\n *\n * Exported for its spec: the copy is the product decision in AGL-2486 —\n * which of two \"unsaved\" states the author is looking at, and whether the\n * one in this browser may still be put back — so it is asserted directly\n * rather than through a rendered tree.\n */\nexport function describeDraftOffer(\n  draft: BesignerDraftState,\n  noun: string,\n  now: number,\n  remoteChanged = false,\n): string {\n  const age = describeDraftAge(draft.takenAt, now)\n  /**\n   * A saved draft whose store recorded no time names no age: \"a moment ago\"\n   * would claim a recency nobody measured, and a stranded draft described as\n   * brand new reads as somebody's work in progress (AGL-2868).\n   */\n  const savedFrom = draft.takenAt ? ` from ${age}` : ''\n  /**\n   * The SHARED working draft is a different sentence from the crash net, and\n   * saying the crash net's one over it is the AGL-2508 defect: an author who\n   * pressed Save draft, was told \"Draft saved\", and came back to\n   * \"Unsaved changes … were recovered from this browser\" reads a save that\n   * failed and a browser that rescued them. Both halves are wrong — it saved,\n   * and it is on the server — and the reasonable conclusion is that the\n   * editor loses work, which sends people re-doing edits they already have.\n   *\n   * The canvas loads the stored document and the draft is OFFERED rather than\n   * applied, which is the right call and is not what changes here. What\n   * changes is that the offer now says which of the two it is.\n   */\n  const found =\n    draft.origin === 'shared'\n      ? `This ${noun} has a saved draft${savedFrom} that has not been ` +\n        'published. It is stored with the site, so anyone who opens this ' +\n        `${noun} sees it offered. `\n      : `Unsaved changes to this ${noun} from ${age} were recovered from ` +\n        'this browser. '\n  switch (draft.restoreBlockedBy) {\n    case 'saved-since':\n      /*\n       * A SAVED draft the document has moved past (AGL-2874). The crash-net\n       * sentences below speak of unsaved changes in this browser, and a saved\n       * draft is neither (AGL-2508). What the author needs instead is that it\n       * cannot be opened and that Discard is what stops it being offered.\n       */\n      if (draft.origin === 'shared') {\n        return (\n          `This ${noun} has a saved draft${savedFrom}, but the ${noun} has ` +\n          'been saved since it was taken, so opening it would undo that save ' +\n          '— it can no longer be opened. ' +\n          (remoteChanged\n            ? `Someone else has also saved this ${noun} since it loaded, so ` +\n              'saving is paused until you reload.'\n            : 'Discard it once nobody needs it; nothing else is affected.')\n        )\n      }\n      // Whether saving is PAUSED is a different fact from whether the draft\n      // may be put back, and only `remoteChanged` can answer it. A draft\n      // stranded by a save that landed before this editor even opened blocks\n      // nothing: the canvas holds the stored document, Save works, and there\n      // is no conflict to reload out of. Claiming otherwise sent authors\n      // reloading a document nobody had touched in days, looking for a\n      // colleague who was not there.\n      if (!remoteChanged) {\n        return (\n          `This ${noun} has been saved since the unsaved changes from ${age} ` +\n          'in this browser were taken, so putting them back would undo that ' +\n          'save — they are not offered. Nothing else is affected: this ' +\n          'canvas holds the saved document and saving works as usual.'\n        )\n      }\n      // One banner for one event. The conflict half comes first because it\n      // is the thing that already happened; the draft half is what the\n      // author is being told they cannot do about it.\n      return (\n        `Someone else saved this ${noun} while you were editing, so saving ` +\n        'is paused until you reload — nothing on this canvas is lost until ' +\n        `then. Unsaved changes from ${age} were also found in this browser, ` +\n        'but they pre-date their save: putting them back would roll it ' +\n        'back, so they are not offered.'\n      )\n    default:\n      return (\n        found +\n        (remoteChanged\n          ? `Someone else has also saved this ${noun} since it loaded, so ` +\n            'saving is paused until you reload. Restoring puts your changes ' +\n            'back on the canvas without saving; you can undo it.'\n          : draft.origin === 'shared'\n            ? 'Opening it puts it back on the canvas; publish when you are ' +\n              'ready, or discard it to go back to what is live.'\n            : 'Restoring puts them back on the canvas without saving; you ' +\n              'can undo it.')\n      )\n  }\n}\n\n/**\n * Offers back unsaved work a crash or reload took away (AGL-1256), and says\n * when it may not be offered (AGL-2486).\n *\n * It asks rather than restoring on its own. Silently replacing a document\n * with a local snapshot would be a worse bug than the one being fixed — and\n * the author is the only one who knows whether the version they are looking\n * at is the one they meant to be in.\n *\n * When the room is SHARED this banner does not render at all. Discard never\n * touches the canvas, so nothing anybody is looking at changes when it is\n * pressed — but it does delete the draft, in both stores, and a prompt whose\n * only remaining button is a delete, over a document several people are\n * mid-edit in, is a question that should not be asked. See `roomIsShared` in\n * `use-besigner-draft`.\n *\n * What is left here is the case where this editor is alone and something\n * still stands in the way of a restore: a colleague SAVED while the draft\n * was stranded, or the mirror replayed work onto the canvas while presence\n * could not report the room. Restoring is a whole-map replace that the\n * co-edit mirror publishes verbatim, so the older \"restoring will not\n * overwrite their work\" was not true from the colleague's side of the\n * screen: their unsaved node was deleted on their own canvas, and a stale\n * restore survived the reload this banner asks for.\n */\nexport function BesignerDraftAlertComponent(props: BesignerDraftAlertProps) {\n  const { draft, noun, remoteChanged = false } = props\n  if (!draft.available) return null\n  const blocked = draft.restoreBlockedBy !== null\n  // The reload is the way out of a CONFLICT, so it is offered exactly while\n  // this banner is standing in for the conflict one. A stranded draft with no\n  // conflict behind it has nothing to reload for — the canvas already holds\n  // the stored document — and a Reload button there reads as an instruction\n  // to fix something that is not broken.\n  const offerReload = remoteChanged\n\n  return (\n    <Alert\n      severity={blocked || remoteChanged ? 'warning' : 'info'}\n      sx={{ borderRadius: 0, position: 'relative', zIndex: 'appBar' }}\n      action={\n        <Stack direction=\"row\" spacing={1}>\n          {offerReload ? (\n            <Button\n              color=\"inherit\"\n              size=\"small\"\n              onClick={() => window.location.reload()}\n            >\n              {'Reload'}\n            </Button>\n          ) : null}\n          {blocked ? null : (\n            <Button color=\"inherit\" size=\"small\" onClick={draft.restore}>\n              {/* A saved draft is OPENED; only unsaved work is restored. */}\n              {draft.origin === 'shared' ? 'Open draft' : 'Restore'}\n            </Button>\n          )}\n          <Button color=\"inherit\" size=\"small\" onClick={draft.discard}>\n            {'Discard'}\n          </Button>\n        </Stack>\n      }\n    >\n      {describeDraftOffer(draft, noun, Date.now(), remoteChanged)}\n    </Alert>\n  )\n}\n\nexport default BesignerDraftAlertComponent\n"],"names":["Alert","Button","Stack","describeDraftAge","takenAt","now","minutes","Math","floor","max","hours","round","days","describeDraftOffer","draft","noun","remoteChanged","age","savedFrom","found","origin","restoreBlockedBy","BesignerDraftAlertComponent","props","available","blocked","offerReload","severity","sx","borderRadius","position","zIndex","action","direction","spacing","color","size","onClick","window","location","reload","restore","discard","Date"],"mappings":"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"}

package/src/lib/components/besigner-root-provider.component.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @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 { AppUUN } from '@aglyn/besigner';
+import { type ComponentType } from 'react';
+export interface BesignerComponentProps {
+    noSsr?: boolean;
+    appName?: AppUUN;
+    children?: JSX.Children;
+}
+export declare const withBesignerContext: <P>(Component: ComponentType<P>) => {
+    (props: BesignerComponentProps & P): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const BesignerRootProviderComponent: {
+    (props: BesignerComponentProps): import("react").JSX.Element;
+    displayName: string;
+    aglyn: boolean;
+};
+export default BesignerRootProviderComponent;

package/src/lib/components/besigner-root-provider.component.js

@@ -0,0 +1,68 @@
+/**
+ * @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 { _ as _extends } from "@swc/helpers/_/_extends";
+import { _ as _object_without_properties_loose } from "@swc/helpers/_/_object_without_properties_loose";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { getDisplayName } from "@aglyn/shared-util-tools";
+import { hoistNonReactStatics } from "@aglyn/shared-util-vendor";
+import { NoSsr } from "@mui/material";
+import { Fragment } from "react";
+import ComponentsDrawerContextProvider from "../contexts/components-drawer-context.provider.js";
+import RenderedCanvasElementsProvider from "../contexts/rendered-canvas-elements.js";
+import { BesignerAppProvider } from "../contexts/besigner-app-context.js";
+import useClipboardShortcuts from "../hooks/use-clipboard-shortcuts.js";
+import BesignerDndContext from "./besigner-dnd-context.component.js";
+export const withBesignerContext = (Component)=>{
+    const displayName = getDisplayName(Component);
+    const WithBesignerContext = (props)=>{
+        const { noSsr, appName } = props, rest = _object_without_properties_loose(props, [
+            "noSsr",
+            "appName"
+        ]);
+        return /*#__PURE__*/ _jsx(BesignerRootProviderComponent, {
+            children: /*#__PURE__*/ _jsx(Component, _extends({}, rest))
+        });
+    };
+    WithBesignerContext.displayName = `WithBesignerComponent(${displayName})`;
+    hoistNonReactStatics(WithBesignerContext, Component);
+    return WithBesignerContext;
+};
+export const BesignerRootProviderComponent = (props)=>{
+    /*forwardRef<any, BesignerComponentProps>(
+ (props, ref) => {*/ const { noSsr, appName, children } = props;
+    const Wrapper = noSsr ? NoSsr : Fragment;
+    // Element copy/paste + select-all (AGL-1202). Bound once here so every
+    // besigner surface — screens, layouts, components, templates, emails —
+    // gets the same shortcuts.
+    useClipboardShortcuts();
+    return /*#__PURE__*/ _jsx(Wrapper, {
+        children: /*#__PURE__*/ _jsx(BesignerAppProvider, {
+            appName: appName,
+            children: /*#__PURE__*/ _jsx(BesignerDndContext, {
+                children: /*#__PURE__*/ _jsx(RenderedCanvasElementsProvider, {
+                    children: /*#__PURE__*/ _jsx(ComponentsDrawerContextProvider, {
+                        children: children
+                    })
+                })
+            })
+        })
+    });
+};
+BesignerRootProviderComponent.displayName = 'BesignerRootProviderComponent';
+BesignerRootProviderComponent.aglyn = true;
+export default BesignerRootProviderComponent;
+
+//# sourceMappingURL=besigner-root-provider.component.js.map

package/src/lib/components/besigner-root-provider.component.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/besigner/feature/designer/src/lib/components/besigner-root-provider.component.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 { AppUUN } from '@aglyn/besigner'\nimport { getDisplayName } from '@aglyn/shared-util-tools'\nimport { hoistNonReactStatics } from '@aglyn/shared-util-vendor'\nimport { NoSsr } from '@mui/material'\nimport { type ComponentType, Fragment } from 'react'\nimport ComponentsDrawerContextProvider from '../contexts/components-drawer-context.provider'\nimport RenderedCanvasElementsProvider from '../contexts/rendered-canvas-elements'\nimport { BesignerAppProvider } from '../contexts/besigner-app-context'\nimport useClipboardShortcuts from '../hooks/use-clipboard-shortcuts'\nimport BesignerDndContext from './besigner-dnd-context.component'\n\nexport interface BesignerComponentProps {\n  noSsr?: boolean\n  appName?: AppUUN\n  children?: JSX.Children\n}\n\nexport const withBesignerContext = <P,>(Component: ComponentType<P>) => {\n  const displayName = getDisplayName(Component)\n  const WithBesignerContext = (props: BesignerComponentProps & P) => {\n    const { noSsr, appName, ...rest } = props\n    return (\n      <BesignerRootProviderComponent>\n        <Component {...(rest as P)} />\n      </BesignerRootProviderComponent>\n    )\n  }\n  WithBesignerContext.displayName = `WithBesignerComponent(${displayName})`\n  hoistNonReactStatics(WithBesignerContext, Component)\n  return WithBesignerContext\n}\n\nexport const BesignerRootProviderComponent = (\n  props: BesignerComponentProps,\n) => {\n  /*forwardRef<any, BesignerComponentProps>(\n (props, ref) => {*/\n  const { noSsr, appName, children } = props\n  const Wrapper = noSsr ? NoSsr : Fragment\n\n  // Element copy/paste + select-all (AGL-1202). Bound once here so every\n  // besigner surface — screens, layouts, components, templates, emails —\n  // gets the same shortcuts.\n  useClipboardShortcuts()\n\n  return (\n    <Wrapper>\n      <BesignerAppProvider appName={appName}>\n        <BesignerDndContext>\n          <RenderedCanvasElementsProvider>\n            <ComponentsDrawerContextProvider>\n              {children}\n            </ComponentsDrawerContextProvider>\n          </RenderedCanvasElementsProvider>\n        </BesignerDndContext>\n      </BesignerAppProvider>\n    </Wrapper>\n  )\n}\n\nBesignerRootProviderComponent.displayName = 'BesignerRootProviderComponent'\nBesignerRootProviderComponent.aglyn = true\n\nexport default BesignerRootProviderComponent\n"],"names":["getDisplayName","hoistNonReactStatics","NoSsr","Fragment","ComponentsDrawerContextProvider","RenderedCanvasElementsProvider","BesignerAppProvider","useClipboardShortcuts","BesignerDndContext","withBesignerContext","Component","displayName","WithBesignerContext","props","noSsr","appName","rest","BesignerRootProviderComponent","children","Wrapper","aglyn"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC;;;AAGD,SAASA,cAAc,QAAQ,2BAA0B;AACzD,SAASC,oBAAoB,QAAQ,4BAA2B;AAChE,SAASC,KAAK,QAAQ,gBAAe;AACrC,SAA6BC,QAAQ,QAAQ,QAAO;AACpD,OAAOC,qCAAqC,oDAAgD;AAC5F,OAAOC,oCAAoC,0CAAsC;AACjF,SAASC,mBAAmB,QAAQ,sCAAkC;AACtE,OAAOC,2BAA2B,sCAAkC;AACpE,OAAOC,wBAAwB,sCAAkC;AAQjE,OAAO,MAAMC,sBAAsB,CAAKC;IACtC,MAAMC,cAAcX,eAAeU;IACnC,MAAME,sBAAsB,CAACC;QAC3B,MAAM,EAAEC,KAAK,EAAEC,OAAO,EAAW,GAAGF,OAATG,wCAASH;;;;QACpC,qBACE,KAACI;sBACC,cAAA,KAACP,wBAAeM;;IAGtB;IACAJ,oBAAoBD,WAAW,GAAG,CAAC,sBAAsB,EAAEA,YAAY,CAAC,CAAC;IACzEV,qBAAqBW,qBAAqBF;IAC1C,OAAOE;AACT,EAAC;AAED,OAAO,MAAMK,gCAAgC,CAC3CJ;IAEA;kBACgB,GAChB,MAAM,EAAEC,KAAK,EAAEC,OAAO,EAAEG,QAAQ,EAAE,GAAGL;IACrC,MAAMM,UAAUL,QAAQZ,QAAQC;IAEhC,uEAAuE;IACvE,uEAAuE;IACvE,2BAA2B;IAC3BI;IAEA,qBACE,KAACY;kBACC,cAAA,KAACb;YAAoBS,SAASA;sBAC5B,cAAA,KAACP;0BACC,cAAA,KAACH;8BACC,cAAA,KAACD;kCACEc;;;;;;AAOf,EAAC;AAEDD,8BAA8BN,WAAW,GAAG;AAC5CM,8BAA8BG,KAAK,GAAG;AAEtC,eAAeH,8BAA6B"}

package/src/lib/components/binding-preview-controls.component.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @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 IconButtonProps as MuiIconButtonProps } from '@mui/material';
+export interface BindingPreviewControlsProps extends Partial<MuiIconButtonProps> {
+}
+/**
+ * WYSIWYG bindings toggle (AGL-97): the canvas resolves variable, function
+ * and host variable tokens live by default; this switches to raw tokens for
+ * editing clarity. Hidden when the host app provides nothing to resolve
+ * with — no variables, no functions, and no site for `{{host.*}}` (AGL-2881).
+ */
+declare const BindingPreviewControlsComponent: import("react").ForwardRefExoticComponent<Omit<BindingPreviewControlsProps, "ref"> & import("react").RefAttributes<any>>;
+export { BindingPreviewControlsComponent };
+export default BindingPreviewControlsComponent;

package/src/lib/components/binding-preview-controls.component.js

@@ -0,0 +1,63 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * @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 { mdiCodeBraces } from "@aglyn/shared-data-mdi";
+import { MdiIcon } from "@aglyn/shared-ui-jsx";
+import { IconButton as MuiIconButton, Tooltip as MuiTooltip } from "@mui/material";
+import { forwardRef, useCallback, useContext } from "react";
+import BindingPickerContext from "../contexts/binding-picker-context.js";
+import useAglynBesignerFlag from "../hooks/use-aglyn-besigner-flag.js";
+/**
+ * WYSIWYG bindings toggle (AGL-97): the canvas resolves variable, function
+ * and host variable tokens live by default; this switches to raw tokens for
+ * editing clarity. Hidden when the host app provides nothing to resolve
+ * with — no variables, no functions, and no site for `{{host.*}}` (AGL-2881).
+ */ const BindingPreviewControlsComponent = /*#__PURE__*/ forwardRef((props, ref)=>{
+    const {} = props, rest = _extends({}, props);
+    const [resolveFlag, setResolveFlag] = useAglynBesignerFlag('resolveBindings');
+    const { variables, functions, host } = useContext(BindingPickerContext);
+    const showingRaw = resolveFlag === false;
+    const handleToggle = useCallback(()=>{
+        setResolveFlag((prev)=>prev === false);
+    }, [
+        setResolveFlag
+    ]);
+    if (!Object.keys(variables != null ? variables : {}).length && !Object.keys(functions != null ? functions : {}).length && !host) {
+        return null;
+    }
+    return /*#__PURE__*/ _jsx(MuiTooltip, {
+        title: showingRaw ? 'Show resolved binding values on the artboard' : 'Show raw binding tokens on the artboard',
+        children: /*#__PURE__*/ _jsx(MuiIconButton, _extends({
+            ref: ref,
+            "aria-label": "toggle binding resolution",
+            size: "small",
+            color: showingRaw ? 'primary' : 'inherit',
+            onClick: handleToggle
+        }, rest, {
+            children: /*#__PURE__*/ _jsx(MdiIcon, {
+                fontSize: "inherit",
+                path: mdiCodeBraces.path
+            })
+        }))
+    });
+});
+BindingPreviewControlsComponent.displayName = 'BindingPreviewControlsComponent';
+BindingPreviewControlsComponent.aglyn = true;
+export { BindingPreviewControlsComponent };
+export default BindingPreviewControlsComponent;
+
+//# sourceMappingURL=binding-preview-controls.component.js.map

package/src/lib/components/binding-preview-controls.component.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/besigner/feature/designer/src/lib/components/binding-preview-controls.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\nimport { mdiCodeBraces } from '@aglyn/shared-data-mdi'\nimport { MdiIcon } from '@aglyn/shared-ui-jsx'\nimport {\n  IconButton as MuiIconButton,\n  type IconButtonProps as MuiIconButtonProps,\n  Tooltip as MuiTooltip,\n} from '@mui/material'\nimport { forwardRef, useCallback, useContext } from 'react'\nimport BindingPickerContext from '../contexts/binding-picker-context'\nimport useAglynBesignerFlag from '../hooks/use-aglyn-besigner-flag'\n\nexport interface BindingPreviewControlsProps\n  extends Partial<MuiIconButtonProps> {}\n\n/**\n * WYSIWYG bindings toggle (AGL-97): the canvas resolves variable, function\n * and host variable tokens live by default; this switches to raw tokens for\n * editing clarity. Hidden when the host app provides nothing to resolve\n * with — no variables, no functions, and no site for `{{host.*}}` (AGL-2881).\n */\nconst BindingPreviewControlsComponent = forwardRef<\n  any,\n  BindingPreviewControlsProps\n>((props, ref) => {\n  const { ...rest } = props\n  const [resolveFlag, setResolveFlag] =\n    useAglynBesignerFlag('resolveBindings')\n  const { variables, functions, host } = useContext(BindingPickerContext)\n  const showingRaw = resolveFlag === false\n\n  const handleToggle = useCallback(() => {\n    setResolveFlag((prev) => prev === false)\n  }, [setResolveFlag])\n\n  if (\n    !Object.keys(variables ?? {}).length &&\n    !Object.keys(functions ?? {}).length &&\n    !host\n  ) {\n    return null\n  }\n\n  return (\n    <MuiTooltip\n      title={\n        showingRaw\n          ? 'Show resolved binding values on the artboard'\n          : 'Show raw binding tokens on the artboard'\n      }\n    >\n      <MuiIconButton\n        ref={ref}\n        aria-label=\"toggle binding resolution\"\n        size=\"small\"\n        color={showingRaw ? 'primary' : 'inherit'}\n        onClick={handleToggle}\n        {...rest}\n      >\n        <MdiIcon fontSize=\"inherit\" path={mdiCodeBraces.path} />\n      </MuiIconButton>\n    </MuiTooltip>\n  )\n})\nBindingPreviewControlsComponent.displayName = 'BindingPreviewControlsComponent'\nBindingPreviewControlsComponent.aglyn = true\n\nexport { BindingPreviewControlsComponent }\nexport default BindingPreviewControlsComponent\n"],"names":["mdiCodeBraces","MdiIcon","IconButton","MuiIconButton","Tooltip","MuiTooltip","forwardRef","useCallback","useContext","BindingPickerContext","useAglynBesignerFlag","BindingPreviewControlsComponent","props","ref","rest","resolveFlag","setResolveFlag","variables","functions","host","showingRaw","handleToggle","prev","Object","keys","length","title","aria-label","size","color","onClick","fontSize","path","displayName","aglyn"],"mappings":";;AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,aAAa,QAAQ,yBAAwB;AACtD,SAASC,OAAO,QAAQ,uBAAsB;AAC9C,SACEC,cAAcC,aAAa,EAE3BC,WAAWC,UAAU,QAChB,gBAAe;AACtB,SAASC,UAAU,EAAEC,WAAW,EAAEC,UAAU,QAAQ,QAAO;AAC3D,OAAOC,0BAA0B,wCAAoC;AACrE,OAAOC,0BAA0B,sCAAkC;AAKnE;;;;;CAKC,GACD,MAAMC,gDAAkCL,WAGtC,CAACM,OAAOC;IACR,MAAM,EAAW,GAAGD,OAATE,oBAASF;IACpB,MAAM,CAACG,aAAaC,eAAe,GACjCN,qBAAqB;IACvB,MAAM,EAAEO,SAAS,EAAEC,SAAS,EAAEC,IAAI,EAAE,GAAGX,WAAWC;IAClD,MAAMW,aAAaL,gBAAgB;IAEnC,MAAMM,eAAed,YAAY;QAC/BS,eAAe,CAACM,OAASA,SAAS;IACpC,GAAG;QAACN;KAAe;IAEnB,IACE,CAACO,OAAOC,IAAI,CAACP,oBAAAA,YAAa,CAAC,GAAGQ,MAAM,IACpC,CAACF,OAAOC,IAAI,CAACN,oBAAAA,YAAa,CAAC,GAAGO,MAAM,IACpC,CAACN,MACD;QACA,OAAO;IACT;IAEA,qBACE,KAACd;QACCqB,OACEN,aACI,iDACA;kBAGN,cAAA,KAACjB;YACCU,KAAKA;YACLc,cAAW;YACXC,MAAK;YACLC,OAAOT,aAAa,YAAY;YAChCU,SAAST;WACLP;sBAEJ,cAAA,KAACb;gBAAQ8B,UAAS;gBAAUC,MAAMhC,cAAcgC,IAAI;;;;AAI5D;AACArB,gCAAgCsB,WAAW,GAAG;AAC9CtB,gCAAgCuB,KAAK,GAAG;AAExC,SAASvB,+BAA+B,GAAE;AAC1C,eAAeA,gCAA+B"}