@vworlds/vecs-phaser-server 1.0.35 → 1.0.37

package/asset.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Base class for every asset the server owns. v1.0.36 has one concrete kind —
+ * `TilesetAsset` — but future kinds (audio, etc.) extend this with their own
+ * `Asset` subclass and one `getX(key)` method each on `AssetManager`.
+ *
+ * `id` is server-assigned, stable, and append-only: allocated the first time an
+ * asset is loaded, never reused or reordered, so a future in-band "asset added"
+ * message can extend the catalog at runtime without disturbing v1.0.36.
+ *
+ * `key` is the human authoring/debug name — it never crosses the wire; the
+ * client keys Phaser textures by the numeric `id`.
+ */
+export declare abstract class Asset {
+    /**
+     * Stable, append-only wire id. Server-assigned on first load; reused on
+     * subsequent `getTileset(key)` calls.
+     */
+    readonly id: number;
+    /** Human authoring/debug key (filename stem). Server-only. */
+    readonly key: string;
+    /**
+     * @param id  - Server-assigned stable wire id.
+     * @param key - Human authoring/debug key.
+     */
+    constructor(id: number, key: string);
+}

package/asset.js

@@ -0,0 +1,23 @@
+/**
+ * Base class for every asset the server owns. v1.0.36 has one concrete kind —
+ * `TilesetAsset` — but future kinds (audio, etc.) extend this with their own
+ * `Asset` subclass and one `getX(key)` method each on `AssetManager`.
+ *
+ * `id` is server-assigned, stable, and append-only: allocated the first time an
+ * asset is loaded, never reused or reordered, so a future in-band "asset added"
+ * message can extend the catalog at runtime without disturbing v1.0.36.
+ *
+ * `key` is the human authoring/debug name — it never crosses the wire; the
+ * client keys Phaser textures by the numeric `id`.
+ */
+export class Asset {
+    /**
+     * @param id  - Server-assigned stable wire id.
+     * @param key - Human authoring/debug key.
+     */
+    constructor(id, key) {
+        this.id = id;
+        this.key = key;
+    }
+}
+//# sourceMappingURL=asset.js.map

package/asset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset.js","sourceRoot":"","sources":["../src/asset.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,OAAgB,KAAK;IAUzB;;;OAGG;IACH,YAAY,EAAU,EAAE,GAAW;QACjC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;CACF"}

package/asset_manager.d.ts

@@ -0,0 +1,91 @@
+import { type AssetCatalog } from "@vworlds/vecs-phaser";
+import { TilesetAsset } from "./tileset_asset.js";
+/** Error thrown when a tileset cannot be found on disk. */
+export declare class TilesetNotFoundError extends Error {
+    /** @param message - Human-readable error message. */
+    constructor(message: string);
+}
+/** Error thrown when a cached/loaded asset is not the requested kind. */
+export declare class AssetKindMismatchError extends Error {
+    /** @param message - Human-readable error message. */
+    constructor(message: string);
+}
+/** Error thrown when a tileset violates the v1.0.36 single-image scope guard. */
+export declare class ImageCollectionTilesetError extends Error {
+    /** @param message - Human-readable error message. */
+    constructor(message: string);
+}
+/** Constructor options for {@link AssetManager}. */
+export interface AssetManagerOptions {
+    /** Root asset directory (e.g. `"assets"`). Tilesets live under `tilesets/`. */
+    assetsPath: string;
+}
+/**
+ * Server-side asset loader + cache of typed asset handles. v1.0.36 has one asset
+ * type — **tileset**; future kinds add their own `Asset` subclass and one
+ * `getX(key)` method each.
+ *
+ * `getTileset(key)` reads `assetsPath/tilesets/<key>.tsj` (falling back to
+ * `<key>.json`), parses with a `JSON.parse` reviver that constructs live
+ * `TilesetAsset`/`Tile`/`MapObject` instances (not plain data bags), assigns a
+ * stable append-only `id`, and caches by the human key so a second call returns
+ * the same handle. Image **bytes** are never read server-side — only metadata;
+ * bytes are served over HTTP by `mount`.
+ *
+ * `toCatalog(worldName)` enumerates cached assets into the wire DTO
+ * (`AssetCatalog`), stripping server-only metadata. `mount(app, worldName)`
+ * registers the catalog JSON route and a static file route over `assetsPath`.
+ */
+export declare class AssetManager {
+    /** Root asset directory. */
+    readonly assetsPath: string;
+    /** Cache of loaded assets keyed by human key (same handle on re-get). */
+    private readonly _cache;
+    /** Next server-assigned wire id (append-only, starts at 1). */
+    private _nextId;
+    /**
+     * @param options - `{ assetsPath }` root asset directory.
+     */
+    constructor(options: AssetManagerOptions);
+    /**
+     * Load (or return cached) `TilesetAsset` by human key. Reads
+     * `assetsPath/tilesets/<key>.tsj`, falling back to `<key>.json`. The first call
+     * parses via `JSON.parse(text, reviver)` constructing live instances, assigns
+     * a stable `id`, and caches; subsequent calls return the same handle.
+     *
+     * @param key - Human key (filename stem).
+     * @returns The loaded `TilesetAsset`.
+     * @throws {TilesetNotFoundError} when neither `<key>.tsj` nor `<key>.json` exists.
+     * @throws {AssetKindMismatchError} when a different asset kind is cached under `key`.
+     * @throws {ImageCollectionTilesetError} when the tileset is an image-collection.
+     */
+    getTileset(key: string): TilesetAsset;
+    /**
+     * Enumerate all cached assets into a wire `AssetCatalog` DTO, stripping
+     * server-only metadata (no properties/objects/animation/class on the
+     * descriptors). Each spritesheet descriptor's `url` is the server path the
+     * static route serves.
+     *
+     * @param worldName    - Name of the world this catalog describes.
+     * @param apiBasePath   - API base path (default `"/rtc/v1/world"`).
+     * @returns The `AssetCatalog` DTO.
+     */
+    toCatalog(worldName: string, apiBasePath?: string): AssetCatalog;
+    /**
+     * Register the catalog JSON route and a static file route over `assetsPath`
+     * on the given Express app, under the per-world `worldPath(apiBasePath,
+     * worldName)`.
+     *
+     * - `GET {worldPath}/assets` → `toCatalog(worldName, apiBasePath)` JSON.
+     * - `{worldPath}/assets/files` → `express.static(assetsPath)` (serves images).
+     *
+     * @param app         - Express app instance.
+     * @param worldName   - Name of the world.
+     * @param apiBasePath - API base path (default `"/rtc/v1/world"`).
+     */
+    mount(app: import("express").Express, worldName: string, apiBasePath?: string): void;
+    /** Load a `TilesetAsset` from disk, parse with the reviver, assign an id. */
+    private _loadTileset;
+    /** Build a live `TilesetAsset` from raw input, applying scope guards + defaults. */
+    private _buildTileset;
+}

