@codexo/exojs-tilemap 0.15.3 → 0.16.0

package/dist/esm/ObjectLayer.d.ts

@@ -35,6 +35,15 @@ export interface ObjectPoint {
 interface TileMapObjectBase<P extends TileProperties = TileProperties> {
     /** Source-unique object id. */
     readonly id: number;
+    /**
+     * Stable string identity assigned by the authoring format, when it has one.
+     *
+     * LDtk sets it to the entity `iid`, which is globally unique and survives
+     * re-ordering, re-export and level moves - the identity to persist in a
+     * savegame. Tiled has no such field and leaves this unset; there, {@link id}
+     * is the identity and it is unique only within its map.
+     */
+    readonly sourceId?: string;
     /** Object name (may be empty; not unique). */
     readonly name: string;
     /** Object class/type string (Tiled `type`/`class`; may be empty). */
@@ -47,12 +56,25 @@ interface TileMapObjectBase<P extends TileProperties = TileProperties> {
     readonly width: number;
     /** Bounding height in px (0 for points). */
     readonly height: number;
-    /** Rotation in degrees, clockwise, about the object origin. */
+    /**
+     * Rotation in degrees, clockwise, about `(x, y)` - except on a
+     * {@link TileObject}, whose pivot stays at the source format's own anchor and
+     * is generally not `(x, y)`. See {@link TileObject} for why.
+     */
     readonly rotation: number;
     /** Whether the object is marked visible. */
     readonly visible: boolean;
     /** Immutable custom properties. */
     readonly properties: P;
+    /**
+     * The raw source-format record this object was parsed from, for the rare
+     * case that needs a field this model does not carry. Adapters that keep
+     * their parsed document alive set it (`LdtkEntityInstance` for LDtk,
+     * `TiledObject` for Tiled); a procedurally built object has none.
+     *
+     * Reading it ties the code to one source format - prefer the typed fields.
+     */
+    readonly source?: unknown;
 }
 /** An axis-aligned rectangle object spanning `[x, y, width, height]`. */
 export interface RectangleObject<P extends TileProperties = TileProperties> extends TileMapObjectBase<P> {
@@ -76,7 +98,23 @@ export interface PolylineObject<P extends TileProperties = TileProperties> exten
     readonly kind: typeof ObjectKind.Polyline;
     readonly points: readonly ObjectPoint[];
 }
-/** A tile (GID) object carrying a resolved tile reference. */
+/**
+ * A tile (GID) object carrying a resolved tile reference.
+ *
+ * `x`/`y` are the top-left corner of the bounding box, the same convention as
+ * every other object kind. Source formats that anchor a tile object elsewhere
+ * normalise to the corner on import: Tiled stores the position at the
+ * tileset's `objectalignment` point (bottom-left by default on an orthogonal
+ * map, bottom-centre on an isometric one) and rotates the tile image about
+ * that point, so a non-zero {@link TileMapObjectBase.rotation} on a tile
+ * object still pivots about the source anchor rather than about `(x, y)`.
+ *
+ * The owning tileset's drawing offset (Tiled `tileoffset`, reachable as
+ * `tile.tileset.offsetX`/`offsetY`) is likewise **not** folded into `x`/`y`.
+ * Object layers are data-only, so nothing in this package draws a tile object;
+ * code that does has to add that offset itself to match how a tile layer
+ * places the same tile.
+ */
 export interface TileObject<P extends TileProperties = TileProperties> extends TileMapObjectBase<P> {
     readonly kind: typeof ObjectKind.Tile;
     readonly tile: ResolvedTile;
@@ -131,7 +169,7 @@ export type TileMapObject<P extends TileProperties = TileProperties> = Rectangle
  *
  * @remarks
  * A schema is a **developer promise, not a runtime guarantee.** Tiled data is
- * untyped at runtime and ExoJS performs no validation against the schema —
+ * untyped at runtime and ExoJS performs no validation against the schema -
  * the property objects are returned exactly as parsed. The schema only refines
  * the static type of `properties` for ergonomic, typo-safe field access. If the
  * source data does not match the declared shape, reads still succeed but the
@@ -185,6 +223,23 @@ export interface ObjectLayerOptions {
     readonly offsetX?: number;
     /** Layer pixel offset Y. Default `0`. */
     readonly offsetY?: number;
+    /**
+     * Parallax scroll factor on the X axis. `1` = full camera speed (normal),
+     * `0.5` = half speed (farther away), `0` = stationary. Default `1`.
+     */
+    readonly parallaxX?: number;
+    /**
+     * Parallax scroll factor on the Y axis. `1` = full camera speed (normal),
+     * `0.5` = half speed (farther away), `0` = stationary. Default `1`.
+     */
+    readonly parallaxY?: number;
+    /** Uniform parallax scale around the layer origin. Default `1`. */
+    readonly parallaxScale?: number;
+    /**
+     * Multiplicative layer tint as a `0xRRGGBB` integer, or `null` for no tint
+     * (Tiled `tintcolor`). Default `null`.
+     */
+    readonly tintColor?: number | null;
     /**
      * Draw order for the objects (Tiled `draworder`): `'topdown'` (sorted by `y`)
      * or `'index'` (source order). Informational; objects are stored as given.
@@ -197,20 +252,29 @@ export interface ObjectLayerOptions {
     readonly properties?: TileProperties;
 }
 /**
- * A data-only layer of {@link TileMapObject}s — spawn points, trigger zones,
+ * A data-only layer of {@link TileMapObject}s - spawn points, trigger zones,
  * collision regions, markers. Object layers are not rendered by the tile
  * renderer; they are parsed and exposed for gameplay use (e.g. building physics
  * colliders, placing entities).
  *
+ * The presentation fields the source format attaches to a layer -
+ * {@link visible}, {@link opacity}, {@link offsetX}/{@link offsetY},
+ * {@link parallaxX}/{@link parallaxY}, {@link parallaxScale}, and
+ * {@link tintColor} - are carried
+ * through in full, with any enclosing group layers' contribution already
+ * folded in, so an object layer describes the same placement and shading its
+ * neighbouring tile and image layers do. Nothing here acts on them: code that
+ * draws these objects itself is what applies them.
+ *
  * Query with {@link query} (untyped, fully back-compatible) or, when an
  * {@link ObjectSchema} type argument `S` is supplied, with the typed accessors
- * {@link byType}, {@link byKind}, and {@link where} — these narrow `properties`
+ * {@link byType}, {@link byKind}, and {@link where} - these narrow `properties`
  * to the developer-declared shape. The schema is **opt-in**: the default type
  * parameter reproduces the original untyped behaviour, so
  * `new ObjectLayer(options)` and `map.getObjectLayer('x')` are unchanged.
  *
  * @remarks
- * A schema is a developer promise, not a runtime guarantee — Tiled data is
+ * A schema is a developer promise, not a runtime guarantee - Tiled data is
  * untyped at runtime and ExoJS performs no validation. See {@link ObjectSchema}.
  *
  * @typeParam S - Optional {@link ObjectSchema} mapping object `type` strings to
@@ -236,6 +300,27 @@ export declare class ObjectLayer<S extends ObjectSchema = ObjectSchema> {
     readonly offsetX: number;
     /** Layer pixel offset Y. */
     readonly offsetY: number;
+    /**
+     * Parallax scroll factor on the X axis - the same quantity
+     * {@link import('./TileLayer').TileLayer.parallaxX} carries, so an object
+     * layer authored beside a tile layer in the same parallax group reports the
+     * same factor. `1` = full camera speed, `0.5` = half speed, `0` =
+     * stationary. Nothing in this package applies it: object layers are
+     * data-only, so placing an object relative to the camera is the consumer's
+     * job (see {@link ObjectLayer}).
+     */
+    readonly parallaxX: number;
+    /** Parallax scroll factor on the Y axis. See {@link ObjectLayer.parallaxX}. */
+    readonly parallaxY: number;
+    /** Uniform scale applied around the layer origin by consumers that render this data-only layer. */
+    readonly parallaxScale: number;
+    /**
+     * Multiplicative layer tint as `0xRRGGBB`, or `null` for no tint. Carried
+     * from the source map (including the accumulated tint of any enclosing group
+     * layers) for code that draws these objects itself; like
+     * {@link ObjectLayer.parallaxX}, nothing in this package applies it.
+     */
+    readonly tintColor: number | null;
     /** Draw order for the objects (Tiled `draworder`). Informational. */
     readonly drawOrder: 'topdown' | 'index';
     /** Immutable layer-level properties. */
@@ -249,7 +334,7 @@ export declare class ObjectLayer<S extends ObjectSchema = ObjectSchema> {
      * Objects whose `type` equals `type`, with `properties` narrowed to the
      * schema shape `S[T]`. Returns a fresh array (insertion order).
      *
-     * The narrowing is a static convenience only — no runtime validation is
+     * The narrowing is a static convenience only - no runtime validation is
      * performed (see {@link ObjectSchema}). On an unschematised layer this
      * behaves like `query({ type })` with `TileProperties` properties.
      */
@@ -275,3 +360,4 @@ export declare class ObjectLayer<S extends ObjectSchema = ObjectSchema> {
     getObjectByName(name: string): TileMapObject | undefined;
 }
 export {};
+//# sourceMappingURL=ObjectLayer.d.ts.map

package/dist/esm/ObjectLayer.d.ts.map

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

package/dist/esm/ObjectLayer.js

@@ -1,176 +1,193 @@
-import { TilePropertyKind } from './types.js';
+import { TilePropertyKind } from "./types.js";
 
+//#region src/ObjectLayer.ts
 /**
- * Geometry kinds for a {@link TileMapObject}, as an `as const` value object.
- *
- * Modelled as a frozen string map (not a TS `enum`) so the values stay
- * wire-compatible with the Tiled string serialisation, survive
- * `verbatimModuleSyntax` (no emitted runtime helper), and follow the package
- * convention for enum-like constants. Use the members for ergonomic, typo-safe
- * call sites: `layer.byKind(ObjectKind.Polygon)`.
- * @stable
- */
+* Geometry kinds for a {@link TileMapObject}, as an `as const` value object.
+*
+* Modelled as a frozen string map (not a TS `enum`) so the values stay
+* wire-compatible with the Tiled string serialisation, survive
+* `verbatimModuleSyntax` (no emitted runtime helper), and follow the package
+* convention for enum-like constants. Use the members for ergonomic, typo-safe
+* call sites: `layer.byKind(ObjectKind.Polygon)`.
+* @stable
+*/
 const ObjectKind = {
-    Rectangle: 'rectangle',
-    Ellipse: 'ellipse',
-    Polygon: 'polygon',
-    Polyline: 'polyline',
-    Point: 'point',
-    Tile: 'tile',
-    Text: 'text',
+	Rectangle: "rectangle",
+	Ellipse: "ellipse",
+	Polygon: "polygon",
+	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);
-}
+* Type guard for the {@link TilePropertyObjectRef} variant of
+* {@link TilePropertyValue}.
+* @internal
+*/
+const isTilePropertyObjectRef = (value) => 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;
-}
+* 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
+*/
+const 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
- * renderer; they are parsed and exposed for gameplay use (e.g. building physics
- * colliders, placing entities).
- *
- * Query with {@link query} (untyped, fully back-compatible) or, when an
- * {@link ObjectSchema} type argument `S` is supplied, with the typed accessors
- * {@link byType}, {@link byKind}, and {@link where} — these narrow `properties`
- * to the developer-declared shape. The schema is **opt-in**: the default type
- * parameter reproduces the original untyped behaviour, so
- * `new ObjectLayer(options)` and `map.getObjectLayer('x')` are unchanged.
- *
- * @remarks
- * A schema is a developer promise, not a runtime guarantee — Tiled data is
- * untyped at runtime and ExoJS performs no validation. See {@link ObjectSchema}.
- *
- * @typeParam S - Optional {@link ObjectSchema} mapping object `type` strings to
- * their property shapes. Defaults to a generic schema (every type maps to the
- * loose {@link TileProperties} bag).
- *
- * @advanced
- */
-class ObjectLayer {
-    /** Layer-kind discriminant (distinguishes object layers from tile layers). */
-    kind = 'object';
-    /** Layer id (unique within the map). */
-    id;
-    /** Layer name. */
-    name;
-    /** Layer class string. */
-    class;
-    /** Whether the layer is visible. */
-    visible;
-    /** Layer opacity in `[0, 1]`. */
-    opacity;
-    /** Layer pixel offset X. */
-    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). */
-    objects;
-    constructor(options) {
-        this.id = options.id;
-        this.name = options.name ?? '';
-        this.class = options.class ?? '';
-        this.visible = options.visible ?? true;
-        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([]);
-    }
-    /** Objects matching every specified criterion of `filter`. Returns a fresh array. */
-    query(filter = {}) {
-        return this.objects.filter(object => {
-            if (filter.name !== undefined && object.name !== filter.name) {
-                return false;
-            }
-            if (filter.type !== undefined && object.type !== filter.type) {
-                return false;
-            }
-            if (filter.kind !== undefined && object.kind !== filter.kind) {
-                return false;
-            }
-            if (filter.property !== undefined) {
-                // 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 && !tilePropertyValueEquals(value, filter.value)) {
-                    return false;
-                }
-            }
-            return true;
-        });
-    }
-    /**
-     * Objects whose `type` equals `type`, with `properties` narrowed to the
-     * schema shape `S[T]`. Returns a fresh array (insertion order).
-     *
-     * The narrowing is a static convenience only — no runtime validation is
-     * performed (see {@link ObjectSchema}). On an unschematised layer this
-     * behaves like `query({ type })` with `TileProperties` properties.
-     */
-    byType(type) {
-        return this.objects.filter(object => object.type === type);
-    }
-    /**
-     * Objects of the given geometry {@link ObjectKind}, narrowed to that
-     * geometry's member type (e.g. `byKind(ObjectKind.Polygon)` yields
-     * {@link PolygonObject}s with their `points`). Returns a fresh array.
-     */
-    byKind(kind) {
-        return this.objects.filter(object => object.kind === kind);
-    }
-    /**
-     * Objects of `type` (typed as in {@link byType}) that also satisfy
-     * `predicate`. A convenience combination of {@link byType} and `Array.filter`
-     * that keeps the narrowed `properties` type inside the predicate. Returns a
-     * fresh array.
-     */
-    where(type, predicate) {
-        return this.byType(type).filter(object => predicate(object));
-    }
-    /** First object with the given id, or undefined. */
-    getObjectById(id) {
-        return this.objects.find(object => object.id === id);
-    }
-    /** First object with the given name, or undefined. */
-    getObjectByName(name) {
-        return this.objects.find(object => object.name === name);
-    }
-}
+* A data-only layer of {@link TileMapObject}s - spawn points, trigger zones,
+* collision regions, markers. Object layers are not rendered by the tile
+* renderer; they are parsed and exposed for gameplay use (e.g. building physics
+* colliders, placing entities).
+*
+* The presentation fields the source format attaches to a layer -
+* {@link visible}, {@link opacity}, {@link offsetX}/{@link offsetY},
+* {@link parallaxX}/{@link parallaxY}, {@link parallaxScale}, and
+* {@link tintColor} - are carried
+* through in full, with any enclosing group layers' contribution already
+* folded in, so an object layer describes the same placement and shading its
+* neighbouring tile and image layers do. Nothing here acts on them: code that
+* draws these objects itself is what applies them.
+*
+* Query with {@link query} (untyped, fully back-compatible) or, when an
+* {@link ObjectSchema} type argument `S` is supplied, with the typed accessors
+* {@link byType}, {@link byKind}, and {@link where} - these narrow `properties`
+* to the developer-declared shape. The schema is **opt-in**: the default type
+* parameter reproduces the original untyped behaviour, so
+* `new ObjectLayer(options)` and `map.getObjectLayer('x')` are unchanged.
+*
+* @remarks
+* A schema is a developer promise, not a runtime guarantee - Tiled data is
+* untyped at runtime and ExoJS performs no validation. See {@link ObjectSchema}.
+*
+* @typeParam S - Optional {@link ObjectSchema} mapping object `type` strings to
+* their property shapes. Defaults to a generic schema (every type maps to the
+* loose {@link TileProperties} bag).
+*
+* @advanced
+*/
+var ObjectLayer = class {
+	/** Layer-kind discriminant (distinguishes object layers from tile layers). */
+	kind = "object";
+	/** Layer id (unique within the map). */
+	id;
+	/** Layer name. */
+	name;
+	/** Layer class string. */
+	class;
+	/** Whether the layer is visible. */
+	visible;
+	/** Layer opacity in `[0, 1]`. */
+	opacity;
+	/** Layer pixel offset X. */
+	offsetX;
+	/** Layer pixel offset Y. */
+	offsetY;
+	/**
+	* Parallax scroll factor on the X axis - the same quantity
+	* {@link import('./TileLayer').TileLayer.parallaxX} carries, so an object
+	* layer authored beside a tile layer in the same parallax group reports the
+	* same factor. `1` = full camera speed, `0.5` = half speed, `0` =
+	* stationary. Nothing in this package applies it: object layers are
+	* data-only, so placing an object relative to the camera is the consumer's
+	* job (see {@link ObjectLayer}).
+	*/
+	parallaxX;
+	/** Parallax scroll factor on the Y axis. See {@link ObjectLayer.parallaxX}. */
+	parallaxY;
+	/** Uniform scale applied around the layer origin by consumers that render this data-only layer. */
+	parallaxScale;
+	/**
+	* Multiplicative layer tint as `0xRRGGBB`, or `null` for no tint. Carried
+	* from the source map (including the accumulated tint of any enclosing group
+	* layers) for code that draws these objects itself; like
+	* {@link ObjectLayer.parallaxX}, nothing in this package applies it.
+	*/
+	tintColor;
+	/** Draw order for the objects (Tiled `draworder`). Informational. */
+	drawOrder;
+	/** Immutable layer-level properties. */
+	properties;
+	/** The objects in this layer (insertion order). */
+	objects;
+	constructor(options) {
+		this.id = options.id;
+		this.name = options.name ?? "";
+		this.class = options.class ?? "";
+		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.parallaxScale = options.parallaxScale ?? 1;
+		if (!Number.isFinite(this.parallaxScale) || this.parallaxScale <= 0) throw new Error("ObjectLayer parallaxScale must be a positive finite number.");
+		this.tintColor = options.tintColor ?? null;
+		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([]);
+	}
+	/** Objects matching every specified criterion of `filter`. Returns a fresh array. */
+	query(filter = {}) {
+		return this.objects.filter((object) => {
+			if (filter.name !== void 0 && object.name !== filter.name) return false;
+			if (filter.type !== void 0 && object.type !== filter.type) return false;
+			if (filter.kind !== void 0 && object.kind !== filter.kind) return false;
+			if (filter.property !== void 0) {
+				const value = object.properties[filter.property];
+				if (value === void 0) return false;
+				if (filter.value !== void 0 && !tilePropertyValueEquals(value, filter.value)) return false;
+			}
+			return true;
+		});
+	}
+	/**
+	* Objects whose `type` equals `type`, with `properties` narrowed to the
+	* schema shape `S[T]`. Returns a fresh array (insertion order).
+	*
+	* The narrowing is a static convenience only - no runtime validation is
+	* performed (see {@link ObjectSchema}). On an unschematised layer this
+	* behaves like `query({ type })` with `TileProperties` properties.
+	*/
+	byType(type) {
+		return this.objects.filter((object) => object.type === type);
+	}
+	/**
+	* Objects of the given geometry {@link ObjectKind}, narrowed to that
+	* geometry's member type (e.g. `byKind(ObjectKind.Polygon)` yields
+	* {@link PolygonObject}s with their `points`). Returns a fresh array.
+	*/
+	byKind(kind) {
+		return this.objects.filter((object) => object.kind === kind);
+	}
+	/**
+	* Objects of `type` (typed as in {@link byType}) that also satisfy
+	* `predicate`. A convenience combination of {@link byType} and `Array.filter`
+	* that keeps the narrowed `properties` type inside the predicate. Returns a
+	* fresh array.
+	*/
+	where(type, predicate) {
+		return this.byType(type).filter((object) => predicate(object));
+	}
+	/** First object with the given id, or undefined. */
+	getObjectById(id) {
+		return this.objects.find((object) => object.id === id);
+	}
+	/** First object with the given name, or undefined. */
+	getObjectByName(name) {
+		return this.objects.find((object) => object.name === name);
+	}
+};
 
+//#endregion
 export { ObjectKind, ObjectLayer };
-//# sourceMappingURL=ObjectLayer.js.map
+//# sourceMappingURL=ObjectLayer.js.map

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","names":[],"sources":["../../src/ObjectLayer.ts"],"sourcesContent":["import type { ResolvedTile, TileProperties, TilePropertyObjectRef, TilePropertyValue } from './types';\nimport { TilePropertyKind } from './types';\n\n/**\n * Geometry kinds for a {@link TileMapObject}, as an `as const` value object.\n *\n * Modelled as a frozen string map (not a TS `enum`) so the values stay\n * wire-compatible with the Tiled string serialisation, survive\n * `verbatimModuleSyntax` (no emitted runtime helper), and follow the package\n * convention for enum-like constants. Use the members for ergonomic, typo-safe\n * call sites: `layer.byKind(ObjectKind.Polygon)`.\n * @stable\n */\nexport const ObjectKind = {\n  Rectangle: 'rectangle',\n  Ellipse: 'ellipse',\n  Polygon: 'polygon',\n  Polyline: 'polyline',\n  Point: 'point',\n  Tile: 'tile',\n  Text: 'text',\n} as const;\n\n/** Geometry discriminant for a {@link TileMapObject}. */\nexport type ObjectKind = (typeof ObjectKind)[keyof typeof ObjectKind];\n\n/**\n * Geometry discriminant for a {@link TileMapObject}.\n * Structural alias of {@link ObjectKind}; retained so existing code keeps\n * compiling. New code may prefer {@link ObjectKind}.\n */\nexport type TileMapObjectKind = ObjectKind;\n\n/** A point in object-layer space (pixels, relative to the object). */\nexport interface ObjectPoint {\n  readonly x: number;\n  readonly y: number;\n}\n\n/** Fields shared by every {@link TileMapObject} kind. */\ninterface TileMapObjectBase<P extends TileProperties = TileProperties> {\n  /** Source-unique object id. */\n  readonly id: number;\n  /**\n   * Stable string identity assigned by the authoring format, when it has one.\n   *\n   * LDtk sets it to the entity `iid`, which is globally unique and survives\n   * re-ordering, re-export and level moves - the identity to persist in a\n   * savegame. Tiled has no such field and leaves this unset; there, {@link id}\n   * is the identity and it is unique only within its map.\n   */\n  readonly sourceId?: string;\n  /** Object name (may be empty; not unique). */\n  readonly name: string;\n  /** Object class/type string (Tiled `type`/`class`; may be empty). */\n  readonly type: string;\n  /** X of the object origin in object-layer pixel space. */\n  readonly x: number;\n  /** Y of the object origin in object-layer pixel space. */\n  readonly y: number;\n  /** Bounding width in px (0 for points). */\n  readonly width: number;\n  /** Bounding height in px (0 for points). */\n  readonly height: number;\n  /**\n   * Rotation in degrees, clockwise, about `(x, y)` - except on a\n   * {@link TileObject}, whose pivot stays at the source format's own anchor and\n   * is generally not `(x, y)`. See {@link TileObject} for why.\n   */\n  readonly rotation: number;\n  /** Whether the object is marked visible. */\n  readonly visible: boolean;\n  /** Immutable custom properties. */\n  readonly properties: P;\n  /**\n   * The raw source-format record this object was parsed from, for the rare\n   * case that needs a field this model does not carry. Adapters that keep\n   * their parsed document alive set it (`LdtkEntityInstance` for LDtk,\n   * `TiledObject` for Tiled); a procedurally built object has none.\n   *\n   * Reading it ties the code to one source format - prefer the typed fields.\n   */\n  readonly source?: unknown;\n}\n\n/** An axis-aligned rectangle object spanning `[x, y, width, height]`. */\nexport interface RectangleObject<P extends TileProperties = TileProperties> extends TileMapObjectBase<P> {\n  readonly kind: typeof ObjectKind.Rectangle;\n}\n\n/** An ellipse inscribed in `[x, y, width, height]`. */\nexport interface EllipseObject<P extends TileProperties = TileProperties> extends TileMapObjectBase<P> {\n  readonly kind: typeof ObjectKind.Ellipse;\n}\n\n/** A single point at `(x, y)`. */\nexport interface PointObject<P extends TileProperties = TileProperties> extends TileMapObjectBase<P> {\n  readonly kind: typeof ObjectKind.Point;\n}\n\n/** A closed polygon; `points` are relative to the object origin. */\nexport interface PolygonObject<P extends TileProperties = TileProperties> extends TileMapObjectBase<P> {\n  readonly kind: typeof ObjectKind.Polygon;\n  readonly points: readonly ObjectPoint[];\n}\n\n/** An open polyline; `points` are relative to the object origin. */\nexport interface PolylineObject<P extends TileProperties = TileProperties> extends TileMapObjectBase<P> {\n  readonly kind: typeof ObjectKind.Polyline;\n  readonly points: readonly ObjectPoint[];\n}\n\n/**\n * A tile (GID) object carrying a resolved tile reference.\n *\n * `x`/`y` are the top-left corner of the bounding box, the same convention as\n * every other object kind. Source formats that anchor a tile object elsewhere\n * normalise to the corner on import: Tiled stores the position at the\n * tileset's `objectalignment` point (bottom-left by default on an orthogonal\n * map, bottom-centre on an isometric one) and rotates the tile image about\n * that point, so a non-zero {@link TileMapObjectBase.rotation} on a tile\n * object still pivots about the source anchor rather than about `(x, y)`.\n *\n * The owning tileset's drawing offset (Tiled `tileoffset`, reachable as\n * `tile.tileset.offsetX`/`offsetY`) is likewise **not** folded into `x`/`y`.\n * Object layers are data-only, so nothing in this package draws a tile object;\n * code that does has to add that offset itself to match how a tile layer\n * places the same tile.\n */\nexport interface TileObject<P extends TileProperties = TileProperties> extends TileMapObjectBase<P> {\n  readonly kind: typeof ObjectKind.Tile;\n  readonly tile: ResolvedTile;\n}\n\n/** Text styling options carried by a {@link TextObject}. */\nexport interface TextStyle {\n  /** The text content. */\n  readonly text: string;\n  /** Text colour as 0xRRGGBB, or `null` if default. */\n  readonly color?: number | null;\n  /** Font family name. */\n  readonly fontFamily?: string;\n  /** Font size in pixels. */\n  readonly pixelSize?: number;\n  /** Bold text. */\n  readonly bold?: boolean;\n  /** Italic text. */\n  readonly italic?: boolean;\n  /** Underline text. */\n  readonly underline?: boolean;\n  /** Strikeout text. */\n  readonly strikeout?: boolean;\n  /** Wrap text within the object bounds. */\n  readonly wrap?: boolean;\n  /** Horizontal alignment. */\n  readonly halign?: 'left' | 'center' | 'right' | 'justify';\n  /** Vertical alignment. */\n  readonly valign?: 'top' | 'center' | 'bottom';\n}\n\n/** A text object carrying styled text content within `[x, y, width, height]`. */\nexport interface TextObject<P extends TileProperties = TileProperties> extends TileMapObjectBase<P> {\n  readonly kind: typeof ObjectKind.Text;\n  readonly text: TextStyle;\n}\n\n/**\n * A format-independent map object. The geometry kind is the discriminant;\n * narrow on `kind` to read shape-specific fields. Template objects are not\n * yet represented.\n *\n * The optional property-shape parameter `P` lets typed accessors\n * (see {@link ObjectLayer.byType}) narrow `properties` to a developer-declared\n * schema. It defaults to the generic {@link TileProperties} bag, so the plain\n * `TileMapObject` form is unchanged.\n * @advanced\n */\nexport type TileMapObject<P extends TileProperties = TileProperties> =\n  RectangleObject<P> | EllipseObject<P> | PointObject<P> | PolygonObject<P> | PolylineObject<P> | TileObject<P> | TextObject<P>;\n\n/**\n * A developer-declared mapping from object `type`/class strings to the property\n * shape an object of that type is expected to carry. Supplied as the type\n * parameter to {@link ObjectLayer} to unlock the typed accessors\n * ({@link ObjectLayer.byType}, {@link ObjectLayer.where}).\n *\n * @remarks\n * A schema is a **developer promise, not a runtime guarantee.** Tiled data is\n * untyped at runtime and ExoJS performs no validation against the schema -\n * the property objects are returned exactly as parsed. The schema only refines\n * the static type of `properties` for ergonomic, typo-safe field access. If the\n * source data does not match the declared shape, reads still succeed but the\n * static type is a fiction. Validate at the boundary if you need certainty.\n *\n * @example\n * ```ts\n * const EntityType = { Spawn: 'spawn', Pickup: 'pickup' } as const;\n * interface LevelObjects {\n *   [EntityType.Spawn]:  { team: 'red' | 'blue' };\n *   [EntityType.Pickup]: { item: 'coin' | 'gem'; amount: number };\n * }\n * const entities = map.getObjectLayer<LevelObjects>('Entities');\n * entities.byType(EntityType.Spawn)[0].properties.team; // 'red' | 'blue'\n * ```\n * @stable\n */\nexport type ObjectSchema = Record<string, TileProperties>;\n\n/**\n * A {@link TileMapObject} whose `properties` are narrowed to the schema shape\n * declared for the object `type` `T` in schema `S`.\n * @advanced\n */\nexport type TypedObject<S extends ObjectSchema, T extends keyof S & string> = TileMapObject<S[T]>;\n\n/** Filter for {@link ObjectLayer.query}. Unspecified fields match everything. */\nexport interface ObjectQuery {\n  /** Match objects whose `name` equals this. */\n  readonly name?: string;\n  /** Match objects whose `type`/class equals this. */\n  readonly type?: string;\n  /** Match objects of this geometry kind. */\n  readonly kind?: TileMapObjectKind;\n  /** Match objects that carry this property key. */\n  readonly property?: string;\n  /** When combined with `property`, also require the property value to equal this. */\n  readonly value?: TilePropertyValue;\n}\n\n/**\n * Type guard for the {@link TilePropertyObjectRef} variant of\n * {@link TilePropertyValue}.\n * @internal\n */\nconst isTilePropertyObjectRef = (value: TilePropertyValue): value is TilePropertyObjectRef =>\n  typeof value === 'object' && value !== null && !Array.isArray(value) && (value as { kind?: unknown }).kind === TilePropertyKind.ObjectRef;\n\n/**\n * Equality used by {@link ObjectLayer.query}'s `value` filter.\n *\n * Scalars and `null` compare with `===`. `objectRef` values compare by `id`\n * alone - the one genuinely common \"find all objects referencing X\" query\n * need - regardless of differing LDtk navigation fields. Every other\n * structured shape (`point`, `tileRef`, arrays, nested property bags) has no\n * obvious value-equality semantics (exact float coordinates? array order?)\n * and only matches when reference-identical; use `query({ property })`\n * (presence-only) for those.\n * @internal\n */\nconst tilePropertyValueEquals = (a: TilePropertyValue, b: TilePropertyValue): boolean => {\n  if (a === b) return true;\n  if (isTilePropertyObjectRef(a) && isTilePropertyObjectRef(b)) return a.id === b.id;\n  return false;\n};\n\n/** Construction options for an {@link ObjectLayer}. */\nexport interface ObjectLayerOptions {\n  /** Layer id (unique within the map). */\n  readonly id: number;\n  /** Layer name. */\n  readonly name?: string;\n  /** Layer class string. */\n  readonly class?: string;\n  /** Whether the layer is visible. Default `true`. */\n  readonly visible?: boolean;\n  /** Layer opacity in `[0, 1]`. Default `1`. */\n  readonly opacity?: number;\n  /** Layer pixel offset X. Default `0`. */\n  readonly offsetX?: number;\n  /** Layer pixel offset Y. Default `0`. */\n  readonly offsetY?: number;\n  /**\n   * Parallax scroll factor on the X axis. `1` = full camera speed (normal),\n   * `0.5` = half speed (farther away), `0` = stationary. Default `1`.\n   */\n  readonly parallaxX?: number;\n  /**\n   * Parallax scroll factor on the Y axis. `1` = full camera speed (normal),\n   * `0.5` = half speed (farther away), `0` = stationary. Default `1`.\n   */\n  readonly parallaxY?: number;\n  /** Uniform parallax scale around the layer origin. Default `1`. */\n  readonly parallaxScale?: number;\n  /**\n   * Multiplicative layer tint as a `0xRRGGBB` integer, or `null` for no tint\n   * (Tiled `tintcolor`). Default `null`.\n   */\n  readonly tintColor?: number | null;\n  /**\n   * Draw order for the objects (Tiled `draworder`): `'topdown'` (sorted by `y`)\n   * or `'index'` (source order). Informational; objects are stored as given.\n   * Default `'topdown'`.\n   */\n  readonly drawOrder?: 'topdown' | 'index';\n  /** The objects in this layer. */\n  readonly objects?: readonly TileMapObject[];\n  /** Layer-level properties (copied and frozen). */\n  readonly properties?: TileProperties;\n}\n\n/**\n * A data-only layer of {@link TileMapObject}s - spawn points, trigger zones,\n * collision regions, markers. Object layers are not rendered by the tile\n * renderer; they are parsed and exposed for gameplay use (e.g. building physics\n * colliders, placing entities).\n *\n * The presentation fields the source format attaches to a layer -\n * {@link visible}, {@link opacity}, {@link offsetX}/{@link offsetY},\n * {@link parallaxX}/{@link parallaxY}, {@link parallaxScale}, and\n * {@link tintColor} - are carried\n * through in full, with any enclosing group layers' contribution already\n * folded in, so an object layer describes the same placement and shading its\n * neighbouring tile and image layers do. Nothing here acts on them: code that\n * draws these objects itself is what applies them.\n *\n * Query with {@link query} (untyped, fully back-compatible) or, when an\n * {@link ObjectSchema} type argument `S` is supplied, with the typed accessors\n * {@link byType}, {@link byKind}, and {@link where} - these narrow `properties`\n * to the developer-declared shape. The schema is **opt-in**: the default type\n * parameter reproduces the original untyped behaviour, so\n * `new ObjectLayer(options)` and `map.getObjectLayer('x')` are unchanged.\n *\n * @remarks\n * A schema is a developer promise, not a runtime guarantee - Tiled data is\n * untyped at runtime and ExoJS performs no validation. See {@link ObjectSchema}.\n *\n * @typeParam S - Optional {@link ObjectSchema} mapping object `type` strings to\n * their property shapes. Defaults to a generic schema (every type maps to the\n * loose {@link TileProperties} bag).\n *\n * @advanced\n */\nexport class ObjectLayer<S extends ObjectSchema = ObjectSchema> {\n  /** Layer-kind discriminant (distinguishes object layers from tile layers). */\n  public readonly kind = 'object' as const;\n\n  /** Layer id (unique within the map). */\n  public readonly id: number;\n  /** Layer name. */\n  public readonly name: string;\n  /** Layer class string. */\n  public readonly class: string;\n  /** Whether the layer is visible. */\n  public readonly visible: boolean;\n  /** Layer opacity in `[0, 1]`. */\n  public readonly opacity: number;\n  /** Layer pixel offset X. */\n  public readonly offsetX: number;\n  /** Layer pixel offset Y. */\n  public readonly offsetY: number;\n  /**\n   * Parallax scroll factor on the X axis - the same quantity\n   * {@link import('./TileLayer').TileLayer.parallaxX} carries, so an object\n   * layer authored beside a tile layer in the same parallax group reports the\n   * same factor. `1` = full camera speed, `0.5` = half speed, `0` =\n   * stationary. Nothing in this package applies it: object layers are\n   * data-only, so placing an object relative to the camera is the consumer's\n   * job (see {@link ObjectLayer}).\n   */\n  public readonly parallaxX: number;\n  /** Parallax scroll factor on the Y axis. See {@link ObjectLayer.parallaxX}. */\n  public readonly parallaxY: number;\n  /** Uniform scale applied around the layer origin by consumers that render this data-only layer. */\n  public readonly parallaxScale: number;\n  /**\n   * Multiplicative layer tint as `0xRRGGBB`, or `null` for no tint. Carried\n   * from the source map (including the accumulated tint of any enclosing group\n   * layers) for code that draws these objects itself; like\n   * {@link ObjectLayer.parallaxX}, nothing in this package applies it.\n   */\n  public readonly tintColor: number | null;\n  /** Draw order for the objects (Tiled `draworder`). Informational. */\n  public readonly drawOrder: 'topdown' | 'index';\n  /** Immutable layer-level properties. */\n  public readonly properties: TileProperties;\n  /** The objects in this layer (insertion order). */\n  public readonly objects: readonly TileMapObject[];\n\n  public constructor(options: ObjectLayerOptions) {\n    this.id = options.id;\n    this.name = options.name ?? '';\n    this.class = options.class ?? '';\n    this.visible = options.visible ?? true;\n    this.opacity = options.opacity ?? 1;\n    this.offsetX = options.offsetX ?? 0;\n    this.offsetY = options.offsetY ?? 0;\n    this.parallaxX = options.parallaxX ?? 1;\n    this.parallaxY = options.parallaxY ?? 1;\n    this.parallaxScale = options.parallaxScale ?? 1;\n    if (!Number.isFinite(this.parallaxScale) || this.parallaxScale <= 0) {\n      throw new Error('ObjectLayer parallaxScale must be a positive finite number.');\n    }\n    this.tintColor = options.tintColor ?? null;\n    this.drawOrder = options.drawOrder ?? 'topdown';\n    this.properties = options.properties ? Object.freeze({ ...options.properties }) : Object.freeze({});\n    this.objects = options.objects ? Object.freeze([...options.objects]) : Object.freeze([]);\n  }\n\n  /** Objects matching every specified criterion of `filter`. Returns a fresh array. */\n  public query(filter: ObjectQuery = {}): TileMapObject[] {\n    return this.objects.filter(object => {\n      if (filter.name !== undefined && object.name !== filter.name) {\n        return false;\n      }\n\n      if (filter.type !== undefined && object.type !== filter.type) {\n        return false;\n      }\n\n      if (filter.kind !== undefined && object.kind !== filter.kind) {\n        return false;\n      }\n\n      if (filter.property !== undefined) {\n        // TilePropertyValue never includes `undefined`, so an `undefined`\n        // read is a reliable \"key absent\" signal (equivalent to, but avoids\n        // re-indexing after, an `in` check).\n        const value = object.properties[filter.property];\n        if (value === undefined) {\n          return false;\n        }\n\n        if (filter.value !== undefined && !tilePropertyValueEquals(value, filter.value)) {\n          return false;\n        }\n      }\n\n      return true;\n    });\n  }\n\n  /**\n   * Objects whose `type` equals `type`, with `properties` narrowed to the\n   * schema shape `S[T]`. Returns a fresh array (insertion order).\n   *\n   * The narrowing is a static convenience only - no runtime validation is\n   * performed (see {@link ObjectSchema}). On an unschematised layer this\n   * behaves like `query({ type })` with `TileProperties` properties.\n   */\n  public byType<T extends keyof S & string>(type: T): Array<TypedObject<S, T>> {\n    return this.objects.filter(object => object.type === type) as unknown as Array<TypedObject<S, T>>;\n  }\n\n  /**\n   * Objects of the given geometry {@link ObjectKind}, narrowed to that\n   * geometry's member type (e.g. `byKind(ObjectKind.Polygon)` yields\n   * {@link PolygonObject}s with their `points`). Returns a fresh array.\n   */\n  public byKind<K extends ObjectKind>(kind: K): Array<Extract<TileMapObject, { kind: K }>> {\n    return this.objects.filter(object => object.kind === kind) as Array<Extract<TileMapObject, { kind: K }>>;\n  }\n\n  /**\n   * Objects of `type` (typed as in {@link byType}) that also satisfy\n   * `predicate`. A convenience combination of {@link byType} and `Array.filter`\n   * that keeps the narrowed `properties` type inside the predicate. Returns a\n   * fresh array.\n   */\n  public where<T extends keyof S & string>(type: T, predicate: (object: TypedObject<S, T>) => boolean): Array<TypedObject<S, T>> {\n    return this.byType(type).filter(object => predicate(object));\n  }\n\n  /** First object with the given id, or undefined. */\n  public getObjectById(id: number): TileMapObject | undefined {\n    return this.objects.find(object => object.id === id);\n  }\n\n  /** First object with the given name, or undefined. */\n  public getObjectByName(name: string): TileMapObject | undefined {\n    return this.objects.find(object => object.name === name);\n  }\n}\n"],"mappings":"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"}