@codexo/exojs 0.12.0 → 0.14.0

package/dist/esm/rendering/mesh/Mesh.d.ts

@@ -68,14 +68,20 @@ export interface MeshOptions {
  * `recomputeLocalBounds()`).
  */
 export declare class Mesh extends Drawable {
-    readonly vertices: Float32Array;
-    readonly indices: Uint16Array | null;
-    readonly uvs: Float32Array | null;
-    readonly colors: Uint32Array | null;
+    protected _vertices: Float32Array;
+    protected _indices: Uint16Array | null;
+    protected _uvs: Float32Array | null;
+    protected _colors: Uint32Array | null;
+    protected _material: MeshMaterial | null;
+    protected _geometry: Geometry | null;
+    get vertices(): Float32Array;
+    get indices(): Uint16Array | null;
+    get uvs(): Float32Array | null;
+    get colors(): Uint32Array | null;
     /** Custom material attached to this mesh, or `null` for the default mesh path. */
-    readonly material: MeshMaterial | null;
+    get material(): MeshMaterial | null;
     /** Source geometry when constructed from the geometry form, otherwise `null`. */
-    readonly geometry: Geometry | null;
+    get geometry(): Geometry | null;
     private _texture;
     constructor(options: MeshOptions);
     /** Number of (x, y) vertex pairs in the mesh (i.e. `vertices.length / 2`). */
@@ -91,4 +97,21 @@ export declare class Mesh extends Drawable {
      */
     recomputeLocalBounds(): this;
 }
+/**
+ * Read a {@link Geometry}'s standard mesh attributes into the flat
+ * `vertices`/`uvs`/`colors` arrays the mesh renderers consume. Only the
+ * `triangle-list` topology and the canonical attribute layout (`f32` position
+ * and texcoord, `u8`/`u32`/`f32` color) are supported — this is the immediate
+ * (non-batched) bridge; shared GPU buffers and instancing arrive later.
+ *
+ * Exported (not barrelled) so the pooled immediate-draw mesh can reuse the exact
+ * same flattening the `Mesh` constructor applies.
+ * @internal
+ */
+export declare function readGeometry(geometry: Geometry): {
+    vertices: Float32Array;
+    uvs: Float32Array | null;
+    colors: Uint32Array | null;
+    indices: Uint16Array | null;
+};
 //# sourceMappingURL=Mesh.d.ts.map

package/dist/esm/rendering/mesh/Mesh.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Mesh.d.ts","sourceRoot":"","sources":["../../../../src/rendering/mesh/Mesh.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAE7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,GAAG,CAAC,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,aAAa,GAAG,IAAI,CAAC;IAClD,+FAA+F;IAC/F,QAAQ,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAC;CAClC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,IAAK,SAAQ,QAAQ;IAChC,SAAgB,QAAQ,EAAE,YAAY,CAAC;IACvC,SAAgB,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;IAC5C,SAAgB,GAAG,EAAE,YAAY,GAAG,IAAI,CAAC;IACzC,SAAgB,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IAE3C,kFAAkF;IAClF,SAAgB,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;IAE9C,iFAAiF;IACjF,SAAgB,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAE1C,OAAO,CAAC,QAAQ,CAAiC;gBAE9B,OAAO,EAAE,WAAW;IA6EvC,8EAA8E;IAC9E,IAAW,WAAW,IAAI,MAAM,CAE/B;IAED,+FAA+F;IAC/F,IAAW,UAAU,IAAI,MAAM,CAE9B;IAED,IAAW,OAAO,IAAI,OAAO,GAAG,aAAa,GAAG,IAAI,CAEnD;IAED,IAAW,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,GAAG,IAAI,EAGzD;IAED;;;;OAIG;IACI,oBAAoB,IAAI,IAAI;CAoBpC"}
+{"version":3,"file":"Mesh.d.ts","sourceRoot":"","sources":["../../../../src/rendering/mesh/Mesh.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAE7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,GAAG,CAAC,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,aAAa,GAAG,IAAI,CAAC;IAClD,+FAA+F;IAC/F,QAAQ,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAC;CAClC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,IAAK,SAAQ,QAAQ;IAIhC,SAAS,CAAC,SAAS,EAAE,YAAY,CAAC;IAClC,SAAS,CAAC,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;IACvC,SAAS,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC;IACpC,SAAS,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;IACtC,SAAS,CAAC,SAAS,EAAE,YAAY,GAAG,IAAI,CAAC;IACzC,SAAS,CAAC,SAAS,EAAE,QAAQ,GAAG,IAAI,CAAC;IAErC,IAAW,QAAQ,IAAI,YAAY,CAElC;IAED,IAAW,OAAO,IAAI,WAAW,GAAG,IAAI,CAEvC;IAED,IAAW,GAAG,IAAI,YAAY,GAAG,IAAI,CAEpC;IAED,IAAW,MAAM,IAAI,WAAW,GAAG,IAAI,CAEtC;IAED,kFAAkF;IAClF,IAAW,QAAQ,IAAI,YAAY,GAAG,IAAI,CAEzC;IAED,iFAAiF;IACjF,IAAW,QAAQ,IAAI,QAAQ,GAAG,IAAI,CAErC;IAED,OAAO,CAAC,QAAQ,CAAiC;gBAE9B,OAAO,EAAE,WAAW;IA8EvC,8EAA8E;IAC9E,IAAW,WAAW,IAAI,MAAM,CAE/B;IAED,+FAA+F;IAC/F,IAAW,UAAU,IAAI,MAAM,CAE9B;IAED,IAAW,OAAO,IAAI,OAAO,GAAG,aAAa,GAAG,IAAI,CAEnD;IAED,IAAW,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,GAAG,IAAI,EAGzD;IAED;;;;OAIG;IACI,oBAAoB,IAAI,IAAI;CAqBpC;AASD;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ,GAAG;IAChD,QAAQ,EAAE,YAAY,CAAC;IACvB,GAAG,EAAE,YAAY,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;CAC7B,CAkDA"}

package/dist/esm/rendering/mesh/Mesh.js

@@ -29,14 +29,35 @@ import { Drawable } from '../Drawable.js';
  * `recomputeLocalBounds()`).
  */
 class Mesh extends Drawable {
-    vertices;
-    indices;
-    uvs;
-    colors;
+    // Backing fields are `protected` so the pooled `ImmediateMesh` subclass can
+    // reconfigure them in place; the public getters keep the data read-only for
+    // every external consumer (the v1 immutable-after-construction contract).
+    _vertices;
+    _indices;
+    _uvs;
+    _colors;
+    _material;
+    _geometry;
+    get vertices() {
+        return this._vertices;
+    }
+    get indices() {
+        return this._indices;
+    }
+    get uvs() {
+        return this._uvs;
+    }
+    get colors() {
+        return this._colors;
+    }
     /** Custom material attached to this mesh, or `null` for the default mesh path. */
-    material;
+    get material() {
+        return this._material;
+    }
     /** Source geometry when constructed from the geometry form, otherwise `null`. */
-    geometry;
+    get geometry() {
+        return this._geometry;
+    }
     _texture;
     constructor(options) {
         super();
@@ -85,6 +106,7 @@ class Mesh extends Drawable {
                 throw new Error(`Mesh indices must be a non-empty multiple of 3 (got length ${indices.length}).`);
             }
             for (let i = 0; i < indices.length; i++) {
+                // In-bounds: `i` < `indices.length`.
                 if (indices[i] >= vertexCount) {
                     throw new Error(`Mesh index ${indices[i]} at position ${i} is out of range for vertex count ${vertexCount}.`);
                 }
@@ -93,12 +115,12 @@ class Mesh extends Drawable {
         else if (vertexCount % 3 !== 0) {
             throw new Error(`Non-indexed Mesh requires a vertex count that is a multiple of 3 (got ${vertexCount}).`);
         }
-        this.vertices = vertices;
-        this.indices = indices;
-        this.uvs = uvs;
-        this.colors = colors;
-        this.material = material;
-        this.geometry = geometry;
+        this._vertices = vertices;
+        this._indices = indices;
+        this._uvs = uvs;
+        this._colors = colors;
+        this._material = material;
+        this._geometry = geometry;
         this._texture = texture;
         this.recomputeLocalBounds();
     }
@@ -128,6 +150,7 @@ class Mesh extends Drawable {
         let maxX = -Infinity;
         let maxY = -Infinity;
         for (let i = 0; i < this.vertices.length; i += 2) {
+            // In-bounds: `vertices.length` is an even (x, y) count (validated on construction).
             const x = this.vertices[i];
             const y = this.vertices[i + 1];
             if (x < minX)
@@ -154,6 +177,10 @@ const findAttribute = (attributes, names) => attributes.find(attribute => names.
  * `triangle-list` topology and the canonical attribute layout (`f32` position
  * and texcoord, `u8`/`u32`/`f32` color) are supported — this is the immediate
  * (non-batched) bridge; shared GPU buffers and instancing arrive later.
+ *
+ * Exported (not barrelled) so the pooled immediate-draw mesh can reuse the exact
+ * same flattening the `Mesh` constructor applies.
+ * @internal
  */
 function readGeometry(geometry) {
     if (geometry.topology !== 'triangle-list') {
@@ -234,5 +261,5 @@ function clamp01(value) {
     return value;
 }
 
-export { Mesh };
+export { Mesh, readGeometry };
 //# sourceMappingURL=Mesh.js.map

package/dist/esm/rendering/mesh/Mesh.js.map

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

package/dist/esm/rendering/pixelSnap.js

@@ -0,0 +1,187 @@
+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++) {
+        // In-bounds: i < source.length.
+        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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"}