package/asset_manager.js

@@ -0,0 +1,198 @@
+import { readFileSync } from "node:fs";
+import { dirname, isAbsolute, join, normalize, relative, sep } from "node:path";
+import express from "express";
+import { worldPath } from "@vworlds/vecs-protocol";
+import { TilesetAsset, buildTiles } from "./tileset_asset.js";
+/** Error thrown when a tileset cannot be found on disk. */
+export class TilesetNotFoundError extends Error {
+    /** @param message - Human-readable error message. */
+    constructor(message) {
+        super(message);
+        this.name = "TilesetNotFoundError";
+    }
+}
+/** Error thrown when a cached/loaded asset is not the requested kind. */
+export class AssetKindMismatchError extends Error {
+    /** @param message - Human-readable error message. */
+    constructor(message) {
+        super(message);
+        this.name = "AssetKindMismatchError";
+    }
+}
+/** Error thrown when a tileset violates the v1.0.36 single-image scope guard. */
+export class ImageCollectionTilesetError extends Error {
+    /** @param message - Human-readable error message. */
+    constructor(message) {
+        super(message);
+        this.name = "ImageCollectionTilesetError";
+    }
+}
+/**
+ * Server-side asset loader + cache of typed asset handles. v1.0.36 has one asset
+ * type — **tileset**; future kinds add their own `Asset` subclass and one
+ * `getX(key)` method each.
+ *
+ * `getTileset(key)` reads `assetsPath/tilesets/<key>.tsj` (falling back to
+ * `<key>.json`), parses with a `JSON.parse` reviver that constructs live
+ * `TilesetAsset`/`Tile`/`MapObject` instances (not plain data bags), assigns a
+ * stable append-only `id`, and caches by the human key so a second call returns
+ * the same handle. Image **bytes** are never read server-side — only metadata;
+ * bytes are served over HTTP by `mount`.
+ *
+ * `toCatalog(worldName)` enumerates cached assets into the wire DTO
+ * (`AssetCatalog`), stripping server-only metadata. `mount(app, worldName)`
+ * registers the catalog JSON route and a static file route over `assetsPath`.
+ */
+export class AssetManager {
+    /**
+     * @param options - `{ assetsPath }` root asset directory.
+     */
+    constructor(options) {
+        /** Cache of loaded assets keyed by human key (same handle on re-get). */
+        this._cache = new Map();
+        /** Next server-assigned wire id (append-only, starts at 1). */
+        this._nextId = 1;
+        this.assetsPath = options.assetsPath;
+    }
+    /**
+     * Load (or return cached) `TilesetAsset` by human key. Reads
+     * `assetsPath/tilesets/<key>.tsj`, falling back to `<key>.json`. The first call
+     * parses via `JSON.parse(text, reviver)` constructing live instances, assigns
+     * a stable `id`, and caches; subsequent calls return the same handle.
+     *
+     * @param key - Human key (filename stem).
+     * @returns The loaded `TilesetAsset`.
+     * @throws {TilesetNotFoundError} when neither `<key>.tsj` nor `<key>.json` exists.
+     * @throws {AssetKindMismatchError} when a different asset kind is cached under `key`.
+     * @throws {ImageCollectionTilesetError} when the tileset is an image-collection.
+     */
+    getTileset(key) {
+        const cached = this._cache.get(key);
+        if (cached !== undefined) {
+            if (!(cached instanceof TilesetAsset)) {
+                throw new AssetKindMismatchError(`Asset "${key}" is not a TilesetAsset (got ${cached.constructor.name})`);
+            }
+            return cached;
+        }
+        const asset = this._loadTileset(key);
+        this._cache.set(key, asset);
+        return asset;
+    }
+    /**
+     * Enumerate all cached assets into a wire `AssetCatalog` DTO, stripping
+     * server-only metadata (no properties/objects/animation/class on the
+     * descriptors). Each spritesheet descriptor's `url` is the server path the
+     * static route serves.
+     *
+     * @param worldName    - Name of the world this catalog describes.
+     * @param apiBasePath   - API base path (default `"/rtc/v1/world"`).
+     * @returns The `AssetCatalog` DTO.
+     */
+    toCatalog(worldName, apiBasePath = "/rtc/v1/world") {
+        const base = worldPath(apiBasePath, worldName);
+        const assets = [];
+        for (const asset of this._cache.values()) {
+            if (asset instanceof TilesetAsset) {
+                const descriptor = {
+                    id: asset.id,
+                    key: asset.key,
+                    kind: "spritesheet",
+                    url: `${base}/assets/files/${asset.image}`,
+                    frameWidth: asset.frameWidth,
+                    frameHeight: asset.frameHeight,
+                    margin: asset.margin,
+                    spacing: asset.spacing,
+                    columns: asset.columns,
+                    tileCount: asset.tileCount,
+                    imageWidth: asset.imageWidth,
+                    imageHeight: asset.imageHeight,
+                };
+                assets.push(descriptor);
+            }
+        }
+        return { worldName, assets };
+    }
+    /**
+     * Register the catalog JSON route and a static file route over `assetsPath`
+     * on the given Express app, under the per-world `worldPath(apiBasePath,
+     * worldName)`.
+     *
+     * - `GET {worldPath}/assets` → `toCatalog(worldName, apiBasePath)` JSON.
+     * - `{worldPath}/assets/files` → `express.static(assetsPath)` (serves images).
+     *
+     * @param app         - Express app instance.
+     * @param worldName   - Name of the world.
+     * @param apiBasePath - API base path (default `"/rtc/v1/world"`).
+     */
+    mount(app, worldName, apiBasePath = "/rtc/v1/world") {
+        const base = worldPath(apiBasePath, worldName);
+        app.get(`${base}/assets`, (_req, res) => {
+            res.json(this.toCatalog(worldName, apiBasePath));
+        });
+        app.use(`${base}/assets/files`, express.static(this.assetsPath));
+    }
+    /** Load a `TilesetAsset` from disk, parse with the reviver, assign an id. */
+    _loadTileset(key) {
+        const tsjPath = join(this.assetsPath, "tilesets", `${key}.tsj`);
+        const jsonPath = join(this.assetsPath, "tilesets", `${key}.json`);
+        let text;
+        let filePath;
+        try {
+            text = readFileSync(tsjPath, "utf8");
+            filePath = tsjPath;
+        }
+        catch {
+            try {
+                text = readFileSync(jsonPath, "utf8");
+                filePath = jsonPath;
+            }
+            catch {
+                throw new TilesetNotFoundError(`No tileset "${key}" found at ${tsjPath} or ${jsonPath}`);
+            }
+        }
+        const tileset = JSON.parse(text, (revKey, value) => revKey === "" ? this._buildTileset(key, filePath, value) : value);
+        return tileset;
+    }
+    /** Build a live `TilesetAsset` from raw input, applying scope guards + defaults. */
+    _buildTileset(key, filePath, raw) {
+        if (raw.image === undefined || raw.image === "") {
+            throw new ImageCollectionTilesetError(`Tileset "${key}" has no top-level image (image-collection tilesets are not supported in v1.0.36)`);
+        }
+        if (raw.tiles) {
+            for (const tile of raw.tiles) {
+                if (tile.image !== undefined && tile.image !== "") {
+                    throw new ImageCollectionTilesetError(`Tileset "${key}" tile ${tile.id} carries its own image (image-collection tilesets are not supported in v1.0.36)`);
+                }
+            }
+        }
+        const tilesetImage = raw.image;
+        const resolvedImage = resolveImageRelative(this.assetsPath, filePath, tilesetImage);
+        const tiles = buildTiles(raw.tiles);
+        const id = this._nextId++;
+        return new TilesetAsset(id, key, resolvedImage, raw.tilewidth ?? 0, raw.tileheight ?? 0, raw.margin ?? 0, raw.spacing ?? 0, raw.columns ?? 0, raw.tilecount ?? 0, raw.imagewidth ?? 0, raw.imageheight ?? 0, raw.name ?? "", 
+        // The tileset "Class" comes from `class` only. A tileset's top-level
+        // `type` is Tiled's file-format discriminator (`"tileset"`/`"map"`), not a
+        // class, so it must NOT be used as a fallback (unlike a *tile*'s `type`,
+        // which is that tile's class — see buildTile in tileset_asset.ts).
+        raw.class ?? "", raw.properties ?? [], tiles);
+    }
+}
+/**
+ * Resolve a tileset `image` path: the `image` field is relative to the `.tsj`
+ * file location; express it relative to `assetsPath` in POSIX form.
+ *
+ * Example: `.tsj` at `assets/tilesets/ship.tsj` + image `ship.png` ⇒
+ * `"tilesets/ship.png"`.
+ *
+ * @param assetsPath - Root asset directory.
+ * @param filePath   - Absolute or relative path to the `.tsj`/`.json` file.
+ * @param image      - Image path relative to the `.tsj` (Tiled `image` field).
+ * @returns Image path relative to `assetsPath`, POSIX-separated.
+ */
+function resolveImageRelative(assetsPath, filePath, image) {
+    const fileDir = dirname(filePath);
+    const absoluteImage = isAbsolute(image) ? image : join(fileDir, image);
+    const rel = relative(assetsPath, absoluteImage);
+    return normalize(rel).split(sep).join("/");
+}
+//# sourceMappingURL=asset_manager.js.map

