@flare-engine/render 0.2.0 → 0.3.0

package/dist/index.d.mts

@@ -1,11 +1,97 @@
-import { Rect, Vec2 } from '@flare-engine/math';
-import { SkImageLike, SpriteFrame } from '@flare-engine/assets';
-import { ComponentDef, World, Query } from '@flare-engine/ecs';
-
+import { ComponentDef, Query, World } from "@flare-engine/ecs";
+import { Rect, Vec2 } from "@flare-engine/math";
+import { SkImageLike, SpriteFrame } from "@flare-engine/assets";
+//#region src/camera2d.d.ts
+/** Camera follow smoothing options. */
+interface FollowOptions {
+  /** Smoothing factor (0 = instant, lower = faster, default 0.1). */
+  smoothing?: number;
+  /** Offset from target (e.g. look-ahead). */
+  offset?: Vec2;
+  /** Dead zone rect — camera won't move while target is inside. */
+  deadZone?: Rect;
+}
+/**
+ * Camera2D — 2D camera with position, zoom, rotation, follow, and shake.
+ * Pure data + methods — no Skia dependency. The renderer reads camera state
+ * to build the view transform.
+ */
+declare class Camera2D {
+  /** Camera position (world-space center). */
+  x: number;
+  y: number;
+  /** Zoom level (1 = 100%). */
+  zoom: number;
+  /** Rotation in radians. */
+  rotation: number;
+  /** Viewport width in pixels. */
+  viewportWidth: number;
+  /** Viewport height in pixels. */
+  viewportHeight: number;
+  /** Optional world bounds to clamp camera position. */
+  bounds: Rect | null;
+  private _follow;
+  private _shake;
+  private _shakePerlin;
+  private _shakeSeed;
+  private _shakePerlinSeed;
+  private _motionScale;
+  /** Set viewport dimensions. */
+  setViewport(width: number, height: number): void;
+  /** Start following a target position. */
+  follow(target: Vec2, options?: FollowOptions): void;
+  /** Stop following. */
+  unfollow(): void;
+  /**
+   * Global motion multiplier applied to subsequent `shake()` calls. Scales
+   * both amplitude and duration. Default 1 (no-op). 0 fully suppresses
+   * shake. Intended to be driven by `@flare-engine/a11y` reduced-motion so
+   * callers don't have to guard every shake site.
+   *
+   * Only affects future `shake()` calls — does not retroactively modify an
+   * in-flight shake.
+   *
+   * Clamped to `>= 0`.
+   */
+  setMotionScale(scale: number): void;
+  /** Current motion scale (default 1). */
+  get motionScale(): number;
+  /** Start camera shake. */
+  shake(intensity: number, duration: number): void;
+  /**
+   * Start a Perlin-noise-based camera shake. Overwrites any in-flight
+   * shakePerlin (same semantics as shake()). Respects motionScale.
+   */
+  shakePerlin(intensity: number, duration: number): void;
+  /**
+   * Update camera. Call once per frame.
+   * @param dt Delta time in seconds.
+   */
+  update(dt: number): void;
+  /** Get the effective camera X (including shake + shakePerlin offsets). */
+  get effectiveX(): number;
+  /** Get the effective camera Y (including shake + shakePerlin offsets). */
+  get effectiveY(): number;
+  /** Convert world coordinates to screen coordinates. */
+  worldToScreen(worldX: number, worldY: number): Vec2;
+  /** Zero-alloc variant — writes screen coordinates into `out`. */
+  worldToScreenInto(worldX: number, worldY: number, out: Vec2): Vec2;
+  /** Convert screen coordinates to world coordinates. */
+  screenToWorld(screenX: number, screenY: number): Vec2;
+  /** Zero-alloc variant — writes world coordinates into `out`. */
+  screenToWorldInto(screenX: number, screenY: number, out: Vec2): Vec2;
+  /** Get the visible world-space bounding rect (allocates a fresh Rect). */
+  getBounds(): Rect;
+  /** Zero-alloc variant — writes the visible bounds into `out`. */
+  getBoundsInto(out: Rect): Rect;
+  private _clampToBounds;
+}
+//#endregion
+//#region src/draw-order.d.ts
 /** A drawable item with a z-order for sorting. */
 interface Drawable {
-    /** Z-index for draw ordering. Higher values draw on top. */
-    z: number;
+  /** Z-index for draw ordering. Higher values draw on top. */
+  z: number;
 }
 /**
  * Sort an array of drawables by z-index (ascending = back to front).
@@ -24,175 +110,111 @@ declare function sortByDrawOrder<T extends Drawable>(items: T[], length?: number
  * Stable relative order for equal z values (returns 0).
  */
 declare function drawOrderCompare(a: Drawable, b: Drawable): number;
