@weasel-js/core 1.10.0 → 1.11.0

package/dist/canvas/viewInputs.js.map

@@ -1 +1 @@
-{"version":3,"file":"viewInputs.js","names":["ViewInputsContext","createContext","ViewInputsProvider","useOptionalViewInputs","useContext"],"sources":["../../src/canvas/viewInputs.tsx"],"sourcesContent":["/**\n * What {@link useViewHelpers} needs that belongs to the surface rather than to\n * one view: the adapter, the geometry and the bounds resolver.\n *\n * These are read during a view's render, so they travel as context rather than\n * on the `SurfaceHandle`, which is not attached until an effect runs.\n */\nimport { createContext, useContext, type ReactNode } from 'react';\nimport type { UseViewHelpersOpts } from './useViewHelpers';\nimport type { SelectionApi } from 'core/selection/useSelection';\nimport type { View } from 'core/viewport/view';\nimport type { Bounds } from 'core/viewport/fitViewToBounds';\nimport type { PlaneMap } from 'core/viewport/parallax';\nimport type { ChromeCaps } from 'features/chrome-caps/useChromeCaps';\nimport type { PickView } from './SceneCanvas/useSceneSelectTool';\n\nexport type { ViewRuleInputs } from 'features/chrome-caps/useChromeCaps';\n\n/**\n * @internal Provided by the surface, consumed by `<CanvasView>`.\n *\n * The scene-shaped half only. What a gesture is doing right now is read from\n * the asking view's own dispatcher, not from here.\n */\nexport interface SurfaceViewInputs\n  extends Pick<UseViewHelpersOpts<unknown>, 'adapter' | 'geometry'> {\n  /** A node's box for chrome, drawn under `view` — the camera of the view\n   *  asking, since a node on a parallax plane lands somewhere else in each. */\n  boundsOf: ((id: string, view?: View | null) => Bounds | null) | undefined;\n  /** How `view`'s world maps into the parallax plane `id` is drawn through,\n   *  or null when its layer moves with the camera. */\n  planeOfNode?: ((id: string, view?: View | null) => PlaneMap | null) | undefined;\n  /** `boundsOf` for `id` drawn at an in-flight `pose`, under `view`. */\n  boundsOfPose?: ((id: string, pose: unknown, view?: View | null) => Bounds | null) | undefined;\n  /** Every id under a world point, bottom-first. `view` is the view the\n   *  point was produced under — a screen-pixel tolerance cannot be converted\n   *  without its scale, nor a layer judged without its paint, and the world\n   *  point carries neither. */\n  pickEvery?: (worldX: number, worldY: number, view?: PickView | null) => string[];\n  /** The one id a click resolves to, collapsing parent/child the way the\n   *  select tool does. Falls back to `pickEvery`'s last when absent. */\n  pickBest?: (worldX: number, worldY: number, view?: PickView | null) => string | null;\n  /** A hit node's routing-trait kind, so `target: 'kind:text'` bindings match. */\n  kindOfNode?: (id: string) => string | undefined;\n  /** The surface's chrome-caps rule table, evaluated against a view's own\n   *  context. */\n  chromeCaps?: ChromeCaps;\n  /** The surface's selection, which a view shares unless it was given one of\n   *  its own. */\n  selectionApi: SelectionApi;\n  /** The rotate badge the surface's selection overlay paints, which every\n   *  view drawing that overlay has to make grabbable where it is drawn. */\n  rotationBadge?: { distancePx: number; sizePx: number } | null;\n}\n\nconst ViewInputsContext = createContext<SurfaceViewInputs | null>(null);\n\n/** @internal */\nexport function ViewInputsProvider(\n  { value, children }: { value: SurfaceViewInputs; children: ReactNode },\n) {\n  return <ViewInputsContext.Provider value={value}>{children}</ViewInputsContext.Provider>;\n}\n\n/** The hosting surface's view-helper inputs, or `null` outside one. */\nexport function useOptionalViewInputs(): SurfaceViewInputs | null {\n  return useContext(ViewInputsContext);\n}\n"],"mappings":";;;AAuDA,IAAMA,IAAoBC,EAAwC,IAAI;AAGtE,SAAgBC,EACd,EAAE,UAAO,eACT;CACA,OAAO,kBAACF,EAAkB,UAAnB;EAAmC;EAAQ;CAAqC,CAAA;AACzF;AAGA,SAAgBG,IAAkD;CAChE,OAAOC,EAAWJ,CAAiB;AACrC"}
+{"version":3,"file":"viewInputs.js","names":[],"sources":["../../src/canvas/viewInputs.tsx"],"sourcesContent":["/**\n * What {@link useViewHelpers} needs that belongs to the surface rather than to\n * one view: the adapter, the geometry and the bounds resolver.\n *\n * These are read during a view's render, so they travel as context rather than\n * on the `SurfaceHandle`, which is not attached until an effect runs.\n */\nimport type { ResizeHandleLayout } from 'interactions/actions/resize/cornerHandles';\nimport { createContext, useContext, type ReactNode } from 'react';\nimport type { UseViewHelpersOpts } from './useViewHelpers';\nimport type { SelectionApi } from 'core/selection/useSelection';\nimport type { View } from 'core/viewport/view';\nimport type { Bounds } from 'core/viewport/fitViewToBounds';\nimport type { PlaneMap } from 'core/viewport/parallax';\nimport type { ChromeCaps } from 'features/chrome-caps/useChromeCaps';\nimport type { PickView } from './SceneCanvas/useSceneSelectTool';\n\nexport type { ViewRuleInputs } from 'features/chrome-caps/useChromeCaps';\n\n/**\n * @internal Provided by the surface, consumed by `<CanvasView>`.\n *\n * The scene-shaped half only. What a gesture is doing right now is read from\n * the asking view's own dispatcher, not from here.\n */\nexport interface SurfaceViewInputs\n  extends Pick<UseViewHelpersOpts<unknown>, 'adapter' | 'geometry'> {\n  /** A node's box for chrome, drawn under `view` — the camera of the view\n   *  asking, since a node on a parallax plane lands somewhere else in each. */\n  boundsOf: ((id: string, view?: View | null) => Bounds | null) | undefined;\n  /** How `view`'s world maps into the parallax plane `id` is drawn through,\n   *  or null when its layer moves with the camera. */\n  planeOfNode?: ((id: string, view?: View | null) => PlaneMap | null) | undefined;\n  /** `boundsOf` for `id` drawn at an in-flight `pose`, under `view`. */\n  boundsOfPose?: ((id: string, pose: unknown, view?: View | null) => Bounds | null) | undefined;\n  /** Every id under a world point, bottom-first. `view` is the view the\n   *  point was produced under — a screen-pixel tolerance cannot be converted\n   *  without its scale, nor a layer judged without its paint, and the world\n   *  point carries neither. */\n  pickEvery?: (worldX: number, worldY: number, view?: PickView | null) => string[];\n  /** The one id a click resolves to, collapsing parent/child the way the\n   *  select tool does. Falls back to `pickEvery`'s last when absent. */\n  pickBest?: (worldX: number, worldY: number, view?: PickView | null) => string | null;\n  /** A hit node's routing-trait kind, so `target: 'kind:text'` bindings match. */\n  kindOfNode?: (id: string) => string | undefined;\n  /** The node a double-click on a hit names (`doubleClickTarget`). */\n  doubleClickNames?: ((hitId: string) => string) | undefined;\n  /** The surface's chrome-caps rule table, evaluated against a view's own\n   *  context. */\n  chromeCaps?: ChromeCaps;\n  /** The surface's selection, which a view shares unless it was given one of\n   *  its own. */\n  selectionApi: SelectionApi;\n  /** The rotate badge the surface's selection overlay paints, which every\n   *  view drawing that overlay has to make grabbable where it is drawn. */\n  rotationBadge?: { distancePx: number; sizePx: number } | null;\n  /** The surface's resize-handle layout — which handles exist and their hit\n   *  radius — so every view grabs exactly the handles the overlay paints. */\n  resizeHandles?: ResizeHandleLayout;\n}\n\nconst ViewInputsContext = createContext<SurfaceViewInputs | null>(null);\n\n/** @internal */\nexport function ViewInputsProvider(\n  { value, children }: { value: SurfaceViewInputs; children: ReactNode },\n) {\n  return <ViewInputsContext.Provider value={value}>{children}</ViewInputsContext.Provider>;\n}\n\n/** The hosting surface's view-helper inputs, or `null` outside one. */\nexport function useOptionalViewInputs(): SurfaceViewInputs | null {\n  return useContext(ViewInputsContext);\n}\n"],"mappings":";;;;AA6DA,IAAM,oBAAoB,cAAwC,IAAI;;AAGtE,SAAgB,mBACd,EAAE,OAAO,YACT;CACA,OAAO,oBAAC,kBAAkB,UAAnB;EAAmC;EAAQ;CAAqC,CAAA;AACzF;;AAGA,SAAgB,wBAAkD;CAChE,OAAO,WAAW,iBAAiB;AACrC"}