package/asset_manager.js.map

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

package/index.d.ts

@@ -1 +1,7 @@
 export { PhaserServerModule } from "./PhaserServerModule.js";
+export { Asset } from "./asset.js";
+export { MapObject, Tile } from "./tile.js";
+export { TilesetAsset } from "./tileset_asset.js";
+export { AssetManager, AssetKindMismatchError, ImageCollectionTilesetError, TilesetNotFoundError, } from "./asset_manager.js";
+export type { AssetManagerOptions } from "./asset_manager.js";
+export type { AnyProperty, Frame, Point, Property, PropertyType, Tile as TileIface, Tileset, } from "./types/tileset.js";

package/index.js

@@ -1,2 +1,6 @@
 export { PhaserServerModule } from "./PhaserServerModule.js";
+export { Asset } from "./asset.js";
+export { MapObject, Tile } from "./tile.js";
+export { TilesetAsset } from "./tileset_asset.js";
+export { AssetManager, AssetKindMismatchError, ImageCollectionTilesetError, TilesetNotFoundError, } from "./asset_manager.js";
 //# sourceMappingURL=index.js.map

package/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EACL,YAAY,EACZ,sBAAsB,EACtB,2BAA2B,EAC3B,oBAAoB,GACrB,MAAM,oBAAoB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vworlds/vecs-phaser-server",
-  "version": "1.0.35",
+  "version": "1.0.37",
   "type": "module",
   "main": "./index.js",
   "types": "./index.d.ts",
