@weasel-js/core 1.4.0 → 1.4.1

package/dist/{registry-CxSEyDka.d.ts → registry-BwY_DxJM.d.ts}

@@ -5,7 +5,7 @@ import { CapabilityTag } from '@weasel-js/modes';
 import * as React from 'react';
 import { MutableRefObject, ReactNode, ReactElement } from 'react';
 import { GestureSpec, IngestItem, InputEvent } from '@weasel-js/gestures';
-import { D as DrawCommand } from './DrawCommand-b-z1bCT-.js';
+import { D as DrawCommand } from './DrawCommand-Ch8W63oQ.js';
 import { B as Bounds, P as PoseProjection, F as FitViewToBoundsOptions, V as ViewportDims } from './geometry-Dtt_k6Dq.js';
 import { FillStyle, Stroke } from '@weasel-js/paint';
 import { CursorSpec } from '@weasel-js/cursor';
@@ -1478,6 +1478,58 @@ interface ContentHandlerEntry {
 /** Register a content handler. Returns a disposer that removes it. */
 declare function registerContentHandler(entry: ContentHandlerEntry): () => void;
 
+/** Per-axis limits on a view's position. Any side may be left open. */
+interface PanBounds {
+    minX?: number;
+    maxX?: number;
+    minY?: number;
+    maxY?: number;
+}
+/** Momentum settings for a pan: how quickly a flung view slows, when it stops,
+ *  and what happens at the pan limits. The `DecayLoopConfig` fields a caller
+ *  chooses up front, without the per-gesture `velocity` / `onTick`. */
+interface InertiaConfig {
+    friction?: number;
+    minSpeed?: number;
+    /** What to do when inertial pan reaches `bounds`. Default: no clamping. */
+    boundary?: 'stop' | 'bounce' | 'spring';
+    /** View-coordinate limits for boundary clamping. Requires `boundary` to take effect. */
+    bounds?: PanBounds;
+}
+/** How a decay should run: its starting velocity, how fast it slows, and what
+ *  happens if it reaches the pan limits. */
+interface DecayLoopConfig {
+    velocity: {
+        vx: number;
+        vy: number;
+    };
+    friction?: number;
+    minSpeed?: number;
+    /** Bounds for boundary clamping. Requires `boundary` to take effect. */
+    viewBounds?: PanBounds;
+    /**
+     * What to do when the accumulated position hits `viewBounds`. Default: no clamping.
+     * - `'stop'`: clamp at boundary, kill velocity component.
+     * - `'bounce'`: linear reflection — flip velocity sign, magnitude preserved.
+     * - `'spring'`: damped reflection — flip velocity sign and shrink magnitude
+     *   by `SPRING_DAMPING` per bounce so the motion settles naturally.
+     */
+    boundary?: 'stop' | 'bounce' | 'spring';
+    /** Starting position for internal boundary tracking. Required when `viewBounds` is set. */
+    initialPosition?: {
+        x: number;
+        y: number;
+    };
+    onTick: (dx: number, dy: number) => void;
+    onEnd?: () => void;
+}
+/** A rAF loop that coasts a value to a stop under friction, reporting the
+ *  per-frame delta. What turns a released pan drag into momentum scrolling. */
+declare function useDecayLoop(): {
+    start: (config: DecayLoopConfig) => void;
+    cancel: () => void;
+};
+
 /** Which of a node's two per-anchor color arrays an override applies to. */
 type VertexColorChannel = 'fill' | 'stroke';
 /** Function-form override: receives the consumer-supplied base color
@@ -2408,6 +2460,11 @@ interface ViewApi {
     /** Where an in-flight camera animation is heading, or null. Compute the next
      *  discrete step from this so repeated presses compound. */
     animationTarget?(): View | null;
+    /** Optional momentum decay. `<SceneCanvas>` wires this from `useDecayLoop`;
+     *  a consumer publishing their own `view` dep need not, and `viewport.dragPan`
+     *  simply lands the pan without coasting. */
+    decay?(config: DecayLoopConfig): void;
+    stopDecay?(): void;
 }
 /**
  * Adapter dep for `areaSelectAction`.
@@ -3139,15 +3196,12 @@ interface ToolDef<TScratch = void> {
  *  authoring signal that a tool pans/zooms the view rather than the scene. */
 type ViewportToolDef<TScratch = void> = ToolDef<TScratch>;
 
