@aglyn/besigner 1.0.0-beta.143

package/src/lib/clipboard-manager/clipboard-manager.d.ts

@@ -0,0 +1,89 @@
+/**
+ * @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 * as Aglyn from '@aglyn/aglyn';
+/**
+ * Besigner element clipboard (AGL-1202): copy an element — or a whole
+ * multi-selection — and paste it somewhere else, including into a
+ * *different document*.
+ *
+ * Cross-document paste is the point. Duplicate already covers "another one
+ * of these, right here"; what it cannot do is carry a built column out of
+ * the nav component and into the footer component, or lift a finished
+ * section off one screen onto another. So the clipboard holds detached
+ * nested JSON (never live nodes) and mirrors itself into `localStorage`,
+ * which is what lets it survive the full page navigation between two
+ * besigner documents.
+ *
+ * A MobX store, mirroring the focus-manager seam, so menus observing
+ * {@link hasContent} re-render the moment something is copied.
+ */
+/** `localStorage` key holding the mirrored clipboard entry. */
+export declare const CLIPBOARD_STORAGE_KEY = "aglyn:besigner:clipboard";
+/**
+ * Bumped whenever the persisted shape changes. A mirrored entry written by
+ * an older build is dropped rather than pasted as something unexpected.
+ */
+export declare const CLIPBOARD_FORMAT_VERSION = 1;
+export interface ClipboardEntry {
+    version: number;
+    /** Element labels in copy order, for the menu ("Paste Stack"). */
+    labels: string[];
+    /** Detached nested subtrees, in document order. */
+    nodes: Aglyn.NodeSchemaNested<any>[];
+}
+/**
+ * The current entry, hydrating from the `localStorage` mirror the first
+ * time it is asked for in this document.
+ */
+export declare function getEntry(): ClipboardEntry | null;
+/** Whether there is anything to paste. */
+export declare function hasContent(): boolean;
+/** Labels of the copied elements, in copy order. */
+export declare function getLabels(): string[];
+/**
+ * Copy one or more live nodes. The document root is skipped — pasting a
+ * whole document into itself is never what the gesture meant.
+ *
+ * Returns the number of elements actually copied.
+ */
+export declare function copyNodes(nodes: Aglyn.NodeSchema<any>[]): number;
+export declare function clear(): void;
+/**
+ * A plain result object rather than a discriminated union: an `ok: true |
+ * false` union stops narrowing once it crosses a library boundary (the
+ * emitted declaration widens the tag to `boolean`), so consumers in the
+ * designer would have to cast. Callers test `error`.
+ */
+export interface PasteResult {
+    /** What landed on the canvas — empty when `error` is set. */
+    nodes: Aglyn.NodeSchema<any>[];
+    /** Set when nothing was pasted, explaining why. */
+    error?: string;
+}
+/**
+ * Paste the clipboard next to / inside `target`, resolved exactly the way
+ * the Add-element flow resolves an insertion point: a container receives the
+ * elements as children, a leaf gets them as its next siblings.
+ *
+ * Rejects — rather than half-pasting — when the clipboard came from a
+ * document whose element catalog this one does not share (an email besigner
+ * has no Screen Link), or when the lineal rules forbid the arrangement.
+ * An `error` result means nothing was written to the canvas.
+ */
+export declare function pasteInto(target?: Aglyn.NodeSchema<any>): PasteResult;
+/** Every `componentId` in a nested subtree, root first. */
+export declare function collectComponentIds(node: Aglyn.NodeSchemaNested<any>, out?: string[]): string[];

package/src/lib/clipboard-manager/clipboard-manager.js