@@ -15,9 +15,13 @@
     "url": "git+https://github.com/vworlds/vecs.git"
   },
   "dependencies": {
-    "@vworlds/vecs-phaser": "1.0.35",
-    "@vworlds/vecs-physics": "1.0.35",
-    "@vworlds/vecs-server": "1.0.35"
+    "@vworlds/vecs-phaser": "1.0.37",
+    "@vworlds/vecs-physics": "1.0.37",
+    "@vworlds/vecs-protocol": "1.0.37",
+    "@vworlds/vecs-server": "1.0.37"
+  },
+  "peerDependencies": {
+    "express": "^5.2.1"
   },
   "license": "MIT"
 }

package/tile.d.ts

@@ -0,0 +1,94 @@
+import { type AnyProperty, type Frame, type MapObject as MapObjectIface, type Tile as TileIface } from "./types/tileset.js";
+/**
+ * Concrete `MapObject` — a collision/anchor shape on a tile. `implements` the
+ * vendored `MapObject` interface (no `?`): sparse Tiled shape flags become
+ * non-null defaults (`false`/`[]`/`0`/`""`) supplied at construction time.
+ *
+ * A plain rectangle has none of `ellipse`/`point`/`polygon`/`polyline` set. A
+ * circle is an ellipse with equal `width`/`height` (Tiled has no dedicated
+ * circle flag).
+ */
+export declare class MapObject implements MapObjectIface {
+    /** Unique id across all objects in the tileset. */
+    readonly id: number;
+    /** X coordinate (px). */
+    x: number;
+    /** Y coordinate (px). */
+    y: number;
+    /** Width (px); `0` when Tiled omits it. */
+    width: number;
+    /** Height (px); `0` when Tiled omits it. */
+    height: number;
+    /** Rotation in degrees clockwise; `0` when Tiled omits it. */
+    rotation: number;
+    /** Name; `""` when Tiled omits it. */
+    name: string;
+    /** Object "Class"; `""` when Tiled omits it. */
+    type: string;
+    /** `true` if ellipse (a circle is an ellipse with equal dims). */
+    ellipse: boolean;
+    /** `true` if point. */
+    point: boolean;
+    /** Polygon points; `[]` when not a polygon. */
+    polygon: {
+        x: number;
+        y: number;
+    }[];
+    /** Polyline points; `[]` when not a polyline. */
+    polyline: {
+        x: number;
+        y: number;
+    }[];
+    /**
+     * @param id       - Unique id across all objects in the tileset.
+     * @param x        - X coordinate (px).
+     * @param y        - Y coordinate (px).
+     * @param width    - Width (px).
+     * @param height   - Height (px).
+     * @param rotation - Rotation in degrees clockwise.
+     * @param name     - Name.
+     * @param type     - Object "Class".
+     * @param ellipse  - `true` if ellipse.
+     * @param point    - `true` if point.
+     * @param polygon  - Polygon points (`[]` when not a polygon).
+     * @param polyline - Polyline points (`[]` when not a polyline).
+     */
+    constructor(id: number, x: number, y: number, width: number, height: number, rotation: number, name: string, type: string, ellipse: boolean, point: boolean, polygon: {
+        x: number;
+        y: number;
+    }[], polyline: {
+        x: number;
+        y: number;
+    }[]);
+}
+/**
+ * Concrete `Tile` — a single tile in a `TilesetAsset`, carrying the per-tile
+ * Tiled metadata the server reads (game-logic data) but the wire never
+ * carries. `implements` the vendored `Tile` interface (no `?`): sparse Tiled
+ * fields become non-null empty defaults (`""`/`[]`/empty `Map`) supplied at
+ * construction time.
+ *
+ * `id` equals the Phaser spritesheet frame index (row-major), so
+ * `set(Image, { texture: ship.id, frame: tileId })` shows this exact tile and
+ * `tileset.tile(tileId)` returns its metadata.
+ */
+export declare class Tile implements TileIface {
+    /** Local tile id (== Phaser frame index, row-major). */
+    readonly id: number;
+    /** Tile "Class" (Tiled `class`/`type`); `""` when absent. */
+    class: string;
+    /** Typed properties, preserved as-is; `[]` when absent. */
+    properties: AnyProperty[];
+    /** Collision/anchor shapes keyed by `MapObject.id`; empty `Map` when absent. */
+    objects: Map<number, MapObject>;
+    /** Animation frames (captured for the future `Sprite` feature); `[]` when absent. */
+    animation: Frame[];
+    /**
+     * @param id         - Local tile id (== Phaser frame index).
+     * @param classField - Tiled `class`/`type` (`""` when absent).
+     * @param properties - Typed properties (`[]` when absent).
+     * @param objects    - Collision/anchor shapes keyed by `MapObject.id` (empty `Map` when absent).
+     * @param animation  - Animation frames (`[]` when absent).
+     */
+    constructor(id: number, classField: string, properties: AnyProperty[], objects: Map<number, MapObject>, animation: Frame[]);
+}

