@flighthq/tilemap-formats 0.1.0

package/dist/tiledTmxFormat.js

@@ -0,0 +1,178 @@
+import { formatTiledColor } from './tiledColor';
+// Re-emits a `TiledMap` as TMX XML, lossless for the modeled fields so that
+// `parseTiledTmx(formatTiledTmx(map))` reproduces `map`. Tile layers are written as CSV `<data>`
+// (the raw GIDs, flip bits intact). Fields the document does not model — Tiled editor chrome, wang
+// sets, per-map render settings beyond orientation/renderorder — are not emitted.
+export function formatTiledTmx(map) {
+    const lines = ['<?xml version="1.0" encoding="UTF-8"?>'];
+    let open = `<map${attr('version', map.version)}`;
+    if (map.tiledVersion !== null)
+        open += attr('tiledversion', map.tiledVersion);
+    open += attr('orientation', map.orientation);
+    open += attr('renderorder', map.renderOrder);
+    open += attr('width', map.width) + attr('height', map.height);
+    open += attr('tilewidth', map.tileWidth) + attr('tileheight', map.tileHeight);
+    open += attr('infinite', map.infinite ? 1 : 0);
+    if (map.backgroundColor !== null)
+        open += attr('backgroundcolor', formatTiledColor(map.backgroundColor));
+    lines.push(`${open}>`);
+    for (const ref of map.tilesets)
+        writeTilesetRef(lines, ref);
+    for (const layer of map.layers)
+        writeLayer(lines, layer);
+    writeProperties(lines, map.properties);
+    lines.push('</map>');
+    return lines.join('\n');
+}
+function attr(name, value) {
+    return ` ${name}="${escapeXml(String(value))}"`;
+}
+function escapeXml(value) {
+    return value.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
+}
+function formatLayerBaseAttrs(layer) {
+    let out = attr('id', layer.id) + attr('name', layer.name);
+    if (layer.opacity !== 1)
+        out += attr('opacity', layer.opacity);
+    if (!layer.visible)
+        out += attr('visible', 0);
+    if (layer.offsetX !== 0)
+        out += attr('offsetx', layer.offsetX);
+    if (layer.offsetY !== 0)
+        out += attr('offsety', layer.offsetY);
+    return out;
+}
+function formatPoints(points) {
+    return points.map((p) => `${p.x},${p.y}`).join(' ');
+}
+function writeLayer(lines, layer) {
+    const base = formatLayerBaseAttrs(layer);
+    if (layer.type === 'tilelayer') {
+        lines.push(`<layer${base}${attr('width', layer.width)}${attr('height', layer.height)}>`);
+        lines.push('<data encoding="csv">');
+        lines.push(Array.from(layer.data).join(','));
+        lines.push('</data>');
+        lines.push('</layer>');
+        return;
+    }
+    if (layer.type === 'objectgroup') {
+        lines.push(`<objectgroup${base}>`);
+        for (const object of layer.objects)
+            writeObject(lines, object);
+        writeProperties(lines, layer.properties);
+        lines.push('</objectgroup>');
+        return;
+    }
+    if (layer.type === 'imagelayer') {
+        lines.push(`<imagelayer${base}>`);
+        lines.push(`<image${attr('source', layer.image)}/>`);
+        writeProperties(lines, layer.properties);
+        lines.push('</imagelayer>');
+        return;
+    }
+    lines.push(`<group${base}>`);
+    for (const child of layer.layers)
+        writeLayer(lines, child);
+    writeProperties(lines, layer.properties);
+    lines.push('</group>');
+}
+function writeObject(lines, object) {
+    let open = `<object${attr('id', object.id)}`;
+    if (object.name !== '')
+        open += attr('name', object.name);
+    if (object.type !== '')
+        open += attr('type', object.type);
+    if (object.gid !== null)
+        open += attr('gid', object.gid);
+    open += attr('x', object.x) + attr('y', object.y);
+    if (object.width !== 0)
+        open += attr('width', object.width);
+    if (object.height !== 0)
+        open += attr('height', object.height);
+    const hasBody = object.point ||
+        object.ellipse ||
+        object.polygon !== null ||
+        object.polyline !== null ||
+        object.properties.length > 0;
+    if (!hasBody) {
+        lines.push(`${open}/>`);
+        return;
+    }
+    lines.push(`${open}>`);
+    if (object.point)
+        lines.push('<point/>');
+    if (object.ellipse)
+        lines.push('<ellipse/>');
+    if (object.polygon !== null)
+        lines.push(`<polygon${attr('points', formatPoints(object.polygon))}/>`);
+    if (object.polyline !== null)
+        lines.push(`<polyline${attr('points', formatPoints(object.polyline))}/>`);
+    writeProperties(lines, object.properties);
+    lines.push('</object>');
+}
+function writeProperties(lines, properties) {
+    if (properties.length === 0)
+        return;
+    lines.push('<properties>');
+    for (const property of properties) {
+        let out = `<property${attr('name', property.name)}`;
+        if (property.type !== 'string')
+            out += attr('type', property.type);
+        out += attr('value', String(property.value));
+        lines.push(`${out}/>`);
+    }
+    lines.push('</properties>');
+}
+function writeTileset(lines, tileset, firstGid) {
+    let open = `<tileset${attr('firstgid', firstGid)}${attr('name', tileset.name)}`;
+    open += attr('tilewidth', tileset.tileWidth) + attr('tileheight', tileset.tileHeight);
+    open += attr('tilecount', tileset.tileCount) + attr('columns', tileset.columns);
+    if (tileset.margin !== 0)
+        open += attr('margin', tileset.margin);
+    if (tileset.spacing !== 0)
+        open += attr('spacing', tileset.spacing);
+    lines.push(`${open}>`);
+    if (tileset.image !== null) {
+        lines.push(`<image${attr('source', tileset.image)}${attr('width', tileset.imageWidth)}${attr('height', tileset.imageHeight)}/>`);
+    }
+    for (const tile of tileset.tiles)
+        writeTilesetTile(lines, tile);
+    writeProperties(lines, tileset.properties);
+    lines.push('</tileset>');
+}
+function writeTilesetRef(lines, ref) {
+    if (ref.source !== null) {
+        lines.push(`<tileset${attr('firstgid', ref.firstGid)}${attr('source', ref.source)}/>`);
+        return;
+    }
+    if (ref.tileset !== null)
+        writeTileset(lines, ref.tileset, ref.firstGid);
+}
+function writeTilesetTile(lines, tile) {
+    let open = `<tile${attr('id', tile.id)}`;
+    if (tile.type !== '')
+        open += attr('type', tile.type);
+    const hasBody = tile.image !== null || tile.animation !== null || tile.objects !== null || tile.properties.length > 0;
+    if (!hasBody) {
+        lines.push(`${open}/>`);
+        return;
+    }
+    lines.push(`${open}>`);
+    if (tile.image !== null)
+        lines.push(`<image${attr('source', tile.image)}/>`);
+    if (tile.animation !== null) {
+        lines.push('<animation>');
+        for (const frame of tile.animation)
+            lines.push(`<frame${attr('tileid', frame.tileId)}${attr('duration', frame.duration)}/>`);
+        lines.push('</animation>');
+    }
+    if (tile.objects !== null) {
+        lines.push('<objectgroup>');
+        for (const object of tile.objects)
+            writeObject(lines, object);
+        lines.push('</objectgroup>');
+    }
+    writeProperties(lines, tile.properties);
+    lines.push('</tile>');
+}
+//# sourceMappingURL=tiledTmxFormat.js.map