@@ -0,0 +1,241 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { _ as _extends } from "@swc/helpers/_/_extends";
+import { _ as _object_without_properties_loose } from "@swc/helpers/_/_object_without_properties_loose";
+import { canvas, components } from "@aglyn/aglyn";
+import { observable, runInAction } from "mobx";
+import { confirmValidLinealRelationship, describeInvalidLinealRelationship } from "../dnd-manager/index.js";
+import { localStore, parseMirrored, watchMirror } from "./clipboard-mirror.js";
+/**
+ * Besigner element clipboard (AGL-1202): copy an element — or a whole
+ * multi-selection — and paste it somewhere else, including into a
+ * *different document*.
+ *
+ * Cross-document paste is the point. Duplicate already covers "another one
+ * of these, right here"; what it cannot do is carry a built column out of
+ * the nav component and into the footer component, or lift a finished
+ * section off one screen onto another. So the clipboard holds detached
+ * nested JSON (never live nodes) and mirrors itself into `localStorage`,
+ * which is what lets it survive the full page navigation between two
+ * besigner documents.
+ *
+ * A MobX store, mirroring the focus-manager seam, so menus observing
+ * {@link hasContent} re-render the moment something is copied.
+ */ /** `localStorage` key holding the mirrored clipboard entry. */ export const CLIPBOARD_STORAGE_KEY = 'aglyn:besigner:clipboard';
+/**
+ * Bumped whenever the persisted shape changes. A mirrored entry written by
+ * an older build is dropped rather than pasted as something unexpected.
+ */ export const CLIPBOARD_FORMAT_VERSION = 1;
+const state = observable({
+    entry: null,
+    hydrated: false
+});
+/**
+ * A copied subtree keeps no tie to the canvas it came from: `$id` and
+ * `parentId` are re-minted on paste, and carrying stale ones through
+ * `localStorage` invites a paste that collides with a live node.
+ */ const detach = (node)=>{
+    const { $id, parentId } = node, rest = _object_without_properties_loose(node, [
+        "$id",
+        "parentId"
+    ]);
+    return _extends({}, rest, {
+        nodes: (Array.isArray(rest.nodes) ? rest.nodes : []).map(detach)
+    });
+};
+/**
+ * Drop any node that already travels inside another node in the same
+ * selection. Selecting a Stack *and* one of its children and hitting copy
+ * should yield one column, not a column plus a second loose copy of a row
+ * that is already inside it.
+ */ const withoutNestedDuplicates = (nodes)=>{
+    const ids = new Set(nodes.map((node)=>node == null ? void 0 : node.$id).filter(Boolean));
+    return nodes.filter((node)=>{
+        var _node_breadcrumbPath;
+        if (!(node == null ? void 0 : node.$id)) return false;
+        // breadcrumbPath is [root, ...ancestors, self] — an ancestor also in the
+        // selection means this node is already covered by that ancestor's copy.
+        const ancestors = ((_node_breadcrumbPath = node.breadcrumbPath) != null ? _node_breadcrumbPath : []).filter((id)=>id !== node.$id);
+        return !ancestors.some((id)=>ids.has(id));
+    });
+};
+const persist = (entry)=>{
+    const store = localStore();
+    if (!store) return;
+    try {
+        if (entry) store.setItem(CLIPBOARD_STORAGE_KEY, JSON.stringify(entry));
+        else store.removeItem(CLIPBOARD_STORAGE_KEY);
+    } catch (unused) {
+    // A full or unavailable quota only costs cross-document paste; the
+    // in-memory entry still works for this document.
+    }
+};
+const parseEntry = (raw)=>{
+    const parsed = parseMirrored(raw, CLIPBOARD_FORMAT_VERSION);
+    if (!parsed) return null;
+    if (!Array.isArray(parsed.nodes) || !parsed.nodes.length) return null;
+    return parsed;
+};
+const readMirror = ()=>{
+    try {
+        var _ref;
+        var _localStore;
+        return parseEntry((_ref = (_localStore = localStore()) == null ? void 0 : _localStore.getItem(CLIPBOARD_STORAGE_KEY)) != null ? _ref : null);
+    } catch (unused) {
+        return null;
+    }
+};
+/**
+ * A copy made in another besigner tab replaces this document's entry the
+ * moment it happens, exactly as a copy made here would. Hydrating once on
+ * first read is what a navigation needs; a second tab needs this, or the
+ * document goes on pasting the clipping it read first (AGL-2507).
+ */ watchMirror(CLIPBOARD_STORAGE_KEY, (raw)=>{
+    const entry = parseEntry(raw);
+    runInAction(()=>{
+        state.entry = entry;
+        // The mirror has now been consulted, whatever it held.
+        state.hydrated = true;
+    });
+});
+/**
+ * The current entry, hydrating from the `localStorage` mirror the first
+ * time it is asked for in this document.
+ */ export function getEntry() {
+    if (!state.hydrated) {
+        const mirrored = readMirror();
+        runInAction(()=>{
+            state.hydrated = true;
+            if (mirrored && !state.entry) state.entry = mirrored;
+        });
+    }
+    return state.entry;
+}
+/** Whether there is anything to paste. */ export function hasContent() {
+    var _getEntry_nodes, _getEntry;
+    return !!((_getEntry = getEntry()) == null ? void 0 : (_getEntry_nodes = _getEntry.nodes) == null ? void 0 : _getEntry_nodes.length);
+}
+/** Labels of the copied elements, in copy order. */ export function getLabels() {
+    var _ref;
+    var _getEntry;
+    return (_ref = (_getEntry = getEntry()) == null ? void 0 : _getEntry.labels) != null ? _ref : [];
+}
+/**
+ * Copy one or more live nodes. The document root is skipped — pasting a
+ * whole document into itself is never what the gesture meant.
+ *
+ * Returns the number of elements actually copied.
+ */ export function copyNodes(nodes) {
+    const copyable = withoutNestedDuplicates((nodes != null ? nodes : []).filter((node)=>node && !canvas.isRootNode(node)));
+    if (!copyable.length) return 0;
+    const entry = {
+        version: CLIPBOARD_FORMAT_VERSION,
+        labels: copyable.map((node)=>{
+            var _ref, _node_labelShort;
+            return (_ref = (_node_labelShort = node.labelShort) != null ? _node_labelShort : node.componentId) != null ? _ref : 'element';
+        }),
+        nodes: copyable.map((node)=>detach(canvas.makeNested(node)))
+    };
+    runInAction(()=>{
+        state.entry = entry;
+        state.hydrated = true;
+    });
+    persist(entry);
+    return copyable.length;
+}
+export function clear() {
+    runInAction(()=>{
+        state.entry = null;
+        state.hydrated = true;
+    });
+    persist(null);
+}
+/**
+ * Paste the clipboard next to / inside `target`, resolved exactly the way
+ * the Add-element flow resolves an insertion point: a container receives the
+ * elements as children, a leaf gets them as its next siblings.
+ *
+ * Rejects — rather than half-pasting — when the clipboard came from a
+ * document whose element catalog this one does not share (an email besigner
+ * has no Screen Link), or when the lineal rules forbid the arrangement.
+ * An `error` result means nothing was written to the canvas.
+ */ export function pasteInto(target) {
+    var _entry_nodes, _parent_componentSchema, _parent_componentSchema1;
+    const entry = getEntry();
+    if (!(entry == null ? void 0 : (_entry_nodes = entry.nodes) == null ? void 0 : _entry_nodes.length)) return {
+        nodes: [],
+        error: 'Nothing to paste'
+    };
+    const { parent, index } = canvas.resolveInsertTarget(target);
+    if (!parent) return {
+        nodes: [],
+        error: 'Nowhere to paste this'
+    };
+    // Every component in every subtree has to exist in THIS app before
+    // anything lands, so a rejected paste leaves the canvas untouched.
+    const unknown = entry.nodes.flatMap((node)=>collectComponentIds(node)).find((id)=>!components.getFactory(id));
+    if (unknown) {
+        return {
+            nodes: [],
+            error: `This copy uses "${unknown}", which isn't available here`
+        };
+    }
+    // Pasting follows the same lineal placement rules as inserting and dnd —
+    // without this, a paste can create an arrangement that drag-and-drop then
+    // (correctly) refuses to move.
+    const parentActor = {
+        componentId: parent.componentId,
+        pluginId: parent.pluginId,
+        restrictChildren: (_parent_componentSchema = parent.componentSchema) == null ? void 0 : _parent_componentSchema.restrictChildren,
+        restrictParent: (_parent_componentSchema1 = parent.componentSchema) == null ? void 0 : _parent_componentSchema1.restrictParent
+    };
+    for (const nested of entry.nodes){
+        const schema = components.getSchema(nested.componentId);
+        const item = {
+            componentId: nested.componentId,
+            pluginId: nested.pluginId,
+            restrictChildren: schema == null ? void 0 : schema.restrictChildren,
+            restrictParent: schema == null ? void 0 : schema.restrictParent
+        };
+        const [valid, reason] = confirmValidLinealRelationship(item, parentActor);
+        if (!valid) {
+            return {
+                nodes: [],
+                error: describeInvalidLinealRelationship(item, parentActor, reason)
+            };
+        }
+    }
+    const pasted = [];
+    entry.nodes.forEach((nested, i)=>{
+        // Sequential indices keep multi-element pastes in copy order; NaN keeps
+        // the append-to-end behaviour of a container target.
+        const at = isNaN(index) ? NaN : index + i;
+        pasted.push(canvas.addNodeFromNested(nested, parent, at));
+    });
+    return {
+        nodes: pasted
+    };
+}
+/** Every `componentId` in a nested subtree, root first. */ export function collectComponentIds(node, out = []) {
+    if (!node) return out;
+    if (node.componentId) out.push(node.componentId);
+    for (const child of Array.isArray(node.nodes) ? node.nodes : []){
+        collectComponentIds(child, out);
+    }
+    return out;
+}
+
+//# sourceMappingURL=clipboard-manager.js.map