-/** Modifier-key snapshot at event dispatch time. `space` is included
- *  because tools commonly use space as a hotkey-slot trigger and may
- *  also want to read it as a flag mid-gesture. */
+/** Modifier-key snapshot at event dispatch time. */
 interface ToolModifiers {
     alt: boolean;
     shift: boolean;
     meta: boolean;
     ctrl: boolean;
-    space: boolean;
 }
 /** Per-event context passed to every channel handler. `scratch` is typed
  *  via the tool's `TScratch` parameter; it survives across a single
@@ -3790,7 +3844,13 @@ type ActionsProp = null | Record<string, ActionEntry>;
  * Imperative API exposed by `useActionsRegistry()`.
  */
 interface ActionsRegistry {
+    /** Add an action and return its release. Registrants for one id stack,
+     *  newest live, so releasing yours uncovers whoever you displaced. Call it
+     *  from an effect and release it in that effect's cleanup — registering from
+     *  a render body pushes an entry per render and releases none. */
     register(action: Action): () => void;
+    /** Drop every registrant of `id`. This is the "this action should not exist"
+     *  door, not a release — for that, call what `register` returned. */
     unregister(id: string): void;
     list(): readonly Action[];
     /** Fire an immediate-invoker action by id. The optional `params` arg is
@@ -3850,4 +3910,4 @@ declare function useActionsRegistry(): ActionsRegistry | null;
  */
 declare function useAction(action: Action): void;
 
-export { type ActionDeps as $, type Action as A, type BuiltinShapeToolId as B, type Condition as C, type Dims as D, ColorOverrideRegistry as E, type BooleansAdapter as F, type GeometryProjection as G, type HotkeyTrigger as H, type InsertExtras as I, type UseAnimatorOptions as J, type SpringPresetName as K, type LayerHit as L, type EasingSpec as M, type AnimationHandle as N, type OverlayPosition as O, type VertexColorChannel as P, type SampledTrack as Q, type RenderLayer as R, type SliceDep as S, type Tool as T, type UseSelectionOptions as U, type VisibilityRules as V, type Eligibility as W, type BindingScope as X, type Contribution as Y, type ScopedBinding as Z, ALWAYS as _, type DeviceProfile as a, type PoseComposition as a$, ActionDisabledReason as a0, type ActionEnabledResult as a1, type ActionEntry as a2, ActionsProvider as a3, ActiveToolContextProvider as a4, ActiveToolContextProviderIfRoot as a5, type ActiveToolContextProviderProps as a6, type ActiveToolContextValue as a7, type AnimateToBoundsOptions as a8, type AreaSelectDep as a9, type IngestCtx as aA, type IngestionDep as aB, type InsertDep as aC, type Interpolate as aD, type InterpolatorFactory as aE, type InvocationCtx as aF, type Invoker as aG, KIT_SHAPE_KINDS as aH, type Keyframe as aI, type LassoSelectDep as aJ, type LayerCommandCache as aK, type LayoutDep as aL, type LoopFactory as aM, type LoopOptions as aN, type MatchResult as aO, NEVER as aP, type NestedTimeline as aQ, type NodeAtPointDep as aR, type OngoingHandle as aS, type OngoingInvoker as aT, type PhysicsHandle as aU, type PhysicsOptions as aV, type Point2 as aW, PointerContextProvider as aX, type PointerContextValue as aY, type PointerWorldPos as aZ, type PoseAdapter as a_, type BezierEasing as aa, type BindingOpts as ab, type BooleanOp as ac, type BooleanOpResult as ad, type BoundGesture as ae, type BuildRuleCtxArgs as af, type ClaimableGesture as ag, type ClipboardDep as ah, type ClipboardIngestCtx as ai, type ColorOverride as aj, type ColorOverrideFn as ak, type CustomPaintContext as al, type DecayOptions as am, type DepName as an, type DepRegistry as ao, DepRegistryProvider as ap, type DispatcherContext as aq, type DragSample as ar, EASINGS as as, type EasingFn as at, type EasingName as au, type EditAnchorsDep as av, type EventTrack as aw, type GestureBinding as ax, IDENTITY_POSE_COMPOSITION as ay, type ImmediateInvoker as az, type DetectedDeviceFacts as b, easeInOutQuart as b$, type ResizePolicy as b0, type ResolveAllOptions as b1, type ResolveOnlyResult as b2, type ResolvedCandidate as b3, SPRING_PRESETS as b4, type SelectionExtendKey as b5, type SelectionMode as b6, type Selector as b7, type SnapDep as b8, type SpringOptions as b9, applyBooleanOp as bA, buildRuleCtx as bB, clipboardCopyAction as bC, clipboardCutAction as bD, composeRectPose as bE, composeWorldPose as bF, createDispatcher as bG, cubicBezierEasing as bH, decomposeRectPose as bI, describeRule as bJ, drawLayers as bK, drawOneLayer as bL, easeIn as bM, easeInBack as bN, easeInBounce as bO, easeInCirc as bP, easeInCubic as bQ, easeInElastic as bR, easeInExpo as bS, easeInOut as bT, easeInOutBack as bU, easeInOutBounce as bV, easeInOutCirc as bW, easeInOutCubic as bX, easeInOutElastic as bY, easeInOutExpo as bZ, easeInOutQuad as b_, type SpringPreset as ba, type StaggerBuilder as bb, type StaggerDelay as bc, type StaggerFactory as bd, type StaggerOptions as be, type StaggerPerItem as bf, type StaggerSpringPoseOptions as bg, type StaggerTweenOptions as bh, type SvgUnpacker as bi, type TextEditDep as bj, type TimelineHandle as bk, type TimelineOptions as bl, type TimelineTrack as bm, type ToolCtx as bn, type ToolModifiers as bo, type ToolPresentation as bp, type ToolSlot as bq, type Track as br, type TweenLoopOptions as bs, type TweenOptions as bt, type UiOngoingControl as bu, VIEW_ANIMATION_KEY as bv, type ViewAnimationApi as bw, type ViewApi as bx, type ViewChannel as by, actionBindings as bz, type Rule as c, easeInOutQuint as c0, easeInOutSine as c1, easeInQuad as c2, easeInQuart as c3, easeInQuint as c4, easeInSine as c5, easeOut as c6, easeOutBack as c7, easeOutBounce as c8, easeOutCirc as c9, useOptionalDepRegistry as cA, usePointerContext as cB, useSelection as cC, useViewAnimation as cD, worldPoseLookup as cE, easeOutCubic as ca, easeOutElastic as cb, easeOutExpo as cc, easeOutQuad as cd, easeOutQuart as ce, easeOutQuint as cf, easeOutSine as cg, enterTextEditAction as ch, evaluate as ci, evaluateEnabled as cj, isLayerPainted as ck, isLayerVisible as cl, linear as cm, rebaseLocalPose as cn, registerContentHandler as co, resolveEasing as cp, resolveParams as cq, sliceAction as cr, specificity as cs, translateRectPose as ct, useAction as cu, useActionsRegistry as cv, useActiveToolContext as cw, useDepRegistry as cx, useDepSource as cy, useOptionalActiveToolContext as cz, type RuleCtx as d, type ChromeCtx as e, type ChromeId as f, type ViewAnimationOptions as g, type DepSchema as h, type ActionsRegistry as i, type AffordanceHit as j, type Dispatcher as k, type ToolDef as l, type ViewportToolDef as m, type AnyTool as n, type ToolKeybinding as o, type OngoingOverlay as p, type ChromeState as q, type SelectionApi as r, type ContentHandlerEntry as s, type SvgIngestOptions as t, type ActionsProp as u, type Animator as v, type Affordance as w, type AffordanceRegion as x, type AffordanceBinding as y, type CommonAffordanceScratch as z };
+export { type ScopedBinding as $, type Action as A, type BuiltinShapeToolId as B, type Condition as C, type Dims as D, type CommonAffordanceScratch as E, ColorOverrideRegistry as F, type GeometryProjection as G, type HotkeyTrigger as H, type InertiaConfig as I, type BooleansAdapter as J, type UseAnimatorOptions as K, type LayerHit as L, type SpringPresetName as M, type EasingSpec as N, type OverlayPosition as O, type PanBounds as P, type AnimationHandle as Q, type RenderLayer as R, type SliceDep as S, type Tool as T, type UseSelectionOptions as U, type VisibilityRules as V, type VertexColorChannel as W, type SampledTrack as X, type Eligibility as Y, type BindingScope as Z, type Contribution as _, type DeviceProfile as a, type PointerContextValue as a$, ALWAYS as a0, type ActionDeps as a1, ActionDisabledReason as a2, type ActionEnabledResult as a3, type ActionEntry as a4, ActionsProvider as a5, ActiveToolContextProvider as a6, ActiveToolContextProviderIfRoot as a7, type ActiveToolContextProviderProps as a8, type ActiveToolContextValue as a9, type GestureBinding as aA, IDENTITY_POSE_COMPOSITION as aB, type ImmediateInvoker as aC, type IngestCtx as aD, type IngestionDep as aE, type InsertDep as aF, type Interpolate as aG, type InterpolatorFactory as aH, type InvocationCtx as aI, type Invoker as aJ, KIT_SHAPE_KINDS as aK, type Keyframe as aL, type LassoSelectDep as aM, type LayerCommandCache as aN, type LayoutDep as aO, type LoopFactory as aP, type LoopOptions as aQ, type MatchResult as aR, NEVER as aS, type NestedTimeline as aT, type NodeAtPointDep as aU, type OngoingHandle as aV, type OngoingInvoker as aW, type PhysicsHandle as aX, type PhysicsOptions as aY, type Point2 as aZ, PointerContextProvider as a_, type AnimateToBoundsOptions as aa, type AreaSelectDep as ab, type BezierEasing as ac, type BindingOpts as ad, type BooleanOp as ae, type BooleanOpResult as af, type BoundGesture as ag, type BuildRuleCtxArgs as ah, type ClaimableGesture as ai, type ClipboardDep as aj, type ClipboardIngestCtx as ak, type ColorOverride as al, type ColorOverrideFn as am, type CustomPaintContext as an, type DecayLoopConfig as ao, type DecayOptions as ap, type DepName as aq, type DepRegistry as ar, DepRegistryProvider as as, type DispatcherContext as at, type DragSample as au, EASINGS as av, type EasingFn as aw, type EasingName as ax, type EditAnchorsDep as ay, type EventTrack as az, type DetectedDeviceFacts as b, easeInOutElastic as b$, type PointerWorldPos as b0, type PoseAdapter as b1, type PoseComposition as b2, type ResizePolicy as b3, type ResolveAllOptions as b4, type ResolveOnlyResult as b5, type ResolvedCandidate as b6, SPRING_PRESETS as b7, type SelectionExtendKey as b8, type SelectionMode as b9, type ViewApi as bA, type ViewChannel as bB, actionBindings as bC, applyBooleanOp as bD, buildRuleCtx as bE, clipboardCopyAction as bF, clipboardCutAction as bG, composeRectPose as bH, composeWorldPose as bI, createDispatcher as bJ, cubicBezierEasing as bK, decomposeRectPose as bL, describeRule as bM, drawLayers as bN, drawOneLayer as bO, easeIn as bP, easeInBack as bQ, easeInBounce as bR, easeInCirc as bS, easeInCubic as bT, easeInElastic as bU, easeInExpo as bV, easeInOut as bW, easeInOutBack as bX, easeInOutBounce as bY, easeInOutCirc as bZ, easeInOutCubic as b_, type Selector as ba, type SnapDep as bb, type SpringOptions as bc, type SpringPreset as bd, type StaggerBuilder as be, type StaggerDelay as bf, type StaggerFactory as bg, type StaggerOptions as bh, type StaggerPerItem as bi, type StaggerSpringPoseOptions as bj, type StaggerTweenOptions as bk, type SvgUnpacker as bl, type TextEditDep as bm, type TimelineHandle as bn, type TimelineOptions as bo, type TimelineTrack as bp, type ToolCtx as bq, type ToolModifiers as br, type ToolPresentation as bs, type ToolSlot as bt, type Track as bu, type TweenLoopOptions as bv, type TweenOptions as bw, type UiOngoingControl as bx, VIEW_ANIMATION_KEY as by, type ViewAnimationApi as bz, type Rule as c, easeInOutExpo as c0, easeInOutQuad as c1, easeInOutQuart as c2, easeInOutQuint as c3, easeInOutSine as c4, easeInQuad as c5, easeInQuart as c6, easeInQuint as c7, easeInSine as c8, easeOut as c9, useDecayLoop as cA, useDepRegistry as cB, useDepSource as cC, useOptionalActiveToolContext as cD, useOptionalDepRegistry as cE, usePointerContext as cF, useSelection as cG, useViewAnimation as cH, worldPoseLookup as cI, easeOutBack as ca, easeOutBounce as cb, easeOutCirc as cc, easeOutCubic as cd, easeOutElastic as ce, easeOutExpo as cf, easeOutQuad as cg, easeOutQuart as ch, easeOutQuint as ci, easeOutSine as cj, enterTextEditAction as ck, evaluate as cl, evaluateEnabled as cm, isLayerPainted as cn, isLayerVisible as co, linear as cp, rebaseLocalPose as cq, registerContentHandler as cr, resolveEasing as cs, resolveParams as ct, sliceAction as cu, specificity as cv, translateRectPose as cw, useAction as cx, useActionsRegistry as cy, useActiveToolContext as cz, type RuleCtx as d, type ChromeCtx as e, type ChromeId as f, type ViewAnimationOptions as g, type DepSchema as h, type ActionsRegistry as i, type AffordanceHit as j, type Dispatcher as k, type ToolDef as l, type ViewportToolDef as m, type AnyTool as n, type ToolKeybinding as o, type OngoingOverlay as p, type ChromeState as q, type SelectionApi as r, type InsertExtras as s, type ContentHandlerEntry as t, type SvgIngestOptions as u, type ActionsProp as v, type Animator as w, type Affordance as x, type AffordanceRegion as y, type AffordanceBinding as z };

package/dist/renderer.d.ts

@@ -1,6 +1,6 @@
-import { M as Mesh } from './stroke-B_BxktoE.js';
-export { I as IDENTITY_COLOR_MATRIX, a as ImageMinification, R as RenderTarget, S as ShaderCompileError, b as SpriteSheet, c as StrokeOptions, V as ViewLike, W as WeaselRenderer, d as WeaselRendererOptions, e as buildGradientRamp, f as frameRect, t as tessellateStroke, v as viewToMat3 } from './stroke-B_BxktoE.js';
-export { D as DrawCommand, G as GroupDrawCommand, I as ImageDrawCommand, M as Mat3, P as PathDrawCommand, S as ShaderDrawCommand, a as ShaderProgramHandle, b as ShaderUniform, c as SolidPaint, T as TextDrawCommand, m as mat3, r as registerProgram } from './DrawCommand-b-z1bCT-.js';
+import { M as Mesh } from './stroke-Dq8nL4A2.js';
+export { I as IDENTITY_COLOR_MATRIX, a as ImageMinification, R as RenderTarget, S as ShaderCompileError, b as SpriteSheet, c as StrokeOptions, V as ViewLike, W as WeaselRenderer, d as WeaselRendererOptions, e as buildGradientRamp, f as frameRect, t as tessellateStroke, v as viewToMat3 } from './stroke-Dq8nL4A2.js';
+export { D as DrawCommand, G as GroupDrawCommand, I as ImageDrawCommand, M as Mat3, P as PathDrawCommand, S as SPRITE_STRIDE, a as ShaderDrawCommand, b as ShaderProgramHandle, c as ShaderUniform, d as SolidPaint, e as SpritesDrawCommand, T as TextDrawCommand, m as mat3, r as registerProgram } from './DrawCommand-Ch8W63oQ.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';
 import { TextureHandle } from '@weasel-js/paint';

package/dist/renderer.js

@@ -1,5 +1,5 @@
-export { IDENTITY_COLOR_MATRIX, OUTLINE_MIN_SCREEN_PX, ShaderCompileError, WeaselRenderer, buildGradientRamp, canQueryLocalFonts, enableLocalFontOutlines, frameRect, hasFontOutlines, isCanvasFont, listFontOutlines, mat3, outlineStatus, registerCanvasFont, registerFont, registerFontOutlines, registerProgram, subscribeGlyphReady, tessellate, tessellateStroke, unregisterCanvasFont, unregisterFontOutlines, viewToMat3 } from './chunk-HYJL7OOJ.js';
-import './chunk-UTIFY2UU.js';
+export { IDENTITY_COLOR_MATRIX, OUTLINE_MIN_SCREEN_PX, SPRITE_STRIDE, ShaderCompileError, WeaselRenderer, buildGradientRamp, canQueryLocalFonts, enableLocalFontOutlines, frameRect, hasFontOutlines, isCanvasFont, listFontOutlines, mat3, outlineStatus, registerCanvasFont, registerFont, registerFontOutlines, registerProgram, subscribeGlyphReady, tessellate, tessellateStroke, unregisterCanvasFont, unregisterFontOutlines, viewToMat3 } from './chunk-NU7D64RL.js';
+import './chunk-TORKRNFY.js';
 import './chunk-Y5KS66G7.js';
 import './chunk-BLJNRMKB.js';
 import './chunk-SBFC6J3C.js';

package/dist/routing.d.ts

@@ -1,6 +1,6 @@
 import { ParsedModifiers, GestureName, GestureSpec } from '@weasel-js/gestures';
 export { ChannelRef, DescribeRouteOptions, GESTURE_DESCRIPTORS, GestureArgSpec, GestureDescriptor, GestureName, ModRequirement, ModifierKey, ParsedModifiers, ParsedRoute, PhaseAtom, RESERVED_ID_NAMES, RESERVED_ID_PREFIXES, ROUTE_FIELD_DEFINITIONS, ROUTE_TERMS, RouteDescriptionPart, RouteFieldName, RouteTermLabel, canonicalModifiers, collapseShiftPairs, describeRoute, describeRouteParts, formatPhaseAtom, formatRoute, getGestureDescriptor, isKnownGestureName, parseRoute } from '@weasel-js/gestures';
-import { T as Tool } from './registry-CxSEyDka.js';
+import { T as Tool } from './registry-BwY_DxJM.js';
 import './types-DIQAisSG.js';
 import '@weasel-js/history';
 import './path-JEV2c5If.js';
@@ -9,7 +9,7 @@ import './types-XBcDEp3Y.js';
 import './view-DSQgxBJB.js';
 import '@weasel-js/modes';
 import 'react';
-import './DrawCommand-b-z1bCT-.js';
+import './DrawCommand-Ch8W63oQ.js';
 import '@weasel-js/paint';
 import '@weasel-js/text';
 import './geometry-Dtt_k6Dq.js';

package/dist/routing.js

@@ -1,3 +1,3 @@
-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, routeGestureForSpecKind, routesForSpec } from './chunk-UTIFY2UU.js';
+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, routeGestureForSpecKind, routesForSpec } from './chunk-TORKRNFY.js';
 //# sourceMappingURL=routing.js.map
 //# sourceMappingURL=routing.js.map

