@weasel-js/core 1.6.1 → 1.7.1

package/dist/renderer.d.ts

@@ -1,18 +1,21 @@
-import { M as Mesh } from './builtins-HWyuLzE-.js';
-export { C as CullRect, D as DrawCommand, E as Effect, G as GlMat3, a as GroupDrawCommand, I as IDENTITY_COLOR_MATRIX, b as ImageDrawCommand, c as ImageMinification, P as PathDrawCommand, R as RenderTarget, S as SPRITE_STRIDE, d as ShaderCompileError, e as ShaderDrawCommand, f as ShaderProgramHandle, g as ShaderUniform, h as SolidPaint, i as SpriteSheet, j as SpritesDrawCommand, k as StrokeOptions, T as TextDrawCommand, W as WeaselRenderer, l as WeaselRendererOptions, m as blur, n as buildGradientRamp, o as cullDrawCommands, p as frameRect, q as mat3, r as registerEffect, s as registerProgram, t as tessellateStroke, v as viewToMat3, u as vignette } from './builtins-HWyuLzE-.js';
-import { P as Path } from './path-JEV2c5If.js';
-export { canQueryLocalFonts, enableLocalFontOutlines, hasFontOutlines, isCanvasFont, listFontOutlines, outlineStatus, registerCanvasFont, registerFont, registerFontOutlines, subscribeGlyphReady, unregisterCanvasFont, unregisterFontOutlines } from '@weasel-js/font';
+export { C as CullRect, D as DrawCommand, E as Effect, G as GroupDrawCommand, I as IDENTITY_COLOR_MATRIX, a as ImageDrawCommand, b as ImageMinification, P as PathDrawCommand, R as RenderOptions, c as RenderSpan, d as RenderSpanStats, e as RenderStats, f as RenderTarget, S as SPRITE_STRIDE, g as ShaderDrawCommand, h as SolidPaint, i as SpriteSheet, j as SpritesDrawCommand, k as StrokeOptions, T as TextDrawCommand, W as WeaselRenderer, l as WeaselRendererOptions, m as blur, n as buildGradientRamp, o as cullDrawCommands, p as frameRect, r as registerEffect, t as tessellateStroke, v as viewToMat3, q as vignette } from './builtins-BSUfH8nU.js';
+export { G as GlMat3, P as ProgramSource, S as ShaderCompileError, a as ShaderProgramHandle, b as ShaderUniform, m as mat3, p as programSourceRegistry, r as registerProgram } from './registerProgram-ateHDGjw.js';
+export { Mesh, TessellateOptions, tessellate } from '@weasel-js/geom/tessellate';
+export { RegisterFontOptions, canQueryLocalFonts, cssFontFamily, cssFontFamilyLoading, enableLocalFontOutlines, fontOutlineRegistry, fontRegistry, hasFontOutlines, isCanvasFont, listFontOutlines, loadFontOutlines, outlineStatus, registerCanvasFont, registerFont, registerFontOutlines, subscribeGlyphReady, unregisterCanvasFont, unregisterFontOutlines } from '@weasel-js/font';
 import { TextureHandle } from '@weasel-js/paint';
 export { TextureHandle } from '@weasel-js/paint';
+import { Reflection } from '@weasel-js/registry';
 export { View as ViewLike } from '@weasel-js/routing';
-import '@weasel-js/text';
 import '@weasel-js/geom';
 import 'react';
 import '@weasel-js/history';
-import './types-CxC8P6W0.js';
-import './poseDescriptor-rZa9W5hJ.js';
+import './types-CA54-mAZ.js';
+import '@weasel-js/text';
+import './poseDescriptor-CjSXMf8X.js';
 import '@weasel-js/routing/react';
-import './types-D_74YlWs.js';
+import './types-DSjd6W3n.js';
+import '@weasel-js/cursor';
+import '@weasel-js/gestures';
 
 /**
  * registerTexture — accepts an image source, assigns an opaque id, stores in
@@ -25,6 +28,12 @@ import './types-D_74YlWs.js';
  * Each WeaselRenderer's GLTextureCache does its own dedup via has(id).
  */
 
+/** A registered texture's image source, uploaded to GL lazily at first draw. */
+interface TextureEntry {
+    source: HTMLImageElement | ImageBitmap;
+}
+/** Every registered texture, keyed by its handle id. */
+declare const textureRegistry: Reflection<TextureEntry>;
 /**
  * Register an image for use as a shader texture uniform.
  *
@@ -36,17 +45,6 @@ import './types-D_74YlWs.js';
  */
 declare function registerTexture(image: HTMLImageElement | ImageBitmap): TextureHandle;
 
