@flighthq/tileset 0.1.0 → 0.2.0

package/dist/tileset.d.ts

@@ -1,4 +1,5 @@
 import type { Tileset } from '@flighthq/types';
 export declare function buildTilesetRegions(target: Tileset): void;
 export declare function createTileset(obj?: Partial<Tileset>): Tileset;
+export declare function disposeTileset(tileset: Tileset): void;
 //# sourceMappingURL=tileset.d.ts.map

package/dist/tileset.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tileset.d.ts","sourceRoot":"","sources":["../src/tileset.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAM/C,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAazD;AAED,wBAAgB,aAAa,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAU7D"}
+{"version":3,"file":"tileset.d.ts","sourceRoot":"","sources":["../src/tileset.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAS/C,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAqBzD;AAED,wBAAgB,aAAa,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAU7D;AAOD,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAErD"}

package/dist/tileset.js

@@ -3,19 +3,31 @@ import { createTextureAtlasRegion, setTextureAtlasRegion } from '@flighthq/textu
 // Fills or refreshes the atlas region array with one region per tile in the grid, using the
 // tileset's tileWidth/tileHeight, margin (border padding), and spacing (inter-tile gap).
 // Existing region objects are reused in place when the capacity matches — zero new allocations
-// for repeated calls on an already-populated tileset.
+// for repeated calls on an already-populated tileset. When the grid shrinks, trailing regions
+// beyond the new tile count are truncated so no stale regions linger. Each region's `id` is its
+// tile index (row-major), and reused regions have their `name`/`rotated`/`trimmed` metadata reset
+// so `getTextureAtlasRegionById` and friends see a clean grid, not leftovers from a prior build.
 export function buildTilesetRegions(target) {
     const { atlas, rows, columns, tileWidth, tileHeight, margin, spacing } = target;
     if (atlas === null)
         return;
+    const regions = atlas.regions;
+    const count = rows * columns;
+    if (regions.length > count)
+        regions.length = count;
     let i = 0;
     for (let row = 0; row < rows; row++) {
         for (let column = 0; column < columns; column++) {
-            if (i >= atlas.regions.length)
-                atlas.regions.push(createTextureAtlasRegion());
+            if (i >= regions.length)
+                regions.push(createTextureAtlasRegion());
+            const region = regions[i];
             const x = margin + column * (tileWidth + spacing);
             const y = margin + row * (tileHeight + spacing);
-            setTextureAtlasRegion(atlas.regions[i], x, y, tileWidth, tileHeight);
+            setTextureAtlasRegion(region, x, y, tileWidth, tileHeight);
+            region.id = i;
+            region.name = null;
+            region.rotated = false;
+            region.trimmed = false;
             i++;
         }
     }
@@ -31,4 +43,12 @@ export function createTileset(obj) {
         tileWidth: obj?.tileWidth ?? 0,
     });
 }
+// Releases what keeps the tileset reachable — the atlas reference — so the atlas (and its image)
+// become eligible for GC once nothing else holds them. The tileset is plain GC-managed memory with
+// no non-GC resource to free, so this is `dispose`, not `destroy`; the grid parameters
+// (rows/columns/tile size) are left intact. Does not clear the atlas's regions: the atlas is a
+// separate entity a caller may still hold, so its contents are not this tileset's to erase.
+export function disposeTileset(tileset) {
+    tileset.atlas = null;
+}
 //# sourceMappingURL=tileset.js.map

package/dist/tileset.js.map

