@weasel-js/core 1.9.3 → 1.9.4

package/dist/input/keyState.js

@@ -1,76 +1,75 @@
-import { isEditableTarget as e } from "@weasel-js/routing";
+import { createEmitter as e } from "@weasel-js/registry";
+import { isEditableTarget as t } from "@weasel-js/routing";
 //#region src/input/keyState.ts
-var t = {
+var n = {
 	shift: ["ShiftLeft", "ShiftRight"],
 	ctrl: ["ControlLeft", "ControlRight"],
 	alt: ["AltLeft", "AltRight"],
 	meta: ["MetaLeft", "MetaRight"]
-}, n = new Set(Object.values(t).flat()), r = (e) => e.length === 1 ? e.toLowerCase() : e, i = (e) => typeof e == "string" ? [e] : e;
-function a() {
-	let a = /* @__PURE__ */ new Map(), o = /* @__PURE__ */ new Set(), s = /* @__PURE__ */ new Set(), c = {
+}, r = new Set(Object.values(n).flat()), i = (e) => e.length === 1 ? e.toLowerCase() : e, a = (e) => typeof e == "string" ? [e] : e;
+function o() {
+	let o = /* @__PURE__ */ new Map(), s = /* @__PURE__ */ new Set(), c = /* @__PURE__ */ new Set(), l = {
 		shift: !1,
 		ctrl: !1,
 		alt: !1,
 		meta: !1
-	}, l = /* @__PURE__ */ new Set(), u = () => {
-		for (let e of [...l]) e();
-	}, d = (e) => (o.delete(e), a.delete(e)), f = () => {
-		let e = a.size > 0 || s.size > 0 || c.shift || c.ctrl || c.alt || c.meta;
-		a.clear(), o.clear(), s.clear(), c.shift = c.ctrl = c.alt = c.meta = !1, e && u();
-	}, p = (e) => {
-		let n = !1, r = {
+	}, u = { ...l }, d = e(), f = d.emit, p = (e) => (s.delete(e), o.delete(e)), m = () => {
+		let e = o.size > 0 || c.size > 0 || l.shift || l.ctrl || l.alt || l.meta;
+		o.clear(), s.clear(), c.clear(), l.shift = l.ctrl = l.alt = l.meta = !1, e && f();
+	}, h = (e) => {
+		let t = !1, r = {
 			shift: e.shiftKey,
 			ctrl: e.ctrlKey,
 			alt: e.altKey,
 			meta: e.metaKey
 		};
-		for (let e of Object.keys(t)) if (c[e] !== r[e] && (c[e] = r[e], n = !0), !r[e]) for (let r of t[e]) n = d(r) || n;
-		return n;
+		for (let e of Object.keys(n)) if (l[e] !== r[e] && (l[e] = r[e], t = !0), !r[e]) for (let r of n[e]) t = p(r) || t;
+		return t;
 	};
 	return {
-		isDown: (e) => i(e).some((e) => o.has(e)),
+		isDown: (e) => a(e).some((e) => s.has(e)),
 		isKeyDown: (e) => {
-			let t = new Set(i(e).map(r));
-			for (let e of a.values()) if (t.has(e)) return !0;
+			let t = new Set(a(e).map(i));
+			for (let e of o.values()) if (t.has(e)) return !0;
 			return !1;
 		},
 		take: (e) => {
 			let t = !1;
-			for (let n of i(e)) t = s.delete(n) || t;
+			for (let n of a(e)) t = c.delete(n) || t;
 			return t;
 		},
-		codes: () => o,
-		modifiers: () => ({ ...c }),
-		subscribe: (e) => (l.add(e), () => l.delete(e)),
-		release: f,
-		attach: (i, c = {}) => {
-			let l = c.skipInEditable ?? !0, m = new Set(c.preventDefault ?? []), h = (t) => {
-				let n = t;
-				if (l && e(n.target)) return;
-				m.has(n.code) && n.preventDefault();
-				let i = p(n);
-				a.has(n.code) || (a.set(n.code, r(n.key)), o.add(n.code), i = !0), !n.repeat && !s.has(n.code) && (s.add(n.code), i = !0), i && u();
+		codes: () => s,
+		modifiers: () => ((u.shift !== l.shift || u.ctrl !== l.ctrl || u.alt !== l.alt || u.meta !== l.meta) && (u = { ...l }), u),
+		subscribe: d.subscribe,
+		release: m,
+		attach: (e, a = {}) => {
+			let l = a.skipInEditable ?? !0, u = new Set(a.preventDefault ?? []), d = (e) => {
+				let n = e;
+				if (l && t(n.target)) return;
+				u.has(n.code) && n.preventDefault();
+				let r = h(n);
+				o.has(n.code) || (o.set(n.code, i(n.key)), s.add(n.code), r = !0), !n.repeat && !c.has(n.code) && (c.add(n.code), r = !0), r && f();
 			}, g = (e) => {
-				let r = e;
-				m.has(r.code) && r.preventDefault();
-				let i = p(r);
-				if (i = d(r.code) || i, t.meta.includes(r.code)) for (let e of [...o]) n.has(e) || (i = d(e) || i);
-				i && u();
+				let t = e;
+				u.has(t.code) && t.preventDefault();
+				let i = h(t);
+				if (i = p(t.code) || i, n.meta.includes(t.code)) for (let e of [...s]) r.has(e) || (i = p(e) || i);
+				i && f();
 			}, _ = () => {
-				document.hidden && f();
-			}, v = (e) => {
-				let t = e.relatedTarget;
-				(!(t instanceof Node) || !i.contains(t)) && f();
+				document.hidden && m();
+			}, v = (t) => {
+				let n = t.relatedTarget;
+				(!(n instanceof Node) || !e.contains(n)) && m();
 			};
-			i.addEventListener("keydown", h), i.addEventListener("keyup", g), window.addEventListener("blur", f), document.addEventListener("visibilitychange", _);
-			let y = i !== window;
-			return y && i.addEventListener("focusout", v), () => {
-				i.removeEventListener("keydown", h), i.removeEventListener("keyup", g), window.removeEventListener("blur", f), document.removeEventListener("visibilitychange", _), y && i.removeEventListener("focusout", v), f();
+			e.addEventListener("keydown", d), e.addEventListener("keyup", g), window.addEventListener("blur", m), document.addEventListener("visibilitychange", _);
+			let y = e !== window;
+			return y && e.addEventListener("focusout", v), () => {
+				e.removeEventListener("keydown", d), e.removeEventListener("keyup", g), window.removeEventListener("blur", m), document.removeEventListener("visibilitychange", _), y && e.removeEventListener("focusout", v), m();
 			};
 		}
 	};
 }
 //#endregion
-export { a as createKeyState };
+export { o as createKeyState };
 
 //# sourceMappingURL=keyState.js.map

package/dist/input/keyState.js.map

@@ -1 +1 @@
-{"version":3,"file":"keyState.js","names":["MODIFIER_CODES","MODIFIER_SET","fold","key","list","v","createKeyState","down","codeSet","presses","mods","listeners","notify","l","remove","code","release","changed","reconcile","flags","m","c","want","k","hit","listener","skipInEditable","options","owned","onKeyDown","e","event","isEditableTarget","onKeyUp","onVisibility","onFocusOut","next","target","isElement"],"sources":["../../src/input/keyState.ts"],"sourcesContent":["/**\n * Which physical keys are down right now — the poll a game loop or character\n * controller reads each step. This is raw input state, not routing: it sees\n * every key whether or not a binding claims it, and a binding claiming a key\n * does not hide it from here.\n */\n\nimport { isEditableTarget } from '@weasel-js/routing';\n\n/** Which modifier keys are held, on either side of the keyboard. */\nexport interface KeyModifiers {\n  shift: boolean;\n  ctrl: boolean;\n  alt: boolean;\n  meta: boolean;\n}\n\n/** Options for {@link KeyState.attach}. */\nexport interface KeyStateAttachOptions {\n  /** Ignore presses whose target is an input, textarea or contenteditable\n   *  element. Their releases are always taken. Default `true`. */\n  skipInEditable?: boolean;\n  /** `KeyboardEvent.code`s whose keydown and keyup have their default\n   *  prevented — the keys a game owns, so Space and the arrows stop scrolling\n   *  the page. */\n  preventDefault?: readonly string[];\n}\n\n/** A poll of which physical keys are down, fed by {@link KeyState.attach}. */\nexport interface KeyState {\n  /** Whether any of these physical keys, by `KeyboardEvent.code`\n   *  (`'KeyA'`, `'Space'`, `'ArrowLeft'`), is down. Codes name positions, so\n   *  WASD stays in place on any layout. */\n  isDown(code: string | readonly string[]): boolean;\n  /** Whether a key down produced any of these `KeyboardEvent.key` values when\n   *  it was pressed. Single characters compare case-insensitively. */\n  isKeyDown(key: string | readonly string[]): boolean;\n  /** Whether any of these codes was freshly pressed since it was last taken;\n   *  clears them. Autorepeat is not a press. A press is taken once, so two\n   *  readers of the same code see it once between them. */\n  take(code: string | readonly string[]): boolean;\n  /** Every code down. The set is live — copy it to keep it. */\n  codes(): ReadonlySet<string>;\n  modifiers(): KeyModifiers;\n  /** Called on every change of what is down. Returns the unsubscribe. */\n  subscribe(listener: () => void): () => void;\n  /** Mark everything up and drop untaken presses. */\n  release(): void;\n  /**\n   * Listen on `target` — `window`, or an element whose subtree has focus.\n   * Everything is released when the keyups can no longer arrive: the window\n   * blurs, the document hides, focus leaves an element target, or Meta is\n   * released (macOS delivers no keyup for a key released while Cmd is held).\n   * Returns the detach, which also releases.\n   */\n  attach(target: Window | HTMLElement, options?: KeyStateAttachOptions): () => void;\n}\n\nconst MODIFIER_CODES: Record<keyof KeyModifiers, readonly string[]> = {\n  shift: ['ShiftLeft', 'ShiftRight'],\n  ctrl: ['ControlLeft', 'ControlRight'],\n  alt: ['AltLeft', 'AltRight'],\n  meta: ['MetaLeft', 'MetaRight'],\n};\nconst MODIFIER_SET = new Set(Object.values(MODIFIER_CODES).flat());\n\nconst fold = (key: string): string => (key.length === 1 ? key.toLowerCase() : key);\nconst list = (v: string | readonly string[]): readonly string[] => (typeof v === 'string' ? [v] : v);\n\n/** A new {@link KeyState} with nothing down. It hears nothing until attached;\n *  in React, `useKeyState` attaches one for a component's lifetime. */\nexport function createKeyState(): KeyState {\n  // code → the folded key it produced when pressed\n  const down = new Map<string, string>();\n  const codeSet = new Set<string>();\n  const presses = new Set<string>();\n  const mods: KeyModifiers = { shift: false, ctrl: false, alt: false, meta: false };\n  const listeners = new Set<() => void>();\n\n  const notify = () => {\n    for (const l of [...listeners]) l();\n  };\n\n  const remove = (code: string): boolean => {\n    codeSet.delete(code);\n    return down.delete(code);\n  };\n\n  const release = () => {\n    const changed = down.size > 0 || presses.size > 0 || mods.shift || mods.ctrl || mods.alt || mods.meta;\n    down.clear();\n    codeSet.clear();\n    presses.clear();\n    mods.shift = mods.ctrl = mods.alt = mods.meta = false;\n    if (changed) notify();\n  };\n\n  // A modifier's keyup can land in another window (alt-tab, cmd-tab), so trust\n  // the flags every event carries over the keys we saw go down.\n  const reconcile = (e: KeyboardEvent): boolean => {\n    let changed = false;\n    const flags: KeyModifiers = { shift: e.shiftKey, ctrl: e.ctrlKey, alt: e.altKey, meta: e.metaKey };\n    for (const m of Object.keys(MODIFIER_CODES) as Array<keyof KeyModifiers>) {\n      if (mods[m] !== flags[m]) {\n        mods[m] = flags[m];\n        changed = true;\n      }\n      if (!flags[m]) for (const code of MODIFIER_CODES[m]) changed = remove(code) || changed;\n    }\n    return changed;\n  };\n\n  const state: KeyState = {\n    isDown: (code) => list(code).some((c) => codeSet.has(c)),\n    isKeyDown: (key) => {\n      const want = new Set(list(key).map(fold));\n      for (const k of down.values()) if (want.has(k)) return true;\n      return false;\n    },\n    take: (code) => {\n      let hit = false;\n      for (const c of list(code)) hit = presses.delete(c) || hit;\n      return hit;\n    },\n    codes: () => codeSet,\n    modifiers: () => ({ ...mods }),\n    subscribe: (listener) => {\n      listeners.add(listener);\n      return () => listeners.delete(listener);\n    },\n    release,\n    attach: (target, options = {}) => {\n      const skipInEditable = options.skipInEditable ?? true;\n      const owned = new Set(options.preventDefault ?? []);\n\n      const onKeyDown = (event: Event) => {\n        const e = event as KeyboardEvent;\n        if (skipInEditable && isEditableTarget(e.target)) return;\n        if (owned.has(e.code)) e.preventDefault();\n        let changed = reconcile(e);\n        if (!down.has(e.code)) {\n          down.set(e.code, fold(e.key));\n          codeSet.add(e.code);\n          changed = true;\n        }\n        if (!e.repeat && !presses.has(e.code)) {\n          presses.add(e.code);\n          changed = true;\n        }\n        if (changed) notify();\n      };\n\n      const onKeyUp = (event: Event) => {\n        const e = event as KeyboardEvent;\n        if (owned.has(e.code)) e.preventDefault();\n        let changed = reconcile(e);\n        changed = remove(e.code) || changed;\n        if (MODIFIER_CODES.meta.includes(e.code)) {\n          for (const code of [...codeSet]) if (!MODIFIER_SET.has(code)) changed = remove(code) || changed;\n        }\n        if (changed) notify();\n      };\n\n      const onVisibility = () => {\n        if (document.hidden) release();\n      };\n\n      const onFocusOut = (event: Event) => {\n        const next = (event as FocusEvent).relatedTarget;\n        if (!(next instanceof Node) || !(target as HTMLElement).contains(next)) release();\n      };\n\n      target.addEventListener('keydown', onKeyDown);\n      target.addEventListener('keyup', onKeyUp);\n      window.addEventListener('blur', release);\n      document.addEventListener('visibilitychange', onVisibility);\n      const isElement = target !== window;\n      if (isElement) target.addEventListener('focusout', onFocusOut);\n\n      return () => {\n        target.removeEventListener('keydown', onKeyDown);\n        target.removeEventListener('keyup', onKeyUp);\n        window.removeEventListener('blur', release);\n        document.removeEventListener('visibilitychange', onVisibility);\n        if (isElement) target.removeEventListener('focusout', onFocusOut);\n        release();\n      };\n    },\n  };\n  return state;\n}\n"],"mappings":"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"}
+{"version":3,"file":"keyState.js","names":["MODIFIER_CODES","MODIFIER_SET","fold","key","list","v","createKeyState","down","codeSet","presses","mods","held","listeners","createEmitter","notify","remove","code","release","changed","reconcile","flags","m","c","want","k","hit","skipInEditable","options","owned","onKeyDown","e","event","isEditableTarget","onKeyUp","onVisibility","onFocusOut","next","target","isElement"],"sources":["../../src/input/keyState.ts"],"sourcesContent":["/**\n * Which physical keys are down right now — the poll a game loop or character\n * controller reads each step. This is raw input state, not routing: it sees\n * every key whether or not a binding claims it, and a binding claiming a key\n * does not hide it from here.\n */\n\nimport { createEmitter } from '@weasel-js/registry';\nimport { isEditableTarget } from '@weasel-js/routing';\n\n/** Which modifier keys are held, on either side of the keyboard. */\nexport interface KeyModifiers {\n  shift: boolean;\n  ctrl: boolean;\n  alt: boolean;\n  meta: boolean;\n}\n\n/** Options for {@link KeyState.attach}. */\nexport interface KeyStateAttachOptions {\n  /** Ignore presses whose target is an input, textarea or contenteditable\n   *  element. Their releases are always taken. Default `true`. */\n  skipInEditable?: boolean;\n  /** `KeyboardEvent.code`s whose keydown and keyup have their default\n   *  prevented — the keys a game owns, so Space and the arrows stop scrolling\n   *  the page. */\n  preventDefault?: readonly string[];\n}\n\n/** A poll of which physical keys are down, fed by {@link KeyState.attach}. */\nexport interface KeyState {\n  /** Whether any of these physical keys, by `KeyboardEvent.code`\n   *  (`'KeyA'`, `'Space'`, `'ArrowLeft'`), is down. Codes name positions, so\n   *  WASD stays in place on any layout. */\n  isDown(code: string | readonly string[]): boolean;\n  /** Whether a key down produced any of these `KeyboardEvent.key` values when\n   *  it was pressed. Single characters compare case-insensitively. */\n  isKeyDown(key: string | readonly string[]): boolean;\n  /** Whether any of these codes was freshly pressed since it was last taken;\n   *  clears them. Autorepeat is not a press. A press is taken once, so two\n   *  readers of the same code see it once between them. */\n  take(code: string | readonly string[]): boolean;\n  /** Every code down. The set is live — copy it to keep it. */\n  codes(): ReadonlySet<string>;\n  /** The modifiers held. The same object until one changes, so it serves as\n   *  a `useSyncExternalStore` snapshot. */\n  modifiers(): KeyModifiers;\n  /** Called on every change of what is down. Returns the unsubscribe. */\n  subscribe(listener: () => void): () => void;\n  /** Mark everything up and drop untaken presses. */\n  release(): void;\n  /**\n   * Listen on `target` — `window`, or an element whose subtree has focus.\n   * Everything is released when the keyups can no longer arrive: the window\n   * blurs, the document hides, focus leaves an element target, or Meta is\n   * released (macOS delivers no keyup for a key released while Cmd is held).\n   * Returns the detach, which also releases.\n   */\n  attach(target: Window | HTMLElement, options?: KeyStateAttachOptions): () => void;\n}\n\nconst MODIFIER_CODES: Record<keyof KeyModifiers, readonly string[]> = {\n  shift: ['ShiftLeft', 'ShiftRight'],\n  ctrl: ['ControlLeft', 'ControlRight'],\n  alt: ['AltLeft', 'AltRight'],\n  meta: ['MetaLeft', 'MetaRight'],\n};\nconst MODIFIER_SET = new Set(Object.values(MODIFIER_CODES).flat());\n\nconst fold = (key: string): string => (key.length === 1 ? key.toLowerCase() : key);\nconst list = (v: string | readonly string[]): readonly string[] => (typeof v === 'string' ? [v] : v);\n\n/** A new {@link KeyState} with nothing down. It hears nothing until attached;\n *  in React, `useKeyState` attaches one for a component's lifetime. */\nexport function createKeyState(): KeyState {\n  // code → the folded key it produced when pressed\n  const down = new Map<string, string>();\n  const codeSet = new Set<string>();\n  const presses = new Set<string>();\n  const mods: KeyModifiers = { shift: false, ctrl: false, alt: false, meta: false };\n  let held: KeyModifiers = { ...mods };\n  const listeners = createEmitter();\n  const notify = listeners.emit;\n\n  const remove = (code: string): boolean => {\n    codeSet.delete(code);\n    return down.delete(code);\n  };\n\n  const release = () => {\n    const changed = down.size > 0 || presses.size > 0 || mods.shift || mods.ctrl || mods.alt || mods.meta;\n    down.clear();\n    codeSet.clear();\n    presses.clear();\n    mods.shift = mods.ctrl = mods.alt = mods.meta = false;\n    if (changed) notify();\n  };\n\n  // A modifier's keyup can land in another window (alt-tab, cmd-tab), so trust\n  // the flags every event carries over the keys we saw go down.\n  const reconcile = (e: KeyboardEvent): boolean => {\n    let changed = false;\n    const flags: KeyModifiers = { shift: e.shiftKey, ctrl: e.ctrlKey, alt: e.altKey, meta: e.metaKey };\n    for (const m of Object.keys(MODIFIER_CODES) as Array<keyof KeyModifiers>) {\n      if (mods[m] !== flags[m]) {\n        mods[m] = flags[m];\n        changed = true;\n      }\n      if (!flags[m]) for (const code of MODIFIER_CODES[m]) changed = remove(code) || changed;\n    }\n    return changed;\n  };\n\n  const state: KeyState = {\n    isDown: (code) => list(code).some((c) => codeSet.has(c)),\n    isKeyDown: (key) => {\n      const want = new Set(list(key).map(fold));\n      for (const k of down.values()) if (want.has(k)) return true;\n      return false;\n    },\n    take: (code) => {\n      let hit = false;\n      for (const c of list(code)) hit = presses.delete(c) || hit;\n      return hit;\n    },\n    codes: () => codeSet,\n    modifiers: () => {\n      if (held.shift !== mods.shift || held.ctrl !== mods.ctrl || held.alt !== mods.alt || held.meta !== mods.meta) {\n        held = { ...mods };\n      }\n      return held;\n    },\n    subscribe: listeners.subscribe,\n    release,\n    attach: (target, options = {}) => {\n      const skipInEditable = options.skipInEditable ?? true;\n      const owned = new Set(options.preventDefault ?? []);\n\n      const onKeyDown = (event: Event) => {\n        const e = event as KeyboardEvent;\n        if (skipInEditable && isEditableTarget(e.target)) return;\n        if (owned.has(e.code)) e.preventDefault();\n        let changed = reconcile(e);\n        if (!down.has(e.code)) {\n          down.set(e.code, fold(e.key));\n          codeSet.add(e.code);\n          changed = true;\n        }\n        if (!e.repeat && !presses.has(e.code)) {\n          presses.add(e.code);\n          changed = true;\n        }\n        if (changed) notify();\n      };\n\n      const onKeyUp = (event: Event) => {\n        const e = event as KeyboardEvent;\n        if (owned.has(e.code)) e.preventDefault();\n        let changed = reconcile(e);\n        changed = remove(e.code) || changed;\n        if (MODIFIER_CODES.meta.includes(e.code)) {\n          for (const code of [...codeSet]) if (!MODIFIER_SET.has(code)) changed = remove(code) || changed;\n        }\n        if (changed) notify();\n      };\n\n      const onVisibility = () => {\n        if (document.hidden) release();\n      };\n\n      const onFocusOut = (event: Event) => {\n        const next = (event as FocusEvent).relatedTarget;\n        if (!(next instanceof Node) || !(target as HTMLElement).contains(next)) release();\n      };\n\n      target.addEventListener('keydown', onKeyDown);\n      target.addEventListener('keyup', onKeyUp);\n      window.addEventListener('blur', release);\n      document.addEventListener('visibilitychange', onVisibility);\n      const isElement = target !== window;\n      if (isElement) target.addEventListener('focusout', onFocusOut);\n\n      return () => {\n        target.removeEventListener('keydown', onKeyDown);\n        target.removeEventListener('keyup', onKeyUp);\n        window.removeEventListener('blur', release);\n        document.removeEventListener('visibilitychange', onVisibility);\n        if (isElement) target.removeEventListener('focusout', onFocusOut);\n        release();\n      };\n    },\n  };\n  return state;\n}\n"],"mappings":"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"}

package/dist/input/useKeyModifiers.js

@@ -0,0 +1,11 @@
+import { useKeyState as e } from "./useKeyState.js";
+import { useSyncExternalStore as t } from "react";
+//#region src/input/useKeyModifiers.ts
+function n(n = {}) {
+	let r = e(n);
+	return t(r.subscribe, r.modifiers, r.modifiers);
+}
+//#endregion
+export { n as useKeyModifiers };
+
+//# sourceMappingURL=useKeyModifiers.js.map

package/dist/input/useKeyModifiers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useKeyModifiers.js","names":["useKeyModifiers","keys","useKeyState","options","useSyncExternalStore"],"sources":["../../src/input/useKeyModifiers.ts"],"sourcesContent":["import { useSyncExternalStore } from 'react';\nimport type { KeyModifiers } from './keyState';\nimport { useKeyState, type UseKeyStateOptions } from './useKeyState';\n\n/**\n * Which modifier keys are held, re-rendering the component when that changes.\n * For chrome that draws the modifiers; a frame loop polls\n * {@link useKeyState} instead. The object is the same one between changes.\n */\nexport function useKeyModifiers(options: UseKeyStateOptions = {}): KeyModifiers {\n  const keys = useKeyState(options);\n  return useSyncExternalStore(keys.subscribe, keys.modifiers, keys.modifiers);\n}\n"],"mappings":";;;AASA,SAAgBA,EAAgB,IAA8B,CAAC,GAAiB;CAC9E,IAAMC,IAAOC,EAAYC,CAAO;CAChC,OAAOC,EAAqBH,EAAK,WAAWA,EAAK,WAAWA,EAAK,SAAS;AAC5E"}

package/dist/interactions/actions/align/align.js

@@ -2,9 +2,9 @@ import { IDENTITY_POSE_COMPOSITION as e } from "../../../core/scene/composeFrame
 import { createTransformOp as t } from "../../../core/ops/transform.js";
 import { unionAABB as n } from "../../../core/geometry/unionBounds.js";
 import { RECT_POSE_DESCRIPTOR as r, translatePoseViaDescriptor as i, visualBoundsViaDescriptor as a } from "../../../core/geometry/poseDescriptor.js";
-import { poseFrame as o } from "../poseFrame.js";
-import { dispatchApplyBatch as s } from "../../../core/applyOps.js";
-import { usePointerContext as c } from "../../../features/pointer/PointerContext.js";
+import { usePointerContext as o } from "../../../features/pointer/PointerContext.js";
+import { poseFrame as s } from "../poseFrame.js";
+import { dispatchApplyBatch as c } from "../../../core/applyOps.js";
 import { resolveSpatialReference as l } from "../spatialReference.js";
 import { useCallback as u } from "react";
 import { useLatest as d } from "@weasel-js/react";
@@ -41,12 +41,12 @@ function p(e, t, n) {
 	}
 }
 function m(n, l = {}) {
-	let m = d(n), h = d(l), g = c(), _ = d(g);
-	return { align: u((n, c) => {
-		let l = m.current, u = h.current, d = l.getSelection(), g = u.geometry ?? r, v = o({
+	let m = d(n), h = d(l), g = o(), _ = d(g);
+	return { align: u((n, o) => {
+		let l = m.current, u = h.current, d = l.getSelection(), g = u.geometry ?? r, v = s({
 			getPose: (e) => l.getPose(e),
 			getParent: (e) => l.getParent?.(e) ?? null
-		}, u.composition ?? e), y = d.map((e) => v.world(e)), b = y.map((e) => a(e, g)), x = f(b, c, {
+		}, u.composition ?? e), y = d.map((e) => v.world(e)), b = y.map((e) => a(e, g)), x = f(b, o, {
 			pointer: () => {
 				let e = _.current?.get();
 				return e ? {
@@ -68,7 +68,7 @@ function m(n, l = {}) {
 				to: v.local(d[e], o)
 			}));
 		}
-		S.length !== 0 && s(l, S, u.label ?? "Align");
+		S.length !== 0 && c(l, S, u.label ?? "Align");
 	}, [
 		m,
 		h,

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

@@ -1,6 +1,6 @@
-import { dispatchApplyBatch as e } from "../../../core/applyOps.js";
+import { dwarn as e } from "../../../debug/flag.js";
 import { usePointerContext as t } from "../../../features/pointer/PointerContext.js";
-import { dwarn as n } from "../../../debug/flag.js";
+import { dispatchApplyBatch as n } from "../../../core/applyOps.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";
@@ -8,39 +8,41 @@ import { useLatest as c } from "@weasel-js/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({
+	let { getSelection: u, onPaste: f, onPasteOmitted: m, pasteLabel: h = "Paste", getDropPoint: g, produceFlavors: _, jsonReplacer: v } = a, y = t(), b = g ?? y?.getDropPoint, x = s(l), S = c(i), C = c({
 		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);
+			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]),
+		}, [S, C]),
 		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?.()
+			let e = x.current;
+			if (e.items.length === 0) return;
+			let t = S.current, i = r(t, 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 && (n(t, i.ops, C.current.pasteLabel), x.current = { items: i.created }, C.current.onPaste?.(i.newIds));
+		}, [S, C]),
+		isEmpty: o(() => x.current.items.length === 0, [])
 	};
 }
 function d(e, t) {
@@ -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 '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  /** 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// 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"}

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

@@ -1 +1 @@
-{"version":3,"file":"cloneByAltDrag.js","names":["cloneByAltDrag","mods","ctx","snap","pose","created","newIds","o","from","createInsertOp","createSetSelectionOp"],"sources":["../../../../../src/interactions/actions/clone/behaviors/cloneByAltDrag.ts"],"sourcesContent":["import { createInsertOp } from 'core/ops/create';\nimport { createSetSelectionOp } from 'core/ops/select';\nimport type { NodeId } from 'core/scene/types';\nimport type { CloneBehavior } from '../../../gestures/types';\n\n/** Clone-on-alt-drag behavior for `useClone`; activates when Alt/Option is held at drag start. */\nexport function cloneByAltDrag(): CloneBehavior {\n  return {\n    id: 'cloneByAltDrag',\n    activates: (mods) => mods.alt === true,\n    onEnd(pose, ctx) {\n      if (!ctx.adapter.snapshotSelection || !ctx.adapter.commitPaste) return [];\n      const snap = ctx.adapter.snapshotSelection(pose.ids);\n      const created = ctx.adapter.commitPaste(snap, pose.offset, {\n        dropPoint: { worldX: pose.worldX, worldY: pose.worldY },\n      });\n      if (created.length === 0) return [];\n      const newIds = created.map((o: { id: string }) => o.id);\n      const from = ctx.adapter.getSelection?.() ?? [];\n      return [\n        ...created.map((o) => createInsertOp({ node: o })),\n        createSetSelectionOp({ from: from as NodeId[], to: newIds as NodeId[] }),\n      ];\n    },\n  };\n}\n"],"mappings":";;;AAMA,SAAgBA,IAAgC;CAC9C,OAAO;EACL,IAAI;EACJ,YAAY,MAASC,EAAK,QAAQ;EAClC,MAAM,GAAM,GAAK;GACf,IAAI,CAACC,EAAI,QAAQ,qBAAqB,CAACA,EAAI,QAAQ,aAAa,OAAO,CAAC;GACxE,IAAMC,IAAOD,EAAI,QAAQ,kBAAkBE,EAAK,GAAG,GAC7CC,IAAUH,EAAI,QAAQ,YAAYC,GAAMC,EAAK,QAAQ,EACzD,WAAW;IAAE,QAAQA,EAAK;IAAQ,QAAQA,EAAK;GAAO,EACxD,CAAC;GACD,IAAIC,EAAQ,WAAW,GAAG,OAAO,CAAC;GAClC,IAAMC,IAASD,EAAQ,KAAK,MAAsBE,EAAE,EAAE,GAChDC,IAAON,EAAI,QAAQ,eAAe,KAAK,CAAC;GAC9C,OAAO,CACL,GAAGG,EAAQ,KAAK,MAAMI,EAAe,EAAE,MAAMF,EAAE,CAAC,CAAC,GACjDG,EAAqB;IAAQ;IAAkB,IAAIJ;GAAmB,CAAC,CACzE;EACF;CACF;AACF"}
+{"version":3,"file":"cloneByAltDrag.js","names":["cloneByAltDrag","mods","ctx","snap","pose","created","newIds","o","from","createInsertOp","createSetSelectionOp"],"sources":["../../../../../src/interactions/actions/clone/behaviors/cloneByAltDrag.ts"],"sourcesContent":["import { createInsertOp } from 'core/ops/create';\nimport { createSetSelectionOp } from 'core/ops/select';\nimport type { NodeId } from 'core/scene/types';\nimport type { CloneBehavior } from '../../../gestures/types';\n\n/** Clone-on-alt-drag behavior; activates when Alt/Option is held at drag start.\n *  `cloneAction` runs no clone behaviors, so nothing in the kit calls this. */\nexport function cloneByAltDrag(): CloneBehavior {\n  return {\n    id: 'cloneByAltDrag',\n    activates: (mods) => mods.alt === true,\n    onEnd(pose, ctx) {\n      if (!ctx.adapter.snapshotSelection || !ctx.adapter.commitPaste) return [];\n      const snap = ctx.adapter.snapshotSelection(pose.ids);\n      const created = ctx.adapter.commitPaste(snap, pose.offset, {\n        dropPoint: { worldX: pose.worldX, worldY: pose.worldY },\n      });\n      if (created.length === 0) return [];\n      const newIds = created.map((o: { id: string }) => o.id);\n      const from = ctx.adapter.getSelection?.() ?? [];\n      return [\n        ...created.map((o) => createInsertOp({ node: o })),\n        createSetSelectionOp({ from: from as NodeId[], to: newIds as NodeId[] }),\n      ];\n    },\n  };\n}\n"],"mappings":";;;AAOA,SAAgBA,IAAgC;CAC9C,OAAO;EACL,IAAI;EACJ,YAAY,MAASC,EAAK,QAAQ;EAClC,MAAM,GAAM,GAAK;GACf,IAAI,CAACC,EAAI,QAAQ,qBAAqB,CAACA,EAAI,QAAQ,aAAa,OAAO,CAAC;GACxE,IAAMC,IAAOD,EAAI,QAAQ,kBAAkBE,EAAK,GAAG,GAC7CC,IAAUH,EAAI,QAAQ,YAAYC,GAAMC,EAAK,QAAQ,EACzD,WAAW;IAAE,QAAQA,EAAK;IAAQ,QAAQA,EAAK;GAAO,EACxD,CAAC;GACD,IAAIC,EAAQ,WAAW,GAAG,OAAO,CAAC;GAClC,IAAMC,IAASD,EAAQ,KAAK,MAAsBE,EAAE,EAAE,GAChDC,IAAON,EAAI,QAAQ,eAAe,KAAK,CAAC;GAC9C,OAAO,CACL,GAAGG,EAAQ,KAAK,MAAMI,EAAe,EAAE,MAAMF,EAAE,CAAC,CAAC,GACjDG,EAAqB;IAAQ;IAAkB,IAAIJ;GAAmB,CAAC,CACzE;EACF;CACF;AACF"}

package/dist/interactions/actions/defaultCommitAdapter.js

@@ -1,29 +1,30 @@
 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 { pickability as r } from "../../core/scene/pickability.js";
 //#region src/interactions/actions/defaultCommitAdapter.ts
-function r(r, i) {
+function i(i, a) {
 	return {
-		getNode: (e) => r.get(t(e)),
-		getNodes: () => [...r.renderOrderNodes()],
-		getPose: (n) => e(r, r.get(t(n))),
-		getSelection: () => [...i ? i.getSelection() : r.getSelection()],
+		getNode: (e) => i.get(t(e)),
+		getNodes: () => [...i.renderOrderNodes()],
+		getPose: (n) => e(i, i.get(t(n))),
+		getSelection: () => [...a ? a.getSelection() : i.getSelection()],
 		setSelection: (e) => {
-			i ? i.setSelection(e.map(t)) : r.setSelection(e.map(t));
+			a ? a.setSelection(e.map(t)) : i.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))],
+		getParent: (e) => i.get(t(e))?.parent ?? null,
+		getRemovalClosure: (e) => [...i.removalClosure(e.map(t))],
+		getChildren: (e) => e === null ? [...i.roots] : [...i.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);
+			for (let r = 0; r < n.length; r++) (e === null ? i.roots : i.childrenOf(t(e)))[r] !== n[r] && i.reorder(t(n[r]), r);
 		},
-		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({
+		setPose: (e, n) => i.setPose(t(e), n),
+		setParent: (e, n) => i.move(t(e), n == null ? null : t(n)),
+		setData: (e, n) => i.update(t(e), { data: n }),
+		setLayer: (e, n) => i.setLayer(t(e), n),
+		setLayout: (e, n) => i.setLayout(t(e), n),
+		removeNode: (e) => i.remove(t(e)),
+		insertNode: (e, t) => i.add({
 			kind: e.kind,
 			layer: e.layer,
 			pose: e.pose,
@@ -32,11 +33,12 @@ function r(r, i) {
 			...e.parent == null ? {} : { parent: e.parent },
 			...t === void 0 ? {} : { index: t },
 			...e.dependsOn === void 0 ? {} : { dependsOn: e.dependsOn },
+			...r(e),
 			...n(e)
 		})
 	};
 }
 //#endregion
-export { r as defaultCommitAdapter };
+export { i as defaultCommitAdapter };
 
 //# sourceMappingURL=defaultCommitAdapter.js.map