@codexo/exojs-tiled 0.12.0 → 0.14.0

package/dist/esm/TiledMap.js

@@ -1,50 +1,389 @@
-// ---------------------------------------------------------------------------
-// TiledMap runtime object
-// ---------------------------------------------------------------------------
+import { TextureRegion } from '@codexo/exojs';
+import { TileSet, TileMap, TileLayer, ObjectLayer } from '@codexo/exojs-tilemap';
+import { maskTiledGid, TILED_FLIPPED_DIAGONALLY_FLAG, TILED_FLIPPED_VERTICALLY_FLAG, TILED_FLIPPED_HORIZONTALLY_FLAG } from './gid.js';
+import { createTiledLayer, TiledGroupLayer, TiledTileLayer, TiledObjectLayer } from './TiledLayer.js';
+import { TiledFormatError } from './validate.js';
+
 /**
- * Runtime representation of a loaded Tiled map.
+ * A parsed and validated Tiled map (`.tmj`).
  *
- * Exposes map metadata, layers, and tileset textures. Tileset textures
- * are owned by the Loader cache — `TiledMap.destroy()` does NOT destroy them.
+ * `TiledMap` represents the parsed Tiled source format. `TileMap` is the
+ * format-independent ExoJS runtime map used for rendering, queries, and
+ * mutation.
  *
- * Only the initial proof scope is implemented: orthogonal tile layers,
- * basic tilesets, and basic object layers. TMX/XML, infinite maps, and
- * world streaming are not supported.
+ * Construction validates that {@link tilesets} cover a non-overlapping,
+ * duplicate-free range of global tile ids, and that every GID referenced by
+ * {@link layers} (tile layer cells, infinite-map chunks, and tile object
+ * `gid`s) falls within one of those ranges. Both checks throw
+ * {@link TiledFormatError} on failure.
  */
 class TiledMap {
+    /** Resolved URL this map was loaded from. */
+    source;
+    /** The validated raw map data this instance was built from. */
     data;
-    tilesetTextures;
+    orientation;
+    renderOrder;
+    class;
+    /** Map width in tiles. */
     width;
+    /** Map height in tiles. */
     height;
+    /** Tile grid cell width in pixels. */
     tileWidth;
+    /** Tile grid cell height in pixels. */
     tileHeight;
+    infinite;
+    backgroundColor;
     layers;
+    /** Tilesets used by this map, sorted by {@link TiledTileset.firstGid} ascending. */
     tilesets;
-    constructor(data, tilesetTextures) {
+    properties;
+    constructor(source, data, tilesets) {
+        this.source = source;
         this.data = data;
-        this.tilesetTextures = tilesetTextures;
+        this.orientation = data.orientation;
+        this.renderOrder = data.renderorder;
+        this.class = data.class ?? '';
         this.width = data.width;
         this.height = data.height;
         this.tileWidth = data.tilewidth;
         this.tileHeight = data.tileheight;
-        this.layers = data.layers;
-        this.tilesets = data.tilesets;
+        this.infinite = data.infinite;
+        this.backgroundColor = data.backgroundcolor;
+        this.properties = data.properties ?? [];
+        this.layers = data.layers.map(createTiledLayer);
+        this.tilesets = sortAndValidateTilesetRanges(tilesets, source);
+        checkGidCoverage(this, source);
     }
-    /** Tile layers only. */
-    get tileLayers() {
-        return this.layers.filter(l => l.type === 'tilelayer');
+    /**
+     * Returns the tileset that owns `gid`, or `undefined` if `gid` is `0`
+     * (the empty-cell sentinel) or is not covered by any tileset.
+     *
+     * Flip/rotation flag bits are masked off before the range lookup, so the
+     * raw GID values found in {@link TiledTileLayer.data}/`chunks` and
+     * {@link TiledObject.gid} can be passed directly.
+     */
+    findTilesetForGid(gid) {
+        const id = maskTiledGid(gid);
+        if (id === 0) {
+            return undefined;
+        }
+        for (const tileset of this.tilesets) {
+            if (id >= tileset.firstGid && id <= tileset.lastGid) {
+                return tileset;
+            }
+        }
+        return undefined;
     }
-    /** Object group layers only. */
-    get objectLayers() {
-        return this.layers.filter(l => l.type === 'objectgroup');
+    /** Looks up a custom property by name. */
+    getProperty(name) {
+        return this.properties.find(property => property.name === name);
     }
     /**
-     * Destroy this TiledMap. Does NOT destroy tileset textures — they are
-     * owned by the Loader's cache and may be shared with other callers.
+     * Convert this parsed Tiled source model into a format-independent runtime
+     * {@link TileMap} from `@codexo/exojs-tilemap`.
+     *
+     * Only finite orthogonal maps with atlas tilesets are supported. A
+     * non-orthogonal or infinite map, or a collection-of-images tileset, throws
+     * {@link TiledFormatError} rather than silently producing wrong (misplaced)
+     * or empty geometry. Tile layers become renderable `TileLayer`s and object
+     * groups become data-only `ObjectLayer`s; group layer children are flattened
+     * in document order. Image layers are not yet converted.
+     *
+     * The returned `TileMap` does **not** own the tileset textures — they remain
+     * in the Loader cache. Destroying the returned map does not unload textures.
+     */
+    toTileMap() {
+        // The runtime TileMap is finite + orthogonal in this release. Reject maps
+        // we cannot convert faithfully rather than silently producing misplaced
+        // (isometric/staggered/hexagonal) or empty (infinite/chunked) geometry.
+        if (this.orientation !== 'orthogonal') {
+            throw new TiledFormatError(this.source, 'orientation', `toTileMap() supports only orthogonal maps in this release, got "${this.orientation}"`);
+        }
+        if (this.infinite) {
+            throw new TiledFormatError(this.source, 'infinite', 'toTileMap() supports only finite maps in this release; infinite (chunked) maps are not yet convertible');
+        }
+        // Build runtime tilesets. Tilesets with a per-tile image collection are
+        // not yet supported; collection-of-images tilesets throw TiledFormatError.
+        // Tilesets with no image at all (no texture, no tileTextures) are silently
+        // skipped — their cells appear as empty in the runtime layer.
+        const runtimeTilesets = [];
+        // indexToRuntime[i] = runtime TileSet for tilesets[i], or null if skipped.
+        const indexToRuntime = [];
+        for (let i = 0; i < this.tilesets.length; i++) {
+            const tiledTs = this.tilesets[i];
+            if (!tiledTs) {
+                indexToRuntime.push(null);
+                continue;
+            }
+            if (!tiledTs.texture) {
+                if (tiledTs.tileTextures.size > 0) {
+                    throw new TiledFormatError(this.source, `tilesets/${tiledTs.name}`, `tileset "${tiledTs.name}" is a collection-of-images tileset; ` +
+                        `toTileMap() requires atlas tilesets in this release`);
+                }
+                // No atlas image and no per-tile images → skip; cells become empty.
+                indexToRuntime.push(null);
+                continue;
+            }
+            const tw = tiledTs.imageWidth ?? tiledTs.texture.width;
+            const th = tiledTs.imageHeight ?? tiledTs.texture.height;
+            const region = new TextureRegion(tiledTs.texture, { x: 0, y: 0, width: tw, height: th });
+            const rts = new TileSet({
+                name: tiledTs.name,
+                texture: region,
+                tileWidth: tiledTs.tileWidth,
+                tileHeight: tiledTs.tileHeight,
+                tileCount: tiledTs.tileCount,
+                columns: tiledTs.columns,
+                spacing: tiledTs.spacing,
+                margin: tiledTs.margin,
+            });
+            runtimeTilesets.push(rts);
+            indexToRuntime.push(rts);
+        }
+        // Collect and convert tile + object layers, flattening group layers.
+        const runtimeLayers = [];
+        const runtimeObjectLayers = [];
+        const convertLayers = (layers) => {
+            for (const layer of layers) {
+                if (layer instanceof TiledGroupLayer) {
+                    convertLayers(layer.layers);
+                }
+                else if (layer instanceof TiledTileLayer) {
+                    const rLayer = new TileLayer({
+                        id: layer.id,
+                        name: layer.name,
+                        width: layer.width,
+                        height: layer.height,
+                        tilesets: runtimeTilesets,
+                        tileWidth: this.tileWidth,
+                        tileHeight: this.tileHeight,
+                        visible: layer.visible,
+                        opacity: layer.opacity,
+                        offsetX: layer.offsetX,
+                        offsetY: layer.offsetY,
+                    });
+                    if (layer.data) {
+                        populateTileLayer(rLayer, layer.data, this.tilesets, indexToRuntime);
+                    }
+                    runtimeLayers.push(rLayer);
+                }
+                else if (layer instanceof TiledObjectLayer) {
+                    runtimeObjectLayers.push(convertObjectLayer(layer, this.tilesets, indexToRuntime));
+                }
+                // ImageLayer: not yet converted.
+            }
+        };
+        convertLayers(this.layers);
+        return new TileMap({
+            name: this.source,
+            width: this.width,
+            height: this.height,
+            tileWidth: this.tileWidth,
+            tileHeight: this.tileHeight,
+            tilesets: runtimeTilesets,
+            layers: runtimeLayers,
+            objectLayers: runtimeObjectLayers,
+        });
+    }
+    /**
+     * Releases this map's reference to its parsed source. Tileset textures are
+     * Loader-owned and may be shared with other maps; this does NOT destroy
+     * them.
      */
     destroy() {
-        // Intentionally empty: tileset textures are Loader-owned.
+        // Intentionally empty: all sub-resources (textures) are Loader-owned.
+    }
+}
+/**
+ * Resolve a raw (flag-bearing) Tiled GID to a runtime {@link ResolvedTile}, or
+ * `null` for an empty cell or a GID whose tileset was skipped (no atlas image).
+ */
+function resolveGid(rawGid, tiledTilesets, indexToRuntime) {
+    if (rawGid === 0)
+        return null;
+    const baseGid = maskTiledGid(rawGid);
+    const transform = {
+        flipX: (rawGid >>> 0 & TILED_FLIPPED_HORIZONTALLY_FLAG) !== 0,
+        flipY: (rawGid >>> 0 & TILED_FLIPPED_VERTICALLY_FLAG) !== 0,
+        diagonal: (rawGid >>> 0 & TILED_FLIPPED_DIAGONALLY_FLAG) !== 0,
+    };
+    // Find owning tileset: rightmost with firstGid <= baseGid (tilesets sorted asc).
+    let tsIdx = -1;
+    for (let t = tiledTilesets.length - 1; t >= 0; t--) {
+        const candidate = tiledTilesets[t];
+        if (candidate && baseGid >= candidate.firstGid) {
+            tsIdx = t;
+            break;
+        }
+    }
+    if (tsIdx === -1)
+        return null;
+    const owningTs = tiledTilesets[tsIdx];
+    const runtimeTs = indexToRuntime[tsIdx];
+    if (!owningTs || !runtimeTs)
+        return null; // tileset was skipped (no atlas image)
+    return {
+        tileset: runtimeTs,
+        localTileId: baseGid - owningTs.firstGid,
+        transform,
+    };
+}
+/** Fill a `TileLayer` from a flat GID array decoded from a Tiled tile layer. */
+function populateTileLayer(layer, gids, tiledTilesets, indexToRuntime) {
+    for (let i = 0; i < gids.length; i++) {
+        const gid = gids[i];
+        if (gid === undefined)
+            continue;
+        const tile = resolveGid(gid, tiledTilesets, indexToRuntime);
+        if (!tile)
+            continue;
+        layer.setTileAt(i % layer.width, Math.floor(i / layer.width), tile);
+    }
+}
+/** Convert a parsed `TiledObjectLayer` into a runtime data-only `ObjectLayer`. */
+function convertObjectLayer(layer, tiledTilesets, indexToRuntime) {
+    const objects = [];
+    for (const object of layer.objects) {
+        const converted = convertObject(object, tiledTilesets, indexToRuntime);
+        if (converted)
+            objects.push(converted);
+    }
+    return new ObjectLayer({
+        id: layer.id,
+        name: layer.name,
+        class: layer.class,
+        visible: layer.visible,
+        opacity: layer.opacity,
+        offsetX: layer.offsetX,
+        offsetY: layer.offsetY,
+        objects,
+        properties: convertProperties(layer.properties),
+    });
+}
+/**
+ * Convert one `TiledObject` to a `TileMapObject`. Text objects (and tile
+ * objects whose tileset was skipped) are dropped — returns `null`.
+ */
+function convertObject(object, tiledTilesets, indexToRuntime) {
+    if (object.text) {
+        return null; // text objects are not represented in the data-only model
+    }
+    const base = {
+        id: object.id,
+        name: object.name,
+        type: object.type,
+        x: object.x,
+        y: object.y,
+        width: object.width,
+        height: object.height,
+        rotation: object.rotation,
+        visible: object.visible,
+        properties: convertProperties(object.properties),
+    };
+    if (object.gid !== undefined) {
+        const tile = resolveGid(object.gid, tiledTilesets, indexToRuntime);
+        if (!tile)
+            return null;
+        return { ...base, kind: 'tile', tile };
+    }
+    if (object.point) {
+        return { ...base, kind: 'point' };
+    }
+    if (object.ellipse) {
+        return { ...base, kind: 'ellipse' };
+    }
+    if (object.polygon) {
+        return { ...base, kind: 'polygon', points: toPoints(object.polygon) };
     }
+    if (object.polyline) {
+        return { ...base, kind: 'polyline', points: toPoints(object.polyline) };
+    }
+    return { ...base, kind: 'rectangle' };
+}
+const toPoints = (points) => points.map(p => ({ x: p.x, y: p.y }));
+/**
+ * Project Tiled custom properties to the generic flat property bag. Class /
+ * object-valued properties are not representable and are skipped.
+ */
+function convertProperties(properties) {
+    if (properties.length === 0)
+        return Object.freeze({});
+    const out = {};
+    for (const property of properties) {
+        const value = property.value;
+        if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') {
+            out[property.name] = value;
+        }
+    }
+    return Object.freeze(out);
+}
+function sortAndValidateTilesetRanges(tilesets, source) {
+    const sorted = [...tilesets].sort((a, b) => a.firstGid - b.firstGid);
+    for (let i = 1; i < sorted.length; i++) {
+        const previous = sorted[i - 1];
+        const current = sorted[i];
+        if (previous === undefined || current === undefined)
+            continue;
+        if (current.firstGid === previous.firstGid) {
+            throw new TiledFormatError(source, 'tilesets', `duplicate firstgid ${current.firstGid} (tilesets "${previous.name}" and "${current.name}")`);
+        }
+        if (current.firstGid <= previous.lastGid) {
+            throw new TiledFormatError(source, 'tilesets', `tileset "${current.name}" (firstgid ${current.firstGid}) overlaps tileset "${previous.name}" (firstgid ${previous.firstGid}, last gid ${previous.lastGid})`);
+        }
+    }
+    return sorted;
+}
+function walkLayers(layers, path, visit) {
+    for (let i = 0; i < layers.length; i++) {
+        const layer = layers[i];
+        if (layer === undefined)
+            continue;
+        const layerPath = `${path}[${i}]`;
+        visit(layer, layerPath);
+        if (layer instanceof TiledGroupLayer) {
+            walkLayers(layer.layers, `${layerPath}.layers`, visit);
+        }
+    }
+}
+function checkGidArray(gids, map, source, path) {
+    for (let i = 0; i < gids.length; i++) {
+        const gid = gids[i];
+        if (gid === undefined)
+            continue;
+        if (gid !== 0 && map.findTilesetForGid(gid) === undefined) {
+            throw new TiledFormatError(source, `${path}[${i}]`, `gid ${gid} (masked: ${maskTiledGid(gid)}) is not covered by any tileset`);
+        }
+    }
+}
+function checkGidCoverage(map, source) {
+    walkLayers(map.layers, 'layers', (layer, layerPath) => {
+        if (layer instanceof TiledTileLayer) {
+            if (layer.data !== undefined) {
+                checkGidArray(layer.data, map, source, `${layerPath}.data`);
+            }
+            if (layer.chunks !== undefined) {
+                for (let c = 0; c < layer.chunks.length; c++) {
+                    const chunk = layer.chunks[c];
+                    if (chunk === undefined)
+                        continue;
+                    checkGidArray(chunk.data, map, source, `${layerPath}.chunks[${c}].data`);
+                }
+            }
+        }
+        else if (layer instanceof TiledObjectLayer) {
+            for (let o = 0; o < layer.objects.length; o++) {
+                const object = layer.objects[o];
+                if (object === undefined)
+                    continue;
+                const gid = object.gid;
+                if (gid !== undefined && map.findTilesetForGid(gid) === undefined) {
+                    throw new TiledFormatError(source, `${layerPath}.objects[${o}].gid`, `gid ${gid} (masked: ${maskTiledGid(gid)}) is not covered by any tileset`);
+                }
+            }
+        }
+    });
 }
 
 export { TiledMap };

package/dist/esm/TiledMap.js.map

@@ -1 +1 @@
-{"version":3,"file":"TiledMap.js","sources":["../../../src/TiledMap.ts"],"sourcesContent":[null],"names":[],"mappings":"AAoEA;AACA;AACA;AAEA;;;;;;;;;AASG;MACU,QAAQ,CAAA;AACH,IAAA,IAAI;AACJ,IAAA,eAAe;AAEf,IAAA,KAAK;AACL,IAAA,MAAM;AACN,IAAA,SAAS;AACT,IAAA,UAAU;AAEV,IAAA,MAAM;AACN,IAAA,QAAQ;IAExB,WAAA,CAAmB,IAAkB,EAAE,eAAmC,EAAA;AACxE,QAAA,IAAI,CAAC,IAAI,GAAG,IAAI;AAChB,QAAA,IAAI,CAAC,eAAe,GAAG,eAAe;AACtC,QAAA,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK;AACvB,QAAA,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM;AACzB,QAAA,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS;AAC/B,QAAA,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU;AACjC,QAAA,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM;AACzB,QAAA,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ;IAC/B;;AAGA,IAAA,IAAW,UAAU,GAAA;AACnB,QAAA,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC;IACxD;;AAGA,IAAA,IAAW,YAAY,GAAA;AACrB,QAAA,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,aAAa,CAAC;IAC1D;AAEA;;;AAGG;IACI,OAAO,GAAA;;IAEd;AACD;;;;"}
+{"version":3,"file":"TiledMap.js","sources":["../../../src/TiledMap.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/TiledObject.d.ts

@@ -0,0 +1,32 @@
+import type { TiledObjectData, TiledPointData, TiledPropertyData, TiledTextData } from './data';
+/**
+ * A parsed Tiled object, placed in an {@link TiledObjectLayer} or a tile's
+ * collision `objectgroup`.
+ *
+ * The shape of the object is determined by which of {@link point},
+ * {@link ellipse}, {@link polygon}, {@link polyline}, {@link text}, or
+ * {@link gid} is set; if none are set, the object is a plain rectangle
+ * spanning `[x, y, width, height]`.
+ */
+export declare class TiledObject {
+    readonly id: number;
+    readonly name: string;
+    readonly type: string;
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+    readonly rotation: number;
+    readonly visible: boolean;
+    readonly gid?: number | undefined;
+    readonly point: boolean;
+    readonly ellipse: boolean;
+    readonly polygon?: readonly TiledPointData[] | undefined;
+    readonly polyline?: readonly TiledPointData[] | undefined;
+    readonly text?: TiledTextData | undefined;
+    readonly template?: string | undefined;
+    readonly properties: readonly TiledPropertyData[];
+    constructor(data: TiledObjectData);
+    /** Looks up a custom property by name. */
+    getProperty(name: string): TiledPropertyData | undefined;
+}

package/dist/esm/TiledObject.js

@@ -0,0 +1,54 @@
+/**
+ * A parsed Tiled object, placed in an {@link TiledObjectLayer} or a tile's
+ * collision `objectgroup`.
+ *
+ * The shape of the object is determined by which of {@link point},
+ * {@link ellipse}, {@link polygon}, {@link polyline}, {@link text}, or
+ * {@link gid} is set; if none are set, the object is a plain rectangle
+ * spanning `[x, y, width, height]`.
+ */
+class TiledObject {
+    id;
+    name;
+    type;
+    x;
+    y;
+    width;
+    height;
+    rotation;
+    visible;
+    gid;
+    point;
+    ellipse;
+    polygon;
+    polyline;
+    text;
+    template;
+    properties;
+    constructor(data) {
+        this.id = data.id;
+        this.name = data.name;
+        this.type = data.type;
+        this.x = data.x;
+        this.y = data.y;
+        this.width = data.width;
+        this.height = data.height;
+        this.rotation = data.rotation;
+        this.visible = data.visible;
+        this.gid = data.gid;
+        this.point = data.point ?? false;
+        this.ellipse = data.ellipse ?? false;
+        this.polygon = data.polygon;
+        this.polyline = data.polyline;
+        this.text = data.text;
+        this.template = data.template;
+        this.properties = data.properties ?? [];
+    }
+    /** Looks up a custom property by name. */
+    getProperty(name) {
+        return this.properties.find(property => property.name === name);
+    }
+}
+
+export { TiledObject };
+//# sourceMappingURL=TiledObject.js.map

package/dist/esm/TiledObject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TiledObject.js","sources":["../../../src/TiledObject.ts"],"sourcesContent":[null],"names":[],"mappings":"AAEA;;;;;;;;AAQG;MACU,WAAW,CAAA;AACN,IAAA,EAAE;AACF,IAAA,IAAI;AACJ,IAAA,IAAI;AACJ,IAAA,CAAC;AACD,IAAA,CAAC;AACD,IAAA,KAAK;AACL,IAAA,MAAM;AACN,IAAA,QAAQ;AACR,IAAA,OAAO;AACP,IAAA,GAAG;AACH,IAAA,KAAK;AACL,IAAA,OAAO;AACP,IAAA,OAAO;AACP,IAAA,QAAQ;AACR,IAAA,IAAI;AACJ,IAAA,QAAQ;AACR,IAAA,UAAU;AAE1B,IAAA,WAAA,CAAmB,IAAqB,EAAA;AACtC,QAAA,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE;AACjB,QAAA,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI;AACrB,QAAA,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI;AACrB,QAAA,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AACf,QAAA,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AACf,QAAA,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK;AACvB,QAAA,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM;AACzB,QAAA,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ;AAC7B,QAAA,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO;AAC3B,QAAA,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG;QACnB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,KAAK;QAChC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,KAAK;AACpC,QAAA,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO;AAC3B,QAAA,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ;AAC7B,QAAA,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI;AACrB,QAAA,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ;QAC7B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,EAAE;IACzC;;AAGO,IAAA,WAAW,CAAC,IAAY,EAAA;AAC7B,QAAA,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,IAAI,KAAK,IAAI,CAAC;IACjE;AACD;;;;"}

package/dist/esm/TiledTileset.d.ts

@@ -0,0 +1,59 @@
+import type { Texture } from '@codexo/exojs';
+import type { TiledPointData, TiledPropertyData, TiledTileData, TiledTilesetData } from './data';
+/**
+ * Loader-resolved resources for a {@link TiledTileset}: the absolute image
+ * URL(s) and the {@link Texture} instance(s) loaded for them. All textures
+ * are owned by the `Loader` cache — a {@link TiledTileset} never destroys
+ * them.
+ */
+export interface TiledTilesetResources {
+    /** Resolved URL of the external `.tsj` file, or `undefined` for an embedded tileset. */
+    readonly source?: string | undefined;
+    /** Resolved URL of the tileset's atlas {@link TiledTilesetData.image}, or `undefined` for a collection-of-images tileset. */
+    readonly imageUrl?: string | undefined;
+    /** Texture loaded for {@link imageUrl}. */
+    readonly texture?: Texture | undefined;
+    /** Textures loaded for collection-of-images {@link TiledTileData.image} entries, keyed by local tile id. */
+    readonly tileTextures?: ReadonlyMap<number, Texture> | undefined;
+}
+/**
+ * A parsed Tiled tileset — either embedded inline in a map's `tilesets`
+ * array, or parsed from an external `.tsj` file referenced by it.
+ *
+ * {@link firstGid} and {@link lastGid} define the inclusive range of global
+ * tile ids (after masking flip/rotation flags via `maskTiledGid`) that this
+ * tileset owns within its owning {@link TiledMap}.
+ */
+export declare class TiledTileset {
+    /** First global tile id owned by this tileset. */
+    readonly firstGid: number;
+    /** Resolved URL of the external `.tsj` file, or `undefined` for an embedded tileset. */
+    readonly source?: string | undefined;
+    readonly name: string;
+    readonly class: string;
+    readonly tileWidth: number;
+    readonly tileHeight: number;
+    readonly tileCount: number;
+    readonly columns: number;
+    readonly spacing: number;
+    readonly margin: number;
+    /** Resolved URL of the tileset's atlas image, or `undefined` for a collection-of-images tileset. */
+    readonly imageUrl?: string | undefined;
+    readonly imageWidth?: number | undefined;
+    readonly imageHeight?: number | undefined;
+    /** Texture loaded for {@link imageUrl}. Loader-owned; not destroyed by {@link TiledMap.destroy}. */
+    readonly texture?: Texture | undefined;
+    readonly tileOffset: TiledPointData;
+    readonly objectAlignment?: string | undefined;
+    readonly tiles: readonly TiledTileData[];
+    /** Textures loaded for collection-of-images tiles, keyed by local tile id. Loader-owned. */
+    readonly tileTextures: ReadonlyMap<number, Texture>;
+    readonly properties: readonly TiledPropertyData[];
+    constructor(data: TiledTilesetData, firstGid: number, resources?: TiledTilesetResources);
+    /** Last global tile id (inclusive) owned by this tileset. Empty (`lastGid < firstGid`) when {@link tileCount} is `0`. */
+    get lastGid(): number;
+    /** Looks up a per-tile definition by local tile id. */
+    getTile(localId: number): TiledTileData | undefined;
+    /** Looks up a custom property by name. */
+    getProperty(name: string): TiledPropertyData | undefined;
+}

package/dist/esm/TiledTileset.js

@@ -0,0 +1,70 @@
+/**
+ * A parsed Tiled tileset — either embedded inline in a map's `tilesets`
+ * array, or parsed from an external `.tsj` file referenced by it.
+ *
+ * {@link firstGid} and {@link lastGid} define the inclusive range of global
+ * tile ids (after masking flip/rotation flags via `maskTiledGid`) that this
+ * tileset owns within its owning {@link TiledMap}.
+ */
+class TiledTileset {
+    /** First global tile id owned by this tileset. */
+    firstGid;
+    /** Resolved URL of the external `.tsj` file, or `undefined` for an embedded tileset. */
+    source;
+    name;
+    class;
+    tileWidth;
+    tileHeight;
+    tileCount;
+    columns;
+    spacing;
+    margin;
+    /** Resolved URL of the tileset's atlas image, or `undefined` for a collection-of-images tileset. */
+    imageUrl;
+    imageWidth;
+    imageHeight;
+    /** Texture loaded for {@link imageUrl}. Loader-owned; not destroyed by {@link TiledMap.destroy}. */
+    texture;
+    tileOffset;
+    objectAlignment;
+    tiles;
+    /** Textures loaded for collection-of-images tiles, keyed by local tile id. Loader-owned. */
+    tileTextures;
+    properties;
+    constructor(data, firstGid, resources = {}) {
+        this.firstGid = firstGid;
+        this.source = resources.source;
+        this.name = data.name;
+        this.class = data.class ?? '';
+        this.tileWidth = data.tilewidth;
+        this.tileHeight = data.tileheight;
+        this.tileCount = data.tilecount;
+        this.columns = data.columns;
+        this.spacing = data.spacing ?? 0;
+        this.margin = data.margin ?? 0;
+        this.imageUrl = resources.imageUrl;
+        this.imageWidth = data.imagewidth;
+        this.imageHeight = data.imageheight;
+        this.texture = resources.texture;
+        this.tileOffset = data.tileoffset ?? { x: 0, y: 0 };
+        this.objectAlignment = data.objectalignment;
+        this.tiles = data.tiles ?? [];
+        this.tileTextures = resources.tileTextures ?? new Map();
+        this.properties = data.properties ?? [];
+    }
+    /** Last global tile id (inclusive) owned by this tileset. Empty (`lastGid < firstGid`) when {@link tileCount} is `0`. */
+    get lastGid() {
+        return this.firstGid + this.tileCount - 1;
+    }
+    /** Looks up a per-tile definition by local tile id. */
+    getTile(localId) {
+        return this.tiles.find(tile => tile.id === localId);
+    }
+    /** Looks up a custom property by name. */
+    getProperty(name) {
+        return this.properties.find(property => property.name === name);
+    }
+}
+
+export { TiledTileset };
+//# sourceMappingURL=TiledTileset.js.map

package/dist/esm/TiledTileset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TiledTileset.js","sources":["../../../src/TiledTileset.ts"],"sourcesContent":[null],"names":[],"mappings":"AAqBA;;;;;;;AAOG;MACU,YAAY,CAAA;;AAEP,IAAA,QAAQ;;AAER,IAAA,MAAM;AACN,IAAA,IAAI;AACJ,IAAA,KAAK;AACL,IAAA,SAAS;AACT,IAAA,UAAU;AACV,IAAA,SAAS;AACT,IAAA,OAAO;AACP,IAAA,OAAO;AACP,IAAA,MAAM;;AAEN,IAAA,QAAQ;AACR,IAAA,UAAU;AACV,IAAA,WAAW;;AAEX,IAAA,OAAO;AACP,IAAA,UAAU;AACV,IAAA,eAAe;AACf,IAAA,KAAK;;AAEL,IAAA,YAAY;AACZ,IAAA,UAAU;AAE1B,IAAA,WAAA,CAAmB,IAAsB,EAAE,QAAgB,EAAE,YAAmC,EAAE,EAAA;AAChG,QAAA,IAAI,CAAC,QAAQ,GAAG,QAAQ;AACxB,QAAA,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM;AAC9B,QAAA,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI;QACrB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE;AAC7B,QAAA,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS;AAC/B,QAAA,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU;AACjC,QAAA,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS;AAC/B,QAAA,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO;QAC3B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,CAAC;QAChC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC;AAC9B,QAAA,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC,QAAQ;AAClC,QAAA,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU;AACjC,QAAA,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW;AACnC,QAAA,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC,OAAO;AAChC,QAAA,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;AACnD,QAAA,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,eAAe;QAC3C,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE;QAC7B,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC,YAAY,IAAI,IAAI,GAAG,EAAE;QACvD,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,EAAE;IACzC;;AAGA,IAAA,IAAW,OAAO,GAAA;QAChB,OAAO,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,SAAS,GAAG,CAAC;IAC3C;;AAGO,IAAA,OAAO,CAAC,OAAe,EAAA;AAC5B,QAAA,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE,KAAK,OAAO,CAAC;IACrD;;AAGO,IAAA,WAAW,CAAC,IAAY,EAAA;AAC7B,QAAA,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,IAAI,KAAK,IAAI,CAAC;IACjE;AACD;;;;"}