@weasel-js/core 1.10.0 → 1.11.0

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

@@ -1,32 +1,58 @@
-import { useCallback as e, useEffect as t, useMemo as n, useRef as r } from "react";
-import { useLatest as i } from "@weasel-js/react";
+import { useCallback, useEffect, useMemo, useRef } from "react";
+import { useLatest } from "@weasel-js/react";
+
 //#region src/features/chrome-caps/useHoverTracking.ts
-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) => {
-			c.current = l.current(e.clientX, e.clientY)?.id ?? null;
-		}, n = () => {
-			c.current = null;
+/** Last-hovered NodeId for chrome-caps rules. */
+/** Track which node the pointer is over. Returns a getter rather than state,
+*  so a pointer move does not re-render the component. Cleared on
+*  `pointerleave`. */
+function useHoverTracking(args) {
+	const { nodeAtClientPoint, enabled = true } = args;
+	const hoverRef = useRef(null);
+	const nodeAtRef = useLatest(nodeAtClientPoint);
+	const elementRef = useRef(null);
+	const enabledRef = useRef(enabled);
+	const detachRef = useRef(null);
+	const sync = useCallback(() => {
+		detachRef.current?.();
+		detachRef.current = null;
+		hoverRef.current = null;
+		const el = elementRef.current;
+		if (!el || !enabledRef.current) return;
+		const onMove = (e) => {
+			hoverRef.current = nodeAtRef.current(e.clientX, e.clientY)?.id ?? null;
+		};
+		const onLeave = () => {
+			hoverRef.current = null;
+		};
+		el.addEventListener("pointermove", onMove);
+		el.addEventListener("pointerleave", onLeave);
+		detachRef.current = () => {
+			el.removeEventListener("pointermove", onMove);
+			el.removeEventListener("pointerleave", onLeave);
 		};
-		e.addEventListener("pointermove", t), e.addEventListener("pointerleave", n), f.current = () => {
-			e.removeEventListener("pointermove", t), e.removeEventListener("pointerleave", n);
+	}, [nodeAtRef]);
+	useEffect(() => {
+		enabledRef.current = enabled;
+		sync();
+		return () => {
+			detachRef.current?.();
+			detachRef.current = null;
+			hoverRef.current = null;
 		};
-	}, [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]);
+	}, [enabled, sync]);
+	const canvasRef = useCallback((element) => {
+		if (elementRef.current === element) return;
+		elementRef.current = element;
+		sync();
+	}, [sync]);
+	const getHover = useCallback(() => hoverRef.current, []);
+	return useMemo(() => ({
+		getHover,
+		canvasRef
+	}), [getHover, canvasRef]);
 }
-//#endregion
-export { a as useHoverTracking };
 