package/tile.js

@@ -0,0 +1,67 @@
+/**
+ * Concrete `MapObject` — a collision/anchor shape on a tile. `implements` the
+ * vendored `MapObject` interface (no `?`): sparse Tiled shape flags become
+ * non-null defaults (`false`/`[]`/`0`/`""`) supplied at construction time.
+ *
+ * A plain rectangle has none of `ellipse`/`point`/`polygon`/`polyline` set. A
+ * circle is an ellipse with equal `width`/`height` (Tiled has no dedicated
+ * circle flag).
+ */
+export class MapObject {
+    /**
+     * @param id       - Unique id across all objects in the tileset.
+     * @param x        - X coordinate (px).
+     * @param y        - Y coordinate (px).
+     * @param width    - Width (px).
+     * @param height   - Height (px).
+     * @param rotation - Rotation in degrees clockwise.
+     * @param name     - Name.
+     * @param type     - Object "Class".
+     * @param ellipse  - `true` if ellipse.
+     * @param point    - `true` if point.
+     * @param polygon  - Polygon points (`[]` when not a polygon).
+     * @param polyline - Polyline points (`[]` when not a polyline).
+     */
+    constructor(id, x, y, width, height, rotation, name, type, ellipse, point, polygon, polyline) {
+        this.id = id;
+        this.x = x;
+        this.y = y;
+        this.width = width;
+        this.height = height;
+        this.rotation = rotation;
+        this.name = name;
+        this.type = type;
+        this.ellipse = ellipse;
+        this.point = point;
+        this.polygon = polygon;
+        this.polyline = polyline;
+    }
+}
+/**
+ * Concrete `Tile` — a single tile in a `TilesetAsset`, carrying the per-tile
+ * Tiled metadata the server reads (game-logic data) but the wire never
+ * carries. `implements` the vendored `Tile` interface (no `?`): sparse Tiled
+ * fields become non-null empty defaults (`""`/`[]`/empty `Map`) supplied at
+ * construction time.
+ *
+ * `id` equals the Phaser spritesheet frame index (row-major), so
+ * `set(Image, { texture: ship.id, frame: tileId })` shows this exact tile and
+ * `tileset.tile(tileId)` returns its metadata.
+ */
+export class Tile {
+    /**
+     * @param id         - Local tile id (== Phaser frame index).
+     * @param classField - Tiled `class`/`type` (`""` when absent).
+     * @param properties - Typed properties (`[]` when absent).
+     * @param objects    - Collision/anchor shapes keyed by `MapObject.id` (empty `Map` when absent).
+     * @param animation  - Animation frames (`[]` when absent).
+     */
+    constructor(id, classField, properties, objects, animation) {
+        this.id = id;
+        this.class = classField;
+        this.properties = properties;
+        this.objects = objects;
+        this.animation = animation;
+    }
+}
+//# sourceMappingURL=tile.js.map

package/tile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tile.js","sourceRoot":"","sources":["../src/tile.ts"],"names":[],"mappings":"AAOA;;;;;;;;GAQG;AACH,MAAM,OAAO,SAAS;IAqCpB;;;;;;;;;;;;;OAaG;IACH,YACE,EAAU,EACV,CAAS,EACT,CAAS,EACT,KAAa,EACb,MAAc,EACd,QAAgB,EAChB,IAAY,EACZ,IAAY,EACZ,OAAgB,EAChB,KAAc,EACd,OAAmC,EACnC,QAAoC;QAEpC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QACX,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QACX,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF;AAED;;;;;;;;;;GAUG;AACH,MAAM,OAAO,IAAI;IAgBf;;;;;;OAMG;IACH,YACE,EAAU,EACV,UAAkB,EAClB,UAAyB,EACzB,OAA+B,EAC/B,SAAkB;QAElB,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC;QACxB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF"}

package/tileset_asset.d.ts

