@codexo/exojs-tilemap 0.13.0

package/dist/esm/TileMapView.js

@@ -0,0 +1,342 @@
+import { assertPixelSnapMode } from './pixelSnap.js';
+import { TileLayerNode } from './TileLayerNode.js';
+import { TileMapBand } from './TileMapBand.js';
+
+/**
+ * Groups a {@link TileMap}'s layers into independently placeable scene nodes so
+ * application actors can be interleaved **between** tile layers.
+ *
+ * A view produces exactly one canonical {@link TileLayerNode} per map layer
+ * (stable identity, map document order) and, optionally, named {@link TileMapBand}s
+ * grouping subsets of those nodes. The application parents the bands / layer
+ * nodes wherever it wants — typically as siblings of its own actor containers:
+ *
+ * ```ts
+ * const view = map.createView({ bands: { ground: ['background', 'ground'], roof: ['roofs'] } });
+ * worldRoot.addChild(view.band('ground'), actors, view.band('roof'));
+ * // or without bands:
+ * worldRoot.addChild(view.getLayerNodeById(groundId)!, actors, view.getLayerNodeById(roofId)!);
+ * ```
+ *
+ * **Actors are application-owned siblings.** A `TileMapView` never adopts or
+ * destroys actors. The view is a helper, not a scene node — it does not own the
+ * world container, the {@link TileMap}, the {@link TileLayer}s, or tileset
+ * textures.
+ *
+ * **Ownership:** the view owns its generated layer nodes and bands. A layer
+ * assigned to a band is owned by that band; an unbanded layer is owned by the
+ * view directly. {@link TileMapView.destroy} destroys every band and layer node
+ * (detaching them from their application parents) but leaves actors, the map,
+ * its layers, and Loader-owned textures untouched. There is no map-replacement
+ * mutation API: to swap maps, destroy the old view, construct a new one, and
+ * re-parent its bands — the actor tree is never involved.
+ *
+ * @advanced
+ */
+class TileMapView {
+    _map;
+    _cullable;
+    /** All canonical layer nodes, in map document order. */
+    _layerNodes = [];
+    /** Layer id → its canonical layer node. */
+    _layerNodeById = new Map();
+    /** Bands in definition (insertion) order. */
+    _bands = [];
+    /** Band name → band. */
+    _bandByName = new Map();
+    /** Original band definitions (frozen) for re-resolution on refresh. */
+    _bandDefs = [];
+    /** Layer node → its owning band (absent = view-owned / unbanded). */
+    _nodeBand = new Map();
+    /** Unbanded layer nodes owned directly by the view, in map document order. */
+    _directLayerNodes = [];
+    _destroyed = false;
+    _pixelSnapMode = 'none';
+    /**
+     * @param map     The runtime map to compose. Referenced, never owned.
+     * @param options Band definitions and culling.
+     * @throws When a band definition references an unknown/ambiguous layer or
+     *         assigns a layer twice / to multiple bands.
+     */
+    constructor(map, options) {
+        this._map = map;
+        this._cullable = options?.cullable ?? true;
+        for (const layer of map.layers) {
+            const node = new TileLayerNode(layer, { cullable: this._cullable });
+            this._layerNodes.push(node);
+            this._layerNodeById.set(layer.id, node);
+        }
+        if (options?.bands) {
+            for (const [name, selectors] of Object.entries(options.bands)) {
+                this._defineBand(name, selectors);
+            }
+        }
+        for (const node of this._layerNodes) {
+            if (!this._nodeBand.has(node)) {
+                this._directLayerNodes.push(node);
+            }
+        }
+    }
+    /** The runtime map this view composes. Referenced, never owned. */
+    get map() {
+        return this._map;
+    }
+    /** All canonical layer nodes, one per map layer, in map document order. */
+    get layers() {
+        return this._layerNodes;
+    }
+    /** The bands, in definition (insertion) order. */
+    get bands() {
+        return this._bands;
+    }
+    /** Whether this view has been destroyed. */
+    get destroyed() {
+        return this._destroyed;
+    }
+    /**
+     * Render-only pixel-snap mode applied to every layer node this view owns (and
+     * forwarded to every chunk drawable, current and rebuilt by
+     * {@link refreshLayers}). Snaps tile chunk origins to the active render
+     * target's device-pixel grid for crisp tiles; with integer tile pitch the grid
+     * stays exact and adjacent chunks cannot drift apart. Purely visual — tile
+     * data, layer offsets, chunk revisions, and culling are unchanged. Setting the
+     * current value is a no-op; an invalid value throws and leaves the prior mode
+     * unchanged.
+     *
+     * @default 'none'
+     * @stable
+     */
+    get pixelSnapMode() {
+        return this._pixelSnapMode;
+    }
+    set pixelSnapMode(mode) {
+        if (mode === this._pixelSnapMode) {
+            return;
+        }
+        assertPixelSnapMode(mode);
+        this._pixelSnapMode = mode;
+        for (const node of this._layerNodes) {
+            node.pixelSnapMode = mode;
+        }
+    }
+    /**
+     * The canonical layer node for the layer with the given **id**, or
+     * `undefined`. Ids are authoritative and unique — this is the unambiguous
+     * lookup. The returned node may be reparented into the caller's own
+     * containers; the view still tracks it for refresh and destruction.
+     */
+    getLayerNodeById(id) {
+        return this._layerNodeById.get(id);
+    }
+    /**
+     * Every canonical layer node whose layer has the given **name**, in map
+     * document order. Layer names are not guaranteed unique, so this returns an
+     * array (empty when no layer matches). Prefer {@link getLayerNodeById} when
+     * you have the id.
+     */
+    getLayerNodesByName(name) {
+        return this._layerNodes.filter(node => node.layer.name === name);
+    }
+    /**
+     * The band registered under `name`.
+     * @throws If no band with that name was defined.
+     */
+    band(name) {
+        const band = this._bandByName.get(name);
+        if (!band) {
+            throw new Error(`TileMapView has no band named "${name}". Defined bands: ${this._bands.length ? this._bands.map(b => `"${b.name}"`).join(', ') : '(none)'}.`);
+        }
+        return band;
+    }
+    /** Whether a band with the given name was defined. */
+    hasBand(name) {
+        return this._bandByName.has(name);
+    }
+    /**
+     * Rebuild the view after **structural** map changes (layers added to or
+     * removed from the map). Ordinary tile edits and chunk creation/removal do
+     * NOT need this — those are handled by chunk revisions and
+     * {@link TileLayerNode.refresh} respectively.
+     *
+     * - Removed layers: their generated layer node is detached and destroyed.
+     * - Unchanged layers: keep their existing layer node (stable identity).
+     * - Added layers: a new layer node is created and assigned to the first band
+     *   whose definition selects it (by id, or by a currently-unambiguous name),
+     *   otherwise owned directly by the view.
+     * - Every band's children are re-ordered to map document order.
+     *
+     * Application actors are never touched, and bands keep their placement in the
+     * application scene graph.
+     *
+     * @throws If the view has been destroyed.
+     */
+    refreshLayers() {
+        if (this._destroyed) {
+            throw new Error('Cannot refresh a destroyed TileMapView.');
+        }
+        const currentLayers = this._map.layers;
+        const currentIds = new Set();
+        for (const layer of currentLayers) {
+            currentIds.add(layer.id);
+        }
+        // 1. Remove nodes whose layer no longer exists.
+        for (const node of [...this._layerNodes]) {
+            if (!currentIds.has(node.layer.id)) {
+                this._removeNode(node);
+            }
+        }
+        // 2. Re-derive the doc-ordered node list, creating + assigning new nodes.
+        const newOrder = [];
+        for (const layer of currentLayers) {
+            let node = this._layerNodeById.get(layer.id);
+            if (!node) {
+                node = new TileLayerNode(layer, { cullable: this._cullable });
+                if (this._pixelSnapMode !== 'none') {
+                    node.pixelSnapMode = this._pixelSnapMode;
+                }
+                this._layerNodeById.set(layer.id, node);
+                this._assignNewNode(node, layer);
+            }
+            newOrder.push(node);
+        }
+        this._layerNodes.length = 0;
+        this._layerNodes.push(...newOrder);
+        // 3. Re-order each band's children to map document order.
+        const documentIndexById = new Map();
+        for (const [index, layer] of currentLayers.entries())
+            documentIndexById.set(layer.id, index);
+        for (const band of this._bands) {
+            band._reorder(documentIndexById);
+        }
+        // 4. Rebuild the unbanded set in doc order.
+        this._directLayerNodes.length = 0;
+        for (const node of newOrder) {
+            if (!this._nodeBand.has(node)) {
+                this._directLayerNodes.push(node);
+            }
+        }
+        return this;
+    }
+    /**
+     * Destroy the view: every band and generated layer node is destroyed (and
+     * detached from its application parent), freeing cached chunk geometry.
+     * Idempotent. Application actors, sibling content, the {@link TileMap}, its
+     * {@link TileLayer}s, and Loader-owned tileset textures all survive.
+     */
+    destroy() {
+        if (this._destroyed) {
+            return;
+        }
+        this._destroyed = true;
+        for (const band of this._bands) {
+            band.destroy();
+        }
+        for (const node of this._directLayerNodes) {
+            node.parent?.removeChild(node);
+            node.destroy();
+        }
+        this._bands.length = 0;
+        this._bandByName.clear();
+        this._bandDefs.length = 0;
+        this._directLayerNodes.length = 0;
+        this._layerNodes.length = 0;
+        this._layerNodeById.clear();
+        this._nodeBand.clear();
+    }
+    // ── Internals ──────────────────────────────────────────────────────────
+    /** Resolve one band definition into a {@link TileMapBand} and record it. */
+    _defineBand(name, selectors) {
+        const memberIds = new Set();
+        for (const selector of selectors) {
+            const id = this._resolveSelector(name, selector);
+            if (memberIds.has(id)) {
+                throw new Error(`TileMapView band "${name}" lists layer ${id} more than once.`);
+            }
+            const existing = this._layerNodeById.get(id);
+            if (existing && this._nodeBand.has(existing)) {
+                throw new Error(`TileMapView layer ${id} is assigned to multiple bands ` +
+                    `("${this._nodeBand.get(existing).name}" and "${name}").`);
+            }
+            memberIds.add(id);
+        }
+        // Order members by map document order (membership selects; doc order renders).
+        const orderedNodes = this._layerNodes.filter(node => memberIds.has(node.layer.id));
+        const band = new TileMapBand(name, orderedNodes);
+        for (const node of orderedNodes) {
+            this._nodeBand.set(node, band);
+        }
+        this._bands.push(band);
+        this._bandByName.set(name, band);
+        this._bandDefs.push({ name, selectors: Object.freeze([...selectors]) });
+    }
+    /** Resolve a single selector to a layer id, throwing on unknown/ambiguous. */
+    _resolveSelector(bandName, selector) {
+        if (typeof selector === 'number') {
+            if (!this._layerNodeById.has(selector)) {
+                throw new Error(`TileMapView band "${bandName}": no layer with id ${selector} in map "${this._map.name}".`);
+            }
+            return selector;
+        }
+        const matches = this._map.layers.filter(layer => layer.name === selector);
+        if (matches.length === 0) {
+            throw new Error(`TileMapView band "${bandName}": no layer named "${selector}" in map "${this._map.name}".`);
+        }
+        if (matches.length > 1) {
+            throw new Error(`TileMapView band "${bandName}": layer name "${selector}" is ambiguous ` +
+                `(${matches.length} layers share it); reference it by id instead.`);
+        }
+        return matches[0].id;
+    }
+    /** Assign a freshly created node to the first band that selects its layer. */
+    _assignNewNode(node, layer) {
+        for (const def of this._bandDefs) {
+            if (this._definitionSelects(def, layer)) {
+                const band = this._bandByName.get(def.name);
+                band._adopt(node);
+                this._nodeBand.set(node, band);
+                return;
+            }
+        }
+    }
+    /** Whether a band definition selects the given layer (unambiguously by name). */
+    _definitionSelects(def, layer) {
+        for (const selector of def.selectors) {
+            if (typeof selector === 'number') {
+                if (selector === layer.id) {
+                    return true;
+                }
+            }
+            else if (selector === layer.name) {
+                const sameName = this._map.layers.filter(other => other.name === selector).length;
+                if (sameName === 1) {
+                    return true;
+                }
+            }
+        }
+        return false;
+    }
+    /** Detach + destroy a node, dropping it from band membership and registries. */
+    _removeNode(node) {
+        const band = this._nodeBand.get(node);
+        if (band) {
+            band._release(node);
+            this._nodeBand.delete(node);
+        }
+        else {
+            const directIndex = this._directLayerNodes.indexOf(node);
+            if (directIndex !== -1) {
+                this._directLayerNodes.splice(directIndex, 1);
+            }
+        }
+        node.parent?.removeChild(node);
+        this._layerNodeById.delete(node.layer.id);
+        const orderIndex = this._layerNodes.indexOf(node);
+        if (orderIndex !== -1) {
+            this._layerNodes.splice(orderIndex, 1);
+        }
+        node.destroy();
+    }
+}
+
+export { TileMapView };
+//# sourceMappingURL=TileMapView.js.map