package/dist/{stroke-B_BxktoE.d.ts → stroke-Dq8nL4A2.d.ts}

@@ -1,5 +1,5 @@
 import { GradStop, Stroke } from '@weasel-js/paint';
-import { M as Mat3, a as ShaderProgramHandle, D as DrawCommand } from './DrawCommand-b-z1bCT-.js';
+import { M as Mat3, b as ShaderProgramHandle, D as DrawCommand } from './DrawCommand-Ch8W63oQ.js';
 import { P as Path } from './path-JEV2c5If.js';
 
 /**
@@ -343,6 +343,67 @@ declare class SolidBatch {
     private deleteSet;
 }
 
+/**
+ * Growable vertex staging for consecutive image quads.
+ *
+ * Geometry only: `draw.ts` owns when a run starts, what breaks it, and the
+ * uniforms the flush draws under. The counterpart to `SolidBatch`, and the same
+ * two tricks — the model transform is applied here rather than uploaded, so
+ * quads under different group transforms still share a draw, and opacity rides
+ * the vertices, so quads under different opacities do too. What it cannot
+ * absorb is the texture: a batch samples one, which is why an atlas is what
+ * makes a large run coalesce at all.
+ *
+ * Every run is quads, so a slot's index buffer is written once at creation and
+ * never again: the pattern for N quads is a prefix of the pattern for any
+ * larger N, so the pattern for a slot's capacity serves every flush it takes.
+ * `SolidBatch` carries meshes, whose indices are rebased per flush, and has to
+ * re-upload; this does not.
+ */
+
+declare class ImageBatch {
+    private readonly gl;
+    private readonly aPos;
+    private readonly aUv;
+    private readonly aOpacity;
+    /** One ring per tier, cycled per flush. Slots are created on first use, so a
+     *  renderer that flushes rarely allocates as few as it flushes. */
+    private readonly rings;
+    private readonly nextInRing;
+    /** For flushes past the largest tier; these sets grow to fit. */
+    private readonly largeRing;
+    private nextLarge;
+    private verts;
+    private nQuads;
+    constructor(gl: WebGL2RenderingContext, prog: ShaderProgram);
+    /** Indices staged — what a caller passes to `drawElements`. */
+    get length(): number;
+    get quads(): number;
+    /** Whether staging one more quad would put the run past the per-flush cap. */
+    wouldOverflow(): boolean;
+    /**
+     * Append one image quad: the destination rect `(x, y, w, h)` mapped through
+     * `m`, sampling `(u0, v0)`-`(u1, v1)`, every corner carrying `opacity`.
+     *
+     * An affine maps a rect to a parallelogram, so two triangles still cover it
+     * and the batch draws at `u_model` identity. Corners wind top-left,
+     * top-right, bottom-right, bottom-left, with UVs following — the flips a
+     * command asks for are already in the `u`/`v` the caller passes.
+     */
+    pushQuad(x: number, y: number, w: number, h: number, m: Mat3, u0: number, v0: number, u1: number, v1: number, opacity: number): void;
+    /** Upload the staged geometry into the next set of buffers and bind its VAO.
+     *  Returns the index count for the caller's `drawElements`. */
+    uploadAndBind(): number;
+    reset(): void;
+    dispose(): void;
+    /** Grow the CPU arrays so one more quad fits. */
+    private reserve;
+    private nextRingSlot;
+    private nextLargeSlot;
+    private createSet;
+    private deleteSet;
+}
+
 /** How to construct a `WeaselRenderer`: the GL context or canvas to draw
  *  into, the output size, and the quality knobs that separate screen
  *  rendering from print. */