package/dist/tiledTmxFormat.js.map

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

package/dist/tiledXmlParse.d.ts

@@ -0,0 +1,5 @@
+import type { TiledMap, TiledTileset } from '@flighthq/types';
+import type { TiledParseOptions } from './tiledOptions';
+export declare function parseTiledTileset(text: string, _options?: Readonly<TiledParseOptions>): TiledTileset | null;
+export declare function parseTiledTmx(text: string, options?: Readonly<TiledParseOptions>): TiledMap | null;
+//# sourceMappingURL=tiledXmlParse.d.ts.map

package/dist/tiledXmlParse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tiledXmlParse.d.ts","sourceRoot":"","sources":["../src/tiledXmlParse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,QAAQ,EAMR,YAAY,EAKb,MAAM,iBAAiB,CAAC;AAWzB,OAAO,KAAK,EAAoB,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAQ1E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,QAAQ,CAAC,iBAAiB,CAAC,GAAG,YAAY,GAAG,IAAI,CAI3G;AAID,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,iBAAiB,CAAC,GAAG,QAAQ,GAAG,IAAI,CA+BlG"}

package/dist/tiledXmlParse.js

@@ -0,0 +1,247 @@
+import { getXmlElementAttribute, getXmlElementChildByName, getXmlElementChildrenByName, parseXmlDocument, } from '@flighthq/xml';
+import { parseTiledColor } from './tiledColor';
+import { decodeTiledBase64Layer, decodeTiledCsvLayer } from './tiledLayerData';
+// XML front-end of the Tiled codec: TMX maps and standalone TSX tilesets. Both are the same XML tree
+// (`@flighthq/xml`), so they share the tileset/layer/object/property builders below. Numeric byte
+// decoding, color, and GID handling come from the representation-independent primitives.
+// Parses a standalone TSX tileset document into a `TiledTileset`, or null when the root is not a
+// `<tileset>` element.
+export function parseTiledTileset(text, _options) {
+    const root = parseXmlDocument(text);
+    if (root === null || root.name !== 'tileset')
+        return null;
+    return buildTiledTilesetFromXml(root);
+}
+// Parses a TMX map document into a faithful `TiledMap`, or null when the root is not a `<map>`
+// element. A compressed tile layer with no `inflate` seam is preserved as an all-zero grid.
+export function parseTiledTmx(text, options) {
+    const root = parseXmlDocument(text);
+    if (root === null || root.name !== 'map')
+        return null;
+    const tilesets = [];
+    for (const element of getXmlElementChildrenByName(root, 'tileset')) {
+        tilesets.push(buildTiledTilesetRefFromXml(element));
+    }
+    const layers = [];
+    for (const element of root.children) {
+        const layer = buildTiledLayerFromXml(element, options);
+        if (layer !== null)
+            layers.push(layer);
+    }
+    const background = getXmlElementAttribute(root, 'backgroundcolor');
+    return {
+        backgroundColor: background !== null ? parseTiledColor(background) : null,
+        height: attrNumber(root, 'height', 0),
+        infinite: attrBool(root, 'infinite', false),
+        layers,
+        orientation: asOrientation(getXmlElementAttribute(root, 'orientation')),
+        properties: buildTiledPropertiesFromXml(root),
+        renderOrder: asRenderOrder(getXmlElementAttribute(root, 'renderorder')),
+        tileHeight: attrNumber(root, 'tileheight', 0),
+        tileWidth: attrNumber(root, 'tilewidth', 0),
+        tiledVersion: getXmlElementAttribute(root, 'tiledversion'),
+        tilesets,
+        version: attrString(root, 'version', '1.0'),
+        width: attrNumber(root, 'width', 0),
+    };
+}
+function attrBool(element, name, fallback) {
+    const value = getXmlElementAttribute(element, name);
+    if (value === null)
+        return fallback;
+    return value === '1' || value === 'true';
+}
+function attrNumber(element, name, fallback) {
+    const value = getXmlElementAttribute(element, name);
+    if (value === null || value.trim() === '')
+        return fallback;
+    const n = Number(value);
+    return Number.isFinite(n) ? n : fallback;
+}
+function attrString(element, name, fallback) {
+    const value = getXmlElementAttribute(element, name);
+    return value !== null ? value : fallback;
+}
+function buildTiledLayerBaseFromXml(element) {
+    return {
+        id: attrNumber(element, 'id', 0),
+        name: attrString(element, 'name', ''),
+        offsetX: attrNumber(element, 'offsetx', 0),
+        offsetY: attrNumber(element, 'offsety', 0),
+        opacity: attrNumber(element, 'opacity', 1),
+        properties: buildTiledPropertiesFromXml(element),
+        visible: attrBool(element, 'visible', true),
+    };
+}
+function buildTiledLayerFromXml(element, options) {
+    const base = buildTiledLayerBaseFromXml(element);
+    if (element.name === 'layer') {
+        const width = attrNumber(element, 'width', 0);
+        const height = attrNumber(element, 'height', 0);
+        return {
+            ...base,
+            data: buildTiledLayerDataFromXml(element, width, height, options),
+            height,
+            type: 'tilelayer',
+            width,
+        };
+    }
+    if (element.name === 'objectgroup') {
+        return {
+            ...base,
+            objects: getXmlElementChildrenByName(element, 'object').map(buildTiledObjectFromXml),
+            type: 'objectgroup',
+        };
+    }
+    if (element.name === 'imagelayer') {
+        const image = getXmlElementChildByName(element, 'image');
+        return { ...base, image: image !== null ? attrString(image, 'source', '') : '', type: 'imagelayer' };
+    }
+    if (element.name === 'group') {
+        const layers = [];
+        for (const child of element.children) {
+            const layer = buildTiledLayerFromXml(child, options);
+            if (layer !== null)
+                layers.push(layer);
+        }
+        return { ...base, layers, type: 'group' };
+    }
+    return null;
+}
+// Decodes a `<layer>`'s `<data>` into a width*height grid of raw GIDs. Handles csv, base64
+// (optionally compressed via `options.inflate`), and the uncompressed `<tile gid>` element form.
+// Always returns a grid sized exactly width*height (short/failed payloads pad with 0 = empty).
+function buildTiledLayerDataFromXml(element, width, height, options) {
+    const grid = new Uint32Array(width * height);
+    const data = getXmlElementChildByName(element, 'data');
+    if (data === null)
+        return grid;
+    const encoding = getXmlElementAttribute(data, 'encoding');
+    let decoded;
+    if (encoding === 'csv') {
+        decoded = decodeTiledCsvLayer(data.text);
+    }
+    else if (encoding === 'base64') {
+        decoded = decodeTiledBase64Layer(data.text, asCompression(getXmlElementAttribute(data, 'compression')), options?.inflate);
+    }
+    else {
+        decoded = Uint32Array.from(getXmlElementChildrenByName(data, 'tile').map((tile) => attrNumber(tile, 'gid', 0) >>> 0));
+    }
+    if (decoded === null)
+        return grid;
+    grid.set(decoded.subarray(0, grid.length));
+    return grid;
+}
+function buildTiledObjectFromXml(element) {
+    const gid = getXmlElementAttribute(element, 'gid');
+    const polygon = getXmlElementChildByName(element, 'polygon');
+    const polyline = getXmlElementChildByName(element, 'polyline');
+    return {
+        ellipse: getXmlElementChildByName(element, 'ellipse') !== null,
+        gid: gid !== null ? Number(gid) >>> 0 : null,
+        height: attrNumber(element, 'height', 0),
+        id: attrNumber(element, 'id', 0),
+        name: attrString(element, 'name', ''),
+        point: getXmlElementChildByName(element, 'point') !== null,
+        polygon: polygon !== null ? parseTiledPoints(attrString(polygon, 'points', '')) : null,
+        polyline: polyline !== null ? parseTiledPoints(attrString(polyline, 'points', '')) : null,
+        properties: buildTiledPropertiesFromXml(element),
+        type: attrString(element, 'type', attrString(element, 'class', '')),
+        width: attrNumber(element, 'width', 0),
+        x: attrNumber(element, 'x', 0),
+        y: attrNumber(element, 'y', 0),
+    };
+}
+function buildTiledPropertiesFromXml(element) {
+    const container = getXmlElementChildByName(element, 'properties');
+    if (container === null)
+        return [];
+    return getXmlElementChildrenByName(container, 'property').map((property) => {
+        const type = asPropertyType(getXmlElementAttribute(property, 'type'));
+        const raw = getXmlElementAttribute(property, 'value') ?? property.text;
+        return { name: attrString(property, 'name', ''), type, value: parsePropertyValue(type, raw) };
+    });
+}
+function buildTiledTilesetFromXml(element) {
+    const image = getXmlElementChildByName(element, 'image');
+    return {
+        columns: attrNumber(element, 'columns', 0),
+        image: image !== null ? attrString(image, 'source', '') : null,
+        imageHeight: image !== null ? attrNumber(image, 'height', 0) : 0,
+        imageWidth: image !== null ? attrNumber(image, 'width', 0) : 0,
+        margin: attrNumber(element, 'margin', 0),
+        name: attrString(element, 'name', ''),
+        properties: buildTiledPropertiesFromXml(element),
+        spacing: attrNumber(element, 'spacing', 0),
+        tileCount: attrNumber(element, 'tilecount', 0),
+        tileHeight: attrNumber(element, 'tileheight', 0),
+        tileWidth: attrNumber(element, 'tilewidth', 0),
+        tiles: getXmlElementChildrenByName(element, 'tile').map(buildTiledTilesetTileFromXml),
+    };
+}
+function buildTiledTilesetRefFromXml(element) {
+    const source = getXmlElementAttribute(element, 'source');
+    return {
+        firstGid: attrNumber(element, 'firstgid', 1),
+        source,
+        tileset: source !== null ? null : buildTiledTilesetFromXml(element),
+    };
+}
+function buildTiledTilesetTileFromXml(element) {
+    const animation = getXmlElementChildByName(element, 'animation');
+    const objectGroup = getXmlElementChildByName(element, 'objectgroup');
+    const image = getXmlElementChildByName(element, 'image');
+    const frames = animation !== null
+        ? getXmlElementChildrenByName(animation, 'frame').map((frame) => ({
+            duration: attrNumber(frame, 'duration', 0),
+            tileId: attrNumber(frame, 'tileid', 0),
+        }))
+        : null;
+    return {
+        animation: frames,
+        id: attrNumber(element, 'id', 0),
+        image: image !== null ? attrString(image, 'source', '') : null,
+        objects: objectGroup !== null ? getXmlElementChildrenByName(objectGroup, 'object').map(buildTiledObjectFromXml) : null,
+        properties: buildTiledPropertiesFromXml(element),
+        type: attrString(element, 'type', attrString(element, 'class', '')),
+    };
+}
+function parseTiledPoints(text) {
+    const points = [];
+    for (const pair of text.trim().split(/\s+/)) {
+        if (pair === '')
+            continue;
+        const [x, y] = pair.split(',');
+        points.push({ x: Number(x) || 0, y: Number(y) || 0 });
+    }
+    return points;
+}
+function asCompression(value) {
+    return value === 'gzip' || value === 'zlib' || value === 'zstd' ? value : null;
+}
+function asOrientation(value) {
+    return value === 'isometric' || value === 'staggered' || value === 'hexagonal' ? value : 'orthogonal';
+}
+function asPropertyType(value) {
+    return value === 'int' ||
+        value === 'float' ||
+        value === 'bool' ||
+        value === 'color' ||
+        value === 'file' ||
+        value === 'object'
+        ? value
+        : 'string';
+}
+function asRenderOrder(value) {
+    return value === 'right-up' || value === 'left-down' || value === 'left-up' ? value : 'right-down';
+}
+function parsePropertyValue(type, raw) {
+    if (type === 'bool')
+        return raw === 'true';
+    if (type === 'int' || type === 'float') {
+        const n = Number(raw);
+        return Number.isFinite(n) ? n : 0;
+    }
+    return raw;
+}
+//# sourceMappingURL=tiledXmlParse.js.map