-/** Options for `tessellate`. A smaller tolerance means more triangles and
- *  smoother curves; it is in path-local units, so callers rendering at a
- *  larger scale should tighten it. */
-interface TessellateOptions {
-    /** Flatness tolerance for bezier subdivision in path-local units. */
-    flattenTolerance?: number;
-}
-/** Turn a path into a triangle mesh the renderer can draw: curves flattened to
- *  line segments, then the resulting polygon triangulated. */
-declare function tessellate(path: Path, opts?: TessellateOptions): Mesh;
-
 /**
  * On-screen glyph size (CSS px) at or above which a face with registered
  * outlines is drawn as geometry instead of sampled from a distance field.
@@ -90,4 +88,4 @@ declare const EFFECT_VERT_SRC = "#version 300 es\nin vec2 a_position;\nin vec2 a
  *  redeclare them with different meanings; it may leave any of them out. */
 declare const EFFECT_KIT_UNIFORMS: readonly ["u_source", "u_resolution", "u_texel"];
 
-export { EFFECT_KIT_UNIFORMS, EFFECT_VERT_SRC, Mesh, OUTLINE_MIN_SCREEN_PX, type TessellateOptions, registerTexture, tessellate };
+export { EFFECT_KIT_UNIFORMS, EFFECT_VERT_SRC, OUTLINE_MIN_SCREEN_PX, type TextureEntry, registerTexture, textureRegistry };

package/dist/renderer.js

@@ -1,13 +1,18 @@
-export { EFFECT_KIT_UNIFORMS, EFFECT_VERT_SRC, IDENTITY_COLOR_MATRIX, OUTLINE_MIN_SCREEN_PX, SPRITE_STRIDE, ShaderCompileError, WeaselRenderer, blur, buildGradientRamp, canQueryLocalFonts, cullDrawCommands, enableLocalFontOutlines, frameRect, hasFontOutlines, isCanvasFont, listFontOutlines, mat3, outlineStatus, registerCanvasFont, registerEffect, registerFont, registerFontOutlines, registerProgram, subscribeGlyphReady, tessellate, tessellateStroke, unregisterCanvasFont, unregisterFontOutlines, viewToMat3, vignette } from './chunk-MZAIDI6D.js';
-import './chunk-PNNZSYRD.js';
-import './chunk-44EWMJV2.js';
-import './chunk-H6N2JSZ3.js';
-import './chunk-HPFJUUTF.js';
-import './chunk-L5YNZYEG.js';
-import './chunk-RMR4QMM6.js';
-import './chunk-D4AAWR64.js';
-import './chunk-DOBSZOPR.js';
-import './chunk-4RJP2N2L.js';
-export { registerTexture } from './chunk-BJN5ZRIJ.js';
-//# sourceMappingURL=renderer.js.map
-//# sourceMappingURL=renderer.js.map
+import { ShaderCompileError as e } from "./renderer/shaders/ShaderProgram.js";
+import { buildGradientRamp as t } from "./renderer/cache/GradientRampAtlas.js";
+import { mat3 as n } from "./renderer/math/mat3.js";
+import { IDENTITY_COLOR_MATRIX as r } from "./renderer/state/GroupState.js";
+import { registerTexture as i, textureRegistry as a } from "./renderer/textures/registerTexture.js";
+import { programSourceRegistry as o, registerProgram as s } from "./renderer/shaders/registerProgram.js";
+import { SPRITE_STRIDE as c } from "./renderer/DrawCommand.js";
+import { tessellateStroke as l } from "./features/paths/tessellate/stroke.js";
+import { EFFECT_KIT_UNIFORMS as u, EFFECT_VERT_SRC as d } from "./renderer/effects/effectPrelude.js";
+import { OUTLINE_MIN_SCREEN_PX as f } from "./renderer/draw.js";
+import { WeaselRenderer as p } from "./renderer/WeaselRenderer.js";
+import { frameRect as m } from "./renderer/spriteSheet.js";
+import { viewToMat3 as h } from "./renderer/math/viewToMat3.js";
+import { cullDrawCommands as g } from "./renderer/cullDrawCommands.js";
+import { registerEffect as _ } from "./renderer/effects/types.js";
+import { blur as v, vignette as y } from "./renderer/effects/builtins.js";
+import { canQueryLocalFonts as b, cssFontFamily as x, cssFontFamilyLoading as S, enableLocalFontOutlines as C, fontOutlineRegistry as w, fontRegistry as T, hasFontOutlines as E, isCanvasFont as D, listFontOutlines as O, loadFontOutlines as k, outlineStatus as A, registerCanvasFont as j, registerFont as M, registerFontOutlines as N, subscribeGlyphReady as P, tessellate as F, unregisterCanvasFont as I, unregisterFontOutlines as L } from "./renderer/index.js";
+export { u as EFFECT_KIT_UNIFORMS, d as EFFECT_VERT_SRC, r as IDENTITY_COLOR_MATRIX, f as OUTLINE_MIN_SCREEN_PX, c as SPRITE_STRIDE, e as ShaderCompileError, p as WeaselRenderer, v as blur, t as buildGradientRamp, b as canQueryLocalFonts, x as cssFontFamily, S as cssFontFamilyLoading, g as cullDrawCommands, C as enableLocalFontOutlines, w as fontOutlineRegistry, T as fontRegistry, m as frameRect, E as hasFontOutlines, D as isCanvasFont, O as listFontOutlines, k as loadFontOutlines, n as mat3, A as outlineStatus, o as programSourceRegistry, j as registerCanvasFont, _ as registerEffect, M as registerFont, N as registerFontOutlines, s as registerProgram, i as registerTexture, P as subscribeGlyphReady, F as tessellate, l as tessellateStroke, a as textureRegistry, I as unregisterCanvasFont, L as unregisterFontOutlines, h as viewToMat3, y as vignette };