package/dist/esm/TileMapView.js.map

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

package/dist/esm/TileSet.d.ts

@@ -0,0 +1,99 @@
+import type { TextureRegion } from '@codexo/exojs';
+import type { TileDefinition, TileProperties } from './types';
+/**
+ * Options for constructing a {@link TileSet}.
+ * @advanced
+ */
+export interface TileSetOptions {
+    /** Stable runtime name (unique within a {@link TileMap}). */
+    readonly name: string;
+    /** Texture atlas for this tileset. Textures are Loader-owned. */
+    readonly texture: TextureRegion;
+    /** Width of each tile in pixels. */
+    readonly tileWidth: number;
+    /** Height of each tile in pixels. */
+    readonly tileHeight: number;
+    /** Total number of tiles in this tileset. */
+    readonly tileCount: number;
+    /** Number of tile columns in the atlas grid. Computed from texture width / tileWidth if omitted. */
+    readonly columns?: number;
+    /** Pixel spacing between tiles in the atlas. Defaults to 0. */
+    readonly spacing?: number;
+    /** Pixel margin around the atlas. Defaults to 0. */
+    readonly margin?: number;
+}
+/**
+ * A resolved tileset: a uniform grid of tiles within a texture atlas.
+ *
+ * Does **not** own its texture — the Loader or application code retains
+ * texture ownership. Tileset dimensions are validated at construction and
+ * frozen thereafter.
+ *
+ * Multiple tilesets are supported per {@link TileMap}; each carries its own
+ * tile dimensions, spacing, and optional per-tile metadata.
+ * @advanced
+ */
+export declare class TileSet {
+    /** Stable runtime name. */
+    readonly name: string;
+    /** Atlas texture region — Loader-owned, never destroyed by the tileset. */
+    readonly texture: TextureRegion;
+    /** Tile width in pixels. */
+    readonly tileWidth: number;
+    /** Tile height in pixels. */
+    readonly tileHeight: number;
+    /** Total number of tiles in the tileset. */
+    readonly tileCount: number;
+    /** Number of columns in the atlas grid. */
+    readonly columns: number;
+    /** Number of rows implied by tileCount and columns. */
+    readonly rows: number;
+    /** Pixel spacing between tiles in the atlas. */
+    readonly spacing: number;
+    /** Pixel margin around the atlas. */
+    readonly margin: number;
+    private readonly _definitions;
+    /**
+     * @throws When dimensions, counts, or spacing values are invalid.
+     */
+    constructor(options: TileSetOptions);
+    /**
+     * Set per-tile metadata for a local tile ID.
+     * Copies input to prevent caller-owned mutation leaking into the tileset.
+     * @internal
+     */
+    _setDefinition(localTileId: number, definition: Partial<TileDefinition>): void;
+    /**
+     * Build definitions from an array, replacing the internal definitions map.
+     * Each entry's properties are copied and frozen.
+     * @internal
+     */
+    _setDefinitions(definitions: readonly TileDefinition[]): void;
+    /**
+     * Retrieve per-tile metadata, or undefined if none defined.
+     * @advanced
+     */
+    getTileDefinition(localTileId: number): TileDefinition | undefined;
+    /**
+     * Compute the pixel-space source rectangle for a local tile ID
+     * within the atlas, accounting for columns, spacing, and margin.
+     * @advanced
+     */
+    getTileRect(localTileId: number): {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    /**
+     * Iterate over all defined tiles (sparse).
+     * @advanced
+     */
+    definedTiles(): IterableIterator<TileDefinition>;
+    /**
+     * Read-only snapshot of all per-tile definitions.
+     * The returned record is a caller-owned copy.
+     * @advanced
+     */
+    get allDefinitions(): Readonly<Record<number, TileProperties | undefined>>;
+}

package/dist/esm/TileSet.js

@@ -0,0 +1,157 @@
+import { validatePositiveInteger, validateNonNegativeInteger } from './types.js';
+
+/**
+ * A resolved tileset: a uniform grid of tiles within a texture atlas.
+ *
+ * Does **not** own its texture — the Loader or application code retains
+ * texture ownership. Tileset dimensions are validated at construction and
+ * frozen thereafter.
+ *
+ * Multiple tilesets are supported per {@link TileMap}; each carries its own
+ * tile dimensions, spacing, and optional per-tile metadata.
+ * @advanced
+ */
+class TileSet {
+    /** Stable runtime name. */
+    name;
+    /** Atlas texture region — Loader-owned, never destroyed by the tileset. */
+    texture;
+    /** Tile width in pixels. */
+    tileWidth;
+    /** Tile height in pixels. */
+    tileHeight;
+    /** Total number of tiles in the tileset. */
+    tileCount;
+    /** Number of columns in the atlas grid. */
+    columns;
+    /** Number of rows implied by tileCount and columns. */
+    rows;
+    /** Pixel spacing between tiles in the atlas. */
+    spacing;
+    /** Pixel margin around the atlas. */
+    margin;
+    _definitions;
+    /**
+     * @throws When dimensions, counts, or spacing values are invalid.
+     */
+    constructor(options) {
+        if (!options.name || typeof options.name !== 'string') {
+            throw new Error('TileSet name must be a non-empty string.');
+        }
+        if (!options.texture) {
+            throw new Error('TileSet requires a valid TextureRegion.');
+        }
+        validatePositiveInteger(options.tileWidth, 'tileWidth');
+        validatePositiveInteger(options.tileHeight, 'tileHeight');
+        validatePositiveInteger(options.tileCount, 'tileCount');
+        const spacing = options.spacing ?? 0;
+        const margin = options.margin ?? 0;
+        validateNonNegativeInteger(spacing, 'spacing');
+        validateNonNegativeInteger(margin, 'margin');
+        const atlasWidth = options.texture.width - margin * 2;
+        const atlasHeight = options.texture.height - margin * 2;
+        const columns = options.columns ?? Math.floor(atlasWidth / options.tileWidth);
+        validatePositiveInteger(columns, 'columns');
+        if (columns <= 0) {
+            throw new Error(`TileSet columns must be positive (got ${columns}).`);
+        }
+        if (options.tileWidth * columns + spacing * (columns - 1) > atlasWidth) {
+            throw new Error(`TileSet grid width exceeds atlas: ${options.tileWidth}*${columns}` +
+                ` + ${spacing}*${columns - 1} > ${atlasWidth}.`);
+        }
+        const rows = Math.ceil(options.tileCount / columns);
+        if (rows > 0 && options.tileHeight * rows + spacing * (rows - 1) > atlasHeight) {
+            throw new Error(`TileSet grid height exceeds atlas: ${options.tileHeight}*${rows}` +
+                ` + ${spacing}*${rows - 1} > ${atlasHeight}.`);
+        }
+        this.name = options.name;
+        this.texture = options.texture;
+        this.tileWidth = options.tileWidth;
+        this.tileHeight = options.tileHeight;
+        this.tileCount = options.tileCount;
+        this.columns = columns;
+        this.rows = rows;
+        this.spacing = spacing;
+        this.margin = margin;
+        this._definitions = new Map();
+    }
+    /**
+     * Set per-tile metadata for a local tile ID.
+     * Copies input to prevent caller-owned mutation leaking into the tileset.
+     * @internal
+     */
+    _setDefinition(localTileId, definition) {
+        if (localTileId < 0 || localTileId >= this.tileCount) {
+            throw new Error(`Tile definition localTileId ${localTileId} out of range [0, ${this.tileCount - 1}].`);
+        }
+        const props = definition.properties
+            ? Object.freeze({ ...definition.properties })
+            : undefined;
+        this._definitions.set(localTileId, {
+            localTileId,
+            properties: props,
+        });
+    }
+    /**
+     * Build definitions from an array, replacing the internal definitions map.
+     * Each entry's properties are copied and frozen.
+     * @internal
+     */
+    _setDefinitions(definitions) {
+        const map = this._definitions;
+        map.clear();
+        for (const def of definitions) {
+            const props = def.properties
+                ? Object.freeze({ ...def.properties })
+                : undefined;
+            map.set(def.localTileId, { localTileId: def.localTileId, properties: props });
+        }
+    }
+    /**
+     * Retrieve per-tile metadata, or undefined if none defined.
+     * @advanced
+     */
+    getTileDefinition(localTileId) {
+        return this._definitions.get(localTileId);
+    }
+    /**
+     * Compute the pixel-space source rectangle for a local tile ID
+     * within the atlas, accounting for columns, spacing, and margin.
+     * @advanced
+     */
+    getTileRect(localTileId) {
+        if (localTileId < 0 || localTileId >= this.tileCount) {
+            throw new Error(`getTileRect: localTileId ${localTileId} out of range [0, ${this.tileCount - 1}].`);
+        }
+        const col = localTileId % this.columns;
+        const row = Math.floor(localTileId / this.columns);
+        return {
+            x: this.margin + col * (this.tileWidth + this.spacing),
+            y: this.margin + row * (this.tileHeight + this.spacing),
+            width: this.tileWidth,
+            height: this.tileHeight,
+        };
+    }
+    /**
+     * Iterate over all defined tiles (sparse).
+     * @advanced
+     */
+    definedTiles() {
+        return this._definitions.values();
+    }
+    /**
+     * Read-only snapshot of all per-tile definitions.
+     * The returned record is a caller-owned copy.
+     * @advanced
+     */
+    get allDefinitions() {
+        const result = {};
+        for (const [id, def] of this._definitions) {
+            result[id] = def.properties;
+        }
+        return Object.freeze(result);
+    }
+}
+
+export { TileSet };
+//# sourceMappingURL=TileSet.js.map

package/dist/esm/TileSet.js.map

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