@codexo/exojs-tilemap 0.14.0 → 0.15.1

package/dist/esm/ImageLayer.d.ts

@@ -0,0 +1,81 @@
+import type { Texture } from '@codexo/exojs';
+import type { TileProperties } from './types';
+/** Construction options for an {@link ImageLayer}. */
+export interface ImageLayerOptions {
+    /** Layer id (unique within the map). */
+    readonly id: number;
+    /** Layer name. */
+    readonly name?: string;
+    /** Layer class string. */
+    readonly class?: string;
+    /** Resolved image URL. */
+    readonly image: string;
+    /** Loaded texture for the image, or `null` if unavailable. */
+    readonly texture?: Texture | null;
+    /** Whether the layer is visible. Default `true`. */
+    readonly visible?: boolean;
+    /** Layer opacity in `[0, 1]`. Default `1`. */
+    readonly opacity?: number;
+    /** Layer pixel offset X. Default `0`. */
+    readonly offsetX?: number;
+    /** Layer pixel offset Y. Default `0`. */
+    readonly offsetY?: number;
+    /** Horizontal parallax factor. Default `1`. */
+    readonly parallaxX?: number;
+    /** Vertical parallax factor. Default `1`. */
+    readonly parallaxY?: number;
+    /** Tint colour as `0xRRGGBB`, or `null`. Default `null`. */
+    readonly tintColor?: number | null;
+    /** Whether the image repeats horizontally. Default `false`. */
+    readonly repeatX?: boolean;
+    /** Whether the image repeats vertically. Default `false`. */
+    readonly repeatY?: boolean;
+    /** Layer properties (copied and frozen). */
+    readonly properties?: TileProperties;
+}
+/**
+ * A data-only image layer: a single image (texture + resolved URL) placed as a
+ * background or foreground layer. Image layers are not rendered by the tile
+ * renderer — they are exposed as data for a renderer or follow-up scene node to
+ * consume.
+ *
+ * Parallax, opacity, tint, offset, and repeat flags are carried from the
+ * source Tiled map.
+ *
+ * @advanced
+ */
+export declare class ImageLayer {
+    /** Layer-kind discriminant. */
+    readonly kind: "image";
+    /** Layer id (unique within the map). */
+    readonly id: number;
+    /** Layer name. */
+    readonly name: string;
+    /** Layer class string. */
+    readonly class: string;
+    /** Resolved URL of the layer image. */
+    readonly image: string;
+    /** Loaded texture for the image, or `null` if unavailable. */
+    readonly texture: Texture | null;
+    /** Whether the layer is visible. */
+    readonly visible: boolean;
+    /** Layer opacity in `[0, 1]`. */
+    readonly opacity: number;
+    /** Layer pixel offset X. */
+    readonly offsetX: number;
+    /** Layer pixel offset Y. */
+    readonly offsetY: number;
+    /** Horizontal parallax factor. */
+    readonly parallaxX: number;
+    /** Vertical parallax factor. */
+    readonly parallaxY: number;
+    /** Tint colour as `0xRRGGBB`, or `null`. */
+    readonly tintColor: number | null;
+    /** Whether the image repeats horizontally. */
+    readonly repeatX: boolean;
+    /** Whether the image repeats vertically. */
+    readonly repeatY: boolean;
+    /** Immutable layer properties. */
+    readonly properties: TileProperties;
+    constructor(options: ImageLayerOptions);
+}

package/dist/esm/ImageLayer.js