package/dist/tiledXmlParse.js.map

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

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@flighthq/tilemap-formats",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src/**/*.test.ts",
+    "!dist/**/*.test.js",
+    "!dist/**/*.test.d.ts",
+    "!dist/**/*.test.js.map",
+    "!dist/**/*.test.d.ts.map"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "tsc -b --clean",
+    "test": "vitest run --config vitest.config.ts",
+    "test:watch": "vitest --watch --config vitest.config.ts",
+    "prepack": "npm run clean && npm run clean:dist && npm run build",
+    "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
+  },
+  "dependencies": {
+    "@flighthq/sprite": "0.1.0",
+    "@flighthq/types": "0.1.0",
+    "@flighthq/xml": "0.1.0"
+  },
+  "devDependencies": {
+    "@flighthq/tileset": "*",
+    "typescript": "^5.3.0"
+  },
+  "description": "Tiled (TMX/TMJ/TSX/TSJ) tilemap import/export codec — faithful TiledMap document plus TilemapData projection",
+  "sideEffects": false
+}

package/src/tiledColor.test.ts

@@ -0,0 +1,32 @@
+import { describe, expect, it } from 'vitest';
+
+import { formatTiledColor, parseTiledColor } from './tiledColor';
+
+describe('formatTiledColor', () => {
+  it('emits #AARRGGBB with alpha first', () => {
+    expect(formatTiledColor(0xff8800ff)).toBe('#ffff8800');
+    expect(formatTiledColor(0x00ff0080)).toBe('#8000ff00');
+  });
+
+  it('round-trips with parseTiledColor', () => {
+    const packed = parseTiledColor('#8000ff00');
+    expect(packed).not.toBeNull();
+    expect(parseTiledColor(formatTiledColor(packed!))).toBe(packed);
+  });
+});
+
+describe('parseTiledColor', () => {
+  it('parses a 6-digit color as opaque RGBA', () => {
+    expect(parseTiledColor('#ff8800')).toBe(0xff8800ff);
+    expect(parseTiledColor('ff8800')).toBe(0xff8800ff);
+  });
+
+  it('parses an 8-digit AARRGGBB color into packed RGBA', () => {
+    expect(parseTiledColor('#8000ff00')).toBe(0x00ff0080);
+  });
+
+  it('returns null for a malformed color', () => {
+    expect(parseTiledColor('#12345')).toBeNull();
+    expect(parseTiledColor('#nothex')).toBeNull();
+  });
+});