package/dist/resize.d.ts

@@ -1,12 +1,11 @@
-export { C as CORNER_ANCHORS, a as CornerAnchor, b as CornerHandle, U as UseResizeOptions, c as cornerPoint, d as cornerResizeHandles, f as fixedCornerOf, h as hitCornerHandle, p as pointSnapToGrid } from './pointSnapToGrid-7mCcm6qG.js';
-export { P as PoseDescriptor, R as RECT_POSE_DESCRIPTOR, a as ROTATED_POSE_DESCRIPTOR, p as poseDescriptorForNode } from './poseDescriptor-rZa9W5hJ.js';
-import { B as BoundsConstraint } from './types-D_74YlWs.js';
-import { Bounds, ModifierState, View } from '@weasel-js/routing';
-export { A as AUTO_POSE_DESCRIPTOR, i as isPathLike, a as isRectPose } from './autoPoseDescriptor-_XOyF7t4.js';
-import { G as Guide } from './types-D2tTKEU0.js';
+export { C as CORNER_ANCHORS, a as CornerAnchor, b as CornerHandle, U as UseResizeOptions, c as cornerPoint, d as cornerResizeHandles, f as fixedCornerOf, h as hitCornerHandle } from './cornerHandles-CDcZOV8h.js';
+export { P as PoseDescriptor, R as RECT_POSE_DESCRIPTOR, a as ROTATED_POSE_DESCRIPTOR, p as poseDescriptorForNode } from './poseDescriptor-CjSXMf8X.js';
+import { B as BoundsConstraint } from './types-DSjd6W3n.js';
+import { Bounds, ModifierState } from '@weasel-js/routing';
+export { A as AUTO_POSE_DESCRIPTOR, i as isPathLike, a as isRectPose } from './autoPoseDescriptor-BT_vp9FO.js';
+import './types-CA54-mAZ.js';
 import '@weasel-js/history';
-import './types-CxC8P6W0.js';
-import './path-JEV2c5If.js';
+import '@weasel-js/geom';
 
 /** Resize constraint that stops a node shrinking past a minimum. The anchored
  *  edge stays put, so clamping pushes the dragged edge back rather than moving
@@ -16,7 +15,7 @@ declare function clampMinSize<TPose extends Bounds>(args: {
     minHeight: number;
 }): BoundsConstraint<TPose>;
 
-type ModKey$2 = keyof ModifierState;
+type ModKey = keyof ModifierState;
 /** Aspect-ratio lock: drag a corner/edge with `key` (default `'shift'`) held
  *  to keep the resized bounds at the start-pose's `width / height` ratio.
  *
@@ -39,48 +38,13 @@ type ModKey$2 = keyof ModifierState;
  *  for `n` / `s`.
  */
 declare function lockAspectWithModifier<TPose extends Bounds>(opts?: {
-    key?: ModKey$2;
-}): BoundsConstraint<TPose>;
-
-type ModKey$1 = keyof ModifierState;
-/** Resize constraint that snaps the moving edges to a grid, leaving the
- *  anchored ones where they are. By default a node already smaller than one
- *  grid cell on an axis is left unsnapped on that axis, so it stays resizable
- *  at sub-grid sizes. */
-declare function snapToGrid<TPose extends Bounds>(args: {
-    spacing: number;
-    bypassKey?: ModKey$1;
-    suspendBelowDim?: boolean;
+    key?: ModKey;
 }): BoundsConstraint<TPose>;
 
-type ModKey = keyof ModifierState;
-/** Options for the resize-flavored `snapToGuides`. */
-interface SnapToGuidesResizeArgs {
-    /** Stable getter into the live guide list (typically from `useGuides`). */
-    getGuides: () => readonly Guide[];
-    /** Snap tolerance (screen px when `getView` is set, world units otherwise). */
-    tolerance?: number;
-    /** Read the active view; required for screen-pixel tolerance. */
-    getView?: () => View;
-    /** Modifier key that bypasses snapping while held. */
-    bypassKey?: ModKey;
-}
-/**
- * Resize behavior that snaps the active edge of the dragged rect to the
- * nearest guide on the corresponding axis when within `tolerance`. The
- * "free" axis is left untouched. The fixed (anchor) edge stays pinned;
- * only the moving edge snaps.
- *
- * On the X axis, vertical guides (`axis: 'x'`) constrain the moving vertical
- * edge — east when `anchor.x === 'min'` (west pinned), west when `'max'`.
- * Likewise on Y for horizontal guides.
- */
-declare function snapToGuides<TPose extends Bounds>(args: SnapToGuidesResizeArgs): BoundsConstraint<TPose>;
-
 /** The kit's standard resize behaviors, applied when a consumer doesn't
  *  supply its own list: shift-drag locks the start pose's aspect ratio.
  *  Pass an explicit `behaviors: []` to opt out. Stateless, so one shared
  *  frozen instance is safe across every gesture. */
 declare const DEFAULT_RESIZE_BEHAVIORS: readonly BoundsConstraint<Bounds>[];
 