@@ -0,0 +1,67 @@
+/**
+ * A data-only image layer: a single image (texture + resolved URL) placed as a
+ * background or foreground layer. Image layers are not rendered by the tile
+ * renderer — they are exposed as data for a renderer or follow-up scene node to
+ * consume.
+ *
+ * Parallax, opacity, tint, offset, and repeat flags are carried from the
+ * source Tiled map.
+ *
+ * @advanced
+ */
+class ImageLayer {
+    /** Layer-kind discriminant. */
+    kind = 'image';
+    /** Layer id (unique within the map). */
+    id;
+    /** Layer name. */
+    name;
+    /** Layer class string. */
+    class;
+    /** Resolved URL of the layer image. */
+    image;
+    /** Loaded texture for the image, or `null` if unavailable. */
+    texture;
+    /** Whether the layer is visible. */
+    visible;
+    /** Layer opacity in `[0, 1]`. */
+    opacity;
+    /** Layer pixel offset X. */
+    offsetX;
+    /** Layer pixel offset Y. */
+    offsetY;
+    /** Horizontal parallax factor. */
+    parallaxX;
+    /** Vertical parallax factor. */
+    parallaxY;
+    /** Tint colour as `0xRRGGBB`, or `null`. */
+    tintColor;
+    /** Whether the image repeats horizontally. */
+    repeatX;
+    /** Whether the image repeats vertically. */
+    repeatY;
+    /** Immutable layer properties. */
+    properties;
+    constructor(options) {
+        this.id = options.id;
+        this.name = options.name ?? '';
+        this.class = options.class ?? '';
+        this.image = options.image;
+        this.texture = options.texture ?? null;
+        this.visible = options.visible ?? true;
+        this.opacity = options.opacity ?? 1;
+        this.offsetX = options.offsetX ?? 0;
+        this.offsetY = options.offsetY ?? 0;
+        this.parallaxX = options.parallaxX ?? 1;
+        this.parallaxY = options.parallaxY ?? 1;
+        this.tintColor = options.tintColor ?? null;
+        this.repeatX = options.repeatX ?? false;
+        this.repeatY = options.repeatY ?? false;
+        this.properties = options.properties
+            ? Object.freeze({ ...options.properties })
+            : Object.freeze({});
+    }
+}
+
+export { ImageLayer };
+//# sourceMappingURL=ImageLayer.js.map

package/dist/esm/ImageLayer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImageLayer.js","sources":["../../../src/ImageLayer.ts"],"sourcesContent":[null],"names":[],"mappings":"AAsCA;;;;;;;;;;AAUG;MACU,UAAU,CAAA;;IAEL,IAAI,GAAG,OAAgB;;AAGvB,IAAA,EAAE;;AAEF,IAAA,IAAI;;AAEJ,IAAA,KAAK;;AAEL,IAAA,KAAK;;AAEL,IAAA,OAAO;;AAEP,IAAA,OAAO;;AAEP,IAAA,OAAO;;AAEP,IAAA,OAAO;;AAEP,IAAA,OAAO;;AAEP,IAAA,SAAS;;AAET,IAAA,SAAS;;AAET,IAAA,SAAS;;AAET,IAAA,OAAO;;AAEP,IAAA,OAAO;;AAEP,IAAA,UAAU;AAE1B,IAAA,WAAA,CAAmB,OAA0B,EAAA;AAC3C,QAAA,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,EAAE;QACpB,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,EAAE;QAC9B,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,EAAE;AAChC,QAAA,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK;QAC1B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,IAAI;QACtC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,IAAI;QACtC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC;QACnC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC;QACnC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC;QACnC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,CAAC;QACvC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,CAAC;QACvC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,IAAI;QAC1C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,KAAK;QACvC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,KAAK;AACvC,QAAA,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC;cACtB,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE;AACzC,cAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;IACvB;AACD;;;;"}

package/dist/esm/ObjectLayer.d.ts

@@ -16,6 +16,7 @@ export declare const ObjectKind: {
     readonly Polyline: "polyline";
     readonly Point: "point";
     readonly Tile: "tile";
+    readonly Text: "text";
 };
 /** Geometry discriminant for a {@link TileMapObject}. */
 export type ObjectKind = (typeof ObjectKind)[keyof typeof ObjectKind];
@@ -80,10 +81,40 @@ export interface TileObject<P extends TileProperties = TileProperties> extends T
     readonly kind: typeof ObjectKind.Tile;
     readonly tile: ResolvedTile;
 }