-
-/** Camera follow smoothing options. */
-interface FollowOptions {
-    /** Smoothing factor (0 = instant, lower = faster, default 0.1). */
-    smoothing?: number;
-    /** Offset from target (e.g. look-ahead). */
-    offset?: Vec2;
-    /** Dead zone rect — camera won't move while target is inside. */
-    deadZone?: Rect;
-}
-/**
- * Camera2D — 2D camera with position, zoom, rotation, follow, and shake.
- * Pure data + methods — no Skia dependency. The renderer reads camera state
- * to build the view transform.
- */
-declare class Camera2D {
-    /** Camera position (world-space center). */
-    x: number;
-    y: number;
-    /** Zoom level (1 = 100%). */
-    zoom: number;
-    /** Rotation in radians. */
-    rotation: number;
-    /** Viewport width in pixels. */
-    viewportWidth: number;
-    /** Viewport height in pixels. */
-    viewportHeight: number;
-    /** Optional world bounds to clamp camera position. */
-    bounds: Rect | null;
-    private _follow;
-    private _shake;
-    private _shakePerlin;
-    private _shakeSeed;
-    private _shakePerlinSeed;
-    private _motionScale;
-    /** Set viewport dimensions. */
-    setViewport(width: number, height: number): void;
-    /** Start following a target position. */
-    follow(target: Vec2, options?: FollowOptions): void;
-    /** Stop following. */
-    unfollow(): void;
-    /**
-     * Global motion multiplier applied to subsequent `shake()` calls. Scales
-     * both amplitude and duration. Default 1 (no-op). 0 fully suppresses
-     * shake. Intended to be driven by `@flare-engine/a11y` reduced-motion so
-     * callers don't have to guard every shake site.
-     *
-     * Only affects future `shake()` calls — does not retroactively modify an
-     * in-flight shake.
-     *
-     * Clamped to `>= 0`.
-     */
-    setMotionScale(scale: number): void;
-    /** Current motion scale (default 1). */
-    get motionScale(): number;
-    /** Start camera shake. */
-    shake(intensity: number, duration: number): void;
-    /**
-     * Start a Perlin-noise-based camera shake. Overwrites any in-flight
-     * shakePerlin (same semantics as shake()). Respects motionScale.
-     */
-    shakePerlin(intensity: number, duration: number): void;
-    /**
-     * Update camera. Call once per frame.
-     * @param dt Delta time in seconds.
-     */
-    update(dt: number): void;
-    /** Get the effective camera X (including shake + shakePerlin offsets). */
-    get effectiveX(): number;
-    /** Get the effective camera Y (including shake + shakePerlin offsets). */
-    get effectiveY(): number;
-    /** Convert world coordinates to screen coordinates. */
-    worldToScreen(worldX: number, worldY: number): Vec2;
-    /** Zero-alloc variant — writes screen coordinates into `out`. */
-    worldToScreenInto(worldX: number, worldY: number, out: Vec2): Vec2;
-    /** Convert screen coordinates to world coordinates. */
-    screenToWorld(screenX: number, screenY: number): Vec2;
-    /** Zero-alloc variant — writes world coordinates into `out`. */
-    screenToWorldInto(screenX: number, screenY: number, out: Vec2): Vec2;
-    /** Get the visible world-space bounding rect (allocates a fresh Rect). */
-    getBounds(): Rect;
-    /** Zero-alloc variant — writes the visible bounds into `out`. */
-    getBoundsInto(out: Rect): Rect;
-    private _clampToBounds;
-}
-
+//#endregion
+//#region src/renderer.d.ts
 /** Minimal Skia Canvas-like interface for the Renderer. */
 interface CanvasLike {
-    save(): number;
-    restore(): void;
-    translate(x: number, y: number): void;
-    scale(sx: number, sy: number): void;
-    rotate(radians: number, cx: number, cy: number): void;
-    clear(color: number): void;
+  save(): number;
+  restore(): void;
+  translate(x: number, y: number): void;
+  scale(sx: number, sy: number): void;
+  /** Rotate around (cx, cy). Angle in DEGREES — both Skia backends take degrees. */
+  rotate(degrees: number, cx: number, cy: number): void;
+  clear(color: number): void;
 }
 /** Stats tracked per frame. */
 interface RenderStats {
-    drawCalls: number;
-    batchCount: number;
+  /**
+   * Number of SpriteBatch flush runs emitted this frame — one per contiguous
+   * same-key (image, effect, alpha, stretch) run, NOT the number of raw canvas
+   * calls. An outline run fans into 9 canvas drawAtlas calls, a stretch run
+   * into n drawImageRect calls, a zone-bg run into n drawRect calls.
+   * Equal to batchCount whenever SpriteBatch.flush is the only writer;
+   * recordDrawCall()/recordBatch() are public and can diverge them if a
+   * custom batching system drives them independently.
+   */
+  drawCalls: number;
+  /**
+   * Number of SpriteBatch flush runs — incremented alongside drawCalls at
+   * the same two sites in SpriteBatch.flush. Equal to drawCalls when only
+   * SpriteBatch.flush writes both; recordDrawCall()/recordBatch() are
+   * independent public methods and can produce different values if called
+   * directly by a custom batching system.
+   */
+  batchCount: number;
 }
 /**
  * Renderer — manages the Skia Canvas lifecycle for a frame.
  * `begin()` to start, draw your content, `end()` to finish.
  */
 declare class Renderer {
-    /** Current frame stats. */
-    readonly stats: RenderStats;
-    private _canvas;
-    private _inFrame;
-    /** Set the canvas to render to. Called once when canvas is available. */
-    setCanvas(canvas: CanvasLike): void;
-    /** Get the current canvas. Throws if not in a frame. */
-    get canvas(): CanvasLike;
-    /** Whether we are currently between begin() and end(). */
-    get inFrame(): boolean;
-    /**
-     * Begin a new frame. Clears the canvas and resets stats.
-     * @param clearColor 32-bit ARGB color to clear with (default black = 0xFF000000).
-     */
-    begin(clearColor?: number): void;
-    /**
-     * End the current frame. Restores canvas state.
-     */
-    end(): void;
-    /**
-     * Apply camera transform to the canvas.
-     * Call after begin() and before drawing.
-     */
-    applyCamera(cameraX: number, cameraY: number, zoom: number, rotation: number, viewportWidth: number, viewportHeight: number): void;
-    /** Increment draw call counter. Called by batching systems. */
-    recordDrawCall(): void;
-    /** Increment batch counter. */
-    recordBatch(): void;
-}
-
+  /** Current frame stats. */
+  readonly stats: RenderStats;
+  private _canvas;
+  private _inFrame;
+  /** Set the canvas to render to. Called once when canvas is available. */
+  setCanvas(canvas: CanvasLike): void;
+  /** Get the current canvas. Throws if not in a frame. */
+  get canvas(): CanvasLike;
+  /** Whether we are currently between begin() and end(). */
+  get inFrame(): boolean;
+  /**
+   * Begin a new frame. Clears the canvas and resets stats.
+   * @param clearColor 32-bit ARGB color to clear with (default black = 0xFF000000).
+   */
+  begin(clearColor?: number): void;
+  /**
+   * End the current frame. Restores canvas state.
+   */
+  end(): void;
+  /**
+   * Apply camera transform to the canvas.
+   * Call after begin() and before drawing.
+   */
+  applyCamera(cameraX: number, cameraY: number, zoom: number, rotation: number, viewportWidth: number, viewportHeight: number): void;
+  /** Increment draw call counter. Invoked in tandem with recordBatch, once per
+   *  flush run in SpriteBatch.flush. */
+  recordDrawCall(): void;
+  /** Increment batch counter. Invoked in tandem with recordDrawCall, once per
+   *  flush run in SpriteBatch.flush. */
+  recordBatch(): void;
+}
+//#endregion
+//#region src/sprite-effects.d.ts
 /** Color as RGBA (0-1 per channel). */
 interface SpriteColor {
-    readonly r: number;
-    readonly g: number;
-    readonly b: number;
-    readonly a: number;
+  readonly r: number;
+  readonly g: number;
+  readonly b: number;
+  readonly a: number;
 }
 /** A sprite effect that can be applied during rendering. */
 interface SpriteEffect {
-    readonly type: string;
+  readonly type: string;
 }
 /** Tint effect — blend a color onto the sprite. */
 interface TintEffect extends SpriteEffect {
-    readonly type: 'tint';
-    readonly color: SpriteColor;
-    readonly amount: number;
+  readonly type: 'tint';
+  readonly color: SpriteColor;
+  readonly amount: number;
 }
 /** Flash effect — overlay a solid color that decays. */
 interface FlashEffect extends SpriteEffect {
-    readonly type: 'flash';
-    readonly color: SpriteColor;
-    readonly duration: number;
-    readonly elapsed: number;
+  readonly type: 'flash';
+  readonly color: SpriteColor;
+  readonly duration: number;
+  readonly elapsed: number;
 }
 /** Grayscale effect — desaturate the sprite. */
 interface GrayscaleEffect extends SpriteEffect {
-    readonly type: 'grayscale';
-    readonly amount: number;
+  readonly type: 'grayscale';
+  readonly amount: number;
 }
 /** Outline effect — draw an outline around the sprite. */
 interface OutlineEffect extends SpriteEffect {
-    readonly type: 'outline';
-    readonly color: SpriteColor;
-    readonly width: number;
+  readonly type: 'outline';
+  readonly color: SpriteColor;
+  readonly width: number;
 }
 /**
  * Opaque pre-compiled shader program. Typically a Skia `RuntimeEffect` built
@@ -205,33 +227,33 @@ type CompiledShader = object;
 type ShaderUniforms = Record<string, number | readonly number[]>;
 /** Custom shader effect — apply a pre-compiled runtime shader with uniforms. */
 interface CustomShaderEffect extends SpriteEffect {
-    readonly type: 'custom';
-    readonly shader: CompiledShader;
-    readonly uniforms: ShaderUniforms;
+  readonly type: 'custom';
+  readonly shader: CompiledShader;
+  readonly uniforms: ShaderUniforms;
 }
 /** Water surface effect — animated UV-displaced sprite with foam crests. */
 interface WaterEffect extends SpriteEffect {
-    readonly type: 'water';
-    readonly color: SpriteColor;
-    readonly foamColor: SpriteColor;
-    readonly waveSpeed: number;
-    readonly waveAmplitude: number;
+  readonly type: 'water';
+  readonly color: SpriteColor;
+  readonly foamColor: SpriteColor;
+  readonly waveSpeed: number;
+  readonly waveAmplitude: number;
 }
 /** Fog / volumetric haze effect — animated FBM noise layered over a sprite. */
 interface FogEffect extends SpriteEffect {
-    readonly type: 'fog';
-    readonly color: SpriteColor;
-    readonly density: number;
-    readonly speed: number;
-    readonly scale: number;
+  readonly type: 'fog';
+  readonly color: SpriteColor;
+  readonly density: number;
+  readonly speed: number;
+  readonly scale: number;
 }
 /** Fire / flame effect — value-noise FBM flame rising upward from a sprite. */
 interface FireEffect extends SpriteEffect {
-    readonly type: 'fire';
-    readonly color: SpriteColor;
-    readonly tipColor: SpriteColor;
-    readonly speed: number;
-    readonly intensity: number;
+  readonly type: 'fire';
+  readonly color: SpriteColor;
+  readonly tipColor: SpriteColor;
+  readonly speed: number;
+  readonly intensity: number;
 }
 /**
  * Drop-shadow effect — a single offset, blurred, tinted copy of the sprite drawn
@@ -240,77 +262,77 @@ interface FireEffect extends SpriteEffect {
  * the offset, blur, and tint all live in the filter, so no extra draw pass.
  */
 interface DropShadowEffect extends SpriteEffect {
-    readonly type: 'drop-shadow';
-    /** Horizontal shadow offset in design px. */
-    readonly offsetX: number;
-    /** Vertical shadow offset in design px; positive = downward (grounding). */
-    readonly offsetY: number;
-    /** Gaussian blur sigma applied to the shadow. 0 = hard edge. */
-    readonly blur: number;
-    /** Shadow color; `a` is the shadow opacity. */
-    readonly color: SpriteColor;
+  readonly type: 'drop-shadow';
+  /** Horizontal shadow offset in design px. */
+  readonly offsetX: number;
+  /** Vertical shadow offset in design px; positive = downward (grounding). */
+  readonly offsetY: number;
+  /** Gaussian blur sigma applied to the shadow. 0 = hard edge. */
+  readonly blur: number;
+  /** Shadow color; `a` is the shadow opacity. */
+  readonly color: SpriteColor;
 }
 /** Rooftop city skyline — AABB silhouettes via SDF hash fields. */
 interface RoofsCityEffect extends SpriteEffect {
-    readonly type: 'roofs-city';
-    readonly skyColor: SpriteColor;
-    readonly roofColor: SpriteColor;
-    readonly scrollOffsetY: number;
-    readonly density: number;
-    /** Destination render width in logical pixels — used as shader resolution.x. */
-    readonly resolutionW: number;
-    /** Destination render height in logical pixels — used as shader resolution.y. */
-    readonly resolutionH: number;
+  readonly type: 'roofs-city';
+  readonly skyColor: SpriteColor;
+  readonly roofColor: SpriteColor;
+  readonly scrollOffsetY: number;
+  readonly density: number;
+  /** Destination render width in logical pixels — used as shader resolution.x. */
+  readonly resolutionW: number;
+  /** Destination render height in logical pixels — used as shader resolution.y. */
+  readonly resolutionH: number;
 }
 /** Forest canopy — value-noise tree line. */
 interface ForestCanopyEffect extends SpriteEffect {
-    readonly type: 'forest-canopy';
-    readonly skyColor: SpriteColor;
-    readonly leafColor: SpriteColor;
-    readonly scrollOffsetY: number;
-    readonly density: number;
-    readonly resolutionW: number;
-    readonly resolutionH: number;
+  readonly type: 'forest-canopy';
+  readonly skyColor: SpriteColor;
+  readonly leafColor: SpriteColor;
+  readonly scrollOffsetY: number;
+  readonly density: number;
+  readonly resolutionW: number;
+  readonly resolutionH: number;
 }
 /** River surface — 1D height-field wave with foam crests. */
 interface RiverWaveEffect extends SpriteEffect {
-    readonly type: 'river-wave';
-    readonly waterColor: SpriteColor;
-    readonly foamColor: SpriteColor;
-    readonly scrollOffsetY: number;
-    readonly waveScale: number;
-    readonly resolutionW: number;
-    readonly resolutionH: number;
+  readonly type: 'river-wave';
+  readonly waterColor: SpriteColor;
+  readonly foamColor: SpriteColor;
+  readonly scrollOffsetY: number;
+  readonly waveScale: number;
+  readonly resolutionW: number;
+  readonly resolutionH: number;
 }
 /** Moon surface — polar-SDF craters on a flat disc. */
 interface MoonCraterEffect extends SpriteEffect {
-    readonly type: 'moon-crater';
-    readonly moonColor: SpriteColor;
-    readonly craterColor: SpriteColor;
-    readonly scrollOffsetY: number;
-    readonly craterCount: number;
-    readonly resolutionW: number;
-    readonly resolutionH: number;
+  readonly type: 'moon-crater';
+  readonly moonColor: SpriteColor;
+  readonly craterColor: SpriteColor;
+  readonly scrollOffsetY: number;
+  readonly craterCount: number;
+  readonly resolutionW: number;
+  readonly resolutionH: number;
 }
 /** Cave interior — stalactites hanging from the top edge. */
 interface CaveInteriorEffect extends SpriteEffect {
-    readonly type: 'cave-interior';
-    readonly caveColor: SpriteColor;
-    readonly glowColor: SpriteColor;
-    readonly scrollOffsetY: number;
-    readonly stalactiteCount: number;
-    readonly resolutionW: number;
-    readonly resolutionH: number;
+  readonly type: 'cave-interior';
+  readonly caveColor: SpriteColor;
+  readonly glowColor: SpriteColor;
+  readonly scrollOffsetY: number;
+  readonly stalactiteCount: number;
+  readonly resolutionW: number;
+  readonly resolutionH: number;
 }
 /** Mountain / hill ridge — FBM height-field silhouette. */
 interface MountainHillsEffect extends SpriteEffect {
-    readonly type: 'mountain-hills';
-    readonly skyColor: SpriteColor;
-    readonly hillColor: SpriteColor;
-    readonly scrollOffsetY: number;
-    readonly ridgeScale: number;
-    readonly resolutionW: number;
-    readonly resolutionH: number;
+  readonly type: 'mountain-hills';
+  readonly skyColor: SpriteColor;
+  readonly hillColor: SpriteColor;
+  readonly scrollOffsetY: number;
+  readonly ridgeScale: number;
+  readonly resolutionW: number;
+  readonly resolutionH: number;
 }
 /** Any concrete sprite effect. */
 type AnySpriteEffect = TintEffect | FlashEffect | GrayscaleEffect | OutlineEffect | CustomShaderEffect | WaterEffect | FogEffect | FireEffect | DropShadowEffect | RoofsCityEffect | ForestCanopyEffect | RiverWaveEffect | MoonCraterEffect | CaveInteriorEffect | MountainHillsEffect;