@@ -1 +1 @@
-{"version":3,"file":"tileset.js","sourceRoot":"","sources":["../src/tileset.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAGzF,4FAA4F;AAC5F,yFAAyF;AACzF,+FAA+F;AAC/F,sDAAsD;AACtD,MAAM,UAAU,mBAAmB,CAAC,MAAe;IACjD,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;IAChF,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO;IAC3B,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC;QACpC,KAAK,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC;YAChD,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM;gBAAE,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,wBAAwB,EAAE,CAAC,CAAC;YAC9E,MAAM,CAAC,GAAG,MAAM,GAAG,MAAM,GAAG,CAAC,SAAS,GAAG,OAAO,CAAC,CAAC;YAClD,MAAM,CAAC,GAAG,MAAM,GAAG,GAAG,GAAG,CAAC,UAAU,GAAG,OAAO,CAAC,CAAC;YAChD,qBAAqB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;YACrE,CAAC,EAAE,CAAC;QACN,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAsB;IAClD,OAAO,YAAY,CAAC;QAClB,KAAK,EAAE,GAAG,EAAE,KAAK,IAAI,IAAI;QACzB,OAAO,EAAE,GAAG,EAAE,OAAO,IAAI,CAAC;QAC1B,MAAM,EAAE,GAAG,EAAE,MAAM,IAAI,CAAC;QACxB,IAAI,EAAE,GAAG,EAAE,IAAI,IAAI,CAAC;QACpB,OAAO,EAAE,GAAG,EAAE,OAAO,IAAI,CAAC;QAC1B,UAAU,EAAE,GAAG,EAAE,UAAU,IAAI,CAAC;QAChC,SAAS,EAAE,GAAG,EAAE,SAAS,IAAI,CAAC;KAC/B,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"tileset.js","sourceRoot":"","sources":["../src/tileset.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAGzF,4FAA4F;AAC5F,yFAAyF;AACzF,+FAA+F;AAC/F,8FAA8F;AAC9F,gGAAgG;AAChG,kGAAkG;AAClG,iGAAiG;AACjG,MAAM,UAAU,mBAAmB,CAAC,MAAe;IACjD,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;IAChF,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO;IAC3B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IAC9B,MAAM,KAAK,GAAG,IAAI,GAAG,OAAO,CAAC;IAC7B,IAAI,OAAO,CAAC,MAAM,GAAG,KAAK;QAAE,OAAO,CAAC,MAAM,GAAG,KAAK,CAAC;IACnD,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC;QACpC,KAAK,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC;YAChD,IAAI,CAAC,IAAI,OAAO,CAAC,MAAM;gBAAE,OAAO,CAAC,IAAI,CAAC,wBAAwB,EAAE,CAAC,CAAC;YAClE,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;YAC1B,MAAM,CAAC,GAAG,MAAM,GAAG,MAAM,GAAG,CAAC,SAAS,GAAG,OAAO,CAAC,CAAC;YAClD,MAAM,CAAC,GAAG,MAAM,GAAG,GAAG,GAAG,CAAC,UAAU,GAAG,OAAO,CAAC,CAAC;YAChD,qBAAqB,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;YAC3D,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC;YACd,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;YACnB,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC;YACvB,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC;YACvB,CAAC,EAAE,CAAC;QACN,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAsB;IAClD,OAAO,YAAY,CAAC;QAClB,KAAK,EAAE,GAAG,EAAE,KAAK,IAAI,IAAI;QACzB,OAAO,EAAE,GAAG,EAAE,OAAO,IAAI,CAAC;QAC1B,MAAM,EAAE,GAAG,EAAE,MAAM,IAAI,CAAC;QACxB,IAAI,EAAE,GAAG,EAAE,IAAI,IAAI,CAAC;QACpB,OAAO,EAAE,GAAG,EAAE,OAAO,IAAI,CAAC;QAC1B,UAAU,EAAE,GAAG,EAAE,UAAU,IAAI,CAAC;QAChC,SAAS,EAAE,GAAG,EAAE,SAAS,IAAI,CAAC;KAC/B,CAAC,CAAC;AACL,CAAC;AAED,iGAAiG;AACjG,mGAAmG;AACnG,uFAAuF;AACvF,+FAA+F;AAC/F,4FAA4F;AAC5F,MAAM,UAAU,cAAc,CAAC,OAAgB;IAC7C,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;AACvB,CAAC"}

package/dist/tilesetFrom.d.ts

@@ -1,8 +1,8 @@
 import type { ImageResource, TextureAtlas, Tileset } from '@flighthq/types';
 export declare function createTilesetFromAtlas(atlas: TextureAtlas, tileWidth: number, tileHeight: number, margin?: number, spacing?: number): Tileset;
 export declare function createTilesetFromImageResource(resource: ImageResource, tileWidth: number, tileHeight: number, margin?: number, spacing?: number): Tileset;
-export declare function loadTilesetFromBase64(base64: string, mimeType: string, tileWidth: number, tileHeight: number, signal?: AbortSignal): Promise<Tileset>;
-export declare function loadTilesetFromBlob(blob: Blob, tileWidth: number, tileHeight: number, signal?: AbortSignal): Promise<Tileset>;
-export declare function loadTilesetFromBytes(bytes: Uint8Array, tileWidth: number, tileHeight: number, mimeType?: string, signal?: AbortSignal): Promise<Tileset>;
-export declare function loadTilesetFromUrl(url: string, tileWidth: number, tileHeight: number, crossOrigin?: string, signal?: AbortSignal): Promise<Tileset>;
+export declare function loadTilesetFromBase64(base64: string, mimeType: string, tileWidth: number, tileHeight: number, margin?: number, spacing?: number, signal?: AbortSignal): Promise<Tileset>;
+export declare function loadTilesetFromBlob(blob: Blob, tileWidth: number, tileHeight: number, margin?: number, spacing?: number, signal?: AbortSignal): Promise<Tileset>;
+export declare function loadTilesetFromBytes(bytes: Uint8Array, tileWidth: number, tileHeight: number, margin?: number, spacing?: number, mimeType?: string, signal?: AbortSignal): Promise<Tileset>;
+export declare function loadTilesetFromUrl(url: string, tileWidth: number, tileHeight: number, margin?: number, spacing?: number, crossOrigin?: string, signal?: AbortSignal): Promise<Tileset>;
 //# sourceMappingURL=tilesetFrom.d.ts.map

package/dist/tilesetFrom.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tilesetFrom.d.ts","sourceRoot":"","sources":["../src/tilesetFrom.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAO5E,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,YAAY,EACnB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,MAAU,EAClB,OAAO,GAAE,MAAU,GAClB,OAAO,CAST;AAED,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,aAAa,EACvB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,MAAU,EAClB,OAAO,GAAE,MAAU,GAClB,OAAO,CAET;AAED,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,OAAO,CAAC,CAMlB;AAED,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,OAAO,CAAC,CAElB;AAED,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,UAAU,EACjB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,OAAO,CAAC,CAMlB;AAED,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,MAAM,EACpB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,OAAO,CAAC,CAMlB"}
+{"version":3,"file":"tilesetFrom.d.ts","sourceRoot":"","sources":["../src/tilesetFrom.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAO5E,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,YAAY,EACnB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,MAAU,EAClB,OAAO,GAAE,MAAU,GAClB,OAAO,CAST;AAED,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,aAAa,EACvB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,MAAU,EAClB,OAAO,GAAE,MAAU,GAClB,OAAO,CAET;AAED,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,MAAU,EAClB,OAAO,GAAE,MAAU,EACnB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,OAAO,CAAC,CAQlB;AAED,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,MAAU,EAClB,OAAO,GAAE,MAAU,EACnB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,OAAO,CAAC,CAQlB;AAED,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,UAAU,EACjB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,MAAU,EAClB,OAAO,GAAE,MAAU,EACnB,QAAQ,CAAC,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,OAAO,CAAC,CAQlB;AAED,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,MAAU,EAClB,OAAO,GAAE,MAAU,EACnB,WAAW,CAAC,EAAE,MAAM,EACpB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,OAAO,CAAC,CAQlB"}

package/dist/tilesetFrom.js

@@ -15,16 +15,16 @@ export function createTilesetFromAtlas(atlas, tileWidth, tileHeight, margin = 0,
 export function createTilesetFromImageResource(resource, tileWidth, tileHeight, margin = 0, spacing = 0) {
     return createTilesetFromAtlas(createTextureAtlas({ image: resource }), tileWidth, tileHeight, margin, spacing);
 }
-export async function loadTilesetFromBase64(base64, mimeType, tileWidth, tileHeight, signal) {
-    return createTilesetFromImageResource(await loadImageResourceFromBase64(base64, mimeType, signal), tileWidth, tileHeight);
+export async function loadTilesetFromBase64(base64, mimeType, tileWidth, tileHeight, margin = 0, spacing = 0, signal) {
+    return createTilesetFromImageResource(await loadImageResourceFromBase64(base64, mimeType, signal), tileWidth, tileHeight, margin, spacing);
 }
-export async function loadTilesetFromBlob(blob, tileWidth, tileHeight, signal) {
-    return createTilesetFromImageResource(await loadImageResourceFromBlob(blob, signal), tileWidth, tileHeight);
+export async function loadTilesetFromBlob(blob, tileWidth, tileHeight, margin = 0, spacing = 0, signal) {
+    return createTilesetFromImageResource(await loadImageResourceFromBlob(blob, signal), tileWidth, tileHeight, margin, spacing);
 }
-export async function loadTilesetFromBytes(bytes, tileWidth, tileHeight, mimeType, signal) {
-    return createTilesetFromImageResource(await loadImageResourceFromBytes(bytes, mimeType, signal), tileWidth, tileHeight);
+export async function loadTilesetFromBytes(bytes, tileWidth, tileHeight, margin = 0, spacing = 0, mimeType, signal) {
+    return createTilesetFromImageResource(await loadImageResourceFromBytes(bytes, mimeType, signal), tileWidth, tileHeight, margin, spacing);
 }
-export async function loadTilesetFromUrl(url, tileWidth, tileHeight, crossOrigin, signal) {
-    return createTilesetFromImageResource(await loadImageResourceFromUrl(url, crossOrigin, signal), tileWidth, tileHeight);
+export async function loadTilesetFromUrl(url, tileWidth, tileHeight, margin = 0, spacing = 0, crossOrigin, signal) {
+    return createTilesetFromImageResource(await loadImageResourceFromUrl(url, crossOrigin, signal), tileWidth, tileHeight, margin, spacing);
 }
 //# sourceMappingURL=tilesetFrom.js.map

package/dist/tilesetFrom.js.map

@@ -1 +1 @@
-{"version":3,"file":"tilesetFrom.js","sourceRoot":"","sources":["../src/tilesetFrom.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,yBAAyB,EACzB,0BAA0B,EAC1B,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAG5D,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/D,0FAA0F;AAC1F,wFAAwF;AACxF,wEAAwE;AACxE,MAAM,UAAU,sBAAsB,CACpC,KAAmB,EACnB,SAAiB,EACjB,UAAkB,EAClB,SAAiB,CAAC,EAClB,UAAkB,CAAC;IAEnB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IAC1B,MAAM,OAAO,GACX,KAAK,KAAK,IAAI,IAAI,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,KAAK,GAAG,MAAM,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACjH,MAAM,IAAI,GACR,KAAK,KAAK,IAAI,IAAI,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,MAAM,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACpH,MAAM,OAAO,GAAG,aAAa,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,CAAC;IAChG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC7B,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC5C,QAAuB,EACvB,SAAiB,EACjB,UAAkB,EAClB,SAAiB,CAAC,EAClB,UAAkB,CAAC;IAEnB,OAAO,sBAAsB,CAAC,kBAAkB,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AACjH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,MAAc,EACd,QAAgB,EAChB,SAAiB,EACjB,UAAkB,EAClB,MAAoB;IAEpB,OAAO,8BAA8B,CACnC,MAAM,2BAA2B,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,EAC3D,SAAS,EACT,UAAU,CACX,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,IAAU,EACV,SAAiB,EACjB,UAAkB,EAClB,MAAoB;IAEpB,OAAO,8BAA8B,CAAC,MAAM,yBAAyB,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;AAC9G,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,KAAiB,EACjB,SAAiB,EACjB,UAAkB,EAClB,QAAiB,EACjB,MAAoB;IAEpB,OAAO,8BAA8B,CACnC,MAAM,0BAA0B,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,EACzD,SAAS,EACT,UAAU,CACX,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,GAAW,EACX,SAAiB,EACjB,UAAkB,EAClB,WAAoB,EACpB,MAAoB;IAEpB,OAAO,8BAA8B,CACnC,MAAM,wBAAwB,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,CAAC,EACxD,SAAS,EACT,UAAU,CACX,CAAC;AACJ,CAAC"}
+{"version":3,"file":"tilesetFrom.js","sourceRoot":"","sources":["../src/tilesetFrom.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,11 @@
 {
   "name": "@flighthq/tileset",
-  "version": "0.1.0",
+  "version": "0.2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/flighthq/flight.git",
+    "directory": "packages/tileset"
+  },
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -27,10 +32,10 @@
     "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
   },
   "dependencies": {
-    "@flighthq/entity": "0.1.0",
-    "@flighthq/image": "0.1.0",
-    "@flighthq/textureatlas": "0.1.0",
-    "@flighthq/types": "0.1.0"
+    "@flighthq/entity": "0.2.0",
+    "@flighthq/image": "0.2.0",
+    "@flighthq/textureatlas": "0.2.0",
+    "@flighthq/types": "0.2.0"
   },
   "devDependencies": {
     "typescript": "^5.3.0"

package/src/tileset.test.ts

@@ -1,8 +1,8 @@
 import { createImageResourceFromImageElement } from '@flighthq/image';
-import { createTextureAtlas } from '@flighthq/textureatlas';
+import { createTextureAtlas, createTextureAtlasRegion, getTextureAtlasRegionById } from '@flighthq/textureatlas';
 import type { TextureAtlas, Tileset } from '@flighthq/types';
 
-import { buildTilesetRegions, createTileset } from './tileset';
+import { buildTilesetRegions, createTileset, disposeTileset } from './tileset';
 
 describe('buildTilesetRegions', () => {
   it('advances y by tileHeight for each row', () => {
@@ -76,6 +76,43 @@ describe('buildTilesetRegions', () => {
     expect(atlas.regions[0].x).toBe(0);
     expect(atlas.regions[1].x).toBe(32);
   });
+
+  it('truncates stale trailing regions when the grid shrinks after growing', () => {
+    const source = createImageResourceFromImageElement({ width: 64, height: 64 } as HTMLImageElement);
+    const atlas = createTextureAtlas({ image: source });
+    const tileset = createTileset({ atlas, columns: 2, rows: 2, tileWidth: 32, tileHeight: 32 });
+    buildTilesetRegions(tileset);
+    expect(atlas.regions).toHaveLength(4);
+
+    tileset.columns = 1;
+    tileset.rows = 1;
+    buildTilesetRegions(tileset);
+    expect(atlas.regions).toHaveLength(1);
+  });
+
+  it('assigns each region id to its row-major tile index', () => {
+    const source = createImageResourceFromImageElement({ width: 64, height: 64 } as HTMLImageElement);
+    const atlas = createTextureAtlas({ image: source });
+    const tileset = createTileset({ atlas, columns: 2, rows: 2, tileWidth: 32, tileHeight: 32 });
+    buildTilesetRegions(tileset);
+
+    expect(atlas.regions.map((region) => region.id)).toEqual([0, 1, 2, 3]);
+    expect(getTextureAtlasRegionById(atlas, 3)).toBe(atlas.regions[3]);
+  });
+
+  it('clears stale name/rotated/trimmed metadata on a reused region', () => {
+    const source = createImageResourceFromImageElement({ width: 32, height: 32 } as HTMLImageElement);
+    const atlas = createTextureAtlas({ image: source });
+    atlas.regions.push(createTextureAtlasRegion({ id: 99, name: 'stale', rotated: true, trimmed: true }));
+    const tileset = createTileset({ atlas, columns: 1, rows: 1, tileWidth: 32, tileHeight: 32 });
+
+    buildTilesetRegions(tileset);
+
+    expect(atlas.regions[0].id).toBe(0);
+    expect(atlas.regions[0].name).toBeNull();
+    expect(atlas.regions[0].rotated).toBe(false);
+    expect(atlas.regions[0].trimmed).toBe(false);
+  });
 });
 
 describe('createTileset', () => {
@@ -121,3 +158,41 @@ describe('createTileset', () => {
     expect(obj).not.toStrictEqual(base);
   });
 });
+
+describe('disposeTileset', () => {
+  it('clears the atlas reference so it becomes eligible for GC', () => {
+    const source = createImageResourceFromImageElement({ width: 32, height: 32 } as HTMLImageElement);
+    const atlas = createTextureAtlas({ image: source });
+    const tileset = createTileset({ atlas, columns: 1, rows: 1, tileWidth: 32, tileHeight: 32 });
+
+    disposeTileset(tileset);
+
+    expect(tileset.atlas).toBeNull();
+  });
+
+  it('leaves the grid parameters intact', () => {
+    const source = createImageResourceFromImageElement({ width: 64, height: 32 } as HTMLImageElement);
+    const atlas = createTextureAtlas({ image: source });
+    const tileset = createTileset({ atlas, columns: 2, rows: 1, tileWidth: 32, tileHeight: 16, margin: 4, spacing: 2 });
+
+    disposeTileset(tileset);
+
+    expect(tileset.columns).toBe(2);
+    expect(tileset.rows).toBe(1);
+    expect(tileset.tileWidth).toBe(32);
+    expect(tileset.tileHeight).toBe(16);
+    expect(tileset.margin).toBe(4);
+    expect(tileset.spacing).toBe(2);
+  });
+
+  it('does not erase the shared atlas regions', () => {
+    const source = createImageResourceFromImageElement({ width: 64, height: 32 } as HTMLImageElement);
+    const atlas = createTextureAtlas({ image: source });
+    const tileset = createTileset({ atlas, columns: 2, rows: 1, tileWidth: 32, tileHeight: 32 });
+    buildTilesetRegions(tileset);
+
+    disposeTileset(tileset);
+
+    expect(atlas.regions).toHaveLength(2);
+  });
+});

package/src/tilesetFrom.test.ts

@@ -95,6 +95,12 @@ describe('loadTilesetFromBase64', () => {
     expect(tileset.tileHeight).toBe(16);
     expect(tileset.atlas?.image?.source).toBeInstanceOf(HTMLImageElement);
   });
+
+  it('threads margin and spacing into the tileset', async () => {
+    const tileset = await loadTilesetFromBase64('abc123', 'image/png', 16, 16, 2, 4);
+    expect(tileset.margin).toBe(2);
+    expect(tileset.spacing).toBe(4);
+  });
 });
 
 describe('loadTilesetFromBlob', () => {
@@ -103,6 +109,13 @@ describe('loadTilesetFromBlob', () => {
     const tileset = await loadTilesetFromBlob(blob, 32, 32);
     expect(tileset.atlas?.image?.source).toBeInstanceOf(HTMLImageElement);
   });
+
+  it('threads margin and spacing into the tileset', async () => {
+    const blob = new Blob([], { type: 'image/png' });
+    const tileset = await loadTilesetFromBlob(blob, 32, 32, 1, 3);
+    expect(tileset.margin).toBe(1);
+    expect(tileset.spacing).toBe(3);
+  });
 });
 
 describe('loadTilesetFromBytes', () => {
@@ -119,6 +132,14 @@ describe('loadTilesetFromBytes', () => {
     const bytes = new Uint8Array(16);
     await expect(loadTilesetFromBytes(bytes, 32, 32)).rejects.toThrow('Unable to determine image type');
   });
+
+  it('threads margin and spacing into the tileset with mimeType still after them', async () => {
+    const bytes = new Uint8Array([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a, 0, 0, 0, 0, 0, 0, 0, 0]);
+    const tileset = await loadTilesetFromBytes(bytes, 32, 32, 5, 6, 'image/png');
+    expect(tileset.margin).toBe(5);
+    expect(tileset.spacing).toBe(6);
+    expect(tileset.atlas?.image?.source).toBeInstanceOf(HTMLImageElement);
+  });
 });
 
 describe('loadTilesetFromUrl', () => {
@@ -128,4 +149,11 @@ describe('loadTilesetFromUrl', () => {
     expect(tileset.tileHeight).toBe(32);
     expect(tileset.atlas?.image?.source).toBeInstanceOf(HTMLImageElement);
   });
+
+  it('threads margin and spacing into the tileset with crossOrigin still after them', async () => {
+    const tileset = await loadTilesetFromUrl('data:image/png;base64,abc', 32, 32, 3, 2, 'anonymous');
+    expect(tileset.margin).toBe(3);
+    expect(tileset.spacing).toBe(2);
+    expect(tileset.atlas?.image?.source).toBeInstanceOf(HTMLImageElement);
+  });
 });