@@ -0,0 +1,86 @@
+import { Asset } from "./asset.js";
+import { Tile } from "./tile.js";
+import { type AnyProperty, type Tileset, type TileRaw } from "./types/tileset.js";
+/**
+ * Concrete `TilesetAsset` — a single-image Tiled tileset ingested as a
+ * spritesheet. `extends Asset` (carries `id`/`key`) and `implements` the
+ * vendored `Tileset` interface (no `?`): sparse Tiled fields become non-null
+ * empty defaults (`""`/`[]`) supplied at construction time.
+ *
+ * Field-name mapping: Tiled `tilewidth`→`frameWidth`, `tileheight`→
+ * `frameHeight`, `tilecount`→`tileCount`, `imagewidth`→`imageWidth`,
+ * `imageheight`→`imageHeight`. `image` is the resolved image path relative to
+ * `assetsPath`, POSIX-separated (e.g. `"tilesets/ship.png"`), so the static
+ * route serves it at `{worldPath}/assets/files/<image>`.
+ *
+ * `tile(id)` looks up a tile by numeric id (== Phaser frame index, row-major);
+ * `sizeInMeters(ppm)` sizes a physics body to match the art in one call.
+ */
+export declare class TilesetAsset extends Asset implements Tileset {
+    /** Resolved image path relative to `assetsPath`, POSIX-separated. */
+    image: string;
+    /** Tile width (px) — Tiled `tilewidth`. */
+    frameWidth: number;
+    /** Tile height (px) — Tiled `tileheight`. */
+    frameHeight: number;
+    /** Tileset margin (px). */
+    margin: number;
+    /** Tile spacing (px). */
+    spacing: number;
+    /** Tiles per row. */
+    columns: number;
+    /** Total frames — Tiled `tilecount`. */
+    tileCount: number;
+    /** Source image width (px) — Tiled `imagewidth`. */
+    imageWidth: number;
+    /** Source image height (px) — Tiled `imageheight`. */
+    imageHeight: number;
+    /** Tileset name. */
+    name: string;
+    /** Tileset "Class" (Tiled `class`/`type`); `""` when absent. */
+    class: string;
+    /** Typed properties, preserved as-is; `[]` when absent. */
+    properties: AnyProperty[];
+    /** Tiles keyed by numeric id (re-indexed from Tiled's sparse `tiles[]`). */
+    private readonly _tiles;
+    /**
+     * @param id          - Server-assigned stable wire id (from `AssetManager`).
+     * @param key         - Human authoring/debug key (filename stem).
+     * @param image       - Resolved image path relative to `assetsPath`, POSIX.
+     * @param frameWidth  - Tile width (px).
+     * @param frameHeight - Tile height (px).
+     * @param margin      - Tileset margin (px).
+     * @param spacing     - Tile spacing (px).
+     * @param columns     - Tiles per row.
+     * @param tileCount   - Total frames.
+     * @param imageWidth  - Source image width (px).
+     * @param imageHeight - Source image height (px).
+     * @param name        - Tileset name.
+     * @param classField  - Tileset "Class" (`""` when absent).
+     * @param properties  - Typed properties (`[]` when absent).
+     * @param tiles       - Tiles keyed by numeric id (may be empty).
+     */
+    constructor(id: number, key: string, image: string, frameWidth: number, frameHeight: number, margin: number, spacing: number, columns: number, tileCount: number, imageWidth: number, imageHeight: number, name: string, classField: string, properties: AnyProperty[], tiles: Map<number, Tile>);
+    /** Look up a tile by numeric id; `undefined` when not present. */
+    tile(id: number): Tile | undefined;
+    /**
+     * Size a physics body to match the art: `{ w: frameWidth/ppm,
+     * h: frameHeight/ppm }`. PPM stays off the wire (meters everywhere).
+     *
+     * @param ppm - Pixels per meter.
+     * @returns `{ w, h }` in meters.
+     */
+    sizeInMeters(ppm: number): {
+        w: number;
+        h: number;
+    };
+}
+/**
+ * Build the `Tile` instances for a `TilesetAsset` from a raw Tiled `tiles[]`
+ * array, applying the non-null empty defaults for every omitted field. Used by
+ * the reviver to construct concrete tiles from raw input.
+ *
+ * @param rawTiles - Raw Tiled tiles array (may be undefined).
+ * @returns `Map<id, Tile>` keyed by numeric tile id.
+ */
+export declare function buildTiles(rawTiles: TileRaw[] | undefined): Map<number, Tile>;

package/tileset_asset.js