package/dist/canvas/viewRegistry.js

@@ -1,51 +1,157 @@
-import { createViewResolver as e } from "../features/viewports/viewResolver.js";
-import { createContext as t, useContext as n, useMemo as r, useRef as i } from "react";
-import { createEmitter as a } from "@weasel-js/registry";
-import { jsx as o } from "react/jsx-runtime";
+import { createViewResolver, viewContains } from "../features/viewports/viewResolver.js";
+import { createEmitter } from "@weasel-js/registry";
+import { createContext, useContext, useMemo, useRef } from "react";
+import { jsx } from "react/jsx-runtime";
+
 //#region src/canvas/viewRegistry.tsx
-var s = t(null);
-function c({ children: t }) {
-	let n = i(/* @__PURE__ */ new Map()), c = i(0), l = i(0), f = i(null), p = r(() => {
-		let t = a(), r = () => {
-			l.current++, t.emit();
-		}, i = () => [...n.current.keys()].sort((e, t) => e.order - t.order || n.current.get(e) - n.current.get(t));
+/**
+* The seam between a canvas surface and the views drawn on it.
+*
+* Traffic runs both ways: the surface attaches a handle onto its frame and its
+* layer stack, and each view registers what it contributes back — the viewport
+* node it paints into and the record the gesture dispatcher routes its events
+* to. Both sides are thunks, read at draw and dispatch time, so neither can
+* serve the other a frame that has already moved.
+*/
+/**
+* A client point in the surface's CSS pixels, from its top-left: the surface's
+* own world point put back through its camera, so a `clientToWorld` override
+* reaches every view declared on it.
+*
+* @internal
+*/
+function surfaceLocal(surface, clientX, clientY) {
+	if (!surface) return {
+		x: clientX,
+		y: clientY
+	};
+	const [worldX, worldY] = surface.clientToWorld(clientX, clientY);
+	const view = surface.view();
+	return {
+		x: (worldX - view.x) * view.scale.x,
+		y: (worldY - view.y) * view.scale.y
+	};
+}
+var ViewRegistryContext = createContext(null);
+/** Mounts the registry for one surface. `<SceneCanvas>` mounts one; a view
+*  declaring itself as a child must be inside it. */
+function ViewRegistryProvider({ children }) {
+	const entriesRef = useRef(/* @__PURE__ */ new Map());
+	const seqRef = useRef(0);
+	const versionRef = useRef(0);
+	const surfaceRef = useRef(null);
+	const registry = useMemo(() => {
+		const listeners = createEmitter();
+		const changed = () => {
+			versionRef.current++;
+			listeners.emit();
+		};
+		const ordered = () => nestedOrder([...entriesRef.current.keys()].sort((a, b) => a.order - b.order || entriesRef.current.get(a) - entriesRef.current.get(b)));
+		const get = (id) => {
+			for (const r of entriesRef.current.keys()) if (r.id === id) return r;
+		};
+		/** Whether `r` is `id` or nested in it, however deep. */
+		const within = (r, id) => {
+			const seen = /* @__PURE__ */ new Set();
+			for (let at = r; at && !seen.has(at); at = at.parent === void 0 ? void 0 : get(at.parent)) {
+				if (at.id === id) return true;
+				seen.add(at);
+			}
+			return false;
+		};
 		return {
-			resolver: e({
+			resolver: createViewResolver({
 				views: () => {
-					let e = f.current, t = e?.view() ?? d, n = e?.dims() ?? u;
-					return i().filter((e) => e.interactive).map((e) => e.layer.resolvable(t, n));
-				},
-				root: () => f.current?.view() ?? d,
-				canvasOrigin: () => f.current?.origin() ?? {
-					left: 0,
-					top: 0
+					const surface = surfaceRef.current;
+					const view = surface?.view() ?? IDENTITY_VIEW;
+					const dims = surface?.dims() ?? UNMEASURED_DIMS;
+					return ordered().filter((r) => r.interactive).map((r) => r.layer.resolvable(view, dims));
 				},
-				occluded: (e, t) => f.current?.claimsAbove(e, t) ?? !1
+				root: () => surfaceRef.current?.view() ?? IDENTITY_VIEW,
+				toLocal: (clientX, clientY) => surfaceLocal(surfaceRef.current, clientX, clientY),
+				occluded: (x, y) => surfaceRef.current?.claimsAbove(x, y) ?? false
 			}),
-			register: (e) => (n.current.set(e, c.current++), r(), () => {
-				n.current.delete(e), r();
-			}),
-			list: i,
-			getVersion: () => l.current,
-			subscribe: t.subscribe,
-			surface: () => f.current,
-			attachSurface: (e) => (f.current = e, () => {
-				f.current === e && (f.current = null);
-			})
+			register: (reg) => {
+				entriesRef.current.set(reg, seqRef.current++);
+				changed();
+				return () => {
+					entriesRef.current.delete(reg);
+					changed();
+				};
+			},
+			list: ordered,
+			get,
+			viewAt: ({ x, y }, opts) => {
+				const surface = surfaceRef.current;
+				const view = surface?.view() ?? IDENTITY_VIEW;
+				const dims = surface?.dims() ?? UNMEASURED_DIMS;
+				const except = opts?.except;
+				const list = ordered();
+				for (let i = list.length - 1; i >= 0; i--) {
+					const r = list[i];
+					if (except !== void 0 && within(r, except)) continue;
+					const v = r.layer.resolvable(view, dims);
+					if (viewContains(v, x, y)) return {
+						id: v.id,
+						view: v.view,
+						rect: v.rect
+					};
+				}
+				return {
+					id: null,
+					view,
+					rect: {
+						x: 0,
+						y: 0,
+						w: dims.width,
+						h: dims.height
+					}
+				};
+			},
+			getVersion: () => versionRef.current,
+			subscribe: listeners.subscribe,
+			surface: () => surfaceRef.current,
+			attachSurface: (handle) => {
+				surfaceRef.current = handle;
+				return () => {
+					if (surfaceRef.current === handle) surfaceRef.current = null;
+				};
+			}
 		};
 	}, []);
-	return /* @__PURE__ */ o(s.Provider, {
-		value: p,
-		children: t
+	return /* @__PURE__ */ jsx(ViewRegistryContext.Provider, {
+		value: registry,
+		children
 	});
 }
-function l() {
-	return n(s);
+/** The surface's view registry, or `null` outside one. */
+function useOptionalViewRegistry() {
+	return useContext(ViewRegistryContext);
+}
+/** Each view followed by the views nested in it, in the order given. A view
+*  whose parent is not registered keeps its place; one caught in a cycle
+*  goes last. */
+function nestedOrder(sorted) {
+	const ids = new Set(sorted.map((r) => r.id));
+	const out = [];
+	const placed = /* @__PURE__ */ new Set();
+	const place = (r) => {
+		if (placed.has(r)) return;
+		placed.add(r);
+		out.push(r);
+		for (const child of sorted) if (child.parent === r.id) place(child);
+	};
+	for (const r of sorted) if (r.parent === void 0 || !ids.has(r.parent)) place(r);
+	for (const r of sorted) place(r);
+	return out;
 }
-var u = {
+/** The `Dims` a surface reports before it has measured itself. */
+var UNMEASURED_DIMS = {
 	width: 0,
 	height: 0
-}, d = {
+};
+/** The camera a view resolves against before its surface attaches. */
+var IDENTITY_VIEW = {
 	x: 0,
 	y: 0,
 	scale: {
@@ -53,7 +159,7 @@ var u = {
 		y: 1
 	}
 };
-//#endregion
-export { d as IDENTITY_VIEW, u as UNMEASURED_DIMS, c as ViewRegistryProvider, l as useOptionalViewRegistry };
 
+//#endregion
+export { IDENTITY_VIEW, UNMEASURED_DIMS, ViewRegistryProvider, surfaceLocal, useOptionalViewRegistry };
 //# sourceMappingURL=viewRegistry.js.map

package/dist/canvas/viewRegistry.js.map

@@ -1 +1 @@
-{"version":3,"file":"viewRegistry.js","names":["ViewRegistryContext","createContext","ViewRegistryProvider","entriesRef","useRef","seqRef","versionRef","surfaceRef","registry","useMemo","listeners","createEmitter","changed","ordered","a","b","createViewResolver","surface","view","IDENTITY_VIEW","dims","UNMEASURED_DIMS","r","x","y","reg","handle","useOptionalViewRegistry","useContext"],"sources":["../../src/canvas/viewRegistry.tsx"],"sourcesContent":["/**\n * The seam between a canvas surface and the views drawn on it.\n *\n * Traffic runs both ways: the surface attaches a handle onto its frame and its\n * layer stack, and each view registers what it contributes back — the viewport\n * node it paints into and the record the gesture dispatcher routes its events\n * to. Both sides are thunks, read at draw and dispatch time, so neither can\n * serve the other a frame that has already moved.\n */\nimport { createContext, useContext, useMemo, useRef, type ReactNode } from 'react';\nimport type { Dims, RenderLayer } from 'core/layers/render';\nimport type { LayerHit } from 'affordances/types';\nimport type { ChromeState } from 'core/selection/chromeState';\nimport type { View } from 'core/viewport/view';\nimport type { ViewportLayer } from 'features/viewports/viewportLayer';\nimport type { DispatcherViewTarget } from '@weasel-js/routing/internal';\nimport { createViewResolver, type ViewResolver } from 'features/viewports/viewResolver';\nimport { createEmitter } from '@weasel-js/registry';\n\n/**\n * What a view needs from the surface hosting it.\n *\n * @internal Attached by the surface, read by `<CanvasView>`.\n */\nexport interface SurfaceHandle {\n  /** Client-space origin of the canvas element. A rect fact: it knows nothing\n   *  of a `clientToWorld` override, so convert with {@link clientToWorld}. */\n  origin(): { left: number; top: number };\n  /** A client point in the surface's own world — the conversion the surface\n   *  itself makes, its `clientToWorld` override included. */\n  clientToWorld(clientX: number, clientY: number): [number, number];\n  /** The outer camera. */\n  view(): View;\n  /** The canvas's CSS-pixel size. */\n  dims(): Dims;\n  /** The stack a view paints through its own camera, unless it narrows it. */\n  layers(): readonly RenderLayer<unknown>[];\n  requestRedraw(): void;\n  /** The canvas's own view chrome — its selection, its overlay-aware bounds.\n   *  What a `<CanvasView>` answers for itself, answered for view zero. */\n  chromeState(): ChromeState;\n  /** Hit-test the externally registered layers at a world point, against the\n   *  frame and draw envelope of whichever view is asking. The public\n   *  `hitTestExtras` is this with the canvas's own frame and envelope. */\n  hitTestExtras(\n    worldX: number,\n    worldY: number,\n    view: View,\n    dims: Dims,\n    data: unknown,\n    /** Consider only these layers — the ones the asking view paints. A layer\n     *  asked on a frame it was not drawn in answers for the wrong pixels. */\n    only?: readonly RenderLayer<unknown>[],\n  ): { layerId: string; hit: LayerHit } | null;\n  /** Whether a registered layer claims a canvas-local point on the surface's\n   *  own frame. Registered layers paint over every view, so such a point is\n   *  theirs even inside a view's rect. */\n  claimsAbove(x: number, y: number): boolean;\n}\n\n/**\n * What one view contributes to the surface hosting it.\n *\n * @internal Written by `<CanvasView>`, read by the surface. Consumers declare\n *   a view, not a registration.\n */\nexport interface ViewRegistration {\n  id: string;\n  /**\n   * Paint and hit order, low to high. Views declared as props take their array\n   * index; a view mounted as a child takes `Infinity`, so it lands after them\n   * however React happens to order the mount effects.\n   */\n  order: number;\n  /** The viewport node this view paints into. Its `resolvable` is what routes\n   *  input here. */\n  layer: ViewportLayer<unknown>;\n  /** `false` keeps input over the view on the canvas beneath it. */\n  interactive: boolean;\n  /** `false` leaves `layer` for a host to draw — a HUD window's interior — so\n   *  the surface does not paint it too. */\n  paint: boolean;\n  /** Everything about dispatching to this view except its id. */\n  target: Omit<DispatcherViewTarget, 'id'>;\n  /** Whether a scene layer reaches the screen in this view. For input that\n   *  reaches a view without a dispatch — hover — so it judges this view's\n   *  paint rather than the surface's. */\n  layerIsPainted(layerId: string): boolean;\n}\n\n/** @internal */\nexport interface ViewRegistry {\n  /** Returns an unregister. */\n  register(reg: ViewRegistration): () => void;\n  /** Live registrations in paint order. */\n  list(): readonly ViewRegistration[];\n  /** Bumped whenever the list changes. Pair with {@link ViewRegistry.subscribe}\n   *  for `useSyncExternalStore`. */\n  getVersion(): number;\n  subscribe(fn: () => void): () => void;\n  /** Which view a client point belongs to, sticky for a captured pointer.\n   *  One per surface: every caller that routes input — the dispatcher, pinch,\n   *  hover — must agree about where a point landed. */\n  readonly resolver: ViewResolver;\n  /** The hosting surface, or `null` before one attaches. */\n  surface(): SurfaceHandle | null;\n  /** Returns a detach, which leaves a handle attached since alone. */\n  attachSurface(handle: SurfaceHandle): () => void;\n}\n\nconst ViewRegistryContext = createContext<ViewRegistry | null>(null);\n\n/** Mounts the registry for one surface. `<SceneCanvas>` mounts one; a view\n *  declaring itself as a child must be inside it. */\nexport function ViewRegistryProvider({ children }: { children: ReactNode }) {\n  const entriesRef = useRef(new Map<ViewRegistration, number>());\n  const seqRef = useRef(0);\n  const versionRef = useRef(0);\n  const surfaceRef = useRef<SurfaceHandle | null>(null);\n\n  const registry = useMemo<ViewRegistry>(() => {\n    const listeners = createEmitter();\n    const changed = (): void => {\n      versionRef.current++;\n      listeners.emit();\n    };\n    const ordered = (): ViewRegistration[] => [...entriesRef.current.keys()].sort((a, b) => (\n      a.order - b.order || entriesRef.current.get(a)! - entriesRef.current.get(b)!\n    ));\n    const resolver = createViewResolver({\n      views: () => {\n        const surface = surfaceRef.current;\n        const view = surface?.view() ?? IDENTITY_VIEW;\n        const dims = surface?.dims() ?? UNMEASURED_DIMS;\n        return ordered().filter((r) => r.interactive).map((r) => r.layer.resolvable(view, dims));\n      },\n      root: () => surfaceRef.current?.view() ?? IDENTITY_VIEW,\n      canvasOrigin: () => surfaceRef.current?.origin() ?? { left: 0, top: 0 },\n      occluded: (x, y) => surfaceRef.current?.claimsAbove(x, y) ?? false,\n    });\n    return {\n      resolver,\n      register: (reg) => {\n        entriesRef.current.set(reg, seqRef.current++);\n        changed();\n        return () => { entriesRef.current.delete(reg); changed(); };\n      },\n      list: ordered,\n      getVersion: () => versionRef.current,\n      subscribe: listeners.subscribe,\n      surface: () => surfaceRef.current,\n      attachSurface: (handle) => {\n        surfaceRef.current = handle;\n        return () => { if (surfaceRef.current === handle) surfaceRef.current = null; };\n      },\n    };\n  }, []);\n\n  return <ViewRegistryContext.Provider value={registry}>{children}</ViewRegistryContext.Provider>;\n}\n\n/** The surface's view registry, or `null` outside one. */\nexport function useOptionalViewRegistry(): ViewRegistry | null {\n  return useContext(ViewRegistryContext);\n}\n\n/** The `Dims` a surface reports before it has measured itself. */\nexport const UNMEASURED_DIMS: Dims = { width: 0, height: 0 };\n\n/** The camera a view resolves against before its surface attaches. */\nexport const IDENTITY_VIEW: View = { x: 0, y: 0, scale: { x: 1, y: 1 } };\n"],"mappings":";;;;;AA8GA,IAAMA,IAAsBC,EAAmC,IAAI;AAInE,SAAgBC,EAAqB,EAAE,eAAqC;CAC1E,IAAMC,IAAaC,kBAAO,IAAI,IAA8B,CAAC,GACvDC,IAASD,EAAO,CAAC,GACjBE,IAAaF,EAAO,CAAC,GACrBG,IAAaH,EAA6B,IAAI,GAE9CI,IAAWC,QAA4B;EAC3C,IAAMC,IAAYC,EAAc,GAC1BC,UAAsB;GAE1B,AADA,EAAW,WACXF,EAAU,KAAK;EACjB,GACMG,UAAoC,CAAC,GAAGV,EAAW,QAAQ,KAAK,CAAC,CAAC,CAAC,MAAM,GAAG,MAChFW,EAAE,QAAQC,EAAE,SAASZ,EAAW,QAAQ,IAAIW,CAAC,IAAKX,EAAW,QAAQ,IAAIY,CAAC,CAC3E;EAYD,OAAO;GACL,UAZeC,EAAmB;IAClC,aAAa;KACX,IAAMC,IAAUV,EAAW,SACrBW,IAAOD,GAAS,KAAK,KAAKE,GAC1BC,IAAOH,GAAS,KAAK,KAAKI;KAChC,OAAOR,EAAQ,CAAC,CAAC,QAAQ,MAAMS,EAAE,WAAW,CAAC,CAAC,KAAK,MAAMA,EAAE,MAAM,WAAWJ,GAAME,CAAI,CAAC;IACzF;IACA,YAAYb,EAAW,SAAS,KAAK,KAAKY;IAC1C,oBAAoBZ,EAAW,SAAS,OAAO,KAAK;KAAE,MAAM;KAAG,KAAK;IAAE;IACtE,WAAW,GAAG,MAAMA,EAAW,SAAS,YAAYgB,GAAGC,CAAC,KAAK;GAC/D,CAEE;GACA,WAAW,OACTrB,EAAW,QAAQ,IAAIsB,GAAK,EAAO,SAAS,GAC5Cb,EAAQ,SACK;IAAkC,AAAhCT,EAAW,QAAQ,OAAOsB,CAAG,GAAGb,EAAQ;GAAG;GAE5D,MAAMC;GACN,kBAAkBP,EAAW;GAC7B,WAAWI,EAAU;GACrB,eAAeH,EAAW;GAC1B,gBAAgB,OACd,EAAW,UAAUmB,SACR;IAAE,AAAInB,EAAW,YAAYmB,MAAQ,EAAW,UAAU;GAAM;EAEjF;CACF,GAAG,CAAC,CAAC;CAEL,OAAO,kBAAC1B,EAAoB,UAArB;EAA8B,OAAOQ;EAAW;CAAuC,CAAA;AAChG;AAGA,SAAgBmB,IAA+C;CAC7D,OAAOC,EAAW5B,CAAmB;AACvC;AAGA,IAAaqB,IAAwB;CAAE,OAAO;CAAG,QAAQ;AAAE,GAG9CF,IAAsB;CAAE,GAAG;CAAG,GAAG;CAAG,OAAO;EAAE,GAAG;EAAG,GAAG;CAAE;AAAE"}
+{"version":3,"file":"viewRegistry.js","names":[],"sources":["../../src/canvas/viewRegistry.tsx"],"sourcesContent":["/**\n * The seam between a canvas surface and the views drawn on it.\n *\n * Traffic runs both ways: the surface attaches a handle onto its frame and its\n * layer stack, and each view registers what it contributes back — the viewport\n * node it paints into and the record the gesture dispatcher routes its events\n * to. Both sides are thunks, read at draw and dispatch time, so neither can\n * serve the other a frame that has already moved.\n */\nimport { createContext, useContext, useMemo, useRef, type ReactNode } from 'react';\nimport type { Dims, RenderLayer } from 'core/layers/render';\nimport type { LayerHit } from 'affordances/types';\nimport type { ChromeState } from 'core/selection/chromeState';\nimport type { View } from 'core/viewport/view';\nimport type { ViewportLayer } from 'features/viewports/viewportLayer';\nimport type { DispatcherViewTarget } from '@weasel-js/routing/internal';\nimport { createViewResolver, viewContains, type ViewResolver } from 'features/viewports/viewResolver';\nimport { createEmitter } from '@weasel-js/registry';\nimport type { ViewAt } from './canvasExtension';\n\n/**\n * What a view needs from the surface hosting it.\n *\n * @internal Attached by the surface, read by `<CanvasView>`.\n */\nexport interface SurfaceHandle {\n  /** A client point in the surface's own world — the conversion the surface\n   *  itself makes, its `clientToWorld` override included. */\n  clientToWorld(clientX: number, clientY: number): [number, number];\n  /** The outer camera. */\n  view(): View;\n  /** The canvas's CSS-pixel size. */\n  dims(): Dims;\n  /** The stack a view paints through its own camera, unless it narrows it. */\n  layers(): readonly RenderLayer<unknown>[];\n  requestRedraw(): void;\n  /** The canvas's own view chrome — its selection, its overlay-aware bounds.\n   *  What a `<CanvasView>` answers for itself, answered for view zero. */\n  chromeState(): ChromeState;\n  /** Hit-test the externally registered layers at a world point, against the\n   *  frame and draw envelope of whichever view is asking. The public\n   *  `hitTestExtras` is this with the canvas's own frame and envelope. */\n  hitTestExtras(\n    worldX: number,\n    worldY: number,\n    view: View,\n    dims: Dims,\n    data: unknown,\n    /** Consider only these layers — the ones the asking view paints. A layer\n     *  asked on a frame it was not drawn in answers for the wrong pixels. */\n    only?: readonly RenderLayer<unknown>[],\n  ): { layerId: string; hit: LayerHit } | null;\n  /** Whether a registered layer claims a canvas-local point on the surface's\n   *  own frame. Registered layers paint over every view, so such a point is\n   *  theirs even inside a view's rect. */\n  claimsAbove(x: number, y: number): boolean;\n}\n\n/**\n * A client point in the surface's CSS pixels, from its top-left: the surface's\n * own world point put back through its camera, so a `clientToWorld` override\n * reaches every view declared on it.\n *\n * @internal\n */\nexport function surfaceLocal(\n  surface: Pick<SurfaceHandle, 'clientToWorld' | 'view'> | null,\n  clientX: number,\n  clientY: number,\n): { x: number; y: number } {\n  if (!surface) return { x: clientX, y: clientY };\n  const [worldX, worldY] = surface.clientToWorld(clientX, clientY);\n  const view = surface.view();\n  return { x: (worldX - view.x) * view.scale.x, y: (worldY - view.y) * view.scale.y };\n}\n\n/**\n * What one view contributes to the surface hosting it.\n *\n * @internal Written by `<CanvasView>`, read by the surface. Consumers declare\n *   a view, not a registration.\n */\nexport interface ViewRegistration {\n  id: string;\n  /** The view this one is nested in: listed, painted and hit after it, and\n   *  its `layer` measures itself from that view's rect and camera. */\n  parent?: string;\n  /**\n   * Paint and hit order, low to high. Views declared as props take their array\n   * index; a view mounted as a child takes `Infinity`, so it lands after them\n   * however React happens to order the mount effects.\n   */\n  order: number;\n  /** The viewport node this view paints into. Its `resolvable` is what routes\n   *  input here. */\n  layer: ViewportLayer<unknown>;\n  /** `false` keeps input over the view on the canvas beneath it. */\n  interactive: boolean;\n  /** `false` leaves `layer` for a host to draw — a HUD window's interior — so\n   *  the surface does not paint it too. */\n  paint: boolean;\n  /** Everything about dispatching to this view except its id. */\n  target: Omit<DispatcherViewTarget, 'id'>;\n  /** Whether a scene layer reaches the screen in this view. For input that\n   *  reaches a view without a dispatch — hover — so it judges this view's\n   *  paint rather than the surface's. */\n  layerIsPainted(layerId: string): boolean;\n  /** The layers this view draws, in order — what a view nested in it paints\n   *  from. */\n  drawnLayers(): readonly RenderLayer<unknown>[];\n}\n\n\n/** @internal */\nexport interface ViewRegistry {\n  /** Returns an unregister. */\n  register(reg: ViewRegistration): () => void;\n  /** Live registrations in paint order, each nested view after the view it\n   *  is nested in. */\n  list(): readonly ViewRegistration[];\n  /** The live registration with `id`, if any. */\n  get(id: string): ViewRegistration | undefined;\n  /** The innermost view painted under a canvas-local point, whether or not it\n   *  takes input, passing over `except` and the views nested in it. */\n  viewAt(at: { x: number; y: number }, opts?: { except?: string }): ViewAt;\n  /** Bumped whenever the list changes. Pair with {@link ViewRegistry.subscribe}\n   *  for `useSyncExternalStore`. */\n  getVersion(): number;\n  subscribe(fn: () => void): () => void;\n  /** Which view a client point belongs to, sticky for a captured pointer.\n   *  One per surface: every caller that routes input — the dispatcher, pinch,\n   *  hover — must agree about where a point landed. */\n  readonly resolver: ViewResolver;\n  /** The hosting surface, or `null` before one attaches. */\n  surface(): SurfaceHandle | null;\n  /** Returns a detach, which leaves a handle attached since alone. */\n  attachSurface(handle: SurfaceHandle): () => void;\n}\n\nconst ViewRegistryContext = createContext<ViewRegistry | null>(null);\n\n/** Mounts the registry for one surface. `<SceneCanvas>` mounts one; a view\n *  declaring itself as a child must be inside it. */\nexport function ViewRegistryProvider({ children }: { children: ReactNode }) {\n  const entriesRef = useRef(new Map<ViewRegistration, number>());\n  const seqRef = useRef(0);\n  const versionRef = useRef(0);\n  const surfaceRef = useRef<SurfaceHandle | null>(null);\n\n  const registry = useMemo<ViewRegistry>(() => {\n    const listeners = createEmitter();\n    const changed = (): void => {\n      versionRef.current++;\n      listeners.emit();\n    };\n    const ordered = (): ViewRegistration[] => nestedOrder([...entriesRef.current.keys()].sort((a, b) => (\n      a.order - b.order || entriesRef.current.get(a)! - entriesRef.current.get(b)!\n    )));\n    const get = (id: string): ViewRegistration | undefined => {\n      for (const r of entriesRef.current.keys()) if (r.id === id) return r;\n      return undefined;\n    };\n    /** Whether `r` is `id` or nested in it, however deep. */\n    const within = (r: ViewRegistration, id: string): boolean => {\n      const seen = new Set<ViewRegistration>();\n      for (let at: ViewRegistration | undefined = r; at && !seen.has(at); at = at.parent === undefined ? undefined : get(at.parent)) {\n        if (at.id === id) return true;\n        seen.add(at);\n      }\n      return false;\n    };\n    const resolver = createViewResolver({\n      views: () => {\n        const surface = surfaceRef.current;\n        const view = surface?.view() ?? IDENTITY_VIEW;\n        const dims = surface?.dims() ?? UNMEASURED_DIMS;\n        return ordered().filter((r) => r.interactive).map((r) => r.layer.resolvable(view, dims));\n      },\n      root: () => surfaceRef.current?.view() ?? IDENTITY_VIEW,\n      toLocal: (clientX, clientY) => surfaceLocal(surfaceRef.current, clientX, clientY),\n      occluded: (x, y) => surfaceRef.current?.claimsAbove(x, y) ?? false,\n    });\n    return {\n      resolver,\n      register: (reg) => {\n        entriesRef.current.set(reg, seqRef.current++);\n        changed();\n        return () => { entriesRef.current.delete(reg); changed(); };\n      },\n      list: ordered,\n      get,\n      viewAt: ({ x, y }, opts) => {\n        const surface = surfaceRef.current;\n        const view = surface?.view() ?? IDENTITY_VIEW;\n        const dims = surface?.dims() ?? UNMEASURED_DIMS;\n        const except = opts?.except;\n        const list = ordered();\n        for (let i = list.length - 1; i >= 0; i--) {\n          const r = list[i]!;\n          if (except !== undefined && within(r, except)) continue;\n          const v = r.layer.resolvable(view, dims);\n          if (viewContains(v, x, y)) return { id: v.id, view: v.view, rect: v.rect };\n        }\n        return { id: null, view, rect: { x: 0, y: 0, w: dims.width, h: dims.height } };\n      },\n      getVersion: () => versionRef.current,\n      subscribe: listeners.subscribe,\n      surface: () => surfaceRef.current,\n      attachSurface: (handle) => {\n        surfaceRef.current = handle;\n        return () => { if (surfaceRef.current === handle) surfaceRef.current = null; };\n      },\n    };\n  }, []);\n\n  return <ViewRegistryContext.Provider value={registry}>{children}</ViewRegistryContext.Provider>;\n}\n\n/** The surface's view registry, or `null` outside one. */\nexport function useOptionalViewRegistry(): ViewRegistry | null {\n  return useContext(ViewRegistryContext);\n}\n\n/** Each view followed by the views nested in it, in the order given. A view\n *  whose parent is not registered keeps its place; one caught in a cycle\n *  goes last. */\nfunction nestedOrder(sorted: readonly ViewRegistration[]): ViewRegistration[] {\n  const ids = new Set(sorted.map((r) => r.id));\n  const out: ViewRegistration[] = [];\n  const placed = new Set<ViewRegistration>();\n  const place = (r: ViewRegistration): void => {\n    if (placed.has(r)) return;\n    placed.add(r);\n    out.push(r);\n    for (const child of sorted) if (child.parent === r.id) place(child);\n  };\n  for (const r of sorted) if (r.parent === undefined || !ids.has(r.parent)) place(r);\n  for (const r of sorted) place(r);\n  return out;\n}\n\n/** The `Dims` a surface reports before it has measured itself. */\nexport const UNMEASURED_DIMS: Dims = { width: 0, height: 0 };\n\n/** The camera a view resolves against before its surface attaches. */\nexport const IDENTITY_VIEW: View = { x: 0, y: 0, scale: { x: 1, y: 1 } };\n"],"mappings":"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"}

package/dist/canvas/watchElementMove.js

@@ -1,43 +1,81 @@
 //#region src/canvas/watchElementMove.ts
-function e(e, t) {
-	if (typeof IntersectionObserver > "u") return () => {};
-	let n = e.ownerDocument.documentElement, r = null, i = null, a, o = () => {
-		clearTimeout(a), r?.disconnect(), r = null, i?.disconnect(), i = null;
-	}, s = () => {
-		typeof ResizeObserver < "u" && (i = new ResizeObserver(() => {
-			let n = e.getBoundingClientRect();
-			n.width !== 0 && n.height !== 0 && (t(), c(1));
-		}), i.observe(e));
-	}, c = (i) => {
-		o();
-		let l = e.getBoundingClientRect();
-		if (l.width === 0 || l.height === 0) {
-			s();
+/**
+* Call `onMove` when `element`'s box moves in the viewport for a reason no
+* event reports: a sibling collapsing, content loading above it. A scroll or a
+* resize of the element may also call it; a caller already listening for those
+* hears a second, harmless report. Returns the function that stops watching.
+*
+* There is no observer for position, so this frames the element's current box
+* with an `IntersectionObserver` whose root margin is that box exactly. Any move
+* changes how much of the element the frame holds, which the observer reports,
+* and the frame is then rebuilt around the new box.
+*
+* A frame only watches from its first report on, so that report is checked
+* against the box the frame was built around: a move in between is reported too.
+*/
+function watchElementMove(element, onMove) {
+	if (typeof IntersectionObserver === "undefined") return () => {};
+	const root = element.ownerDocument.documentElement;
+	let observer = null;
+	let sized = null;
+	let retry;
+	const stop = () => {
+		clearTimeout(retry);
+		observer?.disconnect();
+		observer = null;
+		sized?.disconnect();
+		sized = null;
+	};
+	/** A box with no area cannot be framed, so wait for it to have one. */
+	const awaitSize = () => {
+		if (typeof ResizeObserver === "undefined") return;
+		sized = new ResizeObserver(() => {
+			const box = element.getBoundingClientRect();
+			if (box.width === 0 || box.height === 0) return;
+			onMove();
+			frame(1);
+		});
+		sized.observe(element);
+	};
+	const frame = (threshold) => {
+		stop();
+		const box = element.getBoundingClientRect();
+		if (box.width === 0 || box.height === 0) {
+			awaitSize();
 			return;
 		}
-		let u = [
-			Math.floor(l.top),
-			Math.floor(n.clientWidth - l.right),
-			Math.floor(n.clientHeight - l.bottom),
-			Math.floor(l.left)
-		], d = (e) => Math.abs(e.left - l.left) > .5 || Math.abs(e.top - l.top) > .5 || Math.abs(e.width - l.width) > .5 || Math.abs(e.height - l.height) > .5, f = !0;
-		r = new IntersectionObserver((n) => {
-			let r = n[0].intersectionRatio;
-			if (f ? n.length > 1 || d(n[0].boundingClientRect) : r !== i) {
-				t(), c(1);
+		const insets = [
+			Math.floor(box.top),
+			Math.floor(root.clientWidth - box.right),
+			Math.floor(root.clientHeight - box.bottom),
+			Math.floor(box.left)
+		];
+		const movedTo = (now) => Math.abs(now.left - box.left) > .5 || Math.abs(now.top - box.top) > .5 || Math.abs(now.width - box.width) > .5 || Math.abs(now.height - box.height) > .5;
+		let first = true;
+		observer = new IntersectionObserver((entries) => {
+			const ratio = entries[0].intersectionRatio;
+			if (first ? entries.length > 1 || movedTo(entries[0].boundingClientRect) : ratio !== threshold) {
+				onMove();
+				frame(1);
 				return;
 			}
-			f = !1, r !== i && (r === 0 ? a = setTimeout(() => {
-				d(e.getBoundingClientRect()) && t(), c(1e-7);
-			}, 1e3) : c(r));
+			first = false;
+			if (ratio === threshold) return;
+			if (ratio !== 0) frame(ratio);
+			else retry = setTimeout(() => {
+				if (movedTo(element.getBoundingClientRect())) onMove();
+				frame(1e-7);
+			}, 1e3);
 		}, {
-			rootMargin: u.map((e) => `${-e}px`).join(" "),
-			threshold: Math.max(0, Math.min(1, i)) || 1
-		}), r.observe(e);
+			rootMargin: insets.map((inset) => `${-inset}px`).join(" "),
+			threshold: Math.max(0, Math.min(1, threshold)) || 1
+		});
+		observer.observe(element);
 	};
-	return c(1), o;
+	frame(1);
+	return stop;
 }
-//#endregion
-export { e as watchElementMove };
 
+//#endregion
+export { watchElementMove };
 //# sourceMappingURL=watchElementMove.js.map

package/dist/canvas/watchElementMove.js.map

@@ -1 +1 @@
-{"version":3,"file":"watchElementMove.js","names":["watchElementMove","root","element","observer","sized","retry","stop","awaitSize","box","onMove","frame","insets","movedTo","now","first","ratio","entries","threshold","inset"],"sources":["../../src/canvas/watchElementMove.ts"],"sourcesContent":["/**\n * Call `onMove` when `element`'s box moves in the viewport for a reason no\n * event reports: a sibling collapsing, content loading above it. A scroll or a\n * resize of the element may also call it; a caller already listening for those\n * hears a second, harmless report. Returns the function that stops watching.\n *\n * There is no observer for position, so this frames the element's current box\n * with an `IntersectionObserver` whose root margin is that box exactly. Any move\n * changes how much of the element the frame holds, which the observer reports,\n * and the frame is then rebuilt around the new box.\n *\n * A frame only watches from its first report on, so that report is checked\n * against the box the frame was built around: a move in between is reported too.\n */\nexport function watchElementMove(element: Element, onMove: () => void): () => void {\n  if (typeof IntersectionObserver === 'undefined') return () => {};\n  const root = element.ownerDocument.documentElement;\n  let observer: IntersectionObserver | null = null;\n  let sized: ResizeObserver | null = null;\n  let retry: ReturnType<typeof setTimeout> | undefined;\n\n  const stop = (): void => {\n    clearTimeout(retry);\n    observer?.disconnect();\n    observer = null;\n    sized?.disconnect();\n    sized = null;\n  };\n\n  /** A box with no area cannot be framed, so wait for it to have one. */\n  const awaitSize = (): void => {\n    if (typeof ResizeObserver === 'undefined') return;\n    sized = new ResizeObserver(() => {\n      const box = element.getBoundingClientRect();\n      if (box.width === 0 || box.height === 0) return;\n      onMove();\n      frame(1);\n    });\n    sized.observe(element);\n  };\n\n  const frame = (threshold: number): void => {\n    stop();\n    const box = element.getBoundingClientRect();\n    if (box.width === 0 || box.height === 0) {\n      awaitSize();\n      return;\n    }\n    const insets = [\n      Math.floor(box.top),\n      Math.floor(root.clientWidth - box.right),\n      Math.floor(root.clientHeight - box.bottom),\n      Math.floor(box.left),\n    ];\n    // Half a pixel of slack: two measurements that disagreed by rounding would report every\n    // frame, and the floored frame cannot see a move that small anyway.\n    const movedTo = (now: DOMRectReadOnly): boolean =>\n      Math.abs(now.left - box.left) > 0.5 || Math.abs(now.top - box.top) > 0.5\n      || Math.abs(now.width - box.width) > 0.5 || Math.abs(now.height - box.height) > 0.5;\n    let first = true;\n    observer = new IntersectionObserver(\n      (entries) => {\n        const ratio = entries[0].intersectionRatio;\n        const moved = first\n          ? entries.length > 1 || movedTo(entries[0].boundingClientRect)\n          : ratio !== threshold;\n        if (moved) {\n          onMove();\n          frame(1);\n          return;\n        }\n        first = false;\n        if (ratio === threshold) return;\n        // A box partly off the root never reaches the threshold asked for, so\n        // ask for what it does reach. One wholly off it reports zero for\n        // every frame, wherever it goes; look again once it may have come back.\n        if (ratio !== 0) frame(ratio);\n        else {\n          retry = setTimeout(() => {\n            if (movedTo(element.getBoundingClientRect())) onMove();\n            frame(1e-7);\n          }, 1000);\n        }\n      },\n      { rootMargin: insets.map((inset) => `${-inset}px`).join(' '), threshold: Math.max(0, Math.min(1, threshold)) || 1 },\n    );\n    observer.observe(element);\n  };\n\n  frame(1);\n  return stop;\n}\n"],"mappings":";AAcA,SAAgBA,EAAiB,GAAkB,GAAgC;CACjF,IAAI,OAAO,uBAAyB,KAAa,aAAa,CAAC;CAC/D,IAAMC,IAAOC,EAAQ,cAAc,iBAC/BC,IAAwC,MACxCC,IAA+B,MAC/BC,GAEEC,UAAmB;EAKvB,AAJA,aAAaD,CAAK,GAClBF,GAAU,WAAW,GACrB,IAAW,MACXC,GAAO,WAAW,GAClB,IAAQ;CACV,GAGMG,UAAwB;EAC5B,AAAI,OAAO,iBAAmB,QAC9B,IAAQ,IAAI,qBAAqB;GAC/B,IAAMC,IAAMN,EAAQ,sBAAsB;GAC1C,AAAIM,EAAI,UAAU,KAAKA,EAAI,WAAW,MACtCC,EAAO,GACPC,EAAM,CAAC;EACT,CAAC,GACDN,EAAM,QAAQF,CAAO;CACvB,GAEMQ,KAAS,MAA4B;EACzC,EAAK;EACL,IAAMF,IAAMN,EAAQ,sBAAsB;EAC1C,IAAIM,EAAI,UAAU,KAAKA,EAAI,WAAW,GAAG;GACvC,EAAU;GACV;EACF;EACA,IAAMG,IAAS;GACb,KAAK,MAAMH,EAAI,GAAG;GAClB,KAAK,MAAMP,EAAK,cAAcO,EAAI,KAAK;GACvC,KAAK,MAAMP,EAAK,eAAeO,EAAI,MAAM;GACzC,KAAK,MAAMA,EAAI,IAAI;EACrB,GAGMI,KAAW,MACf,KAAK,IAAIC,EAAI,OAAOL,EAAI,IAAI,IAAI,MAAO,KAAK,IAAIK,EAAI,MAAML,EAAI,GAAG,IAAI,MAClE,KAAK,IAAIK,EAAI,QAAQL,EAAI,KAAK,IAAI,MAAO,KAAK,IAAIK,EAAI,SAASL,EAAI,MAAM,IAAI,IAC9EM,IAAQ;EA2BZ,AA1BA,IAAW,IAAI,sBACZ,MAAY;GACX,IAAMC,IAAQC,EAAQ,EAAE,CAAC;GAIzB,IAHcF,IACVE,EAAQ,SAAS,KAAKJ,EAAQI,EAAQ,EAAE,CAAC,kBAAkB,IAC3DD,MAAUE,GACH;IAET,AADAR,EAAO,GACPC,EAAM,CAAC;IACP;GACF;GAEA,AADA,IAAQ,IACJK,MAAUE,MAIVF,MAAU,IAEZ,IAAQ,iBAAiB;IAEvB,AADIH,EAAQV,EAAQ,sBAAsB,CAAC,KAAGO,EAAO,GACrDC,EAAM,IAAI;GACZ,GAAG,GAAI,IALQA,EAAMK,CAAK;EAO9B,GACA;GAAE,YAAYJ,EAAO,KAAK,MAAU,GAAG,CAACO,EAAM,GAAG,CAAC,CAAC,KAAK,GAAG;GAAG,WAAW,KAAK,IAAI,GAAG,KAAK,IAAI,GAAGD,CAAS,CAAC,KAAK;EAAE,CACpH,GACAd,EAAS,QAAQD,CAAO;CAC1B;CAGA,OADAQ,EAAM,CAAC,GACAJ;AACT"}
+{"version":3,"file":"watchElementMove.js","names":[],"sources":["../../src/canvas/watchElementMove.ts"],"sourcesContent":["/**\n * Call `onMove` when `element`'s box moves in the viewport for a reason no\n * event reports: a sibling collapsing, content loading above it. A scroll or a\n * resize of the element may also call it; a caller already listening for those\n * hears a second, harmless report. Returns the function that stops watching.\n *\n * There is no observer for position, so this frames the element's current box\n * with an `IntersectionObserver` whose root margin is that box exactly. Any move\n * changes how much of the element the frame holds, which the observer reports,\n * and the frame is then rebuilt around the new box.\n *\n * A frame only watches from its first report on, so that report is checked\n * against the box the frame was built around: a move in between is reported too.\n */\nexport function watchElementMove(element: Element, onMove: () => void): () => void {\n  if (typeof IntersectionObserver === 'undefined') return () => {};\n  const root = element.ownerDocument.documentElement;\n  let observer: IntersectionObserver | null = null;\n  let sized: ResizeObserver | null = null;\n  let retry: ReturnType<typeof setTimeout> | undefined;\n\n  const stop = (): void => {\n    clearTimeout(retry);\n    observer?.disconnect();\n    observer = null;\n    sized?.disconnect();\n    sized = null;\n  };\n\n  /** A box with no area cannot be framed, so wait for it to have one. */\n  const awaitSize = (): void => {\n    if (typeof ResizeObserver === 'undefined') return;\n    sized = new ResizeObserver(() => {\n      const box = element.getBoundingClientRect();\n      if (box.width === 0 || box.height === 0) return;\n      onMove();\n      frame(1);\n    });\n    sized.observe(element);\n  };\n\n  const frame = (threshold: number): void => {\n    stop();\n    const box = element.getBoundingClientRect();\n    if (box.width === 0 || box.height === 0) {\n      awaitSize();\n      return;\n    }\n    const insets = [\n      Math.floor(box.top),\n      Math.floor(root.clientWidth - box.right),\n      Math.floor(root.clientHeight - box.bottom),\n      Math.floor(box.left),\n    ];\n    // Half a pixel of slack: two measurements that disagreed by rounding would report every\n    // frame, and the floored frame cannot see a move that small anyway.\n    const movedTo = (now: DOMRectReadOnly): boolean =>\n      Math.abs(now.left - box.left) > 0.5 || Math.abs(now.top - box.top) > 0.5\n      || Math.abs(now.width - box.width) > 0.5 || Math.abs(now.height - box.height) > 0.5;\n    let first = true;\n    observer = new IntersectionObserver(\n      (entries) => {\n        const ratio = entries[0].intersectionRatio;\n        const moved = first\n          ? entries.length > 1 || movedTo(entries[0].boundingClientRect)\n          : ratio !== threshold;\n        if (moved) {\n          onMove();\n          frame(1);\n          return;\n        }\n        first = false;\n        if (ratio === threshold) return;\n        // A box partly off the root never reaches the threshold asked for, so\n        // ask for what it does reach. One wholly off it reports zero for\n        // every frame, wherever it goes; look again once it may have come back.\n        if (ratio !== 0) frame(ratio);\n        else {\n          retry = setTimeout(() => {\n            if (movedTo(element.getBoundingClientRect())) onMove();\n            frame(1e-7);\n          }, 1000);\n        }\n      },\n      { rootMargin: insets.map((inset) => `${-inset}px`).join(' '), threshold: Math.max(0, Math.min(1, threshold)) || 1 },\n    );\n    observer.observe(element);\n  };\n\n  frame(1);\n  return stop;\n}\n"],"mappings":";;;;;;;;;;;;;;;AAcA,SAAgB,iBAAiB,SAAkB,QAAgC;CACjF,IAAI,OAAO,yBAAyB,aAAa,aAAa,CAAC;CAC/D,MAAM,OAAO,QAAQ,cAAc;CACnC,IAAI,WAAwC;CAC5C,IAAI,QAA+B;CACnC,IAAI;CAEJ,MAAM,aAAmB;EACvB,aAAa,KAAK;EAClB,UAAU,WAAW;EACrB,WAAW;EACX,OAAO,WAAW;EAClB,QAAQ;CACV;;CAGA,MAAM,kBAAwB;EAC5B,IAAI,OAAO,mBAAmB,aAAa;EAC3C,QAAQ,IAAI,qBAAqB;GAC/B,MAAM,MAAM,QAAQ,sBAAsB;GAC1C,IAAI,IAAI,UAAU,KAAK,IAAI,WAAW,GAAG;GACzC,OAAO;GACP,MAAM,CAAC;EACT,CAAC;EACD,MAAM,QAAQ,OAAO;CACvB;CAEA,MAAM,SAAS,cAA4B;EACzC,KAAK;EACL,MAAM,MAAM,QAAQ,sBAAsB;EAC1C,IAAI,IAAI,UAAU,KAAK,IAAI,WAAW,GAAG;GACvC,UAAU;GACV;EACF;EACA,MAAM,SAAS;GACb,KAAK,MAAM,IAAI,GAAG;GAClB,KAAK,MAAM,KAAK,cAAc,IAAI,KAAK;GACvC,KAAK,MAAM,KAAK,eAAe,IAAI,MAAM;GACzC,KAAK,MAAM,IAAI,IAAI;EACrB;EAGA,MAAM,WAAW,QACf,KAAK,IAAI,IAAI,OAAO,IAAI,IAAI,IAAI,MAAO,KAAK,IAAI,IAAI,MAAM,IAAI,GAAG,IAAI,MAClE,KAAK,IAAI,IAAI,QAAQ,IAAI,KAAK,IAAI,MAAO,KAAK,IAAI,IAAI,SAAS,IAAI,MAAM,IAAI;EAClF,IAAI,QAAQ;EACZ,WAAW,IAAI,sBACZ,YAAY;GACX,MAAM,QAAQ,QAAQ,EAAE,CAAC;GAIzB,IAHc,QACV,QAAQ,SAAS,KAAK,QAAQ,QAAQ,EAAE,CAAC,kBAAkB,IAC3D,UAAU,WACH;IACT,OAAO;IACP,MAAM,CAAC;IACP;GACF;GACA,QAAQ;GACR,IAAI,UAAU,WAAW;GAIzB,IAAI,UAAU,GAAG,MAAM,KAAK;QAE1B,QAAQ,iBAAiB;IACvB,IAAI,QAAQ,QAAQ,sBAAsB,CAAC,GAAG,OAAO;IACrD,MAAM,IAAI;GACZ,GAAG,GAAI;EAEX,GACA;GAAE,YAAY,OAAO,KAAK,UAAU,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,GAAG;GAAG,WAAW,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,SAAS,CAAC,KAAK;EAAE,CACpH;EACA,SAAS,QAAQ,OAAO;CAC1B;CAEA,MAAM,CAAC;CACP,OAAO;AACT"}

package/dist/canvas/wrapNodeOutput.js

@@ -1,14 +1,26 @@
-import { wrapWithPoseRotation as e } from "./poseRotation.js";
+import { wrapWithPoseRotation } from "./poseRotation.js";
+import { overChildren, splitOverChildren } from "./overChildren.js";
+
 //#region src/canvas/wrapNodeOutput.ts
-function t(t, n, r) {
-	let i = e(t, n);
-	return r !== 1 && i.length > 0 ? [{
+/** Rotate `cmds` about the pose's AABB center and multiply by `alpha`.
+*  Both wraps are skipped when they would be no-ops (zero/absent rotation,
+*  alpha exactly 1, empty command list), so an upright opaque node emits the
+*  painter's commands untouched. Alpha nests OUTSIDE rotation. */
+function wrapNodeOutput(cmds, pose, alpha) {
+	const { under, over } = splitOverChildren(cmds);
+	const wrapped = wrapPart(under, pose, alpha);
+	return over.length > 0 ? [...wrapped, overChildren(wrapPart(over, pose, alpha))] : wrapped;
+}
+function wrapPart(cmds, pose, alpha) {
+	const rotated = wrapWithPoseRotation(cmds, pose);
+	if (alpha !== 1 && rotated.length > 0) return [{
 		kind: "group",
-		alpha: r,
-		children: i
-	}] : i;
+		alpha,
+		children: rotated
+	}];
+	return rotated;
 }
-//#endregion
-export { t as wrapNodeOutput };
 
+//#endregion
+export { wrapNodeOutput };
 //# sourceMappingURL=wrapNodeOutput.js.map

package/dist/canvas/wrapNodeOutput.js.map

@@ -1 +1 @@
-{"version":3,"file":"wrapNodeOutput.js","names":["wrapNodeOutput","rotated","wrapWithPoseRotation","cmds","pose","alpha"],"sources":["../../src/canvas/wrapNodeOutput.ts"],"sourcesContent":["/**\n * The per-node wraps a scene render applies on top of whatever `drawOne`\n * returned — pose rotation, then a per-id alpha multiplier. They sit outside\n * `drawOne` on purpose: consumer-supplied painters get rotation and dimming\n * without having to reimplement either.\n *\n * Shared by the main canvas (`buildSceneLayer`) and the detached renders\n * (`buildSceneViewCommands`) so a scene painted off-screen matches the same\n * scene painted on it.\n */\nimport type { DrawCommand } from '@weasel-js/renderer';\nimport { wrapWithPoseRotation } from './poseRotation';\n\n/** Rotate `cmds` about the pose's AABB center and multiply by `alpha`.\n *  Both wraps are skipped when they would be no-ops (zero/absent rotation,\n *  alpha exactly 1, empty command list), so an upright opaque node emits the\n *  painter's commands untouched. Alpha nests OUTSIDE rotation. */\nexport function wrapNodeOutput(\n  cmds: DrawCommand[],\n  pose: unknown,\n  alpha: number,\n): DrawCommand[] {\n  const rotated = wrapWithPoseRotation(cmds, pose);\n  if (alpha !== 1 && rotated.length > 0) {\n    return [{ kind: 'group', alpha, children: rotated }];\n  }\n  return rotated;\n}\n"],"mappings":";;AAiBA,SAAgBA,EACd,GACA,GACA,GACe;CACf,IAAMC,IAAUC,EAAqBC,GAAMC,CAAI;CAI/C,OAHIC,MAAU,KAAKJ,EAAQ,SAAS,IAC3B,CAAC;EAAE,MAAM;EAAS;EAAO,UAAUA;CAAQ,CAAC,IAE9CA;AACT"}
+{"version":3,"file":"wrapNodeOutput.js","names":[],"sources":["../../src/canvas/wrapNodeOutput.ts"],"sourcesContent":["/**\n * The per-node wraps a scene render applies on top of whatever `drawOne`\n * returned — pose rotation, then a per-id alpha multiplier. They sit outside\n * `drawOne` on purpose: consumer-supplied painters get rotation and dimming\n * without having to reimplement either.\n *\n * Shared by the main canvas (`buildSceneLayer`) and the detached renders\n * (`buildSceneViewCommands`) so a scene painted off-screen matches the same\n * scene painted on it.\n */\nimport type { DrawCommand } from '@weasel-js/renderer';\nimport { wrapWithPoseRotation } from './poseRotation';\nimport { overChildren, splitOverChildren } from './overChildren';\n\n/** Rotate `cmds` about the pose's AABB center and multiply by `alpha`.\n *  Both wraps are skipped when they would be no-ops (zero/absent rotation,\n *  alpha exactly 1, empty command list), so an upright opaque node emits the\n *  painter's commands untouched. Alpha nests OUTSIDE rotation. */\nexport function wrapNodeOutput(\n  cmds: DrawCommand[],\n  pose: unknown,\n  alpha: number,\n): DrawCommand[] {\n  const { under, over } = splitOverChildren(cmds);\n  const wrapped = wrapPart(under, pose, alpha);\n  // What a painter asked to draw over the node's children is wrapped apart, so it is still over them.\n  return over.length > 0 ? [...wrapped, overChildren(wrapPart(over, pose, alpha))] : wrapped;\n}\n\nfunction wrapPart(cmds: DrawCommand[], pose: unknown, alpha: number): DrawCommand[] {\n  const rotated = wrapWithPoseRotation(cmds, pose);\n  if (alpha !== 1 && rotated.length > 0) {\n    return [{ kind: 'group', alpha, children: rotated }];\n  }\n  return rotated;\n}\n"],"mappings":";;;;;;;;AAkBA,SAAgB,eACd,MACA,MACA,OACe;CACf,MAAM,EAAE,OAAO,SAAS,kBAAkB,IAAI;CAC9C,MAAM,UAAU,SAAS,OAAO,MAAM,KAAK;CAE3C,OAAO,KAAK,SAAS,IAAI,CAAC,GAAG,SAAS,aAAa,SAAS,MAAM,MAAM,KAAK,CAAC,CAAC,IAAI;AACrF;AAEA,SAAS,SAAS,MAAqB,MAAe,OAA8B;CAClF,MAAM,UAAU,qBAAqB,MAAM,IAAI;CAC/C,IAAI,UAAU,KAAK,QAAQ,SAAS,GAClC,OAAO,CAAC;EAAE,MAAM;EAAS;EAAO,UAAU;CAAQ,CAAC;CAErD,OAAO;AACT"}

package/dist/clipboard.d.ts

@@ -1,8 +1,8 @@
 import { NodeId } from '@weasel-js/routing';
-import { d as PasteOmission, j as ClipboardSnapshot, I as InsertAdapter } from './types-CIKDwlsP.js';
+import { b as PasteOmission, j as ClipboardSnapshot, I as InsertAdapter } from './types-CHVXGfYm.js';
 import '@weasel-js/history';
 import '@weasel-js/geom';
-import './poseDescriptor-Bqk-11Rl.js';
+import './poseDescriptor-DN2yfnq_.js';
 import '@weasel-js/animator';
 
 type Replacer$1 = (key: string, value: unknown) => unknown;
@@ -46,7 +46,11 @@ type ClipboardFlavors = Record<string, string | Promise<string>>;
 /** Return shape of `useClipboardOps`: imperative `copy`, `paste`, and `isEmpty` functions. */
 interface UseClipboardOpsReturn {
     copy(): void;
-    paste(): void;
+    /** Paste at `at` when given; otherwise at the drop point, else the cascade offset. */
+    paste(at?: {
+        worldX: number;
+        worldY: number;
+    }): void;
     isEmpty(): boolean;
 }
 /** In-memory copy/paste of selections via `InsertAdapter.snapshotSelection` / `commitPaste`. */

package/dist/clipboard.js

@@ -1,3 +1,4 @@
-import { WEASEL_CLIPBOARD_MIME as e, WEASEL_CLIPBOARD_MIME_WEB as t, buildWeaselClipboardText as n, embedWeaselMetadataInSvg as r, extractWeaselClipboardFromSvg as i, parseWeaselClipboardText as a, sniffWeaselClipboardText as o } from "./interactions/actions/clipboard/wireFormat.js";
-import { useClipboardOps as s } from "./interactions/actions/clipboard/clipboardOps.js";
-export { e as WEASEL_CLIPBOARD_MIME, t as WEASEL_CLIPBOARD_MIME_WEB, n as buildWeaselClipboardText, r as embedWeaselMetadataInSvg, i as extractWeaselClipboardFromSvg, a as parseWeaselClipboardText, o as sniffWeaselClipboardText, s as useClipboardOps };
+import { WEASEL_CLIPBOARD_MIME, WEASEL_CLIPBOARD_MIME_WEB, buildWeaselClipboardText, embedWeaselMetadataInSvg, extractWeaselClipboardFromSvg, parseWeaselClipboardText, sniffWeaselClipboardText } from "./interactions/actions/clipboard/wireFormat.js";
+import { useClipboardOps } from "./interactions/actions/clipboard/clipboardOps.js";
+
+export { WEASEL_CLIPBOARD_MIME, WEASEL_CLIPBOARD_MIME_WEB, buildWeaselClipboardText, embedWeaselMetadataInSvg, extractWeaselClipboardFromSvg, parseWeaselClipboardText, sniffWeaselClipboardText, useClipboardOps };