@codexo/exojs 0.12.0 → 0.13.0

package/dist/esm/rendering/sprite/NineSliceSprite.js

@@ -0,0 +1,207 @@
+import { Drawable } from '../Drawable.js';
+import { buildPixelSnapContext, snapQuadsInto } from '../pixelSnap.js';
+import { TextureRegion } from '../texture/TextureRegion.js';
+import { normalizeInsets, validateSlices, validateBorder, normalizeModes, equalInsets, equalModes, buildNineSliceQuads } from './nineSlice.js';
+
+function validateSizeInput(width, height) {
+    if (!Number.isFinite(width) || !Number.isFinite(height)) {
+        throw new Error(`NineSliceSprite: width and height must be finite numbers (got ${width}, ${height}).`);
+    }
+    if (width < 0) {
+        throw new Error(`NineSliceSprite: width must be non-negative (got ${width}).`);
+    }
+    if (height < 0) {
+        throw new Error(`NineSliceSprite: height must be non-negative (got ${height}).`);
+    }
+}
+/**
+ * A scalable nine-slice (9-patch) sprite.
+ * Corners stay pixel-perfect; edges/center fill by stretch, repeat, or mirror-repeat.
+ * @stable
+ */
+class NineSliceSprite extends Drawable {
+    _region;
+    _slices;
+    _border;
+    _width;
+    _height;
+    _modes;
+    _quads = [];
+    _geometryDirty = true;
+    _renderQuads = [];
+    constructor(texture, options) {
+        super();
+        this._region = texture instanceof TextureRegion
+            ? texture
+            : new TextureRegion(texture, {
+                x: 0,
+                y: 0,
+                width: texture.width,
+                height: texture.height,
+            });
+        const region = this._region;
+        // Validate and own slices
+        const rawSlices = normalizeInsets(options.slices);
+        validateSlices(rawSlices, region.width, region.height);
+        this._slices = rawSlices;
+        // Validate and own border
+        const rawBorder = options.border !== undefined
+            ? normalizeInsets(options.border)
+            : normalizeInsets(options.slices);
+        validateBorder(rawBorder);
+        this._border = rawBorder;
+        // Validate and own size
+        const width = options.width ?? region.width;
+        const height = options.height ?? region.height;
+        validateSizeInput(width, height);
+        this._width = width;
+        this._height = height;
+        // Copy and freeze modes
+        this._modes = normalizeModes(options.modes);
+    }
+    // -----------------------------------------------------------------------
+    // Public read-only accessors (engine-owned, frozen)
+    // -----------------------------------------------------------------------
+    /** The TextureRegion this nine-slice samples from. */
+    get region() {
+        return this._region;
+    }
+    /** Convenience accessor: the texture underlying the region. */
+    get texture() {
+        return this._region.texture;
+    }
+    /** The engine-owned, frozen source slice insets. */
+    get slices() {
+        return this._slices;
+    }
+    /** The engine-owned, frozen destination border insets. */
+    get border() {
+        return this._border;
+    }
+    /** The engine-owned, frozen edge/center fill modes. */
+    get modes() {
+        return this._modes;
+    }
+    // -----------------------------------------------------------------------
+    // Width / Height (with atomic validation)
+    // -----------------------------------------------------------------------
+    /** Destination width in local units. */
+    get width() {
+        return this._width;
+    }
+    set width(value) {
+        this.setSize(value, this._height);
+    }
+    /** Destination height in local units. */
+    get height() {
+        return this._height;
+    }
+    set height(value) {
+        this.setSize(this._width, value);
+    }
+    // -----------------------------------------------------------------------
+    // Mutators
+    // -----------------------------------------------------------------------
+    /** Set destination size. Fails atomically — prior state is preserved on invalid input. */
+    setSize(width, height) {
+        validateSizeInput(width, height);
+        if (this._width !== width || this._height !== height) {
+            this._width = width;
+            this._height = height;
+            this._geometryDirty = true;
+            this.invalidateCache();
+        }
+        return this;
+    }
+    /** Update the SOURCE-space slice insets. Fails atomically. No-ops on equivalent values. */
+    setSlices(slices) {
+        const region = this._region;
+        const normalized = normalizeInsets(slices);
+        validateSlices(normalized, region.width, region.height);
+        if (equalInsets(normalized, this._slices)) {
+            return this;
+        }
+        this._slices = normalized;
+        this._geometryDirty = true;
+        this.invalidateCache();
+        return this;
+    }
+    /** Update the DESTINATION border sizes. Fails atomically. No-ops on equivalent values. */
+    setBorder(border) {
+        const normalized = normalizeInsets(border);
+        validateBorder(normalized);
+        if (equalInsets(normalized, this._border)) {
+            return this;
+        }
+        this._border = normalized;
+        this._geometryDirty = true;
+        this.invalidateCache();
+        return this;
+    }
+    /** Update the edge/center fill modes. Input is copied, validated, and frozen. No-ops on equivalent values. */
+    setModes(modes) {
+        const normalized = normalizeModes(modes);
+        if (equalModes(normalized, this._modes)) {
+            return this;
+        }
+        this._modes = normalized;
+        this._geometryDirty = true;
+        this.invalidateCache();
+        return this;
+    }
+    // -----------------------------------------------------------------------
+    // Bounds
+    // -----------------------------------------------------------------------
+    getLocalBounds() {
+        const bounds = super.getLocalBounds();
+        bounds.set(0, 0, this._width, this._height);
+        return bounds;
+    }
+    // -----------------------------------------------------------------------
+    // Internal geometry (for renderers)
+    // -----------------------------------------------------------------------
+    /**
+     * Lazily-built geometry quads. Each quad describes one rendered sub-region
+     * in local space with its corresponding UV bounds.
+     * @internal
+     */
+    get quads() {
+        if (this._geometryDirty) {
+            this._rebuildGeometry();
+        }
+        return this._quads;
+    }
+    /**
+     * 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, targetPxWidth, targetPxHeight) {
+        const base = this.quads;
+        if (base.length === 0) {
+            return base;
+        }
+        const ctx = buildPixelSnapContext(this.getGlobalTransform(), view, targetPxWidth, targetPxHeight);
+        if (!ctx.axisAligned) {
+            return base;
+        }
+        return snapQuadsInto(base, ctx, this._renderQuads);
+    }
+    // -----------------------------------------------------------------------
+    // Private helpers
+    // -----------------------------------------------------------------------
+    _rebuildGeometry() {
+        this._quads = buildNineSliceQuads(this._region, this._slices, this._border, this._width, this._height, this._modes);
+        this._geometryDirty = false;
+    }
+}
+
+export { NineSliceSprite };
+//# sourceMappingURL=NineSliceSprite.js.map

package/dist/esm/rendering/sprite/NineSliceSprite.js.map

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

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

@@ -0,0 +1,120 @@
+import type { Rectangle } from '#math/Rectangle';
+import { Drawable } from '#rendering/Drawable';
+import type { RepeatFit, RepeatMode } from '#rendering/texture/repeat';
+import type { Texture } from '#rendering/texture/Texture';
+import { TextureRegion } from '#rendering/texture/TextureRegion';
+import type { View } from '#rendering/View';
+import type { RepeatingSpriteOptions, RepeatingSpriteQuad } from './repeatingSpritePlan';
+/**
+ * A sprite that fills its destination by repeating, mirroring, or stretching
+ * a source texture or atlas region.
+ *
+ * Supports independent per-axis modes (`modeX`, `modeY`) and fit strategies
+ * (`fitX`, `fitY`).
+ *
+ * ## Internal rendering strategy (selected automatically)
+ *
+ * | Source type       | Internal path                                         |
+ * |-------------------|-------------------------------------------------------|
+ * | Bare `Texture`    | **Shader path** — one quad, GPU sampler repeat wrap.  |
+ * | `TextureRegion`   | **Geometry path** — Cartesian-product quads, clamped. |
+ *
+ * The public class identity and API do not change based on which path the
+ * renderer uses.
+ *
+ * @stable
+ */
+export declare class RepeatingSprite extends Drawable {
+    private readonly _source;
+    private readonly _region;
+    private _width;
+    private _height;
+    private _modeX;
+    private _modeY;
+    private _fitX;
+    private _fitY;
+    private _offsetX;
+    private _offsetY;
+    private _quads;
+    private _geometryDirty;
+    private readonly _renderQuads;
+    constructor(source: Texture | TextureRegion, options?: RepeatingSpriteOptions);
+    /** The original source passed to the constructor. */
+    get source(): Texture | TextureRegion;
+    /** TextureRegion wrapping the source (bare Texture sources auto-wrapped). */
+    get region(): TextureRegion;
+    /** Convenience accessor: the underlying Texture. */
+    get texture(): Texture;
+    /** Destination width in local units. */
+    get width(): number;
+    set width(value: number);
+    /** Destination height in local units. */
+    get height(): number;
+    set height(value: number);
+    /** Horizontal repeat mode. */
+    get modeX(): RepeatMode;
+    set modeX(value: RepeatMode);
+    /** Vertical repeat mode. */
+    get modeY(): RepeatMode;
+    set modeY(value: RepeatMode);
+    /** Horizontal fit mode (how partial repeats are resolved). */
+    get fitX(): RepeatFit;
+    set fitX(value: RepeatFit);
+    /** Vertical fit mode (how partial repeats are resolved). */
+    get fitY(): RepeatFit;
+    set fitY(value: RepeatFit);
+    /**
+     * Horizontal scroll offset in source-pixel units.
+     *
+     * On the shader path (bare `Texture` source), changing the offset does
+     * **not** trigger a geometry rebuild — the value is forwarded as
+     * per-instance data at render time.  On the geometry path
+     * (`TextureRegion` source), offset changes mark quads dirty.
+     */
+    get offsetX(): number;
+    set offsetX(value: number);
+    /** Vertical scroll offset in source-pixel units.  See {@link offsetX}. */
+    get offsetY(): number;
+    set offsetY(value: number);
+    /** Set destination size atomically. Preserves prior state on invalid input. */
+    setSize(width: number, height: number): this;
+    /**
+     * Set scroll offset atomically in source-pixel units.
+     * On the shader path this does not rebuild geometry.
+     * On the geometry path this marks geometry dirty.
+     */
+    setOffset(offsetX: number, offsetY: number): this;
+    getLocalBounds(): Rectangle;
+    /**
+     * Rendering strategy determined by the source type:
+     * - `'shader'` — bare `Texture`; renderer uses GPU sampler wrap.
+     * - `'geometry'` — `TextureRegion`; renderer builds repeat quads.
+     * @internal
+     */
+    get resolvedStrategy(): 'shader' | 'geometry';
+    /**
+     * Lazily-built geometry quads for the geometry path.
+     * Returns an empty array on the shader path.
+     * @internal
+     */
+    get quads(): readonly RepeatingSpriteQuad[];
+    /**
+     * Render-time quads for the **geometry strategy**, device-pixel-snapped in
+     * `'geometry'` pixel-snap mode (axis-aligned only). Like NineSlice, every
+     * shared repeat-segment boundary is snapped once by {@link snapQuadsInto}, so
+     * adjacent segments stay gap-free; the content cache ({@link quads}) is never
+     * rebuilt by snapping. Returns the unsnapped quads otherwise.
+     * @internal
+     */
+    getRenderQuads(view: View, targetPxWidth: number, targetPxHeight: number): readonly RepeatingSpriteQuad[];
+    /**
+     * Render-time destination bounds for the **shader strategy**, written into
+     * `out`. In `'geometry'` pixel-snap mode (axis-aligned only) the destination
+     * quad edges are snapped to the device grid; repetition stays shader-based, so
+     * only the outer rectangle moves. Returns the logical local bounds otherwise.
+     * @internal
+     */
+    getRenderBounds(view: View, targetPxWidth: number, targetPxHeight: number, out: Rectangle): Rectangle;
+    private _rebuildGeometry;
+}
+//# sourceMappingURL=RepeatingSprite.d.ts.map

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

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

package/dist/esm/rendering/sprite/RepeatingSprite.js

@@ -0,0 +1,279 @@
+import { Drawable } from '../Drawable.js';
+import { buildPixelSnapContext, snapQuadsInto, snapBoundsInto } from '../pixelSnap.js';
+import { TextureRegion } from '../texture/TextureRegion.js';
+import { validateMode, validateFit, validateOffset, validateSizeInput, buildRepeatingSpriteQuads } from './repeatingSpritePlan.js';
+
+/**
+ * A sprite that fills its destination by repeating, mirroring, or stretching
+ * a source texture or atlas region.
+ *
+ * Supports independent per-axis modes (`modeX`, `modeY`) and fit strategies
+ * (`fitX`, `fitY`).
+ *
+ * ## Internal rendering strategy (selected automatically)
+ *
+ * | Source type       | Internal path                                         |
+ * |-------------------|-------------------------------------------------------|
+ * | Bare `Texture`    | **Shader path** — one quad, GPU sampler repeat wrap.  |
+ * | `TextureRegion`   | **Geometry path** — Cartesian-product quads, clamped. |
+ *
+ * The public class identity and API do not change based on which path the
+ * renderer uses.
+ *
+ * @stable
+ */
+class RepeatingSprite extends Drawable {
+    _source;
+    _region;
+    _width;
+    _height;
+    _modeX;
+    _modeY;
+    _fitX;
+    _fitY;
+    _offsetX;
+    _offsetY;
+    _quads = [];
+    _geometryDirty = true;
+    _renderQuads = [];
+    constructor(source, options) {
+        super();
+        this._source = source;
+        this._region = source instanceof TextureRegion
+            ? source
+            : new TextureRegion(source, { x: 0, y: 0, width: source.width, height: source.height });
+        const region = this._region;
+        const opts = options ?? {};
+        const modeX = opts.modeX ?? 'repeat';
+        const modeY = opts.modeY ?? 'repeat';
+        validateMode(modeX, 'modeX');
+        validateMode(modeY, 'modeY');
+        this._modeX = modeX;
+        this._modeY = modeY;
+        const fitX = opts.fitX ?? 'round';
+        const fitY = opts.fitY ?? 'round';
+        validateFit(fitX, 'fitX');
+        validateFit(fitY, 'fitY');
+        this._fitX = fitX;
+        this._fitY = fitY;
+        const offsetX = opts.offsetX ?? 0;
+        const offsetY = opts.offsetY ?? 0;
+        validateOffset(offsetX, 'offsetX');
+        validateOffset(offsetY, 'offsetY');
+        this._offsetX = offsetX;
+        this._offsetY = offsetY;
+        const width = opts.width ?? region.width;
+        const height = opts.height ?? region.height;
+        validateSizeInput(width, height);
+        this._width = width;
+        this._height = height;
+    }
+    // -----------------------------------------------------------------------
+    // Accessors
+    // -----------------------------------------------------------------------
+    /** The original source passed to the constructor. */
+    get source() {
+        return this._source;
+    }
+    /** TextureRegion wrapping the source (bare Texture sources auto-wrapped). */
+    get region() {
+        return this._region;
+    }
+    /** Convenience accessor: the underlying Texture. */
+    get texture() {
+        return this._region.texture;
+    }
+    /** Destination width in local units. */
+    get width() {
+        return this._width;
+    }
+    set width(value) {
+        this.setSize(value, this._height);
+    }
+    /** Destination height in local units. */
+    get height() {
+        return this._height;
+    }
+    set height(value) {
+        this.setSize(this._width, value);
+    }
+    /** Horizontal repeat mode. */
+    get modeX() {
+        return this._modeX;
+    }
+    set modeX(value) {
+        validateMode(value, 'modeX');
+        if (this._modeX !== value) {
+            this._modeX = value;
+            this._geometryDirty = true;
+            this.invalidateCache();
+        }
+    }
+    /** Vertical repeat mode. */
+    get modeY() {
+        return this._modeY;
+    }
+    set modeY(value) {
+        validateMode(value, 'modeY');
+        if (this._modeY !== value) {
+            this._modeY = value;
+            this._geometryDirty = true;
+            this.invalidateCache();
+        }
+    }
+    /** Horizontal fit mode (how partial repeats are resolved). */
+    get fitX() {
+        return this._fitX;
+    }
+    set fitX(value) {
+        validateFit(value, 'fitX');
+        if (this._fitX !== value) {
+            this._fitX = value;
+            this._geometryDirty = true;
+            this.invalidateCache();
+        }
+    }
+    /** Vertical fit mode (how partial repeats are resolved). */
+    get fitY() {
+        return this._fitY;
+    }
+    set fitY(value) {
+        validateFit(value, 'fitY');
+        if (this._fitY !== value) {
+            this._fitY = value;
+            this._geometryDirty = true;
+            this.invalidateCache();
+        }
+    }
+    /**
+     * Horizontal scroll offset in source-pixel units.
+     *
+     * On the shader path (bare `Texture` source), changing the offset does
+     * **not** trigger a geometry rebuild — the value is forwarded as
+     * per-instance data at render time.  On the geometry path
+     * (`TextureRegion` source), offset changes mark quads dirty.
+     */
+    get offsetX() {
+        return this._offsetX;
+    }
+    set offsetX(value) {
+        this.setOffset(value, this._offsetY);
+    }
+    /** Vertical scroll offset in source-pixel units.  See {@link offsetX}. */
+    get offsetY() {
+        return this._offsetY;
+    }
+    set offsetY(value) {
+        this.setOffset(this._offsetX, value);
+    }
+    // -----------------------------------------------------------------------
+    // Fluent mutators
+    // -----------------------------------------------------------------------
+    /** Set destination size atomically. Preserves prior state on invalid input. */
+    setSize(width, height) {
+        validateSizeInput(width, height);
+        if (this._width !== width || this._height !== height) {
+            this._width = width;
+            this._height = height;
+            this._geometryDirty = true;
+            this.invalidateCache();
+        }
+        return this;
+    }
+    /**
+     * Set scroll offset atomically in source-pixel units.
+     * On the shader path this does not rebuild geometry.
+     * On the geometry path this marks geometry dirty.
+     */
+    setOffset(offsetX, offsetY) {
+        validateOffset(offsetX, 'offsetX');
+        validateOffset(offsetY, 'offsetY');
+        if (this._offsetX !== offsetX || this._offsetY !== offsetY) {
+            this._offsetX = offsetX;
+            this._offsetY = offsetY;
+            if (this.resolvedStrategy === 'geometry') {
+                this._geometryDirty = true;
+            }
+            this.invalidateCache();
+        }
+        return this;
+    }
+    // -----------------------------------------------------------------------
+    // Bounds
+    // -----------------------------------------------------------------------
+    getLocalBounds() {
+        const bounds = super.getLocalBounds();
+        bounds.set(0, 0, this._width, this._height);
+        return bounds;
+    }
+    // -----------------------------------------------------------------------
+    // Internal renderer interface
+    // -----------------------------------------------------------------------
+    /**
+     * Rendering strategy determined by the source type:
+     * - `'shader'` — bare `Texture`; renderer uses GPU sampler wrap.
+     * - `'geometry'` — `TextureRegion`; renderer builds repeat quads.
+     * @internal
+     */
+    get resolvedStrategy() {
+        return this._source instanceof TextureRegion ? 'geometry' : 'shader';
+    }
+    /**
+     * Lazily-built geometry quads for the geometry path.
+     * Returns an empty array on the shader path.
+     * @internal
+     */
+    get quads() {
+        if (this.resolvedStrategy === 'geometry' && this._geometryDirty) {
+            this._rebuildGeometry();
+        }
+        return this._quads;
+    }
+    /**
+     * Render-time quads for the **geometry strategy**, device-pixel-snapped in
+     * `'geometry'` pixel-snap mode (axis-aligned only). Like NineSlice, every
+     * shared repeat-segment boundary is snapped once by {@link snapQuadsInto}, so
+     * adjacent segments stay gap-free; the content cache ({@link quads}) is never
+     * rebuilt by snapping. Returns the unsnapped quads otherwise.
+     * @internal
+     */
+    getRenderQuads(view, targetPxWidth, targetPxHeight) {
+        const base = this.quads;
+        if (this.pixelSnapMode !== 'geometry' || base.length === 0) {
+            return base;
+        }
+        const ctx = buildPixelSnapContext(this.getGlobalTransform(), view, targetPxWidth, targetPxHeight);
+        if (!ctx.axisAligned) {
+            return base;
+        }
+        return snapQuadsInto(base, ctx, this._renderQuads);
+    }
+    /**
+     * Render-time destination bounds for the **shader strategy**, written into
+     * `out`. In `'geometry'` pixel-snap mode (axis-aligned only) the destination
+     * quad edges are snapped to the device grid; repetition stays shader-based, so
+     * only the outer rectangle moves. Returns the logical local bounds otherwise.
+     * @internal
+     */
+    getRenderBounds(view, targetPxWidth, targetPxHeight, out) {
+        const base = this.getLocalBounds();
+        if (this.pixelSnapMode !== 'geometry') {
+            return base;
+        }
+        const ctx = buildPixelSnapContext(this.getGlobalTransform(), view, targetPxWidth, targetPxHeight);
+        if (!ctx.axisAligned) {
+            return base;
+        }
+        return snapBoundsInto(base, ctx, out);
+    }
+    // -----------------------------------------------------------------------
+    // Private helpers
+    // -----------------------------------------------------------------------
+    _rebuildGeometry() {
+        this._quads = buildRepeatingSpriteQuads(this._region, this._width, this._height, this._modeX, this._modeY, this._fitX, this._fitY, this._offsetX, this._offsetY);
+        this._geometryDirty = false;
+    }
+}
+
+export { RepeatingSprite };
+//# sourceMappingURL=RepeatingSprite.js.map

package/dist/esm/rendering/sprite/RepeatingSprite.js.map

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

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

@@ -5,6 +5,7 @@ import { Drawable } from '#rendering/Drawable';
 import type { SpriteMaterial } from '#rendering/material/SpriteMaterial';
 import type { RenderTexture } from '#rendering/texture/RenderTexture';
 import type { Texture } from '#rendering/texture/Texture';
+import type { View } from '#rendering/View';
 /**
  * Internal dirty-flag bitmask used by {@link Sprite} to lazily recompute
  * derived data (vertices, normals, texture coordinates, bounding boxes).
@@ -72,6 +73,18 @@ export declare class Sprite extends Drawable {
      * (TL, TR, BR, BL). Cached until the transform is invalidated.
      */
     get vertices(): Float32Array;
+    /**
+     * Local-space quad bounds for the active pass, written into `out`. In
+     * `'geometry'` pixel-snap mode (and only when the combined node+view transform
+     * is axis-aligned) the quad edges are snapped to the render target's
+     * device-pixel grid via the shared {@link snapLocalBoundary} helper — combined
+     * with the device-snapped origin from the transform seam, all four corners
+     * land on whole device pixels. The logical local bounds (used by collision /
+     * `getBounds`) are never changed. Returns the unsnapped local bounds for
+     * `'none'`/`'position'` or under a rotation/skew downgrade.
+     * @internal
+     */
+    getRenderBounds(view: View, targetPxWidth: number, targetPxHeight: number, out: Rectangle): Rectangle;
     /**
      * Packed UV coordinates for the four quad corners, encoded as two
      * 16-bit fixed-point values per element (low 16 bits = U, high 16 bits = V,

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

@@ -1 +1 @@
-{"version":3,"file":"Sprite.d.ts","sourceRoot":"","sources":["../../../../src/rendering/sprite/Sprite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAE1D;;;;GAIG;AACH,oBAAY,WAAW;IACrB,IAAI,IAAO;IACX,WAAW,IAAO;IAClB,QAAQ,IAAO;IACf,OAAO,IAAO;IACd,MAAM,IAAO;IACb,SAAS,KAAO;IAChB,gBAAgB,KAAO;IACvB,WAAW,KAAO;IAClB,aAAa,KAAO;IACpB,UAAU,MAAO;IACjB,QAAQ,OAAQ;IAChB,OAAO,OAAQ;CAChB;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,MAAO,SAAQ,QAAQ;IAClC,OAAO,CAAC,QAAQ,CAAwC;IACxD,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,SAAS,CAAqC;IACtD,OAAO,CAAC,UAAU,CAAmC;IACrD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA8F;gBAEpG,OAAO,EAAE,OAAO,GAAG,aAAa,GAAG,IAAI;IAW1D,IAAW,OAAO,IAAI,OAAO,GAAG,aAAa,GAAG,IAAI,CAEnD;IAED,IAAW,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,GAAG,IAAI,EAEzD;IAED,IAAW,YAAY,IAAI,SAAS,CAEnC;IAED,IAAW,YAAY,CAAC,KAAK,EAAE,SAAS,EAEvC;IAED;;;;;;;OAOG;IACH,IAAW,QAAQ,IAAI,cAAc,GAAG,IAAI,CAE3C;IAED,IAAW,QAAQ,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,EAOlD;IAED,IAAW,KAAK,IAAI,MAAM,CAEzB;IAED,IAAW,KAAK,CAAC,KAAK,EAAE,MAAM,EAE7B;IAED,IAAW,MAAM,IAAI,MAAM,CAE1B;IAED,IAAW,MAAM,CAAC,KAAK,EAAE,MAAM,EAE9B;IAED;;;;OAIG;IACH,IAAW,QAAQ,IAAI,YAAY,CAqBlC;IAED;;;;;OAKG;IACH,IAAW,SAAS,IAAI,WAAW,CA2BlC;IAED;;;;;;;;;OASG;IACI,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,GAAG,IAAI,GAAG,IAAI;IAchE,oHAAoH;IAC7G,aAAa,IAAI,IAAI;IAU5B;;;;;;OAMG;IACI,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,UAAO,GAAG,IAAI;IAsBhE,0GAA0G;IACnG,iBAAiB,IAAI,IAAI;IAQhC;;;OAGG;IACa,UAAU,IAAI,MAAM,EAAE;IA2BtC;;;OAGG;IACa,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,QAAyB,GAAG,QAAQ;IAUlF;;;;OAIG;IACa,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO;IAmBvD,gBAAgB;IACA,2BAA2B,IAAI,IAAI;IAKnD,gBAAgB;IACA,wBAAwB,IAAI,IAAI;IAKhC,OAAO,IAAI,IAAI;CAWhC"}
+{"version":3,"file":"Sprite.d.ts","sourceRoot":"","sources":["../../../../src/rendering/sprite/Sprite.ts"],"names":[],"mappings":"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"}