package/src/lib/clipboard-manager/clipboard-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/besigner/core/src/lib/clipboard-manager/clipboard-manager.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 * as Aglyn from '@aglyn/aglyn'\nimport { canvas, components } from '@aglyn/aglyn'\nimport { observable, runInAction } from 'mobx'\nimport {\n  confirmValidLinealRelationship,\n  describeInvalidLinealRelationship,\n  type LinealItem,\n} from '../dnd-manager'\nimport { localStore, parseMirrored, watchMirror } from './clipboard-mirror'\n\n/**\n * Besigner element clipboard (AGL-1202): copy an element — or a whole\n * multi-selection — and paste it somewhere else, including into a\n * *different document*.\n *\n * Cross-document paste is the point. Duplicate already covers \"another one\n * of these, right here\"; what it cannot do is carry a built column out of\n * the nav component and into the footer component, or lift a finished\n * section off one screen onto another. So the clipboard holds detached\n * nested JSON (never live nodes) and mirrors itself into `localStorage`,\n * which is what lets it survive the full page navigation between two\n * besigner documents.\n *\n * A MobX store, mirroring the focus-manager seam, so menus observing\n * {@link hasContent} re-render the moment something is copied.\n */\n\n/** `localStorage` key holding the mirrored clipboard entry. */\nexport const CLIPBOARD_STORAGE_KEY = 'aglyn:besigner:clipboard'\n\n/**\n * Bumped whenever the persisted shape changes. A mirrored entry written by\n * an older build is dropped rather than pasted as something unexpected.\n */\nexport const CLIPBOARD_FORMAT_VERSION = 1\n\nexport interface ClipboardEntry {\n  version: number\n  /** Element labels in copy order, for the menu (\"Paste Stack\"). */\n  labels: string[]\n  /** Detached nested subtrees, in document order. */\n  nodes: Aglyn.NodeSchemaNested<any>[]\n}\n\ninterface ClipboardState {\n  entry: ClipboardEntry | null\n  /** Set once the mirrored entry has been read back after a navigation. */\n  hydrated: boolean\n}\n\nconst state = observable<ClipboardState>({ entry: null, hydrated: false })\n\n/**\n * A copied subtree keeps no tie to the canvas it came from: `$id` and\n * `parentId` are re-minted on paste, and carrying stale ones through\n * `localStorage` invites a paste that collides with a live node.\n */\nconst detach = (\n  node: Aglyn.NodeSchemaNested<any>,\n): Aglyn.NodeSchemaNested<any> => {\n  const { $id, parentId, ...rest } = node as Record<string, unknown> & {\n    $id?: string\n    parentId?: string\n    nodes?: Aglyn.NodeSchemaNested<any>[]\n  }\n  return {\n    ...rest,\n    nodes: (Array.isArray(rest.nodes) ? rest.nodes : []).map(detach),\n  } as Aglyn.NodeSchemaNested<any>\n}\n\n/**\n * Drop any node that already travels inside another node in the same\n * selection. Selecting a Stack *and* one of its children and hitting copy\n * should yield one column, not a column plus a second loose copy of a row\n * that is already inside it.\n */\nconst withoutNestedDuplicates = (\n  nodes: Aglyn.NodeSchema<any>[],\n): Aglyn.NodeSchema<any>[] => {\n  const ids = new Set(nodes.map((node) => node?.$id).filter(Boolean))\n  return nodes.filter((node) => {\n    if (!node?.$id) return false\n    // breadcrumbPath is [root, ...ancestors, self] — an ancestor also in the\n    // selection means this node is already covered by that ancestor's copy.\n    const ancestors = (node.breadcrumbPath ?? []).filter(\n      (id: Aglyn.NodeId) => id !== node.$id,\n    )\n    return !ancestors.some((id: Aglyn.NodeId) => ids.has(id))\n  })\n}\n\nconst persist = (entry: ClipboardEntry | null): void => {\n  const store = localStore()\n  if (!store) return\n  try {\n    if (entry) store.setItem(CLIPBOARD_STORAGE_KEY, JSON.stringify(entry))\n    else store.removeItem(CLIPBOARD_STORAGE_KEY)\n  } catch {\n    // A full or unavailable quota only costs cross-document paste; the\n    // in-memory entry still works for this document.\n  }\n}\n\nconst parseEntry = (raw: string | null): ClipboardEntry | null => {\n  const parsed = parseMirrored<ClipboardEntry>(raw, CLIPBOARD_FORMAT_VERSION)\n  if (!parsed) return null\n  if (!Array.isArray(parsed.nodes) || !parsed.nodes.length) return null\n  return parsed\n}\n\nconst readMirror = (): ClipboardEntry | null => {\n  try {\n    return parseEntry(localStore()?.getItem(CLIPBOARD_STORAGE_KEY) ?? null)\n  } catch {\n    return null\n  }\n}\n\n/**\n * A copy made in another besigner tab replaces this document's entry the\n * moment it happens, exactly as a copy made here would. Hydrating once on\n * first read is what a navigation needs; a second tab needs this, or the\n * document goes on pasting the clipping it read first (AGL-2507).\n */\nwatchMirror(CLIPBOARD_STORAGE_KEY, (raw) => {\n  const entry = parseEntry(raw)\n  runInAction(() => {\n    state.entry = entry\n    // The mirror has now been consulted, whatever it held.\n    state.hydrated = true\n  })\n})\n\n/**\n * The current entry, hydrating from the `localStorage` mirror the first\n * time it is asked for in this document.\n */\nexport function getEntry(): ClipboardEntry | null {\n  if (!state.hydrated) {\n    const mirrored = readMirror()\n    runInAction(() => {\n      state.hydrated = true\n      if (mirrored && !state.entry) state.entry = mirrored\n    })\n  }\n  return state.entry\n}\n\n/** Whether there is anything to paste. */\nexport function hasContent(): boolean {\n  return !!getEntry()?.nodes?.length\n}\n\n/** Labels of the copied elements, in copy order. */\nexport function getLabels(): string[] {\n  return getEntry()?.labels ?? []\n}\n\n/**\n * Copy one or more live nodes. The document root is skipped — pasting a\n * whole document into itself is never what the gesture meant.\n *\n * Returns the number of elements actually copied.\n */\nexport function copyNodes(nodes: Aglyn.NodeSchema<any>[]): number {\n  const copyable = withoutNestedDuplicates(\n    (nodes ?? []).filter((node) => node && !canvas.isRootNode(node)),\n  )\n  if (!copyable.length) return 0\n\n  const entry: ClipboardEntry = {\n    version: CLIPBOARD_FORMAT_VERSION,\n    labels: copyable.map(\n      (node) => node.labelShort ?? node.componentId ?? 'element',\n    ),\n    nodes: copyable.map((node) => detach(canvas.makeNested(node))),\n  }\n  runInAction(() => {\n    state.entry = entry\n    state.hydrated = true\n  })\n  persist(entry)\n  return copyable.length\n}\n\nexport function clear(): void {\n  runInAction(() => {\n    state.entry = null\n    state.hydrated = true\n  })\n  persist(null)\n}\n\n/**\n * A plain result object rather than a discriminated union: an `ok: true |\n * false` union stops narrowing once it crosses a library boundary (the\n * emitted declaration widens the tag to `boolean`), so consumers in the\n * designer would have to cast. Callers test `error`.\n */\nexport interface PasteResult {\n  /** What landed on the canvas — empty when `error` is set. */\n  nodes: Aglyn.NodeSchema<any>[]\n  /** Set when nothing was pasted, explaining why. */\n  error?: string\n}\n\n/**\n * Paste the clipboard next to / inside `target`, resolved exactly the way\n * the Add-element flow resolves an insertion point: a container receives the\n * elements as children, a leaf gets them as its next siblings.\n *\n * Rejects — rather than half-pasting — when the clipboard came from a\n * document whose element catalog this one does not share (an email besigner\n * has no Screen Link), or when the lineal rules forbid the arrangement.\n * An `error` result means nothing was written to the canvas.\n */\nexport function pasteInto(target?: Aglyn.NodeSchema<any>): PasteResult {\n  const entry = getEntry()\n  if (!entry?.nodes?.length) return { nodes: [], error: 'Nothing to paste' }\n\n  const { parent, index } = canvas.resolveInsertTarget(target)\n  if (!parent) return { nodes: [], error: 'Nowhere to paste this' }\n\n  // Every component in every subtree has to exist in THIS app before\n  // anything lands, so a rejected paste leaves the canvas untouched.\n  const unknown = entry.nodes\n    .flatMap((node) => collectComponentIds(node))\n    .find((id) => !components.getFactory(id as any))\n  if (unknown) {\n    return {\n      nodes: [],\n      error: `This copy uses \"${unknown}\", which isn't available here`,\n    }\n  }\n\n  // Pasting follows the same lineal placement rules as inserting and dnd —\n  // without this, a paste can create an arrangement that drag-and-drop then\n  // (correctly) refuses to move.\n  const parentActor: LinealItem = {\n    componentId: parent.componentId,\n    pluginId: parent.pluginId,\n    restrictChildren: parent.componentSchema?.restrictChildren,\n    restrictParent: parent.componentSchema?.restrictParent,\n  }\n  for (const nested of entry.nodes) {\n    const schema = components.getSchema(nested.componentId as any)\n    const item: LinealItem = {\n      componentId: nested.componentId as any,\n      pluginId: nested.pluginId as any,\n      restrictChildren: schema?.restrictChildren,\n      restrictParent: schema?.restrictParent,\n    }\n    const [valid, reason] = confirmValidLinealRelationship(item, parentActor)\n    if (!valid) {\n      return {\n        nodes: [],\n        error: describeInvalidLinealRelationship(item, parentActor, reason),\n      }\n    }\n  }\n\n  const pasted: Aglyn.NodeSchema<any>[] = []\n  entry.nodes.forEach((nested, i) => {\n    // Sequential indices keep multi-element pastes in copy order; NaN keeps\n    // the append-to-end behaviour of a container target.\n    const at = isNaN(index) ? NaN : index + i\n    pasted.push(canvas.addNodeFromNested(nested, parent, at))\n  })\n  return { nodes: pasted }\n}\n\n/** Every `componentId` in a nested subtree, root first. */\nexport function collectComponentIds(\n  node: Aglyn.NodeSchemaNested<any>,\n  out: string[] = [],\n): string[] {\n  if (!node) return out\n  if (node.componentId) out.push(node.componentId as string)\n  for (const child of Array.isArray(node.nodes) ? node.nodes : []) {\n    collectComponentIds(child as Aglyn.NodeSchemaNested<any>, out)\n  }\n  return out\n}\n"],"names":["canvas","components","observable","runInAction","confirmValidLinealRelationship","describeInvalidLinealRelationship","localStore","parseMirrored","watchMirror","CLIPBOARD_STORAGE_KEY","CLIPBOARD_FORMAT_VERSION","state","entry","hydrated","detach","node","$id","parentId","rest","nodes","Array","isArray","map","withoutNestedDuplicates","ids","Set","filter","Boolean","ancestors","breadcrumbPath","id","some","has","persist","store","setItem","JSON","stringify","removeItem","parseEntry","raw","parsed","length","readMirror","getItem","getEntry","mirrored","hasContent","getLabels","labels","copyNodes","copyable","isRootNode","version","labelShort","componentId","makeNested","clear","pasteInto","target","parent","error","index","resolveInsertTarget","unknown","flatMap","collectComponentIds","find","getFactory","parentActor","pluginId","restrictChildren","componentSchema","restrictParent","nested","schema","getSchema","item","valid","reason","pasted","forEach","i","at","isNaN","NaN","push","addNodeFromNested","out","child"],"mappings":"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"}

package/src/lib/clipboard-manager/clipboard-mirror.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * The `localStorage` seam shared by the two besigner clipboards (elements
+ * and styles).
+ *
+ * The mirror IS the clipboard, not a fallback for it. Hydrating from it once
+ * per document is enough to survive a navigation, but not to survive a second
+ * tab: two besigner documents open side by side never reload, so a document
+ * that only reads the mirror on its first paste keeps serving that first
+ * clipping no matter how many times the tab next door copies something new
+ * (AGL-2507). Every document therefore follows the mirror for as long as it
+ * is open, which is what {@link watchMirror} is for.
+ */
+/** `window.localStorage`, or null when it is unavailable. */
+export declare const localStore: () => Storage | null;
+/**
+ * Parse a mirrored entry, dropping anything a different build wrote. A
+ * corrupt or foreign entry is no entry — this never throws.
+ *
+ * @param raw - The stored JSON, or null when the key is absent.
+ * @param version - The format version this build understands.
+ */
+export declare function parseMirrored<T extends {
+    version: number;
+}>(raw: string | null, version: number): T | null;
+/**
+ * Call `onValue` whenever another document on this origin writes `key`.
+ *
+ * `storage` fires only in the OTHER documents, never in the one that wrote,
+ * so a copy made here is never round-tripped back through the parser.
+ *
+ * @returns An unsubscribe function. Nothing calls it today — the clipboards
+ *   are module singletons that live as long as the document — but a listener
+ *   with no way off the window is a leak waiting for the first consumer that
+ *   does need one.
+ */
+export declare function watchMirror(key: string, onValue: (raw: string | null) => void): () => void;

package/src/lib/clipboard-manager/clipboard-mirror.js

@@ -0,0 +1,75 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ /**
+ * The `localStorage` seam shared by the two besigner clipboards (elements
+ * and styles).
+ *
+ * The mirror IS the clipboard, not a fallback for it. Hydrating from it once
+ * per document is enough to survive a navigation, but not to survive a second
+ * tab: two besigner documents open side by side never reload, so a document
+ * that only reads the mirror on its first paste keeps serving that first
+ * clipping no matter how many times the tab next door copies something new
+ * (AGL-2507). Every document therefore follows the mirror for as long as it
+ * is open, which is what {@link watchMirror} is for.
+ */ /** `window.localStorage`, or null when it is unavailable. */ export const localStore = ()=>{
+    try {
+        // SSR and privacy-mode both make this throw rather than return null.
+        return typeof window === 'undefined' ? null : window.localStorage;
+    } catch (unused) {
+        return null;
+    }
+};
+/**
+ * Parse a mirrored entry, dropping anything a different build wrote. A
+ * corrupt or foreign entry is no entry — this never throws.
+ *
+ * @param raw - The stored JSON, or null when the key is absent.
+ * @param version - The format version this build understands.
+ */ export function parseMirrored(raw, version) {
+    if (!raw) return null;
+    try {
+        const parsed = JSON.parse(raw);
+        return (parsed == null ? void 0 : parsed.version) === version ? parsed : null;
+    } catch (unused) {
+        return null;
+    }
+}
+/**
+ * Call `onValue` whenever another document on this origin writes `key`.
+ *
+ * `storage` fires only in the OTHER documents, never in the one that wrote,
+ * so a copy made here is never round-tripped back through the parser.
+ *
+ * @returns An unsubscribe function. Nothing calls it today — the clipboards
+ *   are module singletons that live as long as the document — but a listener
+ *   with no way off the window is a leak waiting for the first consumer that
+ *   does need one.
+ */ export function watchMirror(key, onValue) {
+    if (typeof window === 'undefined') return ()=>undefined;
+    const listener = (event)=>{
+        // A null key is another tab calling `localStorage.clear()`, which clears
+        // this key along with everything else.
+        if (event.key !== null && event.key !== key) return;
+        // `sessionStorage` raises this event too, and it is a different clipboard.
+        const store = localStore();
+        if (store && event.storageArea && event.storageArea !== store) return;
+        onValue(event.key === null ? null : event.newValue);
+    };
+    window.addEventListener('storage', listener);
+    return ()=>window.removeEventListener('storage', listener);
+}
+
+//# sourceMappingURL=clipboard-mirror.js.map

package/src/lib/clipboard-manager/clipboard-mirror.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/besigner/core/src/lib/clipboard-manager/clipboard-mirror.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * The `localStorage` seam shared by the two besigner clipboards (elements\n * and styles).\n *\n * The mirror IS the clipboard, not a fallback for it. Hydrating from it once\n * per document is enough to survive a navigation, but not to survive a second\n * tab: two besigner documents open side by side never reload, so a document\n * that only reads the mirror on its first paste keeps serving that first\n * clipping no matter how many times the tab next door copies something new\n * (AGL-2507). Every document therefore follows the mirror for as long as it\n * is open, which is what {@link watchMirror} is for.\n */\n\n/** `window.localStorage`, or null when it is unavailable. */\nexport const localStore = (): Storage | null => {\n  try {\n    // SSR and privacy-mode both make this throw rather than return null.\n    return typeof window === 'undefined' ? null : window.localStorage\n  } catch {\n    return null\n  }\n}\n\n/**\n * Parse a mirrored entry, dropping anything a different build wrote. A\n * corrupt or foreign entry is no entry — this never throws.\n *\n * @param raw - The stored JSON, or null when the key is absent.\n * @param version - The format version this build understands.\n */\nexport function parseMirrored<T extends { version: number }>(\n  raw: string | null,\n  version: number,\n): T | null {\n  if (!raw) return null\n  try {\n    const parsed = JSON.parse(raw) as T\n    return parsed?.version === version ? parsed : null\n  } catch {\n    return null\n  }\n}\n\n/**\n * Call `onValue` whenever another document on this origin writes `key`.\n *\n * `storage` fires only in the OTHER documents, never in the one that wrote,\n * so a copy made here is never round-tripped back through the parser.\n *\n * @returns An unsubscribe function. Nothing calls it today — the clipboards\n *   are module singletons that live as long as the document — but a listener\n *   with no way off the window is a leak waiting for the first consumer that\n *   does need one.\n */\nexport function watchMirror(\n  key: string,\n  onValue: (raw: string | null) => void,\n): () => void {\n  if (typeof window === 'undefined') return () => undefined\n\n  const listener = (event: StorageEvent): void => {\n    // A null key is another tab calling `localStorage.clear()`, which clears\n    // this key along with everything else.\n    if (event.key !== null && event.key !== key) return\n    // `sessionStorage` raises this event too, and it is a different clipboard.\n    const store = localStore()\n    if (store && event.storageArea && event.storageArea !== store) return\n    onValue(event.key === null ? null : event.newValue)\n  }\n\n  window.addEventListener('storage', listener)\n  return () => window.removeEventListener('storage', listener)\n}\n"],"names":["localStore","window","localStorage","parseMirrored","raw","version","parsed","JSON","parse","watchMirror","key","onValue","undefined","listener","event","store","storageArea","newValue","addEventListener","removeEventListener"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;;;CAWC,GAED,2DAA2D,GAC3D,OAAO,MAAMA,aAAa;IACxB,IAAI;QACF,qEAAqE;QACrE,OAAO,OAAOC,WAAW,cAAc,OAAOA,OAAOC,YAAY;IACnE,EAAE,eAAM;QACN,OAAO;IACT;AACF,EAAC;AAED;;;;;;CAMC,GACD,OAAO,SAASC,cACdC,GAAkB,EAClBC,OAAe;IAEf,IAAI,CAACD,KAAK,OAAO;IACjB,IAAI;QACF,MAAME,SAASC,KAAKC,KAAK,CAACJ;QAC1B,OAAOE,CAAAA,0BAAAA,OAAQD,OAAO,MAAKA,UAAUC,SAAS;IAChD,EAAE,eAAM;QACN,OAAO;IACT;AACF;AAEA;;;;;;;;;;CAUC,GACD,OAAO,SAASG,YACdC,GAAW,EACXC,OAAqC;IAErC,IAAI,OAAOV,WAAW,aAAa,OAAO,IAAMW;IAEhD,MAAMC,WAAW,CAACC;QAChB,yEAAyE;QACzE,uCAAuC;QACvC,IAAIA,MAAMJ,GAAG,KAAK,QAAQI,MAAMJ,GAAG,KAAKA,KAAK;QAC7C,2EAA2E;QAC3E,MAAMK,QAAQf;QACd,IAAIe,SAASD,MAAME,WAAW,IAAIF,MAAME,WAAW,KAAKD,OAAO;QAC/DJ,QAAQG,MAAMJ,GAAG,KAAK,OAAO,OAAOI,MAAMG,QAAQ;IACpD;IAEAhB,OAAOiB,gBAAgB,CAAC,WAAWL;IACnC,OAAO,IAAMZ,OAAOkB,mBAAmB,CAAC,WAAWN;AACrD"}

package/src/lib/clipboard-manager/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export * as clipboard from './clipboard-manager';
+export { CLIPBOARD_FORMAT_VERSION, CLIPBOARD_STORAGE_KEY, type ClipboardEntry, type PasteResult, } from './clipboard-manager';
+export * as styleClipboard from './style-clipboard';
+export { STYLE_CLIPBOARD_FORMAT_VERSION, STYLE_CLIPBOARD_STORAGE_KEY, type StyleClipboardEntry, } from './style-clipboard';

package/src/lib/clipboard-manager/index.js

@@ -0,0 +1,23 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import * as _clipboard from "./clipboard-manager.js";
+export { _clipboard as clipboard };
+export { CLIPBOARD_FORMAT_VERSION, CLIPBOARD_STORAGE_KEY } from "./clipboard-manager.js";
+import * as _styleClipboard from "./style-clipboard.js";
+export { _styleClipboard as styleClipboard };
+export { STYLE_CLIPBOARD_FORMAT_VERSION, STYLE_CLIPBOARD_STORAGE_KEY } from "./style-clipboard.js";
+
+//# sourceMappingURL=index.js.map

package/src/lib/clipboard-manager/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/besigner/core/src/lib/clipboard-manager/index.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\nexport * as clipboard from './clipboard-manager'\nexport {\n  CLIPBOARD_FORMAT_VERSION,\n  CLIPBOARD_STORAGE_KEY,\n  type ClipboardEntry,\n  type PasteResult,\n} from './clipboard-manager'\n\nexport * as styleClipboard from './style-clipboard'\nexport {\n  STYLE_CLIPBOARD_FORMAT_VERSION,\n  STYLE_CLIPBOARD_STORAGE_KEY,\n  type StyleClipboardEntry,\n} from './style-clipboard'\n"],"names":["clipboard","CLIPBOARD_FORMAT_VERSION","CLIPBOARD_STORAGE_KEY","styleClipboard","STYLE_CLIPBOARD_FORMAT_VERSION","STYLE_CLIPBOARD_STORAGE_KEY"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,4BAA2B,yBAAqB;AAAhD,SAAO,cAAKA,SAAS,GAA2B;AAChD,SACEC,wBAAwB,EACxBC,qBAAqB,QAGhB,yBAAqB;AAE5B,iCAAgC,uBAAmB;AAAnD,SAAO,mBAAKC,cAAc,GAAyB;AACnD,SACEC,8BAA8B,EAC9BC,2BAA2B,QAEtB,uBAAmB"}

package/src/lib/clipboard-manager/style-clipboard.d.ts

@@ -0,0 +1,77 @@
+/**
+ * @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 * as Aglyn from '@aglyn/aglyn';
+/**
+ * Besigner STYLE clipboard.
+ *
+ * The element clipboard beside it carries whole subtrees. This carries a
+ * look: everything the Styles panel writes to one element, so a heading
+ * styled once can be applied to five more without rebuilding it field by
+ * field or duplicating an element and re-authoring its content.
+ *
+ * ## What a "style" is here
+ *
+ * `node.sx` and only `node.sx` — the Styles panel's entire output, including
+ * its responsive, `@scheme` and interaction-state slices, which are keys
+ * inside that object rather than separate storage.
+ *
+ * NOT classes. A class is a name pointing at rules the element does not own,
+ * and two of them carry behaviour rather than appearance: `aglyn-hidden`
+ * enrols an element in interaction choreography, and a theme utility class
+ * may be targeted by an interaction's class steps. Carrying those across on
+ * a "paste styles" would move behaviour under a label that promises looks.
+ *
+ * ## Paste REPLACES
+ *
+ * Merging would make the result depend on what the target already had, so
+ * pasting the same look onto two elements could produce two different
+ * elements — and there would be no way to paste "no styles". Undo is the way
+ * back, as it is for every other edit.
+ *
+ * Mirrored into `localStorage` on the same terms as the element clipboard, so
+ * a look copied in one document can be pasted in another after the full page
+ * navigation between two besigner routes.
+ */
+/** `localStorage` key holding the mirrored style entry. */
+export declare const STYLE_CLIPBOARD_STORAGE_KEY = "aglyn:besigner:style-clipboard";
+/** Bumped when the persisted shape changes; an older entry is dropped. */
+export declare const STYLE_CLIPBOARD_FORMAT_VERSION = 1;
+export interface StyleClipboardEntry {
+    version: number;
+    /** The element the look was taken from, for the menu ("from Heading"). */
+    label: string;
+    /** The Styles panel's whole output. `null` is a real value: no styles. */
+    sx: Record<string, unknown> | null;
+}
+/** The copied look, or null. */
+export declare function getStyleEntry(): StyleClipboardEntry | null;
+/** Whether anything has been copied. Observed, so menus enable on copy. */
+export declare function hasStyles(): boolean;
+/** The label of the element the look came from, for the menu. */
+export declare function getStyleLabel(): string;
+/** Takes the look off one node. Returns false when there is no node. */
+export declare function copyStyles(node: Aglyn.NodeSchema<any> | undefined): boolean;
+/**
+ * Applies the copied look to a node, replacing whatever it had.
+ *
+ * Returns false when there is nothing to paste. A copied entry of `null`
+ * styles IS something to paste — it clears the target — which is why the
+ * check is on the entry rather than on its `sx`.
+ */
+export declare function pasteStyles(node: Aglyn.NodeSchema<any> | undefined): boolean;
+/** Forgets the copied look. Tests, and a future "clear" affordance. */
+export declare function clearStyles(): void;