@weasel-js/core 1.9.3 → 1.9.4

package/dist/debug/flag.js

@@ -1,41 +1,2 @@
-//#region src/debug/flag.ts
-var e = ["weasel.debug", "weaseldraw.debug"], t = null;
-function n() {
-	let t = {
-		all: !1,
-		set: /* @__PURE__ */ new Set()
-	};
-	if (typeof localStorage > "u") return t;
-	try {
-		for (let t of e) {
-			let e = localStorage.getItem(t);
-			if (e != null && e !== "") return e === "1" || e === "true" || e === "*" ? {
-				all: !0,
-				set: /* @__PURE__ */ new Set()
-			} : {
-				all: !1,
-				set: new Set(e.split(/[\s,]+/).filter(Boolean))
-			};
-		}
-		return t;
-	} catch {
-		return t;
-	}
-}
-function r() {
-	return t === null && (t = n()), t;
-}
-function i(e) {
-	let t = r();
-	return t.all ? !0 : e === void 0 ? t.set.size > 0 : t.set.has(e);
-}
-function a(e, ...t) {
-	i(e) && console.debug(`[${e}]`, ...t);
-}
-function o(e, ...t) {
-	i(e) && console.warn(`[${e}]`, ...t);
-}
-//#endregion
-export { a as dlog, o as dwarn, i as isDebugEnabled };
-
-//# sourceMappingURL=flag.js.map
+import { dlog as e, dwarn as t, isDebugEnabled as n } from "@weasel-js/routing";
+export { e as dlog, t as dwarn, n as isDebugEnabled };

package/dist/features/chrome-caps/useHoverTracking.js

@@ -1,27 +1,32 @@
-import { useEffect as e, useRef as t } from "react";
-import { useLatest as n } from "@weasel-js/react";
+import { useCallback as e, useEffect as t, useMemo as n, useRef as r } from "react";
+import { useLatest as i } from "@weasel-js/react";
 //#region src/features/chrome-caps/useHoverTracking.ts