@@ -412,6 +473,7 @@ declare class WeaselRenderer {
     private textSdf;
     private textSdfR8;
     private imageFill;
+    private imageFillVOpacity;
     private gradFill;
     private patternFill;
     private meshCache;
@@ -422,6 +484,7 @@ declare class WeaselRenderer {
     private quadVbo;
     private quadIbo;
     private solidBatch;
+    private imageBatch;
     private readonly groupState;
     private widthCss;
     private heightCss;
@@ -515,9 +578,11 @@ declare class WeaselRenderer {
     /** @internal */ _pathFill(): ShaderProgram;
     /** @internal */ _pathFillVColor(): ShaderProgram;
     /** @internal */ _solidBatch(): SolidBatch;
+    /** @internal */ _imageBatch(): ImageBatch;
     /** @internal */ _textSdf(): ShaderProgram;
     /** @internal */ _textSdfR8(): ShaderProgram;
     /** @internal */ _imageFill(): ShaderProgram;
+    /** @internal */ _imageFillVOpacity(): ShaderProgram;
     /** @internal */ _gradFill(): ShaderProgram;
     /** @internal */ _patternFill(): ShaderProgram;
     /** @internal */ _meshCache(): GLMeshCache;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@weasel-js/core",
-  "version": "1.4.0",
+  "version": "1.4.1",
   "description": "Domain-agnostic 2D scene graph primitives for React: viewport math, drag/resize/insert/clone interactions, layered canvas rendering.",
   "license": "MIT",
   "author": "orochi235",
@@ -72,16 +72,16 @@
   },
   "peerDependencies": {
     "react": ">=18",
-    "@weasel-js/font": "1.4.0"
+    "@weasel-js/font": "1.4.1"
   },
   "dependencies": {
-    "@weasel-js/cursor": "1.4.0",
-    "@weasel-js/geom": "1.4.0",
-    "@weasel-js/gestures": "1.4.0",
-    "@weasel-js/history": "1.4.0",
-    "@weasel-js/modes": "1.4.0",
-    "@weasel-js/paint": "1.4.0",
-    "@weasel-js/text": "1.4.0",
+    "@weasel-js/cursor": "1.4.1",
+    "@weasel-js/geom": "1.4.1",
+    "@weasel-js/gestures": "1.4.1",
+    "@weasel-js/history": "1.4.1",
+    "@weasel-js/modes": "1.4.1",
+    "@weasel-js/paint": "1.4.1",
+    "@weasel-js/text": "1.4.1",
     "earcut": "2.2.4",
     "polygon-clipping": "^0.15.7"
   },