@codexo/exojs 0.12.0 → 0.13.0

package/dist/esm/rendering/index.d.ts

@@ -5,6 +5,7 @@ export type { CameraOptions } from './Camera';
 export { Camera } from './Camera';
 export { Container } from './Container';
 export { Drawable } from './Drawable';
+export type { PixelSnapMode } from './pixelSnap';
 export type { RenderBackend } from './RenderBackend';
 export { RenderBackendType } from './RenderBackendType';
 export type { DrawableConstructor, Renderer } from './Renderer';
@@ -56,6 +57,10 @@ export { ShaderUniform } from '#rendering/shader/ShaderUniform';
 export { upgradeFragmentShaderToGl300 } from '#rendering/shader/upgradeFragmentShaderToGl300';
 export type { AnimatedSpriteClipDefinition, AnimatedSpritePlayOptions } from '#rendering/sprite/AnimatedSprite';
 export { AnimatedSprite } from '#rendering/sprite/AnimatedSprite';
+export type { NineSliceInsets, NineSliceModes, NineSliceOptions } from '#rendering/sprite/nineSlice';
+export { NineSliceSprite } from '#rendering/sprite/NineSliceSprite';
+export { RepeatingSprite } from '#rendering/sprite/RepeatingSprite';
+export type { RepeatingSpriteOptions } from '#rendering/sprite/repeatingSpritePlan';
 export { Sprite, SpriteFlags } from '#rendering/sprite/Sprite';
 export type { SpritesheetData, SpritesheetFrame } from '#rendering/sprite/Spritesheet';
 export { Spritesheet } from '#rendering/sprite/Spritesheet';