+/** Text styling options carried by a {@link TextObject}. */
+export interface TextStyle {
+    /** The text content. */
+    readonly text: string;
+    /** Text colour as 0xRRGGBB, or `null` if default. */
+    readonly color?: number | null;
+    /** Font family name. */
+    readonly fontFamily?: string;
+    /** Font size in pixels. */
+    readonly pixelSize?: number;
+    /** Bold text. */
+    readonly bold?: boolean;
+    /** Italic text. */
+    readonly italic?: boolean;
+    /** Underline text. */
+    readonly underline?: boolean;
+    /** Strikeout text. */
+    readonly strikeout?: boolean;
+    /** Wrap text within the object bounds. */
+    readonly wrap?: boolean;
+    /** Horizontal alignment. */
+    readonly halign?: 'left' | 'center' | 'right' | 'justify';
+    /** Vertical alignment. */
+    readonly valign?: 'top' | 'center' | 'bottom';
+}
+/** A text object carrying styled text content within `[x, y, width, height]`. */
+export interface TextObject<P extends TileProperties = TileProperties> extends TileMapObjectBase<P> {
+    readonly kind: typeof ObjectKind.Text;
+    readonly text: TextStyle;
+}
 /**
  * A format-independent map object. The geometry kind is the discriminant;
- * narrow on `kind` to read shape-specific fields. Text objects and templates
- * are intentionally not represented (data-only release).
+ * narrow on `kind` to read shape-specific fields. Template objects are not
+ * yet represented.
  *
  * The optional property-shape parameter `P` lets typed accessors
  * (see {@link ObjectLayer.byType}) narrow `properties` to a developer-declared
@@ -91,7 +122,7 @@ export interface TileObject<P extends TileProperties = TileProperties> extends T
  * `TileMapObject` form is unchanged.
  * @advanced
  */
-export type TileMapObject<P extends TileProperties = TileProperties> = RectangleObject<P> | EllipseObject<P> | PointObject<P> | PolygonObject<P> | PolylineObject<P> | TileObject<P>;
+export type TileMapObject<P extends TileProperties = TileProperties> = RectangleObject<P> | EllipseObject<P> | PointObject<P> | PolygonObject<P> | PolylineObject<P> | TileObject<P> | TextObject<P>;
 /**
  * A developer-declared mapping from object `type`/class strings to the property
  * shape an object of that type is expected to carry. Supplied as the type
@@ -154,6 +185,12 @@ export interface ObjectLayerOptions {
     readonly offsetX?: number;
     /** Layer pixel offset Y. Default `0`. */
     readonly offsetY?: number;
+    /**
+     * Draw order for the objects (Tiled `draworder`): `'topdown'` (sorted by `y`)
+     * or `'index'` (source order). Informational; objects are stored as given.
+     * Default `'topdown'`.
+     */
+    readonly drawOrder?: 'topdown' | 'index';
     /** The objects in this layer. */
     readonly objects?: readonly TileMapObject[];
     /** Layer-level properties (copied and frozen). */
@@ -199,6 +236,8 @@ export declare class ObjectLayer<S extends ObjectSchema = ObjectSchema> {
     readonly offsetX: number;
     /** Layer pixel offset Y. */
     readonly offsetY: number;
+    /** Draw order for the objects (Tiled `draworder`). Informational. */
+    readonly drawOrder: 'topdown' | 'index';
     /** Immutable layer-level properties. */
     readonly properties: TileProperties;
     /** The objects in this layer (insertion order). */

package/dist/esm/ObjectLayer.js

@@ -1,3 +1,5 @@
+import { TilePropertyKind } from './types.js';
+
 /**
  * Geometry kinds for a {@link TileMapObject}, as an `as const` value object.
  *
@@ -15,7 +17,38 @@ const ObjectKind = {
     Polyline: 'polyline',
     Point: 'point',
     Tile: 'tile',
+    Text: 'text',
 };
+/**
+ * Type guard for the {@link TilePropertyObjectRef} variant of
+ * {@link TilePropertyValue}.
+ * @internal
+ */
+function isTilePropertyObjectRef(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        !Array.isArray(value) &&
+        value.kind === TilePropertyKind.ObjectRef);
+}
+/**
+ * Equality used by {@link ObjectLayer.query}'s `value` filter.
+ *
+ * Scalars and `null` compare with `===`. `objectRef` values compare by `id`
+ * alone — the one genuinely common "find all objects referencing X" query
+ * need — regardless of differing LDtk navigation fields. Every other
+ * structured shape (`point`, `tileRef`, arrays, nested property bags) has no
+ * obvious value-equality semantics (exact float coordinates? array order?)
+ * and only matches when reference-identical; use `query({ property })`
+ * (presence-only) for those.
+ * @internal
+ */
+function tilePropertyValueEquals(a, b) {
+    if (a === b)
+        return true;
+    if (isTilePropertyObjectRef(a) && isTilePropertyObjectRef(b))
+        return a.id === b.id;
+    return false;
+}
 /**
  * A data-only layer of {@link TileMapObject}s — spawn points, trigger zones,
  * collision regions, markers. Object layers are not rendered by the tile
@@ -56,6 +89,8 @@ class ObjectLayer {
     offsetX;
     /** Layer pixel offset Y. */
     offsetY;