-export { DEFAULT_RESIZE_BEHAVIORS, clampMinSize, lockAspectWithModifier, snapToGrid, snapToGuides };
+export { DEFAULT_RESIZE_BEHAVIORS, clampMinSize, lockAspectWithModifier };

package/dist/resize.js

@@ -1,5 +1,7 @@
-export { CORNER_ANCHORS, DEFAULT_RESIZE_BEHAVIORS, clampMinSize, cornerPoint, cornerResizeHandles, fixedCornerOf, hitCornerHandle, lockAspectWithModifier, pointSnapToGrid, snapToGrid, snapToGuides } from './chunk-H6N2JSZ3.js';
-import './chunk-HPFJUUTF.js';
-export { AUTO_POSE_DESCRIPTOR, RECT_POSE_DESCRIPTOR, ROTATED_POSE_DESCRIPTOR, isPathLike, isRectPose, poseDescriptorForNode } from './chunk-L5YNZYEG.js';
-//# sourceMappingURL=resize.js.map
-//# sourceMappingURL=resize.js.map
+import { RECT_POSE_DESCRIPTOR as e, ROTATED_POSE_DESCRIPTOR as t, poseDescriptorForNode as n } from "./core/geometry/poseDescriptor.js";
+import { AUTO_POSE_DESCRIPTOR as r, isPathLike as i, isRectPose as a } from "./interactions/actions/resize/autoPoseDescriptor.js";
+import { clampMinSize as o } from "./interactions/actions/resize/behaviors/clampMinSize.js";
+import { lockAspectWithModifier as s } from "./interactions/actions/resize/behaviors/lockAspect.js";
+import { DEFAULT_RESIZE_BEHAVIORS as c } from "./interactions/actions/resize/behaviors/index.js";
+import { CORNER_ANCHORS as l, cornerPoint as u, cornerResizeHandles as d, fixedCornerOf as f, hitCornerHandle as p } from "./interactions/actions/resize/cornerHandles.js";
+export { r as AUTO_POSE_DESCRIPTOR, l as CORNER_ANCHORS, c as DEFAULT_RESIZE_BEHAVIORS, e as RECT_POSE_DESCRIPTOR, t as ROTATED_POSE_DESCRIPTOR, o as clampMinSize, u as cornerPoint, d as cornerResizeHandles, f as fixedCornerOf, p as hitCornerHandle, i as isPathLike, a as isRectPose, s as lockAspectWithModifier, n as poseDescriptorForNode };

package/dist/routing.d.ts

@@ -1 +1 @@
-export { ChannelRef, Conflict, DescribeRouteOptions, GESTURE_DESCRIPTORS, GestureArgSpec, GestureDescriptor, GestureName, ModRequirement, ModifierKey, PREDICATE_TARGET, ParsedModifiers, ParsedRoute, PhaseAtom, RESERVED_ID_NAMES, RESERVED_ID_PREFIXES, ROUTE_FIELD_DEFINITIONS, ROUTE_TERMS, RegistryEntry, RouteDescriptionPart, RouteFieldName, RouteTermLabel, buildRouteRegistry, canonicalModifiers, collapseShiftPairs, describeRoute, describeRouteParts, findConflicts, formatPhaseAtom, formatRoute, getGestureDescriptor, isKnownGestureName, parseRoute, reportRouteConflicts, routeGestureForSpecKind, routesForSpec } from '@weasel-js/routing';
+export { ChannelRef, Conflict, DescribeRouteOptions, DispatchRecord, DispatchRecordInput, DroppedCandidate, GESTURE_DESCRIPTORS, GestureArgSpec, GestureDescriptor, GestureName, ModRequirement, ModeSwitchLogEntry, ModifierKey, PREDICATE_TARGET, ParsedModifiers, ParsedRoute, PhaseAtom, PlacedBy, RESERVED_ID_NAMES, RESERVED_ID_PREFIXES, ROUTE_FIELD_DEFINITIONS, ROUTE_TERMS, RankedCandidate, RecordCandidate, RegistryEntry, RouteDescriptionPart, RouteFieldName, RouteTermLabel, SpecificityPart, TraceLogEntry, WalkStep, buildRouteRegistry, canonicalModifiers, collapseShiftPairs, describeRoute, describeRouteParts, findConflicts, formatPhaseAtom, formatRoute, getGestureDescriptor, isKnownGestureName, parseRoute, reportRouteConflicts, routeGestureForSpecKind, routesForSpec, specKindForRouteGesture } from '@weasel-js/routing';