@@ -78,16 +83,22 @@ export type { GlyphInfo, GlyphKey, GlyphPlacement, GlyphProvider, TextAlignment,
 export type { DataTextureBuffer, DataTextureDirtyRegion, DataTextureFormat, DataTextureOptions } from '#rendering/texture/DataTexture';
 export { DataTexture } from '#rendering/texture/DataTexture';
 export { RenderTexture } from '#rendering/texture/RenderTexture';
+export type { RepeatFit, RepeatMode, RepeatPlan, RepeatSegment } from '#rendering/texture/repeat';
+export { planRepeat } from '#rendering/texture/repeat';
 export type { SamplerOptions } from '#rendering/texture/Sampler';
 export { Sampler } from '#rendering/texture/Sampler';
 export { Texture } from '#rendering/texture/Texture';
+export type { TextureRegionInsets, TextureRegionOptions } from '#rendering/texture/TextureRegion';
+export { TextureRegion } from '#rendering/texture/TextureRegion';
 export { Video } from '#rendering/video/Video';
 export { AbstractWebGl2BatchedRenderer } from '#rendering/webgl2/AbstractWebGl2BatchedRenderer';
 export { AbstractWebGl2Renderer } from '#rendering/webgl2/AbstractWebGl2Renderer';
 export { WebGl2Backend } from '#rendering/webgl2/WebGl2Backend';
 export { WebGl2MeshRenderer } from '#rendering/webgl2/WebGl2MeshRenderer';
+export { WebGl2NineSliceSpriteRenderer } from '#rendering/webgl2/WebGl2NineSliceSpriteRenderer';
 export type { WebGl2RenderBufferRuntime } from '#rendering/webgl2/WebGl2RenderBuffer';
 export { WebGl2RenderBuffer } from '#rendering/webgl2/WebGl2RenderBuffer';
+export { WebGl2RepeatingSpriteRenderer } from '#rendering/webgl2/WebGl2RepeatingSpriteRenderer';
 export { WebGl2ShaderBlock } from '#rendering/webgl2/WebGl2ShaderBlock';
 export { webGl2PrimitiveArrayConstructors, webGl2PrimitiveByteSizeMapping, webGl2PrimitiveTypeNames } from '#rendering/webgl2/WebGl2ShaderMappings';
 export { createWebGl2ShaderProgram } from '#rendering/webgl2/WebGl2ShaderProgram';
@@ -101,6 +112,8 @@ export { WebGpuComputePipeline, WebGpuStorageBuffer } from '#rendering/webgpu/co
 export { WebGpuBackend } from '#rendering/webgpu/WebGpuBackend';
 export { getWebGpuBlendState } from '#rendering/webgpu/WebGpuBlendState';
 export { WebGpuMeshRenderer } from '#rendering/webgpu/WebGpuMeshRenderer';
+export { WebGpuNineSliceSpriteRenderer } from '#rendering/webgpu/WebGpuNineSliceSpriteRenderer';
+export { WebGpuRepeatingSpriteRenderer } from '#rendering/webgpu/WebGpuRepeatingSpriteRenderer';
 export { WebGpuSpriteRenderer } from '#rendering/webgpu/WebGpuSpriteRenderer';
 export { WebGpuTextRenderer } from '#rendering/webgpu/WebGpuTextRenderer';
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/rendering/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/rendering/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/rendering/index.ts"],"names":[],"mappings":"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"}

package/dist/esm/rendering/pixelSnap.d.ts

@@ -0,0 +1,219 @@
+import type { Matrix } from '#math/Matrix';
+import type { Rectangle } from '#math/Rectangle';
+import type { Drawable } from './Drawable';
+import type { View } from './View';
+/**
+ * Render-only pixel snapping.
+ *
+ * ## Coordinate spaces
+ *
+ * A drawable travels through these spaces before it lands on the screen:
+ *
+ * ```
+ * local space      quad / boundary coordinates relative to the node origin
+ *   │  × node world matrix (a, b, c, d, x, y)  — logical, NEVER mutated here
+ *   ▼
+ * world space      the scene's logical coordinate system
+ *   │  × View.getTransform()                   — the camera (center, zoom, rotation)
+ *   ▼
+ * clip space       OpenGL/WebGPU normalised device coordinates, [-1, 1]
+ *   │  × viewport (fraction) × target device pixels
+ *   ▼
+ * device space     actual pixels of the active render target
+ *                  (root canvas = css × pixelRatio; RenderTexture = its own size)
+ * ```
+ *
+ * Pixel snapping aligns rendered geometry to **device pixels** — not to integer
+ * world units. One world unit only equals one device pixel when the view scale
+ * and pixel ratio are both `1`; under zoom or a high-DPR backbuffer the device
+ * grid is finer or coarser, so we always project into device space, round there,
+ * and project back. The full world↔device mapping is provided by the existing,
+ * tested {@link View.worldToScreen} / {@link View.screenToWorld} helpers — we
+ * pass the **active render target's device-pixel dimensions** so the result is
+ * device-correct for both the main canvas and offscreen render targets, and
+ * correct under viewport rectangles (split-screen).
+ *
+ * ## Render-only contract
+ *
+ * Snapping happens on the CPU during render-data preparation and affects only
+ * the values handed to the GPU for that frame. It never mutates logical
+ * position, world/local matrices used for queries, collision data, tween or
+ * physics state, or {@link SceneNode.getBounds} results. {@link snapWorldTranslationInto}
+ * writes into a caller-owned scratch matrix; the node's cached global transform
+ * is left untouched.
+ *
+ * ## Modes
+ *
+ * - `position` — snap the node's rendered origin (the world translation) only.
+ *   Touches the matrix translation `(x, y)` exclusively, leaving the linear part
+ *   `(a, b, c, d)` intact, so it is safe under any transform (rotation, skew,
+ *   non-uniform scale) — the origin is a single point with a well-defined device
+ *   position.
+ * - `geometry` — additionally snap shared geometry boundaries (NineSlice edges,
+ *   repeat-segment boundaries, the sprite quad). Each unique boundary is snapped
+ *   by the **same** pure function {@link snapLocalBoundary}, so adjacent quads
+ *   that share a boundary value snap to the same result — seams cannot open.
+ *   Guaranteed only for **axis-aligned** transforms; rotation / skew (in the
+ *   node or the view) downgrade it to `position` (see
+ *   {@link resolveEffectivePixelSnapMode}).
+ *
+ * ## Rounding policy
+ *
+ * Nearest device pixel via `Math.round` (ties toward +∞). One deterministic
+ * policy used everywhere, so CPU debug values, WebGL2 and WebGPU all agree.
+ *
+ * @module
+ */
+/**
+ * Render-only pixel-snapping policy for a {@link Drawable}.
+ *
+ * - `'none'` — no snapping; rendered transform and geometry use existing behaviour.
+ * - `'position'` — snap the rendered origin to the nearest device pixel. Logical
+ *   `x`/`y`, matrices, bounds and collision are unchanged.
+ * - `'geometry'` — snap a single coherent shared-boundary plan (origin + boundaries)
+ *   so neighbouring quads stay seam-free. Falls back to `'position'` automatically
+ *   when the transform is not axis-aligned (rotation / skew).
+ *
+ * Snapping targets device pixels (× view scale × pixel ratio), not integer world
+ * units, and never alters logical state.
+ *
+ * @default 'none'
+ * @stable
+ */
+export type PixelSnapMode = 'none' | 'position' | 'geometry';
+/**
+ * Runtime guard for the {@link PixelSnapMode} union. Used by the public setter to
+ * reject JavaScript-invalid values atomically.
+ * @internal
+ */
+export declare function isPixelSnapMode(value: unknown): value is PixelSnapMode;
+/**
+ * Axis-aligned device-pixel mapping for one drawable in the active pass. Built
+ * from the node world matrix, the pass {@link View}, and the active render
+ * target's device-pixel dimensions. Distances/positions are in device pixels;
+ * `worldX`/`worldY` are back in world space.
+ * @internal
+ */
+export interface PixelSnapContext {
+    /** Device-pixel position of the node's local origin, before snapping. */
+    readonly originX: number;
+    readonly originY: number;
+    /** Device-pixel position of the local origin after snapping to the nearest pixel. */
+    readonly snappedOriginX: number;
+    readonly snappedOriginY: number;
+    /** World translation that places the local origin exactly on the snapped device pixel. */
+    readonly worldX: number;
+    readonly worldY: number;
+    /** Signed device pixels per local unit along X / Y (node scale × view scale × DPR). */
+    readonly scaleX: number;
+    readonly scaleY: number;
+    /** `true` when local axes map cleanly to device axes (no rotation/skew in node or view). */
+    readonly axisAligned: boolean;
+}
+/**
+ * Build the device-pixel snap context for `world` (a node's global transform)
+ * under `view`, targeting a surface of `targetPxWidth` × `targetPxHeight` device
+ * pixels. Pure — does not mutate `world` or `view`. Falls back to a no-op context
+ * (snapped origin = original origin) when the target size or projection is
+ * degenerate, so callers can always use the result safely.
+ * @internal
+ */
+export declare function buildPixelSnapContext(world: Matrix, view: View, targetPxWidth: number, targetPxHeight: number): PixelSnapContext;
+/**
+ * Copy `world` into `out`, replacing only the translation with the snapped world
+ * origin from `ctx`. The linear part `(a, b, c, d)` and homogeneous row are
+ * preserved, so rotation / scale / skew are untouched — position snapping is safe
+ * under any transform. The source `world` matrix is never mutated.
+ * @internal
+ */
+export declare function snapWorldTranslationInto(out: Matrix, world: Matrix, ctx: PixelSnapContext): Matrix;
+/**
+ * Snap a single local boundary coordinate to the device-pixel grid along an axis
+ * whose local→device scale is `scale`. Returns the local value whose device
+ * position (relative to the already-snapped origin) lands on an integer device
+ * pixel: `round(L · scale) / scale`.
+ *
+ * The function is pure, so two boundaries with the same input value snap to the
+ * same output — shared boundaries stay shared and seams cannot open. It is also
+ * monotonic non-decreasing in `L` for any non-zero `scale` (including negative
+ * scale from a flip), so boundary order is preserved and snapped spans never go
+ * negative. Degenerate scales (`|scale| < epsilon`) and non-finite inputs return
+ * the value unchanged.
+ * @internal
+ */
+export declare function snapLocalBoundary(localValue: number, scale: number): number;
+/** A local-space quad with UVs — the content-cache shape shared by NineSlice / RepeatingSprite. @internal */
+export interface BoundaryQuad {
+    readonly x0: number;
+    readonly y0: number;
+    readonly x1: number;
+    readonly y1: number;
+    readonly u0: number;
+    readonly v0: number;
+    readonly u1: number;
+    readonly v1: number;
+}
+/** Mutable quad produced by {@link snapQuadsInto}; consumed by the batched sprite renderers. @internal */
+export interface RenderQuad {
+    x0: number;
+    y0: number;
+    x1: number;
+    y1: number;
+    u0: number;
+    v0: number;
+    u1: number;
+    v1: number;
+}
+/**
+ * Snap every quad's local X/Y boundaries to the device grid using the per-axis
+ * scale in `ctx`, writing the result into the reusable `out` buffer (grown /
+ * truncated to match `source`, never reallocated per frame once warm). UVs are
+ * copied verbatim — sampling is unchanged. Because {@link snapLocalBoundary} is
+ * pure, quads sharing a boundary value stay seam-free without any explicit
+ * de-duplication.
+ * @internal
+ */
+export declare function snapQuadsInto(source: readonly BoundaryQuad[], ctx: PixelSnapContext, out: RenderQuad[]): RenderQuad[];
+/**
+ * Resolve the world transform to upload for `drawable` at the transform-buffer
+ * write seam. Returns the drawable's live global transform unchanged when its
+ * mode is `'none'` (zero overhead), otherwise a snapped copy written into the
+ * caller-owned `scratch` matrix — the logical global transform is never mutated.
+ *
+ * Both backends call this at their single transform-write boundary, so position
+ * snapping (and tilemap chunk/layer origin snapping) is applied once, backend-
+ * neutrally, to every drawable. `view` and the target device-pixel dimensions
+ * come from the active pass.
+ * @internal
+ */
+export declare function resolveUploadTransform(drawable: Drawable, view: View, targetPxWidth: number, targetPxHeight: number, scratch: Matrix): Matrix;
+/**
+ * Snap a single local-space bounds rectangle (e.g. a sprite quad) to the device
+ * grid using the per-axis scale in `ctx`, writing the result into `out`. Each of
+ * the four edges is snapped by {@link snapLocalBoundary}, so combined with the
+ * device-snapped origin every corner lands on a whole device pixel. `out` may be
+ * the same instance across frames (no allocation). UV/texture mapping is the
+ * caller's concern and is unaffected.
+ * @internal
+ */
+export declare function snapBoundsInto(base: Rectangle, ctx: PixelSnapContext, out: Rectangle): Rectangle;
+/** Reason a requested `geometry` snap was downgraded. @internal */
+export type PixelSnapDowngradeReason = 'non-axis-aligned' | null;
+/**
+ * Resolve the effective snap mode from the requested mode and whether the
+ * combined node+view transform is axis-aligned. `geometry` downgrades to
+ * `position` when the transform is not axis-aligned (rotation or skew, in the
+ * node itself or any ancestor or the view); `none` and `position` pass through
+ * unchanged. Pure and stateless — never stores an effective mode, so it always
+ * reflects the current world transform.
+ * @internal
+ */
+export declare function resolveEffectivePixelSnapMode(requested: PixelSnapMode, axisAligned: boolean): PixelSnapMode;
+/**
+ * Diagnostic companion to {@link resolveEffectivePixelSnapMode}: returns why a
+ * `geometry` request was downgraded, or `null` when no downgrade occurred. Not a
+ * stable public API — exposed for tests and dev warnings only.
+ * @internal
+ */
+export declare function getPixelSnapDowngradeReason(requested: PixelSnapMode, axisAligned: boolean): PixelSnapDowngradeReason;
+//# sourceMappingURL=pixelSnap.d.ts.map

package/dist/esm/rendering/pixelSnap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pixelSnap.d.ts","sourceRoot":"","sources":["../../../src/rendering/pixelSnap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAEnC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AAEH;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,CAAC;AAI7D;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAEtE;AAKD;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,yEAAyE;IACzE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,qFAAqF;IACrF,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,0FAA0F;IAC1F,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,uFAAuF;IACvF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,4FAA4F;IAC5F,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,gBAAgB,CAgEhI;AAgBD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,gBAAgB,GAAG,MAAM,CAMlG;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAM3E;AAED,6GAA6G;AAC7G,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED,0GAA0G;AAC1G,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,EAAE,GAAG,EAAE,gBAAgB,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,CAwBrH;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAU7I;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,gBAAgB,EAAE,GAAG,EAAE,SAAS,GAAG,SAAS,CAOhG;AAED,mEAAmE;AACnE,MAAM,MAAM,wBAAwB,GAAG,kBAAkB,GAAG,IAAI,CAAC;AAEjE;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CAAC,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,OAAO,GAAG,aAAa,CAM3G;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,OAAO,GAAG,wBAAwB,CAMpH"}

package/dist/esm/rendering/pixelSnap.js

@@ -0,0 +1,186 @@
+const pixelSnapModes = new Set(['none', 'position', 'geometry']);
+/**
+ * Runtime guard for the {@link PixelSnapMode} union. Used by the public setter to
+ * reject JavaScript-invalid values atomically.
+ * @internal
+ */
+function isPixelSnapMode(value) {
+    return typeof value === 'string' && pixelSnapModes.has(value);
+}
+/** Below this magnitude an axis is treated as collapsed / cross-coupled. @internal */
+const epsilon = 1e-6;
+/**
+ * Build the device-pixel snap context for `world` (a node's global transform)
+ * under `view`, targeting a surface of `targetPxWidth` × `targetPxHeight` device
+ * pixels. Pure — does not mutate `world` or `view`. Falls back to a no-op context
+ * (snapped origin = original origin) when the target size or projection is
+ * degenerate, so callers can always use the result safely.
+ * @internal
+ */
+function buildPixelSnapContext(world, view, targetPxWidth, targetPxHeight) {
+    const ox = world.x;
+    const oy = world.y;
+    if (!(targetPxWidth > 0) || !(targetPxHeight > 0)) {
+        return noopContext(ox, oy);
+    }
+    // Forward projection only (world → device). The view's inverse is deliberately
+    // avoided; instead the origin plus two world-unit axis tips give the exact
+    // world→device Jacobian, which we invert ourselves (a 2×2) to map the snapped
+    // device origin back to world space. This stays exact for any affine view.
+    const origin = view.worldToScreen(ox, oy, targetPxWidth, targetPxHeight);
+    if (!Number.isFinite(origin.x) || !Number.isFinite(origin.y)) {
+        return noopContext(ox, oy);
+    }
+    const tipWorldX = view.worldToScreen(ox + 1, oy, targetPxWidth, targetPxHeight);
+    const tipWorldY = view.worldToScreen(ox, oy + 1, targetPxWidth, targetPxHeight);
+    // Columns of the world→device Jacobian J = [[jxx, jyx], [jxy, jyy]].
+    const jxx = tipWorldX.x - origin.x;
+    const jxy = tipWorldX.y - origin.y;
+    const jyx = tipWorldY.x - origin.x;
+    const jyy = tipWorldY.y - origin.y;
+    // Local axes in device pixels: apply the node's linear part to the Jacobian —
+    // local (1,0)→world (a,c), local (0,1)→world (b,d).
+    const scaleX = world.a * jxx + world.c * jyx; // device-x per local-x unit
+    const crossXy = world.a * jxy + world.c * jyy; // device-y per local-x unit
+    const crossYx = world.b * jxx + world.d * jyx; // device-x per local-y unit
+    const scaleY = world.b * jxy + world.d * jyy; // device-y per local-y unit
+    const axisAligned = Math.abs(crossXy) < epsilon && Math.abs(crossYx) < epsilon;
+    const snappedOriginX = Math.round(origin.x);
+    const snappedOriginY = Math.round(origin.y);
+    // Map the snapped device origin back to world via J⁻¹ so that, re-projected
+    // through the (unchanged) view, the rendered origin lands on the device pixel.
+    let worldX = ox;
+    let worldY = oy;
+    const det = jxx * jyy - jyx * jxy;
+    if (Math.abs(det) > epsilon) {
+        const ddx = snappedOriginX - origin.x;
+        const ddy = snappedOriginY - origin.y;
+        worldX = ox + (jyy * ddx - jyx * ddy) / det;
+        worldY = oy + (jxx * ddy - jxy * ddx) / det;
+    }
+    return {
+        originX: origin.x,
+        originY: origin.y,
+        snappedOriginX,
+        snappedOriginY,
+        worldX,
+        worldY,
+        scaleX,
+        scaleY,
+        axisAligned,
+    };
+}
+function noopContext(ox, oy) {
+    return {
+        originX: ox,
+        originY: oy,
+        snappedOriginX: ox,
+        snappedOriginY: oy,
+        worldX: ox,
+        worldY: oy,
+        scaleX: 0,
+        scaleY: 0,
+        axisAligned: false,
+    };
+}
+/**
+ * Copy `world` into `out`, replacing only the translation with the snapped world
+ * origin from `ctx`. The linear part `(a, b, c, d)` and homogeneous row are
+ * preserved, so rotation / scale / skew are untouched — position snapping is safe
+ * under any transform. The source `world` matrix is never mutated.
+ * @internal
+ */
+function snapWorldTranslationInto(out, world, ctx) {
+    out.copy(world);
+    out.x = ctx.worldX;
+    out.y = ctx.worldY;
+    return out;
+}
+/**
+ * Snap a single local boundary coordinate to the device-pixel grid along an axis
+ * whose local→device scale is `scale`. Returns the local value whose device
+ * position (relative to the already-snapped origin) lands on an integer device
+ * pixel: `round(L · scale) / scale`.
+ *
+ * The function is pure, so two boundaries with the same input value snap to the
+ * same output — shared boundaries stay shared and seams cannot open. It is also
+ * monotonic non-decreasing in `L` for any non-zero `scale` (including negative
+ * scale from a flip), so boundary order is preserved and snapped spans never go
+ * negative. Degenerate scales (`|scale| < epsilon`) and non-finite inputs return
+ * the value unchanged.
+ * @internal
+ */
+function snapLocalBoundary(localValue, scale) {
+    if (!Number.isFinite(localValue) || Math.abs(scale) < epsilon) {
+        return localValue;
+    }
+    return Math.round(localValue * scale) / scale;
+}
+/**
+ * Snap every quad's local X/Y boundaries to the device grid using the per-axis
+ * scale in `ctx`, writing the result into the reusable `out` buffer (grown /
+ * truncated to match `source`, never reallocated per frame once warm). UVs are
+ * copied verbatim — sampling is unchanged. Because {@link snapLocalBoundary} is
+ * pure, quads sharing a boundary value stay seam-free without any explicit
+ * de-duplication.
+ * @internal
+ */
+function snapQuadsInto(source, ctx, out) {
+    const { scaleX, scaleY } = ctx;
+    out.length = source.length;
+    for (let i = 0; i < source.length; i++) {
+        const q = source[i];
+        let t = out[i];
+        if (t === undefined) {
+            t = out[i] = { x0: 0, y0: 0, x1: 0, y1: 0, u0: 0, v0: 0, u1: 0, v1: 0 };
+        }
+        t.x0 = snapLocalBoundary(q.x0, scaleX);
+        t.x1 = snapLocalBoundary(q.x1, scaleX);
+        t.y0 = snapLocalBoundary(q.y0, scaleY);
+        t.y1 = snapLocalBoundary(q.y1, scaleY);
+        t.u0 = q.u0;
+        t.v0 = q.v0;
+        t.u1 = q.u1;
+        t.v1 = q.v1;
+    }
+    return out;
+}
+/**
+ * Resolve the world transform to upload for `drawable` at the transform-buffer
+ * write seam. Returns the drawable's live global transform unchanged when its
+ * mode is `'none'` (zero overhead), otherwise a snapped copy written into the
+ * caller-owned `scratch` matrix — the logical global transform is never mutated.
+ *
+ * Both backends call this at their single transform-write boundary, so position
+ * snapping (and tilemap chunk/layer origin snapping) is applied once, backend-
+ * neutrally, to every drawable. `view` and the target device-pixel dimensions
+ * come from the active pass.
+ * @internal
+ */
+function resolveUploadTransform(drawable, view, targetPxWidth, targetPxHeight, scratch) {
+    const world = drawable.getGlobalTransform();
+    if (drawable.pixelSnapMode === 'none') {
+        return world;
+    }
+    const ctx = buildPixelSnapContext(world, view, targetPxWidth, targetPxHeight);
+    return snapWorldTranslationInto(scratch, world, ctx);
+}
+/**
+ * Snap a single local-space bounds rectangle (e.g. a sprite quad) to the device
+ * grid using the per-axis scale in `ctx`, writing the result into `out`. Each of
+ * the four edges is snapped by {@link snapLocalBoundary}, so combined with the
+ * device-snapped origin every corner lands on a whole device pixel. `out` may be
+ * the same instance across frames (no allocation). UV/texture mapping is the
+ * caller's concern and is unaffected.
+ * @internal
+ */
+function snapBoundsInto(base, ctx, out) {
+    const left = snapLocalBoundary(base.left, ctx.scaleX);
+    const top = snapLocalBoundary(base.top, ctx.scaleY);
+    const right = snapLocalBoundary(base.right, ctx.scaleX);
+    const bottom = snapLocalBoundary(base.bottom, ctx.scaleY);
+    return out.set(left, top, right - left, bottom - top);
+}
+
+export { buildPixelSnapContext, isPixelSnapMode, resolveUploadTransform, snapBoundsInto, snapLocalBoundary, snapQuadsInto, snapWorldTranslationInto };
+//# sourceMappingURL=pixelSnap.js.map

package/dist/esm/rendering/pixelSnap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pixelSnap.js","sources":["../../../../src/rendering/pixelSnap.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/rendering/plan/RenderPlanPlayer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RenderPlanPlayer.d.ts","sourceRoot":"","sources":["../../../../src/rendering/plan/RenderPlanPlayer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAK9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAc,WAAW,EAAE,MAAM,eAAe,CAAC;AA6B7D,gBAAgB;AAChB,qBAAa,gBAAgB;WACb,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI;WA0BpD,SAAS,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI;IAMzE,OAAO,CAAC,MAAM,CAAC,UAAU;IAYzB,OAAO,CAAC,MAAM,CAAC,UAAU;IAoDzB,OAAO,CAAC,MAAM,CAAC,sBAAsB;IAOrC,OAAO,CAAC,MAAM,CAAC,iCAAiC;IAahD,OAAO,CAAC,MAAM,CAAC,4BAA4B;CAM5C"}
+{"version":3,"file":"RenderPlanPlayer.d.ts","sourceRoot":"","sources":["../../../../src/rendering/plan/RenderPlanPlayer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAK9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAc,WAAW,EAAE,MAAM,eAAe,CAAC;AA6B7D,gBAAgB;AAChB,qBAAa,gBAAgB;WACb,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI;WA0BpD,SAAS,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI;IAMzE,OAAO,CAAC,MAAM,CAAC,UAAU;IAYzB,OAAO,CAAC,MAAM,CAAC,UAAU;IA2EzB,OAAO,CAAC,MAAM,CAAC,sBAAsB;IAOrC,OAAO,CAAC,MAAM,CAAC,iCAAiC;IAahD,OAAO,CAAC,MAAM,CAAC,4BAA4B;CAM5C"}

package/dist/esm/rendering/plan/RenderPlanPlayer.js

@@ -43,13 +43,33 @@ class RenderPlanPlayer {
         let groupCursor = 0;
         let currentGroup = null;
         let currentInstructionIndex = 0;
+        // Phase 1 — populate the CPU transform buffer for all groups in this scope
+        // before any renderer draws execute. Without this separation, each
+        // per-group upload changes the buffer hash while a renderer holds an
+        // in-flight batch; the next flush detects the changed hash and re-uploads
+        // the growing buffer, producing O(groups²) GPU transform writes per pass
+        // (measured: ~240 KB/frame for 100 NineSlice sprites across 8 textures,
+        // ~600 MB/frame for 5000 RepeatingSprites). Writing every group's
+        // transforms first ensures the hash is stable by the time the first flush
+        // calls bindTransformBufferTexture/getTransformStorageBuffer, so all
+        // subsequent flushes within the same scope find an unchanged hash and skip
+        // the upload entirely.
+        if (hooks._prepareRenderGroupUpload !== undefined) {
+            let preInstructionIndex = context.passInstructionIndex;
+            for (let gi = 0; gi < groups.length; gi++) {
+                const group = groups[gi];
+                hooks._prepareRenderGroupUpload(group, this._createRenderGroupPlaybackContext(group.instructions.length, preInstructionIndex, context.passGroupIndex + gi));
+                preInstructionIndex += group.instructions.length;
+            }
+        }
+        // Phase 2 — execute draws in document order. Transform writes are already
+        // done; _prepareRenderGroupUpload is intentionally not called a second time.
         for (const entry of scope.entries) {
             if (entry.kind === RenderEntryKind.Draw) {
                 if (currentGroup === null) {
                     currentGroup = groups[groupCursor];
                     currentInstructionIndex = 0;
                     hooks._beginRenderGroup?.(currentGroup);
-                    hooks._prepareRenderGroupUpload?.(currentGroup, this._createRenderGroupPlaybackContext(currentGroup.instructions.length, context.passInstructionIndex, context.passGroupIndex));
                     context.passGroupIndex++;
                 }
                 // Allocate the per-draw instruction slot only when a backend consumes

package/dist/esm/rendering/plan/RenderPlanPlayer.js.map

@@ -1 +1 @@
-{"version":3,"file":"RenderPlanPlayer.js","sources":["../../../../../src/rendering/plan/RenderPlanPlayer.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}
+{"version":3,"file":"RenderPlanPlayer.js","sources":["../../../../../src/rendering/plan/RenderPlanPlayer.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/rendering/sprite/NineSliceSprite.d.ts

@@ -0,0 +1,69 @@
+import type { Rectangle } from '#math/Rectangle';
+import { Drawable } from '#rendering/Drawable';
+import type { Texture } from '#rendering/texture/Texture';
+import { TextureRegion } from '#rendering/texture/TextureRegion';
+import type { View } from '#rendering/View';
+import type { NineSliceInsets, NineSliceModes, NineSliceOptions, NineSliceQuad } from './nineSlice';
+/**
+ * A scalable nine-slice (9-patch) sprite.
+ * Corners stay pixel-perfect; edges/center fill by stretch, repeat, or mirror-repeat.
+ * @stable
+ */
+export declare class NineSliceSprite extends Drawable {
+    private _region;
+    private _slices;
+    private _border;
+    private _width;
+    private _height;
+    private _modes;
+    private _quads;
+    private _geometryDirty;
+    private readonly _renderQuads;
+    constructor(texture: Texture | TextureRegion, options: NineSliceOptions);
+    /** The TextureRegion this nine-slice samples from. */
+    get region(): TextureRegion;
+    /** Convenience accessor: the texture underlying the region. */
+    get texture(): Texture;
+    /** The engine-owned, frozen source slice insets. */
+    get slices(): Readonly<NineSliceInsets>;
+    /** The engine-owned, frozen destination border insets. */
+    get border(): Readonly<NineSliceInsets>;
+    /** The engine-owned, frozen edge/center fill modes. */
+    get modes(): Readonly<NineSliceModes>;
+    /** Destination width in local units. */
+    get width(): number;
+    set width(value: number);
+    /** Destination height in local units. */
+    get height(): number;
+    set height(value: number);
+    /** Set destination size. Fails atomically — prior state is preserved on invalid input. */
+    setSize(width: number, height: number): this;
+    /** Update the SOURCE-space slice insets. Fails atomically. No-ops on equivalent values. */
+    setSlices(slices: number | Partial<NineSliceInsets>): this;
+    /** Update the DESTINATION border sizes. Fails atomically. No-ops on equivalent values. */
+    setBorder(border: number | Partial<NineSliceInsets>): this;
+    /** Update the edge/center fill modes. Input is copied, validated, and frozen. No-ops on equivalent values. */
+    setModes(modes: NineSliceModes): this;
+    getLocalBounds(): Rectangle;
+    /**
+     * Lazily-built geometry quads. Each quad describes one rendered sub-region
+     * in local space with its corresponding UV bounds.
+     * @internal
+     */
+    get quads(): readonly NineSliceQuad[];
+    /**
+     * Render-time quads for the active pass. In `'geometry'` pixel-snap mode (and
+     * only when the combined node+view transform is axis-aligned) the shared
+     * boundary plan is snapped to the render target's device-pixel grid via the
+     * common {@link snapQuadsInto} helper, so every corner/edge/center quad reuses
+     * the exact same snapped boundary value and no seams can open. The content
+     * quad cache ({@link quads}) is never rebuilt by snapping — camera movement
+     * reuses it — and snapped quads are written into a reused buffer. Returns the
+     * unsnapped content quads for `'none'`/`'position'` or under a rotation/skew
+     * downgrade.
+     * @internal
+     */
+    getRenderQuads(view: View, targetPxWidth: number, targetPxHeight: number): readonly NineSliceQuad[];
+    private _rebuildGeometry;
+}
+//# sourceMappingURL=NineSliceSprite.d.ts.map

package/dist/esm/rendering/sprite/NineSliceSprite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NineSliceSprite.d.ts","sourceRoot":"","sources":["../../../../src/rendering/sprite/NineSliceSprite.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAyBpG;;;;GAIG;AACH,qBAAa,eAAgB,SAAQ,QAAQ;IAC3C,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAA2B;IAEzC,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,cAAc,CAAQ;IAC9B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAoB;gBAE9B,OAAO,EAAE,OAAO,GAAG,aAAa,EAAE,OAAO,EAAE,gBAAgB;IAyC9E,sDAAsD;IACtD,IAAW,MAAM,IAAI,aAAa,CAEjC;IAED,+DAA+D;IAC/D,IAAW,OAAO,IAAI,OAAO,CAE5B;IAED,oDAAoD;IACpD,IAAW,MAAM,IAAI,QAAQ,CAAC,eAAe,CAAC,CAE7C;IAED,0DAA0D;IAC1D,IAAW,MAAM,IAAI,QAAQ,CAAC,eAAe,CAAC,CAE7C;IAED,uDAAuD;IACvD,IAAW,KAAK,IAAI,QAAQ,CAAC,cAAc,CAAC,CAE3C;IAMD,wCAAwC;IACxC,IAAW,KAAK,IAAI,MAAM,CAEzB;IAED,IAAW,KAAK,CAAC,KAAK,EAAE,MAAM,EAE7B;IAED,yCAAyC;IACzC,IAAW,MAAM,IAAI,MAAM,CAE1B;IAED,IAAW,MAAM,CAAC,KAAK,EAAE,MAAM,EAE9B;IAMD,0FAA0F;IACnF,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAanD,2FAA2F;IACpF,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI;IAejE,0FAA0F;IACnF,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI;IAcjE,8GAA8G;IACvG,QAAQ,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAiB5B,cAAc,IAAI,SAAS;IAU3C;;;;OAIG;IACH,IAAW,KAAK,IAAI,SAAS,aAAa,EAAE,CAM3C;IAED;;;;;;;;;;;OAWG;IACI,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,SAAS,aAAa,EAAE;IAsB1G,OAAO,CAAC,gBAAgB;CAWzB"}