-function r(r) {
-	let { canvasRef: i, nodeAtClientPoint: a, enabled: o = !0 } = r, s = t(null), c = n(a);
-	return e(() => {
-		if (!o) return;
-		let e = i.current;
-		if (!e) return;
+function a(a) {
+	let { nodeAtClientPoint: o, enabled: s = !0 } = a, c = r(null), l = i(o), u = r(null), d = r(s), f = r(null), p = e(() => {
+		f.current?.(), f.current = null, c.current = null;
+		let e = u.current;
+		if (!e || !d.current) return;
 		let t = (e) => {
-			s.current = c.current(e.clientX, e.clientY)?.id ?? null;
+			c.current = l.current(e.clientX, e.clientY)?.id ?? null;
 		}, n = () => {
-			s.current = null;
+			c.current = null;
 		};
-		return e.addEventListener("pointermove", t), e.addEventListener("pointerleave", n), () => {
+		e.addEventListener("pointermove", t), e.addEventListener("pointerleave", n), f.current = () => {
 			e.removeEventListener("pointermove", t), e.removeEventListener("pointerleave", n);
 		};
-	}, [
-		i,
-		o,
-		c
-	]), () => s.current;
+	}, [l]);
+	t(() => (d.current = s, p(), () => {
+		f.current?.(), f.current = null, c.current = null;
+	}), [s, p]);
+	let m = e((e) => {
+		u.current !== e && (u.current = e, p());
+	}, [p]), h = e(() => c.current, []);
+	return n(() => ({
+		getHover: h,
+		canvasRef: m
+	}), [h, m]);
 }
 //#endregion
-export { r as useHoverTracking };
+export { a as useHoverTracking };
 
 //# sourceMappingURL=useHoverTracking.js.map

package/dist/features/chrome-caps/useHoverTracking.js.map

@@ -1 +1 @@
-{"version":3,"file":"useHoverTracking.js","names":["useHoverTracking","args","hoverRef","useRef","nodeAtRef","useLatest","nodeAtClientPoint","useEffect","enabled","c","canvasRef","onMove","onLeave"],"sources":["../../../src/features/chrome-caps/useHoverTracking.ts"],"sourcesContent":["/**\n * useHoverTracking — last-hovered NodeId for chrome-caps rules.\n *\n * Attaches a `pointermove` listener to the supplied canvas; on each move it\n * runs the supplied `nodeAtClientPoint` and caches the resulting id on a ref.\n * Cleared on `pointerleave` (pointer left the canvas → nothing is hovered).\n *\n * Returns a stable getter — call once per frame from `buildChromeCtx`.\n *\n * No re-render: the ref updates silently, and the next render that\n * reads it picks up the fresh value. Chrome-caps rules are evaluated\n * during paint, so the hover state is always read fresh.\n */\n\nimport { useEffect, useRef, type RefObject } from 'react';\nimport { useLatest } from '@weasel-js/react';\nimport type { NodeId } from '../../core/scene/types';\n\n/** Options for `useHoverTracking`. */\nexport interface UseHoverTrackingArgs {\n  canvasRef: RefObject<HTMLElement | null>;\n  /** Topmost id under a client point, or null. One lookup rather than a\n   *  client→world thunk beside a world-space picker: a screen-pixel pick\n   *  tolerance converts against the camera the point resolved to, and two\n   *  thunks are two chances to disagree about which view that is. */\n  nodeAtClientPoint: (clientX: number, clientY: number) => { id: NodeId } | null;\n  enabled?: boolean;\n}\n\n/** Track which node the pointer is over. Returns a getter rather than state,\n *  so per-frame code can read the current value without the hover re-rendering\n *  the component on every pointer move. */\nexport function useHoverTracking(args: UseHoverTrackingArgs): () => NodeId | null {\n  const { canvasRef, nodeAtClientPoint, enabled = true } = args;\n  const hoverRef = useRef<NodeId | null>(null);\n  const nodeAtRef = useLatest(nodeAtClientPoint);\n\n  useEffect(() => {\n    if (!enabled) return;\n    const c = canvasRef.current;\n    if (!c) return;\n    const onMove = (e: PointerEvent) => {\n      hoverRef.current = nodeAtRef.current(e.clientX, e.clientY)?.id ?? null;\n    };\n    const onLeave = () => { hoverRef.current = null; };\n    c.addEventListener('pointermove', onMove);\n    c.addEventListener('pointerleave', onLeave);\n    return () => {\n      c.removeEventListener('pointermove', onMove);\n      c.removeEventListener('pointerleave', onLeave);\n    };\n  }, [canvasRef, enabled, nodeAtRef]);\n\n  return () => hoverRef.current;\n}\n"],"mappings":";;;AAgCA,SAAgBA,EAAiB,GAAiD;CAChF,IAAM,EAAE,cAAW,sBAAmB,aAAU,OAASC,GACnDC,IAAWC,EAAsB,IAAI,GACrCC,IAAYC,EAAUC,CAAiB;CAkB7C,OAhBAC,QAAgB;EACd,IAAI,CAACC,GAAS;EACd,IAAMC,IAAIC,EAAU;EACpB,IAAI,CAACD,GAAG;EACR,IAAME,KAAU,MAAoB;GAClC,EAAS,UAAUP,EAAU,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,MAAM;EACpE,GACMQ,UAAgB;GAAE,EAAS,UAAU;EAAM;EAGjD,OAFAH,EAAE,iBAAiB,eAAeE,CAAM,GACxCF,EAAE,iBAAiB,gBAAgBG,CAAO,SAC7B;GAEX,AADAH,EAAE,oBAAoB,eAAeE,CAAM,GAC3CF,EAAE,oBAAoB,gBAAgBG,CAAO;EAC/C;CACF,GAAG;EAACF;EAAWF;EAASJ;CAAS,CAAC,SAErBF,EAAS;AACxB"}
+{"version":3,"file":"useHoverTracking.js","names":["useHoverTracking","args","hoverRef","useRef","nodeAtRef","useLatest","nodeAtClientPoint","elementRef","enabledRef","enabled","detachRef","sync","useCallback","el","onMove","onLeave","canvasRef","element","getHover","useMemo"],"sources":["../../../src/features/chrome-caps/useHoverTracking.ts"],"sourcesContent":["/**\n * useHoverTracking — last-hovered NodeId for chrome-caps rules.\n *\n * Listens for `pointermove` on the element handed to the returned\n * `canvasRef`; on each move it runs the supplied `nodeAtClientPoint` and\n * caches the resulting id on a ref. Cleared on `pointerleave` (pointer left\n * the canvas → nothing is hovered).\n *\n * `getHover` is a stable getter — call once per frame from `buildChromeCtx`.\n *\n * No re-render: the ref updates silently, and the next render that\n * reads it picks up the fresh value. Chrome-caps rules are evaluated\n * during paint, so the hover state is always read fresh.\n */\n\nimport { useCallback, useEffect, useMemo, useRef } from 'react';\nimport { useLatest } from '@weasel-js/react';\nimport type { NodeId } from '../../core/scene/types';\n\n/** Options for `useHoverTracking`. */\nexport interface UseHoverTrackingArgs {\n  /** Topmost id under a client point, or null. One lookup rather than a\n   *  client→world thunk beside a world-space picker: a screen-pixel pick\n   *  tolerance converts against the camera the point resolved to, and two\n   *  thunks are two chances to disagree about which view that is. */\n  nodeAtClientPoint: (clientX: number, clientY: number) => { id: NodeId } | null;\n  enabled?: boolean;\n}\n\n/** What `useHoverTracking` returns. Both members keep their identity. */\nexport interface HoverTracking {\n  /** The node the pointer is over, or null. */\n  getHover: () => NodeId | null;\n  /** Hand it the element to track, or null to stop: a callback ref, so an\n   *  element that mounts after the hook is tracked from the moment it arrives. */\n  canvasRef: (element: HTMLElement | null) => void;\n}\n\n/** Track which node the pointer is over. Returns a getter rather than state,\n *  so per-frame code can read the current value without the hover re-rendering\n *  the component on every pointer move. */\nexport function useHoverTracking(args: UseHoverTrackingArgs): HoverTracking {\n  const { nodeAtClientPoint, enabled = true } = args;\n  const hoverRef = useRef<NodeId | null>(null);\n  const nodeAtRef = useLatest(nodeAtClientPoint);\n  const elementRef = useRef<HTMLElement | null>(null);\n  const enabledRef = useRef(enabled);\n  const detachRef = useRef<(() => void) | null>(null);\n\n  const sync = useCallback(() => {\n    detachRef.current?.();\n    detachRef.current = null;\n    hoverRef.current = null;\n    const el = elementRef.current;\n    if (!el || !enabledRef.current) return;\n    const onMove = (e: PointerEvent) => {\n      hoverRef.current = nodeAtRef.current(e.clientX, e.clientY)?.id ?? null;\n    };\n    const onLeave = () => { hoverRef.current = null; };\n    el.addEventListener('pointermove', onMove);\n    el.addEventListener('pointerleave', onLeave);\n    detachRef.current = () => {\n      el.removeEventListener('pointermove', onMove);\n      el.removeEventListener('pointerleave', onLeave);\n    };\n  }, [nodeAtRef]);\n\n  useEffect(() => {\n    enabledRef.current = enabled;\n    sync();\n    return () => {\n      detachRef.current?.();\n      detachRef.current = null;\n      hoverRef.current = null;\n    };\n  }, [enabled, sync]);\n\n  const canvasRef = useCallback((element: HTMLElement | null) => {\n    if (elementRef.current === element) return;\n    elementRef.current = element;\n    sync();\n  }, [sync]);\n  const getHover = useCallback(() => hoverRef.current, []);\n\n  return useMemo(() => ({ getHover, canvasRef }), [getHover, canvasRef]);\n}\n"],"mappings":";;;AAyCA,SAAgBA,EAAiB,GAA2C;CAC1E,IAAM,EAAE,sBAAmB,aAAU,OAASC,GACxCC,IAAWC,EAAsB,IAAI,GACrCC,IAAYC,EAAUC,CAAiB,GACvCC,IAAaJ,EAA2B,IAAI,GAC5CK,IAAaL,EAAOM,CAAO,GAC3BC,IAAYP,EAA4B,IAAI,GAE5CQ,IAAOC,QAAkB;EAG7B,AAFAF,EAAU,UAAU,GACpB,EAAU,UAAU,MACpB,EAAS,UAAU;EACnB,IAAMG,IAAKN,EAAW;EACtB,IAAI,CAACM,KAAM,CAACL,EAAW,SAAS;EAChC,IAAMM,KAAU,MAAoB;GAClC,EAAS,UAAUV,EAAU,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,MAAM;EACpE,GACMW,UAAgB;GAAE,EAAS,UAAU;EAAM;EAGjD,AAFAF,EAAG,iBAAiB,eAAeC,CAAM,GACzCD,EAAG,iBAAiB,gBAAgBE,CAAO,GAC3C,EAAU,gBAAgB;GAExB,AADAF,EAAG,oBAAoB,eAAeC,CAAM,GAC5CD,EAAG,oBAAoB,gBAAgBE,CAAO;EAChD;CACF,GAAG,CAACX,CAAS,CAAC;CAEd,SACE,EAAW,UAAUK,GACrBE,EAAK,SACQ;EAGX,AAFAD,EAAU,UAAU,GACpB,EAAU,UAAU,MACpB,EAAS,UAAU;CACrB,IACC,CAACD,GAASE,CAAI,CAAC;CAElB,IAAMK,IAAYJ,GAAa,MAAgC;EAC7D,AAAIL,EAAW,YAAYU,MAC3B,EAAW,UAAUA,GACrBN,EAAK;CACP,GAAG,CAACA,CAAI,CAAC,GACHO,IAAWN,QAAkBV,EAAS,SAAS,CAAC,CAAC;CAEvD,OAAOiB,SAAe;EAAE;EAAU;CAAU,IAAI,CAACD,GAAUF,CAAS,CAAC;AACvE"}

package/dist/features/focus/gateLayer.js

@@ -2,11 +2,10 @@ import { subscribeToSources as e } from "../../core/layers/render.js";
 //#region src/features/focus/gateLayer.ts
 function t(t) {
 	let { layer: n, visible: r } = t, i = {
-		id: n.id,
-		label: n.label,
+		...n,
 		draw: (e, t, i) => r() ? n.draw(e, t, i) : []
-	};
-	return n.defaultVisible !== void 0 && (i.defaultVisible = n.defaultVisible), n.alwaysOn !== void 0 && (i.alwaysOn = n.alwaysOn), n.space !== void 0 && (i.space = n.space), n.subscribe && (i.subscribe = e([n])), i;
+	}, { deps: a, hitTest: o } = n;
+	return a && (i.deps = (e, t, n) => [r(), ...a(e, t, n)]), o && (i.hitTest = (...e) => r() ? o(...e) : null), n.subscribe && (i.subscribe = e([n])), i;
 }
 //#endregion
 export { t as gateLayer };

package/dist/features/focus/gateLayer.js.map

@@ -1 +1 @@
-{"version":3,"file":"gateLayer.js","names":["gateLayer","opts","wrapped","layer","visible","data","view","dims","subscribeToSources"],"sources":["../../../src/features/focus/gateLayer.ts"],"sourcesContent":["/**\n * `RenderLayer` wrapper that conditionally emits draw commands based on a\n * predicate. Most common use: hide selection-overlay handles when the\n * canvas isn't focused.\n *\n * The predicate is a getter (`() => boolean`), not a static value, because\n * RenderLayers are constructed once but their `draw` runs every frame —\n * a static value would lock in whatever the predicate returned at\n * construction time.\n */\nimport { subscribeToSources, type RenderLayer } from 'core/layers/render';\n\n/** Options for `gateLayer`. */\nexport interface GateLayerOptions<TData> {\n  /** The wrapped layer. Its `id`, `label`, `defaultVisible`, `alwaysOn`,\n   *  `space` flow through unchanged. */\n  layer: RenderLayer<TData>;\n  /** Returns `true` to render the layer this frame, `false` to skip. */\n  visible: () => boolean;\n}\n\n/** Wrap a render layer so it only draws while `visible()` is true. The\n *  predicate is consulted per frame, which is how chrome follows canvas focus\n *  without the layer knowing anything about focus. */\nexport function gateLayer<TData>(opts: GateLayerOptions<TData>): RenderLayer<TData> {\n  const { layer, visible } = opts;\n  const wrapped: RenderLayer<TData> = {\n    id: layer.id,\n    label: layer.label,\n    draw: (data, view, dims) => (visible() ? layer.draw(data, view, dims) : []),\n  };\n  if (layer.defaultVisible !== undefined) wrapped.defaultVisible = layer.defaultVisible;\n  if (layer.alwaysOn !== undefined) wrapped.alwaysOn = layer.alwaysOn;\n  if (layer.space !== undefined) wrapped.space = layer.space;\n  if (layer.subscribe) wrapped.subscribe = subscribeToSources([layer]);\n  return wrapped;\n}\n"],"mappings":";;AAwBA,SAAgBA,EAAiB,GAAmD;CAClF,IAAM,EAAE,UAAO,eAAYC,GACrBC,IAA8B;EAClC,IAAIC,EAAM;EACV,OAAOA,EAAM;EACb,OAAO,GAAM,GAAM,MAAUC,EAAQ,IAAID,EAAM,KAAKE,GAAMC,GAAMC,CAAI,IAAI,CAAC;CAC3E;CAKA,OAJIJ,EAAM,mBAAmB,KAAA,MAAW,EAAQ,iBAAiBA,EAAM,iBACnEA,EAAM,aAAa,KAAA,MAAW,EAAQ,WAAWA,EAAM,WACvDA,EAAM,UAAU,KAAA,MAAW,EAAQ,QAAQA,EAAM,QACjDA,EAAM,cAAW,EAAQ,YAAYK,EAAmB,CAACL,CAAK,CAAC,IAC5DD;AACT"}
+{"version":3,"file":"gateLayer.js","names":["gateLayer","opts","wrapped","layer","visible","data","view","dims","deps","hitTest","args","subscribeToSources"],"sources":["../../../src/features/focus/gateLayer.ts"],"sourcesContent":["/**\n * `RenderLayer` wrapper that conditionally emits draw commands based on a\n * predicate. Most common use: hide selection-overlay handles when the\n * canvas isn't focused.\n *\n * The predicate is a getter (`() => boolean`), not a static value, because\n * RenderLayers are constructed once but their `draw` runs every frame —\n * a static value would lock in whatever the predicate returned at\n * construction time.\n */\nimport { subscribeToSources, type RenderLayer } from 'core/layers/render';\n\n/** Options for `gateLayer`. */\nexport interface GateLayerOptions<TData> {\n  /** The wrapped layer. Everything but `draw`, `hitTest`, and `deps` flows\n   *  through unchanged. */\n  layer: RenderLayer<TData>;\n  /** Returns `true` to render the layer this frame, `false` to skip. */\n  visible: () => boolean;\n}\n\n/** Wrap a render layer so it only draws, and is only hit, while `visible()`\n *  is true. The predicate is consulted per frame, which is how chrome follows\n *  canvas focus without the layer knowing anything about focus. */\nexport function gateLayer<TData>(opts: GateLayerOptions<TData>): RenderLayer<TData> {\n  const { layer, visible } = opts;\n  const wrapped: RenderLayer<TData> = {\n    ...layer,\n    draw: (data, view, dims) => (visible() ? layer.draw(data, view, dims) : []),\n  };\n  const { deps, hitTest } = layer;\n  if (deps) wrapped.deps = (data, view, dims) => [visible(), ...deps(data, view, dims)];\n  if (hitTest) wrapped.hitTest = (...args) => (visible() ? hitTest(...args) : null);\n  if (layer.subscribe) wrapped.subscribe = subscribeToSources([layer]);\n  return wrapped;\n}\n"],"mappings":";;AAwBA,SAAgBA,EAAiB,GAAmD;CAClF,IAAM,EAAE,UAAO,eAAYC,GACrBC,IAA8B;EAClC,GAAGC;EACH,OAAO,GAAM,GAAM,MAAUC,EAAQ,IAAID,EAAM,KAAKE,GAAMC,GAAMC,CAAI,IAAI,CAAC;CAC3E,GACM,EAAE,SAAM,eAAYJ;CAI1B,OAHIK,MAAM,EAAQ,QAAQ,GAAM,GAAM,MAAS,CAACJ,EAAQ,GAAG,GAAGI,EAAKH,GAAMC,GAAMC,CAAI,CAAC,IAChFE,MAAS,EAAQ,WAAW,GAAGC,MAAUN,EAAQ,IAAIK,EAAQ,GAAGC,CAAI,IAAI,OACxEP,EAAM,cAAW,EAAQ,YAAYQ,EAAmB,CAACR,CAAK,CAAC,IAC5DD;AACT"}

package/dist/features/images/imageCache.js

@@ -39,7 +39,8 @@ function g(e) {
 					height: n.height
 				},
 				scale: 1,
-				failed: /* @__PURE__ */ new Set()
+				failed: /* @__PURE__ */ new Set(),
+				floor: 0
 			} } : {}
 		}), h());
 	}, () => {
@@ -57,18 +58,20 @@ function v(e, n, i, a) {
 	let s = _(i.natural, a);
 	if (s === void 0) return;
 	let c = s > i.scale;
-	if (!(!c && s * r > i.scale)) {
-		for (let e of i.failed) if (s === e || c && e > i.scale && s >= e) return;
-		i.pending = s, m(e, {
-			width: Math.max(1, Math.round(i.natural.width * s)),
-			height: Math.max(1, Math.round(i.natural.height * s))
+	c && i.shrunkTo === i.scale && (i.floor = Math.max(i.floor, s));
+	let l = c ? s : Math.max(s, i.floor);
+	if (!(!c && l * r > i.scale)) {
+		for (let e of i.failed) if (l === e || c && e > i.scale && l >= e) return;
+		i.pending = l, m(e, {
+			width: Math.max(1, Math.round(i.natural.width * l)),
+			height: Math.max(1, Math.round(i.natural.height * l))
 		}).then((r) => {
 			if (o.get(e) !== n) return;
 			i.pending = void 0;
 			let a = n.bitmap;
-			n.bitmap = r, i.scale = s, a && a !== r && t(a), h();
+			n.bitmap = r, i.shrunkTo = c ? void 0 : l, i.scale = l, a && a !== r && t(a), h();
 		}, () => {
-			o.get(e) === n && (i.pending = void 0, i.failed.add(s));
+			o.get(e) === n && (i.pending = void 0, i.failed.add(l));
 		});
 	}
 }
@@ -84,11 +87,18 @@ function b(e) {
 	return o.get(e)?.status ?? "idle";
 }
 function x(e) {
+	let n = o.get(e);
+	o.delete(e), c.delete(e), n?.bitmap && t(n.bitmap);
+}
+function S(e) {
+	o.get(e)?.status === "error" && (g(e), h());
+}
+function C(e) {
 	return s.add(e), () => {
 		s.delete(e);
 	};
 }
 //#endregion
-export { y as getImageBitmap, b as imageStatus, l as isVectorImageSrc, x as subscribeImageReady };
+export { y as getImageBitmap, b as imageStatus, l as isVectorImageSrc, x as releaseImage, S as retryImage, C as subscribeImageReady };
 
 //# sourceMappingURL=imageCache.js.map

package/dist/features/images/imageCache.js.map

@@ -1 +1 @@
-{"version":3,"file":"imageCache.js","names":["MAX_VECTOR_RASTER_PIXELS","SHRINK_SLACK","FALLBACK_WIDTH","FALLBACK_HEIGHT","cache","subscribers","decodedVectors","isVectorImageSrc","src","requireDom","decodeImage","img","decodeVector","decoded","rasterizeVector","width","size","height","canvas","c2d","loader","notify","cb","startLoad","entry","bitmap","rasterScaleFor","need","drawnAt","natural","side","maxImageTextureSide","cap","maybeReraster","v","target","grow","f","old","releaseImageSource","getImageBitmap","imageStatus","subscribeImageReady"],"sources":["../../../src/features/images/imageCache.ts"],"sourcesContent":["/**\n * imageCache — the kit's per-`src` image loader + cache.\n *\n * The shape-painter chain (`kit:image` in `NodeShape.ts`) is synchronous, but\n * decoding an image is async. This module bridges the two: `getImageBitmap` is\n * a synchronous read that returns the decoded `ImageBitmap` when ready, and\n * otherwise returns `undefined` and lazily kicks off a de-duped async load.\n * When a load resolves (or errors), every `subscribeImageReady` listener fires\n * — `<SceneCanvas>` subscribes and calls `requestRedraw()`, so the painter\n * re-runs and emits the now-ready bitmap.\n *\n * `src` is any browser-loadable image string: a remote URL, a `blob:` URL, or\n * a `data:image/…;base64,…` URI (the embedded-bytes path). The decoded bitmap\n * lives only here, keyed by `src` — never in node `data` — so `scene.toJSON()`\n * round-trips the (serializable) `src` string untouched.\n */\n\nimport { maxImageTextureSide, releaseImageSource } from 'renderer/cache/GLImageCache';\n\n/** Public shape of an image node's `data`. `src` round-trips through\n *  serialization; the decoded bitmap is held in this cache, not on the node. */\nexport interface ImageNodeData {\n  image: {\n    src: string;\n    opacity?: number;\n    /** The part of the bitmap drawn into the pose rect, as fractions of the\n     *  bitmap's width and height from its top-left. Omitted draws the whole\n     *  bitmap. Fractions, so the data means the same thing before the bitmap\n     *  has decoded and after `src` is swapped for another resolution. */\n    source?: { x: number; y: number; width: number; height: number };\n    /** Mirror the drawn region within the pose rect. The rect does not move. */\n    flipX?: boolean;\n    flipY?: boolean;\n  };\n}\n\n/** Where an image is in its load: never requested, in flight, decoded, or\n *  failed. Renderers paint a placeholder for anything but `'ready'`. */\nexport type ImageStatus = 'idle' | 'loading' | 'ready' | 'error';\n\n/** A size in device pixels. */\nexport interface ImageRasterSize {\n  width: number;\n  height: number;\n}\n\n/** A vector source's raster bookkeeping. `scale` is the current raster's size\n *  over the natural one, always a power of two unless a cap cut it short. */\ninterface VectorRaster {\n  natural: ImageRasterSize;\n  scale: number;\n  pending?: number;\n  failed: Set<number>;\n}\n\ninterface Entry {\n  status: ImageStatus;\n  bitmap?: ImageBitmap;\n  vector?: VectorRaster;\n}\n\n/** `size` is absent for the first load, which decodes at natural size. */\ntype Loader = (src: string, size?: ImageRasterSize) => Promise<ImageBitmap>;\n\n/** One vector raster may hold at most 64MB of RGBA. */\nconst MAX_VECTOR_RASTER_PIXELS = 4096 * 4096;\n/** A raster is only shrunk once it is this many times larger than needed, so\n *  zooming back and forth across a bucket edge does not re-raster each way. */\nconst SHRINK_SLACK = 4;\n// CSS default object size, as `kit:svg` measures a viewBox-only SVG.\nconst FALLBACK_WIDTH = 300;\nconst FALLBACK_HEIGHT = 150;\n\nconst cache = new Map<string, Entry>();\nconst subscribers = new Set<() => void>();\nconst decodedVectors = new Map<string, Promise<HTMLImageElement>>();\n\n/** True when `src` names SVG — a `data:image/svg+xml` URI, or a URL whose path\n *  ends in `.svg`/`.svgz`. Such sources re-rasterize at the size they are drawn\n *  at; everything else decodes once. A `blob:` URL carries no type and counts\n *  as raster. */\nexport function isVectorImageSrc(src: string): boolean {\n  if (/^data:image\\/svg\\+xml[;,]/i.test(src)) return true;\n  if (/^(data|blob):/i.test(src)) return false;\n  return /\\.svgz?$/i.test(src.replace(/[?#].*$/, ''));\n}\n\nfunction requireDom(): void {\n  if (typeof Image === 'undefined' || typeof createImageBitmap === 'undefined') {\n    throw new Error('weasel imageCache: no DOM image loader in this environment');\n  }\n}\n\nasync function decodeImage(src: string): Promise<HTMLImageElement> {\n  const img = new Image();\n  img.crossOrigin = 'anonymous';\n  img.src = src;\n  await img.decode();\n  return img;\n}\n\nfunction decodeVector(src: string): Promise<HTMLImageElement> {\n  let decoded = decodedVectors.get(src);\n  if (!decoded) {\n    decoded = decodeImage(src);\n    decodedVectors.set(src, decoded);\n    decoded.catch(() => decodedVectors.delete(src));\n  }\n  return decoded;\n}\n\n// `createImageBitmap` rejects SVG blobs and resamples an SVG `<img>` rather\n// than re-drawing it, so vectors go through a canvas `drawImage` at full size.\nasync function rasterizeVector(src: string, size?: ImageRasterSize): Promise<ImageBitmap> {\n  const img = await decodeVector(src);\n  const width = size?.width ?? (img.naturalWidth || FALLBACK_WIDTH);\n  const height = size?.height ?? (img.naturalHeight || FALLBACK_HEIGHT);\n  const canvas: OffscreenCanvas | HTMLCanvasElement = typeof OffscreenCanvas !== 'undefined'\n    ? new OffscreenCanvas(width, height)\n    : Object.assign(document.createElement('canvas'), { width, height });\n  const c2d = canvas.getContext('2d') as CanvasDrawImage | null;\n  if (!c2d) throw new Error('weasel imageCache: no 2D context to rasterize an SVG');\n  c2d.drawImage(img, 0, 0, width, height);\n  return createImageBitmap(canvas);\n}\n\nconst defaultLoader: Loader = async (src, size) => {\n  requireDom();\n  if (isVectorImageSrc(src)) return rasterizeVector(src, size);\n  return createImageBitmap(await decodeImage(src));\n};\n\nlet loader: Loader = defaultLoader;\n\nfunction notify(): void {\n  for (const cb of subscribers) cb();\n}\n\nfunction startLoad(src: string): void {\n  const entry: Entry = { status: 'loading' };\n  cache.set(src, entry);\n  loader(src).then(\n    (bitmap) => {\n      // The entry may have been replaced/cleared mid-flight (reset, etc.);\n      // only commit if this src is still the one we started loading.\n      if (cache.get(src) !== entry) return;\n      cache.set(src, {\n        status: 'ready',\n        bitmap,\n        ...(isVectorImageSrc(src)\n          ? { vector: { natural: { width: bitmap.width, height: bitmap.height }, scale: 1, failed: new Set<number>() } }\n          : {}),\n      });\n      notify();\n    },\n    () => {\n      // Cache the error so a broken `src` doesn't reload-storm.\n      if (cache.get(src) !== entry) return;\n      cache.set(src, { status: 'error' });\n      notify();\n    },\n  );\n}\n\n/** The raster scale `drawnAt` calls for: the next power of two at or above the\n *  natural-to-drawn ratio, capped by texture size and the pixel ceiling. */\nfunction rasterScaleFor(natural: ImageRasterSize, drawnAt: ImageRasterSize): number | undefined {\n  const need = Math.max(drawnAt.width / natural.width, drawnAt.height / natural.height);\n  if (!(need > 0) || !Number.isFinite(need)) return undefined;\n  const side = maxImageTextureSide();\n  const cap = Math.min(\n    side / natural.width,\n    side / natural.height,\n    Math.sqrt(MAX_VECTOR_RASTER_PIXELS / (natural.width * natural.height)),\n  );\n  return Math.min(2 ** Math.ceil(Math.log2(need)), cap);\n}\n\nfunction maybeReraster(src: string, entry: Entry, v: VectorRaster, drawnAt: ImageRasterSize): void {\n  if (v.pending !== undefined) return;\n  const target = rasterScaleFor(v.natural, drawnAt);\n  if (target === undefined) return;\n  const grow = target > v.scale;\n  if (!grow && target * SHRINK_SLACK > v.scale) return;\n  for (const f of v.failed) if (target === f || (grow && f > v.scale && target >= f)) return;\n\n  v.pending = target;\n  const size = {\n    width: Math.max(1, Math.round(v.natural.width * target)),\n    height: Math.max(1, Math.round(v.natural.height * target)),\n  };\n  loader(src, size).then(\n    (bitmap) => {\n      if (cache.get(src) !== entry) return;\n      v.pending = undefined;\n      const old = entry.bitmap;\n      entry.bitmap = bitmap;\n      v.scale = target;\n      if (old && old !== bitmap) releaseImageSource(old);\n      notify();\n    },\n    () => {\n      // The previous raster keeps painting; only this scale is given up on.\n      if (cache.get(src) !== entry) return;\n      v.pending = undefined;\n      v.failed.add(target);\n    },\n  );\n}\n\n/** Synchronous read. Returns the decoded bitmap when ready; otherwise returns\n *  `undefined` and lazily starts a de-duped async load for `src`.\n *\n *  `drawnAt` is the size in device pixels the image is about to cover. A\n *  vector source ({@link isVectorImageSrc}) uses it to re-rasterize in\n *  power-of-two steps — the current raster is returned until the sharper one\n *  is ready. Raster sources ignore it. */\nexport function getImageBitmap(src: string, drawnAt?: ImageRasterSize): ImageBitmap | undefined {\n  const entry = cache.get(src);\n  if (!entry) {\n    startLoad(src);\n    return undefined;\n  }\n  if (drawnAt && entry.vector) maybeReraster(src, entry, entry.vector, drawnAt);\n  return entry.bitmap;\n}\n\n/** Current load status for `src` (`'idle'` if never requested). */\nexport function imageStatus(src: string): ImageStatus {\n  return cache.get(src)?.status ?? 'idle';\n}\n\n/** Subscribe to load-resolution events (fires after any `src` resolves or\n *  errors). Returns an unsubscribe. */\nexport function subscribeImageReady(cb: () => void): () => void {\n  subscribers.add(cb);\n  return () => {\n    subscribers.delete(cb);\n  };\n}\n\n/** @internal test seam — override the async loader so unit tests don't need\n *  a real DOM image. Not part of the public barrel. */\nexport function __setImageLoaderForTests(fn: Loader): void {\n  loader = fn;\n}\n\n/** @internal test seam — clear cache + subscribers and restore the default\n *  loader. Not part of the public barrel. */\nexport function _resetImageCacheForTests(): void {\n  cache.clear();\n  subscribers.clear();\n  decodedVectors.clear();\n  loader = defaultLoader;\n}\n"],"mappings":"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"}
+{"version":3,"file":"imageCache.js","names":["MAX_VECTOR_RASTER_PIXELS","SHRINK_SLACK","FALLBACK_WIDTH","FALLBACK_HEIGHT","cache","subscribers","decodedVectors","isVectorImageSrc","src","requireDom","decodeImage","img","decodeVector","decoded","rasterizeVector","width","size","height","canvas","c2d","loader","notify","cb","startLoad","entry","bitmap","rasterScaleFor","need","drawnAt","natural","side","maxImageTextureSide","cap","maybeReraster","v","wanted","grow","target","f","old","releaseImageSource","getImageBitmap","imageStatus","releaseImage","retryImage","subscribeImageReady"],"sources":["../../../src/features/images/imageCache.ts"],"sourcesContent":["/**\n * imageCache — the kit's per-`src` image loader + cache.\n *\n * The shape-painter chain (`kit:image` in `NodeShape.ts`) is synchronous, but\n * decoding an image is async. This module bridges the two: `getImageBitmap` is\n * a synchronous read that returns the decoded `ImageBitmap` when ready, and\n * otherwise returns `undefined` and lazily kicks off a de-duped async load.\n * When a load resolves (or errors), every `subscribeImageReady` listener fires\n * — `<SceneCanvas>` subscribes and calls `requestRedraw()`, so the painter\n * re-runs and emits the now-ready bitmap.\n *\n * `src` is any browser-loadable image string: a remote URL, a `blob:` URL, or\n * a `data:image/…;base64,…` URI (the embedded-bytes path). The decoded bitmap\n * lives only here, keyed by `src` — never in node `data` — so `scene.toJSON()`\n * round-trips the (serializable) `src` string untouched.\n */\n\nimport { maxImageTextureSide, releaseImageSource } from 'renderer/cache/GLImageCache';\n\n/** Public shape of an image node's `data`. `src` round-trips through\n *  serialization; the decoded bitmap is held in this cache, not on the node. */\nexport interface ImageNodeData {\n  image: {\n    src: string;\n    opacity?: number;\n    /** The part of the bitmap drawn into the pose rect, as fractions of the\n     *  bitmap's width and height from its top-left. Omitted draws the whole\n     *  bitmap. Fractions, so the data means the same thing before the bitmap\n     *  has decoded and after `src` is swapped for another resolution. */\n    source?: { x: number; y: number; width: number; height: number };\n    /** Mirror the drawn region within the pose rect. The rect does not move. */\n    flipX?: boolean;\n    flipY?: boolean;\n  };\n}\n\n/** Where an image is in its load: never requested, in flight, decoded, or\n *  failed. Renderers paint a placeholder for anything but `'ready'`. */\nexport type ImageStatus = 'idle' | 'loading' | 'ready' | 'error';\n\n/** A size in device pixels. */\nexport interface ImageRasterSize {\n  width: number;\n  height: number;\n}\n\n/** A vector source's raster bookkeeping. `scale` is the current raster's size\n *  over the natural one, always a power of two unless a cap cut it short. */\ninterface VectorRaster {\n  natural: ImageRasterSize;\n  scale: number;\n  pending?: number;\n  failed: Set<number>;\n  /** The scale the last shrink left, until something asks for more. */\n  shrunkTo?: number;\n  /** The largest scale a shrunk raster was asked to grow back to. One raster\n   *  serves every size a source is drawn at, so that request may be a second\n   *  consumer the shrink starved; shrinking below it again would loop. */\n  floor: number;\n}\n\ninterface Entry {\n  status: ImageStatus;\n  bitmap?: ImageBitmap;\n  vector?: VectorRaster;\n}\n\n/** `size` is absent for the first load, which decodes at natural size. */\ntype Loader = (src: string, size?: ImageRasterSize) => Promise<ImageBitmap>;\n\n/** One vector raster may hold at most 64MB of RGBA. */\nconst MAX_VECTOR_RASTER_PIXELS = 4096 * 4096;\n/** A raster is only shrunk once it is this many times larger than needed, so\n *  zooming back and forth across a bucket edge does not re-raster each way. */\nconst SHRINK_SLACK = 4;\n// CSS default object size, as `kit:svg` measures a viewBox-only SVG.\nconst FALLBACK_WIDTH = 300;\nconst FALLBACK_HEIGHT = 150;\n\nconst cache = new Map<string, Entry>();\nconst subscribers = new Set<() => void>();\nconst decodedVectors = new Map<string, Promise<HTMLImageElement>>();\n\n/** True when `src` names SVG — a `data:image/svg+xml` URI, or a URL whose path\n *  ends in `.svg`/`.svgz`. Such sources re-rasterize at the size they are drawn\n *  at; everything else decodes once. A `blob:` URL carries no type and counts\n *  as raster. */\nexport function isVectorImageSrc(src: string): boolean {\n  if (/^data:image\\/svg\\+xml[;,]/i.test(src)) return true;\n  if (/^(data|blob):/i.test(src)) return false;\n  return /\\.svgz?$/i.test(src.replace(/[?#].*$/, ''));\n}\n\nfunction requireDom(): void {\n  if (typeof Image === 'undefined' || typeof createImageBitmap === 'undefined') {\n    throw new Error('weasel imageCache: no DOM image loader in this environment');\n  }\n}\n\nasync function decodeImage(src: string): Promise<HTMLImageElement> {\n  const img = new Image();\n  img.crossOrigin = 'anonymous';\n  img.src = src;\n  await img.decode();\n  return img;\n}\n\nfunction decodeVector(src: string): Promise<HTMLImageElement> {\n  let decoded = decodedVectors.get(src);\n  if (!decoded) {\n    decoded = decodeImage(src);\n    decodedVectors.set(src, decoded);\n    decoded.catch(() => decodedVectors.delete(src));\n  }\n  return decoded;\n}\n\n// `createImageBitmap` rejects SVG blobs and resamples an SVG `<img>` rather\n// than re-drawing it, so vectors go through a canvas `drawImage` at full size.\nasync function rasterizeVector(src: string, size?: ImageRasterSize): Promise<ImageBitmap> {\n  const img = await decodeVector(src);\n  const width = size?.width ?? (img.naturalWidth || FALLBACK_WIDTH);\n  const height = size?.height ?? (img.naturalHeight || FALLBACK_HEIGHT);\n  const canvas: OffscreenCanvas | HTMLCanvasElement = typeof OffscreenCanvas !== 'undefined'\n    ? new OffscreenCanvas(width, height)\n    : Object.assign(document.createElement('canvas'), { width, height });\n  const c2d = canvas.getContext('2d') as CanvasDrawImage | null;\n  if (!c2d) throw new Error('weasel imageCache: no 2D context to rasterize an SVG');\n  c2d.drawImage(img, 0, 0, width, height);\n  return createImageBitmap(canvas);\n}\n\nconst defaultLoader: Loader = async (src, size) => {\n  requireDom();\n  if (isVectorImageSrc(src)) return rasterizeVector(src, size);\n  return createImageBitmap(await decodeImage(src));\n};\n\nlet loader: Loader = defaultLoader;\n\nfunction notify(): void {\n  for (const cb of subscribers) cb();\n}\n\nfunction startLoad(src: string): void {\n  const entry: Entry = { status: 'loading' };\n  cache.set(src, entry);\n  loader(src).then(\n    (bitmap) => {\n      // The entry may have been replaced/cleared mid-flight (reset, etc.);\n      // only commit if this src is still the one we started loading.\n      if (cache.get(src) !== entry) return;\n      cache.set(src, {\n        status: 'ready',\n        bitmap,\n        ...(isVectorImageSrc(src)\n          ? { vector: { natural: { width: bitmap.width, height: bitmap.height }, scale: 1, failed: new Set<number>(), floor: 0 } }\n          : {}),\n      });\n      notify();\n    },\n    () => {\n      // Cache the error so a broken `src` doesn't reload-storm.\n      if (cache.get(src) !== entry) return;\n      cache.set(src, { status: 'error' });\n      notify();\n    },\n  );\n}\n\n/** The raster scale `drawnAt` calls for: the next power of two at or above the\n *  natural-to-drawn ratio, capped by texture size and the pixel ceiling. */\nfunction rasterScaleFor(natural: ImageRasterSize, drawnAt: ImageRasterSize): number | undefined {\n  const need = Math.max(drawnAt.width / natural.width, drawnAt.height / natural.height);\n  if (!(need > 0) || !Number.isFinite(need)) return undefined;\n  const side = maxImageTextureSide();\n  const cap = Math.min(\n    side / natural.width,\n    side / natural.height,\n    Math.sqrt(MAX_VECTOR_RASTER_PIXELS / (natural.width * natural.height)),\n  );\n  return Math.min(2 ** Math.ceil(Math.log2(need)), cap);\n}\n\nfunction maybeReraster(src: string, entry: Entry, v: VectorRaster, drawnAt: ImageRasterSize): void {\n  if (v.pending !== undefined) return;\n  const wanted = rasterScaleFor(v.natural, drawnAt);\n  if (wanted === undefined) return;\n  const grow = wanted > v.scale;\n  if (grow && v.shrunkTo === v.scale) v.floor = Math.max(v.floor, wanted);\n  const target = grow ? wanted : Math.max(wanted, v.floor);\n  if (!grow && target * SHRINK_SLACK > v.scale) return;\n  for (const f of v.failed) if (target === f || (grow && f > v.scale && target >= f)) return;\n\n  v.pending = target;\n  const size = {\n    width: Math.max(1, Math.round(v.natural.width * target)),\n    height: Math.max(1, Math.round(v.natural.height * target)),\n  };\n  loader(src, size).then(\n    (bitmap) => {\n      if (cache.get(src) !== entry) return;\n      v.pending = undefined;\n      const old = entry.bitmap;\n      entry.bitmap = bitmap;\n      v.shrunkTo = grow ? undefined : target;\n      v.scale = target;\n      if (old && old !== bitmap) releaseImageSource(old);\n      notify();\n    },\n    () => {\n      // The previous raster keeps painting; only this scale is given up on.\n      if (cache.get(src) !== entry) return;\n      v.pending = undefined;\n      v.failed.add(target);\n    },\n  );\n}\n\n/** Synchronous read. Returns the decoded bitmap when ready; otherwise returns\n *  `undefined` and lazily starts a de-duped async load for `src`.\n *\n *  `drawnAt` is the size in device pixels the image is about to cover. A\n *  vector source ({@link isVectorImageSrc}) uses it to re-rasterize in\n *  power-of-two steps — the current raster is returned until the sharper one\n *  is ready. Raster sources ignore it. */\nexport function getImageBitmap(src: string, drawnAt?: ImageRasterSize): ImageBitmap | undefined {\n  const entry = cache.get(src);\n  if (!entry) {\n    startLoad(src);\n    return undefined;\n  }\n  if (drawnAt && entry.vector) maybeReraster(src, entry, entry.vector, drawnAt);\n  return entry.bitmap;\n}\n\n/** Current load status for `src` (`'idle'` if never requested). */\nexport function imageStatus(src: string): ImageStatus {\n  return cache.get(src)?.status ?? 'idle';\n}\n\n/**\n * Forget `src`: drop its decoded bitmap, its decoded SVG, and the texture every\n * live renderer holds for it, and abandon a load in flight. The cache is keyed\n * by `src` across every scene on the page, so it cannot know when the last use\n * is gone; whoever does know calls this. A later {@link getImageBitmap} for the\n * same `src` loads it again.\n */\nexport function releaseImage(src: string): void {\n  const entry = cache.get(src);\n  cache.delete(src);\n  decodedVectors.delete(src);\n  if (entry?.bitmap) releaseImageSource(entry.bitmap);\n}\n\n/** Load a `src` whose last load failed again. Does nothing for a `src` in any\n *  other state; one that failed otherwise stays `'error'` for the page's life. */\nexport function retryImage(src: string): void {\n  if (cache.get(src)?.status !== 'error') return;\n  startLoad(src);\n  notify();\n}\n\n/** Subscribe to load-resolution events (fires after any `src` resolves or\n *  errors). Returns an unsubscribe. */\nexport function subscribeImageReady(cb: () => void): () => void {\n  subscribers.add(cb);\n  return () => {\n    subscribers.delete(cb);\n  };\n}\n\n/** @internal test seam — override the async loader so unit tests don't need\n *  a real DOM image. Not part of the public barrel. */\nexport function __setImageLoaderForTests(fn: Loader): void {\n  loader = fn;\n}\n\n/** @internal test seam — clear cache + subscribers and restore the default\n *  loader. Not part of the public barrel. */\nexport function _resetImageCacheForTests(): void {\n  cache.clear();\n  subscribers.clear();\n  decodedVectors.clear();\n  loader = defaultLoader;\n}\n"],"mappings":"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"}

package/dist/features/ingestion/contentHandlers.js

@@ -8,10 +8,13 @@ function r(e) {
 		t >= 0 && n.splice(t, 1);
 	};
 }
-function i() {
-	return [...n].sort((e, t) => (t.priority ?? 0) - (e.priority ?? 0));
+function i(e) {
+	return [...e].sort((e, t) => (t.priority ?? 0) - (e.priority ?? 0));
 }
-function a(e, n) {
+function a() {
+	return i(n);
+}
+function o(e, n) {
 	let { match: r } = e;
 	if (typeof r == "function") try {
 		return r(n);
@@ -20,18 +23,18 @@ function a(e, n) {
 	}
 	return (Array.isArray(r) ? r : [r]).some((e) => t(n.mime, e));
 }
-async function o(t, n) {
-	let r = t, o = [];
-	for (let e of i()) {
-		if (r.length === 0) break;
-		let t = r.filter((t) => a(e, t));
-		t.length !== 0 && (r = r.filter((e) => !t.includes(e)), o.push(Promise.resolve().then(() => e.handle(t, n)).catch((t) => {
+async function s(t, n, r = {}) {
+	let s = t, c = [], l = r.handlers ? i(r.handlers) : a();
+	for (let e of l) {
+		if (s.length === 0) break;
+		let t = s.filter((t) => o(e, t));
+		t.length !== 0 && (s = s.filter((e) => !t.includes(e)), c.push(Promise.resolve().then(() => e.handle(t, n)).catch((t) => {
 			console.warn(`weasel ingest: handler "${e.id}" threw`, t);
 		})));
 	}
-	r.length > 0 && e("ingest", `no content handler matched ${r.length} item(s):`, r.map((e) => e.mime).join(", ")), await Promise.all(o);
+	s.length > 0 && e("ingest", `no content handler matched ${s.length} item(s):`, s.map((e) => e.mime).join(", ")), await Promise.all(c);
 }
 //#endregion
-export { i as getContentHandlers, r as registerContentHandler, o as runIngest };
+export { a as getContentHandlers, r as registerContentHandler, s as runIngest };
 
 //# sourceMappingURL=contentHandlers.js.map

package/dist/features/ingestion/contentHandlers.js.map

@@ -1 +1 @@
-{"version":3,"file":"contentHandlers.js","names":["HANDLERS","registerContentHandler","entry","i","getContentHandlers","b","a","entryMatches","match","item","err","mimeMatchesGlob","g","runIngest","remaining","items","runs","mine","it","ctx","dwarn"],"sources":["../../../src/features/ingestion/contentHandlers.ts"],"sourcesContent":["/**\n * Content-handler registry — the \"registry out\" half of external-content\n * ingestion (spec: docs/superpowers/specs/2026-07-03-content-ingestion-design.md).\n *\n * All three arrival paths (OS drop, clipboard paste, file picker /\n * `CanvasExtensionApi.ingest`) converge here: the `ingest` action calls\n * `runIngest(items, ctx)`, which partitions the items across registered\n * handlers in priority order — the first matching handler takes every item\n * it matches; leftovers continue down the list. Same per-trait registry\n * idiom as `NodeShape` / `NodeRouting`.\n *\n * MIME matching delegates to `mimeMatchesGlob` from `@weasel-js/gestures` —\n * the SAME matcher the binding-level `types` filter uses, so a binding that\n * matched can never disagree with the registry about what a glob means.\n */\nimport { mimeMatchesGlob } from '@weasel-js/gestures';\nimport { dwarn } from '../../debug';\nimport type { Scene } from 'core/scene/types';\nimport type { SelectionApi } from 'core/selection/useSelection';\nimport type { Op } from 'core/ops/types';\nimport type { ClipboardIngestCtx, InsertDep, SvgIngestOptions } from 'interactions/actions/depSchema';\nimport type { ActionDeps } from '@weasel-js/routing';\nimport type { IngestItem } from '@weasel-js/routing';\n\n/** Context handed to every content handler for one ingest event. */\nexport interface IngestCtx {\n  /** World-space arrival point (drop / pointed imperative ingest); `null`\n   *  for paste and point-less calls — handlers pick their own policy\n   *  (the kit image handler centers on the viewport). */\n  point: { x: number; y: number } | null;\n  /** Visible canvas area in world coordinates. */\n  viewportWorldRect(): { x: number; y: number; width: number; height: number };\n  /** The kit insert dep — id/layer/undoable-op supplied; the canonical way\n   *  for a handler to mint a node (`insert.commit(bounds, { kind, ... })`). */\n  insert: InsertDep;\n  /** Raw op commit for handlers that build their own ops. */\n  applyOps(ops: Op[], label?: string): void;\n  scene: Scene<unknown, string, unknown>;\n  selection: SelectionApi;\n  /** Consumer file→src resolver (SceneCanvas `ingestion.resolveSrc`).\n   *  When absent, the kit image handler embeds as a `data:` URI. */\n  resolveSrc?: (file: File) => Promise<string>;\n  /** Kit SVG-handler options (SceneCanvas `ingestion.svg`) — e.g.\n   *  `{ unpack: unpackSvgFiles }` (from `@weasel-js/svg`) to parse SVG files\n   *  into scene nodes. */\n  svg?: SvgIngestOptions;\n  /** Clipboard-paste seam — present when the hosting `SceneCanvas` supplied\n   *  an adapter with `commitPaste`. `reviver` comes from\n   *  `SceneCanvasProps.ingestion.clipboard`. Absent ⇒ the kit weasel-JSON\n   *  handler declines inert (dwarn, nothing ingested) — its matched items\n   *  were already consumed at match time, so they do NOT fall through;\n   *  only match-level misses flow on to other handlers. */\n  clipboard?: ClipboardIngestCtx;\n  /** Set to `true` by the kit weasel-JSON handler when it successfully\n   *  pastes a payload in this event. The `ctx` object is shared across all\n   *  handlers in one `runIngest` call, and higher-priority handlers' `handle`\n   *  bodies run (synchronously) before lower ones — so `kit:svg`'s\n   *  `text/plain` SVG fallback reads this to decline the SVG flavor of a copy\n   *  whose canonical weasel-JSON flavor already ingested (avoids a\n   *  double-paste when both flavors ride one clipboard event). */\n  consumedWeaselPayload?: boolean;\n  /** Full action-deps bag, for consumer handlers that need more. */\n  deps: ActionDeps;\n}\n\n/** A handler for content arriving by paste, drop or file picker. Handlers are\n *  matched by MIME glob or predicate and run highest-priority first; the kit's\n *  own register at a low priority so a consumer's handler wins by default. */\nexport interface ContentHandlerEntry {\n  /** Stable identifier — used for unregistration and debugging\n   *  (`'kit:image'`, `'app:csv'`). */\n  id: string;\n  /** MIME glob(s) (`'image/*'`, `'text/csv'`) or an item predicate. */\n  match: string | string[] | ((item: IngestItem) => boolean);\n  /** Higher runs earlier. Kit defaults register at -100 so any consumer\n   *  handler (default 0) beats them. */\n  priority?: number;\n  handle(items: IngestItem[], ctx: IngestCtx): void | Promise<void>;\n}\n\nconst HANDLERS: ContentHandlerEntry[] = [];\n\n/** Register a content handler. Returns a disposer that removes it. */\nexport function registerContentHandler(entry: ContentHandlerEntry): () => void {\n  HANDLERS.push(entry);\n  return () => {\n    const i = HANDLERS.indexOf(entry);\n    if (i >= 0) HANDLERS.splice(i, 1);\n  };\n}\n\n/** Snapshot of registered handlers, priority-ordered (stable within ties —\n *  registration order; Array.prototype.sort is stable per ES2019). */\nexport function getContentHandlers(): readonly ContentHandlerEntry[] {\n  return [...HANDLERS].sort((a, b) => (b.priority ?? 0) - (a.priority ?? 0));\n}\n\nfunction entryMatches(entry: ContentHandlerEntry, item: IngestItem): boolean {\n  const { match } = entry;\n  if (typeof match === 'function') {\n    try {\n      return match(item);\n    } catch (err) {\n      console.warn(`weasel ingest: handler \"${entry.id}\" match predicate threw`, err);\n      return false;\n    }\n  }\n  const globs = Array.isArray(match) ? match : [match];\n  return globs.some((g) => mimeMatchesGlob(item.mime, g));\n}\n\n/**\n * Route one ingest event's items through the registry. Handlers are queued\n * as microtasks in priority order and their async work then overlaps (each\n * already owns a disjoint item set); a throwing or rejecting handler\n * `console.warn`s and doesn't block the others. The queue order is a real\n * invariant: a higher-priority handler's `handle` body runs before lower\n * ones start, so ctx-flag coordination (e.g. `consumedWeaselPayload`)\n * works — but only while the writing handler stays synchronous up to the\n * write and the reading handler reads before its first `await`.\n * Unmatched items are ignored with a debug-gated `dwarn('ingest', ...)`.\n */\nexport async function runIngest(items: IngestItem[], ctx: IngestCtx): Promise<void> {\n  let remaining = items;\n  const runs: Promise<void>[] = [];\n\n  for (const entry of getContentHandlers()) {\n    if (remaining.length === 0) break;\n    const mine = remaining.filter((it) => entryMatches(entry, it));\n    if (mine.length === 0) continue;\n    remaining = remaining.filter((it) => !mine.includes(it));\n    runs.push(\n      Promise.resolve()\n        .then(() => entry.handle(mine, ctx))\n        .catch((err) => {\n          console.warn(`weasel ingest: handler \"${entry.id}\" threw`, err);\n        }),\n    );\n  }\n\n  if (remaining.length > 0) {\n    dwarn(\n      'ingest',\n      `no content handler matched ${remaining.length} item(s):`,\n      remaining.map((it) => it.mime).join(', '),\n    );\n  }\n\n  await Promise.all(runs);\n}\n\n/** @internal test seam — clear the registry. Not part of the public barrel. */\nexport function _resetContentHandlersForTests(): void {\n  HANDLERS.length = 0;\n}\n"],"mappings":";;;AAgFA,IAAMA,IAAkC,CAAC;AAGzC,SAAgBC,EAAuB,GAAwC;CAE7E,OADAD,EAAS,KAAKE,CAAK,SACN;EACX,IAAMC,IAAIH,EAAS,QAAQE,CAAK;EAChC,AAAIC,KAAK,KAAGH,EAAS,OAAOG,GAAG,CAAC;CAClC;AACF;AAIA,SAAgBC,IAAqD;CACnE,OAAO,CAAC,GAAGJ,CAAQ,CAAC,CAAC,MAAM,GAAG,OAAOK,EAAE,YAAY,MAAMC,EAAE,YAAY,EAAE;AAC3E;AAEA,SAASC,EAAa,GAA4B,GAA2B;CAC3E,IAAM,EAAE,aAAUL;CAClB,IAAI,OAAOM,KAAU,YACnB,IAAI;EACF,OAAOA,EAAMC,CAAI;CACnB,SAASC,GAAK;EAEZ,OADA,QAAQ,KAAK,2BAA2BR,EAAM,GAAG,0BAA0BQ,CAAG,GACvE;CACT;CAGF,QADc,MAAM,QAAQF,CAAK,IAAIA,IAAQ,CAACA,CAAK,EAAA,CACtC,MAAM,MAAMG,EAAgBF,EAAK,MAAMG,CAAC,CAAC;AACxD;AAaA,eAAsBC,EAAU,GAAqB,GAA+B;CAClF,IAAIC,IAAYC,GACVC,IAAwB,CAAC;CAE/B,KAAK,IAAMd,KAASE,EAAmB,GAAG;EACxC,IAAIU,EAAU,WAAW,GAAG;EAC5B,IAAMG,IAAOH,EAAU,QAAQ,MAAOP,EAAaL,GAAOgB,CAAE,CAAC;EAC7D,AAAID,EAAK,WAAW,MACpB,IAAYH,EAAU,QAAQ,MAAO,CAACG,EAAK,SAASC,CAAE,CAAC,GACvDF,EAAK,KACH,QAAQ,QAAQ,CAAC,CACd,WAAWd,EAAM,OAAOe,GAAME,CAAG,CAAC,CAAC,CACnC,OAAO,MAAQ;GACd,QAAQ,KAAK,2BAA2BjB,EAAM,GAAG,UAAUQ,CAAG;EAChE,CAAC,CACL;CACF;CAUA,AARII,EAAU,SAAS,KACrBM,EACE,UACA,8BAA8BN,EAAU,OAAO,YAC/CA,EAAU,KAAK,MAAOI,EAAG,IAAI,CAAC,CAAC,KAAK,IAAI,CAC1C,GAGF,MAAM,QAAQ,IAAIF,CAAI;AACxB"}
+{"version":3,"file":"contentHandlers.js","names":["HANDLERS","registerContentHandler","entry","i","byPriority","handlers","b","a","getContentHandlers","entryMatches","match","item","err","mimeMatchesGlob","g","runIngest","remaining","items","runs","opts","mine","it","ctx","dwarn"],"sources":["../../../src/features/ingestion/contentHandlers.ts"],"sourcesContent":["/**\n * Content-handler registry — the \"registry out\" half of external-content\n * ingestion (spec: docs/superpowers/specs/2026-07-03-content-ingestion-design.md).\n *\n * All three arrival paths (OS drop, clipboard paste, file picker /\n * `CanvasExtensionApi.ingest`) converge here: the `ingest` action calls\n * `runIngest(items, ctx)`, which partitions the items across registered\n * handlers in priority order — the first matching handler takes every item\n * it matches; leftovers continue down the list. Same per-trait registry\n * idiom as `NodeShape` / `NodeRouting`. The `clipboard.pasteEvent` action\n * calls it too, with `RunIngestOptions.handlers` naming the one handler it\n * accepts.\n *\n * MIME matching delegates to `mimeMatchesGlob` from `@weasel-js/gestures` —\n * the SAME matcher the binding-level `types` filter uses, so a binding that\n * matched can never disagree with the registry about what a glob means.\n */\nimport { mimeMatchesGlob } from '@weasel-js/gestures';\nimport { dwarn } from '../../debug';\nimport type { Scene } from 'core/scene/types';\nimport type { SelectionApi } from 'core/selection/useSelection';\nimport type { Op } from 'core/ops/types';\nimport type { ClipboardIngestCtx, InsertDep, SvgIngestOptions } from 'interactions/actions/depSchema';\nimport type { ActionDeps } from '@weasel-js/routing';\nimport type { IngestItem } from '@weasel-js/routing';\n\n/** Context handed to every content handler for one ingest event. */\nexport interface IngestCtx {\n  /** World-space arrival point (drop / pointed imperative ingest); `null`\n   *  for paste and point-less calls — handlers pick their own policy\n   *  (the kit image handler centers on the viewport). */\n  point: { x: number; y: number } | null;\n  /** Visible canvas area in world coordinates. */\n  viewportWorldRect(): { x: number; y: number; width: number; height: number };\n  /** The kit insert dep — id/layer/undoable-op supplied; the canonical way\n   *  for a handler to mint a node (`insert.commit(bounds, { kind, ... })`). */\n  insert: InsertDep;\n  /** Raw op commit for handlers that build their own ops. */\n  applyOps(ops: Op[], label?: string): void;\n  scene: Scene<unknown, string, unknown>;\n  selection: SelectionApi;\n  /** Consumer file→src resolver (SceneCanvas `ingestion.resolveSrc`).\n   *  When absent, the kit image handler embeds as a `data:` URI. */\n  resolveSrc?: (file: File) => Promise<string>;\n  /** Kit SVG-handler options (SceneCanvas `ingestion.svg`) — e.g.\n   *  `{ unpack: unpackSvgFiles }` (from `@weasel-js/svg`) to parse SVG files\n   *  into scene nodes. */\n  svg?: SvgIngestOptions;\n  /** Clipboard-paste seam — present when the hosting `SceneCanvas` supplied\n   *  an adapter with `commitPaste`. `reviver` comes from\n   *  `SceneCanvasProps.ingestion.clipboard`. Absent ⇒ the kit weasel-JSON\n   *  handler declines inert (dwarn, nothing ingested) — its matched items\n   *  were already consumed at match time, so they do NOT fall through;\n   *  only match-level misses flow on to other handlers. */\n  clipboard?: ClipboardIngestCtx;\n  /** Set to `true` by the kit weasel-JSON handler when it successfully\n   *  pastes a payload in this event. The `ctx` object is shared across all\n   *  handlers in one `runIngest` call, and higher-priority handlers' `handle`\n   *  bodies run (synchronously) before lower ones — so `kit:svg`'s\n   *  `text/plain` SVG fallback reads this to decline the SVG flavor of a copy\n   *  whose canonical weasel-JSON flavor already ingested (avoids a\n   *  double-paste when both flavors ride one clipboard event). */\n  consumedWeaselPayload?: boolean;\n  /** Full action-deps bag, for consumer handlers that need more. */\n  deps: ActionDeps;\n}\n\n/** A handler for content arriving by paste, drop or file picker. Handlers are\n *  matched by MIME glob or predicate and run highest-priority first; the kit's\n *  own register at a low priority so a consumer's handler wins by default. */\nexport interface ContentHandlerEntry {\n  /** Stable identifier — used for unregistration and debugging\n   *  (`'kit:image'`, `'app:csv'`). */\n  id: string;\n  /** MIME glob(s) (`'image/*'`, `'text/csv'`) or an item predicate. */\n  match: string | string[] | ((item: IngestItem) => boolean);\n  /** Higher runs earlier. Kit defaults register at -100 so any consumer\n   *  handler (default 0) beats them. */\n  priority?: number;\n  handle(items: IngestItem[], ctx: IngestCtx): void | Promise<void>;\n}\n\nconst HANDLERS: ContentHandlerEntry[] = [];\n\n/** Register a content handler. Returns a disposer that removes it. */\nexport function registerContentHandler(entry: ContentHandlerEntry): () => void {\n  HANDLERS.push(entry);\n  return () => {\n    const i = HANDLERS.indexOf(entry);\n    if (i >= 0) HANDLERS.splice(i, 1);\n  };\n}\n\nfunction byPriority(handlers: readonly ContentHandlerEntry[]): ContentHandlerEntry[] {\n  return [...handlers].sort((a, b) => (b.priority ?? 0) - (a.priority ?? 0));\n}\n\n/** Snapshot of registered handlers, priority-ordered (stable within ties —\n *  registration order; Array.prototype.sort is stable per ES2019). */\nexport function getContentHandlers(): readonly ContentHandlerEntry[] {\n  return byPriority(HANDLERS);\n}\n\n/** Options for {@link runIngest}. */\nexport interface RunIngestOptions {\n  /**\n   * The handlers to route through, in place of the registry. The registry is\n   * shared by every canvas on the page, so this is how one arrival path\n   * accepts a narrower set of content than the page has handlers for: the\n   * `clipboard.pasteEvent` action passes the kit's node-payload handler alone.\n   * Ordered by `priority` like registered handlers; an item none of them\n   * matches is ignored.\n   */\n  handlers?: readonly ContentHandlerEntry[];\n}\n\nfunction entryMatches(entry: ContentHandlerEntry, item: IngestItem): boolean {\n  const { match } = entry;\n  if (typeof match === 'function') {\n    try {\n      return match(item);\n    } catch (err) {\n      console.warn(`weasel ingest: handler \"${entry.id}\" match predicate threw`, err);\n      return false;\n    }\n  }\n  const globs = Array.isArray(match) ? match : [match];\n  return globs.some((g) => mimeMatchesGlob(item.mime, g));\n}\n\n/**\n * Route one ingest event's items through the registry. Handlers are queued\n * as microtasks in priority order and their async work then overlaps (each\n * already owns a disjoint item set); a throwing or rejecting handler\n * `console.warn`s and doesn't block the others. The queue order is a real\n * invariant: a higher-priority handler's `handle` body runs before lower\n * ones start, so ctx-flag coordination (e.g. `consumedWeaselPayload`)\n * works — but only while the writing handler stays synchronous up to the\n * write and the reading handler reads before its first `await`.\n * Unmatched items are ignored with a debug-gated `dwarn('ingest', ...)`.\n */\nexport async function runIngest(\n  items: IngestItem[],\n  ctx: IngestCtx,\n  opts: RunIngestOptions = {},\n): Promise<void> {\n  let remaining = items;\n  const runs: Promise<void>[] = [];\n  const handlers = opts.handlers ? byPriority(opts.handlers) : getContentHandlers();\n\n  for (const entry of handlers) {\n    if (remaining.length === 0) break;\n    const mine = remaining.filter((it) => entryMatches(entry, it));\n    if (mine.length === 0) continue;\n    remaining = remaining.filter((it) => !mine.includes(it));\n    runs.push(\n      Promise.resolve()\n        .then(() => entry.handle(mine, ctx))\n        .catch((err) => {\n          console.warn(`weasel ingest: handler \"${entry.id}\" threw`, err);\n        }),\n    );\n  }\n\n  if (remaining.length > 0) {\n    dwarn(\n      'ingest',\n      `no content handler matched ${remaining.length} item(s):`,\n      remaining.map((it) => it.mime).join(', '),\n    );\n  }\n\n  await Promise.all(runs);\n}\n\n/** @internal test seam — clear the registry. Not part of the public barrel. */\nexport function _resetContentHandlersForTests(): void {\n  HANDLERS.length = 0;\n}\n"],"mappings":";;;AAkFA,IAAMA,IAAkC,CAAC;AAGzC,SAAgBC,EAAuB,GAAwC;CAE7E,OADAD,EAAS,KAAKE,CAAK,SACN;EACX,IAAMC,IAAIH,EAAS,QAAQE,CAAK;EAChC,AAAIC,KAAK,KAAGH,EAAS,OAAOG,GAAG,CAAC;CAClC;AACF;AAEA,SAASC,EAAW,GAAiE;CACnF,OAAO,CAAC,GAAGC,CAAQ,CAAC,CAAC,MAAM,GAAG,OAAOC,EAAE,YAAY,MAAMC,EAAE,YAAY,EAAE;AAC3E;AAIA,SAAgBC,IAAqD;CACnE,OAAOJ,EAAWJ,CAAQ;AAC5B;AAeA,SAASS,EAAa,GAA4B,GAA2B;CAC3E,IAAM,EAAE,aAAUP;CAClB,IAAI,OAAOQ,KAAU,YACnB,IAAI;EACF,OAAOA,EAAMC,CAAI;CACnB,SAASC,GAAK;EAEZ,OADA,QAAQ,KAAK,2BAA2BV,EAAM,GAAG,0BAA0BU,CAAG,GACvE;CACT;CAGF,QADc,MAAM,QAAQF,CAAK,IAAIA,IAAQ,CAACA,CAAK,EAAA,CACtC,MAAM,MAAMG,EAAgBF,EAAK,MAAMG,CAAC,CAAC;AACxD;AAaA,eAAsBC,EACpB,GACA,GACA,IAAyB,CAAC,GACX;CACf,IAAIC,IAAYC,GACVC,IAAwB,CAAC,GACzBb,IAAWc,EAAK,WAAWf,EAAWe,EAAK,QAAQ,IAAIX,EAAmB;CAEhF,KAAK,IAAMN,KAASG,GAAU;EAC5B,IAAIW,EAAU,WAAW,GAAG;EAC5B,IAAMI,IAAOJ,EAAU,QAAQ,MAAOP,EAAaP,GAAOmB,CAAE,CAAC;EAC7D,AAAID,EAAK,WAAW,MACpB,IAAYJ,EAAU,QAAQ,MAAO,CAACI,EAAK,SAASC,CAAE,CAAC,GACvDH,EAAK,KACH,QAAQ,QAAQ,CAAC,CACd,WAAWhB,EAAM,OAAOkB,GAAME,CAAG,CAAC,CAAC,CACnC,OAAO,MAAQ;GACd,QAAQ,KAAK,2BAA2BpB,EAAM,GAAG,UAAUU,CAAG;EAChE,CAAC,CACL;CACF;CAUA,AARII,EAAU,SAAS,KACrBO,EACE,UACA,8BAA8BP,EAAU,OAAO,YAC/CA,EAAU,KAAK,MAAOK,EAAG,IAAI,CAAC,CAAC,KAAK,IAAI,CAC1C,GAGF,MAAM,QAAQ,IAAIH,CAAI;AACxB"}

package/dist/features/ingestion/index.js

@@ -1,7 +1,7 @@
-import { registerContentHandler as e } from "./contentHandlers.js";
 import "./imageHandler.js";
 import "./svgHandler.js";
 import "./weaselJsonHandler.js";
+import { registerContentHandler as e } from "./contentHandlers.js";
 import { acquireKitContentHandlers as t } from "./registerKitHandlers.js";
 import { openFilePicker as n } from "./openFilePicker.js";
 import { itemsFromFiles as r } from "@weasel-js/routing";

package/dist/features/ingestion/registerKitHandlers.js

@@ -1,16 +1,16 @@
-import { registerContentHandler as e } from "./contentHandlers.js";
-import { kitImageHandler as t } from "./imageHandler.js";
-import { kitSvgHandler as n } from "./svgHandler.js";
-import { kitWeaselJsonHandler as r } from "./weaselJsonHandler.js";
+import { kitImageHandler as e } from "./imageHandler.js";
+import { kitSvgHandler as t } from "./svgHandler.js";
+import { kitWeaselJsonHandler as n } from "./weaselJsonHandler.js";
+import { registerContentHandler as r } from "./contentHandlers.js";
 //#region src/features/ingestion/registerKitHandlers.ts
 var i = 0, a = null;
 function o() {
 	if (i++, i === 1) {
 		let i = [
+			e,
 			t,
-			n,
-			r
-		].map(e);
+			n
+		].map(r);
 		a = () => {
 			for (let e of i) e();
 		};

package/dist/features/ingestion/weaselJsonHandler.js

@@ -1,36 +1,39 @@
 import { dwarn as e } from "../../debug/flag.js";
-import { sniffSvgText as t } from "./svgHandler.js";
-import { materializePaste as n } from "../../interactions/actions/clipboard/materializePaste.js";
-import { WEASEL_CLIPBOARD_MIME as r, WEASEL_CLIPBOARD_MIME_WEB as i, extractWeaselClipboardFromSvg as a, parseWeaselClipboardText as o, sniffWeaselClipboardText as s } from "../../interactions/actions/clipboard/wireFormat.js";
+import { materializePaste as t } from "../../interactions/actions/clipboard/materializePaste.js";
+import { WEASEL_CLIPBOARD_MIME as n, WEASEL_CLIPBOARD_MIME_WEB as r, extractWeaselClipboardFromSvg as i, parseWeaselClipboardText as a, sniffWeaselClipboardText as o } from "../../interactions/actions/clipboard/wireFormat.js";
+import { sniffSvgText as s } from "./svgHandler.js";
 //#region src/features/ingestion/weaselJsonHandler.ts
-var c = (e) => e.includes("\"weaselClipboard\"") && t(e) && a(e) !== null, l = {
+var c = (e) => e.includes("\"weaselClipboard\"") && s(e) && i(e) !== null, l = {
 	id: "kit:weasel-json",
 	priority: -50,
-	match: (e) => e.kind === "string" && (e.mime === r || e.mime === i || e.mime === "text/plain" && (s(e.text) || c(e.text))),
-	handle(r, i) {
-		let s = i.clipboard;
-		if (!s) {
+	match: (e) => e.kind === "string" && (e.mime === n || e.mime === r || e.mime === "text/plain" && (o(e.text) || c(e.text))),
+	handle(n, r) {
+		let o = r.clipboard;
+		if (!o) {
 			e("clipboard", "weasel payload arrived but ctx.clipboard is not wired (ingestion.clipboard disabled or absent) — declining");
 			return;
 		}
-		if (!s.adapter.commitPaste) {
+		if (!o.adapter.commitPaste) {
 			e("clipboard", "weasel payload arrived but the clipboard adapter lacks commitPaste — declining");
 			return;
 		}
-		let c = r.find((e) => e.kind === "string");
+		let c = n.find((e) => e.kind === "string");
 		if (!c || c.kind !== "string") return;
-		let l = t(c.text) ? a(c.text) : c.text;
+		let l = s(c.text) ? i(c.text) : c.text;
 		if (l === null) {
 			e("clipboard", "weasel payload vanished from the SVG metadata between match and handle — declining");
 			return;
 		}
-		let u = o(l, s.reviver);
+		let u = a(l, o.reviver);
 		if (u === null) {
 			e("clipboard", "weasel payload unusable — declining (see prior warning if the parse threw)");
 			return;
 		}
-		let d = { items: u }, f = n(s.adapter, d, { currentSelection: i.selection.get() });
-		f && (i.applyOps(f.ops, "Paste"), i.selection.set(f.newIds), i.consumedWeaselPayload = !0);
+		let d = { items: u }, f = t(o.adapter, d, {
+			currentSelection: r.selection.get(),
+			onOmitted: o.onOmitted
+		});
+		f && (r.applyOps(f.ops, "Paste"), r.selection.set(f.newIds), r.consumedWeaselPayload = !0);
 	}
 };
 //#endregion

package/dist/features/ingestion/weaselJsonHandler.js.map

@@ -1 +1 @@
-{"version":3,"file":"weaselJsonHandler.js","names":["isMetadataBearingSvg","text","sniffSvgText","extractWeaselClipboardFromSvg","kitWeaselJsonHandler","item","WEASEL_CLIPBOARD_MIME","WEASEL_CLIPBOARD_MIME_WEB","sniffWeaselClipboardText","clipboard","ctx","items","it","nodes","parseWeaselClipboardText","snapshot","result","materializePaste"],"sources":["../../../src/features/ingestion/weaselJsonHandler.ts"],"sourcesContent":["/**\n * The kit's weasel-JSON clipboard content handler.\n *\n * Consumes `application/x-weasel-clipboard+json` payloads (either MIME\n * spelling — Chromium's async-clipboard API round-trips custom formats with\n * a `web ` prefix — plus `text/plain` that sniffs as the wire format, plus\n * `text/plain` SVG carrying the wire format embedded in a `<metadata>`\n * element: Chromium's DOM paste event exposes ONLY `text/plain`, and draw\n * puts metadata-bearing SVG there so draw→draw paste keeps full JSON\n * fidelity) and replays them as a paste through the hosting canvas's\n * adapter: parse →\n * `commitPaste` (fresh ids, cascade offset) → one undoable batch of\n * `InsertOp`s + a selection op. Mirrors `useClipboardOps.paste`'s op\n * construction exactly so OS-arriving pastes and in-memory pastes are\n * indistinguishable in history.\n *\n * Declines (leaving the event un-acted-on) when `ctx.clipboard` is absent\n * (consumer disabled it, or the adapter lacks `commitPaste`) or the payload\n * fails to parse. Note `runIngest` consumes items at *match* time, so\n * \"leave it for other handlers\" is the sniff's job: non-weasel `text/plain`\n * never matches and flows on to lower-priority handlers untouched.\n */\nimport type { NodeId } from 'core/scene/types';\nimport type { ClipboardSnapshot } from 'core/adapters/types';\nimport { materializePaste } from 'interactions/actions/clipboard/materializePaste';\nimport {\n  WEASEL_CLIPBOARD_MIME,\n  WEASEL_CLIPBOARD_MIME_WEB,\n  sniffWeaselClipboardText,\n  parseWeaselClipboardText,\n  extractWeaselClipboardFromSvg,\n} from 'interactions/actions/clipboard/wireFormat';\nimport { dwarn } from '../../debug';\nimport type { ContentHandlerEntry, IngestCtx } from './contentHandlers';\n// Direct module import (not the ./index barrel) to avoid a cycle — the\n// barrel re-exports this handler.\nimport { sniffSvgText } from './svgHandler';\n\n/** text/plain SVG whose `<metadata>` carries a verified weasel payload —\n *  the draw→draw DOM-paste flavor (Chromium exposes only text/plain there).\n *  The `\"weaselClipboard\"` substring guard keeps match cheap on arbitrary\n *  external SVG pastes before the extraction regex runs. */\nconst isMetadataBearingSvg = (text: string): boolean =>\n  text.includes('\"weaselClipboard\"')\n  && sniffSvgText(text)\n  && extractWeaselClipboardFromSvg(text) !== null;\n\nexport const kitWeaselJsonHandler: ContentHandlerEntry = {\n  id: 'kit:weasel-json',\n  // Above the other kit handlers (-100/-90) so weasel payloads never fall\n  // through to the SVG/text paths; still below consumer handlers (default 0).\n  priority: -50,\n  match: (item) =>\n    item.kind === 'string'\n    && (item.mime === WEASEL_CLIPBOARD_MIME\n      || item.mime === WEASEL_CLIPBOARD_MIME_WEB\n      || (item.mime === 'text/plain'\n        && (sniffWeaselClipboardText(item.text) || isMetadataBearingSvg(item.text)))),\n  handle(items, ctx: IngestCtx) {\n    const clipboard = ctx.clipboard;\n    if (!clipboard) {\n      dwarn('clipboard', 'weasel payload arrived but ctx.clipboard is not wired (ingestion.clipboard disabled or absent) — declining');\n      return;\n    }\n    if (!clipboard.adapter.commitPaste) {\n      dwarn('clipboard', 'weasel payload arrived but the clipboard adapter lacks commitPaste — declining');\n      return;\n    }\n    const item = items.find((it) => it.kind === 'string');\n    if (!item || item.kind !== 'string') return;\n    // The metadata-bearing-SVG flavor: unwrap the embedded payload before\n    // parsing. Extraction was already verified at match time, so a null here\n    // is the same inert-decline class as a corrupt custom-MIME payload.\n    const text = sniffSvgText(item.text)\n      ? extractWeaselClipboardFromSvg(item.text)\n      : item.text;\n    if (text === null) {\n      dwarn('clipboard', 'weasel payload vanished from the SVG metadata between match and handle — declining');\n      return;\n    }\n    const nodes = parseWeaselClipboardText(text, clipboard.reviver);\n    if (nodes === null) {\n      dwarn('clipboard', 'weasel payload unusable — declining (see prior warning if the parse threw)');\n      return;\n    }\n    // Shared paste recipe (offset → commitPaste → InsertOps + selection op)\n    // so OS-arriving pastes match useClipboardOps.paste exactly. `ctx.point`\n    // is null for paste, so no dropPoint is threaded — the cascade offset is\n    // the placement.\n    const snapshot: ClipboardSnapshot = { items: nodes };\n    const result = materializePaste(clipboard.adapter, snapshot, {\n      currentSelection: ctx.selection.get(),\n    });\n    if (!result) return;\n    ctx.applyOps(result.ops, 'Paste');\n    ctx.selection.set(result.newIds as NodeId[]);\n    // Flag the shared event ctx so kit:svg's text/plain fallback declines the\n    // SVG flavor of this same copy (draw writes weasel-JSON + SVG together).\n    // WARNING: do not add an `await` earlier in this handle — the flag must\n    // be written before lower-priority handlers' microtasks run.\n    ctx.consumedWeaselPayload = true;\n  },\n};\n"],"mappings":";;;;;AA0CA,IAAMA,KAAwB,MAC5BC,EAAK,SAAS,qBAAmB,KAC9BC,EAAaD,CAAI,KACjBE,EAA8BF,CAAI,MAAM,MAEhCG,IAA4C;CACvD,IAAI;CAGJ,UAAU;CACV,QAAQ,MACNC,EAAK,SAAS,aACVA,EAAK,SAASC,KACbD,EAAK,SAASE,KACbF,EAAK,SAAS,iBACZG,EAAyBH,EAAK,IAAI,KAAKL,EAAqBK,EAAK,IAAI;CAC/E,OAAO,GAAO,GAAgB;EAC5B,IAAMI,IAAYC,EAAI;EACtB,IAAI,CAACD,GAAW;GACd,EAAM,aAAa,4GAA4G;GAC/H;EACF;EACA,IAAI,CAACA,EAAU,QAAQ,aAAa;GAClC,EAAM,aAAa,gFAAgF;GACnG;EACF;EACA,IAAMJ,IAAOM,EAAM,MAAM,MAAOC,EAAG,SAAS,QAAQ;EACpD,IAAI,CAACP,KAAQA,EAAK,SAAS,UAAU;EAIrC,IAAMJ,IAAOC,EAAaG,EAAK,IAAI,IAC/BF,EAA8BE,EAAK,IAAI,IACvCA,EAAK;EACT,IAAIJ,MAAS,MAAM;GACjB,EAAM,aAAa,oFAAoF;GACvG;EACF;EACA,IAAMY,IAAQC,EAAyBb,GAAMQ,EAAU,OAAO;EAC9D,IAAII,MAAU,MAAM;GAClB,EAAM,aAAa,4EAA4E;GAC/F;EACF;EAKA,IAAME,IAA8B,EAAE,OAAOF,EAAM,GAC7CG,IAASC,EAAiBR,EAAU,SAASM,GAAU,EAC3D,kBAAkBL,EAAI,UAAU,IAAI,EACtC,CAAC;EACD,AAAKM,MACLN,EAAI,SAASM,EAAO,KAAK,OAAO,GAChCN,EAAI,UAAU,IAAIM,EAAO,MAAkB,GAK3C,EAAI,wBAAwB;CAC9B;AACF"}
+{"version":3,"file":"weaselJsonHandler.js","names":["isMetadataBearingSvg","text","sniffSvgText","extractWeaselClipboardFromSvg","kitWeaselJsonHandler","item","WEASEL_CLIPBOARD_MIME","WEASEL_CLIPBOARD_MIME_WEB","sniffWeaselClipboardText","clipboard","ctx","items","it","nodes","parseWeaselClipboardText","snapshot","result","materializePaste"],"sources":["../../../src/features/ingestion/weaselJsonHandler.ts"],"sourcesContent":["/**\n * The kit's weasel-JSON clipboard content handler.\n *\n * Consumes `application/x-weasel-clipboard+json` payloads (either MIME\n * spelling — Chromium's async-clipboard API round-trips custom formats with\n * a `web ` prefix — plus `text/plain` that sniffs as the wire format, plus\n * `text/plain` SVG carrying the wire format embedded in a `<metadata>`\n * element: Chromium's DOM paste event exposes ONLY `text/plain`, and draw\n * puts metadata-bearing SVG there so draw→draw paste keeps full JSON\n * fidelity) and replays them as a paste through the hosting canvas's\n * adapter: parse →\n * `commitPaste` (fresh ids, cascade offset) → one undoable batch of\n * `InsertOp`s + a selection op. Mirrors `useClipboardOps.paste`'s op\n * construction exactly so OS-arriving pastes and in-memory pastes are\n * indistinguishable in history.\n *\n * Declines (leaving the event un-acted-on) when `ctx.clipboard` is absent\n * (consumer disabled it, or the adapter lacks `commitPaste`) or the payload\n * fails to parse. Note `runIngest` consumes items at *match* time, so\n * \"leave it for other handlers\" is the sniff's job: non-weasel `text/plain`\n * never matches and flows on to lower-priority handlers untouched.\n */\nimport type { NodeId } from 'core/scene/types';\nimport type { ClipboardSnapshot } from 'core/adapters/types';\nimport { materializePaste } from 'interactions/actions/clipboard/materializePaste';\nimport {\n  WEASEL_CLIPBOARD_MIME,\n  WEASEL_CLIPBOARD_MIME_WEB,\n  sniffWeaselClipboardText,\n  parseWeaselClipboardText,\n  extractWeaselClipboardFromSvg,\n} from 'interactions/actions/clipboard/wireFormat';\nimport { dwarn } from '../../debug';\nimport type { ContentHandlerEntry, IngestCtx } from './contentHandlers';\n// Direct module import (not the ./index barrel) to avoid a cycle — the\n// barrel re-exports this handler.\nimport { sniffSvgText } from './svgHandler';\n\n/** text/plain SVG whose `<metadata>` carries a verified weasel payload —\n *  the draw→draw DOM-paste flavor (Chromium exposes only text/plain there).\n *  The `\"weaselClipboard\"` substring guard keeps match cheap on arbitrary\n *  external SVG pastes before the extraction regex runs. */\nconst isMetadataBearingSvg = (text: string): boolean =>\n  text.includes('\"weaselClipboard\"')\n  && sniffSvgText(text)\n  && extractWeaselClipboardFromSvg(text) !== null;\n\nexport const kitWeaselJsonHandler: ContentHandlerEntry = {\n  id: 'kit:weasel-json',\n  // Above the other kit handlers (-100/-90) so weasel payloads never fall\n  // through to the SVG/text paths; still below consumer handlers (default 0).\n  priority: -50,\n  match: (item) =>\n    item.kind === 'string'\n    && (item.mime === WEASEL_CLIPBOARD_MIME\n      || item.mime === WEASEL_CLIPBOARD_MIME_WEB\n      || (item.mime === 'text/plain'\n        && (sniffWeaselClipboardText(item.text) || isMetadataBearingSvg(item.text)))),\n  handle(items, ctx: IngestCtx) {\n    const clipboard = ctx.clipboard;\n    if (!clipboard) {\n      dwarn('clipboard', 'weasel payload arrived but ctx.clipboard is not wired (ingestion.clipboard disabled or absent) — declining');\n      return;\n    }\n    if (!clipboard.adapter.commitPaste) {\n      dwarn('clipboard', 'weasel payload arrived but the clipboard adapter lacks commitPaste — declining');\n      return;\n    }\n    const item = items.find((it) => it.kind === 'string');\n    if (!item || item.kind !== 'string') return;\n    // The metadata-bearing-SVG flavor: unwrap the embedded payload before\n    // parsing. Extraction was already verified at match time, so a null here\n    // is the same inert-decline class as a corrupt custom-MIME payload.\n    const text = sniffSvgText(item.text)\n      ? extractWeaselClipboardFromSvg(item.text)\n      : item.text;\n    if (text === null) {\n      dwarn('clipboard', 'weasel payload vanished from the SVG metadata between match and handle — declining');\n      return;\n    }\n    const nodes = parseWeaselClipboardText(text, clipboard.reviver);\n    if (nodes === null) {\n      dwarn('clipboard', 'weasel payload unusable — declining (see prior warning if the parse threw)');\n      return;\n    }\n    // Shared paste recipe (offset → commitPaste → InsertOps + selection op)\n    // so OS-arriving pastes match useClipboardOps.paste exactly. `ctx.point`\n    // is null for paste, so no dropPoint is threaded — the cascade offset is\n    // the placement.\n    const snapshot: ClipboardSnapshot = { items: nodes };\n    const result = materializePaste(clipboard.adapter, snapshot, {\n      currentSelection: ctx.selection.get(),\n      onOmitted: clipboard.onOmitted,\n    });\n    if (!result) return;\n    ctx.applyOps(result.ops, 'Paste');\n    ctx.selection.set(result.newIds as NodeId[]);\n    // Flag the shared event ctx so kit:svg's text/plain fallback declines the\n    // SVG flavor of this same copy (draw writes weasel-JSON + SVG together).\n    // WARNING: do not add an `await` earlier in this handle — the flag must\n    // be written before lower-priority handlers' microtasks run.\n    ctx.consumedWeaselPayload = true;\n  },\n};\n"],"mappings":";;;;;AA0CA,IAAMA,KAAwB,MAC5BC,EAAK,SAAS,qBAAmB,KAC9BC,EAAaD,CAAI,KACjBE,EAA8BF,CAAI,MAAM,MAEhCG,IAA4C;CACvD,IAAI;CAGJ,UAAU;CACV,QAAQ,MACNC,EAAK,SAAS,aACVA,EAAK,SAASC,KACbD,EAAK,SAASE,KACbF,EAAK,SAAS,iBACZG,EAAyBH,EAAK,IAAI,KAAKL,EAAqBK,EAAK,IAAI;CAC/E,OAAO,GAAO,GAAgB;EAC5B,IAAMI,IAAYC,EAAI;EACtB,IAAI,CAACD,GAAW;GACd,EAAM,aAAa,4GAA4G;GAC/H;EACF;EACA,IAAI,CAACA,EAAU,QAAQ,aAAa;GAClC,EAAM,aAAa,gFAAgF;GACnG;EACF;EACA,IAAMJ,IAAOM,EAAM,MAAM,MAAOC,EAAG,SAAS,QAAQ;EACpD,IAAI,CAACP,KAAQA,EAAK,SAAS,UAAU;EAIrC,IAAMJ,IAAOC,EAAaG,EAAK,IAAI,IAC/BF,EAA8BE,EAAK,IAAI,IACvCA,EAAK;EACT,IAAIJ,MAAS,MAAM;GACjB,EAAM,aAAa,oFAAoF;GACvG;EACF;EACA,IAAMY,IAAQC,EAAyBb,GAAMQ,EAAU,OAAO;EAC9D,IAAII,MAAU,MAAM;GAClB,EAAM,aAAa,4EAA4E;GAC/F;EACF;EAKA,IAAME,IAA8B,EAAE,OAAOF,EAAM,GAC7CG,IAASC,EAAiBR,EAAU,SAASM,GAAU;GAC3D,kBAAkBL,EAAI,UAAU,IAAI;GACpC,WAAWD,EAAU;EACvB,CAAC;EACD,AAAKO,MACLN,EAAI,SAASM,EAAO,KAAK,OAAO,GAChCN,EAAI,UAAU,IAAIM,EAAO,MAAkB,GAK3C,EAAI,wBAAwB;CAC9B;AACF"}