package/dist/routing.js

@@ -1,3 +1,2 @@
-export { GESTURE_DESCRIPTORS, PREDICATE_TARGET, RESERVED_ID_NAMES, RESERVED_ID_PREFIXES, ROUTE_FIELD_DEFINITIONS, ROUTE_TERMS, buildRouteRegistry, canonicalModifiers, collapseShiftPairs, describeRoute, describeRouteParts, findConflicts, formatPhaseAtom, formatRoute, getGestureDescriptor, isKnownGestureName, parseRoute, reportRouteConflicts, routeGestureForSpecKind, routesForSpec } from '@weasel-js/routing';
-//# sourceMappingURL=routing.js.map
-//# sourceMappingURL=routing.js.map
+import { GESTURE_DESCRIPTORS as e, PREDICATE_TARGET as t, RESERVED_ID_NAMES as n, RESERVED_ID_PREFIXES as r, ROUTE_FIELD_DEFINITIONS as i, ROUTE_TERMS as a, buildRouteRegistry as o, canonicalModifiers as s, collapseShiftPairs as c, describeRoute as l, describeRouteParts as u, findConflicts as d, formatPhaseAtom as f, formatRoute as p, getGestureDescriptor as m, isKnownGestureName as h, parseRoute as g, reportRouteConflicts as _, routeGestureForSpecKind as v, routesForSpec as y, specKindForRouteGesture as b } from "@weasel-js/routing";
+export { e as GESTURE_DESCRIPTORS, t as PREDICATE_TARGET, n as RESERVED_ID_NAMES, r as RESERVED_ID_PREFIXES, i as ROUTE_FIELD_DEFINITIONS, a as ROUTE_TERMS, o as buildRouteRegistry, s as canonicalModifiers, c as collapseShiftPairs, l as describeRoute, u as describeRouteParts, d as findConflicts, f as formatPhaseAtom, p as formatRoute, m as getGestureDescriptor, h as isKnownGestureName, g as parseRoute, _ as reportRouteConflicts, v as routeGestureForSpecKind, y as routesForSpec, b as specKindForRouteGesture };

package/dist/scheduling/useVisibleRaf.js

@@ -0,0 +1,69 @@
+import { useCallback as e, useLayoutEffect as t, useMemo as n, useRef as r } from "react";
+import { useLatest as i } from "@weasel-js/react";
+//#region src/scheduling/useVisibleRaf.ts
+var a = () => typeof document < "u" && document.hidden, o = (e) => typeof e == "function" ? e() : e?.current ?? null;
+function s(s, c = {}) {
+	let l = i(s), u = i(c), d = r(null), f = r(!1), p = r(!1), m = r(!0), h = r(!0), g = r(null), _ = r(null), v = e(() => u.current.dangerouslyRunWhenHidden === !0 || !a() && h.current, [u]), y = e(() => {
+		d.current !== null && ((u.current.cancelFrame ?? cancelAnimationFrame)(d.current), d.current = null);
+	}, [u]), b = e(() => {
+		d.current === null && m.current && (d.current = (u.current.requestFrame ?? requestAnimationFrame)((e) => {
+			d.current = null, m.current && f.current && v() && (f.current = !1, l.current(e));
+		}));
+	}, [
+		l,
+		v,
+		u
+	]), x = e(() => {
+		let e = g.current;
+		if (!e) return;
+		let t = o(u.current.target);
+		t !== _.current && (_.current && e.unobserve(_.current), _.current = t, h.current = !0, t && e.observe(t));
+	}, [u]), S = e(() => {
+		if (!v()) {
+			if (p.current) return;
+			p.current = !0, y();
+			return;
+		}
+		p.current && (p.current = !1, m.current && (u.current.onResume?.(), f.current && b()));
+	}, [
+		y,
+		v,
+		u,
+		b
+	]), C = e(() => {
+		if (m.current) {
+			if (x(), f.current = !0, !v()) {
+				p.current = !0;
+				return;
+			}
+			b();
+		}
+	}, [
+		v,
+		b,
+		x
+	]), w = e(() => {
+		f.current = !1, y();
+	}, [y]);
+	return t(() => (m.current = !0, document.addEventListener("visibilitychange", S), typeof IntersectionObserver < "u" && (g.current = new IntersectionObserver((e) => {
+		h.current = e.some((e) => e.isIntersecting), S();
+	}), x()), () => {
+		m.current = !1, document.removeEventListener("visibilitychange", S), g.current?.disconnect(), g.current = null, _.current = null, h.current = !0, y(), f.current = !1, p.current = !1;
+	}), [
+		y,
+		S,
+		x
+	]), n(() => ({
+		request: C,
+		cancel: w,
+		isVisible: v
+	}), [
+		C,
+		w,
+		v
+	]);
+}
+//#endregion
+export { s as useVisibleRaf };
+
+//# sourceMappingURL=useVisibleRaf.js.map