@@ -0,0 +1,102 @@
+import { Asset } from "./asset.js";
+import { MapObject, Tile } from "./tile.js";
+/**
+ * Concrete `TilesetAsset` — a single-image Tiled tileset ingested as a
+ * spritesheet. `extends Asset` (carries `id`/`key`) and `implements` the
+ * vendored `Tileset` interface (no `?`): sparse Tiled fields become non-null
+ * empty defaults (`""`/`[]`) supplied at construction time.
+ *
+ * Field-name mapping: Tiled `tilewidth`→`frameWidth`, `tileheight`→
+ * `frameHeight`, `tilecount`→`tileCount`, `imagewidth`→`imageWidth`,
+ * `imageheight`→`imageHeight`. `image` is the resolved image path relative to
+ * `assetsPath`, POSIX-separated (e.g. `"tilesets/ship.png"`), so the static
+ * route serves it at `{worldPath}/assets/files/<image>`.
+ *
+ * `tile(id)` looks up a tile by numeric id (== Phaser frame index, row-major);
+ * `sizeInMeters(ppm)` sizes a physics body to match the art in one call.
+ */
+export class TilesetAsset extends Asset {
+    /**
+     * @param id          - Server-assigned stable wire id (from `AssetManager`).
+     * @param key         - Human authoring/debug key (filename stem).
+     * @param image       - Resolved image path relative to `assetsPath`, POSIX.
+     * @param frameWidth  - Tile width (px).
+     * @param frameHeight - Tile height (px).
+     * @param margin      - Tileset margin (px).
+     * @param spacing     - Tile spacing (px).
+     * @param columns     - Tiles per row.
+     * @param tileCount   - Total frames.
+     * @param imageWidth  - Source image width (px).
+     * @param imageHeight - Source image height (px).
+     * @param name        - Tileset name.
+     * @param classField  - Tileset "Class" (`""` when absent).
+     * @param properties  - Typed properties (`[]` when absent).
+     * @param tiles       - Tiles keyed by numeric id (may be empty).
+     */
+    constructor(id, key, image, frameWidth, frameHeight, margin, spacing, columns, tileCount, imageWidth, imageHeight, name, classField, properties, tiles) {
+        super(id, key);
+        this.image = image;
+        this.frameWidth = frameWidth;
+        this.frameHeight = frameHeight;
+        this.margin = margin;
+        this.spacing = spacing;
+        this.columns = columns;
+        this.tileCount = tileCount;
+        this.imageWidth = imageWidth;
+        this.imageHeight = imageHeight;
+        this.name = name;
+        this.class = classField;
+        this.properties = properties;
+        this._tiles = tiles;
+    }
+    /** Look up a tile by numeric id; `undefined` when not present. */
+    tile(id) {
+        return this._tiles.get(id);
+    }
+    /**
+     * Size a physics body to match the art: `{ w: frameWidth/ppm,
+     * h: frameHeight/ppm }`. PPM stays off the wire (meters everywhere).
+     *
+     * @param ppm - Pixels per meter.
+     * @returns `{ w, h }` in meters.
+     */
+    sizeInMeters(ppm) {
+        return { w: this.frameWidth / ppm, h: this.frameHeight / ppm };
+    }
+}
+/**
+ * Build the `Tile` instances for a `TilesetAsset` from a raw Tiled `tiles[]`
+ * array, applying the non-null empty defaults for every omitted field. Used by
+ * the reviver to construct concrete tiles from raw input.
+ *
+ * @param rawTiles - Raw Tiled tiles array (may be undefined).
+ * @returns `Map<id, Tile>` keyed by numeric tile id.
+ */
+export function buildTiles(rawTiles) {
+    const map = new Map();
+    if (!rawTiles) {
+        return map;
+    }
+    for (const raw of rawTiles) {
+        const tile = buildTile(raw);
+        map.set(tile.id, tile);
+    }
+    return map;
+}
+/** Build a single `Tile` from raw input, applying non-null empty defaults. */
+function buildTile(raw) {
+    return new Tile(raw.id, raw.class ?? raw.type ?? "", raw.properties ?? [], buildObjects(raw.objectgroup), raw.animation ?? []);
+}
+/** Build the `Map<number, MapObject>` for a tile from a raw `objectgroup`. */
+function buildObjects(objectgroup) {
+    const map = new Map();
+    if (!objectgroup || !objectgroup.objects) {
+        return map;
+    }
+    for (const raw of objectgroup.objects) {
+        const obj = new MapObject(raw.id, raw.x, raw.y, raw.width ?? 0, raw.height ?? 0, raw.rotation ?? 0, raw.name ?? "", raw.type ?? "", raw.ellipse ?? false, raw.point ?? false, (raw.polygon ?? []), (raw.polyline ?? []));
+        map.set(obj.id, obj);
+    }
+    return map;
+}
+//# sourceMappingURL=tileset_asset.js.map

package/tileset_asset.js.map

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

package/types/tileset.d.ts

