@codexo/exojs-tilemap 0.15.3 → 0.16.0

package/dist/esm/TileMap.js.map

@@ -1 +1 @@
-{"version":3,"file":"TileMap.js","sources":["../../../src/TileMap.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}
+{"version":3,"file":"TileMap.js","names":[],"sources":["../../src/TileMap.ts"],"sourcesContent":["import { type ImageLayer } from './ImageLayer';\nimport type { ObjectLayer, ObjectSchema } from './ObjectLayer';\nimport { type TileLayer } from './TileLayer';\nimport type { TileMapViewOptions } from './TileMapView';\nimport { TileMapView } from './TileMapView';\nimport { type TileSet } from './TileSet';\nimport type { ResolvedTile, TileProperties } from './types';\nimport { validatePairedDimensions, validatePositiveInteger } from './types';\n\n/**\n * Options for constructing a {@link TileMap}.\n * @advanced\n */\nexport interface TileMapOptions {\n  /** Map name (for debugging). */\n  readonly name?: string;\n  /**\n   * Map width in tiles. Omit together with {@link height} for an unbounded\n   * map - layers you add are then free to be unbounded too (this option\n   * does not constrain per-layer dimensions either way).\n   */\n  readonly width?: number;\n  /** Map height in tiles. Must be provided iff {@link width} is. */\n  readonly height?: number;\n  /** Width of each tile in pixels. */\n  readonly tileWidth: number;\n  /** Height of each tile in pixels. */\n  readonly tileHeight: number;\n  /** Tilesets available to this map. */\n  readonly tilesets?: readonly TileSet[];\n  /** Layers (constructed externally and owned by the map after construction). */\n  readonly layers?: readonly TileLayer[];\n  /** Object layers (data-only; spawn points, triggers, collision regions). */\n  readonly objectLayers?: readonly ObjectLayer[];\n  /** Image layers (data-only; background/foreground images from Tiled image layers). */\n  readonly imageLayers?: readonly ImageLayer[];\n  /** Chunk width for layers (default 32). */\n  readonly chunkWidth?: number;\n  /** Chunk height for layers (default 32). */\n  readonly chunkHeight?: number;\n  /** Map class/type string (Tiled `class`). Defaults to `''`. */\n  readonly class?: string;\n  /**\n   * Map background colour as a `0xRRGGBB` integer, or `null` (Tiled\n   * `backgroundcolor`). Informational - the renderer does not auto-clear to it.\n   * Default `null`.\n   */\n  readonly backgroundColor?: number | null;\n  /** Tile draw order (Tiled `renderorder`), informational. Default `'right-down'`. */\n  readonly renderOrder?: string;\n  /** Map-level properties (copied and frozen). */\n  readonly properties?: TileProperties;\n  /**\n   * Combined document order across tile and image layers, as an ordered list\n   * of layer ids - exposed via {@link TileMap.renderableLayers}. Every tile\n   * and image layer passed to this map (via {@link layers} / {@link\n   * imageLayers}) must appear exactly once; an id that belongs to neither\n   * kind, or is listed more than once, throws. The list's length must also\n   * equal the total number of tile/image layer instances - nothing enforces\n   * unique ids across image layers, so two image layers sharing an id would\n   * otherwise both satisfy the id-based checks while one silently drops out\n   * of {@link TileMap.renderableLayers}; that mismatch throws too.\n   *\n   * A tile layer and an image layer sharing the same id makes the order\n   * ambiguous - that combination throws when `documentOrder` is provided.\n   * It is NOT rejected when this option is omitted: the fallback order below\n   * is unambiguous by construction (tile layers are always listed before\n   * image layers), so hand-built maps that predate this option are\n   * unaffected even if such an id collision exists.\n   *\n   * Omit to fall back to all tile layers in insertion order, followed by all\n   * image layers in insertion order - the map's implicit ordering before\n   * this option existed.\n   *\n   * Named `documentOrder` rather than `renderOrder` to avoid colliding with\n   * the unrelated {@link renderOrder} option above (Tiled's tile-draw-\n   * direction string, e.g. `'right-down'`).\n   */\n  readonly documentOrder?: readonly number[];\n}\n\n/**\n * A generic, format-independent tile map.\n *\n * Owns a finite grid of {@link TileLayer}s and a shared set of {@link TileSet}s.\n * Tile data is stored in compact chunked arrays - no per-tile heap objects.\n *\n * The map does NOT own tileset textures (those are Loader-owned) and does\n * NOT own SceneNode children - see {@link import('./TileMapNode').TileMapNode},\n * which owns those.\n *\n * Multiple tilesets are supported: each cell stores a packed tileset index\n * and local tile ID, so different tilesets may have different tile dimensions.\n *\n * @advanced\n */\nexport class TileMap {\n  /** Map name (debug). */\n  public readonly name: string;\n\n  /** Map width in tiles, or `undefined` if unbounded. */\n  public readonly width: number | undefined;\n  /** Map height in tiles, or `undefined` if unbounded. */\n  public readonly height: number | undefined;\n\n  /** Tile width in pixels. */\n  public readonly tileWidth: number;\n  /** Tile height in pixels. */\n  public readonly tileHeight: number;\n\n  /** Pixel width, or `undefined` if unbounded. */\n  public get pixelWidth(): number | undefined {\n    return this.width === undefined ? undefined : this.width * this.tileWidth;\n  }\n  /** Pixel height, or `undefined` if unbounded. */\n  public get pixelHeight(): number | undefined {\n    return this.height === undefined ? undefined : this.height * this.tileHeight;\n  }\n  /** `true` if this map has a fixed width/height; `false` if unbounded. */\n  public get bounded(): boolean {\n    return this.width !== undefined && this.height !== undefined;\n  }\n\n  /** Default chunk width for layers. */\n  public readonly chunkWidth: number;\n  /** Default chunk height for layers. */\n  public readonly chunkHeight: number;\n\n  /** Map class/type string (Tiled `class`; may be empty). */\n  public readonly class: string;\n  /** Map background colour as `0xRRGGBB`, or `null`. Informational. */\n  public readonly backgroundColor: number | null;\n  /** Tile draw order (Tiled `renderorder`). Informational. */\n  public readonly renderOrder: string;\n\n  /** Map-level properties (immutable). */\n  public readonly properties: TileProperties;\n\n  private readonly _tilesets: TileSet[];\n  private readonly _layers: TileLayer[] = [];\n  private readonly _layerById = new Map<number, TileLayer>();\n  private readonly _objectLayers: ObjectLayer[] = [];\n  private readonly _imageLayers: ImageLayer[] = [];\n  private readonly _documentOrder: Array<TileLayer | ImageLayer> = [];\n\n  private _revision = 0;\n  private _destroyed = false;\n\n  /**\n   * @throws When dimensions or other options are invalid.\n   */\n  public constructor(options: TileMapOptions) {\n    validatePairedDimensions(options.width, options.height, 'TileMap', 'map');\n    validatePositiveInteger(options.tileWidth, 'map.tileWidth');\n    validatePositiveInteger(options.tileHeight, 'map.tileHeight');\n\n    const chunkWidth = options.chunkWidth ?? 32;\n    const chunkHeight = options.chunkHeight ?? 32;\n    validatePositiveInteger(chunkWidth, 'chunkWidth');\n    validatePositiveInteger(chunkHeight, 'chunkHeight');\n\n    this.name = options.name ?? 'TileMap';\n    this.width = options.width;\n    this.height = options.height;\n    this.tileWidth = options.tileWidth;\n    this.tileHeight = options.tileHeight;\n    this.chunkWidth = chunkWidth;\n    this.chunkHeight = chunkHeight;\n    this.class = options.class ?? '';\n    this.backgroundColor = options.backgroundColor ?? null;\n    this.renderOrder = options.renderOrder ?? 'right-down';\n\n    this._tilesets = options.tilesets ? [...options.tilesets] : [];\n    this.properties = options.properties ? Object.freeze({ ...options.properties }) : Object.freeze({});\n\n    if (options.layers) {\n      for (const layer of options.layers) {\n        this._addLayer(layer);\n      }\n    }\n\n    if (options.objectLayers) {\n      this._objectLayers.push(...options.objectLayers);\n    }\n\n    if (options.imageLayers) {\n      for (const layer of options.imageLayers) {\n        this._addImageLayer(layer);\n      }\n    }\n\n    this._documentOrder.push(...this._buildDocumentOrder(options.documentOrder));\n  }\n\n  /**\n   * Validate an explicit `documentOrder` option against current tile/image\n   * layer membership and resolve it to layer instances, or compute the\n   * fallback order (tile layers in insertion order, then image layers) when\n   * omitted. The order stores instance references - not ids - so a\n   * cross-kind id collision in a fallback map can never resolve to the\n   * wrong layer.\n   * @throws Per the validation rules documented on {@link\n   *         TileMapOptions.documentOrder}.\n   */\n  private _buildDocumentOrder(documentOrder: readonly number[] | undefined): Array<TileLayer | ImageLayer> {\n    if (!documentOrder) {\n      return [...this._layers, ...this._imageLayers];\n    }\n\n    const tileIds = new Set(this._layers.map(l => l.id));\n    const imageIds = new Set(this._imageLayers.map(l => l.id));\n\n    for (const id of tileIds) {\n      if (imageIds.has(id)) {\n        throw new Error(`Layer ID ${id} exists as both a tile layer and an image layer in map \"${this.name}\"; documentOrder cannot disambiguate them.`);\n      }\n    }\n\n    const seen = new Set<number>();\n    for (const id of documentOrder) {\n      if (!tileIds.has(id) && !imageIds.has(id)) {\n        throw new Error(`documentOrder references unknown layer ID ${id} in map \"${this.name}\".`);\n      }\n      if (seen.has(id)) {\n        throw new Error(`documentOrder lists layer ID ${id} more than once in map \"${this.name}\".`);\n      }\n      seen.add(id);\n    }\n\n    const totalLayers = tileIds.size + imageIds.size;\n    if (seen.size !== totalLayers) {\n      for (const id of [...tileIds, ...imageIds]) {\n        if (!seen.has(id)) {\n          throw new Error(`documentOrder is missing layer ID ${id} in map \"${this.name}\".`);\n        }\n      }\n    }\n\n    // The checks above are id-SET based, so they can't see a duplicate\n    // image-layer id (nothing enforces image-layer id uniqueness): two\n    // image layers sharing an id collapse to one entry in `imageIds`,\n    // letting a documentOrder that covers every distinct id still be one\n    // instance short. Compare against the actual instance counts so that\n    // case throws instead of silently dropping an instance from\n    // renderableLayers.\n    const instanceCount = this._layers.length + this._imageLayers.length;\n    if (documentOrder.length !== instanceCount) {\n      throw new Error(\n        `documentOrder has ${documentOrder.length} entries but map \"${this.name}\" has ${instanceCount} tile/image layer instances; check for a duplicate image-layer ID.`,\n      );\n    }\n\n    // Ids are unique across kinds here (the cross-kind check above threw\n    // otherwise), so resolving each id to an instance is unambiguous. The\n    // count check above does not guarantee the ids themselves match, so an\n    // unresolvable one is reported rather than left as a hole in the list.\n    return documentOrder.map(id => {\n      const layer = this._layerById.get(id) ?? this._imageLayers.find(imageLayer => imageLayer.id === id);\n\n      if (!layer) {\n        throw new Error(`documentOrder references layer id ${id}, but map \"${this.name}\" has no tile or image layer with that id.`);\n      }\n\n      return layer;\n    });\n  }\n\n  // ── Tilesets ──────────────────────────────────────────────────────────\n\n  /** Immutable list of tilesets available to this map. */\n  public get tilesets(): readonly TileSet[] {\n    return this._tilesets;\n  }\n\n  /**\n   * Add a tileset. Tilesets must have unique names.\n   * @throws If a tileset with the same name already exists, or the map is destroyed.\n   */\n  public addTileset(tileset: TileSet): void {\n    this._checkDestroyed();\n    if (this._tilesets.some(ts => ts.name === tileset.name)) {\n      throw new Error(`Tileset \"${tileset.name}\" already exists in map \"${this.name}\".`);\n    }\n    this._tilesets.push(tileset);\n    this._revision++;\n  }\n\n  /**\n   * Get a tileset by name, or undefined.\n   */\n  public getTileset(name: string): TileSet | undefined {\n    return this._tilesets.find(ts => ts.name === name);\n  }\n\n  // ── Layers ────────────────────────────────────────────────────────────\n\n  /** Immutable snapshot of layers (ordered). */\n  public get layers(): readonly TileLayer[] {\n    return this._layers;\n  }\n\n  private _addLayer(layer: TileLayer): void {\n    if (this._layerById.has(layer.id)) {\n      throw new Error(`Layer ID ${layer.id} already exists in map \"${this.name}\".`);\n    }\n    this._layerById.set(layer.id, layer);\n    this._layers.push(layer);\n  }\n\n  /**\n   * Add a layer after construction. Appended to the end of {@link\n   * renderableLayers}'s document order.\n   * @throws If a layer with the same ID already exists.\n   */\n  public addLayer(layer: TileLayer): void {\n    this._checkDestroyed();\n    this._addLayer(layer);\n    this._documentOrder.push(layer);\n    this._revision++;\n  }\n\n  /**\n   * Get a tile layer by ID.\n   */\n  public getTileLayerById(id: number): TileLayer | undefined {\n    return this._layerById.get(id);\n  }\n\n  /**\n   * Get a tile layer by name. Returns the first match in insertion order.\n   */\n  public getTileLayer(name: string): TileLayer | undefined {\n    return this._layers.find(l => l.name === name);\n  }\n\n  /**\n   * Remove a layer by ID. The layer is destroyed and spliced out of {@link\n   * renderableLayers}'s document order.\n   * @returns true if the layer was found and removed.\n   */\n  public removeLayer(id: number): boolean {\n    this._checkDestroyed();\n    const layer = this._layerById.get(id);\n    if (!layer) return false;\n    this._layers.splice(this._layers.indexOf(layer), 1);\n    this._layerById.delete(id);\n    const orderIndex = this._documentOrder.indexOf(layer);\n    if (orderIndex !== -1) this._documentOrder.splice(orderIndex, 1);\n    layer.destroy();\n    this._revision++;\n    return true;\n  }\n\n  // ── Object layers (data-only) ─────────────────────────────────────────\n\n  /** Immutable snapshot of object layers (insertion order). */\n  public get objectLayers(): readonly ObjectLayer[] {\n    return this._objectLayers;\n  }\n\n  /**\n   * Add an object layer after construction.\n   * @throws If the map is destroyed.\n   */\n  public addObjectLayer(layer: ObjectLayer): void {\n    this._checkDestroyed();\n    this._objectLayers.push(layer);\n    this._revision++;\n  }\n\n  /**\n   * Get an object layer by name (first match in insertion order), or undefined.\n   *\n   * Supply an {@link ObjectSchema} type argument `S` to obtain a typed view of\n   * the layer - `getObjectLayer<LevelObjects>('Entities')` returns an\n   * `ObjectLayer<LevelObjects>` whose {@link ObjectLayer.byType} / {@link\n   * ObjectLayer.where} accessors narrow `properties`. The schema is a static\n   * developer promise only; no runtime validation is performed and the call\n   * remains fully back-compatible when omitted.\n   */\n  public getObjectLayer<S extends ObjectSchema = ObjectSchema>(name: string): ObjectLayer<S> | undefined {\n    return this._objectLayers.find(layer => layer.name === name) as ObjectLayer<S> | undefined;\n  }\n\n  /**\n   * Get an object layer by ID.\n   *\n   * Supply an {@link ObjectSchema} type argument `S` to obtain a typed view of\n   * the layer, as with {@link getObjectLayer}.\n   */\n  public getObjectLayerById<S extends ObjectSchema = ObjectSchema>(id: number): ObjectLayer<S> | undefined {\n    return this._objectLayers.find(layer => layer.id === id) as ObjectLayer<S> | undefined;\n  }\n\n  /**\n   * Remove an object layer by ID.\n   * @returns true if the layer was found and removed.\n   */\n  public removeObjectLayer(id: number): boolean {\n    this._checkDestroyed();\n    const index = this._objectLayers.findIndex(layer => layer.id === id);\n    if (index === -1) return false;\n    this._objectLayers.splice(index, 1);\n    this._revision++;\n    return true;\n  }\n\n  // ── Image layers (data-only) ──────────────────────────────────────────\n\n  /** Immutable snapshot of image layers (insertion order). */\n  public get imageLayers(): readonly ImageLayer[] {\n    return this._imageLayers;\n  }\n\n  /**\n   * Add an image layer after construction. Appended to both {@link\n   * imageLayers} and the end of {@link renderableLayers}'s document order.\n   * @throws If an image layer with the same ID already exists. An ID shared\n   *   with a *tile* layer is permitted - the two kinds keep separate ID\n   *   spaces, and all internal bookkeeping is instance-based.\n   */\n  public addImageLayer(layer: ImageLayer): void {\n    this._checkDestroyed();\n    this._addImageLayer(layer);\n    this._documentOrder.push(layer);\n    this._revision++;\n  }\n\n  /** Shared by the constructor and {@link addImageLayer}: enforce ID uniqueness within the image-layer kind. */\n  private _addImageLayer(layer: ImageLayer): void {\n    if (this._imageLayers.some(existing => existing.id === layer.id)) {\n      throw new Error(`Image layer ID ${layer.id} already exists in map \"${this.name}\".`);\n    }\n    this._imageLayers.push(layer);\n  }\n\n  /**\n   * Get an image layer by name (first match in insertion order), or undefined.\n   */\n  public getImageLayer(name: string): ImageLayer | undefined {\n    return this._imageLayers.find(layer => layer.name === name);\n  }\n\n  /**\n   * Get an image layer by ID.\n   */\n  public getImageLayerById(id: number): ImageLayer | undefined {\n    return this._imageLayers.find(layer => layer.id === id);\n  }\n\n  /**\n   * Remove an image layer by ID. Spliced out of {@link renderableLayers}'s\n   * document order.\n   * @returns true if the layer was found and removed.\n   */\n  public removeImageLayer(id: number): boolean {\n    this._checkDestroyed();\n    const layer = this._imageLayers.find(l => l.id === id);\n    if (!layer) return false;\n    this._imageLayers.splice(this._imageLayers.indexOf(layer), 1);\n    const orderIndex = this._documentOrder.indexOf(layer);\n    if (orderIndex !== -1) this._documentOrder.splice(orderIndex, 1);\n    this._revision++;\n    return true;\n  }\n\n  // ── Combined render order ─────────────────────────────────────────────\n\n  /**\n   * Tile and image layers combined into a single document order (see {@link\n   * TileMapOptions.documentOrder}), maintained live as membership changes.\n   * Reflects `addLayer` / `addImageLayer` / `removeLayer` /\n   * `removeImageLayer` calls made after construction. Holds instance\n   * references, so entries stay correct even when a tile layer and an image\n   * layer share an id in a fallback-ordered map. Object layers are\n   * data-only and never appear here.\n   */\n  public get renderableLayers(): ReadonlyArray<TileLayer | ImageLayer> {\n    return this._documentOrder;\n  }\n\n  // ── Scene composition ─────────────────────────────────────────────────\n\n  /**\n   * Create a new {@link TileMapView} that groups this map's layers into\n   * independently placeable band / layer scene nodes for interleaving\n   * application actors between tile layers.\n   *\n   * Each call returns a fresh, independent view - the map does **not** cache a\n   * single global view, so multiple coexisting views of the same map are\n   * allowed. The view references this map but never owns it: destroying the\n   * view frees only its generated layer/band nodes - never the map, its layers,\n   * tileset textures, or any application actors.\n   *\n   * @advanced\n   */\n  public createView(options?: TileMapViewOptions): TileMapView {\n    return new TileMapView(this, options);\n  }\n\n  // ── Queries ───────────────────────────────────────────────────────────\n\n  /**\n   * Get a resolved tile from a given layer at tile coordinates.\n   * Convenience for `map.getTileLayerById(id)?.getTileAt(tx, ty)`.\n   * Returns null for an empty cell, out-of-bounds, or missing layer.\n   */\n  public getTileAt(layerId: number, tx: number, ty: number): ResolvedTile | null {\n    const layer = this._layerById.get(layerId);\n    if (!layer) return null;\n    return layer.getTileAt(tx, ty);\n  }\n\n  /**\n   * Set a tile on a given layer at tile coordinates.\n   * Convenience for `map.getTileLayerById(id)?.setTileAt(tx, ty, tile)`.\n   * @throws If the layer does not exist, coordinates are out of bounds,\n   *         or the tile reference is invalid.\n   */\n  public setTileAt(layerId: number, tx: number, ty: number, tile: ResolvedTile): void {\n    const layer = this._layerById.get(layerId);\n    if (!layer) throw new Error(`Layer ${layerId} not found in map \"${this.name}\".`);\n    layer.setTileAt(tx, ty, tile);\n  }\n\n  /**\n   * Clear a tile on a given layer at tile coordinates.\n   * Convenience for `map.getTileLayerById(id)?.clearTileAt(tx, ty)`.\n   * @throws If the layer does not exist or coordinates are out of bounds.\n   */\n  public clearTileAt(layerId: number, tx: number, ty: number): void {\n    const layer = this._layerById.get(layerId);\n    if (!layer) throw new Error(`Layer ${layerId} not found in map \"${this.name}\".`);\n    layer.clearTileAt(tx, ty);\n  }\n\n  // ── Coordinate conversion (base layer) ────────────────────────────────\n\n  /**\n   * Convert a tile coordinate to the pixel position of its top-left corner\n   * in map-local space (ignoring layer offsets).\n   */\n  public tileToPixel(tx: number, ty: number): { x: number; y: number } {\n    return {\n      x: tx * this.tileWidth,\n      y: ty * this.tileHeight,\n    };\n  }\n\n  /**\n   * Convert a pixel position in map-local space to the tile coordinate\n   * that contains it. Uses `floor`. May return coordinates outside map bounds.\n   */\n  public pixelToTile(px: number, py: number): { tx: number; ty: number } {\n    return {\n      tx: Math.floor(px / this.tileWidth),\n      ty: Math.floor(py / this.tileHeight),\n    };\n  }\n\n  // ── Revision / lifecycle ──────────────────────────────────────────────\n\n  /**\n   * Monotonic map revision counter. Increments on structural changes only\n   * (add/remove layer, add tileset). Cell mutations are tracked per-chunk\n   * and per-layer; the renderer reads chunk-level revisions directly.\n   * @advanced\n   */\n  public get revision(): number {\n    return this._revision;\n  }\n\n  /** Whether the map has been destroyed. */\n  public get destroyed(): boolean {\n    return this._destroyed;\n  }\n\n  private _checkDestroyed(): void {\n    if (this._destroyed) {\n      throw new Error(`TileMap \"${this.name}\" has been destroyed.`);\n    }\n  }\n\n  /**\n   * Destroy the map and all owned layers and chunk storage.\n   *\n   * Is idempotent. Does NOT destroy tileset textures (Loader-owned) or\n   * any SceneNodes (those do not exist yet in this slice).\n   */\n  public destroy(): void {\n    if (this._destroyed) return;\n    this._destroyed = true;\n    for (const layer of this._layers) {\n      layer.destroy();\n    }\n    this._layers.length = 0;\n    this._layerById.clear();\n    this._objectLayers.length = 0;\n    this._imageLayers.length = 0;\n    this._documentOrder.length = 0;\n    this._tilesets.length = 0;\n  }\n}\n"],"mappings":"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"}

package/dist/esm/TileMapBand.d.ts

@@ -1,12 +1,16 @@
 import { Container } from '@codexo/exojs';
+import type { ImageLayer } from './ImageLayer';
+import type { ImageLayerNode } from './ImageLayerNode';
+import type { TileLayer } from './TileLayer';
 import type { TileLayerNode } from './TileLayerNode';
 /**
- * A named, ordered group of {@link TileLayerNode}s produced by a
- * {@link TileMapView} for ergonomic actor interleaving.
+ * A named, ordered group of layer nodes ({@link TileLayerNode}s and
+ * {@link ImageLayerNode}s) produced by a {@link TileMapView} for ergonomic
+ * actor interleaving.
  *
  * A band is a plain {@link Container} scene node that the application parents
  * wherever it wants (typically directly under its own world root). Bands are
- * composition units only: a band owns **its generated tile-layer nodes** and
+ * composition units only: a band owns **its generated layer nodes** and
  * never application actors. Placing actors *between* bands is done by parenting
  * the bands and the actor containers as siblings in the desired document order:
  *
@@ -14,17 +18,19 @@ import type { TileLayerNode } from './TileLayerNode';
  * worldRoot.addChild(view.band('ground'), actors, view.band('roof'));
  * ```
  *
- * **Rendering order within a band always follows map document order**, not the
- * order layers were listed in the band definition — band membership *selects*
- * layers; it never reorders them.
+ * **Rendering order within a band always follows map document order**
+ * ({@link import('./TileMap').TileMap.renderableLayers}), not the order layers
+ * were listed in the band definition - band membership *selects* layers; it
+ * never reorders them. Tile and image members interleave exactly as the map's
+ * combined document order dictates.
  *
- * **Ownership:** the band owns the {@link TileLayerNode}s it was created with.
- * Destroying the band destroys those layer nodes (and their cached chunk
- * geometry) and detaches the band from its application parent — it never
- * touches application actors, sibling bands, the {@link TileMap}, the
- * {@link TileLayer}s, or Loader-owned tileset textures.
+ * **Ownership:** the band owns the layer nodes it was created with. Destroying
+ * the band destroys those layer nodes (and their cached chunk geometry) and
+ * detaches the band from its application parent - it never touches application
+ * actors, sibling bands, the {@link TileMap}, the {@link TileLayer}s /
+ * {@link ImageLayer}s, or Loader-owned textures.
  *
- * Bounds are the union of the band's tile-layer-node bounds (an empty band
+ * Bounds are the union of the band's layer-node bounds (an empty band
  * collapses to a degenerate rect at the band's transformed origin).
  *
  * Bands are created by {@link TileMapView}; construct them through
@@ -47,20 +53,23 @@ export declare class TileMapBand extends Container {
      *                   map document order. Adopted as children.
      * @internal Constructed by {@link TileMapView}.
      */
-    constructor(name: string, layerNodes: readonly TileLayerNode[]);
+    constructor(name: string, layerNodes: ReadonlyArray<TileLayerNode | ImageLayerNode>);
     /**
-     * The tile-layer nodes that compose this band, in map document order. This
-     * is the band's **membership** list (the nodes it owns and destroys); it may
-     * differ from {@link Container.children} if the caller reparents an
-     * individual layer node elsewhere.
+     * The layer nodes that compose this band, in map document order - tile and
+     * image members interleaved. This is the band's **membership** list (the
+     * nodes it owns and destroys); it may differ from {@link Container.children}
+     * if the caller reparents an individual layer node elsewhere.
      */
-    get layerNodes(): readonly TileLayerNode[];
-    /** Find this band's layer node rendering the layer with the given id. */
-    getLayerNodeById(id: number): TileLayerNode | undefined;
+    get layerNodes(): ReadonlyArray<TileLayerNode | ImageLayerNode>;
+    /**
+     * Find this band's layer node rendering the layer with the given id (tile or
+     * image member; first match in document order).
+     */
+    getLayerNodeById(id: number): TileLayerNode | ImageLayerNode | undefined;
     /** Whether this band currently owns no layer nodes. */
     get isEmpty(): boolean;
     /**
-     * Bounds are the union of the band's visible tile-layer-node bounds. With no
+     * Bounds are the union of the band's visible layer-node bounds. With no
      * visible children the band collapses to a degenerate rect at its transformed
      * origin (rather than the whole-subtree-plus-origin union a bare Container
      * would report).
@@ -73,28 +82,32 @@ export declare class TileMapBand extends Container {
      * map document order.
      * @internal
      */
-    _adopt(node: TileLayerNode): void;
+    _adopt(node: TileLayerNode | ImageLayerNode): void;
     /**
      * Drop a layer node from this band's membership without destroying it (used
      * when its map layer was removed; the view destroys the node separately).
      * @internal
      */
-    _release(node: TileLayerNode): void;
+    _release(node: TileLayerNode | ImageLayerNode): void;
     /**
      * Reorder this band's membership and its still-parented children to map
-     * document order. `documentIndexById` maps a layer id to its index in the
-     * map's layer list. Layer nodes the caller has reparented away from this band
-     * keep their membership (for ownership) but are not re-adopted.
+     * document order. `documentIndex` maps a layer **instance** to its index in
+     * the map's combined document order - keyed by instance rather than id
+     * because a tile layer and an image layer may share an id in fallback-ordered
+     * maps. Layer nodes the caller has reparented away from this band keep their
+     * membership (for ownership) but are not re-adopted.
      * @internal
      */
-    _reorder(documentIndexById: ReadonlyMap<number, number>): void;
+    _reorder(documentIndex: ReadonlyMap<TileLayer | ImageLayer, number>): void;
     /**
      * Destroy the band: detach it from its application parent, then destroy the
-     * tile-layer nodes it owns (freeing their chunk geometry). Application actors,
-     * sibling bands, the map, layers, and tileset textures are untouched.
+     * layer nodes it owns (freeing their chunk geometry / image sprites).
+     * Application actors, sibling bands, the map, layers, and Loader-owned
+     * textures are untouched.
      *
      * Idempotent: a second call (e.g. when {@link TileMapView.destroy} runs after
      * the application already destroyed this band directly) is a safe no-op.
      */
     destroy(): void;
 }
+//# sourceMappingURL=TileMapBand.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TileMapBand.d.ts","sourceRoot":"","sources":["../../src/TileMapBand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,qBAAa,WAAY,SAAQ,SAAS;IACxC;;;;OAIG;IACa,IAAI,SAAM;IAE1B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAwC;IACpE,OAAO,CAAC,UAAU,CAAS;IAE3B;;;;;OAKG;gBACgB,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,CAAC,aAAa,GAAG,cAAc,CAAC;IAW1F;;;;;OAKG;IACH,IAAW,UAAU,IAAI,aAAa,CAAC,aAAa,GAAG,cAAc,CAAC,CAErE;IAED;;;OAGG;IACI,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,cAAc,GAAG,SAAS;IAI/E,uDAAuD;IACvD,IAAW,OAAO,IAAI,OAAO,CAE5B;IAED;;;;;OAKG;IACa,YAAY,IAAI,IAAI;IAmBpC;;;;;;OAMG;IACI,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,cAAc,GAAG,IAAI;IAQzD;;;;OAIG;IACI,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,cAAc,GAAG,IAAI;IAY3D;;;;;;;;OAQG;IACI,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC,SAAS,GAAG,UAAU,EAAE,MAAM,CAAC,GAAG,IAAI;IAUjF;;;;;;;;OAQG;IACa,OAAO,IAAI,IAAI;CAmBhC"}

package/dist/esm/TileMapBand.js

@@ -1,162 +1,155 @@
-import { Container } from '@codexo/exojs';
+import { Container } from "@codexo/exojs";
 
+//#region src/TileMapBand.ts
 /**
- * A named, ordered group of {@link TileLayerNode}s produced by a
- * {@link TileMapView} for ergonomic actor interleaving.
- *
- * A band is a plain {@link Container} scene node that the application parents
- * wherever it wants (typically directly under its own world root). Bands are
- * composition units only: a band owns **its generated tile-layer nodes** and
- * never application actors. Placing actors *between* bands is done by parenting
- * the bands and the actor containers as siblings in the desired document order:
- *
- * ```ts
- * worldRoot.addChild(view.band('ground'), actors, view.band('roof'));
- * ```
- *
- * **Rendering order within a band always follows map document order**, not the
- * order layers were listed in the band definition — band membership *selects*
- * layers; it never reorders them.
- *
- * **Ownership:** the band owns the {@link TileLayerNode}s it was created with.
- * Destroying the band destroys those layer nodes (and their cached chunk
- * geometry) and detaches the band from its application parent — it never
- * touches application actors, sibling bands, the {@link TileMap}, the
- * {@link TileLayer}s, or Loader-owned tileset textures.
- *
- * Bounds are the union of the band's tile-layer-node bounds (an empty band
- * collapses to a degenerate rect at the band's transformed origin).
- *
- * Bands are created by {@link TileMapView}; construct them through
- * {@link TileMapView} rather than directly.
- *
- * @advanced
- */
-class TileMapBand extends Container {
-    /**
-     * The band name (unique within its owning {@link TileMapView}). Narrows the
-     * inherited {@link SceneNode.name} from `string | null` to a required string;
-     * assigned once at construction.
-     */
-    name = '';
-    _layerNodes;
-    _destroyed = false;
-    /**
-     * @param name       The band name (unique within its owning view).
-     * @param layerNodes The layer nodes composing this band, already ordered by
-     *                   map document order. Adopted as children.
-     * @internal Constructed by {@link TileMapView}.
-     */
-    constructor(name, layerNodes) {
-        super();
-        this.name = name;
-        this._layerNodes = [...layerNodes];
-        for (const node of this._layerNodes) {
-            this.addChild(node);
-        }
-    }
-    /**
-     * The tile-layer nodes that compose this band, in map document order. This
-     * is the band's **membership** list (the nodes it owns and destroys); it may
-     * differ from {@link Container.children} if the caller reparents an
-     * individual layer node elsewhere.
-     */
-    get layerNodes() {
-        return this._layerNodes;
-    }
-    /** Find this band's layer node rendering the layer with the given id. */
-    getLayerNodeById(id) {
-        return this._layerNodes.find(node => node.layer.id === id);
-    }
-    /** Whether this band currently owns no layer nodes. */
-    get isEmpty() {
-        return this._layerNodes.length === 0;
-    }
-    /**
-     * Bounds are the union of the band's visible tile-layer-node bounds. With no
-     * visible children the band collapses to a degenerate rect at its transformed
-     * origin (rather than the whole-subtree-plus-origin union a bare Container
-     * would report).
-     */
-    updateBounds() {
-        this._bounds.reset();
-        let hasVisibleChild = false;
-        for (const child of this.children) {
-            if (child.visible) {
-                this._bounds.addRect(child.getBounds());
-                hasVisibleChild = true;
-            }
-        }
-        if (!hasVisibleChild) {
-            this._bounds.addRect(this.getLocalBounds(), this.getGlobalTransform());
-        }
-        return this;
-    }
-    /**
-     * Adopt a freshly created layer node into this band (used by
-     * {@link TileMapView.refreshLayers} when a newly added map layer joins this
-     * band). Appended; call {@link TileMapBand._reorder} afterwards to restore
-     * map document order.
-     * @internal
-     */
-    _adopt(node) {
-        if (!this._layerNodes.includes(node)) {
-            this._layerNodes.push(node);
-        }
-        this.addChild(node);
-    }
-    /**
-     * Drop a layer node from this band's membership without destroying it (used
-     * when its map layer was removed; the view destroys the node separately).
-     * @internal
-     */
-    _release(node) {
-        const index = this._layerNodes.indexOf(node);
-        if (index !== -1) {
-            this._layerNodes.splice(index, 1);
-        }
-        if (node.parent === this) {
-            this.removeChild(node);
-        }
-    }
-    /**
-     * Reorder this band's membership and its still-parented children to map
-     * document order. `documentIndexById` maps a layer id to its index in the
-     * map's layer list. Layer nodes the caller has reparented away from this band
-     * keep their membership (for ownership) but are not re-adopted.
-     * @internal
-     */
-    _reorder(documentIndexById) {
-        this._layerNodes.sort((a, b) => (documentIndexById.get(a.layer.id) ?? 0) - (documentIndexById.get(b.layer.id) ?? 0));
-        for (const node of this._layerNodes) {
-            if (node.parent === this) {
-                this.addChild(node);
-            }
-        }
-    }
-    /**
-     * Destroy the band: detach it from its application parent, then destroy the
-     * tile-layer nodes it owns (freeing their chunk geometry). Application actors,
-     * sibling bands, the map, layers, and tileset textures are untouched.
-     *
-     * Idempotent: a second call (e.g. when {@link TileMapView.destroy} runs after
-     * the application already destroyed this band directly) is a safe no-op.
-     */
-    destroy() {
-        if (this._destroyed) {
-            return;
-        }
-        this._destroyed = true;
-        this.parent?.removeChild(this);
-        const owned = [...this._layerNodes];
-        this._layerNodes.length = 0;
-        super.destroy();
-        for (const node of owned) {
-            node.parent?.removeChild(node);
-            node.destroy();
-        }
-    }
-}
+* A named, ordered group of layer nodes ({@link TileLayerNode}s and
+* {@link ImageLayerNode}s) produced by a {@link TileMapView} for ergonomic
+* actor interleaving.
+*
+* A band is a plain {@link Container} scene node that the application parents
+* wherever it wants (typically directly under its own world root). Bands are
+* composition units only: a band owns **its generated layer nodes** and
+* never application actors. Placing actors *between* bands is done by parenting
+* the bands and the actor containers as siblings in the desired document order:
+*
+* ```ts
+* worldRoot.addChild(view.band('ground'), actors, view.band('roof'));
+* ```
+*
+* **Rendering order within a band always follows map document order**
+* ({@link import('./TileMap').TileMap.renderableLayers}), not the order layers
+* were listed in the band definition - band membership *selects* layers; it
+* never reorders them. Tile and image members interleave exactly as the map's
+* combined document order dictates.
+*
+* **Ownership:** the band owns the layer nodes it was created with. Destroying
+* the band destroys those layer nodes (and their cached chunk geometry) and
+* detaches the band from its application parent - it never touches application
+* actors, sibling bands, the {@link TileMap}, the {@link TileLayer}s /
+* {@link ImageLayer}s, or Loader-owned textures.
+*
+* Bounds are the union of the band's layer-node bounds (an empty band
+* collapses to a degenerate rect at the band's transformed origin).
+*
+* Bands are created by {@link TileMapView}; construct them through
+* {@link TileMapView} rather than directly.
+*
+* @advanced
+*/
+var TileMapBand = class extends Container {
+	/**
+	* The band name (unique within its owning {@link TileMapView}). Narrows the
+	* inherited {@link SceneNode.name} from `string | null` to a required string;
+	* assigned once at construction.
+	*/
+	name = "";
+	_layerNodes;
+	_destroyed = false;
+	/**
+	* @param name       The band name (unique within its owning view).
+	* @param layerNodes The layer nodes composing this band, already ordered by
+	*                   map document order. Adopted as children.
+	* @internal Constructed by {@link TileMapView}.
+	*/
+	constructor(name, layerNodes) {
+		super();
+		this.name = name;
+		this._layerNodes = [...layerNodes];
+		for (const node of this._layerNodes) this.addChild(node);
+	}
+	/**
+	* The layer nodes that compose this band, in map document order - tile and
+	* image members interleaved. This is the band's **membership** list (the
+	* nodes it owns and destroys); it may differ from {@link Container.children}
+	* if the caller reparents an individual layer node elsewhere.
+	*/
+	get layerNodes() {
+		return this._layerNodes;
+	}
+	/**
+	* Find this band's layer node rendering the layer with the given id (tile or
+	* image member; first match in document order).
+	*/
+	getLayerNodeById(id) {
+		return this._layerNodes.find((node) => node.layer.id === id);
+	}
+	/** Whether this band currently owns no layer nodes. */
+	get isEmpty() {
+		return this._layerNodes.length === 0;
+	}
+	/**
+	* Bounds are the union of the band's visible layer-node bounds. With no
+	* visible children the band collapses to a degenerate rect at its transformed
+	* origin (rather than the whole-subtree-plus-origin union a bare Container
+	* would report).
+	*/
+	updateBounds() {
+		this._bounds.reset();
+		let hasVisibleChild = false;
+		for (const child of this.children) if (child.visible) {
+			this._bounds.addRect(child.getBounds());
+			hasVisibleChild = true;
+		}
+		if (!hasVisibleChild) this._bounds.addRect(this.getLocalBounds(), this.getGlobalTransform());
+		return this;
+	}
+	/**
+	* Adopt a freshly created layer node into this band (used by
+	* {@link TileMapView.refreshLayers} when a newly added map layer joins this
+	* band). Appended; call {@link TileMapBand._reorder} afterwards to restore
+	* map document order.
+	* @internal
+	*/
+	_adopt(node) {
+		if (!this._layerNodes.includes(node)) this._layerNodes.push(node);
+		this.addChild(node);
+	}
+	/**
+	* Drop a layer node from this band's membership without destroying it (used
+	* when its map layer was removed; the view destroys the node separately).
+	* @internal
+	*/
+	_release(node) {
+		const index = this._layerNodes.indexOf(node);
+		if (index !== -1) this._layerNodes.splice(index, 1);
+		if (node.parent === this) this.removeChild(node);
+	}
+	/**
+	* Reorder this band's membership and its still-parented children to map
+	* document order. `documentIndex` maps a layer **instance** to its index in
+	* the map's combined document order - keyed by instance rather than id
+	* because a tile layer and an image layer may share an id in fallback-ordered
+	* maps. Layer nodes the caller has reparented away from this band keep their
+	* membership (for ownership) but are not re-adopted.
+	* @internal
+	*/
+	_reorder(documentIndex) {
+		this._layerNodes.sort((a, b) => (documentIndex.get(a.layer) ?? 0) - (documentIndex.get(b.layer) ?? 0));
+		for (const node of this._layerNodes) if (node.parent === this) this.addChild(node);
+	}
+	/**
+	* Destroy the band: detach it from its application parent, then destroy the
+	* layer nodes it owns (freeing their chunk geometry / image sprites).
+	* Application actors, sibling bands, the map, layers, and Loader-owned
+	* textures are untouched.
+	*
+	* Idempotent: a second call (e.g. when {@link TileMapView.destroy} runs after
+	* the application already destroyed this band directly) is a safe no-op.
+	*/
+	destroy() {
+		if (this._destroyed) return;
+		this._destroyed = true;
+		this.parent?.removeChild(this);
+		const owned = [...this._layerNodes];
+		this._layerNodes.length = 0;
+		super.destroy();
+		for (const node of owned) {
+			node.parent?.removeChild(node);
+			node.destroy();
+		}
+	}
+};
 
+//#endregion
 export { TileMapBand };
-//# sourceMappingURL=TileMapBand.js.map
+//# sourceMappingURL=TileMapBand.js.map

package/dist/esm/TileMapBand.js.map

@@ -1 +1 @@
-{"version":3,"file":"TileMapBand.js","sources":["../../../src/TileMapBand.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BG;AACG,MAAO,WAAY,SAAQ,SAAS,CAAA;AACxC;;;;AAIG;IACa,IAAI,GAAG,EAAE;AAER,IAAA,WAAW;IACpB,UAAU,GAAG,KAAK;AAE1B;;;;;AAKG;IACH,WAAA,CAAmB,IAAY,EAAE,UAAoC,EAAA;AACnE,QAAA,KAAK,EAAE;AAEP,QAAA,IAAI,CAAC,IAAI,GAAG,IAAI;AAChB,QAAA,IAAI,CAAC,WAAW,GAAG,CAAC,GAAG,UAAU,CAAC;AAElC,QAAA,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,WAAW,EAAE;AACnC,YAAA,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QACrB;IACF;AAEA;;;;;AAKG;AACH,IAAA,IAAW,UAAU,GAAA;QACnB,OAAO,IAAI,CAAC,WAAW;IACzB;;AAGO,IAAA,gBAAgB,CAAC,EAAU,EAAA;AAChC,QAAA,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC;IAC5D;;AAGA,IAAA,IAAW,OAAO,GAAA;AAChB,QAAA,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC;IACtC;AAEA;;;;;AAKG;IACa,YAAY,GAAA;AAC1B,QAAA,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE;QAEpB,IAAI,eAAe,GAAG,KAAK;AAE3B,QAAA,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE;AACjC,YAAA,IAAI,KAAK,CAAC,OAAO,EAAE;gBACjB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;gBACvC,eAAe,GAAG,IAAI;YACxB;QACF;QAEA,IAAI,CAAC,eAAe,EAAE;AACpB,YAAA,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACxE;AAEA,QAAA,OAAO,IAAI;IACb;AAEA;;;;;;AAMG;AACI,IAAA,MAAM,CAAC,IAAmB,EAAA;QAC/B,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE;AACpC,YAAA,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;QAC7B;AAEA,QAAA,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;IACrB;AAEA;;;;AAIG;AACI,IAAA,QAAQ,CAAC,IAAmB,EAAA;QACjC,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC;AAE5C,QAAA,IAAI,KAAK,KAAK,EAAE,EAAE;YAChB,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QACnC;AAEA,QAAA,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,EAAE;AACxB,YAAA,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QACxB;IACF;AAEA;;;;;;AAMG;AACI,IAAA,QAAQ,CAAC,iBAA8C,EAAA;AAC5D,QAAA,IAAI,CAAC,WAAW,CAAC,IAAI,CACnB,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAC9F;AAED,QAAA,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,WAAW,EAAE;AACnC,YAAA,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,EAAE;AACxB,gBAAA,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;YACrB;QACF;IACF;AAEA;;;;;;;AAOG;IACa,OAAO,GAAA;AACrB,QAAA,IAAI,IAAI,CAAC,UAAU,EAAE;YACnB;QACF;AACA,QAAA,IAAI,CAAC,UAAU,GAAG,IAAI;AAEtB,QAAA,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,IAAI,CAAC;QAE9B,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC;AAEnC,QAAA,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC;QAE3B,KAAK,CAAC,OAAO,EAAE;AAEf,QAAA,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE;AACxB,YAAA,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,IAAI,CAAC;YAC9B,IAAI,CAAC,OAAO,EAAE;QAChB;IACF;AACD;;;;"}
+{"version":3,"file":"TileMapBand.js","names":[],"sources":["../../src/TileMapBand.ts"],"sourcesContent":["import { Container } from '@codexo/exojs';\n\nimport type { ImageLayer } from './ImageLayer';\nimport type { ImageLayerNode } from './ImageLayerNode';\nimport type { TileLayer } from './TileLayer';\nimport type { TileLayerNode } from './TileLayerNode';\n\n/**\n * A named, ordered group of layer nodes ({@link TileLayerNode}s and\n * {@link ImageLayerNode}s) produced by a {@link TileMapView} for ergonomic\n * actor interleaving.\n *\n * A band is a plain {@link Container} scene node that the application parents\n * wherever it wants (typically directly under its own world root). Bands are\n * composition units only: a band owns **its generated layer nodes** and\n * never application actors. Placing actors *between* bands is done by parenting\n * the bands and the actor containers as siblings in the desired document order:\n *\n * ```ts\n * worldRoot.addChild(view.band('ground'), actors, view.band('roof'));\n * ```\n *\n * **Rendering order within a band always follows map document order**\n * ({@link import('./TileMap').TileMap.renderableLayers}), not the order layers\n * were listed in the band definition - band membership *selects* layers; it\n * never reorders them. Tile and image members interleave exactly as the map's\n * combined document order dictates.\n *\n * **Ownership:** the band owns the layer nodes it was created with. Destroying\n * the band destroys those layer nodes (and their cached chunk geometry) and\n * detaches the band from its application parent - it never touches application\n * actors, sibling bands, the {@link TileMap}, the {@link TileLayer}s /\n * {@link ImageLayer}s, or Loader-owned textures.\n *\n * Bounds are the union of the band's layer-node bounds (an empty band\n * collapses to a degenerate rect at the band's transformed origin).\n *\n * Bands are created by {@link TileMapView}; construct them through\n * {@link TileMapView} rather than directly.\n *\n * @advanced\n */\nexport class TileMapBand extends Container {\n  /**\n   * The band name (unique within its owning {@link TileMapView}). Narrows the\n   * inherited {@link SceneNode.name} from `string | null` to a required string;\n   * assigned once at construction.\n   */\n  public override name = '';\n\n  private readonly _layerNodes: Array<TileLayerNode | ImageLayerNode>;\n  private _destroyed = false;\n\n  /**\n   * @param name       The band name (unique within its owning view).\n   * @param layerNodes The layer nodes composing this band, already ordered by\n   *                   map document order. Adopted as children.\n   * @internal Constructed by {@link TileMapView}.\n   */\n  public constructor(name: string, layerNodes: ReadonlyArray<TileLayerNode | ImageLayerNode>) {\n    super();\n\n    this.name = name;\n    this._layerNodes = [...layerNodes];\n\n    for (const node of this._layerNodes) {\n      this.addChild(node);\n    }\n  }\n\n  /**\n   * The layer nodes that compose this band, in map document order - tile and\n   * image members interleaved. This is the band's **membership** list (the\n   * nodes it owns and destroys); it may differ from {@link Container.children}\n   * if the caller reparents an individual layer node elsewhere.\n   */\n  public get layerNodes(): ReadonlyArray<TileLayerNode | ImageLayerNode> {\n    return this._layerNodes;\n  }\n\n  /**\n   * Find this band's layer node rendering the layer with the given id (tile or\n   * image member; first match in document order).\n   */\n  public getLayerNodeById(id: number): TileLayerNode | ImageLayerNode | undefined {\n    return this._layerNodes.find(node => node.layer.id === id);\n  }\n\n  /** Whether this band currently owns no layer nodes. */\n  public get isEmpty(): boolean {\n    return this._layerNodes.length === 0;\n  }\n\n  /**\n   * Bounds are the union of the band's visible layer-node bounds. With no\n   * visible children the band collapses to a degenerate rect at its transformed\n   * origin (rather than the whole-subtree-plus-origin union a bare Container\n   * would report).\n   */\n  public override updateBounds(): this {\n    this._bounds.reset();\n\n    let hasVisibleChild = false;\n\n    for (const child of this.children) {\n      if (child.visible) {\n        this._bounds.addRect(child.getBounds());\n        hasVisibleChild = true;\n      }\n    }\n\n    if (!hasVisibleChild) {\n      this._bounds.addRect(this.getLocalBounds(), this.getGlobalTransform());\n    }\n\n    return this;\n  }\n\n  /**\n   * Adopt a freshly created layer node into this band (used by\n   * {@link TileMapView.refreshLayers} when a newly added map layer joins this\n   * band). Appended; call {@link TileMapBand._reorder} afterwards to restore\n   * map document order.\n   * @internal\n   */\n  public _adopt(node: TileLayerNode | ImageLayerNode): void {\n    if (!this._layerNodes.includes(node)) {\n      this._layerNodes.push(node);\n    }\n\n    this.addChild(node);\n  }\n\n  /**\n   * Drop a layer node from this band's membership without destroying it (used\n   * when its map layer was removed; the view destroys the node separately).\n   * @internal\n   */\n  public _release(node: TileLayerNode | ImageLayerNode): void {\n    const index = this._layerNodes.indexOf(node);\n\n    if (index !== -1) {\n      this._layerNodes.splice(index, 1);\n    }\n\n    if (node.parent === this) {\n      this.removeChild(node);\n    }\n  }\n\n  /**\n   * Reorder this band's membership and its still-parented children to map\n   * document order. `documentIndex` maps a layer **instance** to its index in\n   * the map's combined document order - keyed by instance rather than id\n   * because a tile layer and an image layer may share an id in fallback-ordered\n   * maps. Layer nodes the caller has reparented away from this band keep their\n   * membership (for ownership) but are not re-adopted.\n   * @internal\n   */\n  public _reorder(documentIndex: ReadonlyMap<TileLayer | ImageLayer, number>): void {\n    this._layerNodes.sort((a, b) => (documentIndex.get(a.layer) ?? 0) - (documentIndex.get(b.layer) ?? 0));\n\n    for (const node of this._layerNodes) {\n      if (node.parent === this) {\n        this.addChild(node);\n      }\n    }\n  }\n\n  /**\n   * Destroy the band: detach it from its application parent, then destroy the\n   * layer nodes it owns (freeing their chunk geometry / image sprites).\n   * Application actors, sibling bands, the map, layers, and Loader-owned\n   * textures are untouched.\n   *\n   * Idempotent: a second call (e.g. when {@link TileMapView.destroy} runs after\n   * the application already destroyed this band directly) is a safe no-op.\n   */\n  public override destroy(): void {\n    if (this._destroyed) {\n      return;\n    }\n    this._destroyed = true;\n\n    this.parent?.removeChild(this);\n\n    const owned = [...this._layerNodes];\n\n    this._layerNodes.length = 0;\n\n    super.destroy();\n\n    for (const node of owned) {\n      node.parent?.removeChild(node);\n      node.destroy();\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0CA,IAAa,cAAb,cAAiC,UAAU;;;;;;CAMzC,AAAgB,OAAO;CAEvB,AAAiB;CACjB,AAAQ,aAAa;;;;;;;CAQrB,AAAO,YAAY,MAAc,YAA2D;EAC1F,MAAM;EAEN,KAAK,OAAO;EACZ,KAAK,cAAc,CAAC,GAAG,UAAU;EAEjC,KAAK,MAAM,QAAQ,KAAK,aACtB,KAAK,SAAS,IAAI;CAEtB;;;;;;;CAQA,IAAW,aAA4D;EACrE,OAAO,KAAK;CACd;;;;;CAMA,AAAO,iBAAiB,IAAwD;EAC9E,OAAO,KAAK,YAAY,MAAK,SAAQ,KAAK,MAAM,OAAO,EAAE;CAC3D;;CAGA,IAAW,UAAmB;EAC5B,OAAO,KAAK,YAAY,WAAW;CACrC;;;;;;;CAQA,AAAgB,eAAqB;EACnC,KAAK,QAAQ,MAAM;EAEnB,IAAI,kBAAkB;EAEtB,KAAK,MAAM,SAAS,KAAK,UACvB,IAAI,MAAM,SAAS;GACjB,KAAK,QAAQ,QAAQ,MAAM,UAAU,CAAC;GACtC,kBAAkB;EACpB;EAGF,IAAI,CAAC,iBACH,KAAK,QAAQ,QAAQ,KAAK,eAAe,GAAG,KAAK,mBAAmB,CAAC;EAGvE,OAAO;CACT;;;;;;;;CASA,AAAO,OAAO,MAA4C;EACxD,IAAI,CAAC,KAAK,YAAY,SAAS,IAAI,GACjC,KAAK,YAAY,KAAK,IAAI;EAG5B,KAAK,SAAS,IAAI;CACpB;;;;;;CAOA,AAAO,SAAS,MAA4C;EAC1D,MAAM,QAAQ,KAAK,YAAY,QAAQ,IAAI;EAE3C,IAAI,UAAU,IACZ,KAAK,YAAY,OAAO,OAAO,CAAC;EAGlC,IAAI,KAAK,WAAW,MAClB,KAAK,YAAY,IAAI;CAEzB;;;;;;;;;;CAWA,AAAO,SAAS,eAAkE;EAChF,KAAK,YAAY,MAAM,GAAG,OAAO,cAAc,IAAI,EAAE,KAAK,KAAK,MAAM,cAAc,IAAI,EAAE,KAAK,KAAK,EAAE;EAErG,KAAK,MAAM,QAAQ,KAAK,aACtB,IAAI,KAAK,WAAW,MAClB,KAAK,SAAS,IAAI;CAGxB;;;;;;;;;;CAWA,AAAgB,UAAgB;EAC9B,IAAI,KAAK,YACP;EAEF,KAAK,aAAa;EAElB,KAAK,QAAQ,YAAY,IAAI;EAE7B,MAAM,QAAQ,CAAC,GAAG,KAAK,WAAW;EAElC,KAAK,YAAY,SAAS;EAE1B,MAAM,QAAQ;EAEd,KAAK,MAAM,QAAQ,OAAO;GACxB,KAAK,QAAQ,YAAY,IAAI;GAC7B,KAAK,QAAQ;EACf;CACF;AACF"}