package/dist/scheduling/useVisibleRaf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useVisibleRaf.js","names":["documentHidden","resolveTarget","target","useVisibleRaf","frameRef","useLatest","frame","optsRef","options","rafRef","useRef","pendingRef","suspendedRef","aliveRef","intersectingRef","observerRef","observedRef","isVisible","useCallback","cancelRaf","scheduleRaf","time","syncObserver","io","el","syncGate","request","cancel","useLayoutEffect","entries","useMemo"],"sources":["../../src/scheduling/useVisibleRaf.ts"],"sourcesContent":["/**\n * The one place weasel decides whether a frame may run, so that \"a loop does no\n * work nobody can see\" holds by construction rather than by every loop author\n * remembering. Nothing runs while the document is hidden; a loop that names an\n * element also stops while that element is outside the viewport.\n *\n * A request made while suspended is held, not dropped, and re-armed when the\n * surface comes back — so a loop never needs to poll visibility itself.\n */\n\nimport { type RefObject, useCallback, useLayoutEffect, useMemo, useRef } from 'react';\nimport { useLatest } from '@weasel-js/react';\n\n/** What a loop names as its element, resolved every time the gate is consulted\n *  so a ref filled in after mount still starts the observer. */\nexport type VisibleRafTarget = RefObject<Element | null> | (() => Element | null);\n\n/** Options for {@link useVisibleRaf}. */\nexport interface VisibleRafOptions {\n  /** Also gate on this element's intersection with the viewport. Omit it and\n   *  the loop is gated on document visibility alone. */\n  target?: VisibleRafTarget;\n  /**\n   * Run frames regardless of visibility. The escape hatch for a loop that is\n   * not painting for a viewer — an offscreen recording, an export driving its\n   * own frames. It is the wrong fix for a loop that stalls after a tab switch:\n   * that is a missing `request()`, and setting this hides it.\n   */\n  dangerouslyRunWhenHidden?: boolean;\n  /** Frame clock. Read live, so a test may inject one after mount. */\n  requestFrame?: (cb: FrameRequestCallback) => number;\n  cancelFrame?: (handle: number) => void;\n  /**\n   * Runs once when the loop leaves suspension, before the frame that follows\n   * it. Where a loop that measures elapsed time drops the interval it spent\n   * suspended — without it, an hour hidden arrives as one hour-long frame.\n   */\n  onResume?: () => void;\n}\n\n/** The handle {@link useVisibleRaf} returns. Nothing runs until `request()` is called. */\nexport interface VisibleRaf {\n  /** Ask for a frame. Idempotent while one is outstanding, and held rather than\n   *  dropped while suspended. Identity is stable for the component's lifetime. */\n  request(): void;\n  /** Drop the outstanding request, held or scheduled. */\n  cancel(): void;\n  /** Whether a frame would run right now. */\n  isVisible(): boolean;\n}\n\nconst documentHidden = (): boolean => typeof document !== 'undefined' && document.hidden;\n\nconst resolveTarget = (target: VisibleRafTarget | undefined): Element | null =>\n  typeof target === 'function' ? target() : (target?.current ?? null);\n\n/**\n * @param frame Runs on the frame, with the timestamp the clock supplied.\n *   A continuous loop calls `request()` again from inside it; a one-shot loop\n *   does not.\n */\nexport function useVisibleRaf(\n  frame: (time: number) => void,\n  options: VisibleRafOptions = {},\n): VisibleRaf {\n  const frameRef = useLatest(frame);\n  const optsRef = useLatest(options);\n\n  const rafRef = useRef<number | null>(null);\n  const pendingRef = useRef(false);\n  const suspendedRef = useRef(false);\n  const aliveRef = useRef(true);\n  const intersectingRef = useRef(true);\n  const observerRef = useRef<IntersectionObserver | null>(null);\n  const observedRef = useRef<Element | null>(null);\n\n  const isVisible = useCallback(\n    (): boolean =>\n      optsRef.current.dangerouslyRunWhenHidden === true ||\n      (!documentHidden() && intersectingRef.current),\n    [optsRef],\n  );\n\n  const cancelRaf = useCallback(() => {\n    if (rafRef.current === null) return;\n    (optsRef.current.cancelFrame ?? cancelAnimationFrame)(rafRef.current);\n    rafRef.current = null;\n  }, [optsRef]);\n\n  const scheduleRaf = useCallback(() => {\n    if (rafRef.current !== null || !aliveRef.current) return;\n    rafRef.current = (optsRef.current.requestFrame ?? requestAnimationFrame)((time) => {\n      // Released before the frame runs, so a `request()` issued from inside it\n      // schedules the next one instead of being swallowed.\n      rafRef.current = null;\n      if (!aliveRef.current || !pendingRef.current || !isVisible()) return;\n      pendingRef.current = false;\n      frameRef.current(time);\n    });\n  }, [frameRef, isVisible, optsRef]);\n\n  /** Attaches the observer once the named element exists. Ref callbacks and\n   *  lazily-mounted hosts fill their refs after this hook's effect has run. */\n  const syncObserver = useCallback(() => {\n    const io = observerRef.current;\n    if (!io) return;\n    const el = resolveTarget(optsRef.current.target);\n    if (el === observedRef.current) return;\n    if (observedRef.current) io.unobserve(observedRef.current);\n    observedRef.current = el;\n    // An element that has gone away stops gating rather than stopping the loop.\n    intersectingRef.current = true;\n    if (el) io.observe(el);\n  }, [optsRef]);\n\n  /** Re-reads the gate after something that could have changed it. Suspending\n   *  drops the outstanding frame but keeps the request; resuming hands the\n   *  loop its rebase before re-arming. */\n  const syncGate = useCallback(() => {\n    if (!isVisible()) {\n      if (suspendedRef.current) return;\n      suspendedRef.current = true;\n      cancelRaf();\n      return;\n    }\n    if (!suspendedRef.current) return;\n    suspendedRef.current = false;\n    if (!aliveRef.current) return;\n    optsRef.current.onResume?.();\n    if (pendingRef.current) scheduleRaf();\n  }, [cancelRaf, isVisible, optsRef, scheduleRaf]);\n\n  const request = useCallback(() => {\n    if (!aliveRef.current) return;\n    syncObserver();\n    pendingRef.current = true;\n    if (!isVisible()) {\n      suspendedRef.current = true;\n      return;\n    }\n    scheduleRaf();\n  }, [isVisible, scheduleRaf, syncObserver]);\n\n  const cancel = useCallback(() => {\n    pendingRef.current = false;\n    cancelRaf();\n  }, [cancelRaf]);\n\n  // Re-armed in setup because the refs survive StrictMode's simulated remount, and\n  // a layout effect so the arming precedes the host's own layout effects — a loop\n  // driven from one of those would otherwise be declined on the second mount.\n  useLayoutEffect(() => {\n    aliveRef.current = true;\n    document.addEventListener('visibilitychange', syncGate);\n    if (typeof IntersectionObserver !== 'undefined') {\n      observerRef.current = new IntersectionObserver((entries) => {\n        intersectingRef.current = entries.some((e) => e.isIntersecting);\n        syncGate();\n      });\n      syncObserver();\n    }\n    return () => {\n      aliveRef.current = false;\n      document.removeEventListener('visibilitychange', syncGate);\n      observerRef.current?.disconnect();\n      observerRef.current = null;\n      observedRef.current = null;\n      intersectingRef.current = true;\n      cancelRaf();\n      pendingRef.current = false;\n      suspendedRef.current = false;\n    };\n  }, [cancelRaf, syncGate, syncObserver]);\n\n  // Stable identity: `requestRedraw` and friends outlive the render that made\n  // them, and consumers capture the handle.\n  return useMemo(() => ({ request, cancel, isVisible }), [request, cancel, isVisible]);\n}\n"],"mappings":"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"}

package/dist/test-hook/createTestHook.js

@@ -0,0 +1,39 @@
+//#region src/test-hook/createTestHook.ts
+function e(e) {
+	let t, n = new Promise((e) => {
+		t = e;
+	}), r = /* @__PURE__ */ new Map();
+	return {
+		ready: n,
+		getScene() {
+			let t = e.getScene();
+			if (!t) throw Error("weasel test hook: scene not mounted yet");
+			return t.toJSON();
+		},
+		getSelection() {
+			return [...e.getSelectionIds()];
+		},
+		getView() {
+			return e.getView();
+		},
+		getActiveToolId() {
+			return e.getActiveToolId();
+		},
+		probe(e) {
+			let t = r.get(e);
+			return t ? t() : void 0;
+		},
+		registerProbe(e, t) {
+			return r.set(e, t), () => {
+				r.get(e) === t && r.delete(e);
+			};
+		},
+		_markReady() {
+			t();
+		}
+	};
+}
+//#endregion
+export { e as createTestHook };
+
+//# sourceMappingURL=createTestHook.js.map

package/dist/test-hook/createTestHook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createTestHook.js","names":["createTestHook","resolveReady","ready","r","probes","s","refs","fn","name"],"sources":["../../src/test-hook/createTestHook.ts"],"sourcesContent":["import type { TestHookRefs, WeaselTestHook } from './types';\n\nexport function createTestHook(refs: TestHookRefs): WeaselTestHook {\n  let resolveReady!: () => void;\n  const ready = new Promise<void>((r) => { resolveReady = r; });\n  const probes = new Map<string, () => unknown>();\n\n  return {\n    ready,\n    getScene() {\n      const s = refs.getScene();\n      if (!s) throw new Error('weasel test hook: scene not mounted yet');\n      return s.toJSON();\n    },\n    getSelection() {\n      return [...refs.getSelectionIds()];\n    },\n    getView() {\n      return refs.getView();\n    },\n    getActiveToolId() {\n      return refs.getActiveToolId();\n    },\n    probe<T = unknown>(name: string): T | undefined {\n      const fn = probes.get(name);\n      return fn ? (fn() as T) : undefined;\n    },\n    registerProbe<T>(name: string, fn: () => T) {\n      probes.set(name, fn as () => unknown);\n      return () => {\n        if (probes.get(name) === fn) probes.delete(name);\n      };\n    },\n    _markReady() {\n      resolveReady();\n    },\n  };\n}\n"],"mappings":";AAEA,SAAgBA,EAAe,GAAoC;CACjE,IAAIC,GACEC,IAAQ,IAAI,SAAe,MAAM;EAAE,IAAeC;CAAG,CAAC,GACtDC,oBAAS,IAAI,IAA2B;CAE9C,OAAO;EACL;EACA,WAAW;GACT,IAAMC,IAAIC,EAAK,SAAS;GACxB,IAAI,CAACD,GAAG,MAAU,MAAM,yCAAyC;GACjE,OAAOA,EAAE,OAAO;EAClB;EACA,eAAe;GACb,OAAO,CAAC,GAAGC,EAAK,gBAAgB,CAAC;EACnC;EACA,UAAU;GACR,OAAOA,EAAK,QAAQ;EACtB;EACA,kBAAkB;GAChB,OAAOA,EAAK,gBAAgB;EAC9B;EACA,MAAmB,GAA6B;GAC9C,IAAMC,IAAKH,EAAO,IAAII,CAAI;GAC1B,OAAOD,IAAMA,EAAG,IAAU,KAAA;EAC5B;EACA,cAAiB,GAAc,GAAa;GAE1C,OADAH,EAAO,IAAII,GAAMD,CAAmB,SACvB;IACX,AAAIH,EAAO,IAAII,CAAI,MAAMD,KAAIH,EAAO,OAAOI,CAAI;GACjD;EACF;EACA,aAAa;GACX,EAAa;EACf;CACF;AACF"}

package/dist/test-hook/install.js

@@ -0,0 +1,12 @@
+import { createTestHook as e } from "./createTestHook.js";
+//#region src/test-hook/install.ts
+function t(t) {
+	if (typeof window > "u" || typeof process < "u" && process.env.NODE_ENV === "production" || new URLSearchParams(window.location.search).get("test") !== "1") return null;
+	if (window.__weaselTest) return window.__weaselTest;
+	let n = e(t);
+	return window.__weaselTest = n, n;
+}
+//#endregion
+export { t as installTestHookIfRequested };
+
+//# sourceMappingURL=install.js.map

package/dist/test-hook/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","names":["installTestHookIfRequested","hook","createTestHook","refs"],"sources":["../../src/test-hook/install.ts"],"sourcesContent":["// src/test-hook/install.ts\nimport { createTestHook } from './createTestHook';\nimport type { TestHookRefs, WeaselTestHook } from './types';\n\n/** Attach `window.__weaselTest` and return the hook iff\n *    - `process.env.NODE_ENV !== 'production'` (never in production consumer\n *      builds — paired with a call-site gate in SceneCanvas so the entire\n *      module DCEs out), AND\n *    - the URL contains `?test=1`.\n *  Otherwise returns null and does not touch `window`. */\nexport function installTestHookIfRequested(refs: TestHookRefs): WeaselTestHook | null {\n  if (typeof window === 'undefined') return null;\n  // Defense in depth: even if the call-site gate is bypassed, never expose\n  // the hook in production.\n  if (typeof process !== 'undefined' && process.env?.NODE_ENV === 'production') return null;\n  const params = new URLSearchParams(window.location.search);\n  if (params.get('test') !== '1') return null;\n  // If a hook is already installed (HMR), keep it.\n  if (window.__weaselTest) return window.__weaselTest;\n  const hook = createTestHook(refs);\n  window.__weaselTest = hook;\n  return hook;\n}\n"],"mappings":";;AAUA,SAAgBA,EAA2B,GAA2C;CAMpF,IALI,OAAO,SAAW,OAGlB,OAAO,UAAY,OAAA,QAAA,IAAA,aAAyC,gBAE5D,IADe,gBAAgB,OAAO,SAAS,MAC/C,CAAA,CAAO,IAAI,MAAM,MAAM,KAAK,OAAO;CAEvC,IAAI,OAAO,cAAc,OAAO,OAAO;CACvC,IAAMC,IAAOC,EAAeC,CAAI;CAEhC,OADA,OAAO,eAAeF,GACfA;AACT"}