@@ -0,0 +1,184 @@
+/**
+ * Vendored Tiled schema — bare-minimum interfaces copied from `@kayahr/tiled`
+ * (the authoritative reference), retaining only the fields v1.0.36 uses.
+ *
+ * Two layers live here:
+ *
+ * 1. **Public interfaces** (no `?` on the v1.0.36 fields). Our concrete classes
+ *    (`TilesetAsset`, `Tile`, `MapObject`) `implements` these, so they act as
+ *    the type-check contract. Sparse Tiled fields become REQUIRED here, and the
+ *    concrete classes guarantee non-null empty defaults (`[]`, empty `Map`, `""`,
+ *    `false`, `0`) — consumers never null-check.
+ *
+ * 2. **`*Raw` interfaces** (with `?`) modeling the raw Tiled JSON the reviver
+ *    reads. These carry the original Tiled field names (`tilewidth`, `type`,
+ *    `objectgroup`, …) so the loader can read raw input before constructing the
+ *    concrete tree.
+ *
+ * This file is grown field-by-field as features are added; it never depends on
+ * `@kayahr/tiled` at runtime or build time.
+ */
+/**
+ * Tiled property type discriminant. String/file/color/class serialize as
+ * strings; int/float/object as numbers; bool as boolean. Color values are hex
+ * strings like `"#ffaa00ff"`.
+ */
+export type PropertyType = "string" | "int" | "float" | "bool" | "color" | "file" | "object" | "class";
+/**
+ * A single Tiled typed property. Preserved as-is (NOT flattened to a map) so
+ * declared types like `color`/`int`/`file` survive the round-trip.
+ */
+export interface Property {
+    /** Property name. */
+    name: string;
+    /** Property type discriminant. */
+    type: PropertyType;
+    /** Value — typed by `type` (string | number | boolean). */
+    value: string | number | boolean;
+}
+/** Any Tiled property (the typed property union). */
+export type AnyProperty = Property;
+/** A single animation frame: `{ tileid, duration }` (ms). */
+export interface Frame {
+    /** Tile id this frame shows. */
+    tileid: number;
+    /** Frame duration in milliseconds. */
+    duration: number;
+}
+/** A 2D point in pixels. */
+export interface Point {
+    /** X coordinate (px). */
+    x: number;
+    /** Y coordinate (px). */
+    y: number;
+}
+/**
+ * Public vendored `MapObject` interface — a collision/anchor shape on a tile.
+ * Sparse Tiled shape flags become REQUIRED booleans/arrays defaulting to
+ * `false`/`[]`; a plain rectangle has none of `ellipse`/`point`/`polygon`/
+ * `polyline` set.
+ */
+export interface MapObject {
+    /** Unique id across all objects in the tileset. */
+    id: number;
+    /** X coordinate (px). */
+    x: number;
+    /** Y coordinate (px). */
+    y: number;
+    /** Width (px); `0` when absent. */
+    width: number;
+    /** Height (px); `0` when absent. */
+    height: number;
+    /** Rotation in degrees clockwise; `0` when absent. */
+    rotation: number;
+    /** Name; `""` when absent. */
+    name: string;
+    /** Object "Class"; `""` when absent. */
+    type: string;
+    /** `true` if ellipse (a circle is an ellipse with equal dims). */
+    ellipse: boolean;
+    /** `true` if point. */
+    point: boolean;
+    /** Polygon points; `[]` when not a polygon. */
+    polygon: Point[];
+    /** Polyline points; `[]` when not a polyline. */
+    polyline: Point[];
+}
+/**
+ * Public vendored `Tile` interface — a single tile in a tileset. Sparse Tiled
+ * fields become REQUIRED with non-null empty defaults supplied by `Tile`.
+ */
+export interface Tile {
+    /** Local tile id (== Phaser frame index, row-major). */
+    id: number;
+    /** Tile "Class" (Tiled `class`/`type`); `""` when absent. */
+    class: string;
+    /** Typed properties, preserved as-is; `[]` when absent. */
+    properties: AnyProperty[];
+    /** Collision/anchor shapes keyed by `MapObject.id`; empty `Map` when absent. */
+    objects: Map<number, MapObject>;
+    /** Animation frames; `[]` when absent. */
+    animation: Frame[];
+}
+/**
+ * Public vendored `Tileset` interface — a single-image Tiled tileset ingested
+ * as a spritesheet. Field names map Tiled's (`tilewidth`→`frameWidth`, etc.);
+ * sparse fields become REQUIRED with non-null defaults. `tile(id)` looks up a
+ * tile by numeric id (the concrete class re-indexes Tiled's `tiles[]` into a
+ * `Map`).
+ */
+export interface Tileset {
+    /** Resolved image path relative to `assetsPath`, POSIX-separated. */
+    image: string;
+    /** Tile width (px) — Tiled `tilewidth`. */
+    frameWidth: number;
+    /** Tile height (px) — Tiled `tileheight`. */
+    frameHeight: number;
+    /** Tileset margin (px). */
+    margin: number;
+    /** Tile spacing (px). */
+    spacing: number;
+    /** Tiles per row. */
+    columns: number;
+    /** Total frames — Tiled `tilecount`. */
+    tileCount: number;
+    /** Source image width (px) — Tiled `imagewidth`. */
+    imageWidth: number;
+    /** Source image height (px) — Tiled `imageheight`. */
+    imageHeight: number;
+    /** Tileset name. */
+    name: string;
+    /** Tileset "Class" (Tiled `class`/`type`); `""` when absent. */
+    class: string;
+    /** Typed properties; `[]` when absent. */
+    properties: AnyProperty[];
+    /** Look up a tile by numeric id; `undefined` when not present. */
+    tile(id: number): Tile | undefined;
+}
+/** Raw `MapObject` as Tiled emits it (sparse fields optional). */
+export interface MapObjectRaw {
+    id: number;
+    x: number;
+    y: number;
+    width?: number;
+    height?: number;
+    rotation?: number;
+    name?: string;
+    type?: string;
+    ellipse?: boolean;
+    point?: boolean;
+    polygon?: Point[];
+    polyline?: Point[];
+}
+/** Raw `Tile` as Tiled emits it (sparse fields optional; `image?` ⇒ collection). */
+export interface TileRaw {
+    id: number;
+    type?: string;
+    class?: string;
+    properties?: AnyProperty[];
+    objectgroup?: {
+        objects: MapObjectRaw[];
+    };
+    animation?: Frame[];
+    /** Presence ⇒ image-collection tile (rejected by the scope guard). */
+    image?: string;
+}
+/** Raw `Tileset` as Tiled emits it (sparse fields optional; `image?` ⇒ collection). */
+export interface TilesetRaw {
+    columns: number;
+    image?: string;
+    imagewidth?: number;
+    imageheight?: number;
+    margin?: number;
+    spacing?: number;
+    tilecount?: number;
+    tilewidth?: number;
+    tileheight?: number;
+    name?: string;
+    /** Tileset "Class" (Tiled >=1.9). */
+    class?: string;
+    /** Tiled file-format discriminator (`"tileset"`/`"map"`) — NOT a class. */
+    type?: string;
+    properties?: AnyProperty[];
+    tiles?: TileRaw[];
+}

package/types/tileset.js

@@ -0,0 +1,22 @@
+/**
+ * Vendored Tiled schema — bare-minimum interfaces copied from `@kayahr/tiled`
+ * (the authoritative reference), retaining only the fields v1.0.36 uses.
+ *
+ * Two layers live here:
+ *
+ * 1. **Public interfaces** (no `?` on the v1.0.36 fields). Our concrete classes
+ *    (`TilesetAsset`, `Tile`, `MapObject`) `implements` these, so they act as
+ *    the type-check contract. Sparse Tiled fields become REQUIRED here, and the
+ *    concrete classes guarantee non-null empty defaults (`[]`, empty `Map`, `""`,
+ *    `false`, `0`) — consumers never null-check.
+ *
+ * 2. **`*Raw` interfaces** (with `?`) modeling the raw Tiled JSON the reviver
+ *    reads. These carry the original Tiled field names (`tilewidth`, `type`,
+ *    `objectgroup`, …) so the loader can read raw input before constructing the
+ *    concrete tree.
+ *
+ * This file is grown field-by-field as features are added; it never depends on
+ * `@kayahr/tiled` at runtime or build time.
+ */
+export {};
+//# sourceMappingURL=tileset.js.map

package/types/tileset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tileset.js","sourceRoot":"","sources":["../../src/types/tileset.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG"}