package/src/tiledGid.test.ts

@@ -0,0 +1,54 @@
+import { describe, expect, it } from 'vitest';
+
+import { decodeTiledGid, getTiledTilesetRefForGid } from './tiledGid';
+import { parseTiledTmx } from './tiledXmlParse';
+
+const twoTilesetMap = parseTiledTmx(
+  '<map version="1" width="1" height="1" tilewidth="1" tileheight="1">' +
+    '<tileset firstgid="1" source="a.tsx"/>' +
+    '<tileset firstgid="5" source="b.tsx"/>' +
+    '</map>',
+)!;
+
+describe('decodeTiledGid', () => {
+  it('splits an unflipped gid into its tile id with no flags', () => {
+    expect(decodeTiledGid(6)).toEqual({
+      flipDiagonal: false,
+      flipHorizontal: false,
+      flipVertical: false,
+      tileId: 6,
+    });
+  });
+
+  it('recovers the horizontal flip flag and base tile id from a flipped gid', () => {
+    // tile id 1 with the horizontal (high) bit set: 1 | 0x80000000.
+    expect(decodeTiledGid(2147483649)).toEqual({
+      flipDiagonal: false,
+      flipHorizontal: true,
+      flipVertical: false,
+      tileId: 1,
+    });
+  });
+
+  it('decodes all three flip bits together', () => {
+    const gid = (0x80000000 | 0x40000000 | 0x20000000 | 7) >>> 0;
+    expect(decodeTiledGid(gid)).toEqual({
+      flipDiagonal: true,
+      flipHorizontal: true,
+      flipVertical: true,
+      tileId: 7,
+    });
+  });
+});
+
+describe('getTiledTilesetRefForGid', () => {
+  it('finds the ref with the largest firstGid not exceeding the tile id', () => {
+    expect(getTiledTilesetRefForGid(twoTilesetMap, 3)?.firstGid).toBe(1);
+    expect(getTiledTilesetRefForGid(twoTilesetMap, 5)?.firstGid).toBe(5);
+    expect(getTiledTilesetRefForGid(twoTilesetMap, 9)?.firstGid).toBe(5);
+  });
+
+  it('returns null for an empty tile', () => {
+    expect(getTiledTilesetRefForGid(twoTilesetMap, 0)).toBeNull();
+  });
+});