+    /** Draw order for the objects (Tiled `draworder`). Informational. */
+    drawOrder;
     /** Immutable layer-level properties. */
     properties;
     /** The objects in this layer (insertion order). */
@@ -68,6 +103,7 @@ class ObjectLayer {
         this.opacity = options.opacity ?? 1;
         this.offsetX = options.offsetX ?? 0;
         this.offsetY = options.offsetY ?? 0;
+        this.drawOrder = options.drawOrder ?? 'topdown';
         this.properties = options.properties ? Object.freeze({ ...options.properties }) : Object.freeze({});
         this.objects = options.objects ? Object.freeze([...options.objects]) : Object.freeze([]);
     }
@@ -84,10 +120,14 @@ class ObjectLayer {
                 return false;
             }
             if (filter.property !== undefined) {
-                if (!(filter.property in object.properties)) {
+                // TilePropertyValue never includes `undefined`, so an `undefined`
+                // read is a reliable "key absent" signal (equivalent to, but avoids
+                // re-indexing after, an `in` check).
+                const value = object.properties[filter.property];
+                if (value === undefined) {
                     return false;
                 }
-                if (filter.value !== undefined && object.properties[filter.property] !== filter.value) {
+                if (filter.value !== undefined && !tilePropertyValueEquals(value, filter.value)) {
                     return false;
                 }
             }

package/dist/esm/ObjectLayer.js.map

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

package/dist/esm/TileAnimator.d.ts

@@ -0,0 +1,62 @@
+import type { TileLayer } from './TileLayer';
+/**
+ * Drives per-tile animations on one or more {@link TileLayer}s, RPG-Maker style.
+ *
+ * On construction it scans the given layer(s) once and registers every cell
+ * whose tile carries an `animation` (see {@link import('./types').TileDefinition}).
+ * Each {@link update} advances a shared clock and rewrites **only** the
+ * registered animated cells, and **only** when a cell crosses a frame boundary —
+ * static tiles are never touched. Because a tile rewrite goes through
+ * `layer.setTileAt`, only the chunks that actually contain animated cells rebuild
+ * their geometry, and only on the (infrequent) frames where a boundary is
+ * crossed. The large static body of the map never rebuilds.
+ *
+ * Tick it from your update loop, like `TweenSequencer`:
+ *
+ * ```ts
+ * const animator = new TileAnimator(map.layers);
+ * scene.systems.add({ update: (t) => animator.update(t.deltaSeconds) });
+ * ```
+ *
+ * The animator references — but never owns — the layers and their tilesets;
+ * {@link destroy} only drops its own cell registry.
+ *
+ * @advanced
+ */
+export declare class TileAnimator {
+    private readonly _layers;
+    private _cells;
+    private _elapsedMs;
+    /**
+     * @param layers One layer, or an array of layers (e.g. `map.layers`), to scan
+     *               for animated tiles.
+     */
+    constructor(layers: TileLayer | readonly TileLayer[]);
+    /** Number of animated cells currently registered across all layers. */
+    get animatedCellCount(): number;
+    /** Total elapsed animation time in milliseconds since construction/reset. */
+    get elapsedMs(): number;
+    /**
+     * Advance all registered animations by `deltaSeconds` and write the current
+     * frame into any cell that crossed a frame boundary. Cells that did not change
+     * frame are not touched, so their chunks do not rebuild.
+     *
+     * @param deltaSeconds Elapsed wall-clock time since the last call, in seconds.
+     */
+    update(deltaSeconds: number): void;
+    /**
+     * Restore every animated cell to its first frame and reset the clock.
+     * Useful before serialising or pausing.
+     */
+    reset(): void;
+    /**
+     * Re-scan the layers for animated cells. Call after structural edits that add
+     * or remove animated tiles. Resets all currently-tracked cells to frame 0
+     * first so the rescan starts from a clean, deterministic state.
+     */
+    rescan(): void;
+    /** Drop the cell registry. Does not modify the layers or tilesets. */
+    destroy(): void;
+    /** Scan all layers for cells whose tile carries a (multi-frame) animation. */
+    private _scan;
+}

package/dist/esm/TileAnimator.js

@@ -0,0 +1,169 @@
+/**
+ * Drives per-tile animations on one or more {@link TileLayer}s, RPG-Maker style.
+ *
+ * On construction it scans the given layer(s) once and registers every cell
+ * whose tile carries an `animation` (see {@link import('./types').TileDefinition}).
+ * Each {@link update} advances a shared clock and rewrites **only** the
+ * registered animated cells, and **only** when a cell crosses a frame boundary —
+ * static tiles are never touched. Because a tile rewrite goes through
+ * `layer.setTileAt`, only the chunks that actually contain animated cells rebuild
+ * their geometry, and only on the (infrequent) frames where a boundary is
+ * crossed. The large static body of the map never rebuilds.
+ *
+ * Tick it from your update loop, like `TweenSequencer`:
+ *
+ * ```ts
+ * const animator = new TileAnimator(map.layers);
+ * scene.systems.add({ update: (t) => animator.update(t.deltaSeconds) });
+ * ```
+ *
+ * The animator references — but never owns — the layers and their tilesets;
+ * {@link destroy} only drops its own cell registry.
+ *
+ * @advanced
+ */
+class TileAnimator {
+    _layers;
+    _cells = [];
+    _elapsedMs = 0;
+    /**
+     * @param layers One layer, or an array of layers (e.g. `map.layers`), to scan
+     *               for animated tiles.
+     */
+    constructor(layers) {
+        this._layers = Array.isArray(layers) ? layers : [layers];
+        this._scan();
+    }
+    /** Number of animated cells currently registered across all layers. */
+    get animatedCellCount() {
+        return this._cells.length;
+    }
+    /** Total elapsed animation time in milliseconds since construction/reset. */
+    get elapsedMs() {
+        return this._elapsedMs;
+    }
+    /**
+     * Advance all registered animations by `deltaSeconds` and write the current
+     * frame into any cell that crossed a frame boundary. Cells that did not change
+     * frame are not touched, so their chunks do not rebuild.
+     *
+     * @param deltaSeconds Elapsed wall-clock time since the last call, in seconds.
+     */
+    update(deltaSeconds) {
+        if (!Number.isFinite(deltaSeconds) || deltaSeconds <= 0 || this._cells.length === 0) {
+            return;
+        }
+        this._elapsedMs += deltaSeconds * 1000;
+        for (const cell of this._cells) {
+            const t = this._elapsedMs % cell.totalMs;
+            const frameIndex = frameIndexAt(cell.cumulative, t);
+            if (frameIndex === cell.currentFrame) {
+                continue;
+            }
+            cell.currentFrame = frameIndex;
+            const frame = cell.frames[frameIndex];
+            if (frame === undefined) {
+                continue;
+            }
+            cell.layer.setTileAt(cell.tx, cell.ty, {
+                tileset: cell.tileset,
+                localTileId: frame.localTileId,
+                transform: cell.transform,
+            });
+        }
+    }
+    /**
+     * Restore every animated cell to its first frame and reset the clock.
+     * Useful before serialising or pausing.
+     */
+    reset() {
+        this._elapsedMs = 0;
+        for (const cell of this._cells) {
+            const frame = cell.frames[0];
+            if (frame === undefined) {
+                continue;
+            }
+            cell.currentFrame = 0;
+            cell.layer.setTileAt(cell.tx, cell.ty, {
+                tileset: cell.tileset,
+                localTileId: frame.localTileId,
+                transform: cell.transform,
+            });
+        }
+    }
+    /**
+     * Re-scan the layers for animated cells. Call after structural edits that add
+     * or remove animated tiles. Resets all currently-tracked cells to frame 0
+     * first so the rescan starts from a clean, deterministic state.
+     */
+    rescan() {
+        this.reset();
+        this._scan();
+    }
+    /** Drop the cell registry. Does not modify the layers or tilesets. */
+    destroy() {
+        this._cells = [];
+        this._elapsedMs = 0;
+    }
+    /** Scan all layers for cells whose tile carries a (multi-frame) animation. */
+    _scan() {
+        const cells = [];
+        for (const layer of this._layers) {
+            for (let ty = 0; ty < layer.height; ty++) {
+                for (let tx = 0; tx < layer.width; tx++) {
+                    const tile = layer.getTileAt(tx, ty);
+                    if (!tile) {
+                        continue;
+                    }
+                    const def = tile.tileset.getTileDefinition(tile.localTileId);
+                    const frames = def?.animation;
+                    if (!frames || frames.length < 2) {
+                        continue;
+                    }
+                    // Skip animations referencing out-of-range frames so update() never
+                    // throws from setTileAt; such data is malformed and silently ignored.
+                    if (frames.some(f => f.localTileId < 0 || f.localTileId >= tile.tileset.tileCount)) {
+                        continue;
+                    }
+                    const cumulative = [];
+                    let total = 0;
+                    for (const frame of frames) {
+                        total += Math.max(0, frame.duration);
+                        cumulative.push(total);
+                    }
+                    if (total <= 0) {
+                        continue;
+                    }
+                    cells.push({
+                        layer,
+                        tx,
+                        ty,
+                        tileset: tile.tileset,
+                        transform: tile.transform,
+                        frames,
+                        cumulative,
+                        totalMs: total,
+                        currentFrame: -1,
+                    });
+                }
+            }
+        }
+        this._cells = cells;
+    }
+}
+/**
+ * Find the frame index whose cumulative window contains time `t` (0 ≤ t < total).
+ * `cumulative[i]` is the end time of frame `i`; the last entry equals the total.
+ */
+function frameIndexAt(cumulative, t) {
+    for (let i = 0; i < cumulative.length; i++) {
+        const end = cumulative[i];
+        if (end !== undefined && t < end) {
+            return i;
+        }
+    }
+    return cumulative.length - 1;
+}
+
+export { TileAnimator };
+//# sourceMappingURL=TileAnimator.js.map

package/dist/esm/TileAnimator.js.map

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

package/dist/esm/TileLayer.d.ts

@@ -34,6 +34,23 @@ export interface TileLayerOptions {
     readonly offsetX?: number;
     /** Layer pixel offset Y. Default 0. */
     readonly offsetY?: number;
+    /**
+     * Parallax scroll factor on the X axis. `1.0` = full camera speed (normal),
+     * `0.5` = half speed (farther away), `0.0` = stationary. Default 1.
+     */
+    readonly parallaxX?: number;
+    /**
+     * Parallax scroll factor on the Y axis. `1.0` = full camera speed (normal),
+     * `0.5` = half speed (farther away), `0.0` = stationary. Default 1.
+     */
+    readonly parallaxY?: number;
+    /** Layer class/type string (Tiled `class`). Defaults to `''`. */
+    readonly class?: string;
+    /**
+     * Multiplicative layer tint as a `0xRRGGBB` integer, or `null` for none
+     * (Tiled `tintcolor`). Applied to every chunk's render tint. Default `null`.
+     */
+    readonly tintColor?: number | null;
     /** Layer properties (copied and frozen). */
     readonly properties?: TileProperties;
 }
@@ -50,8 +67,8 @@ export interface TileLayerOptions {
  * changes. Direct chunk mutation is not supported — the layer owns chunk
  * storage and exposes only a {@link ReadonlyTileChunk} view.
  *
- * The layer is NOT a SceneNode — that integration lives in the future
- * renderer slice.
+ * The layer is NOT a SceneNode — that integration lives in
+ * {@link import('./TileLayerNode').TileLayerNode}.
  *
  * @advanced
  */
@@ -84,6 +101,20 @@ export declare class TileLayer {
     offsetX: number;
     /** Vertical pixel offset (mutable). */
     offsetY: number;
+    /**
+     * Parallax scroll factor on the X axis.
+     * `1.0` = full camera speed, `0.5` = half speed, `0.0` = stationary.
+     */
+    readonly parallaxX: number;
+    /**
+     * Parallax scroll factor on the Y axis.
+     * `1.0` = full camera speed, `0.5` = half speed, `0.0` = stationary.
+     */
+    readonly parallaxY: number;
+    /** Layer class/type string (Tiled `class`; may be empty). */
+    readonly class: string;
+    /** Multiplicative layer tint as `0xRRGGBB`, or `null` for no tint. */
+    readonly tintColor: number | null;
     /** Immutable layer properties. */
     readonly properties: TileProperties;
     /** The tilesets available to this layer (shared array reference). */