@weasel-js/core 1.9.3 → 1.10.0

package/dist/interactions/actions/clipboard/clipboardOps.js

@@ -1,52 +1,54 @@
-import { dispatchApplyBatch as e } from "../../../core/applyOps.js";
-import { usePointerContext as t } from "../../../features/pointer/PointerContext.js";
-import { dwarn as n } from "../../../debug/flag.js";
-import { materializePaste as r } from "./materializePaste.js";
-import { WEASEL_CLIPBOARD_MIME as i, buildWeaselClipboardText as a } from "./wireFormat.js";
-import { useCallback as o, useRef as s } from "react";
-import { useLatest as c } from "@weasel-js/react";
+import { dwarn as e } from "../../../debug/flag.js";
+import { dispatchApplyBatch as t } from "../../../core/applyOps.js";
+import { materializePaste as n } from "./materializePaste.js";
+import { WEASEL_CLIPBOARD_MIME as r, buildWeaselClipboardText as i } from "./wireFormat.js";
+import { useCallback as a, useRef as o } from "react";
+import { useLatest as s } from "@weasel-js/react";
+import { usePointerContext as c } from "@weasel-js/routing/react";
 //#region src/interactions/actions/clipboard/clipboardOps.ts
 var l = { items: [] };
-function u(i, a) {
-	let { getSelection: u, onPaste: f, pasteLabel: m = "Paste", getDropPoint: h, produceFlavors: g, jsonReplacer: _ } = a, v = t(), y = h ?? v?.getDropPoint, b = s(l), x = c(i), S = c({
+function u(r, i) {
+	let { getSelection: u, onPaste: f, onPasteOmitted: m, pasteLabel: h = "Paste", getDropPoint: g, produceFlavors: _, jsonReplacer: v } = i, y = c(), b = g ?? y?.getDropPoint, x = o(l), S = s(r), C = s({
 		getSelection: u,
 		onPaste: f,
-		pasteLabel: m,
-		getDropPoint: y,
-		produceFlavors: g,
-		jsonReplacer: _
+		onPasteOmitted: m,
+		pasteLabel: h,
+		getDropPoint: b,
+		produceFlavors: _,
+		jsonReplacer: v
 	});
 	return {
-		copy: o(() => {
-			let e = S.current.getSelection();
-			if (e.length === 0) return;
-			let t = x.current.snapshotSelection;
-			if (!t) return;
-			b.current = t(e);
+		copy: a(() => {
+			let t = C.current.getSelection();
+			if (t.length === 0) return;
+			let n = S.current.snapshotSelection;
+			if (!n) return;
+			x.current = n(t);
 			let r = null;
 			try {
-				r = S.current.produceFlavors?.(b.current) ?? d(b.current, S.current.jsonReplacer);
-			} catch (e) {
-				n("clipboard", `flavor producer threw — skipping OS write: ${String(e)}`);
+				r = C.current.produceFlavors?.(x.current) ?? d(x.current, C.current.jsonReplacer);
+			} catch (t) {
+				e("clipboard", `flavor producer threw — skipping OS write: ${String(t)}`);
 			}
 			r && p(r);
-		}, [x, S]),
-		paste: o(() => {
-			let t = b.current;
-			if (t.items.length === 0) return;
-			let n = x.current, i = r(n, t, {
-				currentSelection: S.current.getSelection(),
-				dropPoint: S.current.getDropPoint?.()
+		}, [S, C]),
+		paste: a(() => {
+			let e = x.current;
+			if (e.items.length === 0) return;
+			let r = S.current, i = n(r, e, {
+				currentSelection: C.current.getSelection(),
+				dropPoint: C.current.getDropPoint?.(),
+				onOmitted: C.current.onPasteOmitted
 			});
-			i && (e(n, i.ops, S.current.pasteLabel), b.current = { items: i.created }, S.current.onPaste?.(i.newIds));
-		}, [x, S]),
-		isEmpty: o(() => b.current.items.length === 0, [])
+			i && (t(r, i.ops, C.current.pasteLabel), x.current = { items: i.created }, C.current.onPaste?.(i.newIds));
+		}, [S, C]),
+		isEmpty: a(() => x.current.items.length === 0, [])
 	};
 }
 function d(e, t) {
-	let n = a(e.items, t);
+	let n = i(e.items, t);
 	return {
-		[i]: n,
+		[r]: n,
 		"text/plain": n
 	};
 }
@@ -55,13 +57,13 @@ var f = /* @__PURE__ */ new Set([
 	"text/html",
 	"image/png"
 ]);
-async function p(e) {
-	let t = Object.entries(e);
-	if (t.length === 0) return;
+async function p(t) {
+	let n = Object.entries(t);
+	if (n.length === 0) return;
 	let r = typeof navigator < "u" ? navigator.clipboard : void 0;
 	if (!r?.write || typeof ClipboardItem > "u") return;
 	let i = /* @__PURE__ */ new Set();
-	for (let [e, n] of t) typeof n != "string" && n.catch(() => {
+	for (let [e, t] of n) typeof t != "string" && t.catch(() => {
 		i.add(e);
 	});
 	let a = (e) => f.has(e) ? e : `web ${e}`, o = (e) => new ClipboardItem(Object.fromEntries(e.map(([e, t]) => {
@@ -79,14 +81,14 @@ async function p(e) {
 			t = n;
 		}
 	};
-	if (await s(t) === null) return;
-	let c = t.filter(([e]) => f.has(e) && !i.has(e));
+	if (await s(n) === null) return;
+	let c = n.filter(([e]) => f.has(e) && !i.has(e));
 	if (c.length === 0) {
-		n("clipboard", "OS write failed; no standard flavors to fall back to");
+		e("clipboard", "OS write failed; no standard flavors to fall back to");
 		return;
 	}
 	let l = await s(c);
-	l !== null && n("clipboard", `OS clipboard write failed twice — copy stays in-memory only: ${String(l)}`);
+	l !== null && e("clipboard", `OS clipboard write failed twice — copy stays in-memory only: ${String(l)}`);
 }
 //#endregion
 export { u as useClipboardOps, p as writeOsClipboard };

package/dist/interactions/actions/clipboard/clipboardOps.js.map

@@ -1 +1 @@
-{"version":3,"file":"clipboardOps.js","names":["EMPTY","useClipboardOps","options","pointerCtx","usePointerContext","effectiveGetDropPoint","getDropPoint","clipboardRef","useRef","adapterRef","useLatest","adapter","optsRef","useCallback","ids","snap","flavors","defaultFlavors","err","writeOsClipboard","cb","a","result","materializePaste","dispatchApplyBatch","text","buildWeaselClipboardText","snapshot","replacer","WEASEL_CLIPBOARD_MIME","WELL_KNOWN_CLIPBOARD_MIMES","entries","rejected","mime","wireMime","toItem","fs","wire","blob","t","promised","writeLive","live","next","standard","dwarn"],"sources":["../../../../src/interactions/actions/clipboard/clipboardOps.ts"],"sourcesContent":["import { useCallback, useRef } from 'react';\nimport { useLatest } from '@weasel-js/react';\nimport type { NodeId } from 'core/scene/types';\nimport { dispatchApplyBatch } from 'core/applyOps';\nimport type { InsertAdapter } from 'core/adapters/types';\nimport type { ClipboardSnapshot } from './types';\nimport { usePointerContext } from 'features/pointer/PointerContext';\nimport { dwarn } from 'debug/flag';\nimport { materializePaste } from './materializePaste';\nimport { WEASEL_CLIPBOARD_MIME, buildWeaselClipboardText } from './wireFormat';\n\ntype Replacer = (key: string, value: unknown) => unknown;\n\n/** Options for `useClipboardOps`. */\nexport interface UseClipboardOpsOptions {\n  /** How the hook reads \"current selection\" for copy. The kit doesn't assume\n   *  a global selection store; each consumer wires this. */\n  getSelection: () => NodeId[];\n  /** Called after a successful paste with the ids of the newly inserted objects. */\n  onPaste?: (newIds: NodeId[]) => void;\n  /** Label for the history entry produced by paste. Default 'Paste'. */\n  pasteLabel?: string;\n  /** Pulled once per paste() call. When non-null, threaded to commitPaste\n   *  as `ctx.dropPoint`; adapters typically use it as the cluster origin\n   *  (ignoring `offset`). When null/undefined, the hook falls back to the\n   *  existing cascade-offset behavior. */\n  getDropPoint?: () => { worldX: number; worldY: number } | null;\n  /** Produce the OS-clipboard flavor map for a copied snapshot. Keys are MIME\n   *  types, values the serialized payload. The kit default emits\n   *  `application/x-weasel-clipboard+json` plus `text/plain` carrying the\n   *  same JSON. Apps override to add richer flavors (e.g. real SVG) or to\n   *  replace the text flavor. Return an empty object to skip the OS write\n   *  entirely. A value may be a promise — an SVG flavor waiting on\n   *  `warmSvg`, say: the write is still issued inside the copy gesture and\n   *  the clipboard takes the text when it resolves. The producer itself runs\n   *  synchronously, so it reads the selection as it stood at the copy. */\n  produceFlavors?: (snapshot: ClipboardSnapshot) => ClipboardFlavors;\n  /** Replacer for the kit-default JSON flavor (typed arrays etc.). Ignored\n   *  when `produceFlavors` is supplied. */\n  jsonReplacer?: Replacer;\n}\n\n/** MIME type to payload, as `produceFlavors` returns it. */\nexport type ClipboardFlavors = Record<string, string | Promise<string>>;\n\n/** Return shape of `useClipboardOps`: imperative `copy`, `paste`, and `isEmpty` functions. */\nexport interface UseClipboardOpsReturn {\n  copy(): void;\n  paste(): void;\n  isEmpty(): boolean;\n}\n\nconst EMPTY: ClipboardSnapshot = { items: [] };\n\n/** In-memory copy/paste of selections via `InsertAdapter.snapshotSelection` / `commitPaste`. */\nexport function useClipboardOps<TNode extends { id: string }>(\n  adapter: InsertAdapter<TNode>,\n  options: UseClipboardOpsOptions,\n): UseClipboardOpsReturn {\n  const { getSelection, onPaste, pasteLabel = 'Paste', getDropPoint, produceFlavors, jsonReplacer } = options;\n  // Fall back to the ambient pointer context (auto-published by SceneCanvas)\n  // when the caller didn't supply an explicit `getDropPoint`. Null context\n  // (no provider in scope) and no caller-supplied thunk together mean\n  // \"no drop point\" — paste uses the cascade offset instead.\n  const pointerCtx = usePointerContext();\n  const effectiveGetDropPoint = getDropPoint ?? pointerCtx?.getDropPoint;\n  const clipboardRef = useRef<ClipboardSnapshot>(EMPTY);\n  // Keep callbacks stable across renders.\n  const adapterRef = useLatest(adapter);\n  const optsRef = useLatest({\n    getSelection, onPaste, pasteLabel, getDropPoint: effectiveGetDropPoint, produceFlavors, jsonReplacer,\n  });\n\n  const copy = useCallback(() => {\n    const ids = optsRef.current.getSelection();\n    if (ids.length === 0) return;\n    const snap = adapterRef.current.snapshotSelection;\n    if (!snap) return;\n    clipboardRef.current = snap(ids);\n    // Best-effort OS write. Never blocks or throws — the in-memory ref is\n    // already set, and OS clipboard support varies (custom formats are\n    // Chromium-only via the \"web \" prefix; jsdom/non-secure contexts have\n    // no API at all). The flavor producer itself is untrusted consumer code\n    // (`produceFlavors`), so guard its call too — a throwing producer must\n    // not break `copy()`, it just skips the OS write.\n    let flavors: ClipboardFlavors | null = null;\n    try {\n      flavors = optsRef.current.produceFlavors?.(clipboardRef.current)\n        ?? defaultFlavors(clipboardRef.current, optsRef.current.jsonReplacer);\n    } catch (err) {\n      dwarn('clipboard', `flavor producer threw — skipping OS write: ${String(err)}`);\n    }\n    if (flavors) void writeOsClipboard(flavors);\n  }, [adapterRef, optsRef]);\n\n  const paste = useCallback(() => {\n    const cb = clipboardRef.current;\n    if (cb.items.length === 0) return;\n    const a = adapterRef.current;\n    const result = materializePaste(a, cb, {\n      currentSelection: optsRef.current.getSelection(),\n      dropPoint: optsRef.current.getDropPoint?.(),\n    });\n    if (!result) return;\n    dispatchApplyBatch(a, result.ops, optsRef.current.pasteLabel);\n    // Use the just-created objects as the next cascade source. Re-snapshotting\n    // via `adapter.snapshotSelection(newIds)` would read adapter state, but\n    // React-state adapters haven't flushed yet — `itemsRef.current` still\n    // points at the pre-insert array, so the snapshot would come back empty\n    // and the next paste would no-op.\n    clipboardRef.current = { items: result.created };\n    optsRef.current.onPaste?.(result.newIds as NodeId[]);\n  }, [adapterRef, optsRef]);\n\n  const isEmpty = useCallback(() => clipboardRef.current.items.length === 0, []);\n\n  return { copy, paste, isEmpty };\n}\n\nfunction defaultFlavors(snapshot: ClipboardSnapshot, replacer?: Replacer): ClipboardFlavors {\n  const text = buildWeaselClipboardText(snapshot.items, replacer);\n  return { [WEASEL_CLIPBOARD_MIME]: text, 'text/plain': text };\n}\n\n/** MIME types the async Clipboard API accepts unprefixed. Every other type\n *  (including our own custom MIME, and app-supplied flavors like\n *  `image/svg+xml`) must carry Chromium's `web ` prefix or `ClipboardItem`'s\n *  constructor throws. */\nconst WELL_KNOWN_CLIPBOARD_MIMES = new Set(['text/plain', 'text/html', 'image/png']);\n\n/** Degradation ladder: full map (every non-well-known MIME web-prefixed) →\n *  the same minus any promised flavor that rejected → well-known-only → give\n *  up with a dwarn. Chromium writes nothing when one flavor rejects, so a\n *  rejection costs only that flavor, never the clipboard's previous content\n *  half-overwritten.\n *  @internal test seam — exported so unit tests can await the fire-and-forget\n *  write directly; tests should still exercise this at least once through\n *  the public `copy()` (see clipboardOps.test.tsx). */\nexport async function writeOsClipboard(flavors: ClipboardFlavors): Promise<void> {\n  const entries = Object.entries(flavors);\n  if (entries.length === 0) return;\n  const cb = typeof navigator !== 'undefined' ? navigator.clipboard : undefined;\n  if (!cb?.write || typeof ClipboardItem === 'undefined') return;\n  const rejected = new Set<string>();\n  for (const [mime, text] of entries) {\n    if (typeof text !== 'string') text.catch(() => { rejected.add(mime); });\n  }\n  const wireMime = (mime: string) => (WELL_KNOWN_CLIPBOARD_MIMES.has(mime) ? mime : `web ${mime}`);\n  const toItem = (fs: Flavor[]) => new ClipboardItem(Object.fromEntries(\n    fs.map(([mime, text]) => {\n      const wire = wireMime(mime);\n      const blob = (t: string) => new Blob([t], { type: wire });\n      if (typeof text === 'string') return [wire, blob(text)];\n      const promised = text.then(blob);\n      // Chromium leaves a ClipboardItem's rejected promise unhandled.\n      promised.catch(() => {});\n      return [wire, promised];\n    }),\n  ));\n  // Writes `fs`, dropping flavors whose promise rejected and retrying the\n  // rest. Returns the last error, or null once a write lands.\n  const writeLive = async (fs: Flavor[]): Promise<unknown> => {\n    let live = fs;\n    for (;;) {\n      try {\n        await cb.write([toItem(live)]);\n        return null;\n      } catch (err) {\n        const next = live.filter(([mime]) => !rejected.has(mime));\n        if (next.length === live.length || next.length === 0) return err;\n        live = next;\n      }\n    }\n  };\n  if (await writeLive(entries) === null) return;\n  const standard = entries.filter(([mime]) => WELL_KNOWN_CLIPBOARD_MIMES.has(mime) && !rejected.has(mime));\n  if (standard.length === 0) { dwarn('clipboard', 'OS write failed; no standard flavors to fall back to'); return; }\n  const err = await writeLive(standard);\n  if (err !== null) dwarn('clipboard', `OS clipboard write failed twice — copy stays in-memory only: ${String(err)}`);\n}\n\ntype Flavor = [mime: string, text: string | Promise<string>];\n"],"mappings":"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"}
+{"version":3,"file":"clipboardOps.js","names":["EMPTY","useClipboardOps","options","pointerCtx","usePointerContext","effectiveGetDropPoint","getDropPoint","clipboardRef","useRef","adapterRef","useLatest","adapter","optsRef","useCallback","ids","snap","flavors","defaultFlavors","err","writeOsClipboard","cb","a","result","materializePaste","dispatchApplyBatch","text","buildWeaselClipboardText","snapshot","replacer","WEASEL_CLIPBOARD_MIME","WELL_KNOWN_CLIPBOARD_MIMES","entries","rejected","mime","wireMime","toItem","fs","wire","blob","t","promised","writeLive","live","next","standard","dwarn"],"sources":["../../../../src/interactions/actions/clipboard/clipboardOps.ts"],"sourcesContent":["import { useCallback, useRef } from 'react';\nimport { useLatest } from '@weasel-js/react';\nimport type { NodeId } from 'core/scene/types';\nimport { dispatchApplyBatch } from 'core/applyOps';\nimport type { InsertAdapter, PasteOmission } from 'core/adapters/types';\nimport type { ClipboardSnapshot } from './types';\nimport { usePointerContext } from '@weasel-js/routing/react';\nimport { dwarn } from 'debug/flag';\nimport { materializePaste } from './materializePaste';\nimport { WEASEL_CLIPBOARD_MIME, buildWeaselClipboardText } from './wireFormat';\n\ntype Replacer = (key: string, value: unknown) => unknown;\n\n/** Options for `useClipboardOps`. */\nexport interface UseClipboardOpsOptions {\n  /** How the hook reads \"current selection\" for copy. The kit doesn't assume\n   *  a global selection store; each consumer wires this. */\n  getSelection: () => NodeId[];\n  /** Called after a successful paste with the ids of the newly inserted objects. */\n  onPaste?: (newIds: NodeId[]) => void;\n  /** Called when a paste left copied nodes out, with each one and the reason\n   *  — an edge whose endpoints were not copied with it, say. Also called for\n   *  a paste that made nothing. */\n  onPasteOmitted?: (omitted: PasteOmission[]) => void;\n  /** Label for the history entry produced by paste. Default 'Paste'. */\n  pasteLabel?: string;\n  /** Pulled once per paste() call. When non-null, threaded to commitPaste\n   *  as `ctx.dropPoint`; adapters typically use it as the cluster origin\n   *  (ignoring `offset`). When null/undefined, the hook falls back to the\n   *  existing cascade-offset behavior. */\n  getDropPoint?: () => { worldX: number; worldY: number } | null;\n  /** Produce the OS-clipboard flavor map for a copied snapshot. Keys are MIME\n   *  types, values the serialized payload. The kit default emits\n   *  `application/x-weasel-clipboard+json` plus `text/plain` carrying the\n   *  same JSON. Apps override to add richer flavors (e.g. real SVG) or to\n   *  replace the text flavor. Return an empty object to skip the OS write\n   *  entirely. A value may be a promise — an SVG flavor waiting on\n   *  `warmSvg`, say: the write is still issued inside the copy gesture and\n   *  the clipboard takes the text when it resolves. The producer itself runs\n   *  synchronously, so it reads the selection as it stood at the copy. */\n  produceFlavors?: (snapshot: ClipboardSnapshot) => ClipboardFlavors;\n  /** Replacer for the kit-default JSON flavor (typed arrays etc.). Ignored\n   *  when `produceFlavors` is supplied. */\n  jsonReplacer?: Replacer;\n}\n\n/** MIME type to payload, as `produceFlavors` returns it. */\nexport type ClipboardFlavors = Record<string, string | Promise<string>>;\n\n/** Return shape of `useClipboardOps`: imperative `copy`, `paste`, and `isEmpty` functions. */\nexport interface UseClipboardOpsReturn {\n  copy(): void;\n  paste(): void;\n  isEmpty(): boolean;\n}\n\nconst EMPTY: ClipboardSnapshot = { items: [] };\n\n/** In-memory copy/paste of selections via `InsertAdapter.snapshotSelection` / `commitPaste`. */\nexport function useClipboardOps<TNode extends { id: string }>(\n  adapter: InsertAdapter<TNode>,\n  options: UseClipboardOpsOptions,\n): UseClipboardOpsReturn {\n  const {\n    getSelection, onPaste, onPasteOmitted, pasteLabel = 'Paste', getDropPoint, produceFlavors, jsonReplacer,\n  } = options;\n  // Fall back to the ambient pointer context (auto-published by SceneCanvas)\n  // when the caller didn't supply an explicit `getDropPoint`. Null context\n  // (no provider in scope) and no caller-supplied thunk together mean\n  // \"no drop point\" — paste uses the cascade offset instead.\n  const pointerCtx = usePointerContext();\n  const effectiveGetDropPoint = getDropPoint ?? pointerCtx?.getDropPoint;\n  const clipboardRef = useRef<ClipboardSnapshot>(EMPTY);\n  // Keep callbacks stable across renders.\n  const adapterRef = useLatest(adapter);\n  const optsRef = useLatest({\n    getSelection, onPaste, onPasteOmitted, pasteLabel, getDropPoint: effectiveGetDropPoint, produceFlavors,\n    jsonReplacer,\n  });\n\n  const copy = useCallback(() => {\n    const ids = optsRef.current.getSelection();\n    if (ids.length === 0) return;\n    const snap = adapterRef.current.snapshotSelection;\n    if (!snap) return;\n    clipboardRef.current = snap(ids);\n    // Best-effort OS write. Never blocks or throws — the in-memory ref is\n    // already set, and OS clipboard support varies (custom formats are\n    // Chromium-only via the \"web \" prefix; jsdom/non-secure contexts have\n    // no API at all). The flavor producer itself is untrusted consumer code\n    // (`produceFlavors`), so guard its call too — a throwing producer must\n    // not break `copy()`, it just skips the OS write.\n    let flavors: ClipboardFlavors | null = null;\n    try {\n      flavors = optsRef.current.produceFlavors?.(clipboardRef.current)\n        ?? defaultFlavors(clipboardRef.current, optsRef.current.jsonReplacer);\n    } catch (err) {\n      dwarn('clipboard', `flavor producer threw — skipping OS write: ${String(err)}`);\n    }\n    if (flavors) void writeOsClipboard(flavors);\n  }, [adapterRef, optsRef]);\n\n  const paste = useCallback(() => {\n    const cb = clipboardRef.current;\n    if (cb.items.length === 0) return;\n    const a = adapterRef.current;\n    const result = materializePaste(a, cb, {\n      currentSelection: optsRef.current.getSelection(),\n      dropPoint: optsRef.current.getDropPoint?.(),\n      onOmitted: optsRef.current.onPasteOmitted,\n    });\n    if (!result) return;\n    dispatchApplyBatch(a, result.ops, optsRef.current.pasteLabel);\n    // Use the just-created objects as the next cascade source. Re-snapshotting\n    // via `adapter.snapshotSelection(newIds)` would read adapter state, but\n    // React-state adapters haven't flushed yet — `itemsRef.current` still\n    // points at the pre-insert array, so the snapshot would come back empty\n    // and the next paste would no-op.\n    clipboardRef.current = { items: result.created };\n    optsRef.current.onPaste?.(result.newIds as NodeId[]);\n  }, [adapterRef, optsRef]);\n\n  const isEmpty = useCallback(() => clipboardRef.current.items.length === 0, []);\n\n  return { copy, paste, isEmpty };\n}\n\nfunction defaultFlavors(snapshot: ClipboardSnapshot, replacer?: Replacer): ClipboardFlavors {\n  const text = buildWeaselClipboardText(snapshot.items, replacer);\n  return { [WEASEL_CLIPBOARD_MIME]: text, 'text/plain': text };\n}\n\n/** MIME types the async Clipboard API accepts unprefixed. Every other type\n *  (including our own custom MIME, and app-supplied flavors like\n *  `image/svg+xml`) must carry Chromium's `web ` prefix or `ClipboardItem`'s\n *  constructor throws. */\nconst WELL_KNOWN_CLIPBOARD_MIMES = new Set(['text/plain', 'text/html', 'image/png']);\n\n/** Degradation ladder: full map (every non-well-known MIME web-prefixed) →\n *  the same minus any promised flavor that rejected → well-known-only → give\n *  up with a dwarn. Chromium writes nothing when one flavor rejects, so a\n *  rejection costs only that flavor, never the clipboard's previous content\n *  half-overwritten.\n *  @internal test seam — exported so unit tests can await the fire-and-forget\n *  write directly; tests should still exercise this at least once through\n *  the public `copy()` (see clipboardOps.test.tsx). */\nexport async function writeOsClipboard(flavors: ClipboardFlavors): Promise<void> {\n  const entries = Object.entries(flavors);\n  if (entries.length === 0) return;\n  const cb = typeof navigator !== 'undefined' ? navigator.clipboard : undefined;\n  if (!cb?.write || typeof ClipboardItem === 'undefined') return;\n  const rejected = new Set<string>();\n  for (const [mime, text] of entries) {\n    if (typeof text !== 'string') text.catch(() => { rejected.add(mime); });\n  }\n  const wireMime = (mime: string) => (WELL_KNOWN_CLIPBOARD_MIMES.has(mime) ? mime : `web ${mime}`);\n  const toItem = (fs: Flavor[]) => new ClipboardItem(Object.fromEntries(\n    fs.map(([mime, text]) => {\n      const wire = wireMime(mime);\n      const blob = (t: string) => new Blob([t], { type: wire });\n      if (typeof text === 'string') return [wire, blob(text)];\n      const promised = text.then(blob);\n      // Chromium leaves a ClipboardItem's rejected promise unhandled.\n      promised.catch(() => {});\n      return [wire, promised];\n    }),\n  ));\n  // Writes `fs`, dropping flavors whose promise rejected and retrying the\n  // rest. Returns the last error, or null once a write lands.\n  const writeLive = async (fs: Flavor[]): Promise<unknown> => {\n    let live = fs;\n    for (;;) {\n      try {\n        await cb.write([toItem(live)]);\n        return null;\n      } catch (err) {\n        const next = live.filter(([mime]) => !rejected.has(mime));\n        if (next.length === live.length || next.length === 0) return err;\n        live = next;\n      }\n    }\n  };\n  if (await writeLive(entries) === null) return;\n  const standard = entries.filter(([mime]) => WELL_KNOWN_CLIPBOARD_MIMES.has(mime) && !rejected.has(mime));\n  if (standard.length === 0) { dwarn('clipboard', 'OS write failed; no standard flavors to fall back to'); return; }\n  const err = await writeLive(standard);\n  if (err !== null) dwarn('clipboard', `OS clipboard write failed twice — copy stays in-memory only: ${String(err)}`);\n}\n\ntype Flavor = [mime: string, text: string | Promise<string>];\n"],"mappings":"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"}

package/dist/interactions/actions/clipboard/materializePaste.js

@@ -7,16 +7,19 @@ function n(n, r, i) {
 	let o = n.getPasteOffset?.(r) ?? {
 		dx: 0,
 		dy: 0
-	}, s = i.dropPoint == null ? void 0 : { dropPoint: i.dropPoint }, c = a.call(n, r, o, s);
-	if (c.length === 0) return null;
-	let l = c.map((e) => e.id);
+	}, s = [], c = {
+		...i.dropPoint == null ? {} : { dropPoint: i.dropPoint },
+		...i.onOmitted ? { onOmit: (e) => s.push(e) } : {}
+	}, l = a.call(n, r, o, Object.keys(c).length > 0 ? c : void 0);
+	if (s.length > 0 && i.onOmitted?.(s), l.length === 0) return null;
+	let u = l.map((e) => e.id);
 	return {
-		ops: [...c.map((t) => e({ node: t })), t({
+		ops: [...l.map((t) => e({ node: t })), t({
 			from: i.currentSelection,
-			to: l
+			to: u
 		})],
-		newIds: l,
-		created: c
+		newIds: u,
+		created: l
 	};
 }
 //#endregion

package/dist/interactions/actions/clipboard/materializePaste.js.map

@@ -1 +1 @@
-{"version":3,"file":"materializePaste.js","names":["materializePaste","commitPaste","adapter","offset","snapshot","ctx","opts","created","newIds","o","createInsertOp","createSetSelectionOp"],"sources":["../../../../src/interactions/actions/clipboard/materializePaste.ts"],"sourcesContent":["/**\n * Shared paste materialization — the one place the paste recipe lives:\n * offset policy → `commitPaste` → the op batch (InsertOps parents-first +\n * a SetSelectionOp). Both `useClipboardOps.paste` (in-memory paste) and the\n * kit weasel-JSON content handler (OS-clipboard paste) dispatch exactly this\n * batch, so the two arrival paths stay indistinguishable in history.\n *\n * Pure: no dispatching here — callers own how the ops are applied\n * (`dispatchApplyBatch` vs `IngestCtx.applyOps`) and any post-paste\n * bookkeeping (the hook's cascade re-snapshot, the handler's selection set).\n */\nimport { createInsertOp } from 'core/ops/create';\nimport { createSetSelectionOp } from 'core/ops/select';\nimport type { Op } from 'core/ops/types';\nimport type { NodeId } from 'core/scene/types';\nimport type { ClipboardSnapshot, InsertAdapter } from 'core/adapters/types';\n\n/** Shared paste materialization: offset policy → commitPaste → the op batch\n *  both the in-memory paste and the OS-paste handler dispatch. Returns null\n *  when the adapter can't paste or nothing was created. */\nexport function materializePaste<TNode extends { id: string }>(\n  adapter: InsertAdapter<TNode>,\n  snapshot: ClipboardSnapshot,\n  opts: {\n    currentSelection: string[];\n    dropPoint?: { worldX: number; worldY: number } | null;\n  },\n): { ops: Op[]; newIds: string[]; created: TNode[] } | null {\n  const commitPaste = adapter.commitPaste;\n  if (!commitPaste) return null;\n  const offset = adapter.getPasteOffset?.(snapshot) ?? { dx: 0, dy: 0 };\n  const ctx = opts.dropPoint != null ? { dropPoint: opts.dropPoint } : undefined;\n  const created = commitPaste.call(adapter, snapshot, offset, ctx);\n  if (created.length === 0) return null;\n  const newIds = created.map((o) => o.id);\n  const ops: Op[] = [\n    ...created.map((o) => createInsertOp({ node: o })),\n    createSetSelectionOp({ from: opts.currentSelection as NodeId[], to: newIds as NodeId[] }),\n  ];\n  return { ops, newIds, created };\n}\n"],"mappings":";;;AAoBA,SAAgBA,EACd,GACA,GACA,GAI0D;CAC1D,IAAMC,IAAcC,EAAQ;CAC5B,IAAI,CAACD,GAAa,OAAO;CACzB,IAAME,IAASD,EAAQ,iBAAiBE,CAAQ,KAAK;EAAE,IAAI;EAAG,IAAI;CAAE,GAC9DC,IAAMC,EAAK,aAAa,OAAuC,KAAA,IAAhC,EAAE,WAAWA,EAAK,UAAU,GAC3DC,IAAUN,EAAY,KAAKC,GAASE,GAAUD,GAAQE,CAAG;CAC/D,IAAIE,EAAQ,WAAW,GAAG,OAAO;CACjC,IAAMC,IAASD,EAAQ,KAAK,MAAME,EAAE,EAAE;CAKtC,OAAO;EAAE,KAAA,CAHP,GAAGF,EAAQ,KAAK,MAAMG,EAAe,EAAE,MAAMD,EAAE,CAAC,CAAC,GACjDE,EAAqB;GAAE,MAAML,EAAK;GAA8B,IAAIE;EAAmB,CAAC,CAEjF;EAAK;EAAQ;CAAQ;AAChC"}
+{"version":3,"file":"materializePaste.js","names":["materializePaste","commitPaste","adapter","offset","snapshot","omitted","ctx","opts","omission","created","newIds","o","createInsertOp","createSetSelectionOp"],"sources":["../../../../src/interactions/actions/clipboard/materializePaste.ts"],"sourcesContent":["/**\n * Shared paste materialization — the one place the paste recipe lives:\n * offset policy → `commitPaste` → the op batch (InsertOps parents-first +\n * a SetSelectionOp). Both `useClipboardOps.paste` (in-memory paste) and the\n * kit weasel-JSON content handler (OS-clipboard paste) dispatch exactly this\n * batch, so the two arrival paths stay indistinguishable in history.\n *\n * Pure: no dispatching here — callers own how the ops are applied\n * (`dispatchApplyBatch` vs `IngestCtx.applyOps`) and any post-paste\n * bookkeeping (the hook's cascade re-snapshot, the handler's selection set).\n */\nimport { createInsertOp } from 'core/ops/create';\nimport { createSetSelectionOp } from 'core/ops/select';\nimport type { Op } from 'core/ops/types';\nimport type { NodeId } from 'core/scene/types';\nimport type { ClipboardSnapshot, InsertAdapter, PasteCtx, PasteOmission } from 'core/adapters/types';\n\n/** Shared paste materialization: offset policy → commitPaste → the op batch\n *  both the in-memory paste and the OS-paste handler dispatch. Returns null\n *  when the adapter can't paste or nothing was created. */\nexport function materializePaste<TNode extends { id: string }>(\n  adapter: InsertAdapter<TNode>,\n  snapshot: ClipboardSnapshot,\n  opts: {\n    currentSelection: string[];\n    dropPoint?: { worldX: number; worldY: number } | null;\n    /** Told what the paste left out and why, when it left anything out —\n     *  including a paste that made nothing. */\n    onOmitted?: (omitted: PasteOmission[]) => void;\n  },\n): { ops: Op[]; newIds: string[]; created: TNode[] } | null {\n  const commitPaste = adapter.commitPaste;\n  if (!commitPaste) return null;\n  const offset = adapter.getPasteOffset?.(snapshot) ?? { dx: 0, dy: 0 };\n  const omitted: PasteOmission[] = [];\n  const ctx: PasteCtx = {\n    ...(opts.dropPoint != null ? { dropPoint: opts.dropPoint } : {}),\n    ...(opts.onOmitted ? { onOmit: (omission: PasteOmission) => omitted.push(omission) } : {}),\n  };\n  const created = commitPaste.call(\n    adapter, snapshot, offset, Object.keys(ctx).length > 0 ? ctx : undefined,\n  );\n  if (omitted.length > 0) opts.onOmitted?.(omitted);\n  if (created.length === 0) return null;\n  const newIds = created.map((o) => o.id);\n  const ops: Op[] = [\n    ...created.map((o) => createInsertOp({ node: o })),\n    createSetSelectionOp({ from: opts.currentSelection as NodeId[], to: newIds as NodeId[] }),\n  ];\n  return { ops, newIds, created };\n}\n"],"mappings":";;;AAoBA,SAAgBA,EACd,GACA,GACA,GAO0D;CAC1D,IAAMC,IAAcC,EAAQ;CAC5B,IAAI,CAACD,GAAa,OAAO;CACzB,IAAME,IAASD,EAAQ,iBAAiBE,CAAQ,KAAK;EAAE,IAAI;EAAG,IAAI;CAAE,GAC9DC,IAA2B,CAAC,GAC5BC,IAAgB;EACpB,GAAIC,EAAK,aAAa,OAAuC,CAAC,IAAjC,EAAE,WAAWA,EAAK,UAAU;EACzD,GAAIA,EAAK,YAAY,EAAE,SAAS,MAA4BF,EAAQ,KAAKG,CAAQ,EAAE,IAAI,CAAC;CAC1F,GACMC,IAAUR,EAAY,KAC1BC,GAASE,GAAUD,GAAQ,OAAO,KAAKG,CAAG,CAAC,CAAC,SAAS,IAAIA,IAAM,KAAA,CACjE;CAEA,IADID,EAAQ,SAAS,KAAGE,EAAK,YAAYF,CAAO,GAC5CI,EAAQ,WAAW,GAAG,OAAO;CACjC,IAAMC,IAASD,EAAQ,KAAK,MAAME,EAAE,EAAE;CAKtC,OAAO;EAAE,KAAA,CAHP,GAAGF,EAAQ,KAAK,MAAMG,EAAe,EAAE,MAAMD,EAAE,CAAC,CAAC,GACjDE,EAAqB;GAAE,MAAMN,EAAK;GAA8B,IAAIG;EAAmB,CAAC,CAEjF;EAAK;EAAQ;CAAQ;AAChC"}

package/dist/interactions/actions/clipboard/wireFormat.js.map

@@ -1 +1 @@
-{"version":3,"file":"wireFormat.js","names":["WEASEL_CLIPBOARD_MIME","WEASEL_CLIPBOARD_MIME_WEB","buildWeaselClipboardText","items","replacer","sniffWeaselClipboardText","text","parsed","SVG_OPEN_TAG","embedWeaselMetadataInSvg","open","svgText","dwarn","cdata","payloadText","at","extractWeaselClipboardFromSvg","block","inner","payload","m","parseWeaselClipboardText","reviver","err"],"sources":["../../../../src/interactions/actions/clipboard/wireFormat.ts"],"sourcesContent":["import { dwarn } from 'debug/flag';\n\n/** MIME type the kit writes its full-fidelity clipboard payload under, so a\n *  copy/paste between two weasel canvases round-trips scene nodes rather than\n *  the SVG or text flavors other apps read. */\nexport const WEASEL_CLIPBOARD_MIME = 'application/x-weasel-clipboard+json';\n/** Chromium's async-clipboard spelling for custom formats. */\nexport const WEASEL_CLIPBOARD_MIME_WEB = `web ${WEASEL_CLIPBOARD_MIME}`;\n\ninterface WeaselClipboardPayload { weaselClipboard: 1; nodes: unknown[] }\n\ntype Replacer = (key: string, value: unknown) => unknown;\ntype Reviver = (key: string, value: unknown) => unknown;\n\n/** Serialize snapshot items into the versioned wire text.\n *\n *  Function-valued fields (e.g. a container's `clipFromPose`) are dropped by\n *  JSON serialization — OS-pasted clip containers arrive unclipped.\n *  Consumers who need clips to survive the OS round-trip can translate\n *  function ↔ registry key in their `jsonReplacer`/reviver pair (the\n *  scene-serialization `clipFromPoseKey` precedent). */\nexport function buildWeaselClipboardText(items: unknown[], replacer?: Replacer): string {\n  const payload: WeaselClipboardPayload = { weaselClipboard: 1, nodes: items };\n  return JSON.stringify(payload, replacer as Parameters<typeof JSON.stringify>[1]);\n}\n\n/** Cheap check: could this text be a weasel clipboard payload? Substring\n *  pre-check, then a guarded parse + marker/version test. */\nexport function sniffWeaselClipboardText(text: string): boolean {\n  if (!text.includes('\"weaselClipboard\"')) return false;\n  try {\n    const parsed = JSON.parse(text) as Partial<WeaselClipboardPayload> | null;\n    return !!parsed && parsed.weaselClipboard === 1;\n  } catch {\n    return false;\n  }\n}\n\n// Opening `<svg ...>` tag of a serialized document. `[^>]*` is safe for OUR\n// serializer's output (attribute values are XML-escaped, so no raw `>` can\n// appear inside the tag) — see embedWeaselMetadataInSvg's contract note.\nconst SVG_OPEN_TAG = /<svg(?:\\s[^>]*)?>/i;\n\n/**\n * Embed a weasel clipboard payload in an SVG document as a `<metadata>`\n * child of the root — legal SVG 1.1, ignored by external tools — so one\n * `text/plain` flavor serves both audiences: external tools parse the SVG,\n * weasel extracts the JSON for full fidelity on draw→draw DOM paste.\n *\n * The payload rides in CDATA so JSON's `<` / `&` need no entity escaping; a\n * literal `]]>` inside the payload is split across CDATA sections\n * (`]]]]><![CDATA[>`), which {@link extractWeaselClipboardFromSvg} rejoins.\n *\n * Intended for OUR serializer's output only (`serializeSvg` — single\n * `<svg ...>` open tag, XML-escaped attributes). When no open tag is found\n * the input is returned unchanged with a debug warning.\n */\nexport function embedWeaselMetadataInSvg(svgText: string, payloadText: string): string {\n  const open = SVG_OPEN_TAG.exec(svgText);\n  if (!open) {\n    dwarn('clipboard', 'embedWeaselMetadataInSvg: no <svg ...> open tag found — returning input unchanged');\n    return svgText;\n  }\n  const cdata = `<![CDATA[${payloadText.replaceAll(']]>', ']]]]><![CDATA[>')}]]>`;\n  const at = open.index + open[0].length;\n  return `${svgText.slice(0, at)}<metadata>${cdata}</metadata>${svgText.slice(at)}`;\n}\n\n/**\n * Recover an embedded weasel clipboard payload from SVG text: read the first\n * `<metadata>` block, rejoin its CDATA sections (concatenation restores the\n * `]]>` split by {@link embedWeaselMetadataInSvg}; plain non-CDATA content\n * passes through as-is), and return the payload text iff it sniffs as the\n * weasel wire format — else null (external/non-weasel metadata declines).\n *\n * A text scan, not an XML parse — the payload is small and ours.\n */\nexport function extractWeaselClipboardFromSvg(svgText: string): string | null {\n  const block = /<metadata(?:\\s[^>]*)?>([\\s\\S]*?)<\\/metadata>/i.exec(svgText);\n  if (!block) return null;\n  const inner = block[1];\n  const payload = inner.includes('<![CDATA[')\n    ? Array.from(inner.matchAll(/<!\\[CDATA\\[([\\s\\S]*?)\\]\\]>/g), (m) => m[1]).join('')\n    : inner;\n  return sniffWeaselClipboardText(payload) ? payload : null;\n}\n\n/** Parse wire text to snapshot items, or null when malformed/mismatched\n *  (callers decline to the next content handler). */\nexport function parseWeaselClipboardText(text: string, reviver?: Reviver): unknown[] | null {\n  try {\n    const parsed = JSON.parse(text, reviver as Parameters<typeof JSON.parse>[1]) as\n      Partial<WeaselClipboardPayload> | null;\n    if (!parsed || parsed.weaselClipboard !== 1 || !Array.isArray(parsed.nodes)) return null;\n    return parsed.nodes;\n  } catch (err) {\n    dwarn('clipboard', `weasel payload failed to parse: ${String(err)}`);\n    return null;\n  }\n}\n"],"mappings":";;AAKA,IAAaA,IAAwB,uCAExBC,IAA4B,OAAOD;AAchD,SAAgBE,EAAyB,GAAkB,GAA6B;CAEtF,OAAO,KAAK,UAAU;EADoB,iBAAiB;EAAG,OAAOC;CAC/C,GAASC,CAAgD;AACjF;AAIA,SAAgBC,EAAyB,GAAuB;CAC9D,IAAI,CAACC,EAAK,SAAS,qBAAmB,GAAG,OAAO;CAChD,IAAI;EACF,IAAMC,IAAS,KAAK,MAAMD,CAAI;EAC9B,OAAO,CAAC,CAACC,KAAUA,EAAO,oBAAoB;CAChD,QAAQ;EACN,OAAO;CACT;AACF;AAKA,IAAMC,IAAe;AAgBrB,SAAgBC,EAAyB,GAAiB,GAA6B;CACrF,IAAMC,IAAOF,EAAa,KAAKG,CAAO;CACtC,IAAI,CAACD,GAEH,OADAE,EAAM,aAAa,mFAAmF,GAC/FD;CAET,IAAME,IAAQ,YAAYC,EAAY,WAAW,OAAO,iBAAiB,EAAE,MACrEC,IAAKL,EAAK,QAAQA,EAAK,EAAE,CAAC;CAChC,OAAO,GAAGC,EAAQ,MAAM,GAAGI,CAAE,EAAE,YAAYF,EAAM,aAAaF,EAAQ,MAAMI,CAAE;AAChF;AAWA,SAAgBC,EAA8B,GAAgC;CAC5E,IAAMC,IAAQ,gDAAgD,KAAKN,CAAO;CAC1E,IAAI,CAACM,GAAO,OAAO;CACnB,IAAMC,IAAQD,EAAM,IACdE,IAAUD,EAAM,SAAS,WAAW,IACtC,MAAM,KAAKA,EAAM,SAAS,6BAA6B,IAAI,MAAME,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,IAC9EF;CACJ,OAAOb,EAAyBc,CAAO,IAAIA,IAAU;AACvD;AAIA,SAAgBE,EAAyB,GAAc,GAAqC;CAC1F,IAAI;EACF,IAAMd,IAAS,KAAK,MAAMD,GAAMgB,CAA2C;EAG3E,OADI,CAACf,KAAUA,EAAO,oBAAoB,KAAK,CAAC,MAAM,QAAQA,EAAO,KAAK,IAAU,OAC7EA,EAAO;CAChB,SAASgB,GAAK;EAEZ,OADAX,EAAM,aAAa,mCAAmC,OAAOW,CAAG,GAAG,GAC5D;CACT;AACF"}
+{"version":3,"file":"wireFormat.js","names":["WEASEL_CLIPBOARD_MIME","WEASEL_CLIPBOARD_MIME_WEB","buildWeaselClipboardText","items","replacer","sniffWeaselClipboardText","text","parsed","SVG_OPEN_TAG","embedWeaselMetadataInSvg","open","svgText","dwarn","cdata","payloadText","at","extractWeaselClipboardFromSvg","block","inner","payload","m","parseWeaselClipboardText","reviver","err"],"sources":["../../../../src/interactions/actions/clipboard/wireFormat.ts"],"sourcesContent":["import { dwarn } from 'debug/flag';\n\n/** MIME type the kit writes its full-fidelity clipboard payload under, so a\n *  copy/paste between two weasel canvases round-trips scene nodes rather than\n *  the SVG or text flavors other apps read. */\nexport const WEASEL_CLIPBOARD_MIME = 'application/x-weasel-clipboard+json';\n/** Chromium's async-clipboard spelling for custom formats. */\nexport const WEASEL_CLIPBOARD_MIME_WEB = `web ${WEASEL_CLIPBOARD_MIME}`;\n\ninterface WeaselClipboardPayload { weaselClipboard: 1; nodes: unknown[] }\n\ntype Replacer = (key: string, value: unknown) => unknown;\ntype Reviver = (key: string, value: unknown) => unknown;\n\n/** Serialize snapshot items into the versioned wire text.\n *\n *  JSON drops a function-valued field (a container's `clipFromPose`, a\n *  node's `derivePath`). A scene adapter's snapshot also carries each one's\n *  `SceneRegistry` key (`clipFromPoseKey`, `derivePathKey`, …), which does\n *  cross, and its paste restores the function from the pasting scene's\n *  registry. A function that is not registered does not survive. */\nexport function buildWeaselClipboardText(items: unknown[], replacer?: Replacer): string {\n  const payload: WeaselClipboardPayload = { weaselClipboard: 1, nodes: items };\n  return JSON.stringify(payload, replacer as Parameters<typeof JSON.stringify>[1]);\n}\n\n/** Cheap check: could this text be a weasel clipboard payload? Substring\n *  pre-check, then a guarded parse + marker/version test. */\nexport function sniffWeaselClipboardText(text: string): boolean {\n  if (!text.includes('\"weaselClipboard\"')) return false;\n  try {\n    const parsed = JSON.parse(text) as Partial<WeaselClipboardPayload> | null;\n    return !!parsed && parsed.weaselClipboard === 1;\n  } catch {\n    return false;\n  }\n}\n\n// `[^>]*` is safe for OUR serializer's output only: attribute values are\n// XML-escaped, so no raw `>` can appear inside the tag.\nconst SVG_OPEN_TAG = /<svg(?:\\s[^>]*)?>/i;\n\n/**\n * Embed a weasel clipboard payload in an SVG document as a `<metadata>`\n * child of the root — legal SVG 1.1, ignored by external tools — so one\n * `text/plain` flavor serves both audiences.\n *\n * Intended for OUR serializer's output only (`serializeSvg` — single\n * `<svg ...>` open tag, XML-escaped attributes). When no open tag is found\n * the input is returned unchanged with a debug warning.\n */\nexport function embedWeaselMetadataInSvg(svgText: string, payloadText: string): string {\n  const open = SVG_OPEN_TAG.exec(svgText);\n  if (!open) {\n    dwarn('clipboard', 'embedWeaselMetadataInSvg: no <svg ...> open tag found — returning input unchanged');\n    return svgText;\n  }\n  const cdata = `<![CDATA[${payloadText.replaceAll(']]>', ']]]]><![CDATA[>')}]]>`;\n  const at = open.index + open[0].length;\n  return `${svgText.slice(0, at)}<metadata>${cdata}</metadata>${svgText.slice(at)}`;\n}\n\n/**\n * The weasel clipboard payload embedded in SVG text by\n * {@link embedWeaselMetadataInSvg}, or null when the first `<metadata>` block\n * is absent or not the weasel wire format. A text scan, not an XML parse.\n */\nexport function extractWeaselClipboardFromSvg(svgText: string): string | null {\n  const block = /<metadata(?:\\s[^>]*)?>([\\s\\S]*?)<\\/metadata>/i.exec(svgText);\n  if (!block) return null;\n  const inner = block[1];\n  const payload = inner.includes('<![CDATA[')\n    ? Array.from(inner.matchAll(/<!\\[CDATA\\[([\\s\\S]*?)\\]\\]>/g), (m) => m[1]).join('')\n    : inner;\n  return sniffWeaselClipboardText(payload) ? payload : null;\n}\n\n/** Parse wire text to snapshot items, or null when malformed/mismatched\n *  (callers decline to the next content handler). */\nexport function parseWeaselClipboardText(text: string, reviver?: Reviver): unknown[] | null {\n  try {\n    const parsed = JSON.parse(text, reviver as Parameters<typeof JSON.parse>[1]) as\n      Partial<WeaselClipboardPayload> | null;\n    if (!parsed || parsed.weaselClipboard !== 1 || !Array.isArray(parsed.nodes)) return null;\n    return parsed.nodes;\n  } catch (err) {\n    dwarn('clipboard', `weasel payload failed to parse: ${String(err)}`);\n    return null;\n  }\n}\n"],"mappings":";;AAKA,IAAaA,IAAwB,uCAExBC,IAA4B,OAAOD;AAchD,SAAgBE,EAAyB,GAAkB,GAA6B;CAEtF,OAAO,KAAK,UAAU;EADoB,iBAAiB;EAAG,OAAOC;CAC/C,GAASC,CAAgD;AACjF;AAIA,SAAgBC,EAAyB,GAAuB;CAC9D,IAAI,CAACC,EAAK,SAAS,qBAAmB,GAAG,OAAO;CAChD,IAAI;EACF,IAAMC,IAAS,KAAK,MAAMD,CAAI;EAC9B,OAAO,CAAC,CAACC,KAAUA,EAAO,oBAAoB;CAChD,QAAQ;EACN,OAAO;CACT;AACF;AAIA,IAAMC,IAAe;AAWrB,SAAgBC,EAAyB,GAAiB,GAA6B;CACrF,IAAMC,IAAOF,EAAa,KAAKG,CAAO;CACtC,IAAI,CAACD,GAEH,OADAE,EAAM,aAAa,mFAAmF,GAC/FD;CAET,IAAME,IAAQ,YAAYC,EAAY,WAAW,OAAO,iBAAiB,EAAE,MACrEC,IAAKL,EAAK,QAAQA,EAAK,EAAE,CAAC;CAChC,OAAO,GAAGC,EAAQ,MAAM,GAAGI,CAAE,EAAE,YAAYF,EAAM,aAAaF,EAAQ,MAAMI,CAAE;AAChF;AAOA,SAAgBC,EAA8B,GAAgC;CAC5E,IAAMC,IAAQ,gDAAgD,KAAKN,CAAO;CAC1E,IAAI,CAACM,GAAO,OAAO;CACnB,IAAMC,IAAQD,EAAM,IACdE,IAAUD,EAAM,SAAS,WAAW,IACtC,MAAM,KAAKA,EAAM,SAAS,6BAA6B,IAAI,MAAME,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,IAC9EF;CACJ,OAAOb,EAAyBc,CAAO,IAAIA,IAAU;AACvD;AAIA,SAAgBE,EAAyB,GAAc,GAAqC;CAC1F,IAAI;EACF,IAAMd,IAAS,KAAK,MAAMD,GAAMgB,CAA2C;EAG3E,OADI,CAACf,KAAUA,EAAO,oBAAoB,KAAK,CAAC,MAAM,QAAQA,EAAO,KAAK,IAAU,OAC7EA,EAAO;CAChB,SAASgB,GAAK;EAEZ,OADAX,EAAM,aAAa,mCAAmC,OAAOW,CAAG,GAAG,GAC5D;CACT;AACF"}

package/dist/interactions/actions/clone/action.js

@@ -0,0 +1,98 @@
+import { translatePoseViaDescriptor as e } from "../../../core/geometry/poseDescriptor.js";
+import { runBehaviorCancel as t, runBehaviorSettled as n } from "../gestureLifecycle.js";
+import { carryPose as r, inPlane as i, invertPlane as a, planeOf as o, selectionLayer as s } from "../planeInput.js";
+import { nodeDescriptors as c, poseDescriptorOf as l } from "../poseDescriptorDep.js";
+import { selectedRoots as u, translateTargets as d } from "../selectionSubtree.js";
+import { scenePoseFrame as f } from "../poseFrame.js";
+import { defaultCommitAdapter as p } from "../defaultCommitAdapter.js";
+import { startCloneBehaviors as m } from "./behaviors.js";
+import { copySelection as h } from "../defaults/copySubtree.js";
+//#region src/interactions/actions/clone/action.ts
+function g(t, n, i, a) {
+	let s = t.originPoses.get(n), c = t.scene.get(n);
+	if (s === void 0 || !c) return;
+	let l = t.descriptorOf(n), u = e(s, i, a, l);
+	return t.frame.local(n, r(l, u, o(t.view, c.layer)));
+}
+function _(e, t, n) {
+	let { dx: r, dy: i } = e.currentDelta, a = (t) => {
+		e.applyOps ? e.applyOps(t, "Clone") : e.scene.applyBatch(t, "Clone", p(e.scene, n.adapterMethods));
+	}, o = t.end(e.currentDelta);
+	if (o === null) return !1;
+	if (o !== void 0) return o.length > 0 && a(o), !0;
+	let { ops: s, copies: c } = h(e.scene, e.ids, (t, n) => e.originPoses.has(t) ? g(e, t, r, i) : n.pose, "Clone");
+	return s.length !== 0 && (a(s), n.set(c), !0);
+}
+var v = i({
+	id: "clone",
+	label: "Clone",
+	cursor: "copy",
+	activeCursor: "copy",
+	eligible: { capability: ["edits-page", "creates-selection"] },
+	requires: [
+		"selection",
+		"scene",
+		"applyOps",
+		"poseDescriptor"
+	],
+	invoker: {
+		timing: "ongoing",
+		start(e, i) {
+			let s = e.deps.selection, p = e.deps.scene, h = e.deps.applyOps;
+			if (!s || !p) return {};
+			let v = s.get();
+			if (v.length === 0) return {};
+			let y = f(p), b = /* @__PURE__ */ new Map(), x = c(p, l(e.deps.poseDescriptor));
+			for (let t of d(p, y, v)) {
+				let n = p.get(t);
+				if (n === void 0) continue;
+				let i = a(o(e.deps.view, n.layer));
+				b.set(t, r(x(t), y.world(t), i));
+			}
+			if (b.size === 0) return {};
+			let S = {
+				ids: u(p, v),
+				scene: p,
+				descriptorOf: x,
+				frame: y,
+				originPoses: b,
+				view: e.deps.view,
+				currentDelta: {
+					dx: 0,
+					dy: 0
+				},
+				previews: /* @__PURE__ */ new Map(),
+				applyOps: h
+			}, C = m(e, i, p, S.ids, b, x);
+			return {
+				kind: "clone",
+				previewHidesSource: !1,
+				onMove(e) {
+					if (!e.drag) return;
+					S.currentDelta = C.shape(e, {
+						dx: e.drag.delta.x,
+						dy: e.drag.delta.y
+					}), S.previews.clear();
+					let { dx: t, dy: n } = S.currentDelta;
+					if (t !== 0 || n !== 0) for (let e of S.originPoses.keys()) S.previews.set(e, g(S, e, t, n));
+				},
+				onEnd(e, r) {
+					let i = !1;
+					try {
+						let { dx: e, dy: n } = S.currentDelta;
+						r === "commit" && (e !== 0 || n !== 0) ? i = _(S, C, s) : t(C.list, C.gctx);
+					} finally {
+						S.previews.clear(), n(C.list, C.gctx, i);
+					}
+				},
+				previewIds: () => S.previews.keys(),
+				previewPose: (e) => S.previews.get(e) ?? null
+			};
+		}
+	},
+	enabled: () => !0
+}, s);
+//#endregion
+export { v as cloneAction };
+
+//# sourceMappingURL=action.js.map

package/dist/interactions/actions/clone/action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action.js","names":["landed","origin","scratch","id","node","d","moved","translatePoseViaDescriptor","dx","dy","carryPose","planeOf","commitClone","apply","ops","defaultCommitAdapter","selection","answer","behaviors","copySelection","copies","cloneAction","inPlane","ctx","scene","applyOps","ids","frame","scenePoseFrame","originPoses","descriptorOf","nodeDescriptors","poseDescriptorOf","translateTargets","toEdited","invertPlane","selectedRoots","startCloneBehaviors","opts","moveCtx","committed","reason","runBehaviorCancel","runBehaviorSettled","selectionLayer"],"sources":["../../../../src/interactions/actions/clone/action.ts"],"sourcesContent":["/**\n * `cloneAction` — ongoing Action descriptor for alt-drag clone. Nothing is\n * written before the commit, so a cancel only clears the preview.\n *\n * The action does not gate on a modifier: it runs whenever the dispatcher\n * routes to it, and the binding that names it carries the `alt` requirement.\n */\n\nimport type { Action } from '@weasel-js/routing';\nimport type { BindingOpts, InvocationCtx, OngoingHandle } from '@weasel-js/routing';\nimport type { Scene, NodeId } from 'core/scene/types';\nimport type { Op } from 'core/ops/types';\nimport { defaultCommitAdapter } from '../defaultCommitAdapter';\nimport { runBehaviorCancel, runBehaviorSettled } from '../gestureLifecycle';\nimport { startCloneBehaviors, type CloneBehaviors } from './behaviors';\nimport type { SelectionApi } from 'core/selection/useSelection';\nimport { copySelection } from '../defaults/copySubtree';\nimport { selectedRoots, translateTargets } from '../selectionSubtree';\nimport { nodeDescriptors, poseDescriptorOf } from '../poseDescriptorDep';\nimport { translatePoseViaDescriptor, type PoseDescriptor } from '../resize/geometry';\nimport { scenePoseFrame, type PoseFrame } from '../poseFrame';\nimport { carryPose, invertPlane, inPlane, planeOf, selectionLayer } from '../planeInput';\n\ninterface CloneScratch {\n  /** The selected ids a copy starts from; each brings its subtree. */\n  ids: NodeId[];\n  scene: Scene<unknown, string, unknown>;\n  descriptorOf: (id: NodeId) => PoseDescriptor<unknown>;\n  /** World reads and local writes over the scene's composition strategy. */\n  frame: PoseFrame<unknown>;\n  /** Origin poses captured at drag start, in world — the frame the drag\n   *  delta is expressed in, and the plane the edit is measured in. The copy\n   *  keeps its source's parent and layer, so each translated result is\n   *  carried back to that layer's plane and stored in that same frame.\n   *  Holds every node the copy moves itself: a node stored in a copied frame\n   *  is absent, because the copy of that frame carries it. */\n  originPoses: Map<NodeId, unknown>;\n  /** The view the invocation started with, read for `planeOf`. */\n  view: unknown;\n  /** Running drag delta — updated each onMove, applied once at commit. */\n  currentDelta: { dx: number; dy: number };\n  /** Preview poses keyed by the original's id: the copies have no ids yet. */\n  previews: Map<NodeId, unknown>;\n  /** Optional consumer commit hook captured at gesture start. When present,\n   *  the insert ops route through it instead of `scene.applyBatch`. */\n  applyOps?: (ops: Op[], label: string) => void;\n}\n\n/** Where the copy of `id` lands for a drag of `(dx, dy)`, as stored. */\nfunction landed(scratch: CloneScratch, id: NodeId, dx: number, dy: number): unknown {\n  const origin = scratch.originPoses.get(id);\n  const node = scratch.scene.get(id);\n  if (origin === undefined || !node) return undefined;\n  const d = scratch.descriptorOf(id);\n  const moved = translatePoseViaDescriptor(origin, dx, dy, d);\n  return scratch.frame.local(id, carryPose(d, moved, planeOf(scratch.view, node.layer)));\n}\n\n/** Commit the drag: a behavior's ops when one claims it, else the copies,\n *  which become the selection. Returns whether anything was committed. */\nfunction commitClone(scratch: CloneScratch, behaviors: CloneBehaviors, selection: SelectionApi): boolean {\n  const { dx, dy } = scratch.currentDelta;\n  const apply = (ops: Op[]): void => {\n    if (scratch.applyOps) scratch.applyOps(ops, 'Clone');\n    else scratch.scene.applyBatch(ops, 'Clone', defaultCommitAdapter(scratch.scene, selection.adapterMethods));\n  };\n  const answer = behaviors.end(scratch.currentDelta);\n  if (answer === null) return false;\n  if (answer !== undefined) {\n    if (answer.length > 0) apply(answer);\n    return true;\n  }\n  const { ops, copies } = copySelection(\n    scratch.scene,\n    scratch.ids,\n    (id, node) => (scratch.originPoses.has(id) ? landed(scratch, id, dx, dy) : node.pose),\n    'Clone',\n  );\n  if (ops.length === 0) return false;\n  apply(ops);\n  selection.set(copies);\n  return true;\n}\n\n/**\n * @experimental\n * Static descriptor for the `clone` Action. Copies each selected node, with\n * its subtree, to where the drag left it. One undo entry.\n */\nexport const cloneAction: Action & { requires: string[] } = inPlane({\n  id: 'clone',\n  label: 'Clone',\n  // No default binding: a bare `{ kind: 'drag' }` would clone a non-empty\n  // selection on any drag no tool claimed. Alt-drag on a body binds it\n  // (`selectionMoveBindings`, the `move` preset).\n  // The platform's duplicate cursor. The select tool binds clone behind\n  // `mods: { alt: true }`, so the pump shows this only while Alt is down.\n  cursor: 'copy',\n  activeCursor: 'copy',\n  eligible: { capability: ['edits-page', 'creates-selection'] },\n  requires: ['selection', 'scene', 'applyOps', 'poseDescriptor'],\n  invoker: {\n    timing: 'ongoing',\n    start(ctx: InvocationCtx, opts?: BindingOpts): OngoingHandle {\n      const selection = ctx.deps.selection;\n      const scene = ctx.deps.scene;\n      const applyOps = ctx.deps.applyOps;\n\n      if (!selection || !scene) return {};\n\n      const ids = selection.get() as NodeId[];\n      if (ids.length === 0) return {};\n\n      // Capture origin poses once at drag start.\n      const frame = scenePoseFrame(scene);\n      const originPoses = new Map<NodeId, unknown>();\n      const descriptorOf = nodeDescriptors(scene, poseDescriptorOf(ctx.deps.poseDescriptor));\n      for (const id of translateTargets(scene, frame, ids)) {\n        const node = scene.get(id);\n        if (node === undefined) continue;\n        const toEdited = invertPlane(planeOf(ctx.deps.view, node.layer));\n        originPoses.set(id, carryPose(descriptorOf(id), frame.world(id), toEdited));\n      }\n\n      if (originPoses.size === 0) return {};\n\n      const scratch: CloneScratch = {\n        ids: selectedRoots(scene, ids),\n        scene,\n        descriptorOf,\n        frame,\n        originPoses,\n        view: ctx.deps.view,\n        currentDelta: { dx: 0, dy: 0 },\n        previews: new Map<NodeId, unknown>(),\n        applyOps,\n      };\n      const behaviors = startCloneBehaviors(ctx, opts, scene, scratch.ids, originPoses, descriptorOf);\n\n      return {\n        kind: 'clone',\n        // The source stays visible at its committed pose; the ghost appears\n        // at the drag target.\n        previewHidesSource: false,\n        onMove(moveCtx: InvocationCtx): void {\n          if (!moveCtx.drag) return;\n          scratch.currentDelta = behaviors.shape(moveCtx, { dx: moveCtx.drag.delta.x, dy: moveCtx.drag.delta.y });\n          scratch.previews.clear();\n          const { dx, dy } = scratch.currentDelta;\n          if (dx === 0 && dy === 0) return;\n          for (const id of scratch.originPoses.keys()) scratch.previews.set(id, landed(scratch, id, dx, dy)!);\n        },\n        onEnd(_endCtx: InvocationCtx, reason: 'commit' | 'cancel'): void {\n          let committed = false;\n          try {\n            const { dx, dy } = scratch.currentDelta;\n            // A zero-delta drag makes no clone, so its behaviors are canceled.\n            if (reason === 'commit' && (dx !== 0 || dy !== 0)) committed = commitClone(scratch, behaviors, selection);\n            else runBehaviorCancel(behaviors.list, behaviors.gctx);\n          } finally {\n            scratch.previews.clear();\n            runBehaviorSettled(behaviors.list, behaviors.gctx, committed);\n          }\n        },\n        previewIds: () => scratch.previews.keys(),\n        previewPose: (id: string) => scratch.previews.get(id as NodeId) ?? null,\n      };\n    },\n  },\n  enabled: () => true,\n}, selectionLayer);\n"],"mappings":"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"}

package/dist/interactions/actions/clone/behaviors.js

@@ -0,0 +1,52 @@
+import { translatePoseViaDescriptor as e } from "../../../core/geometry/poseDescriptor.js";
+import { reduceBehaviorEnd as t } from "../gestureLifecycle.js";
+import { gestureReaders as n } from "../../gestures/shared/screenTolerance.js";
+import { pointerStateOf as r } from "../pointerState.js";
+import { sceneGestureFrames as i } from "../gestureFrames.js";
+import { defaultCommitAdapter as a } from "../defaultCommitAdapter.js";
+//#region src/interactions/actions/clone/behaviors.ts
+function o(o, s, c, l, u, d) {
+	let f = s?.behaviors ?? [], p = n(o.deps), m = new Map(u), h = {
+		draggedIds: l,
+		origin: m,
+		current: new Map(m),
+		snap: null,
+		modifiers: { ...o.modifiers },
+		pointer: r(o.world, o),
+		view: p.view(),
+		plane: p.plane(),
+		frames: i(c, o.deps.view),
+		adapter: a(c, o.deps.selection?.adapterMethods),
+		scratch: {}
+	}, g = ({ dx: t, dy: n }) => {
+		for (let [r, i] of u) h.current.set(r, e(i, t, n, d(r)));
+	};
+	for (let e of f) e.onStart?.(h);
+	return {
+		list: f,
+		gctx: h,
+		shape(e, t) {
+			if (f.length === 0) return t;
+			h.modifiers = { ...e.modifiers }, h.pointer = r(e.world, e), h.view = p.view(), h.plane = p.plane(), g(t);
+			let n = {
+				kind: "translate",
+				...t
+			};
+			for (let e of f) {
+				let t = e.onMove?.(h, n);
+				t && (t.transform?.kind === "translate" && (n = t.transform), t.snap !== void 0 && (h.snap = t.snap));
+			}
+			return n.kind === "translate" ? {
+				dx: n.dx,
+				dy: n.dy
+			} : t;
+		},
+		end(e) {
+			return g(e), t(f, h);
+		}
+	};
+}
+//#endregion
+export { o as startCloneBehaviors };
+
+//# sourceMappingURL=behaviors.js.map

package/dist/interactions/actions/clone/behaviors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"behaviors.js","names":["startCloneBehaviors","list","opts","readers","gestureReaders","ctx","origin","origins","gctx","roots","pointerStateOf","sceneGestureFrames","scene","defaultCommitAdapter","place","id","pose","translatePoseViaDescriptor","dx","dy","descriptorOf","b","raw","moveCtx","transform","r","delta","reduceBehaviorEnd"],"sources":["../../../../src/interactions/actions/clone/behaviors.ts"],"sourcesContent":["import type { ActionDeps, BindingOpts, InvocationCtx } from '@weasel-js/routing';\nimport type { Op } from 'core/ops/types';\nimport type { NodeId, Scene } from 'core/scene/types';\nimport { gestureReaders, type GestureReaders } from '../../gestures/shared/screenTolerance';\nimport type { CloneBehavior, CloneBehaviorResult, GestureContext, GroupTransform } from '../../gestures/types';\nimport { defaultCommitAdapter } from '../defaultCommitAdapter';\nimport { sceneGestureFrames } from '../gestureFrames';\nimport { reduceBehaviorEnd } from '../gestureLifecycle';\nimport { pointerStateOf } from '../pointerState';\nimport { translatePoseViaDescriptor, type PoseDescriptor } from '../resize/geometry';\n\ntype Delta = { dx: number; dy: number };\n\n/** A clone drag's behaviors and the context they are told. */\nexport interface CloneBehaviors {\n  readonly list: readonly CloneBehavior<unknown>[];\n  readonly gctx: GestureContext<unknown>;\n  /** The drag's delta as the behaviors reshape it, each seeing the one before. */\n  shape(moveCtx: InvocationCtx, raw: Delta): Delta;\n  /** What the behaviors answer for the commit; see `reduceBehaviorEnd`. */\n  end(delta: Delta): Op[] | null | undefined;\n}\n\n/**\n * Start the binding's behaviors over the poses the copies are measured from:\n * `origins`, in world, keyed by the original's id.\n */\nexport function startCloneBehaviors(\n  ctx: InvocationCtx,\n  opts: BindingOpts | undefined,\n  scene: Scene<unknown, string, unknown>,\n  roots: readonly NodeId[],\n  origins: ReadonlyMap<NodeId, unknown>,\n  descriptorOf: (id: NodeId) => PoseDescriptor<unknown>,\n): CloneBehaviors {\n  const list = (opts?.behaviors ?? []) as CloneBehavior<unknown>[];\n  const readers: GestureReaders = gestureReaders(ctx.deps as Pick<ActionDeps, 'view'>);\n  const origin = new Map<string, unknown>(origins as ReadonlyMap<string, unknown>);\n  const gctx: GestureContext<unknown> = {\n    draggedIds: roots as unknown as string[],\n    origin,\n    current: new Map(origin),\n    snap: null,\n    modifiers: { ...ctx.modifiers },\n    pointer: pointerStateOf(ctx.world, ctx),\n    view: readers.view(),\n    plane: readers.plane(),\n    frames: sceneGestureFrames(scene, ctx.deps.view),\n    adapter: defaultCommitAdapter(scene, ctx.deps.selection?.adapterMethods) as unknown as GestureContext<unknown>['adapter'],\n    scratch: {},\n  };\n  const place = ({ dx, dy }: Delta): void => {\n    for (const [id, pose] of origins) {\n      gctx.current.set(id as string, translatePoseViaDescriptor(pose, dx, dy, descriptorOf(id)));\n    }\n  };\n  for (const b of list) b.onStart?.(gctx);\n  return {\n    list,\n    gctx,\n    shape(moveCtx, raw) {\n      if (list.length === 0) return raw;\n      gctx.modifiers = { ...moveCtx.modifiers };\n      gctx.pointer = pointerStateOf(moveCtx.world, moveCtx);\n      gctx.view = readers.view();\n      gctx.plane = readers.plane();\n      place(raw);\n      let transform: GroupTransform = { kind: 'translate', ...raw };\n      for (const b of list) {\n        const r: CloneBehaviorResult<unknown> | void = b.onMove?.(gctx, transform);\n        if (!r) continue;\n        if (r.transform?.kind === 'translate') transform = r.transform;\n        if (r.snap !== undefined) gctx.snap = r.snap;\n      }\n      return transform.kind === 'translate' ? { dx: transform.dx, dy: transform.dy } : raw;\n    },\n    end(delta) {\n      place(delta);\n      return reduceBehaviorEnd(list, gctx);\n    },\n  };\n}\n"],"mappings":";;;;;;;AA2BA,SAAgBA,EACd,GACA,GACA,GACA,GACA,GACA,GACgB;CAChB,IAAMC,IAAQC,GAAM,aAAa,CAAC,GAC5BC,IAA0BC,EAAeC,EAAI,IAAgC,GAC7EC,IAAS,IAAI,IAAqBC,CAAuC,GACzEC,IAAgC;EACpC,YAAYC;EACZ;EACA,SAAS,IAAI,IAAIH,CAAM;EACvB,MAAM;EACN,WAAW,EAAE,GAAGD,EAAI,UAAU;EAC9B,SAASK,EAAeL,EAAI,OAAOA,CAAG;EACtC,MAAMF,EAAQ,KAAK;EACnB,OAAOA,EAAQ,MAAM;EACrB,QAAQQ,EAAmBC,GAAOP,EAAI,KAAK,IAAI;EAC/C,SAASQ,EAAqBD,GAAOP,EAAI,KAAK,WAAW,cAAc;EACvE,SAAS,CAAC;CACZ,GACMS,KAAS,EAAE,OAAI,YAAsB;EACzC,KAAK,IAAM,CAACC,GAAIC,MAAST,GACvB,EAAK,QAAQ,IAAIQ,GAAcE,EAA2BD,GAAME,GAAIC,GAAIC,EAAaL,CAAE,CAAC,CAAC;CAE7F;CACA,KAAK,IAAMM,KAAKpB,GAAM,EAAE,UAAUO,CAAI;CACtC,OAAO;EACL;EACA;EACA,MAAM,GAAS,GAAK;GAClB,IAAIP,EAAK,WAAW,GAAG,OAAOqB;GAK9B,AAJA,EAAK,YAAY,EAAE,GAAGC,EAAQ,UAAU,GACxC,EAAK,UAAUb,EAAea,EAAQ,OAAOA,CAAO,GACpD,EAAK,OAAOpB,EAAQ,KAAK,GACzB,EAAK,QAAQA,EAAQ,MAAM,GAC3BW,EAAMQ,CAAG;GACT,IAAIE,IAA4B;IAAE,MAAM;IAAa,GAAGF;GAAI;GAC5D,KAAK,IAAMD,KAAKpB,GAAM;IACpB,IAAMwB,IAAyCJ,EAAE,SAASb,GAAMgB,CAAS;IACzE,AAAKC,MACDA,EAAE,WAAW,SAAS,gBAAa,IAAYA,EAAE,YACjDA,EAAE,SAAS,KAAA,MAAW,EAAK,OAAOA,EAAE;GAC1C;GACA,OAAOD,EAAU,SAAS,cAAc;IAAE,IAAIA,EAAU;IAAI,IAAIA,EAAU;GAAG,IAAIF;EACnF;EACA,IAAI,GAAO;GAET,OADAR,EAAMY,CAAK,GACJC,EAAkB1B,GAAMO,CAAI;EACrC;CACF;AACF"}

package/dist/interactions/actions/defaultCommitAdapter.js

@@ -1,39 +1,14 @@
-import { documentPose as e } from "../../core/scene/effectivePose.js";
-import { asNodeId as t } from "../../core/scene/types.js";
-import { fnFieldsOfNode as n } from "../../core/scene/nodeFnFields.js";
+import { asNodeId as e } from "../../core/scene/types.js";
+import { documentReads as t, sceneMutators as n } from "../../core/scene/sceneMutators.js";
 //#region src/interactions/actions/defaultCommitAdapter.ts
 function r(r, i) {
 	return {
-		getNode: (e) => r.get(t(e)),
-		getNodes: () => [...r.renderOrderNodes()],
-		getPose: (n) => e(r, r.get(t(n))),
+		...n(r),
+		...t(r),
 		getSelection: () => [...i ? i.getSelection() : r.getSelection()],
-		setSelection: (e) => {
-			i ? i.setSelection(e.map(t)) : r.setSelection(e.map(t));
-		},
-		getParent: (e) => r.get(t(e))?.parent ?? null,
-		getRemovalClosure: (e) => [...r.removalClosure(e.map(t))],
-		getChildren: (e) => e === null ? [...r.roots] : [...r.childrenOf(t(e))],
-		setChildOrder: (e, n) => {
-			for (let i = 0; i < n.length; i++) (e === null ? r.roots : r.childrenOf(t(e)))[i] !== n[i] && r.reorder(t(n[i]), i);
-		},
-		setPose: (e, n) => r.setPose(t(e), n),
-		setParent: (e, n) => r.move(t(e), n == null ? null : t(n)),
-		setData: (e, n) => r.update(t(e), { data: n }),
-		setLayer: (e, n) => r.setLayer(t(e), n),
-		setLayout: (e, n) => r.setLayout(t(e), n),
-		removeNode: (e) => r.remove(t(e)),
-		insertNode: (e, t) => r.add({
-			kind: e.kind,
-			layer: e.layer,
-			pose: e.pose,
-			data: e.data,
-			id: e.id,
-			...e.parent == null ? {} : { parent: e.parent },
-			...t === void 0 ? {} : { index: t },
-			...e.dependsOn === void 0 ? {} : { dependsOn: e.dependsOn },
-			...n(e)
-		})
+		setSelection: (t) => {
+			i ? i.setSelection(t.map(e)) : r.setSelection(t.map(e));
+		}
 	};
 }
 //#endregion

package/dist/interactions/actions/defaultCommitAdapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"defaultCommitAdapter.js","names":["defaultCommitAdapter","scene","asNodeId","id","documentPose","selection","ids","parentId","orderedIds","pose","layer","layout","node","index","fnFieldsOfNode"],"sources":["../../../src/interactions/actions/defaultCommitAdapter.ts"],"sourcesContent":["/**\n * Shared scene-backed commit adapter for default actions.\n *\n * Default actions route data/layer/pose/parent mutations through the\n * consumer's `applyOps` commit hook when one is present; when it isn't, they\n * fall back to applying the committed ops directly against the scene through\n * this adapter. It carries the scene-backed op-apply methods (`setPose` /\n * `setParent` / `setData` / `setLayer` / `setLayout` / `removeNode` /\n * `insertNode` / `setChildOrder`) plus the read-side queries (`getNode` / `getNodes` /\n * `getPose` / `getParent` / `getChildren` / `getSelection`) and\n * `setSelection`. Known exclusions from the op factory roster — surfaces the\n * scene doesn't own: `setPath` and `setText`.\n *\n * Lives in `interactions/actions/` (not `canvas/sceneAdapter.ts`) so default\n * actions never import from `canvas/` — that back-edge would create an\n * `interactions → canvas → interactions` cycle. Mirrors `moveGestureAdapter`,\n * widened to all op-apply methods.\n */\nimport { fnFieldsOfNode } from 'core/scene/nodeFnFields';\nimport { documentPose } from 'core/scene/effectivePose';\nimport type { Node, NodeId, Scene } from 'core/scene/types';\nimport { asNodeId } from 'core/scene/types';\nimport type { SelectionApi } from 'core/selection/useSelection';\nimport type { LayoutStrategy } from '../../layout/types';\n\n/** Build the adapter the default actions commit through when the consumer\n *  supplies no `applyOps` hook of its own — it applies ops straight to the\n *  scene. Path and text ops are not covered; those surfaces belong to their\n *  own owners.\n *\n *  Pass `selection` (a `SelectionApi`'s `adapterMethods`) and selection reads\n *  and writes go through it rather than the scene, so a canvas that gates its\n *  selection — `selectable={false}` — gates what these batches select too. */\nexport function defaultCommitAdapter<TPose>(\n  scene: Scene<unknown, string, TPose>,\n  selection?: SelectionApi['adapterMethods'],\n) {\n  return {\n    getNode: (id: string) => scene.get(asNodeId(id)),\n    getNodes: () => {\n      return [...scene.renderOrderNodes()] as Node<unknown, string, TPose>[];\n    },\n    getPose: (id: string) => documentPose(scene, scene.get(asNodeId(id))!),\n    getSelection: (): string[] => [...(selection ? selection.getSelection() : scene.getSelection())],\n    setSelection: (ids: string[]) => {\n      if (selection) selection.setSelection(ids.map(asNodeId));\n      else scene.setSelection(ids.map(asNodeId));\n    },\n    getParent: (id: string) => (scene.get(asNodeId(id))?.parent ?? null) as string | null,\n    getRemovalClosure: (ids: readonly string[]): string[] =>\n      [...scene.removalClosure(ids.map(asNodeId))],\n    getChildren: (parentId: string | null): string[] =>\n      (parentId === null\n        ? [...scene.roots]\n        : [...scene.childrenOf(asNodeId(parentId))]) as string[],\n    // Re-stamp each slot whose occupant changed. `scene.reorder` mutates the\n    // live sibling list in place, so re-read it each iteration and skip slots\n    // already holding the desired id (an earlier reorder may have shifted a\n    // later id into place). One enclosing batch is provided by the caller\n    // (`scene.applyBatch` / consumer `applyOps`), so no batch here.\n    setChildOrder: (parentId: string | null, orderedIds: string[]): void => {\n      for (let i = 0; i < orderedIds.length; i++) {\n        const current = parentId === null\n          ? (scene.roots as readonly NodeId[])\n          : (scene.childrenOf(asNodeId(parentId)) as readonly NodeId[]);\n        if ((current[i] as string) === orderedIds[i]) continue;\n        scene.reorder(asNodeId(orderedIds[i]), i);\n      }\n    },\n    setPose: (id: string, pose: TPose) => scene.setPose(asNodeId(id), pose),\n    setParent: (id: string, parentId: string | null) =>\n      scene.move(asNodeId(id), parentId == null ? null : asNodeId(parentId)),\n    setData: (id: string, data: unknown) => scene.update(asNodeId(id), { data } as never),\n    setLayer: (id: string, layer: string) => scene.setLayer(asNodeId(id), layer as never),\n    setLayout: (id: string, layout: LayoutStrategy<TPose> | string | null) =>\n      scene.setLayout(asNodeId(id), layout),\n    removeNode: (id: string) => scene.remove(asNodeId(id)),\n    insertNode: (node: Node<unknown, string, TPose>, index?: number) =>\n      scene.add({\n        kind: node.kind,\n        layer: node.layer,\n        pose: node.pose,\n        data: node.data,\n        id: node.id,\n        ...(node.parent != null ? { parent: node.parent } : {}),\n        // Sibling-index passthrough: undo of a delete (or a boolean op's\n        // source removal) re-inserts at the recorded z-order slot instead\n        // of appending at the end.\n        ...(index !== undefined ? { index } : {}),\n        ...(node.dependsOn !== undefined ? { dependsOn: node.dependsOn } : {}),\n        ...fnFieldsOfNode(node),\n      }),\n  };\n}\n"],"mappings":";;;;AAiCA,SAAgBA,EACd,GACA,GACA;CACA,OAAO;EACL,UAAU,MAAeC,EAAM,IAAIC,EAASC,CAAE,CAAC;EAC/C,gBACS,CAAC,GAAGF,EAAM,iBAAiB,CAAC;EAErC,UAAU,MAAeG,EAAaH,GAAOA,EAAM,IAAIC,EAASC,CAAE,CAAC,CAAE;EACrE,oBAA8B,CAAC,GAAIE,IAAYA,EAAU,aAAa,IAAIJ,EAAM,aAAa,CAAE;EAC/F,eAAe,MAAkB;GAC/B,AAAII,IAAWA,EAAU,aAAaC,EAAI,IAAIJ,CAAQ,CAAC,IAClDD,EAAM,aAAaK,EAAI,IAAIJ,CAAQ,CAAC;EAC3C;EACA,YAAY,MAAgBD,EAAM,IAAIC,EAASC,CAAE,CAAC,CAAC,EAAE,UAAU;EAC/D,oBAAoB,MAClB,CAAC,GAAGF,EAAM,eAAeK,EAAI,IAAIJ,CAAQ,CAAC,CAAC;EAC7C,cAAc,MACXK,MAAa,OACV,CAAC,GAAGN,EAAM,KAAK,IACf,CAAC,GAAGA,EAAM,WAAWC,EAASK,CAAQ,CAAC,CAAC;EAM9C,gBAAgB,GAAyB,MAA+B;GACtE,KAAK,IAAI,IAAI,GAAG,IAAIC,EAAW,QAAQ,KAIrC,CAHgBD,MAAa,OACxBN,EAAM,QACNA,EAAM,WAAWC,EAASK,CAAQ,CAAC,EAAA,CAC3B,OAAkBC,EAAW,MAC1CP,EAAM,QAAQC,EAASM,EAAW,EAAE,GAAG,CAAC;EAE5C;EACA,UAAU,GAAY,MAAgBP,EAAM,QAAQC,EAASC,CAAE,GAAGM,CAAI;EACtE,YAAY,GAAY,MACtBR,EAAM,KAAKC,EAASC,CAAE,GAAGI,KAAY,OAAO,OAAOL,EAASK,CAAQ,CAAC;EACvE,UAAU,GAAY,MAAkBN,EAAM,OAAOC,EAASC,CAAE,GAAG,EAAE,QAAK,CAAU;EACpF,WAAW,GAAY,MAAkBF,EAAM,SAASC,EAASC,CAAE,GAAGO,CAAc;EACpF,YAAY,GAAY,MACtBT,EAAM,UAAUC,EAASC,CAAE,GAAGQ,CAAM;EACtC,aAAa,MAAeV,EAAM,OAAOC,EAASC,CAAE,CAAC;EACrD,aAAa,GAAoC,MAC/CF,EAAM,IAAI;GACR,MAAMW,EAAK;GACX,OAAOA,EAAK;GACZ,MAAMA,EAAK;GACX,MAAMA,EAAK;GACX,IAAIA,EAAK;GACT,GAAIA,EAAK,UAAU,OAAiC,CAAC,IAA3B,EAAE,QAAQA,EAAK,OAAO;GAIhD,GAAIC,MAAU,KAAA,IAAwB,CAAC,IAAb,EAAE,SAAM;GAClC,GAAID,EAAK,cAAc,KAAA,IAA4C,CAAC,IAAjC,EAAE,WAAWA,EAAK,UAAU;GAC/D,GAAGE,EAAeF,CAAI;EACxB,CAAC;CACL;AACF"}
+{"version":3,"file":"defaultCommitAdapter.js","names":["defaultCommitAdapter","sceneMutators","scene","documentReads","selection","ids","asNodeId"],"sources":["../../../src/interactions/actions/defaultCommitAdapter.ts"],"sourcesContent":["/**\n * Shared scene-backed commit adapter for default actions.\n *\n * Default actions route data/layer/pose/parent mutations through the\n * consumer's `applyOps` commit hook when one is present; when it isn't, they\n * fall back to applying the committed ops directly against the scene through\n * this adapter: the scene's mutators (`core/scene/sceneMutators.ts`), the\n * document's poses and nodes, and the selection. Known exclusions from the op\n * factory roster — surfaces the scene doesn't own: `setPath` and `setText`.\n */\nimport { documentReads, sceneMutators } from 'core/scene/sceneMutators';\nimport type { Scene } from 'core/scene/types';\nimport { asNodeId } from 'core/scene/types';\nimport type { SelectionApi } from 'core/selection/useSelection';\n\n/** Build the adapter the default actions commit through when the consumer\n *  supplies no `applyOps` hook of its own — it applies ops straight to the\n *  scene. Path and text ops are not covered; those surfaces belong to their\n *  own owners.\n *\n *  Pass `selection` (a `SelectionApi`'s `adapterMethods`) and selection reads\n *  and writes go through it rather than the scene, so a canvas that gates its\n *  selection — `selectable={false}` — gates what these batches select too. */\nexport function defaultCommitAdapter<TPose>(\n  scene: Scene<unknown, string, TPose>,\n  selection?: SelectionApi['adapterMethods'],\n) {\n  return {\n    ...sceneMutators(scene),\n    ...documentReads(scene),\n    getSelection: (): string[] => [...(selection ? selection.getSelection() : scene.getSelection())],\n    setSelection: (ids: string[]) => {\n      if (selection) selection.setSelection(ids.map(asNodeId));\n      else scene.setSelection(ids.map(asNodeId));\n    },\n  };\n}\n"],"mappings":";;;AAuBA,SAAgBA,EACd,GACA,GACA;CACA,OAAO;EACL,GAAGC,EAAcC,CAAK;EACtB,GAAGC,EAAcD,CAAK;EACtB,oBAA8B,CAAC,GAAIE,IAAYA,EAAU,aAAa,IAAIF,EAAM,aAAa,CAAE;EAC/F,eAAe,MAAkB;GAC/B,AAAIE,IAAWA,EAAU,aAAaC,EAAI,IAAIC,CAAQ,CAAC,IAClDJ,EAAM,aAAaG,EAAI,IAAIC,CAAQ,CAAC;EAC3C;CACF;AACF"}