@@ -335,72 +357,72 @@ declare function fog(color: SpriteColor, density?: number, speed?: number, scale
 /** Create a fire / flame effect. Time is passed to the renderer each
  *  frame via `beginFrame(w, h, time)` — the effect itself is time-invariant. */
 declare function fire(opts: {
-    color: SpriteColor;
-    tipColor: SpriteColor;
-    speed?: number;
-    intensity?: number;
+  color: SpriteColor;
+  tipColor: SpriteColor;
+  speed?: number;
+  intensity?: number;
 }): FireEffect;
 /** Create a drop-shadow effect. Defaults to a soft shadow offset downward for
  *  grounding; `color.a` is the shadow opacity. */
 declare function dropShadow(opts: {
-    color: SpriteColor;
-    offsetX?: number;
-    offsetY?: number;
-    blur?: number;
+  color: SpriteColor;
+  offsetX?: number;
+  offsetY?: number;
+  blur?: number;
 }): DropShadowEffect;
 /** Create a rooftop city skyline effect. */
 declare function roofsCity(opts: {
-    skyColor: SpriteColor;
-    roofColor: SpriteColor;
-    scrollOffsetY?: number;
-    density?: number;
-    resolutionW?: number;
-    resolutionH?: number;
+  skyColor: SpriteColor;
+  roofColor: SpriteColor;
+  scrollOffsetY?: number;
+  density?: number;
+  resolutionW?: number;
+  resolutionH?: number;
 }): RoofsCityEffect;
 /** Create a forest canopy effect. */
 declare function forestCanopy(opts: {
-    skyColor: SpriteColor;
-    leafColor: SpriteColor;
-    scrollOffsetY?: number;
-    density?: number;
-    resolutionW?: number;
-    resolutionH?: number;
+  skyColor: SpriteColor;
+  leafColor: SpriteColor;
+  scrollOffsetY?: number;
+  density?: number;
+  resolutionW?: number;
+  resolutionH?: number;
 }): ForestCanopyEffect;
 /** Create a river wave surface effect. */
 declare function riverWave(opts: {
-    waterColor: SpriteColor;
-    foamColor: SpriteColor;
-    scrollOffsetY?: number;
-    waveScale?: number;
-    resolutionW?: number;
-    resolutionH?: number;
+  waterColor: SpriteColor;
+  foamColor: SpriteColor;
+  scrollOffsetY?: number;
+  waveScale?: number;
+  resolutionW?: number;
+  resolutionH?: number;
 }): RiverWaveEffect;
 /** Create a moon crater surface effect. */
 declare function moonCrater(opts: {
-    moonColor: SpriteColor;
-    craterColor: SpriteColor;
-    scrollOffsetY?: number;
-    craterCount?: number;
-    resolutionW?: number;
-    resolutionH?: number;
+  moonColor: SpriteColor;
+  craterColor: SpriteColor;
+  scrollOffsetY?: number;
+  craterCount?: number;
+  resolutionW?: number;
+  resolutionH?: number;
 }): MoonCraterEffect;
 /** Create a cave interior effect. */
 declare function caveInterior(opts: {
-    caveColor: SpriteColor;
-    glowColor: SpriteColor;
-    scrollOffsetY?: number;
-    stalactiteCount?: number;
-    resolutionW?: number;
-    resolutionH?: number;
+  caveColor: SpriteColor;
+  glowColor: SpriteColor;
+  scrollOffsetY?: number;
+  stalactiteCount?: number;
+  resolutionW?: number;
+  resolutionH?: number;
 }): CaveInteriorEffect;
 /** Create a mountain / hill ridge effect. */
 declare function mountainHills(opts: {
-    skyColor: SpriteColor;
-    hillColor: SpriteColor;
-    scrollOffsetY?: number;
-    ridgeScale?: number;
-    resolutionW?: number;
-    resolutionH?: number;
+  skyColor: SpriteColor;
+  hillColor: SpriteColor;
+  scrollOffsetY?: number;
+  ridgeScale?: number;
+  resolutionW?: number;
+  resolutionH?: number;
 }): MountainHillsEffect;
 /**
  * Advance a time-based effect by `dt` seconds.
@@ -417,50 +439,51 @@ declare function updateEffect(effect: AnySpriteEffect, dt: number): AnySpriteEff
  * Get the current intensity of a flash effect (1 at start, 0 at end).
  */
 declare function flashIntensity(effect: FlashEffect): number;
-
+//#endregion
+//#region src/sprite-batch.d.ts
 /** A single sprite draw request in the batch. */
 interface SpriteDrawCommand {
-    /** Texture (Skia SkImage). */
-    image: SkImageLike;
-    /** Source rectangle in the texture. */
-    srcX: number;
-    srcY: number;
-    srcW: number;
-    srcH: number;
-    /** Destination position and size. */
-    dstX: number;
-    dstY: number;
-    dstW: number;
-    dstH: number;
-    /** Optional per-sprite effect. Shared by reference across commands in a
-     *  batch — the render adapter applies it once per batch. */
-    effect: AnySpriteEffect | undefined;
-    /** Per-instance alpha multiplier. Range [0, 1]. Default 1 (fully opaque).
-     *  Participates in the batch key — sprites with different alphas are
-     *  placed in separate batches so the renderer can apply each alpha once
-     *  per draw call without per-sprite overhead. */
-    alpha: number;
-    /** Rotation in radians, clockwise (Skia Y-down convention). Default 0.
-     *  Rotation is applied about the anchor point. */
-    rotation: number;
-    /** Anchor X fraction stored for the bridge rotation path. Range [0, 1]. */
-    anchorX: number;
-    /** Anchor Y fraction stored for the bridge rotation path. Range [0, 1]. */
-    anchorY: number;
-    /**
-     * When true, the sprite is drawn via `drawImageRect` so `dstW` and `dstH`
-     * are honored independently (non-uniform scale). A 256×256 source image
-     * will fill an arbitrary W×H destination rect.
-     *
-     * Default (false/absent): drawn via the batched `drawAtlas` path (uniform
-     * scale — dstW/srcW drives both axes). Stretched sprites are NOT batched
-     * with regular sprites; each is an independent `drawImageRect` call.
-     *
-     * Rotation is unsupported in stretch mode — the RSXform similarity-transform
-     * limit does not apply, but the bridge draws a plain axis-aligned rect.
-     * Combine with a zero rotation only.
-     */
-    stretch: boolean;
+  /** Texture (Skia SkImage). */
+  image: SkImageLike;
+  /** Source rectangle in the texture. */
+  srcX: number;
+  srcY: number;
+  srcW: number;
+  srcH: number;
+  /** Destination position and size. */
+  dstX: number;
+  dstY: number;
+  dstW: number;
+  dstH: number;
+  /** Optional per-sprite effect. Shared by reference across commands in a
+   *  batch — the render adapter applies it once per batch. */
+  effect: AnySpriteEffect | undefined;
+  /** Per-instance alpha multiplier. Range [0, 1]. Default 1 (fully opaque).
+   *  Participates in the batch key — sprites with different alphas are
+   *  placed in separate batches so the renderer can apply each alpha once
+   *  per draw call without per-sprite overhead. */
+  alpha: number;
+  /** Rotation in radians, clockwise (Skia Y-down convention). Default 0.
+   *  Rotation is applied about the anchor point. */
+  rotation: number;
+  /** Anchor X fraction stored for the bridge rotation path. Range [0, 1]. */
+  anchorX: number;
+  /** Anchor Y fraction stored for the bridge rotation path. Range [0, 1]. */
+  anchorY: number;
+  /**
+   * When true, the sprite is drawn via `drawImageRect` so `dstW` and `dstH`
+   * are honored independently (non-uniform scale). A 256×256 source image
+   * will fill an arbitrary W×H destination rect.
+   *
+   * Default (false/absent): drawn via the batched `drawAtlas` path (uniform
+   * scale — dstW/srcW drives both axes). Stretched sprites are NOT batched
+   * with regular sprites; each is an independent `drawImageRect` call.
+   *
+   * Rotation is unsupported in stretch mode — the RSXform similarity-transform
+   * limit does not apply, but the bridge draws a plain axis-aligned rect.
+   * Combine with a zero rotation only.
+   */
+  stretch: boolean;
 }
 /**
  * SpriteBatch — collects sprite draw commands and groups them by texture
@@ -469,57 +492,57 @@ interface SpriteDrawCommand {
  * Usage:
  * 1. Call `draw()` for each sprite, optionally passing an effect
  * 2. Call `flush()` with an atlas draw callback to execute all batched draws
- * 3. Batching groups by texture identity, then by effect identity — so
- *    sharing an effect instance across sprites maximizes batch size
+ * 3. Batching groups consecutive commands by `(image, effect, alpha, stretch)`
+ *    identity, preserving global insertion (z-sorted) order. Sharing an effect
+ *    reference and the same alpha across consecutive entities maximizes batch
+ *    size while keeping sprites in correct draw order.
  *
  * The actual Skia Atlas draw call is delegated to a callback so this module
  * remains testable without Skia.
  */
 declare class SpriteBatch {
-    private _commands;
-    private _pool;
-    private _batches;
-    /** Number of queued draw commands. */
-    get count(): number;
-    /** Queue a sprite draw from a frame.
-     *
-     *  `anchorX` / `anchorY` define the pivot point of the sprite as a
-     *  fraction of its destination size — `(0, 0)` = top-left (default),
-     *  `(0.5, 0.5)` = center, `(1, 1)` = bottom-right. `dstX` / `dstY`
-     *  then refer to the anchor point instead of the top-left corner.
-     *
-     *  `alpha` is a per-instance opacity multiplier in [0, 1]. Default 1. */
-    draw(image: SkImageLike, frame: SpriteFrame, dstX: number, dstY: number, dstW?: number, dstH?: number, effect?: AnySpriteEffect, anchorX?: number, anchorY?: number, alpha?: number, rotation?: number, stretch?: boolean): void;
-    /** Queue a raw sprite draw with explicit src/dst rects. `dstX` / `dstY`
-     *  refer to the anchor point — offset by `anchorX * dstW` / `anchorY * dstH`.
-     *
-     *  `alpha` is a per-instance opacity multiplier in [0, 1]. Default 1. */
-    drawRaw(image: SkImageLike, srcX: number, srcY: number, srcW: number, srcH: number, dstX: number, dstY: number, dstW: number, dstH: number, effect?: AnySpriteEffect, anchorX?: number, anchorY?: number, alpha?: number, rotation?: number, stretch?: boolean): void;
-    /**
-     * Flush all queued commands, grouped by (texture, effect, alpha) identity.
-     *
-     * @param drawAtlas Callback invoked once per batch. Receives
-     *   `(image, commands)` — all commands in a batch share the same texture,
-     *   the same effect (readable from `commands[0].effect`), and the same
-     *   alpha (readable from `commands[0].alpha`).
-     * @param renderer Optional renderer to record stats.
-     */
-    flush(drawAtlas: (image: SkImageLike, commands: SpriteDrawCommand[]) => void, renderer?: Renderer): void;
-    /** Clear all queued commands without drawing. */
-    clear(): void;
-    private _acquire;
-}
-
-declare const FIRE_SKSL = "\nuniform shader src;\nuniform float2 resolution;\nuniform float3 color;\nuniform float3 tipColor;\nuniform float speed;\nuniform float intensity;\nuniform float time;\n\nfloat hash(float2 p) { return fract(sin(dot(p, float2(127.1, 311.7))) * 43758.5453); }\n\nfloat vnoise(float2 p) {\n  float2 i = floor(p);\n  float2 f = fract(p);\n  float2 u = f * f * (3.0 - 2.0 * f);\n  float a = hash(i);\n  float b = hash(i + float2(1.0, 0.0));\n  float c = hash(i + float2(0.0, 1.0));\n  float d = hash(i + float2(1.0, 1.0));\n  return mix(mix(a, b, u.x), mix(c, d, u.x), u.y);\n}\n\nfloat fbm(float2 p) {\n  return 0.5 * vnoise(p) + 0.25 * vnoise(p * 2.0);\n}\n\nhalf4 main(float2 coord) {\n  half4 srcColor = src.eval(coord);\n  float2 uv = coord / max(resolution, float2(1.0));\n  float2 np = float2(uv.x * 4.0, uv.y * 6.0 - time * speed * 2.0);\n  float n = fbm(np);\n  float flameMask = smoothstep(0.0, intensity, n * (1.0 - uv.y));\n  float3 fireRgb = mix(color, tipColor, uv.y);\n  half4 fireColor = half4(fireRgb.r, fireRgb.g, fireRgb.b, flameMask);\n  return half4(fireColor.rgb, fireColor.a * srcColor.a);\n}\n";
-declare const FOG_SKSL = "\nuniform shader src;\nuniform float2 resolution;\nuniform float3 color;\nuniform float density;\nuniform float speed;\nuniform float scale;\nuniform float time;\n\nfloat hash(float2 p) {\n  return fract(sin(dot(p, float2(127.1, 311.7))) * 43758.5453);\n}\n\nfloat valueNoise(float2 p) {\n  float2 i = floor(p);\n  float2 f = fract(p);\n  float2 u = f * f * (3.0 - 2.0 * f);\n  float a = hash(i);\n  float b = hash(i + float2(1.0, 0.0));\n  float c = hash(i + float2(0.0, 1.0));\n  float d = hash(i + float2(1.0, 1.0));\n  return mix(mix(a, b, u.x), mix(c, d, u.x), u.y);\n}\n\nfloat fbm(float2 p) {\n  float value = 0.0;\n  float amplitude = 0.5;\n  for (int i = 0; i < 4; i++) {\n    value += amplitude * valueNoise(p);\n    p *= 2.0;\n    amplitude *= 0.5;\n  }\n  return value;\n}\n\nhalf4 main(float2 coord) {\n  float2 uv = coord / max(resolution, float2(1.0));\n  float2 drift = float2(time * speed, 0.3 * time * speed);\n  float n = clamp(fbm(uv * scale + drift), 0.0, 1.0);\n  half4 srcColor = src.eval(coord);\n  half3 blended = mix(srcColor.rgb, half3(color.r, color.g, color.b), half(density * n));\n  return half4(blended, srcColor.a);\n}\n";
-declare const WATER_SKSL = "\nuniform shader src;\nuniform float2 resolution;\nuniform float3 color;\nuniform float3 foamColor;\nuniform float waveSpeed;\nuniform float waveAmplitude;\nuniform float time;\n\nhalf4 main(float2 coord) {\n  float2 uv = coord / resolution;\n  float wave1 = sin(uv.x * 6.2832 * 3.0 + time * waveSpeed * 2.0) * waveAmplitude;\n  float wave2 = sin(uv.x * 6.2832 * 5.0 - time * waveSpeed * 1.3 + 1.5) * waveAmplitude * 0.5;\n  float totalWave = wave1 + wave2;\n  float2 displaced = float2(uv.x, uv.y + totalWave);\n  displaced = clamp(displaced, float2(0.0), float2(1.0));\n  half4 c = src.eval(displaced * resolution);\n  float waveDeriv = cos(uv.x * 6.2832 * 3.0 + time * waveSpeed * 2.0) * waveAmplitude * 2.0\n                  + cos(uv.x * 6.2832 * 5.0 - time * waveSpeed * 1.3 + 1.5) * waveAmplitude;\n  float foam = smoothstep(waveAmplitude * 0.6, waveAmplitude * 1.5, waveDeriv);\n  half3 tinted = mix(c.rgb, half3(color.r, color.g, color.b), half(0.35));\n  half3 final = mix(tinted, half3(foamColor.r, foamColor.g, foamColor.b), half(foam));\n  return half4(final, c.a);\n}\n";
-declare const ROOFS_CITY_SKSL = "\nuniform float2 resolution;\nuniform float3 skyColor;\nuniform float3 roofColor;\nuniform float scrollOffsetY;\nuniform float density;\n\nfloat hash(float x) { return fract(sin(x * 127.1) * 43758.5453); }\n\nfloat buildingTop(float2 uv, float density) {\n  float col = floor(uv.x * density);\n  float h = 0.35 + 0.35 * hash(col);\n  float w = 0.6 + 0.3 * hash(col + 7.3);\n  float edge = step(abs(fract(uv.x * density) - 0.5), w * 0.5);\n  return edge * step(uv.y, h);\n}\n\nhalf4 main(float2 coord) {\n  float2 uv = coord / max(resolution, float2(1.0));\n  uv.y = uv.y + scrollOffsetY / max(resolution.y, 1.0);\n  uv.y = fract(uv.y);\n  float buildings = buildingTop(uv, density);\n  half3 col = mix(half3(skyColor.r, skyColor.g, skyColor.b),\n                  half3(roofColor.r, roofColor.g, roofColor.b),\n                  half(buildings));\n  return half4(col, 1.0);\n}\n";
-declare const FOREST_CANOPY_SKSL = "\nuniform float2 resolution;\nuniform float3 skyColor;\nuniform float3 leafColor;\nuniform float scrollOffsetY;\nuniform float density;\n\nfloat hash(float2 p) { return fract(sin(dot(p, float2(127.1, 311.7))) * 43758.5453); }\n\nfloat valueNoise(float2 p) {\n  float2 i = floor(p);\n  float2 f = fract(p);\n  float2 u = f * f * (3.0 - 2.0 * f);\n  return mix(mix(hash(i), hash(i + float2(1.0, 0.0)), u.x),\n             mix(hash(i + float2(0.0, 1.0)), hash(i + float2(1.0, 1.0)), u.x), u.y);\n}\n\nhalf4 main(float2 coord) {\n  float2 uv = coord / max(resolution, float2(1.0));\n  uv.y = uv.y + scrollOffsetY / max(resolution.y, 1.0);\n  float n = valueNoise(float2(uv.x * density, uv.y * 3.0));\n  float treeLine = 0.55 + 0.25 * valueNoise(float2(uv.x * density * 0.5, 0.0));\n  float canopy = step(uv.y, treeLine) * smoothstep(0.3, 0.7, n);\n  half3 col = mix(half3(skyColor.r, skyColor.g, skyColor.b),\n                  half3(leafColor.r, leafColor.g, leafColor.b),\n                  half(canopy));\n  return half4(col, 1.0);\n}\n";
-declare const RIVER_WAVE_SKSL = "\nuniform float2 resolution;\nuniform float3 waterColor;\nuniform float3 foamColor;\nuniform float scrollOffsetY;\nuniform float waveScale;\n\nhalf4 main(float2 coord) {\n  float2 uv = coord / max(resolution, float2(1.0));\n  float scroll = scrollOffsetY / max(resolution.y, 1.0);\n  float2 p = float2(uv.x, uv.y + scroll);\n  float w1 = sin(p.x * 6.2832 * waveScale + p.y * 4.0) * 0.04;\n  float w2 = sin(p.x * 6.2832 * waveScale * 1.7 - p.y * 2.5 + 1.2) * 0.02;\n  float surface = 0.5 + w1 + w2;\n  float inWater = step(uv.y, surface);\n  float crest = smoothstep(surface - 0.015, surface, uv.y) * (1.0 - inWater) +\n                smoothstep(surface + 0.015, surface, uv.y) * inWater;\n  half3 base = mix(half3(foamColor.r, foamColor.g, foamColor.b),\n                   half3(waterColor.r, waterColor.g, waterColor.b),\n                   half(inWater));\n  half3 col = mix(base, half3(foamColor.r, foamColor.g, foamColor.b), half(crest * 0.6));\n  return half4(col, 1.0);\n}\n";
-declare const MOON_CRATER_SKSL = "\nuniform float2 resolution;\nuniform float3 moonColor;\nuniform float3 craterColor;\nuniform float scrollOffsetY;\nuniform float craterCount;\n\nfloat hash(float2 p) { return fract(sin(dot(p, float2(127.1, 311.7))) * 43758.5453); }\n\nfloat crater(float2 uv, float2 center, float r) {\n  float d = length(uv - center);\n  float rim = smoothstep(r, r * 0.85, d) - smoothstep(r * 0.85, r * 0.65, d);\n  float floor_ = smoothstep(r * 0.65, r * 0.4, d);\n  return rim * 0.6 + floor_ * 0.25;\n}\n\nhalf4 main(float2 coord) {\n  float2 uv = coord / max(resolution, float2(1.0));\n  uv.y = uv.y + scrollOffsetY / max(resolution.y, 1.0);\n  float c = 0.0;\n  for (int i = 0; i < 6; i++) {\n    float fi = float(i);\n    float2 center = float2(hash(float2(fi, 0.0)), hash(float2(fi, 1.0)));\n    float r = 0.04 + 0.07 * hash(float2(fi, 2.0));\n    c += crater(fract(uv), center, r) * step(fi, craterCount - 1.0);\n  }\n  c = clamp(c, 0.0, 1.0);\n  half3 col = mix(half3(moonColor.r, moonColor.g, moonColor.b),\n                  half3(craterColor.r, craterColor.g, craterColor.b),\n                  half(c));\n  return half4(col, 1.0);\n}\n";
-declare const CAVE_INTERIOR_SKSL = "\nuniform float2 resolution;\nuniform float3 caveColor;\nuniform float3 glowColor;\nuniform float scrollOffsetY;\nuniform float stalactiteCount;\n\nfloat hash(float x) { return fract(sin(x * 127.1) * 43758.5453); }\n\nfloat stalactite(float2 uv, float count) {\n  float col = floor(uv.x * count);\n  float tip = 0.1 + 0.2 * hash(col);\n  float w = 0.3 + 0.3 * hash(col + 5.0);\n  float dx = abs(fract(uv.x * count) - 0.5) / (w * 0.5);\n  float shape = step(dx, 1.0) * step(uv.y, tip * (1.0 - clamp(dx, 0.0, 1.0)));\n  return shape;\n}\n\nhalf4 main(float2 coord) {\n  float2 uv = coord / max(resolution, float2(1.0));\n  uv.y = 1.0 - uv.y;\n  uv.y = uv.y + scrollOffsetY / max(resolution.y, 1.0);\n  float stalac = stalactite(uv, stalactiteCount);\n  float glow = smoothstep(0.8, 1.0, uv.y) * (1.0 - stalac);\n  half3 col = mix(half3(caveColor.r, caveColor.g, caveColor.b),\n                  half3(glowColor.r, glowColor.g, glowColor.b),\n                  half(glow));\n  col = mix(col, half3(caveColor.r, caveColor.g, caveColor.b) * half(0.3), half(stalac));\n  return half4(col, 1.0);\n}\n";
-declare const MOUNTAIN_HILLS_SKSL = "\nuniform float2 resolution;\nuniform float3 skyColor;\nuniform float3 hillColor;\nuniform float scrollOffsetY;\nuniform float ridgeScale;\n\nfloat hash(float x) { return fract(sin(x * 127.1) * 43758.5453); }\n\nfloat heightField(float x, float scale) {\n  float h = 0.0;\n  float amp = 0.5;\n  float freq = scale;\n  for (int i = 0; i < 4; i++) {\n    float ix = floor(x * freq);\n    float fx = fract(x * freq);\n    fx = fx * fx * (3.0 - 2.0 * fx);\n    h += amp * mix(hash(ix), hash(ix + 1.0), fx);\n    freq *= 2.0;\n    amp *= 0.5;\n  }\n  return h;\n}\n\nhalf4 main(float2 coord) {\n  float2 uv = coord / max(resolution, float2(1.0));\n  float scroll = scrollOffsetY / max(resolution.y, 1.0);\n  float horizon = 0.4 + 0.3 * heightField(uv.x + scroll * 0.3, ridgeScale);\n  float mountains = step(uv.y, horizon);\n  half3 col = mix(half3(skyColor.r, skyColor.g, skyColor.b),\n                  half3(hillColor.r, hillColor.g, hillColor.b),\n                  half(mountains));\n  return half4(col, 1.0);\n}\n";
-
+  private _commands;
+  private _pool;
+  private _batches;
+  private _allocCount;
+  /** Number of queued draw commands. */
+  get count(): number;
+  /** Cumulative number of SpriteDrawCommand objects allocated because the internal
+   *  command pool was empty. Steady state should be 0 after warm-up. */
+  get allocCount(): number;
+  /** Queue a sprite draw from a frame.
+   *
+   *  `anchorX` / `anchorY` define the pivot point of the sprite as a
+   *  fraction of its destination size — `(0, 0)` = top-left (default),
+   *  `(0.5, 0.5)` = center, `(1, 1)` = bottom-right. `dstX` / `dstY`
+   *  then refer to the anchor point instead of the top-left corner.
+   *
+   *  `alpha` is a per-instance opacity multiplier in [0, 1]. Default 1. */
+  draw(image: SkImageLike, frame: SpriteFrame, dstX: number, dstY: number, dstW?: number, dstH?: number, effect?: AnySpriteEffect, anchorX?: number, anchorY?: number, alpha?: number, rotation?: number, stretch?: boolean): void;
+  /** Queue a raw sprite draw with explicit src/dst rects. `dstX` / `dstY`
+   *  refer to the anchor point — offset by `anchorX * dstW` / `anchorY * dstH`.
+   *
+   *  `alpha` is a per-instance opacity multiplier in [0, 1]. Default 1. */
+  drawRaw(image: SkImageLike, srcX: number, srcY: number, srcW: number, srcH: number, dstX: number, dstY: number, dstW: number, dstH: number, effect?: AnySpriteEffect, anchorX?: number, anchorY?: number, alpha?: number, rotation?: number, stretch?: boolean): void;
+  /**
+   * Flush all queued commands in insertion order, grouping maximal consecutive
+   * runs that share the same `(image, effect, alpha, stretch)` key into a
+   * single `drawAtlas` call. This preserves global z-order (the caller is
+   * responsible for queuing in z-sorted order) while still batching runs of
+   * same-key sprites for efficiency.
+   *
+   * @param drawAtlas Callback invoked once per run. Receives
+   *   `(image, commands)` — all commands in a run share the same key and are
+   *   contiguous in the original insertion order.
+   * @param renderer Optional renderer to record stats.
+   */
+  flush(drawAtlas: (image: SkImageLike, commands: SpriteDrawCommand[]) => void, renderer?: Renderer): void;
+  /** Clear all queued commands without drawing. */
+  clear(): void;
+  private _acquire;
+}
+//#endregion
+//#region src/frame-renderer.d.ts
 /** A 4-float RGBA color buffer (r, g, b, a in [0, 1]). */
 type ColorLike = Float32Array;
 /**
@@ -530,11 +553,11 @@ type ColorLike = Float32Array;
  * interface in contra-variant parameter positions.
  */
 interface RectLike {
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-    setXYWH(x: number, y: number, w: number, h: number): void;
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+  setXYWH(x: number, y: number, w: number, h: number): void;
 }
 /**
  * A mutable similarity transform.
@@ -544,57 +567,57 @@ interface RectLike {
  * RN-Skia's `SkRSXform` exposes all four fields.
  */
 interface RSXformLike {
-    scos: number;
-    ssin: number;
-    tx: number;
-    ty: number;
-    set(scos: number, ssin: number, tx: number, ty: number): void;
+  scos: number;
+  ssin: number;
+  tx: number;
+  ty: number;
+  set(scos: number, ssin: number, tx: number, ty: number): void;
 }
 /** A compiled SkSL runtime effect. */
 interface RuntimeEffectLike {
-    makeShader(uniforms: number[]): unknown;
-    getUniformCount(): number;
-    getUniformFloatCount(): number;
-    getUniformName(index: number): string;
-    getUniform(index: number): {
-        columns: number;
-        rows: number;
-        slot: number;
-    };
+  makeShader(uniforms: number[]): unknown;
+  getUniformCount(): number;
+  getUniformFloatCount(): number;
+  getUniformName(index: number): string;
+  getUniform(index: number): {
+    columns: number;
+    rows: number;
+    slot: number;
+  };
 }
 /** Color filter factory — subset used by the frame-renderer. */
 interface ColorFilterFactoryLike {
-    MakeBlend(color: Float32Array, mode: number): unknown;
-    MakeMatrix(matrix: number[]): unknown;
+  MakeBlend(color: Float32Array, mode: number): unknown;
+  MakeMatrix(matrix: number[]): unknown;
 }
 /** Image filter factory — optional; absent on CPU/test surfaces. */
 interface ImageFilterFactoryLike {
-    MakeDropShadow(dx: number, dy: number, sigmaX: number, sigmaY: number, color: Float32Array, input: null): unknown;
+  MakeDropShadow(dx: number, dy: number, sigmaX: number, sigmaY: number, color: Float32Array, input: null): unknown;
 }
 /** Runtime-effect factory — optional; absent when SkSL is unsupported. */
 interface RuntimeEffectFactoryLike {
-    Make(sksl: string): RuntimeEffectLike | null;
+  Make(sksl: string): RuntimeEffectLike | null;
 }
 /** Paint — the writable subset the frame-renderer mutates. */
 interface PaintLike {
-    setAlphaf(alpha: number): void;
-    setColor?(color: Float32Array): void;
-    setColorFilter(filter: unknown): void;
-    setShader(shader: unknown): void;
-    setImageFilter(filter: unknown): void;
+  setAlphaf(alpha: number): void;
+  setColor?(color: Float32Array): void;
+  setColorFilter(filter: unknown): void;
+  setShader(shader: unknown): void;
+  setImageFilter(filter: unknown): void;
 }
 /** Minimal draw surface the frame-renderer calls into. */
 interface DrawSurfaceLike {
-    save(): number;
-    restore(): void;
-    translate(x: number, y: number): void;
-    scale(sx: number, sy: number): void;
-    /** rotate(radians, cx, cy) — always in radians. Web shims must convert. */
-    rotate(radians: number, cx: number, cy: number): void;
-    clear(color: Float32Array): void;
-    drawAtlas(image: unknown, srcRects: RectLike[], dstXforms: RSXformLike[], paint: PaintLike): void;
-    drawImageRect(image: unknown, src: RectLike, dst: RectLike, paint: PaintLike): void;
-    drawRect(rect: RectLike, paint: PaintLike): void;
+  save(): number;
+  restore(): void;
+  translate(x: number, y: number): void;
+  scale(sx: number, sy: number): void;
+  /** rotate(degrees, cx, cy) — DEGREES, forwarded verbatim (both Skia backends take degrees). */
+  rotate(degrees: number, cx: number, cy: number): void;
+  clear(color: Float32Array): void;
+  drawAtlas(image: unknown, srcRects: RectLike[], dstXforms: RSXformLike[], paint: PaintLike): void;
+  drawImageRect(image: unknown, src: RectLike, dst: RectLike, paint: PaintLike): void;
+  drawRect(rect: RectLike, paint: PaintLike): void;
 }
 /**
  * Opaque picture (recorded draw commands).
@@ -605,8 +628,8 @@ interface DrawSurfaceLike {
 type PictureLike = object;
 /** Picture recorder. */
 interface PictureRecorderLike {
-    beginRecording(bounds: RectLike): DrawSurfaceLike;
-    finishRecordingAsPicture(): PictureLike;
+  beginRecording(bounds: RectLike): DrawSurfaceLike;
+  finishRecordingAsPicture(): PictureLike;
 }
 /**
  * Minimal structural view of the Skia module the frame-renderer needs.
@@ -617,47 +640,47 @@ interface PictureRecorderLike {
  * on CPU surfaces and in test mocks.
  */
 interface FrameRendererModule {
-    XYWHRect(x: number, y: number, w: number, h: number): RectLike;
-    RSXform(scos: number, ssin: number, tx: number, ty: number): RSXformLike;
-    Paint(): PaintLike;
-    PictureRecorder(): PictureRecorderLike;
-    ColorFilter: ColorFilterFactoryLike;
-    RuntimeEffect?: RuntimeEffectFactoryLike;
-    ImageFilter?: ImageFilterFactoryLike;
+  XYWHRect(x: number, y: number, w: number, h: number): RectLike;
+  RSXform(scos: number, ssin: number, tx: number, ty: number): RSXformLike;
+  Paint(): PaintLike;
+  PictureRecorder(): PictureRecorderLike;
+  ColorFilter: ColorFilterFactoryLike;
+  RuntimeEffect?: RuntimeEffectFactoryLike;
+  ImageFilter?: ImageFilterFactoryLike;
 }
 /**
  * A single compiled postfx pass descriptor produced by the runtime.
  */
 interface FrameRendererCompiledPass {
-    readonly id: string;
-    readonly shader: {
-        makeShaderWithChildren(uniforms: number[], children: unknown[]): unknown | null;
-        getUniformCount?(): number;
-        getUniformName?(index: number): string;
-        getUniform?(index: number): {
-            columns: number;
-            rows: number;
-            slot: number;
-        };
+  readonly id: string;
+  readonly shader: {
+    makeShaderWithChildren(uniforms: number[], children: unknown[]): unknown | null;
+    getUniformCount?(): number;
+    getUniformName?(index: number): string;
+    getUniform?(index: number): {
+      columns: number;
+      rows: number;
+      slot: number;
     };
-    readonly uniforms: Float32Array;
-    readonly children: readonly unknown[];
+  };
+  readonly uniforms: Float32Array;
+  readonly children: readonly unknown[];
 }
 /** Minimal structural view of a PostFxRuntime that the frame-renderer needs. */
 interface FrameRendererPostFxRuntime {
-    readonly supported: boolean;
-    buildPass?(chain: FrameRendererPostFxChain, width: number, height: number): readonly FrameRendererCompiledPass[];
+  readonly supported: boolean;
+  buildPass?(chain: FrameRendererPostFxChain, width: number, height: number): readonly FrameRendererCompiledPass[];
 }
 /** Minimal structural view of an EffectChain the frame-renderer needs. */
 interface FrameRendererPostFxChain {
-    enabled(): Iterable<unknown>;
+  enabled(): Iterable<unknown>;
 }
 /** A resolved postfx pass descriptor with named uniforms (for React JSX). */
 interface FrameRendererPostFxDescriptor {
-    readonly id: string;
-    readonly source: unknown;
-    readonly uniforms: Record<string, number | readonly number[]>;
-    readonly children: readonly unknown[];
+  readonly id: string;
+  readonly source: unknown;
+  readonly uniforms: Record<string, number | readonly number[]>;
+  readonly children: readonly unknown[];
 }
 /**
  * Frame renderer that bridges a `SpriteBatch` to a picture-backed draw surface.
@@ -668,12 +691,18 @@ interface FrameRendererPostFxDescriptor {
  *   3. Call `endFrame()` — returns the recorded picture.
  */
 interface FrameRenderer {
-    readonly canvas: CanvasLike;
-    beginFrame(viewportWidth: number, viewportHeight: number, time?: number, pixelDensity?: number): void;
-    drawAtlas(image: SkImageLike, commands: SpriteDrawCommand[]): void;
-    buildPostFxPasses(runtime: FrameRendererPostFxRuntime | null, chain: FrameRendererPostFxChain | null, width: number, height: number): readonly FrameRendererPostFxDescriptor[];
-    setPostFxBinding(runtime: FrameRendererPostFxRuntime | null, chain: FrameRendererPostFxChain | null): void;
-    endFrame(): PictureLike | null;
+  readonly canvas: CanvasLike;
+  beginFrame(viewportWidth: number, viewportHeight: number, time?: number, pixelDensity?: number): void;
+  drawAtlas(image: SkImageLike, commands: SpriteDrawCommand[]): void;
+  buildPostFxPasses(runtime: FrameRendererPostFxRuntime | null, chain: FrameRendererPostFxChain | null, width: number, height: number): readonly FrameRendererPostFxDescriptor[];
+  setPostFxBinding(runtime: FrameRendererPostFxRuntime | null, chain: FrameRendererPostFxChain | null): void;
+  /**
+   * Whether `buildPostFxPasses` would attempt to build passes from the bound
+   * runtime and chain. Pure null/flag checks — never calls `runtime.buildPass`,
+   * so it is safe on platforms where building throws (React Native Web).
+   */
+  hasPostFxBinding(): boolean;
+  endFrame(): PictureLike | null;
 }
 /**
  * Create a `FrameRenderer` backed by the given structural Skia module.
@@ -682,98 +711,71 @@ interface FrameRenderer {
  * `@flare-engine/render-web` (passing a CanvasKit shim) use this factory.
  */
 declare function createFrameRenderer(Skia: FrameRendererModule): FrameRenderer;
-
-/** A single glyph in a bitmap font. */
-interface Glyph {
-    /** Character code (Unicode). */
-    id: number;
-    /** Source rect in the font texture. */
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-    /** Draw offset. */
-    xOffset: number;
-    yOffset: number;
-    /** Horizontal advance after this glyph. */
-    xAdvance: number;
-}
-/** Kerning pair. */
-interface KerningPair {
-    first: number;
-    second: number;
-    amount: number;
-}
-/** Parsed bitmap font data. */
-interface BitmapFont {
-    /** Line height in pixels. */
-    lineHeight: number;
-    /** Baseline offset. */
-    base: number;
-    /** Glyph map by character code. */
-    glyphs: Map<number, Glyph>;
-    /** Kerning map. Key = `first << 16 | second`. */
-    kernings: Map<number, number>;
-}
+/** Zero both branch counters unconditionally (no __DEV__ guard). */
+declare function resetXformCounters(): void;
 /**
- * Parse BMFont JSON format (common output from tools like Hiero, BMFont, msdf-bmfont).
- */
-declare function parseBMFontJSON(json: unknown): BitmapFont;
-/** Get kerning between two characters. */
-declare function getKerning(font: BitmapFont, first: number, second: number): number;
-/** Measure the width of a text string in pixels. */
-declare function measureText(font: BitmapFont, text: string): number;
-/**
- * Draw text using a SpriteBatch.
- * Characters are batched as individual sprites from the font texture.
+ * Cumulative `fillXforms` branch hit counts since the last reset. Both stay 0
+ * when `__DEV__` is falsy or absent.
+ *
+ * These count transform WRITES, not sprites: a run drawn with an outline effect
+ * passes through `fillXforms` 9 times (8 offset passes + 1 main pass), so it
+ * contributes 9 hits per command — the transform work the renderer actually
+ * performs. The counters are process-global: every `createFrameRenderer`
+ * instance increments the same pair, so readings sum across live renderers.
+ *
+ * Allocates one object per call — never call it from the render loop.
  */
-declare function drawText(batch: SpriteBatch, font: BitmapFont, image: SkImageLike, text: string, x: number, y: number, scale?: number): void;
-
+declare function getXformCounters(): {
+  rotated: number;
+  unrotated: number;
+};
+//#endregion
+//#region src/render-system.d.ts
 /** Position component data expected by the render system. */
 interface PositionData {
-    x: number;
-    y: number;
+  x: number;
+  y: number;
 }
 /** Sprite anchor as a fraction of the destination rect — `(0, 0)` is
  *  top-left (default), `(0.5, 0.5)` is center, `(1, 1)` is bottom-right.
  *  When present, `Position` refers to the anchor point rather than the
  *  sprite's top-left corner. */
 interface SpriteAnchor {
-    x: number;
-    y: number;
+  x: number;
+  y: number;
 }
 /** Sprite component data expected by the render system. */
 interface SpriteData {
-    image: SkImageLike;
-    frame: SpriteFrame;
-    z: number;
-    width?: number;
-    height?: number;
-    /** Optional per-sprite effect (tint, flash, grayscale, outline, custom).
-     *  Shared instances are batched together — prefer reusing an effect
-     *  reference across entities that should render identically. */
-    effect?: AnySpriteEffect;
-    /** Optional pivot point for the sprite. Defaults to top-left `(0, 0)`. */
-    anchor?: SpriteAnchor;
-    /** Per-instance alpha multiplier. Range [0, 1]. Default 1 (fully opaque).
-     *  Mutate directly each frame — e.g. `sprite.alpha = lerp(1, 0, t)`.
-     *  Sprites with different alphas are placed in separate draw batches. */
-    alpha?: number;
-    /** Rotation in radians, clockwise (Skia Y-down convention). Default 0.
-     *  Applied about the sprite's anchor point. Non-uniform scale combined with
-     *  rotation is unsupported — scale is inferred uniformly from dstW/srcW. */
-    rotation?: number;
-    /**
-     * When true, draw via `drawImageRect` so `width` and `height` are honored
-     * independently (non-uniform scale). Use for background tiles or any sprite
-     * that must fill a non-square destination rect exactly.
-     *
-     * Default (absent/false): drawn via the batched `drawAtlas` uniform-scale
-     * path. Stretched sprites are NOT batched with regular sprites.
-     *
-     * Rotation is unsupported in stretch mode — combine only with `rotation = 0`.
-     */
-    stretch?: boolean;
+  image: SkImageLike;
+  frame: SpriteFrame;
+  z: number;
+  width?: number;
+  height?: number;
+  /** Optional per-sprite effect (tint, flash, grayscale, outline, custom).
+   *  Shared instances are batched together — prefer reusing an effect
+   *  reference across entities that should render identically. */
+  effect?: AnySpriteEffect;
+  /** Optional pivot point for the sprite. Defaults to top-left `(0, 0)`. */
+  anchor?: SpriteAnchor;
+  /** Per-instance alpha multiplier. Range [0, 1]. Default 1 (fully opaque).
+   *  Mutate directly each frame — e.g. `sprite.alpha = lerp(1, 0, t)`.
+   *  Sprites with different alphas are placed in separate draw batches. */
+  alpha?: number;
+  /** Rotation in radians, clockwise (Skia Y-down convention). Default 0.
+   *  Applied about the sprite's anchor point. Non-uniform scale combined with
+   *  rotation is unsupported — scale is inferred uniformly from dstW/srcW. */
+  rotation?: number;
+  /**
+   * When true, draw via `drawImageRect` so `width` and `height` are honored
+   * independently (non-uniform scale). Use for background tiles or any sprite
+   * that must fill a non-square destination rect exactly.
+   *
+   * Default (absent/false): drawn via the batched `drawAtlas` uniform-scale
+   * path. Stretched sprites are NOT batched with regular sprites.
+   *
+   * Rotation is unsupported in stretch mode — combine only with `rotation = 0`.
+   */
+  stretch?: boolean;
 }
 /**
  * Create a render system function.
@@ -796,5 +798,64 @@ interface SpriteData {
 declare function createRenderSystem(world: World, query: Query, positionDef: ComponentDef<PositionData>, spriteDef: ComponentDef<SpriteData>, batch: SpriteBatch): () => void;
 /** Canonical Sprite component — queried by the render system alongside `Position`. */
 declare const Sprite: ComponentDef<SpriteData>;
-
-export { type AnySpriteEffect, type BitmapFont, CAVE_INTERIOR_SKSL, Camera2D, type CanvasLike, type CaveInteriorEffect, type ColorFilterFactoryLike, type ColorLike, type CompiledShader, type CustomShaderEffect, type DrawSurfaceLike, type Drawable, type DropShadowEffect, FIRE_SKSL, FOG_SKSL, FOREST_CANOPY_SKSL, type FireEffect, type FlashEffect, type FogEffect, type FollowOptions, type ForestCanopyEffect, type FrameRenderer, type FrameRendererCompiledPass, type FrameRendererModule, type FrameRendererPostFxChain, type FrameRendererPostFxDescriptor, type FrameRendererPostFxRuntime, type Glyph, type GrayscaleEffect, type ImageFilterFactoryLike, type KerningPair, MOON_CRATER_SKSL, MOUNTAIN_HILLS_SKSL, type MoonCraterEffect, type MountainHillsEffect, type OutlineEffect, type PaintLike, type PictureLike, type PictureRecorderLike, type PositionData, RIVER_WAVE_SKSL, ROOFS_CITY_SKSL, type RSXformLike, type RectLike, type RenderStats, Renderer, type RiverWaveEffect, type RoofsCityEffect, type RuntimeEffectFactoryLike, type RuntimeEffectLike, type ShaderUniforms, Sprite, type SpriteAnchor, SpriteBatch, type SpriteColor, type SpriteData, type SpriteDrawCommand, type SpriteEffect, type TintEffect, WATER_SKSL, type WaterEffect, caveInterior, createFrameRenderer, createRenderSystem, custom, drawOrderCompare, drawText, dropShadow, fire, flash, flashIntensity, fog, forestCanopy, getKerning, grayscale, measureText, moonCrater, mountainHills, outline, parseBMFontJSON, riverWave, roofsCity, sortByDrawOrder, tint, updateEffect, water };
+//#endregion
+//#region src/shaders.d.ts
+declare const FIRE_SKSL = "\nuniform float2 resolution;\nuniform float3 color;\nuniform float3 tipColor;\nuniform float speed;\nuniform float intensity;\nuniform float time;\n\nfloat hash(float2 p) { return fract(sin(dot(p, float2(127.1, 311.7))) * 43758.5453); }\n\nfloat vnoise(float2 p) {\n  float2 i = floor(p);\n  float2 f = fract(p);\n  float2 u = f * f * (3.0 - 2.0 * f);\n  float a = hash(i);\n  float b = hash(i + float2(1.0, 0.0));\n  float c = hash(i + float2(0.0, 1.0));\n  float d = hash(i + float2(1.0, 1.0));\n  return mix(mix(a, b, u.x), mix(c, d, u.x), u.y);\n}\n\nfloat fbm(float2 p) {\n  return 0.5 * vnoise(p) + 0.25 * vnoise(p * 2.0);\n}\n\nhalf4 main(float2 coord) {\n  float2 uv = coord / max(resolution, float2(1.0));\n  float2 np = float2(uv.x * 4.0, uv.y * 6.0 - time * speed * 2.0);\n  float n = fbm(np);\n  float flameMask = smoothstep(0.0, intensity, n * (1.0 - uv.y));\n  float3 fireRgb = mix(color, tipColor, uv.y);\n  return half4(fireRgb.r, fireRgb.g, fireRgb.b, flameMask);\n}\n";
+declare const FOG_SKSL = "\nuniform float2 resolution;\nuniform float3 color;\nuniform float density;\nuniform float speed;\nuniform float scale;\nuniform float time;\n\nfloat hash(float2 p) {\n  return fract(sin(dot(p, float2(127.1, 311.7))) * 43758.5453);\n}\n\nfloat valueNoise(float2 p) {\n  float2 i = floor(p);\n  float2 f = fract(p);\n  float2 u = f * f * (3.0 - 2.0 * f);\n  float a = hash(i);\n  float b = hash(i + float2(1.0, 0.0));\n  float c = hash(i + float2(0.0, 1.0));\n  float d = hash(i + float2(1.0, 1.0));\n  return mix(mix(a, b, u.x), mix(c, d, u.x), u.y);\n}\n\nfloat fbm(float2 p) {\n  float value = 0.0;\n  float amplitude = 0.5;\n  for (int i = 0; i < 4; i++) {\n    value += amplitude * valueNoise(p);\n    p *= 2.0;\n    amplitude *= 0.5;\n  }\n  return value;\n}\n\nhalf4 main(float2 coord) {\n  float2 uv = coord / max(resolution, float2(1.0));\n  float2 drift = float2(time * speed, 0.3 * time * speed);\n  float n = clamp(fbm(uv * scale + drift), 0.0, 1.0);\n  return half4(color.r, color.g, color.b, clamp(density * n, 0.0, 1.0));\n}\n";
+declare const WATER_SKSL = "\nuniform float2 resolution;\nuniform float3 color;\nuniform float3 foamColor;\nuniform float waveSpeed;\nuniform float waveAmplitude;\nuniform float time;\n\nhalf4 main(float2 coord) {\n  float2 uv = coord / max(resolution, float2(1.0));\n  float waveDeriv = cos(uv.x * 6.2832 * 3.0 + time * waveSpeed * 2.0) * waveAmplitude * 2.0\n                  + cos(uv.x * 6.2832 * 5.0 - time * waveSpeed * 1.3 + 1.5) * waveAmplitude;\n  float foam = smoothstep(waveAmplitude * 0.6, waveAmplitude * 1.5, waveDeriv);\n  half3 tinted = half3(color.r, color.g, color.b);\n  half3 final = mix(tinted, half3(foamColor.r, foamColor.g, foamColor.b), half(foam));\n  return half4(final, 1.0);\n}\n";
+declare const ROOFS_CITY_SKSL = "\nuniform float2 resolution;\nuniform float3 skyColor;\nuniform float3 roofColor;\nuniform float scrollOffsetY;\nuniform float density;\n\nfloat hash(float x) { return fract(sin(x * 127.1) * 43758.5453); }\n\nfloat buildingTop(float2 uv, float density) {\n  float col = floor(uv.x * density);\n  float h = 0.35 + 0.35 * hash(col);\n  float w = 0.6 + 0.3 * hash(col + 7.3);\n  float edge = step(abs(fract(uv.x * density) - 0.5), w * 0.5);\n  return edge * step(uv.y, h);\n}\n\nhalf4 main(float2 coord) {\n  float2 uv = coord / max(resolution, float2(1.0));\n  uv.y = uv.y + scrollOffsetY / max(resolution.y, 1.0);\n  uv.y = fract(uv.y);\n  float buildings = buildingTop(uv, density);\n  half3 col = mix(half3(skyColor.r, skyColor.g, skyColor.b),\n                  half3(roofColor.r, roofColor.g, roofColor.b),\n                  half(buildings));\n  return half4(col, 1.0);\n}\n";
+declare const FOREST_CANOPY_SKSL = "\nuniform float2 resolution;\nuniform float3 skyColor;\nuniform float3 leafColor;\nuniform float scrollOffsetY;\nuniform float density;\n\nfloat hash(float2 p) { return fract(sin(dot(p, float2(127.1, 311.7))) * 43758.5453); }\n\nfloat valueNoise(float2 p) {\n  float2 i = floor(p);\n  float2 f = fract(p);\n  float2 u = f * f * (3.0 - 2.0 * f);\n  return mix(mix(hash(i), hash(i + float2(1.0, 0.0)), u.x),\n             mix(hash(i + float2(0.0, 1.0)), hash(i + float2(1.0, 1.0)), u.x), u.y);\n}\n\nhalf4 main(float2 coord) {\n  float2 uv = coord / max(resolution, float2(1.0));\n  uv.y = uv.y + scrollOffsetY / max(resolution.y, 1.0);\n  float n = valueNoise(float2(uv.x * density, uv.y * 3.0));\n  float treeLine = 0.55 + 0.25 * valueNoise(float2(uv.x * density * 0.5, 0.0));\n  float canopy = step(uv.y, treeLine) * smoothstep(0.3, 0.7, n);\n  half3 col = mix(half3(skyColor.r, skyColor.g, skyColor.b),\n                  half3(leafColor.r, leafColor.g, leafColor.b),\n                  half(canopy));\n  return half4(col, 1.0);\n}\n";
+declare const RIVER_WAVE_SKSL = "\nuniform float2 resolution;\nuniform float3 waterColor;\nuniform float3 foamColor;\nuniform float scrollOffsetY;\nuniform float waveScale;\n\nhalf4 main(float2 coord) {\n  float2 uv = coord / max(resolution, float2(1.0));\n  float scroll = scrollOffsetY / max(resolution.y, 1.0);\n  float2 p = float2(uv.x, uv.y + scroll);\n  float w1 = sin(p.x * 6.2832 * waveScale + p.y * 4.0) * 0.04;\n  float w2 = sin(p.x * 6.2832 * waveScale * 1.7 - p.y * 2.5 + 1.2) * 0.02;\n  float surface = 0.5 + w1 + w2;\n  float inWater = step(uv.y, surface);\n  float crest = smoothstep(surface - 0.015, surface, uv.y) * (1.0 - inWater) +\n                smoothstep(surface + 0.015, surface, uv.y) * inWater;\n  half3 base = mix(half3(foamColor.r, foamColor.g, foamColor.b),\n                   half3(waterColor.r, waterColor.g, waterColor.b),\n                   half(inWater));\n  half3 col = mix(base, half3(foamColor.r, foamColor.g, foamColor.b), half(crest * 0.6));\n  return half4(col, 1.0);\n}\n";
+declare const MOON_CRATER_SKSL = "\nuniform float2 resolution;\nuniform float3 moonColor;\nuniform float3 craterColor;\nuniform float scrollOffsetY;\nuniform float craterCount;\n\nfloat hash(float2 p) { return fract(sin(dot(p, float2(127.1, 311.7))) * 43758.5453); }\n\nfloat crater(float2 uv, float2 center, float r) {\n  float d = length(uv - center);\n  float rim = smoothstep(r, r * 0.85, d) - smoothstep(r * 0.85, r * 0.65, d);\n  float floor_ = smoothstep(r * 0.65, r * 0.4, d);\n  return rim * 0.6 + floor_ * 0.25;\n}\n\nhalf4 main(float2 coord) {\n  float2 uv = coord / max(resolution, float2(1.0));\n  uv.y = uv.y + scrollOffsetY / max(resolution.y, 1.0);\n  float c = 0.0;\n  for (int i = 0; i < 6; i++) {\n    float fi = float(i);\n    float2 center = float2(hash(float2(fi, 0.0)), hash(float2(fi, 1.0)));\n    float r = 0.04 + 0.07 * hash(float2(fi, 2.0));\n    c += crater(fract(uv), center, r) * step(fi, craterCount - 1.0);\n  }\n  c = clamp(c, 0.0, 1.0);\n  half3 col = mix(half3(moonColor.r, moonColor.g, moonColor.b),\n                  half3(craterColor.r, craterColor.g, craterColor.b),\n                  half(c));\n  return half4(col, 1.0);\n}\n";
+declare const CAVE_INTERIOR_SKSL = "\nuniform float2 resolution;\nuniform float3 caveColor;\nuniform float3 glowColor;\nuniform float scrollOffsetY;\nuniform float stalactiteCount;\n\nfloat hash(float x) { return fract(sin(x * 127.1) * 43758.5453); }\n\nfloat stalactite(float2 uv, float count) {\n  float col = floor(uv.x * count);\n  float tip = 0.1 + 0.2 * hash(col);\n  float w = 0.3 + 0.3 * hash(col + 5.0);\n  float dx = abs(fract(uv.x * count) - 0.5) / (w * 0.5);\n  float shape = step(dx, 1.0) * step(uv.y, tip * (1.0 - clamp(dx, 0.0, 1.0)));\n  return shape;\n}\n\nhalf4 main(float2 coord) {\n  float2 uv = coord / max(resolution, float2(1.0));\n  uv.y = 1.0 - uv.y;\n  uv.y = uv.y + scrollOffsetY / max(resolution.y, 1.0);\n  float stalac = stalactite(uv, stalactiteCount);\n  float glow = smoothstep(0.8, 1.0, uv.y) * (1.0 - stalac);\n  half3 col = mix(half3(caveColor.r, caveColor.g, caveColor.b),\n                  half3(glowColor.r, glowColor.g, glowColor.b),\n                  half(glow));\n  col = mix(col, half3(caveColor.r, caveColor.g, caveColor.b) * half(0.3), half(stalac));\n  return half4(col, 1.0);\n}\n";
+declare const MOUNTAIN_HILLS_SKSL = "\nuniform float2 resolution;\nuniform float3 skyColor;\nuniform float3 hillColor;\nuniform float scrollOffsetY;\nuniform float ridgeScale;\n\nfloat hash(float x) { return fract(sin(x * 127.1) * 43758.5453); }\n\nfloat heightField(float x, float scale) {\n  float h = 0.0;\n  float amp = 0.5;\n  float freq = scale;\n  for (int i = 0; i < 4; i++) {\n    float ix = floor(x * freq);\n    float fx = fract(x * freq);\n    fx = fx * fx * (3.0 - 2.0 * fx);\n    h += amp * mix(hash(ix), hash(ix + 1.0), fx);\n    freq *= 2.0;\n    amp *= 0.5;\n  }\n  return h;\n}\n\nhalf4 main(float2 coord) {\n  float2 uv = coord / max(resolution, float2(1.0));\n  float scroll = scrollOffsetY / max(resolution.y, 1.0);\n  float horizon = 0.4 + 0.3 * heightField(uv.x + scroll * 0.3, ridgeScale);\n  float mountains = step(uv.y, horizon);\n  half3 col = mix(half3(skyColor.r, skyColor.g, skyColor.b),\n                  half3(hillColor.r, hillColor.g, hillColor.b),\n                  half(mountains));\n  return half4(col, 1.0);\n}\n";
+//#endregion
+//#region src/sprite-font.d.ts
+/** A single glyph in a bitmap font. */
+interface Glyph {
+  /** Character code (Unicode). */
+  id: number;
+  /** Source rect in the font texture. */
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+  /** Draw offset. */
+  xOffset: number;
+  yOffset: number;
+  /** Horizontal advance after this glyph. */
+  xAdvance: number;
+}
+/** Kerning pair. */
+interface KerningPair {
+  first: number;
+  second: number;
+  amount: number;
+}
+/** Parsed bitmap font data. */
+interface BitmapFont {
+  /** Line height in pixels. */
+  lineHeight: number;
+  /** Baseline offset. */
+  base: number;
+  /** Glyph map by character code. */
+  glyphs: Map<number, Glyph>;
+  /** Kerning map. Key = `first << 16 | second`. */
+  kernings: Map<number, number>;
+}
+/**
+ * Parse BMFont JSON format (common output from tools like Hiero, BMFont, msdf-bmfont).
+ */
+declare function parseBMFontJSON(json: unknown): BitmapFont;
+/** Get kerning between two characters. */
+declare function getKerning(font: BitmapFont, first: number, second: number): number;
+/** Measure the width of a text string in pixels. */
+declare function measureText(font: BitmapFont, text: string): number;
+/**
+ * Draw text using a SpriteBatch.
+ * Characters are batched as individual sprites from the font texture.
+ */
+declare function drawText(batch: SpriteBatch, font: BitmapFont, image: SkImageLike, text: string, x: number, y: number, scale?: number): void;
+//#endregion
+export { type AnySpriteEffect, type BitmapFont, CAVE_INTERIOR_SKSL, Camera2D, type CanvasLike, type CaveInteriorEffect, type ColorFilterFactoryLike, type ColorLike, type CompiledShader, type CustomShaderEffect, type DrawSurfaceLike, type Drawable, type DropShadowEffect, FIRE_SKSL, FOG_SKSL, FOREST_CANOPY_SKSL, type FireEffect, type FlashEffect, type FogEffect, type FollowOptions, type ForestCanopyEffect, type FrameRenderer, type FrameRendererCompiledPass, type FrameRendererModule, type FrameRendererPostFxChain, type FrameRendererPostFxDescriptor, type FrameRendererPostFxRuntime, type Glyph, type GrayscaleEffect, type ImageFilterFactoryLike, type KerningPair, MOON_CRATER_SKSL, MOUNTAIN_HILLS_SKSL, type MoonCraterEffect, type MountainHillsEffect, type OutlineEffect, type PaintLike, type PictureLike, type PictureRecorderLike, type PositionData, RIVER_WAVE_SKSL, ROOFS_CITY_SKSL, type RSXformLike, type RectLike, type RenderStats, Renderer, type RiverWaveEffect, type RoofsCityEffect, type RuntimeEffectFactoryLike, type RuntimeEffectLike, type ShaderUniforms, Sprite, type SpriteAnchor, SpriteBatch, type SpriteColor, type SpriteData, type SpriteDrawCommand, type SpriteEffect, type TintEffect, WATER_SKSL, type WaterEffect, caveInterior, createFrameRenderer, createRenderSystem, custom, drawOrderCompare, drawText, dropShadow, fire, flash, flashIntensity, fog, forestCanopy, getKerning, getXformCounters, grayscale, measureText, moonCrater, mountainHills, outline, parseBMFontJSON, resetXformCounters, riverWave, roofsCity, sortByDrawOrder, tint, updateEffect, water };
+//# sourceMappingURL=index.d.mts.map