@weasel-js/core 1.10.1 → 1.11.1

package/dist/canvas/SceneCanvas/contributionFrameHooks.js

@@ -1,42 +1,64 @@
-import { useEffect as e, useRef as t } from "react";
-import { useLatest as n } from "@weasel-js/react";
+import { useEffect, useRef } from "react";
+import { useLatest } from "@weasel-js/react";
+
 //#region src/canvas/SceneCanvas/contributionFrameHooks.ts
-function r(e, t, n, r) {
-	for (let i of e) {
-		let e = i[t];
-		if (e) try {
-			e(n);
-		} catch (n) {
-			if (r.has(e)) continue;
-			r.add(e), console.error(`[weasel] contribution "${i.id}" threw from ${t}; the frame went on without it.`, n);
+/**
+* Runs contributions' `beforePaint` / `afterPaint` on the surface's own frame
+* loop. One subscription per phase serves every entry, and only while some
+* entry declares that phase — a surface with no hooks subscribes to nothing.
+*/
+/**
+* Call every entry's `phase` hook in list order. A hook that throws is
+* reported through `console.error` the first time and skipped, so one broken
+* contribution costs its own work rather than the frame.
+*/
+function runContributionFrameHooks(entries, phase, ctx, reported) {
+	for (const entry of entries) {
+		const hook = entry[phase];
+		if (!hook) continue;
+		try {
+			hook(ctx);
+		} catch (err) {
+			if (reported.has(hook)) continue;
+			reported.add(hook);
+			console.error(`[weasel] contribution "${entry.id}" threw from ${phase}; the frame went on without it.`, err);
 		}
 	}
 }
-function i(i, a, o) {
-	let s = i.some((e) => e.beforePaint), c = i.some((e) => e.afterPaint), l = n(i), u = n(o), d = t(/* @__PURE__ */ new WeakSet()).current;
-	e(() => {
-		if (!a || !(s || c)) return;
-		let e = (e) => ({
-			time: e,
-			view: a.getView(),
-			requestFrame: a.requestRedraw,
-			deps: u.current
-		}), t = (t) => (n) => {
-			r(l.current, t, e(n), d);
-		}, n = s ? a.subscribeBeforePaint(t("beforePaint")) : void 0, i = c ? a.subscribeFrame(t("afterPaint")) : void 0;
-		return a.requestRedraw(), () => {
-			n?.(), i?.();
+function useContributionFrameHooks(entries, api, deps) {
+	const hasBefore = entries.some((e) => e.beforePaint);
+	const hasAfter = entries.some((e) => e.afterPaint);
+	const entriesRef = useLatest(entries);
+	const depsRef = useLatest(deps);
+	const reported = useRef(/* @__PURE__ */ new WeakSet()).current;
+	useEffect(() => {
+		if (!api || !(hasBefore || hasAfter)) return;
+		const ctxAt = (time) => ({
+			time,
+			view: api.getView(),
+			requestFrame: api.requestRedraw,
+			deps: depsRef.current
+		});
+		const run = (phase) => (time) => {
+			runContributionFrameHooks(entriesRef.current, phase, ctxAt(time), reported);
+		};
+		const offBefore = hasBefore ? api.subscribeBeforePaint(run("beforePaint")) : void 0;
+		const offAfter = hasAfter ? api.subscribeFrame(run("afterPaint")) : void 0;
+		api.requestRedraw();
+		return () => {
+			offBefore?.();
+			offAfter?.();
 		};
 	}, [
-		a,
-		s,
-		c,
-		l,
-		u,
-		d
+		api,
+		hasBefore,
+		hasAfter,
+		entriesRef,
+		depsRef,
+		reported
 	]);
 }
-//#endregion
-export { r as runContributionFrameHooks, i as useContributionFrameHooks };
 
+//#endregion
+export { runContributionFrameHooks, useContributionFrameHooks };
 //# sourceMappingURL=contributionFrameHooks.js.map

package/dist/canvas/SceneCanvas/contributionFrameHooks.js.map

@@ -1 +1 @@
-{"version":3,"file":"contributionFrameHooks.js","names":["runContributionFrameHooks","entry","entries","hook","phase","ctx","err","reported","useContributionFrameHooks","hasBefore","hasAfter","entriesRef","useLatest","depsRef","deps","useRef","api","ctxAt","run","time","offBefore","offAfter"],"sources":["../../../src/canvas/SceneCanvas/contributionFrameHooks.ts"],"sourcesContent":["/**\n * Runs contributions' `beforePaint` / `afterPaint` on the surface's own frame\n * loop. One subscription per phase serves every entry, and only while some\n * entry declares that phase — a surface with no hooks subscribes to nothing.\n */\nimport { useEffect, useRef } from 'react';\nimport { useLatest } from '@weasel-js/react';\nimport type { CanvasExtensionApi } from '../canvasExtension';\nimport type {\n  ContributionDepReader, ContributionFrameCtx, SurfaceContribution,\n} from '../surfaceContribution';\n\ntype Phase = 'beforePaint' | 'afterPaint';\n\n/**\n * Call every entry's `phase` hook in list order. A hook that throws is\n * reported through `console.error` the first time and skipped, so one broken\n * contribution costs its own work rather than the frame.\n */\nexport function runContributionFrameHooks(\n  entries: readonly SurfaceContribution[],\n  phase: Phase,\n  ctx: ContributionFrameCtx,\n  reported: WeakSet<object>,\n): void {\n  for (const entry of entries) {\n    const hook = entry[phase];\n    if (!hook) continue;\n    try {\n      hook(ctx);\n    } catch (err) {\n      if (reported.has(hook)) continue;\n      reported.add(hook);\n      console.error(`[weasel] contribution \"${entry.id}\" threw from ${phase}; the frame went on without it.`, err);\n    }\n  }\n}\n\nexport function useContributionFrameHooks(\n  entries: readonly SurfaceContribution[],\n  api: CanvasExtensionApi | null,\n  deps: ContributionDepReader,\n): void {\n  const hasBefore = entries.some((e) => e.beforePaint);\n  const hasAfter = entries.some((e) => e.afterPaint);\n  const entriesRef = useLatest(entries);\n  const depsRef = useLatest(deps);\n  const reported = useRef(new WeakSet<object>()).current;\n\n  useEffect(() => {\n    if (!api || !(hasBefore || hasAfter)) return;\n    const ctxAt = (time: number): ContributionFrameCtx => ({\n      time,\n      view: api.getView(),\n      requestFrame: api.requestRedraw,\n      deps: depsRef.current,\n    });\n    const run = (phase: Phase) => (time: number) => {\n      runContributionFrameHooks(entriesRef.current, phase, ctxAt(time), reported);\n    };\n    const offBefore = hasBefore ? api.subscribeBeforePaint(run('beforePaint')) : undefined;\n    const offAfter = hasAfter ? api.subscribeFrame(run('afterPaint')) : undefined;\n    // A hook arriving after the last paint would otherwise wait for an\n    // unrelated redraw to run for the first time.\n    api.requestRedraw();\n    return () => { offBefore?.(); offAfter?.(); };\n  }, [api, hasBefore, hasAfter, entriesRef, depsRef, reported]);\n}\n"],"mappings":";;;AAmBA,SAAgBA,EACd,GACA,GACA,GACA,GACM;CACN,KAAK,IAAMC,KAASC,GAAS;EAC3B,IAAMC,IAAOF,EAAMG;EACnB,IAAKD,GACL,IAAI;GACF,EAAKE,CAAG;EACV,SAASC,GAAK;GACZ,IAAIC,EAAS,IAAIJ,CAAI,GAAG;GAExB,AADAI,EAAS,IAAIJ,CAAI,GACjB,QAAQ,MAAM,0BAA0BF,EAAM,GAAG,eAAeG,EAAM,kCAAkCE,CAAG;EAC7G;CACF;AACF;AAEA,SAAgBE,EACd,GACA,GACA,GACM;CACN,IAAMC,IAAYP,EAAQ,MAAM,MAAM,EAAE,WAAW,GAC7CQ,IAAWR,EAAQ,MAAM,MAAM,EAAE,UAAU,GAC3CS,IAAaC,EAAUV,CAAO,GAC9BW,IAAUD,EAAUE,CAAI,GACxBP,IAAWQ,kBAAO,IAAI,QAAgB,CAAC,CAAC,CAAC;CAE/C,QAAgB;EACd,IAAI,CAACC,KAAO,EAAEP,KAAaC,IAAW;EACtC,IAAMO,KAAS,OAAwC;GACrD;GACA,MAAMD,EAAI,QAAQ;GAClB,cAAcA,EAAI;GAClB,MAAMH,EAAQ;EAChB,IACMK,KAAO,OAAkB,MAAiB;GAC9C,EAA0BP,EAAW,SAASP,GAAOa,EAAME,CAAI,GAAGZ,CAAQ;EAC5E,GACMa,IAAYX,IAAYO,EAAI,qBAAqBE,EAAI,aAAa,CAAC,IAAI,KAAA,GACvEG,IAAWX,IAAWM,EAAI,eAAeE,EAAI,YAAY,CAAC,IAAI,KAAA;EAIpE,OADAF,EAAI,cAAc,SACL;GAAiB,AAAfI,IAAY,GAAGC,IAAW;EAAG;CAC9C,GAAG;EAACL;EAAKP;EAAWC;EAAUC;EAAYE;EAASN;CAAQ,CAAC;AAC9D"}
+{"version":3,"file":"contributionFrameHooks.js","names":[],"sources":["../../../src/canvas/SceneCanvas/contributionFrameHooks.ts"],"sourcesContent":["/**\n * Runs contributions' `beforePaint` / `afterPaint` on the surface's own frame\n * loop. One subscription per phase serves every entry, and only while some\n * entry declares that phase — a surface with no hooks subscribes to nothing.\n */\nimport { useEffect, useRef } from 'react';\nimport { useLatest } from '@weasel-js/react';\nimport type { CanvasExtensionApi } from '../canvasExtension';\nimport type {\n  ContributionDepReader, ContributionFrameCtx, SurfaceContribution,\n} from '../surfaceContribution';\n\ntype Phase = 'beforePaint' | 'afterPaint';\n\n/**\n * Call every entry's `phase` hook in list order. A hook that throws is\n * reported through `console.error` the first time and skipped, so one broken\n * contribution costs its own work rather than the frame.\n */\nexport function runContributionFrameHooks(\n  entries: readonly SurfaceContribution[],\n  phase: Phase,\n  ctx: ContributionFrameCtx,\n  reported: WeakSet<object>,\n): void {\n  for (const entry of entries) {\n    const hook = entry[phase];\n    if (!hook) continue;\n    try {\n      hook(ctx);\n    } catch (err) {\n      if (reported.has(hook)) continue;\n      reported.add(hook);\n      console.error(`[weasel] contribution \"${entry.id}\" threw from ${phase}; the frame went on without it.`, err);\n    }\n  }\n}\n\nexport function useContributionFrameHooks(\n  entries: readonly SurfaceContribution[],\n  api: CanvasExtensionApi | null,\n  deps: ContributionDepReader,\n): void {\n  const hasBefore = entries.some((e) => e.beforePaint);\n  const hasAfter = entries.some((e) => e.afterPaint);\n  const entriesRef = useLatest(entries);\n  const depsRef = useLatest(deps);\n  const reported = useRef(new WeakSet<object>()).current;\n\n  useEffect(() => {\n    if (!api || !(hasBefore || hasAfter)) return;\n    const ctxAt = (time: number): ContributionFrameCtx => ({\n      time,\n      view: api.getView(),\n      requestFrame: api.requestRedraw,\n      deps: depsRef.current,\n    });\n    const run = (phase: Phase) => (time: number) => {\n      runContributionFrameHooks(entriesRef.current, phase, ctxAt(time), reported);\n    };\n    const offBefore = hasBefore ? api.subscribeBeforePaint(run('beforePaint')) : undefined;\n    const offAfter = hasAfter ? api.subscribeFrame(run('afterPaint')) : undefined;\n    // A hook arriving after the last paint would otherwise wait for an\n    // unrelated redraw to run for the first time.\n    api.requestRedraw();\n    return () => { offBefore?.(); offAfter?.(); };\n  }, [api, hasBefore, hasAfter, entriesRef, depsRef, reported]);\n}\n"],"mappings":";;;;;;;;;;;;;;AAmBA,SAAgB,0BACd,SACA,OACA,KACA,UACM;CACN,KAAK,MAAM,SAAS,SAAS;EAC3B,MAAM,OAAO,MAAM;EACnB,IAAI,CAAC,MAAM;EACX,IAAI;GACF,KAAK,GAAG;EACV,SAAS,KAAK;GACZ,IAAI,SAAS,IAAI,IAAI,GAAG;GACxB,SAAS,IAAI,IAAI;GACjB,QAAQ,MAAM,0BAA0B,MAAM,GAAG,eAAe,MAAM,kCAAkC,GAAG;EAC7G;CACF;AACF;AAEA,SAAgB,0BACd,SACA,KACA,MACM;CACN,MAAM,YAAY,QAAQ,MAAM,MAAM,EAAE,WAAW;CACnD,MAAM,WAAW,QAAQ,MAAM,MAAM,EAAE,UAAU;CACjD,MAAM,aAAa,UAAU,OAAO;CACpC,MAAM,UAAU,UAAU,IAAI;CAC9B,MAAM,WAAW,uBAAO,IAAI,QAAgB,CAAC,CAAC,CAAC;CAE/C,gBAAgB;EACd,IAAI,CAAC,OAAO,EAAE,aAAa,WAAW;EACtC,MAAM,SAAS,UAAwC;GACrD;GACA,MAAM,IAAI,QAAQ;GAClB,cAAc,IAAI;GAClB,MAAM,QAAQ;EAChB;EACA,MAAM,OAAO,WAAkB,SAAiB;GAC9C,0BAA0B,WAAW,SAAS,OAAO,MAAM,IAAI,GAAG,QAAQ;EAC5E;EACA,MAAM,YAAY,YAAY,IAAI,qBAAqB,IAAI,aAAa,CAAC,IAAI;EAC7E,MAAM,WAAW,WAAW,IAAI,eAAe,IAAI,YAAY,CAAC,IAAI;EAGpE,IAAI,cAAc;EAClB,aAAa;GAAE,YAAY;GAAG,WAAW;EAAG;CAC9C,GAAG;EAAC;EAAK;EAAW;EAAU;EAAY;EAAS;CAAQ,CAAC;AAC9D"}

package/dist/canvas/SceneCanvas/coordTrace.js

@@ -1,46 +1,42 @@
-import { IS_DEV as e } from "./isDev.js";
 //#region src/canvas/SceneCanvas/coordTrace.ts
-var t = 200, n = [], r = e;
-r && typeof window < "u" && (window.__weaselCoordLog__ = n);
-function i(e) {
-	r && (n.push(e), n.length > t && n.shift());
-}
-function a(e, t, n, a, o) {
-	if (!r) return;
-	if (!n || !a) {
-		i({
+/** Record one conversion against the rect and view it was made under. A null
+*  `canvas` or a missing `view` records the identity fallback. */
+function traceConversion(ring, clientX, clientY, canvas, view, world) {
+	if (!ring.recording()) return;
+	if (!canvas || !view) {
+		ring.push({
 			ts: Date.now(),
-			clientX: e,
-			clientY: t,
+			clientX,
+			clientY,
 			rect: null,
 			view: null,
-			world: o,
-			fallback: !0
+			world,
+			fallback: true
 		});
 		return;
 	}
-	let s = n.getBoundingClientRect();
-	i({
+	const rect = canvas.getBoundingClientRect();
+	ring.push({
 		ts: Date.now(),
-		clientX: e,
-		clientY: t,
+		clientX,
+		clientY,
 		rect: {
-			left: s.left,
-			top: s.top,
-			width: s.width,
-			height: s.height
+			left: rect.left,
+			top: rect.top,
+			width: rect.width,
+			height: rect.height
 		},
 		view: {
-			x: a.x,
-			y: a.y,
-			scaleX: a.scale.x,
-			scaleY: a.scale.y
+			x: view.x,
+			y: view.y,
+			scaleX: view.scale.x,
+			scaleY: view.scale.y
 		},
-		world: o,
-		fallback: !1
+		world,
+		fallback: false
 	});
 }
-//#endregion
-export { r as COORD_DEV, t as COORD_TRACE_LIMIT, n as coordTrace, a as traceConversion };
 
+//#endregion
+export { traceConversion };
 //# sourceMappingURL=coordTrace.js.map

package/dist/canvas/SceneCanvas/coordTrace.js.map

@@ -1 +1 @@
-{"version":3,"file":"coordTrace.js","names":["COORD_TRACE_LIMIT","coordTrace","COORD_DEV","IS_DEV","recordCoordTrace","entry","traceConversion","canvas","view","rect"],"sources":["../../../src/canvas/SceneCanvas/coordTrace.ts"],"sourcesContent":["import type { View } from 'core/viewport/view';\nimport { IS_DEV } from './isDev';\n\n// ---------------------------------------------------------------------------\n// Dev-only coord trace\n// ---------------------------------------------------------------------------\n\n/** Records every `clientToWorld` call so dev tools (and agents) can\n *  reconcile cursor coords with computed world coords. Mirrors the\n *  dispatcher's trace log. Exposed on `window.__weaselCoordLog__`. */\nexport interface CoordTraceEntry {\n  ts: number;\n  clientX: number;\n  clientY: number;\n  rect: { left: number; top: number; width: number; height: number } | null;\n  view: { x: number; y: number; scaleX: number; scaleY: number } | null;\n  world: { x: number; y: number };\n  /** True when canvas/view weren't available and we returned identity. */\n  fallback: boolean;\n}\n\nexport const COORD_TRACE_LIMIT = 200;\n\nexport const coordTrace: CoordTraceEntry[] = [];\n\nexport const COORD_DEV: boolean = IS_DEV;\n\nif (COORD_DEV && typeof window !== 'undefined') {\n  (window as unknown as { __weaselCoordLog__: CoordTraceEntry[] }).__weaselCoordLog__ = coordTrace;\n}\n\nfunction recordCoordTrace(entry: CoordTraceEntry): void {\n  if (!COORD_DEV) return;\n  coordTrace.push(entry);\n  if (coordTrace.length > COORD_TRACE_LIMIT) coordTrace.shift();\n}\n\n/** Record one conversion against the rect and view it was made under. A null\n *  `canvas` or a missing `view` records the identity fallback. */\nexport function traceConversion(\n  clientX: number,\n  clientY: number,\n  canvas: HTMLElement | null,\n  view: View | null | undefined,\n  world: { x: number; y: number },\n): void {\n  if (!COORD_DEV) return;\n  if (!canvas || !view) {\n    recordCoordTrace({ ts: Date.now(), clientX, clientY, rect: null, view: null, world, fallback: true });\n    return;\n  }\n  const rect = canvas.getBoundingClientRect();\n  recordCoordTrace({\n    ts: Date.now(), clientX, clientY,\n    rect: { left: rect.left, top: rect.top, width: rect.width, height: rect.height },\n    view: { x: view.x, y: view.y, scaleX: view.scale.x, scaleY: view.scale.y },\n    world, fallback: false,\n  });\n}\n"],"mappings":";;AAqBA,IAAaA,IAAoB,KAEpBC,IAAgC,CAAC,GAEjCC,IAAqBC;AAE9BD,KAAa,OAAO,SAAW,QACjC,OAAiE,qBAAqBD;AAGxF,SAASG,EAAiB,GAA8B;CACtD,AAAKF,MACLD,EAAW,KAAKI,CAAK,GACjBJ,EAAW,SAASD,KAAmBC,EAAW,MAAM;AAC9D;AAIA,SAAgBK,EACd,GACA,GACA,GACA,GACA,GACM;CACN,IAAI,CAACJ,GAAW;CAChB,IAAI,CAACK,KAAU,CAACC,GAAM;EACpB,EAAiB;GAAE,IAAI,KAAK,IAAI;GAAG;GAAS;GAAS,MAAM;GAAM,MAAM;GAAM;GAAO,UAAU;EAAK,CAAC;EACpG;CACF;CACA,IAAMC,IAAOF,EAAO,sBAAsB;CAC1C,EAAiB;EACf,IAAI,KAAK,IAAI;EAAG;EAAS;EACzB,MAAM;GAAE,MAAME,EAAK;GAAM,KAAKA,EAAK;GAAK,OAAOA,EAAK;GAAO,QAAQA,EAAK;EAAO;EAC/E,MAAM;GAAE,GAAGD,EAAK;GAAG,GAAGA,EAAK;GAAG,QAAQA,EAAK,MAAM;GAAG,QAAQA,EAAK,MAAM;EAAE;EACzE;EAAO,UAAU;CACnB,CAAC;AACH"}
+{"version":3,"file":"coordTrace.js","names":[],"sources":["../../../src/canvas/SceneCanvas/coordTrace.ts"],"sourcesContent":["import type { TraceRing } from '@weasel-js/routing';\nimport type { View } from 'core/viewport/view';\n\n/** One `clientToWorld` call, so a cursor position can be reconciled with the\n *  world point it became. A canvas keeps these beside its dispatch trace, and\n *  the devtools hook's `get-trace` reads them. */\nexport interface CoordTraceEntry {\n  ts: number;\n  clientX: number;\n  clientY: number;\n  rect: { left: number; top: number; width: number; height: number } | null;\n  view: { x: number; y: number; scaleX: number; scaleY: number } | null;\n  world: { x: number; y: number };\n  /** True when canvas/view weren't available and we returned identity. */\n  fallback: boolean;\n}\n\n/** Record one conversion against the rect and view it was made under. A null\n *  `canvas` or a missing `view` records the identity fallback. */\nexport function traceConversion(\n  ring: TraceRing<CoordTraceEntry>,\n  clientX: number,\n  clientY: number,\n  canvas: HTMLElement | null,\n  view: View | null | undefined,\n  world: { x: number; y: number },\n): void {\n  if (!ring.recording()) return;\n  if (!canvas || !view) {\n    ring.push({ ts: Date.now(), clientX, clientY, rect: null, view: null, world, fallback: true });\n    return;\n  }\n  const rect = canvas.getBoundingClientRect();\n  ring.push({\n    ts: Date.now(), clientX, clientY,\n    rect: { left: rect.left, top: rect.top, width: rect.width, height: rect.height },\n    view: { x: view.x, y: view.y, scaleX: view.scale.x, scaleY: view.scale.y },\n    world, fallback: false,\n  });\n}\n"],"mappings":";;;AAmBA,SAAgB,gBACd,MACA,SACA,SACA,QACA,MACA,OACM;CACN,IAAI,CAAC,KAAK,UAAU,GAAG;CACvB,IAAI,CAAC,UAAU,CAAC,MAAM;EACpB,KAAK,KAAK;GAAE,IAAI,KAAK,IAAI;GAAG;GAAS;GAAS,MAAM;GAAM,MAAM;GAAM;GAAO,UAAU;EAAK,CAAC;EAC7F;CACF;CACA,MAAM,OAAO,OAAO,sBAAsB;CAC1C,KAAK,KAAK;EACR,IAAI,KAAK,IAAI;EAAG;EAAS;EACzB,MAAM;GAAE,MAAM,KAAK;GAAM,KAAK,KAAK;GAAK,OAAO,KAAK;GAAO,QAAQ,KAAK;EAAO;EAC/E,MAAM;GAAE,GAAG,KAAK;GAAG,GAAG,KAAK;GAAG,QAAQ,KAAK,MAAM;GAAG,QAAQ,KAAK,MAAM;EAAE;EACzE;EAAO,UAAU;CACnB,CAAC;AACH"}