+//#endregion
+export { 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","elementRef","enabledRef","enabled","detachRef","sync","useCallback","el","onMove","onLeave","canvasRef","element","getHover","useMemo"],"sources":["../../../src/features/chrome-caps/useHoverTracking.ts"],"sourcesContent":["/** Last-hovered NodeId for chrome-caps rules. */\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. */\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 a pointer move does not re-render the component. Cleared on\n *  `pointerleave`. */\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":";;;AAyBA,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"}
+{"version":3,"file":"useHoverTracking.js","names":[],"sources":["../../../src/features/chrome-caps/useHoverTracking.ts"],"sourcesContent":["/** Last-hovered NodeId for chrome-caps rules. */\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. */\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 a pointer move does not re-render the component. Cleared on\n *  `pointerleave`. */\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":";;;;;;;;AAyBA,SAAgB,iBAAiB,MAA2C;CAC1E,MAAM,EAAE,mBAAmB,UAAU,SAAS;CAC9C,MAAM,WAAW,OAAsB,IAAI;CAC3C,MAAM,YAAY,UAAU,iBAAiB;CAC7C,MAAM,aAAa,OAA2B,IAAI;CAClD,MAAM,aAAa,OAAO,OAAO;CACjC,MAAM,YAAY,OAA4B,IAAI;CAElD,MAAM,OAAO,kBAAkB;EAC7B,UAAU,UAAU;EACpB,UAAU,UAAU;EACpB,SAAS,UAAU;EACnB,MAAM,KAAK,WAAW;EACtB,IAAI,CAAC,MAAM,CAAC,WAAW,SAAS;EAChC,MAAM,UAAU,MAAoB;GAClC,SAAS,UAAU,UAAU,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,MAAM;EACpE;EACA,MAAM,gBAAgB;GAAE,SAAS,UAAU;EAAM;EACjD,GAAG,iBAAiB,eAAe,MAAM;EACzC,GAAG,iBAAiB,gBAAgB,OAAO;EAC3C,UAAU,gBAAgB;GACxB,GAAG,oBAAoB,eAAe,MAAM;GAC5C,GAAG,oBAAoB,gBAAgB,OAAO;EAChD;CACF,GAAG,CAAC,SAAS,CAAC;CAEd,gBAAgB;EACd,WAAW,UAAU;EACrB,KAAK;EACL,aAAa;GACX,UAAU,UAAU;GACpB,UAAU,UAAU;GACpB,SAAS,UAAU;EACrB;CACF,GAAG,CAAC,SAAS,IAAI,CAAC;CAElB,MAAM,YAAY,aAAa,YAAgC;EAC7D,IAAI,WAAW,YAAY,SAAS;EACpC,WAAW,UAAU;EACrB,KAAK;CACP,GAAG,CAAC,IAAI,CAAC;CACT,MAAM,WAAW,kBAAkB,SAAS,SAAS,CAAC,CAAC;CAEvD,OAAO,eAAe;EAAE;EAAU;CAAU,IAAI,CAAC,UAAU,SAAS,CAAC;AACvE"}

package/dist/features/ingestion/contentHandlers.js

@@ -1,46 +1,92 @@
-import { dwarn as e } from "../../debug/flag.js";
-import { UNKNOWN_MIME as t, mimeMatchesGlob as n } from "@weasel-js/gestures";
+import { dwarn } from "../../debug/flag.js";
+import { UNKNOWN_MIME, mimeMatchesGlob } from "@weasel-js/gestures";
+
 //#region src/features/ingestion/contentHandlers.ts
-var r = [];
-function i(e) {
-	return r.push(e), () => {
-		let t = r.indexOf(e);
-		t >= 0 && r.splice(t, 1);
+/**
+* Content-handler registry for external-content ingestion.
+*
+* All three arrival paths (OS drop, clipboard paste, file picker /
+* `CanvasExtensionApi.ingest`) converge here: `runIngest(items, ctx)`
+* partitions the items across registered handlers in priority order — the
+* first matching handler takes every item it matches; leftovers continue
+* down the list.
+*
+* MIME matching delegates to `mimeMatchesGlob` from `@weasel-js/gestures` —
+* the SAME matcher the binding-level `types` filter uses, so a binding that
+* matched can never disagree with the registry about what a glob means.
+*/
+var HANDLERS = [];
+/** Register a content handler. Returns a disposer that removes it. */
+function registerContentHandler(entry) {
+	HANDLERS.push(entry);
+	return () => {
+		const i = HANDLERS.indexOf(entry);
+		if (i >= 0) HANDLERS.splice(i, 1);
 	};
 }
-function a(e) {
-	return [...e].sort((e, t) => (t.priority ?? 0) - (e.priority ?? 0));
+function byPriority(handlers) {
+	return [...handlers].sort((a, b) => (b.priority ?? 0) - (a.priority ?? 0));
 }
-function o() {
-	return a(r);
+/** Snapshot of registered handlers, priority-ordered (stable within ties —
+*  registration order; Array.prototype.sort is stable per ES2019). */
+function getContentHandlers() {
+	return byPriority(HANDLERS);
 }
-function s(e, t) {
-	let { match: r } = e;
-	if (typeof r == "function") try {
-		return r(t);
-	} catch (t) {
-		return console.warn(`weasel ingest: handler "${e.id}" match predicate threw`, t), !1;
+function entryMatches(entry, item) {
+	const { match } = entry;
+	if (typeof match === "function") try {
+		return match(item);
+	} catch (err) {
+		console.warn(`weasel ingest: handler "${entry.id}" match predicate threw`, err);
+		return false;
 	}
-	return (Array.isArray(r) ? r : [r]).some((e) => n(t.mime, e));
+	return (Array.isArray(match) ? match : [match]).some((g) => mimeMatchesGlob(item.mime, g));
 }
-function c(e, i = r) {
-	return e.some((e) => e.kind === void 0 ? e.mime === t || i.some((t) => {
-		let r = typeof t.match == "function" ? t.types : [t.match].flat();
-		return r === void 0 || r.some((t) => n(e.mime, t));
-	}) : i.some((t) => s(t, e)));
+/**
+* Whether some handler could claim one of `items`: the registry's, or
+* `handlers`. An item with contents is put to each handler's `match`. One
+* with a MIME alone, from a drag still in flight, is answered from the globs
+* and a predicate's declared `types`; it is never refused when its MIME is
+* `UNKNOWN_MIME`, or while a predicate handler declares no types.
+*/
+function couldClaim(items, handlers = HANDLERS) {
+	return items.some((item) => {
+		if (item.kind !== void 0) return handlers.some((h) => entryMatches(h, item));
+		if (item.mime === UNKNOWN_MIME) return true;
+		return handlers.some((h) => {
+			const globs = typeof h.match === "function" ? h.types : [h.match].flat();
+			return globs === void 0 || globs.some((g) => mimeMatchesGlob(item.mime, g));
+		});
+	});
 }
-async function l(t, n, r = {}) {
-	let i = t, c = [], l = r.handlers ? a(r.handlers) : o();
-	for (let e of l) {
-		if (i.length === 0) break;
-		let t = i.filter((t) => s(e, t));
-		t.length !== 0 && (i = i.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);
-		})));
+/**
+* Route one ingest event's items through the registry. Handlers are queued
+* as microtasks in priority order and their async work then overlaps (each
+* already owns a disjoint item set); a throwing or rejecting handler
+* `console.warn`s and doesn't block the others. The queue order is a real
+* invariant: a higher-priority handler's `handle` body runs before lower
+* ones start, so ctx-flag coordination (e.g. `consumedWeaselPayload`)
+* works — but only while the writing handler stays synchronous up to the
+* write and the reading handler reads before its first `await`.
+* Unmatched items are ignored with a debug-gated `dwarn('ingest', ...)`.
+*/
+async function runIngest(items, ctx, opts = {}) {
+	let remaining = items;
+	const runs = [];
+	const handlers = opts.handlers ? byPriority(opts.handlers) : getContentHandlers();
+	for (const entry of handlers) {
+		if (remaining.length === 0) break;
+		const mine = remaining.filter((it) => entryMatches(entry, it));
+		if (mine.length === 0) continue;
+		remaining = remaining.filter((it) => !mine.includes(it));
+		runs.push(Promise.resolve().then(() => entry.handle(mine, ctx)).catch((err) => {
+			console.warn(`weasel ingest: handler "${entry.id}" threw`, err);
+		}));
 	}
-	i.length > 0 && e("ingest", `no content handler matched ${i.length} item(s):`, i.map((e) => e.mime).join(", ")), await Promise.all(c);
+	if (remaining.length > 0) dwarn("ingest", `no content handler matched ${remaining.length} item(s):`, remaining.map((it) => it.mime).join(", "));
+	await Promise.all(runs);
 }
-//#endregion
-export { c as couldClaim, o as getContentHandlers, i as registerContentHandler, l as runIngest };
 
+//#endregion
+export { couldClaim, getContentHandlers, registerContentHandler, runIngest };
 //# sourceMappingURL=contentHandlers.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"contentHandlers.js","names":["HANDLERS","registerContentHandler","entry","i","byPriority","handlers","b","a","getContentHandlers","entryMatches","match","item","err","mimeMatchesGlob","g","couldClaim","items","UNKNOWN_MIME","globs","h","runIngest","remaining","runs","opts","mine","it","ctx","dwarn"],"sources":["../../../src/features/ingestion/contentHandlers.ts"],"sourcesContent":["/**\n * Content-handler registry for external-content ingestion.\n *\n * All three arrival paths (OS drop, clipboard paste, file picker /\n * `CanvasExtensionApi.ingest`) converge here: `runIngest(items, ctx)`\n * partitions the items across registered handlers in priority order — the\n * first matching handler takes every item it matches; leftovers continue\n * down the list.\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, UNKNOWN_MIME } 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. `kit:svg`'s `text/plain` SVG fallback\n   *  reads this to decline the SVG flavor of a copy whose weasel-JSON flavor\n   *  already ingested (avoids a double-paste when both flavors ride one\n   *  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  /** For a predicate `match`: the MIME globs it could say yes to. A drag\n   *  still in flight shows its MIMEs and no contents, so a predicate cannot be\n   *  asked about it; this is what it is asked instead. Without it, no drag\n   *  can be refused while this handler is registered. */\n  types?: readonly string[];\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.\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 * Whether some handler could claim one of `items`: the registry's, or\n * `handlers`. An item with contents is put to each handler's `match`. One\n * with a MIME alone, from a drag still in flight, is answered from the globs\n * and a predicate's declared `types`; it is never refused when its MIME is\n * `UNKNOWN_MIME`, or while a predicate handler declares no types.\n */\nexport function couldClaim(\n  items: readonly IngestItem[],\n  handlers: readonly ContentHandlerEntry[] = HANDLERS,\n): boolean {\n  return items.some((item) => {\n    if ((item as { kind?: string }).kind !== undefined) return handlers.some((h) => entryMatches(h, item));\n    if (item.mime === UNKNOWN_MIME) return true;\n    return handlers.some((h) => {\n      const globs = typeof h.match === 'function' ? h.types : [h.match].flat();\n      return globs === undefined || globs.some((g) => mimeMatchesGlob(item.mime, g));\n    });\n  });\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":";;;AAiFA,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;AAcA,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;AASA,SAAgBC,EACd,GACA,IAA2Cf,GAClC;CACT,OAAOgB,EAAM,MAAM,MACZL,EAA2B,SAAS,KAAA,IACrCA,EAAK,SAASM,KACXZ,EAAS,MAAM,MAAM;EAC1B,IAAMa,IAAQ,OAAOC,EAAE,SAAU,aAAaA,EAAE,QAAQ,CAACA,EAAE,KAAK,CAAC,CAAC,KAAK;EACvE,OAAOD,MAAU,KAAA,KAAaA,EAAM,MAAM,MAAML,EAAgBF,EAAK,MAAMG,CAAC,CAAC;CAC/E,CAAC,IAL0DT,EAAS,MAAM,MAAMI,EAAaU,GAAGR,CAAI,CAAC,CAMtG;AACH;AAaA,eAAsBS,EACpB,GACA,GACA,IAAyB,CAAC,GACX;CACf,IAAIC,IAAYL,GACVM,IAAwB,CAAC,GACzBjB,IAAWkB,EAAK,WAAWnB,EAAWmB,EAAK,QAAQ,IAAIf,EAAmB;CAEhF,KAAK,IAAMN,KAASG,GAAU;EAC5B,IAAIgB,EAAU,WAAW,GAAG;EAC5B,IAAMG,IAAOH,EAAU,QAAQ,MAAOZ,EAAaP,GAAOuB,CAAE,CAAC;EAC7D,AAAID,EAAK,WAAW,MACpB,IAAYH,EAAU,QAAQ,MAAO,CAACG,EAAK,SAASC,CAAE,CAAC,GACvDH,EAAK,KACH,QAAQ,QAAQ,CAAC,CACd,WAAWpB,EAAM,OAAOsB,GAAME,CAAG,CAAC,CAAC,CACnC,OAAO,MAAQ;GACd,QAAQ,KAAK,2BAA2BxB,EAAM,GAAG,UAAUU,CAAG;EAChE,CAAC,CACL;CACF;CAUA,AARIS,EAAU,SAAS,KACrBM,EACE,UACA,8BAA8BN,EAAU,OAAO,YAC/CA,EAAU,KAAK,MAAOI,EAAG,IAAI,CAAC,CAAC,KAAK,IAAI,CAC1C,GAGF,MAAM,QAAQ,IAAIH,CAAI;AACxB"}
+{"version":3,"file":"contentHandlers.js","names":[],"sources":["../../../src/features/ingestion/contentHandlers.ts"],"sourcesContent":["/**\n * Content-handler registry for external-content ingestion.\n *\n * All three arrival paths (OS drop, clipboard paste, file picker /\n * `CanvasExtensionApi.ingest`) converge here: `runIngest(items, ctx)`\n * partitions the items across registered handlers in priority order — the\n * first matching handler takes every item it matches; leftovers continue\n * down the list.\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, UNKNOWN_MIME } 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. `kit:svg`'s `text/plain` SVG fallback\n   *  reads this to decline the SVG flavor of a copy whose weasel-JSON flavor\n   *  already ingested (avoids a double-paste when both flavors ride one\n   *  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  /** For a predicate `match`: the MIME globs it could say yes to. A drag\n   *  still in flight shows its MIMEs and no contents, so a predicate cannot be\n   *  asked about it; this is what it is asked instead. Without it, no drag\n   *  can be refused while this handler is registered. */\n  types?: readonly string[];\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.\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 * Whether some handler could claim one of `items`: the registry's, or\n * `handlers`. An item with contents is put to each handler's `match`. One\n * with a MIME alone, from a drag still in flight, is answered from the globs\n * and a predicate's declared `types`; it is never refused when its MIME is\n * `UNKNOWN_MIME`, or while a predicate handler declares no types.\n */\nexport function couldClaim(\n  items: readonly IngestItem[],\n  handlers: readonly ContentHandlerEntry[] = HANDLERS,\n): boolean {\n  return items.some((item) => {\n    if ((item as { kind?: string }).kind !== undefined) return handlers.some((h) => entryMatches(h, item));\n    if (item.mime === UNKNOWN_MIME) return true;\n    return handlers.some((h) => {\n      const globs = typeof h.match === 'function' ? h.types : [h.match].flat();\n      return globs === undefined || globs.some((g) => mimeMatchesGlob(item.mime, g));\n    });\n  });\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":";;;;;;;;;;;;;;;;;AAiFA,IAAM,WAAkC,CAAC;;AAGzC,SAAgB,uBAAuB,OAAwC;CAC7E,SAAS,KAAK,KAAK;CACnB,aAAa;EACX,MAAM,IAAI,SAAS,QAAQ,KAAK;EAChC,IAAI,KAAK,GAAG,SAAS,OAAO,GAAG,CAAC;CAClC;AACF;AAEA,SAAS,WAAW,UAAiE;CACnF,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC,MAAM,GAAG,OAAO,EAAE,YAAY,MAAM,EAAE,YAAY,EAAE;AAC3E;;;AAIA,SAAgB,qBAAqD;CACnE,OAAO,WAAW,QAAQ;AAC5B;AAcA,SAAS,aAAa,OAA4B,MAA2B;CAC3E,MAAM,EAAE,UAAU;CAClB,IAAI,OAAO,UAAU,YACnB,IAAI;EACF,OAAO,MAAM,IAAI;CACnB,SAAS,KAAK;EACZ,QAAQ,KAAK,2BAA2B,MAAM,GAAG,0BAA0B,GAAG;EAC9E,OAAO;CACT;CAGF,QADc,MAAM,QAAQ,KAAK,IAAI,QAAQ,CAAC,KAAK,EAC5C,CAAM,MAAM,MAAM,gBAAgB,KAAK,MAAM,CAAC,CAAC;AACxD;;;;;;;;AASA,SAAgB,WACd,OACA,WAA2C,UAClC;CACT,OAAO,MAAM,MAAM,SAAS;EAC1B,IAAK,KAA2B,SAAS,QAAW,OAAO,SAAS,MAAM,MAAM,aAAa,GAAG,IAAI,CAAC;EACrG,IAAI,KAAK,SAAS,cAAc,OAAO;EACvC,OAAO,SAAS,MAAM,MAAM;GAC1B,MAAM,QAAQ,OAAO,EAAE,UAAU,aAAa,EAAE,QAAQ,CAAC,EAAE,KAAK,CAAC,CAAC,KAAK;GACvE,OAAO,UAAU,UAAa,MAAM,MAAM,MAAM,gBAAgB,KAAK,MAAM,CAAC,CAAC;EAC/E,CAAC;CACH,CAAC;AACH;;;;;;;;;;;;AAaA,eAAsB,UACpB,OACA,KACA,OAAyB,CAAC,GACX;CACf,IAAI,YAAY;CAChB,MAAM,OAAwB,CAAC;CAC/B,MAAM,WAAW,KAAK,WAAW,WAAW,KAAK,QAAQ,IAAI,mBAAmB;CAEhF,KAAK,MAAM,SAAS,UAAU;EAC5B,IAAI,UAAU,WAAW,GAAG;EAC5B,MAAM,OAAO,UAAU,QAAQ,OAAO,aAAa,OAAO,EAAE,CAAC;EAC7D,IAAI,KAAK,WAAW,GAAG;EACvB,YAAY,UAAU,QAAQ,OAAO,CAAC,KAAK,SAAS,EAAE,CAAC;EACvD,KAAK,KACH,QAAQ,QAAQ,CAAC,CACd,WAAW,MAAM,OAAO,MAAM,GAAG,CAAC,CAAC,CACnC,OAAO,QAAQ;GACd,QAAQ,KAAK,2BAA2B,MAAM,GAAG,UAAU,GAAG;EAChE,CAAC,CACL;CACF;CAEA,IAAI,UAAU,SAAS,GACrB,MACE,UACA,8BAA8B,UAAU,OAAO,YAC/C,UAAU,KAAK,OAAO,GAAG,IAAI,CAAC,CAAC,KAAK,IAAI,CAC1C;CAGF,MAAM,QAAQ,IAAI,IAAI;AACxB"}

package/dist/features/ingestion/imageHandler.js

@@ -1,42 +1,62 @@
-import { arrivalBounds as e } from "./placement.js";
+import { arrivalBounds } from "./placement.js";
+
 //#region src/features/ingestion/imageHandler.ts
-var t = .9, n = async (e) => {
-	let t = await createImageBitmap(e), n = {
-		width: t.width,
-		height: t.height
+var VIEWPORT_FIT = .9;
+var defaultMeasure = async (file) => {
+	const bitmap = await createImageBitmap(file);
+	const size = {
+		width: bitmap.width,
+		height: bitmap.height
 	};
-	return t.close(), n;
-}, r = (e) => new Promise((t, n) => {
-	let r = new FileReader();
-	r.onload = () => t(r.result), r.onerror = () => n(r.error), r.readAsDataURL(e);
-}), i = n, a = r;
-async function o(n, r, o = {}) {
-	let s = 0;
-	for (let c of n) try {
-		let n = await (o.measure ?? i)(c), l = r.resolveSrc ? await r.resolveSrc(c) : await a(c);
-		!r.resolveSrc && o.mimeOverride && (l = l.replace(/^data:[^;,]*/, `data:${o.mimeOverride}`));
-		let u = r.viewportWorldRect(), d = Math.min(1, u.width * t / n.width, u.height * t / n.height), f = {
-			width: n.width * d,
-			height: n.height * d
+	bitmap.close();
+	return size;
+};
+var defaultToDataUri = (file) => new Promise((resolve, reject) => {
+	const reader = new FileReader();
+	reader.onload = () => resolve(reader.result);
+	reader.onerror = () => reject(reader.error);
+	reader.readAsDataURL(file);
+});
+var measure = defaultMeasure;
+var toDataUri = defaultToDataUri;
+/**
+* @internal The shared embed engine: for each file, measure → resolve a
+* `src` → fit-clamp to 90% of the visible viewport → insert one image node
+* centered on `ctx.point` (or the viewport center), cascading multi-file
+* batches by a fixed offset. A file that fails to measure or resolve is
+* skipped with a `console.warn`; the rest proceed.
+*/
+async function embedFilesAsImageNodes(files, ctx, opts = {}) {
+	let index = 0;
+	for (const file of files) try {
+		const natural = await (opts.measure ?? measure)(file);
+		let src = ctx.resolveSrc ? await ctx.resolveSrc(file) : await toDataUri(file);
+		if (!ctx.resolveSrc && opts.mimeOverride) src = src.replace(/^data:[^;,]*/, `data:${opts.mimeOverride}`);
+		const view = ctx.viewportWorldRect();
+		const scale = Math.min(1, view.width * VIEWPORT_FIT / natural.width, view.height * VIEWPORT_FIT / natural.height);
+		const size = {
+			width: natural.width * scale,
+			height: natural.height * scale
 		};
-		r.insert.commit(e(r, f, s), {
+		ctx.insert.commit(arrivalBounds(ctx, size, index), {
 			kind: "image",
-			src: l
-		}), s++;
-	} catch (e) {
-		console.warn(`weasel ingest: image "${c.name}" failed to load`, e);
+			src
+		});
+		index++;
+	} catch (err) {
+		console.warn(`weasel ingest: image "${file.name}" failed to load`, err);
 	}
 }
-var s = {
+var kitImageHandler = {
 	id: "kit:image",
-	match: (e) => e.kind === "file" && e.mime.startsWith("image/"),
+	match: (item) => item.kind === "file" && item.mime.startsWith("image/"),
 	types: ["image/*"],
 	priority: -100,
-	handle(e, t) {
-		return o(e.flatMap((e) => e.kind === "file" ? [e.file] : []), t);
+	handle(items, ctx) {
+		return embedFilesAsImageNodes(items.flatMap((it) => it.kind === "file" ? [it.file] : []), ctx);
 	}
 };
-//#endregion
-export { o as embedFilesAsImageNodes, s as kitImageHandler };
 
+//#endregion
+export { embedFilesAsImageNodes, kitImageHandler };
 //# sourceMappingURL=imageHandler.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"imageHandler.js","names":["VIEWPORT_FIT","defaultMeasure","bitmap","file","size","defaultToDataUri","reader","resolve","reject","measure","toDataUri","embedFilesAsImageNodes","index","files","natural","opts","src","ctx","view","scale","arrivalBounds","err","kitImageHandler","item","items","it"],"sources":["../../../src/features/ingestion/imageHandler.ts"],"sourcesContent":["/**\n * The kit's `image/*` content handler. With no consumer `resolveSrc`, a file\n * embeds as a `data:` URI so the scene stays serializable.\n *\n * Registered at priority -100 so any consumer handler (default 0) can take\n * image files first.\n */\nimport type { ContentHandlerEntry, IngestCtx } from './contentHandlers';\nimport type { IngestItem } from '@weasel-js/routing';\nimport { arrivalBounds } from './placement';\n\nconst VIEWPORT_FIT = 0.9;\n\nexport type Measure = (file: File) => Promise<{ width: number; height: number }>;\ntype ToDataUri = (file: File) => Promise<string>;\n\nconst defaultMeasure: Measure = async (file) => {\n  const bitmap = await createImageBitmap(file);\n  const size = { width: bitmap.width, height: bitmap.height };\n  bitmap.close();\n  return size;\n};\n\nconst defaultToDataUri: ToDataUri = (file) =>\n  new Promise((resolve, reject) => {\n    const reader = new FileReader();\n    reader.onload = () => resolve(reader.result as string);\n    reader.onerror = () => reject(reader.error);\n    reader.readAsDataURL(file);\n  });\n\nlet measure: Measure = defaultMeasure;\nlet toDataUri: ToDataUri = defaultToDataUri;\n\n/** @internal Options for {@link embedFilesAsImageNodes} — used by the kit\n *  SVG handler, whose files can't go through `createImageBitmap`. */\nexport interface EmbedImageOptions {\n  /** Replace the raster measurer for these files (the SVG handler supplies\n   *  an `Image`-element one). Defaults to the module measurer (seam-aware). */\n  measure?: Measure;\n  /** Force the data-URI MIME. A sniffed `.svg` whose `File.type` was empty\n   *  would otherwise embed as `data:application/octet-stream;…`, which\n   *  browsers refuse to rasterize. No effect on `resolveSrc` output. */\n  mimeOverride?: string;\n}\n\n/**\n * @internal The shared embed engine: for each file, measure → resolve a\n * `src` → fit-clamp to 90% of the visible viewport → insert one image node\n * centered on `ctx.point` (or the viewport center), cascading multi-file\n * batches by a fixed offset. A file that fails to measure or resolve is\n * skipped with a `console.warn`; the rest proceed.\n */\nexport async function embedFilesAsImageNodes(\n  files: File[],\n  ctx: IngestCtx,\n  opts: EmbedImageOptions = {},\n): Promise<void> {\n  let index = 0;\n  for (const file of files) {\n    try {\n      // Measure first: a corrupt file should fail cheaply here, not after\n      // a consumer `resolveSrc` has already uploaded it somewhere.\n      const natural = await (opts.measure ?? measure)(file);\n      let src = ctx.resolveSrc ? await ctx.resolveSrc(file) : await toDataUri(file);\n      if (!ctx.resolveSrc && opts.mimeOverride) {\n        src = src.replace(/^data:[^;,]*/, `data:${opts.mimeOverride}`);\n      }\n      const view = ctx.viewportWorldRect();\n      const scale = Math.min(\n        1,\n        (view.width * VIEWPORT_FIT) / natural.width,\n        (view.height * VIEWPORT_FIT) / natural.height,\n      );\n      const size = { width: natural.width * scale, height: natural.height * scale };\n      ctx.insert.commit(arrivalBounds(ctx, size, index), { kind: 'image', src });\n      index++;\n    } catch (err) {\n      console.warn(`weasel ingest: image \"${file.name}\" failed to load`, err);\n    }\n  }\n}\n\nexport const kitImageHandler: ContentHandlerEntry = {\n  id: 'kit:image',\n  match: (item: IngestItem) => item.kind === 'file' && item.mime.startsWith('image/'),\n  types: ['image/*'],\n  priority: -100,\n  handle(items, ctx: IngestCtx) {\n    const files = items.flatMap((it) => (it.kind === 'file' ? [it.file] : []));\n    return embedFilesAsImageNodes(files, ctx);\n  },\n};\n\n/** @internal test seam — override the bitmap measurer (jsdom has no\n *  `createImageBitmap`). Not part of the public barrel. */\nexport function __setImageMeasureForTests(fn: Measure): void {\n  measure = fn;\n}\n\n/** @internal test seam — override the FileReader embed. */\nexport function __setFileToDataUriForTests(fn: ToDataUri): void {\n  toDataUri = fn;\n}\n\n/** @internal test seam — restore default seams. */\nexport function _resetImageHandlerSeamsForTests(): void {\n  measure = defaultMeasure;\n  toDataUri = defaultToDataUri;\n}\n"],"mappings":";;AAWA,IAAMA,IAAe,IAKfC,IAA0B,OAAO,MAAS;CAC9C,IAAMC,IAAS,MAAM,kBAAkBC,CAAI,GACrCC,IAAO;EAAE,OAAOF,EAAO;EAAO,QAAQA,EAAO;CAAO;CAE1D,OADAA,EAAO,MAAM,GACNE;AACT,GAEMC,KAA+B,MACnC,IAAI,SAAS,GAAS,MAAW;CAC/B,IAAMC,IAAS,IAAI,WAAW;CAG9B,AAFA,EAAO,eAAeC,EAAQD,EAAO,MAAgB,GACrD,EAAO,gBAAgBE,EAAOF,EAAO,KAAK,GAC1CA,EAAO,cAAcH,CAAI;AAC3B,CAAC,GAECM,IAAmBR,GACnBS,IAAuBL;AAqB3B,eAAsBM,EACpB,GACA,GACA,IAA0B,CAAC,GACZ;CACf,IAAIC,IAAQ;CACZ,KAAK,IAAMT,KAAQU,GACjB,IAAI;EAGF,IAAMC,IAAU,OAAOC,EAAK,WAAWN,EAAA,CAASN,CAAI,GAChDa,IAAMC,EAAI,aAAa,MAAMA,EAAI,WAAWd,CAAI,IAAI,MAAMO,EAAUP,CAAI;EAC5E,AAAI,CAACc,EAAI,cAAcF,EAAK,iBAC1B,IAAMC,EAAI,QAAQ,gBAAgB,QAAQD,EAAK,cAAc;EAE/D,IAAMG,IAAOD,EAAI,kBAAkB,GAC7BE,IAAQ,KAAK,IACjB,GACCD,EAAK,QAAQlB,IAAgBc,EAAQ,OACrCI,EAAK,SAASlB,IAAgBc,EAAQ,MACzC,GACMV,IAAO;GAAE,OAAOU,EAAQ,QAAQK;GAAO,QAAQL,EAAQ,SAASK;EAAM;EAE5E,AADAF,EAAI,OAAO,OAAOG,EAAcH,GAAKb,GAAMQ,CAAK,GAAG;GAAE,MAAM;GAAS;EAAI,CAAC,GACzE;CACF,SAASS,GAAK;EACZ,QAAQ,KAAK,yBAAyBlB,EAAK,KAAK,mBAAmBkB,CAAG;CACxE;AAEJ;AAEA,IAAaC,IAAuC;CAClD,IAAI;CACJ,QAAQ,MAAqBC,EAAK,SAAS,UAAUA,EAAK,KAAK,WAAW,QAAQ;CAClF,OAAO,CAAC,SAAS;CACjB,UAAU;CACV,OAAO,GAAO,GAAgB;EAE5B,OAAOZ,EADOa,EAAM,SAAS,MAAQC,EAAG,SAAS,SAAS,CAACA,EAAG,IAAI,IAAI,CAAC,CACzC,GAAOR,CAAG;CAC1C;AACF"}
+{"version":3,"file":"imageHandler.js","names":[],"sources":["../../../src/features/ingestion/imageHandler.ts"],"sourcesContent":["/**\n * The kit's `image/*` content handler. With no consumer `resolveSrc`, a file\n * embeds as a `data:` URI so the scene stays serializable.\n *\n * Registered at priority -100 so any consumer handler (default 0) can take\n * image files first.\n */\nimport type { ContentHandlerEntry, IngestCtx } from './contentHandlers';\nimport type { IngestItem } from '@weasel-js/routing';\nimport { arrivalBounds } from './placement';\n\nconst VIEWPORT_FIT = 0.9;\n\nexport type Measure = (file: File) => Promise<{ width: number; height: number }>;\ntype ToDataUri = (file: File) => Promise<string>;\n\nconst defaultMeasure: Measure = async (file) => {\n  const bitmap = await createImageBitmap(file);\n  const size = { width: bitmap.width, height: bitmap.height };\n  bitmap.close();\n  return size;\n};\n\nconst defaultToDataUri: ToDataUri = (file) =>\n  new Promise((resolve, reject) => {\n    const reader = new FileReader();\n    reader.onload = () => resolve(reader.result as string);\n    reader.onerror = () => reject(reader.error);\n    reader.readAsDataURL(file);\n  });\n\nlet measure: Measure = defaultMeasure;\nlet toDataUri: ToDataUri = defaultToDataUri;\n\n/** @internal Options for {@link embedFilesAsImageNodes} — used by the kit\n *  SVG handler, whose files can't go through `createImageBitmap`. */\nexport interface EmbedImageOptions {\n  /** Replace the raster measurer for these files (the SVG handler supplies\n   *  an `Image`-element one). Defaults to the module measurer (seam-aware). */\n  measure?: Measure;\n  /** Force the data-URI MIME. A sniffed `.svg` whose `File.type` was empty\n   *  would otherwise embed as `data:application/octet-stream;…`, which\n   *  browsers refuse to rasterize. No effect on `resolveSrc` output. */\n  mimeOverride?: string;\n}\n\n/**\n * @internal The shared embed engine: for each file, measure → resolve a\n * `src` → fit-clamp to 90% of the visible viewport → insert one image node\n * centered on `ctx.point` (or the viewport center), cascading multi-file\n * batches by a fixed offset. A file that fails to measure or resolve is\n * skipped with a `console.warn`; the rest proceed.\n */\nexport async function embedFilesAsImageNodes(\n  files: File[],\n  ctx: IngestCtx,\n  opts: EmbedImageOptions = {},\n): Promise<void> {\n  let index = 0;\n  for (const file of files) {\n    try {\n      // Measure first: a corrupt file should fail cheaply here, not after\n      // a consumer `resolveSrc` has already uploaded it somewhere.\n      const natural = await (opts.measure ?? measure)(file);\n      let src = ctx.resolveSrc ? await ctx.resolveSrc(file) : await toDataUri(file);\n      if (!ctx.resolveSrc && opts.mimeOverride) {\n        src = src.replace(/^data:[^;,]*/, `data:${opts.mimeOverride}`);\n      }\n      const view = ctx.viewportWorldRect();\n      const scale = Math.min(\n        1,\n        (view.width * VIEWPORT_FIT) / natural.width,\n        (view.height * VIEWPORT_FIT) / natural.height,\n      );\n      const size = { width: natural.width * scale, height: natural.height * scale };\n      ctx.insert.commit(arrivalBounds(ctx, size, index), { kind: 'image', src });\n      index++;\n    } catch (err) {\n      console.warn(`weasel ingest: image \"${file.name}\" failed to load`, err);\n    }\n  }\n}\n\nexport const kitImageHandler: ContentHandlerEntry = {\n  id: 'kit:image',\n  match: (item: IngestItem) => item.kind === 'file' && item.mime.startsWith('image/'),\n  types: ['image/*'],\n  priority: -100,\n  handle(items, ctx: IngestCtx) {\n    const files = items.flatMap((it) => (it.kind === 'file' ? [it.file] : []));\n    return embedFilesAsImageNodes(files, ctx);\n  },\n};\n\n/** @internal test seam — override the bitmap measurer (jsdom has no\n *  `createImageBitmap`). Not part of the public barrel. */\nexport function __setImageMeasureForTests(fn: Measure): void {\n  measure = fn;\n}\n\n/** @internal test seam — override the FileReader embed. */\nexport function __setFileToDataUriForTests(fn: ToDataUri): void {\n  toDataUri = fn;\n}\n\n/** @internal test seam — restore default seams. */\nexport function _resetImageHandlerSeamsForTests(): void {\n  measure = defaultMeasure;\n  toDataUri = defaultToDataUri;\n}\n"],"mappings":";;;AAWA,IAAM,eAAe;AAKrB,IAAM,iBAA0B,OAAO,SAAS;CAC9C,MAAM,SAAS,MAAM,kBAAkB,IAAI;CAC3C,MAAM,OAAO;EAAE,OAAO,OAAO;EAAO,QAAQ,OAAO;CAAO;CAC1D,OAAO,MAAM;CACb,OAAO;AACT;AAEA,IAAM,oBAA+B,SACnC,IAAI,SAAS,SAAS,WAAW;CAC/B,MAAM,SAAS,IAAI,WAAW;CAC9B,OAAO,eAAe,QAAQ,OAAO,MAAgB;CACrD,OAAO,gBAAgB,OAAO,OAAO,KAAK;CAC1C,OAAO,cAAc,IAAI;AAC3B,CAAC;AAEH,IAAI,UAAmB;AACvB,IAAI,YAAuB;;;;;;;;AAqB3B,eAAsB,uBACpB,OACA,KACA,OAA0B,CAAC,GACZ;CACf,IAAI,QAAQ;CACZ,KAAK,MAAM,QAAQ,OACjB,IAAI;EAGF,MAAM,UAAU,OAAO,KAAK,WAAW,QAAA,CAAS,IAAI;EACpD,IAAI,MAAM,IAAI,aAAa,MAAM,IAAI,WAAW,IAAI,IAAI,MAAM,UAAU,IAAI;EAC5E,IAAI,CAAC,IAAI,cAAc,KAAK,cAC1B,MAAM,IAAI,QAAQ,gBAAgB,QAAQ,KAAK,cAAc;EAE/D,MAAM,OAAO,IAAI,kBAAkB;EACnC,MAAM,QAAQ,KAAK,IACjB,GACC,KAAK,QAAQ,eAAgB,QAAQ,OACrC,KAAK,SAAS,eAAgB,QAAQ,MACzC;EACA,MAAM,OAAO;GAAE,OAAO,QAAQ,QAAQ;GAAO,QAAQ,QAAQ,SAAS;EAAM;EAC5E,IAAI,OAAO,OAAO,cAAc,KAAK,MAAM,KAAK,GAAG;GAAE,MAAM;GAAS;EAAI,CAAC;EACzE;CACF,SAAS,KAAK;EACZ,QAAQ,KAAK,yBAAyB,KAAK,KAAK,mBAAmB,GAAG;CACxE;AAEJ;AAEA,IAAa,kBAAuC;CAClD,IAAI;CACJ,QAAQ,SAAqB,KAAK,SAAS,UAAU,KAAK,KAAK,WAAW,QAAQ;CAClF,OAAO,CAAC,SAAS;CACjB,UAAU;CACV,OAAO,OAAO,KAAgB;EAE5B,OAAO,uBADO,MAAM,SAAS,OAAQ,GAAG,SAAS,SAAS,CAAC,GAAG,IAAI,IAAI,CAAC,CACzC,GAAO,GAAG;CAC1C;AACF"}

package/dist/features/ingestion/openFilePicker.js

@@ -1,15 +1,33 @@
 //#region src/features/ingestion/openFilePicker.ts
-function e(e = {}) {
-	return new Promise((t) => {
-		let n = document.createElement("input");
-		n.type = "file", n.hidden = !0, e.accept && (n.accept = e.accept), e.multiple && (n.multiple = !0), document.body.appendChild(n);
-		let r = (e) => {
-			n.remove(), t(e);
+/**
+* Show the browser's file picker and resolve with what the user chose —
+* empty when they cancel. Must be called from a user gesture (a click
+* handler): browsers block programmatic `input.click()` otherwise. Pairs
+* with `CanvasExtensionApi.ingest`:
+*
+* ```ts
+* const files = await openFilePicker({ accept: 'image/*', multiple: true });
+* canvasRef.current?.ingest(files);
+* ```
+*/
+function openFilePicker(opts = {}) {
+	return new Promise((resolve) => {
+		const input = document.createElement("input");
+		input.type = "file";
+		input.hidden = true;
+		if (opts.accept) input.accept = opts.accept;
+		if (opts.multiple) input.multiple = true;
+		document.body.appendChild(input);
+		const finish = (files) => {
+			input.remove();
+			resolve(files);
 		};
-		n.addEventListener("change", () => r(Array.from(n.files ?? [])), { once: !0 }), n.addEventListener("cancel", () => r([]), { once: !0 }), n.click();
+		input.addEventListener("change", () => finish(Array.from(input.files ?? [])), { once: true });
+		input.addEventListener("cancel", () => finish([]), { once: true });
+		input.click();
 	});
 }
-//#endregion
-export { e as openFilePicker };
 
+//#endregion
+export { openFilePicker };
 //# sourceMappingURL=openFilePicker.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"openFilePicker.js","names":["openFilePicker","input","opts","finish","resolve","files"],"sources":["../../../src/features/ingestion/openFilePicker.ts"],"sourcesContent":["/** Options for {@link openFilePicker}. */\nexport interface OpenFilePickerOptions {\n  /** `<input accept>` filter, e.g. `'image/*'` or `'.csv,text/csv'`. */\n  accept?: string;\n  /** Allow multi-select. Default false. */\n  multiple?: boolean;\n}\n\n/**\n * Show the browser's file picker and resolve with what the user chose —\n * empty when they cancel. Must be called from a user gesture (a click\n * handler): browsers block programmatic `input.click()` otherwise. Pairs\n * with `CanvasExtensionApi.ingest`:\n *\n * ```ts\n * const files = await openFilePicker({ accept: 'image/*', multiple: true });\n * canvasRef.current?.ingest(files);\n * ```\n */\nexport function openFilePicker(opts: OpenFilePickerOptions = {}): Promise<File[]> {\n  return new Promise((resolve) => {\n    const input = document.createElement('input');\n    input.type = 'file';\n    input.hidden = true;\n    if (opts.accept) input.accept = opts.accept;\n    if (opts.multiple) input.multiple = true;\n    document.body.appendChild(input);\n    const finish = (files: File[]) => {\n      input.remove();\n      resolve(files);\n    };\n    input.addEventListener('change', () => finish(Array.from(input.files ?? [])), { once: true });\n    // Where `cancel` is unsupported, the hidden input leaks until the page\n    // unloads.\n    input.addEventListener('cancel', () => finish([]), { once: true });\n    input.click();\n  });\n}\n"],"mappings":";AAmBA,SAAgBA,EAAe,IAA8B,CAAC,GAAoB;CAChF,OAAO,IAAI,SAAS,MAAY;EAC9B,IAAMC,IAAQ,SAAS,cAAc,OAAO;EAK5C,AAJA,EAAM,OAAO,QACb,EAAM,SAAS,IACXC,EAAK,WAAQ,EAAM,SAASA,EAAK,SACjCA,EAAK,aAAU,EAAM,WAAW,KACpC,SAAS,KAAK,YAAYD,CAAK;EAC/B,IAAME,KAAU,MAAkB;GAEhC,AADAF,EAAM,OAAO,GACbG,EAAQC,CAAK;EACf;EAKA,AAJAJ,EAAM,iBAAiB,gBAAgBE,EAAO,MAAM,KAAKF,EAAM,SAAS,CAAC,CAAC,CAAC,GAAG,EAAE,MAAM,GAAK,CAAC,GAG5FA,EAAM,iBAAiB,gBAAgBE,EAAO,CAAC,CAAC,GAAG,EAAE,MAAM,GAAK,CAAC,GACjEF,EAAM,MAAM;CACd,CAAC;AACH"}
+{"version":3,"file":"openFilePicker.js","names":[],"sources":["../../../src/features/ingestion/openFilePicker.ts"],"sourcesContent":["/** Options for {@link openFilePicker}. */\nexport interface OpenFilePickerOptions {\n  /** `<input accept>` filter, e.g. `'image/*'` or `'.csv,text/csv'`. */\n  accept?: string;\n  /** Allow multi-select. Default false. */\n  multiple?: boolean;\n}\n\n/**\n * Show the browser's file picker and resolve with what the user chose —\n * empty when they cancel. Must be called from a user gesture (a click\n * handler): browsers block programmatic `input.click()` otherwise. Pairs\n * with `CanvasExtensionApi.ingest`:\n *\n * ```ts\n * const files = await openFilePicker({ accept: 'image/*', multiple: true });\n * canvasRef.current?.ingest(files);\n * ```\n */\nexport function openFilePicker(opts: OpenFilePickerOptions = {}): Promise<File[]> {\n  return new Promise((resolve) => {\n    const input = document.createElement('input');\n    input.type = 'file';\n    input.hidden = true;\n    if (opts.accept) input.accept = opts.accept;\n    if (opts.multiple) input.multiple = true;\n    document.body.appendChild(input);\n    const finish = (files: File[]) => {\n      input.remove();\n      resolve(files);\n    };\n    input.addEventListener('change', () => finish(Array.from(input.files ?? [])), { once: true });\n    // Where `cancel` is unsupported, the hidden input leaks until the page\n    // unloads.\n    input.addEventListener('cancel', () => finish([]), { once: true });\n    input.click();\n  });\n}\n"],"mappings":";;;;;;;;;;;;AAmBA,SAAgB,eAAe,OAA8B,CAAC,GAAoB;CAChF,OAAO,IAAI,SAAS,YAAY;EAC9B,MAAM,QAAQ,SAAS,cAAc,OAAO;EAC5C,MAAM,OAAO;EACb,MAAM,SAAS;EACf,IAAI,KAAK,QAAQ,MAAM,SAAS,KAAK;EACrC,IAAI,KAAK,UAAU,MAAM,WAAW;EACpC,SAAS,KAAK,YAAY,KAAK;EAC/B,MAAM,UAAU,UAAkB;GAChC,MAAM,OAAO;GACb,QAAQ,KAAK;EACf;EACA,MAAM,iBAAiB,gBAAgB,OAAO,MAAM,KAAK,MAAM,SAAS,CAAC,CAAC,CAAC,GAAG,EAAE,MAAM,KAAK,CAAC;EAG5F,MAAM,iBAAiB,gBAAgB,OAAO,CAAC,CAAC,GAAG,EAAE,MAAM,KAAK,CAAC;EACjE,MAAM,MAAM;CACd,CAAC;AACH"}

package/dist/features/ingestion/placement.js

@@ -1,16 +1,25 @@
-function e(e, t, n) {
-	let r = e.viewportWorldRect(), i = e.point ?? {
-		x: r.x + r.width / 2,
-		y: r.y + r.height / 2
-	}, a = n * 24;
+//#region src/features/ingestion/placement.ts
+var CASCADE_OFFSET_PX = 24;
+/**
+* Where the kit's handlers put arriving content of a given size: centered on
+* `ctx.point` (a drop, a pointed ingest) or on the viewport (a paste), with the
+* `index`-th item of one arrival stepped down and right of the first.
+*/
+function arrivalBounds(ctx, size, index) {
+	const view = ctx.viewportWorldRect();
+	const center = ctx.point ?? {
+		x: view.x + view.width / 2,
+		y: view.y + view.height / 2
+	};
+	const offset = index * CASCADE_OFFSET_PX;
 	return {
-		x: i.x - t.width / 2 + a,
-		y: i.y - t.height / 2 + a,
-		width: t.width,
-		height: t.height
+		x: center.x - size.width / 2 + offset,
+		y: center.y - size.height / 2 + offset,
+		width: size.width,
+		height: size.height
 	};
 }
-//#endregion
-export { e as arrivalBounds };
 
+//#endregion
+export { arrivalBounds };
 //# sourceMappingURL=placement.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"placement.js","names":["arrivalBounds","view","ctx","center","offset","index","size"],"sources":["../../../src/features/ingestion/placement.ts"],"sourcesContent":["import type { IngestCtx } from './contentHandlers';\n\nconst CASCADE_OFFSET_PX = 24;\n\n/**\n * Where the kit's handlers put arriving content of a given size: centered on\n * `ctx.point` (a drop, a pointed ingest) or on the viewport (a paste), with the\n * `index`-th item of one arrival stepped down and right of the first.\n */\nexport function arrivalBounds(\n  ctx: IngestCtx,\n  size: { width: number; height: number },\n  index: number,\n): { x: number; y: number; width: number; height: number } {\n  const view = ctx.viewportWorldRect();\n  const center = ctx.point ?? { x: view.x + view.width / 2, y: view.y + view.height / 2 };\n  const offset = index * CASCADE_OFFSET_PX;\n  return {\n    x: center.x - size.width / 2 + offset,\n    y: center.y - size.height / 2 + offset,\n    width: size.width,\n    height: size.height,\n  };\n}\n"],"mappings":"AASA,SAAgBA,EACd,GACA,GACA,GACyD;CACzD,IAAMC,IAAOC,EAAI,kBAAkB,GAC7BC,IAASD,EAAI,SAAS;EAAE,GAAGD,EAAK,IAAIA,EAAK,QAAQ;EAAG,GAAGA,EAAK,IAAIA,EAAK,SAAS;CAAE,GAChFG,IAASC,IAAQ;CACvB,OAAO;EACL,GAAGF,EAAO,IAAIG,EAAK,QAAQ,IAAIF;EAC/B,GAAGD,EAAO,IAAIG,EAAK,SAAS,IAAIF;EAChC,OAAOE,EAAK;EACZ,QAAQA,EAAK;CACf;AACF"}
+{"version":3,"file":"placement.js","names":[],"sources":["../../../src/features/ingestion/placement.ts"],"sourcesContent":["import type { IngestCtx } from './contentHandlers';\n\nconst CASCADE_OFFSET_PX = 24;\n\n/**\n * Where the kit's handlers put arriving content of a given size: centered on\n * `ctx.point` (a drop, a pointed ingest) or on the viewport (a paste), with the\n * `index`-th item of one arrival stepped down and right of the first.\n */\nexport function arrivalBounds(\n  ctx: IngestCtx,\n  size: { width: number; height: number },\n  index: number,\n): { x: number; y: number; width: number; height: number } {\n  const view = ctx.viewportWorldRect();\n  const center = ctx.point ?? { x: view.x + view.width / 2, y: view.y + view.height / 2 };\n  const offset = index * CASCADE_OFFSET_PX;\n  return {\n    x: center.x - size.width / 2 + offset,\n    y: center.y - size.height / 2 + offset,\n    width: size.width,\n    height: size.height,\n  };\n}\n"],"mappings":";AAEA,IAAM,oBAAoB;;;;;;AAO1B,SAAgB,cACd,KACA,MACA,OACyD;CACzD,MAAM,OAAO,IAAI,kBAAkB;CACnC,MAAM,SAAS,IAAI,SAAS;EAAE,GAAG,KAAK,IAAI,KAAK,QAAQ;EAAG,GAAG,KAAK,IAAI,KAAK,SAAS;CAAE;CACtF,MAAM,SAAS,QAAQ;CACvB,OAAO;EACL,GAAG,OAAO,IAAI,KAAK,QAAQ,IAAI;EAC/B,GAAG,OAAO,IAAI,KAAK,SAAS,IAAI;EAChC,OAAO,KAAK;EACZ,QAAQ,KAAK;CACf;AACF"}

package/dist/features/ingestion/registerKitHandlers.js

@@ -1,26 +1,43 @@
-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";
+import { kitImageHandler } from "./imageHandler.js";
+import { kitSvgHandler } from "./svgHandler.js";
+import { kitWeaselJsonHandler } from "./weaselJsonHandler.js";
+import { registerContentHandler } 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
-		].map(r);
-		a = () => {
-			for (let e of i) e();
+/**
+* Refcounted registration of the kit's default content handlers.
+* Each mounted `<SceneCanvas>` calls this on mount and disposes on unmount;
+* the kit handlers stay registered while at least one canvas is up. (A naive
+* skip-if-present would break the two-canvas case: if the mount that
+* registered `kit:image` unmounts first, the survivor would lose its image
+* handler.)
+*/
+var refs = 0;
+var dispose = null;
+function acquireKitContentHandlers() {
+	refs++;
+	if (refs === 1) {
+		const disposers = [
+			kitImageHandler,
+			kitSvgHandler,
+			kitWeaselJsonHandler
+		].map(registerContentHandler);
+		dispose = () => {
+			for (const d of disposers) d();
 		};
 	}
-	let o = !1;
+	let released = false;
 	return () => {
-		o || (o = !0, i--, i === 0 && (a?.(), a = null));
+		if (released) return;
+		released = true;
+		refs--;
+		if (refs === 0) {
+			dispose?.();
+			dispose = null;
+		}
 	};
 }
-//#endregion
-export { o as acquireKitContentHandlers };
 
+//#endregion
+export { acquireKitContentHandlers };
 //# sourceMappingURL=registerKitHandlers.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"registerKitHandlers.js","names":["refs","dispose","acquireKitContentHandlers","disposers","kitImageHandler","kitSvgHandler","kitWeaselJsonHandler","registerContentHandler","d","released"],"sources":["../../../src/features/ingestion/registerKitHandlers.ts"],"sourcesContent":["/**\n * Refcounted registration of the kit's default content handlers.\n * Each mounted `<SceneCanvas>` calls this on mount and disposes on unmount;\n * the kit handlers stay registered while at least one canvas is up. (A naive\n * skip-if-present would break the two-canvas case: if the mount that\n * registered `kit:image` unmounts first, the survivor would lose its image\n * handler.)\n */\nimport { registerContentHandler } from './contentHandlers';\nimport { kitImageHandler } from './imageHandler';\nimport { kitSvgHandler } from './svgHandler';\nimport { kitWeaselJsonHandler } from './weaselJsonHandler';\n\nlet refs = 0;\nlet dispose: (() => void) | null = null;\n\nexport function acquireKitContentHandlers(): () => void {\n  refs++;\n  if (refs === 1) {\n    const disposers = [kitImageHandler, kitSvgHandler, kitWeaselJsonHandler].map(registerContentHandler);\n    dispose = () => { for (const d of disposers) d(); };\n  }\n  let released = false;\n  return () => {\n    if (released) return;\n    released = true;\n    refs--;\n    if (refs === 0) {\n      dispose?.();\n      dispose = null;\n    }\n  };\n}\n\n/** @internal test seam. */\nexport function _resetKitContentHandlersForTests(): void {\n  refs = 0;\n  dispose = null;\n}\n"],"mappings":";;;;;AAaA,IAAIA,IAAO,GACPC,IAA+B;AAEnC,SAAgBC,IAAwC;CAEtD,IADA,KACIF,MAAS,GAAG;EACd,IAAMG,IAAY;GAACC;GAAiBC;GAAeC;EAAoB,CAAC,CAAC,IAAIC,CAAsB;EACnG,UAAgB;GAAE,KAAK,IAAMC,KAAKL,GAAW,EAAE;EAAG;CACpD;CACA,IAAIM,IAAW;CACf,aAAa;EACX,AAAIA,MACJ,IAAW,IACX,KACIT,MAAS,MACXC,IAAU,GACV,IAAU;CAEd;AACF"}
+{"version":3,"file":"registerKitHandlers.js","names":[],"sources":["../../../src/features/ingestion/registerKitHandlers.ts"],"sourcesContent":["/**\n * Refcounted registration of the kit's default content handlers.\n * Each mounted `<SceneCanvas>` calls this on mount and disposes on unmount;\n * the kit handlers stay registered while at least one canvas is up. (A naive\n * skip-if-present would break the two-canvas case: if the mount that\n * registered `kit:image` unmounts first, the survivor would lose its image\n * handler.)\n */\nimport { registerContentHandler } from './contentHandlers';\nimport { kitImageHandler } from './imageHandler';\nimport { kitSvgHandler } from './svgHandler';\nimport { kitWeaselJsonHandler } from './weaselJsonHandler';\n\nlet refs = 0;\nlet dispose: (() => void) | null = null;\n\nexport function acquireKitContentHandlers(): () => void {\n  refs++;\n  if (refs === 1) {\n    const disposers = [kitImageHandler, kitSvgHandler, kitWeaselJsonHandler].map(registerContentHandler);\n    dispose = () => { for (const d of disposers) d(); };\n  }\n  let released = false;\n  return () => {\n    if (released) return;\n    released = true;\n    refs--;\n    if (refs === 0) {\n      dispose?.();\n      dispose = null;\n    }\n  };\n}\n\n/** @internal test seam. */\nexport function _resetKitContentHandlersForTests(): void {\n  refs = 0;\n  dispose = null;\n}\n"],"mappings":";;;;;;;;;;;;;;AAaA,IAAI,OAAO;AACX,IAAI,UAA+B;AAEnC,SAAgB,4BAAwC;CACtD;CACA,IAAI,SAAS,GAAG;EACd,MAAM,YAAY;GAAC;GAAiB;GAAe;EAAoB,CAAC,CAAC,IAAI,sBAAsB;EACnG,gBAAgB;GAAE,KAAK,MAAM,KAAK,WAAW,EAAE;EAAG;CACpD;CACA,IAAI,WAAW;CACf,aAAa;EACX,IAAI,UAAU;EACd,WAAW;EACX;EACA,IAAI,SAAS,GAAG;GACd,UAAU;GACV,UAAU;EACZ;CACF;AACF"}