@pixelvibing/cli 0.46.0 → 0.49.0

package/dist/pixel-vibing-cli.js

@@ -576,10 +576,11 @@ function createWebApi(fetcher = (input, init2) => fetch(input, init2), base = AP
     /** Every version of the guide, newest first, with how and when each was made (specs/platform-projects/ R2.10). */
     guideVersions: async (projectId) => (await json2(`/projects/${id(projectId)}/style-guide/versions`)).versions,
     reviseGuide: (projectId, instruction) => paying2(async () => (await json2(`/projects/${id(projectId)}/style-guide/revisions`, { method: "POST", body: { instruction } })).job),
-    /** A page of a project's assets, of one kind when one is named. */
-    assets: (projectId, kind = null, before = null) => {
+    /** A page of a project's assets, of one kind and carrying one tag when they are named. */
+    assets: (projectId, kind = null, before = null, tag2 = null) => {
       const query = new URLSearchParams();
       if (kind !== null) query.set("kind", kind);
+      if (tag2 !== null) query.set("tag", tag2);
       if (before !== null) query.set("before", before);
       const search = query.toString();
       return json2(`/projects/${id(projectId)}/assets${search === "" ? "" : `?${search}`}`);
@@ -592,6 +593,10 @@ function createWebApi(fetcher = (input, init2) => fetch(input, init2), base = AP
     },
     /** One of a project's assets, by its id or its name. */
     asset: (projectId, ref) => json2(`/projects/${id(projectId)}/assets/${id(ref)}`),
+    /** The project's tags for concept art: the offered ones first, then its own (specs/concept-art/ R3.1). */
+    tags: async (projectId) => (await json2(`/projects/${id(projectId)}/tags`)).tags,
+    /** A concept art's tags replaced by these, a tag the project has not held made (R3.2). */
+    tagAsset: (projectId, ref, tags) => json2(`/projects/${id(projectId)}/assets/${id(ref)}/tags`, { method: "PUT", body: { tags } }),
     /** Keep a PNG for the account, answering its id. */
     uploadImage: async (png) => (await json2("/images", { method: "POST", bytes: { data: png, type: "image/png" } })).id,
     /** Where the page shows a kept image from; the cookie carries the account. */
@@ -1066,1019 +1071,1117 @@ function describedInterface(manifest2, kept, earlier) {
     next[name] = { meta: { kind: "ui", ...piece.nineGrid === void 0 ? {} : { nineGrid: piece.nineGrid, scale: "stretch" } } };
   return next;
 }
-const SECTOR_SIDE$1 = 128;
-const SECTOR_CELLS = SECTOR_SIDE$1 * SECTOR_SIDE$1;
-const SECTOR_BYTES = 512 * 1024;
-const MAP_LEVELS = { first: 0, last: 14 };
-const LARGEST_MAP_SIDE = 1e4;
-const OUTLINE_ACROSS = Math.ceil(LARGEST_MAP_SIDE / SECTOR_SIDE$1);
-const SECTOR_FORMAT = 1;
-const MAGIC = [80, 86, 67];
-const PRESENT = 1;
-const AUDIO = 2;
-const INTERACT = 4;
-const EXTRA = 8;
-const U16 = 65535;
-const MAX_LAYERS = 255;
-const NAMED$1 = /* @__PURE__ */ new Set(["x", "y", "z", "layers", "blocking", "zone", "audioZone", "interact"]);
-class SectorError extends Error {
+const TILE_SIZE = 256;
+const EAI_MAGIC = 1229018181;
+const EAI_VERSION = 1;
+const HEADER_SIZE$1 = 32;
+const ASSET_SIZE = 24;
+const ATLAS_SIZE = 12;
+class AssetIndexError extends Error {
+  // Assigned in the body: the suites run under Node's strip-only TypeScript
+  // mode, which rejects parameter properties (docs/notes.md n-0023).
   constructor(message) {
     super(message);
-    this.name = "SectorError";
+    this.name = "AssetIndexError";
   }
 }
-function u16(value, what) {
-  if (!Number.isInteger(value) || value < 0 || value > U16) throw new SectorError(`${what} is ${value}, and a sector holds a whole number from 0 to 65,535`);
-  return value;
+function parseAssetIndex(buffer) {
+  if (buffer.byteLength < HEADER_SIZE$1) {
+    throw new AssetIndexError(`buffer too small: ${buffer.byteLength} < ${HEADER_SIZE$1}`);
+  }
+  const view = new DataView(buffer);
+  const magic = view.getUint32(0, true);
+  if (magic !== EAI_MAGIC) {
+    throw new AssetIndexError(`bad magic 0x${magic.toString(16)} (expected 0x${EAI_MAGIC.toString(16)})`);
+  }
+  const version2 = view.getUint32(4, true);
+  if (version2 !== EAI_VERSION) {
+    throw new AssetIndexError(`unsupported version ${version2}, reader speaks v${EAI_VERSION}`);
+  }
+  const assetCount = view.getUint32(8, true);
+  const atlasCount = view.getUint32(12, true);
+  const assetsOffset = view.getUint32(16, true);
+  const atlasesOffset = view.getUint32(20, true);
+  const stringsOffset = view.getUint32(24, true);
+  const stringsLength = view.getUint32(28, true);
+  if (buffer.byteLength !== stringsOffset + stringsLength) {
+    throw new AssetIndexError(`file size ${buffer.byteLength} ≠ header-declared ${stringsOffset + stringsLength}`);
+  }
+  if (assetsOffset < HEADER_SIZE$1) {
+    throw new AssetIndexError(`assetsOffset ${assetsOffset} is inside the ${HEADER_SIZE$1}-byte header`);
+  }
+  if (assetsOffset + assetCount * ASSET_SIZE > atlasesOffset) {
+    throw new AssetIndexError("asset section overlaps atlas section");
+  }
+  if (atlasesOffset + atlasCount * ATLAS_SIZE > stringsOffset) {
+    throw new AssetIndexError("atlas section overlaps string pool");
+  }
+  const pool = new Pool(buffer, stringsOffset, stringsLength);
+  const atlases = readAtlases(view, pool, atlasCount, atlasesOffset);
+  const assets = readAssets(view, pool, assetCount, assetsOffset, atlases);
+  return { version: version2, assets, atlases };
 }
-function encodeSector(cells) {
-  if (cells.length !== SECTOR_CELLS) throw new SectorError(`a sector is ${SECTOR_CELLS} cells, not ${cells.length}`);
-  const encoder2 = new TextEncoder();
-  const bytes = [...MAGIC, SECTOR_FORMAT];
-  const push16 = (value) => bytes.push(value & 255, value >> 8);
-  for (const cell of cells) {
-    if (cell === void 0) {
-      bytes.push(0);
-      continue;
+class Pool {
+  buffer;
+  offset;
+  length;
+  decoder = new TextDecoder("utf-8", { fatal: true });
+  constructor(buffer, offset, length) {
+    this.buffer = buffer;
+    this.offset = offset;
+    this.length = length;
+  }
+  read(what, nameOffset, nameLength) {
+    if (nameOffset < this.offset || nameOffset + nameLength > this.offset + this.length) {
+      throw new AssetIndexError(`${what}: name range [${nameOffset}, +${nameLength}] outside the string pool`);
     }
-    const extra = cell.extra === void 0 ? null : encoder2.encode(JSON.stringify(cell.extra));
-    if (extra !== null && extra.length > U16) throw new SectorError("a tile's extra fields are past 65,535 bytes");
-    if (cell.layers.length > MAX_LAYERS) throw new SectorError(`a tile has ${cell.layers.length} layers, and a sector holds at most ${MAX_LAYERS}`);
-    bytes.push(PRESENT | (cell.audioZone === void 0 ? 0 : AUDIO) | (cell.interact === void 0 ? 0 : INTERACT) | (extra === null ? 0 : EXTRA));
-    bytes.push(cell.layers.length);
-    for (const layer of cell.layers) push16(u16(layer, "a layer id"));
-    push16(u16(cell.blocking, "blocking"));
-    push16(u16(cell.zone, "a zone"));
-    if (cell.audioZone !== void 0) push16(u16(cell.audioZone, "an audio zone"));
-    if (cell.interact !== void 0) push16(u16(cell.interact, "interact"));
-    if (extra !== null) {
-      push16(extra.length);
-      for (const byte of extra) bytes.push(byte);
+    try {
+      return this.decoder.decode(new Uint8Array(this.buffer, nameOffset, nameLength));
+    } catch (error) {
+      throw new AssetIndexError(`${what}: bad UTF-8 name (${error.message})`);
     }
   }
-  return Uint8Array.from(bytes);
 }
-function decodeSector(bytes) {
-  if (bytes.length < 4 || MAGIC.some((byte, index) => bytes[index] !== byte)) throw new SectorError("these bytes are not a map sector");
-  if (bytes[3] !== SECTOR_FORMAT) throw new SectorError(`a map sector of format ${bytes[3]} is not one this version reads`);
-  const decoder = new TextDecoder("utf-8", { fatal: true });
-  let at = 4;
-  const need = (count) => {
-    if (at + count > bytes.length) throw new SectorError("the sector's bytes end before its last cell");
-  };
-  const read8 = () => {
-    need(1);
-    return bytes[at++];
-  };
-  const read16 = () => {
-    need(2);
-    const value = bytes[at] | bytes[at + 1] << 8;
-    at += 2;
-    return value;
-  };
-  const cells = [];
-  for (let index = 0; index < SECTOR_CELLS; index += 1) {
-    const flags = read8();
-    if ((flags & PRESENT) === 0) {
-      cells.push(void 0);
-      continue;
+function readAtlases(view, pool, atlasCount, atlasesOffset) {
+  const atlases = new Array(atlasCount);
+  for (let index = 0; index < atlasCount; index += 1) {
+    const base = atlasesOffset + index * ATLAS_SIZE;
+    atlases[index] = {
+      index,
+      width: view.getUint16(base, true),
+      height: view.getUint16(base + 2, true),
+      name: pool.read(`atlas ${index}`, view.getUint32(base + 4, true), view.getUint32(base + 8, true))
+    };
+  }
+  return atlases;
+}
+function readAssets(view, pool, assetCount, assetsOffset, atlases) {
+  const assets = /* @__PURE__ */ new Map();
+  for (let index = 0; index < assetCount; index += 1) {
+    const base = assetsOffset + index * ASSET_SIZE;
+    const name = pool.read(`asset ${index}`, view.getUint32(base, true), view.getUint16(base + 4, true));
+    if (assets.has(name)) {
+      throw new AssetIndexError(`duplicate asset name ${name}`);
     }
-    const count = read8();
-    const layers = [];
-    for (let layer = 0; layer < count; layer += 1) layers.push(read16());
-    const blocking = read16();
-    const zone = read16();
-    const audioZone = (flags & AUDIO) === 0 ? void 0 : read16();
-    const interact = (flags & INTERACT) === 0 ? void 0 : read16();
-    let extra;
-    if ((flags & EXTRA) !== 0) {
-      const length = read16();
-      need(length);
-      let parsed2;
-      try {
-        parsed2 = JSON.parse(decoder.decode(bytes.subarray(at, at + length)));
-      } catch {
-        throw new SectorError("a tile's extra fields are not JSON");
-      }
-      if (typeof parsed2 !== "object" || parsed2 === null || Array.isArray(parsed2)) throw new SectorError("a tile's extra fields are not an object");
-      const named = Object.keys(parsed2).find((key) => NAMED$1.has(key));
-      if (named !== void 0) throw new SectorError(`a tile's extra fields name ${named}, which the sector holds itself`);
-      extra = parsed2;
-      at += length;
+    const atlasIndex = view.getUint16(base + 6, true);
+    const atlas = atlases[atlasIndex];
+    if (atlas === void 0) {
+      throw new AssetIndexError(`asset ${name}: atlasIndex ${atlasIndex} ≥ atlasCount ${atlases.length}`);
     }
-    cells.push({
-      layers,
-      blocking,
-      zone,
-      ...audioZone === void 0 ? {} : { audioZone },
-      ...interact === void 0 ? {} : { interact },
-      ...extra === void 0 ? {} : { extra }
-    });
+    const entry = {
+      name,
+      atlasIndex,
+      x: view.getUint16(base + 8, true),
+      y: view.getUint16(base + 10, true),
+      width: view.getUint16(base + 12, true),
+      height: view.getUint16(base + 14, true),
+      offsetX: view.getInt16(base + 16, true),
+      offsetY: view.getInt16(base + 18, true),
+      flags: view.getUint16(base + 20, true)
+    };
+    if (entry.x + entry.width > atlas.width || entry.y + entry.height > atlas.height) {
+      throw new AssetIndexError(
+        `asset ${name}: rectangle ${entry.x},${entry.y} ${entry.width}x${entry.height} leaves atlas ${atlas.name} (${atlas.width}x${atlas.height})`
+      );
+    }
+    assets.set(name, entry);
   }
-  if (at !== bytes.length) throw new SectorError("the sector's bytes go on past its last cell");
-  return cells;
+  return assets;
 }
-const NAMED = /* @__PURE__ */ new Set(["x", "y", "z", "layers", "blocking", "zone", "audioZone", "interact"]);
-function cellOfTile(tile) {
-  const extra = Object.fromEntries(Object.entries(tile).filter(([key]) => !NAMED.has(key)));
-  return {
-    layers: tile.layers,
-    blocking: tile.blocking,
-    zone: tile.zone,
-    ...tile.audioZone === void 0 ? {} : { audioZone: tile.audioZone },
-    ...tile.interact === void 0 ? {} : { interact: tile.interact },
-    ...Object.keys(extra).length === 0 ? {} : { extra }
+const U16_MAX = 65535;
+const I16_MIN = -32768;
+const I16_MAX = 32767;
+function writeAssetIndex(atlases, assets) {
+  const encoder2 = new TextEncoder();
+  const ordered = [...assets].sort((left, right) => compareBytes(encoder2, left.name, right.name));
+  const seen = /* @__PURE__ */ new Set();
+  for (const asset of ordered) {
+    if (seen.has(asset.name)) throw new AssetIndexError(`duplicate asset name ${asset.name}`);
+    seen.add(asset.name);
+    if (asset.atlasIndex >= atlases.length) {
+      throw new AssetIndexError(`asset ${asset.name}: atlasIndex ${asset.atlasIndex} ≥ atlasCount ${atlases.length}`);
+    }
+    checkU16(asset.name, { x: asset.x, y: asset.y, width: asset.width, height: asset.height, flags: asset.flags });
+    checkI16(asset.name, { offsetX: asset.offsetX, offsetY: asset.offsetY });
+    const atlas = atlases[asset.atlasIndex];
+    if (asset.x + asset.width > atlas.width || asset.y + asset.height > atlas.height) {
+      throw new AssetIndexError(`asset ${asset.name}: rectangle leaves atlas ${atlas.name} (${atlas.width}x${atlas.height})`);
+    }
+  }
+  for (const atlas of atlases) {
+    checkU16(atlas.name, { width: atlas.width, height: atlas.height });
+  }
+  const pool = [];
+  const ranges = /* @__PURE__ */ new Map();
+  const intern = (text2) => {
+    const found = ranges.get(text2);
+    if (found !== void 0) return found;
+    const bytes = encoder2.encode(text2);
+    const range = { offset: pool.length, length: bytes.length };
+    if (range.length > U16_MAX) throw new AssetIndexError(`name too long: ${text2}`);
+    pool.push(...bytes);
+    ranges.set(text2, range);
+    return range;
   };
+  for (const asset of ordered) intern(asset.name);
+  for (const atlas of atlases) intern(atlas.name);
+  const assetsOffset = HEADER_SIZE$1;
+  const atlasesOffset = assetsOffset + ordered.length * ASSET_SIZE;
+  const stringsOffset = atlasesOffset + atlases.length * ATLAS_SIZE;
+  const buffer = new ArrayBuffer(stringsOffset + pool.length);
+  const view = new DataView(buffer);
+  view.setUint32(0, EAI_MAGIC, true);
+  view.setUint32(4, EAI_VERSION, true);
+  view.setUint32(8, ordered.length, true);
+  view.setUint32(12, atlases.length, true);
+  view.setUint32(16, assetsOffset, true);
+  view.setUint32(20, atlasesOffset, true);
+  view.setUint32(24, stringsOffset, true);
+  view.setUint32(28, pool.length, true);
+  ordered.forEach((asset, index) => {
+    const base = assetsOffset + index * ASSET_SIZE;
+    const range = ranges.get(asset.name);
+    view.setUint32(base, stringsOffset + range.offset, true);
+    view.setUint16(base + 4, range.length, true);
+    view.setUint16(base + 6, asset.atlasIndex, true);
+    view.setUint16(base + 8, asset.x, true);
+    view.setUint16(base + 10, asset.y, true);
+    view.setUint16(base + 12, asset.width, true);
+    view.setUint16(base + 14, asset.height, true);
+    view.setInt16(base + 16, asset.offsetX, true);
+    view.setInt16(base + 18, asset.offsetY, true);
+    view.setUint16(base + 20, asset.flags, true);
+  });
+  atlases.forEach((atlas, index) => {
+    const base = atlasesOffset + index * ATLAS_SIZE;
+    const range = ranges.get(atlas.name);
+    view.setUint16(base, atlas.width, true);
+    view.setUint16(base + 2, atlas.height, true);
+    view.setUint32(base + 4, stringsOffset + range.offset, true);
+    view.setUint32(base + 8, range.length, true);
+  });
+  new Uint8Array(buffer).set(new Uint8Array(pool), stringsOffset);
+  return buffer;
 }
-function tileOfCell(cell, x, y, z) {
-  return {
-    ...cell.extra ?? {},
-    x,
-    y,
-    z,
-    layers: [...cell.layers],
-    blocking: cell.blocking,
-    zone: cell.zone,
-    ...cell.audioZone === void 0 ? {} : { audioZone: cell.audioZone },
-    ...cell.interact === void 0 ? {} : { interact: cell.interact }
-  };
+function compareBytes(encoder2, left, right) {
+  const a = encoder2.encode(left);
+  const b = encoder2.encode(right);
+  for (let index = 0; index < Math.min(a.length, b.length); index += 1) {
+    const difference = (a[index] ?? 0) - (b[index] ?? 0);
+    if (difference !== 0) return difference;
+  }
+  return a.length - b.length;
+}
+function checkU16(what, fields) {
+  for (const [field, value] of Object.entries(fields)) {
+    if (!Number.isInteger(value) || value < 0 || value > U16_MAX) {
+      throw new AssetIndexError(`${what}: ${field} ${value} does not fit in a u16`);
+    }
+  }
+}
+function checkI16(what, fields) {
+  for (const [field, value] of Object.entries(fields)) {
+    if (!Number.isInteger(value) || value < I16_MIN || value > I16_MAX) {
+      throw new AssetIndexError(`${what}: ${field} ${value} does not fit in an i16`);
+    }
+  }
+}
+const METADATA_ENTRY = "meta.json";
+const METADATA_VERSION = 1;
+const ANIMATION_KEYS = [
+  "idle",
+  "stand-north",
+  "stand-south",
+  "stand-west",
+  "stand-east",
+  "walk-north",
+  "walk-south",
+  "walk-west",
+  "walk-east",
+  "attack-north",
+  "attack-south",
+  "attack-west",
+  "attack-east",
+  "icon"
+];
+const ANIMATION_KEY_SET = new Set(ANIMATION_KEYS);
+function isAnimationKey(key) {
+  return ANIMATION_KEY_SET.has(key);
+}
+const ASSET_KINDS = ["outfit", "tile", "item", "effect", "ui"];
+const UI_SCALES = ["stretch", "repeat", "round"];
+const PLAY_EVERY_MIN_MS = 250;
+const PLAY_EVERY_MAX_MS = 6e5;
+const MAX_ANIMATION_NAME = 48;
+const ANIMATION_NAME = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+function isAnimationName(name) {
+  return name.length <= MAX_ANIMATION_NAME && ANIMATION_NAME.test(name);
 }
-const MIRROR_MAP_DIRECTORY = "map";
-const MIRROR_INDEX_FILE = `${MIRROR_MAP_DIRECTORY}/index.json`;
-const MIRROR_FORMAT = 1;
-class MirrorError extends Error {
-  // Assigned in the body: Node's strip-only TypeScript mode rejects parameter
-  // properties (docs/notes.md n-0023).
+class AssetMetadataError extends Error {
+  // Assigned in the body: the suites run under Node's strip-only TypeScript
+  // mode, which rejects parameter properties (docs/notes.md n-0023).
   constructor(message) {
     super(message);
-    this.name = "MirrorError";
+    this.name = "AssetMetadataError";
   }
 }
-function mirrorSectorPath(z, cx, cy) {
-  if (!isPlace(z, cx, cy)) throw new MirrorError(`no sector of a map is at level ${z}, column ${cx}, row ${cy}`);
-  return `${MIRROR_MAP_DIRECTORY}/${z}/${cx}-${cy}.bin`;
-}
-function isPlace(z, cx, cy) {
-  const within = (value, last) => Number.isInteger(value) && value >= 0 && value <= last;
-  return within(z, MAP_LEVELS.last) && z >= MAP_LEVELS.first && within(cx, OUTLINE_ACROSS - 1) && within(cy, OUTLINE_ACROSS - 1);
-}
-function isSize(value) {
-  const side = (n) => Number.isInteger(n) && n >= 1 && n <= LARGEST_MAP_SIDE;
-  return typeof value === "object" && value !== null && side(value.width) && side(value.height);
-}
-function mirrorIndexText(index) {
-  return `${JSON.stringify(index, null, 2)}
-`;
+function isRecord$2(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-function parseMirrorIndex(text2) {
-  let value;
-  try {
-    value = JSON.parse(text2);
-  } catch {
-    throw new MirrorError(`${MIRROR_INDEX_FILE} is not JSON`);
+const MAX_ANIMATION_FRAMES = 64;
+function readFrames(value, asset, animation) {
+  if (!Array.isArray(value)) {
+    throw new AssetMetadataError(`${asset}: animation ${animation} is not a list of frames`);
   }
-  const index = value;
-  if (typeof index !== "object" || index === null) throw new MirrorError(`${MIRROR_INDEX_FILE} is not an object`);
-  if (index.format !== MIRROR_FORMAT)
-    throw new MirrorError(`${MIRROR_INDEX_FILE} is in format ${String(index.format)}, and this reads format ${MIRROR_FORMAT}`);
-  if (!Number.isInteger(index.revision) || index.revision < 0) throw new MirrorError(`${MIRROR_INDEX_FILE} names no revision`);
-  if (!isSize(index.size) || !isSize(index.limit)) throw new MirrorError(`${MIRROR_INDEX_FILE} names no size or limit a map may have`);
-  if (!Array.isArray(index.names) || !Array.isArray(index.sectors)) throw new MirrorError(`${MIRROR_INDEX_FILE} lists no levels or sectors`);
-  for (const named of index.names) {
-    if (typeof named?.name !== "string" || !isPlace(named.z, 0, 0)) throw new MirrorError(`${MIRROR_INDEX_FILE} names a level that is none`);
+  if (value.length > MAX_ANIMATION_FRAMES) {
+    throw new AssetMetadataError(`${asset}: animation ${animation} has ${value.length} frames, and an animation holds at most ${MAX_ANIMATION_FRAMES}`);
   }
-  const seen = /* @__PURE__ */ new Set();
-  for (const sector of index.sectors) {
-    const [z, cx, cy, version2] = Array.isArray(sector) ? sector : [];
-    if (!isPlace(z, cx, cy) || !Number.isInteger(version2) || version2 < 1) {
-      throw new MirrorError(`${MIRROR_INDEX_FILE} lists a sector that is none: ${JSON.stringify(sector)}`);
-    }
-    const key = `${z}:${cx}:${cy}`;
-    if (cx * SECTOR_SIDE$1 >= index.size.width || cy * SECTOR_SIDE$1 >= index.size.height) {
-      throw new MirrorError(`${MIRROR_INDEX_FILE} lists the sector ${key}, outside the map's size`);
+  return value.map((raw, index) => {
+    if (!isRecord$2(raw)) {
+      throw new AssetMetadataError(`${asset}: animation ${animation} frame ${index} is not a frame`);
     }
-    if (seen.has(key)) throw new MirrorError(`${MIRROR_INDEX_FILE} lists the sector ${key} twice`);
-    seen.add(key);
-  }
-  return index;
-}
-async function readMirroredMap(index, read, inflate2) {
-  const tiles = [];
-  for (const [z, cx, cy] of index.sectors) {
-    const path = mirrorSectorPath(z, cx, cy);
-    let cells;
-    try {
-      cells = decodeSector(await inflate2(await read(path)));
-    } catch (error) {
-      throw new MirrorError(`${path} is not a sector the map can read: ${error instanceof Error ? error.message : String(error)}`);
+    const name = raw.asset;
+    if (typeof name !== "string" || name === "") {
+      throw new AssetMetadataError(`${asset}: animation ${animation} frame ${index} names no asset`);
     }
-    for (const [at, cell] of cells.entries()) {
-      if (cell === void 0) continue;
-      const x = cx * SECTOR_SIDE$1 + at % SECTOR_SIDE$1;
-      const y = cy * SECTOR_SIDE$1 + Math.floor(at / SECTOR_SIDE$1);
-      if (x >= index.size.width || y >= index.size.height) continue;
-      tiles.push(tileOfCell(cell, x, y, z));
+    const ms = raw.ms;
+    if (typeof ms !== "number" || !Number.isInteger(ms) || ms < 0) {
+      throw new AssetMetadataError(
+        `${asset}: animation ${animation} frame ${index} has duration ${String(ms)}, which is not a whole number of milliseconds at or above zero`
+      );
     }
-  }
-  tiles.sort((a, b) => a.z - b.z || a.y - b.y || a.x - b.x);
-  return { width: index.size.width, height: index.size.height, tiles };
+    return { asset: name, ms, flip: raw.flip === true };
+  });
 }
-function sectorsOfMap(map) {
-  const sectors = /* @__PURE__ */ new Map();
-  for (const tile of map.tiles) {
-    const { x, y, z } = tile;
-    if (!Number.isInteger(x) || !Number.isInteger(y) || x < 0 || y < 0 || x >= LARGEST_MAP_SIDE || y >= LARGEST_MAP_SIDE || !isPlace(z, 0, 0)) {
-      throw new MirrorError(`the tile at (${x}, ${y}) on level ${z} is at no place a map has`);
+function readAnimations(value, asset, kind) {
+  const animations = /* @__PURE__ */ new Map();
+  if (value === void 0) return animations;
+  if (!isRecord$2(value)) {
+    throw new AssetMetadataError(`${asset}: animations is not a map of name to frames`);
+  }
+  for (const [name, frames] of Object.entries(value)) {
+    if (kind === "outfit" && !isAnimationKey(name)) {
+      throw new AssetMetadataError(`${asset}: unknown animation ${name} (expected one of ${ANIMATION_KEYS.join(", ")})`);
     }
-    const cx = Math.floor(x / SECTOR_SIDE$1);
-    const cy = Math.floor(y / SECTOR_SIDE$1);
-    const key = `${z}:${cx}:${cy}`;
-    let sector = sectors.get(key);
-    if (sector === void 0) {
-      sector = { z, cx, cy, cells: new Array(SECTOR_CELLS) };
-      sectors.set(key, sector);
+    if (kind !== "outfit" && !isAnimationName(name)) {
+      throw new AssetMetadataError(`${asset}: animation ${name} is not a kebab-case name of at most ${MAX_ANIMATION_NAME} characters`);
     }
-    sector.cells[y % SECTOR_SIDE$1 * SECTOR_SIDE$1 + x % SECTOR_SIDE$1] = cellOfTile(tile);
-  }
-  return [...sectors.values()].sort((a, b) => a.z - b.z || a.cy - b.cy || a.cx - b.cx);
-}
-class MapTextError extends Error {
-  // Assigned in the body: the suites run under Node's strip-only TypeScript
-  // mode, which rejects parameter properties (docs/notes.md n-0023).
-  constructor(message) {
-    super(message);
-    this.name = "MapTextError";
+    animations.set(name, readFrames(frames, asset, name));
   }
+  return animations;
 }
-function tileKey(x, y, z) {
-  return `${x}:${y}:${z}`;
-}
-function scanTileSources(text2) {
-  const key = '"tiles"';
-  let at = text2.indexOf(key);
-  if (at === -1) return [];
-  at = text2.indexOf("[", at + key.length);
-  if (at === -1) return [];
-  const sources = [];
-  let depth = 0;
-  let inString = false;
-  let start = -1;
-  for (let index = at + 1; index < text2.length; index += 1) {
-    const char = text2[index];
-    if (inString) {
-      if (char === "\\") index += 1;
-      else if (char === '"') inString = false;
+function readPlays(value, asset, animations, kind) {
+  const plays = /* @__PURE__ */ new Map();
+  if (value === void 0) return plays;
+  if (!isRecord$2(value)) throw new AssetMetadataError(`${asset}: plays is not a map of animation to how it plays`);
+  for (const [name, play] of Object.entries(value)) {
+    if (!animations.has(name)) throw new AssetMetadataError(`${asset}: plays names ${name}, and there is no such animation`);
+    if (!isRecord$2(play)) throw new AssetMetadataError(`${asset}: how ${name} plays is not an object`);
+    if (kind === "outfit" && play.mode !== "loop")
+      throw new AssetMetadataError(`${asset}: ${name} is an outfit's animation, which plays as the game drives it, in a loop`);
+    if (play.mode === "loop" || play.mode === "change") {
+      plays.set(name, { mode: play.mode });
       continue;
     }
-    if (char === '"') {
-      inString = true;
-    } else if (char === "{") {
-      if (depth === 0) start = index;
-      depth += 1;
-    } else if (char === "}") {
-      depth -= 1;
-      if (depth === 0 && start !== -1) {
-        sources.push(text2.slice(start, index + 1));
-        start = -1;
+    if (play.mode === "every") {
+      const ms = play.ms;
+      if (typeof ms !== "number" || !Number.isInteger(ms) || ms < PLAY_EVERY_MIN_MS || ms > PLAY_EVERY_MAX_MS) {
+        throw new AssetMetadataError(
+          `${asset}: ${name} plays every ${String(ms)} ms, and an interval is a whole ${PLAY_EVERY_MIN_MS} to ${PLAY_EVERY_MAX_MS} ms`
+        );
       }
-    } else if (char === "]" && depth === 0) {
-      break;
+      plays.set(name, { mode: "every", ms });
+      continue;
     }
+    throw new AssetMetadataError(`${asset}: ${name} plays as ${String(play.mode)}, and an animation plays as loop, every or change`);
   }
-  return sources;
-}
-function isTile(value) {
-  if (typeof value !== "object" || value === null) return false;
-  const record = value;
-  return typeof record.x === "number" && typeof record.y === "number" && typeof record.z === "number" && Array.isArray(record.layers);
+  return plays;
 }
-function parseMapText(text2, path = "the map") {
-  let parsed2;
-  try {
-    parsed2 = JSON.parse(text2);
-  } catch (error) {
-    throw new MapTextError(`${path} is not valid JSON: ${error.message}`);
-  }
-  if (typeof parsed2 !== "object" || parsed2 === null || !Array.isArray(parsed2.tiles)) {
-    throw new MapTextError(`${path} holds no tiles array`);
+function readNineGrid(value, asset) {
+  if (value === void 0) return void 0;
+  if (!isRecord$2(value)) {
+    throw new AssetMetadataError(`${asset}: nineGrid is not an object of four insets`);
   }
-  const document = parsed2;
-  const sources = scanTileSources(text2);
-  if (sources.length !== document.tiles.length) {
-    throw new MapTextError(`${path}: the scanner found ${sources.length} tile sources for ${document.tiles.length} tiles`);
+  const insets = {};
+  for (const edge of ["top", "right", "bottom", "left"]) {
+    const inset = value[edge];
+    if (inset === void 0) {
+      throw new AssetMetadataError(`${asset}: nineGrid declares no ${edge} inset`);
+    }
+    if (typeof inset !== "number" || !Number.isInteger(inset) || inset < 0) {
+      throw new AssetMetadataError(`${asset}: nineGrid ${edge} is ${String(inset)}, which is not a whole number of pixels at or above zero`);
+    }
+    insets[edge] = inset;
   }
-  const byKey = /* @__PURE__ */ new Map();
-  document.tiles.forEach((tile, index) => {
-    if (!isTile(tile)) throw new MapTextError(`${path}: tile ${index} lacks x, y, z or layers`);
-    byKey.set(tileKey(tile.x, tile.y, tile.z), { tile, source: sources[index] });
-  });
-  return { document, sources: byKey };
+  return { top: insets.top, right: insets.right, bottom: insets.bottom, left: insets.left };
 }
-const TILE_KEYS = ["x", "y", "z", "layers", "blocking", "zone", "audioZone", "interact"];
-function serializeTile(tile) {
-  const ordered = {};
-  for (const key of TILE_KEYS) {
-    if (tile[key] !== void 0) ordered[key] = tile[key];
-  }
-  for (const key of Object.keys(tile)) {
-    if (!(key in ordered) && tile[key] !== void 0) ordered[key] = tile[key];
+function readScale(value, asset) {
+  if (value === void 0) return void 0;
+  if (typeof value !== "string" || !UI_SCALES.includes(value)) {
+    throw new AssetMetadataError(`${asset}: scale ${String(value)} is not one of ${UI_SCALES.join(", ")}`);
   }
-  return JSON.stringify(ordered);
+  return value;
 }
-function formatMap(next, previous) {
-  const lines = [];
-  let changed = 0;
-  for (const tile of next.tiles) {
-    {
-      lines.push(serializeTile(tile));
-      changed += 1;
+function readCollide(value, asset) {
+  if (value === void 0) return void 0;
+  if (!isRecord$2(value)) {
+    throw new AssetMetadataError(`${asset}: collide is not a box of x, y, w and h in cells`);
+  }
+  const box = {};
+  for (const side of ["x", "y", "w", "h"]) {
+    const cells = value[side];
+    if (typeof cells !== "number" || !Number.isInteger(cells)) {
+      throw new AssetMetadataError(`${asset}: collide ${side} is ${String(cells)}, which is not a whole number of cells`);
     }
+    box[side] = cells;
   }
-  const rest = {};
-  for (const key of Object.keys(next)) {
-    if (key !== "width" && key !== "height" && key !== "tiles") rest[key] = next[key];
+  if (box.w < 1 || box.h < 1) {
+    throw new AssetMetadataError(`${asset}: collide is ${box.w}x${box.h} cells, and a box is at least one by one`);
   }
-  const trailer = Object.keys(rest).length === 0 ? "" : `,${JSON.stringify(rest).slice(1, -1)}`;
-  const head = `{"width":${JSON.stringify(next.width)},"height":${JSON.stringify(next.height)},"tiles":[`;
-  const body = lines.length === 0 ? "" : `
-${lines.join(",\n")}
-`;
-  return { text: `${head}${body}]${trailer}}
-`, changed };
-}
-const SIGNATURE$1 = [137, 80, 78, 71, 13, 10, 26, 10];
-function isPng(bytes) {
-  return bytes.length >= 24 && SIGNATURE$1.every((byte, index) => bytes[index] === byte);
-}
-function pngSize(bytes) {
-  if (!isPng(bytes)) throw new RangeError("those bytes are not a PNG");
-  const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
-  return { width: view.getUint32(16), height: view.getUint32(20) };
-}
-const GROUND_KINDS = /* @__PURE__ */ new Set(["ground", "floor", "wall", "cliff", "interior", "grass-stone"]);
-function isGroundName(name) {
-  const { inner } = splitTileset(name);
-  const kind = inner.split("/")[1] ?? "";
-  return GROUND_KINDS.has(kind) || inner.includes("/wang-");
+  return { x: box.x, y: box.y, w: box.w, h: box.h };
 }
-const MAX_ASSEMBLED_PX = 4096;
-const TILE_SIZE = 256;
-const EAI_MAGIC = 1229018181;
-const EAI_VERSION = 1;
-const HEADER_SIZE$1 = 32;
-const ASSET_SIZE = 24;
-const ATLAS_SIZE = 12;
-class AssetIndexError extends Error {
-  // Assigned in the body: the suites run under Node's strip-only TypeScript
-  // mode, which rejects parameter properties (docs/notes.md n-0023).
-  constructor(message) {
-    super(message);
-    this.name = "AssetIndexError";
+const MAX_DRAW_OFFSET = TILE_SIZE * 8;
+const MIN_DRAW_SCALE = 0.05;
+const MAX_DRAW_SCALE = 8;
+function readOffset(value, asset) {
+  if (value === void 0) return void 0;
+  if (!isRecord$2(value) || typeof value.x !== "number" || typeof value.y !== "number" || !Number.isFinite(value.x) || !Number.isFinite(value.y)) {
+    throw new AssetMetadataError(`${asset}: offset is not an x and a y in pixels`);
+  }
+  for (const axis of ["x", "y"]) {
+    const px = value[axis];
+    if (Math.abs(px) > MAX_DRAW_OFFSET) {
+      throw new AssetMetadataError(`${asset}: offset ${axis} is ${px} px, and an offset is within ${MAX_DRAW_OFFSET} px of the tile`);
+    }
   }
+  return { x: value.x, y: value.y };
 }
-function parseAssetIndex(buffer) {
-  if (buffer.byteLength < HEADER_SIZE$1) {
-    throw new AssetIndexError(`buffer too small: ${buffer.byteLength} < ${HEADER_SIZE$1}`);
+function readDrawScale(value, asset) {
+  if (value === void 0) return void 0;
+  if (typeof value !== "number" || !Number.isFinite(value) || value <= 0) {
+    throw new AssetMetadataError(`${asset}: drawScale is ${String(value)}, and a scale is a number above zero`);
   }
-  const view = new DataView(buffer);
-  const magic = view.getUint32(0, true);
-  if (magic !== EAI_MAGIC) {
-    throw new AssetIndexError(`bad magic 0x${magic.toString(16)} (expected 0x${EAI_MAGIC.toString(16)})`);
+  if (value < MIN_DRAW_SCALE || value > MAX_DRAW_SCALE) {
+    throw new AssetMetadataError(`${asset}: drawScale is ${value}, and a scale is between ${MIN_DRAW_SCALE} and ${MAX_DRAW_SCALE}`);
   }
-  const version2 = view.getUint32(4, true);
-  if (version2 !== EAI_VERSION) {
-    throw new AssetIndexError(`unsupported version ${version2}, reader speaks v${EAI_VERSION}`);
+  return value;
+}
+function readEntry(value, asset) {
+  if (!isRecord$2(value)) {
+    throw new AssetMetadataError(`${asset}: not an entry`);
   }
-  const assetCount = view.getUint32(8, true);
-  const atlasCount = view.getUint32(12, true);
-  const assetsOffset = view.getUint32(16, true);
-  const atlasesOffset = view.getUint32(20, true);
-  const stringsOffset = view.getUint32(24, true);
-  const stringsLength = view.getUint32(28, true);
-  if (buffer.byteLength !== stringsOffset + stringsLength) {
-    throw new AssetIndexError(`file size ${buffer.byteLength} ≠ header-declared ${stringsOffset + stringsLength}`);
+  const kind = value.kind;
+  if (typeof kind !== "string") {
+    throw new AssetMetadataError(`${asset}: declares no kind`);
   }
-  if (assetsOffset < HEADER_SIZE$1) {
-    throw new AssetIndexError(`assetsOffset ${assetsOffset} is inside the ${HEADER_SIZE$1}-byte header`);
+  if (!ASSET_KINDS.includes(kind)) {
+    throw new AssetMetadataError(`${asset}: unknown kind ${kind} (expected ${ASSET_KINDS.join(", ")})`);
   }
-  if (assetsOffset + assetCount * ASSET_SIZE > atlasesOffset) {
-    throw new AssetIndexError("asset section overlaps atlas section");
+  const minimap = value.minimap;
+  if (minimap !== void 0 && (typeof minimap !== "number" || !Number.isInteger(minimap))) {
+    throw new AssetMetadataError(`${asset}: minimap category is not a whole number`);
   }
-  if (atlasesOffset + atlasCount * ATLAS_SIZE > stringsOffset) {
-    throw new AssetIndexError("atlas section overlaps string pool");
+  if (kind !== "ui" && (value.nineGrid !== void 0 || value.scale !== void 0)) {
+    throw new AssetMetadataError(`${asset}: nineGrid and scale are interface fields, and this is a ${kind}`);
   }
-  const pool = new Pool(buffer, stringsOffset, stringsLength);
-  const atlases = readAtlases(view, pool, atlasCount, atlasesOffset);
-  const assets = readAssets(view, pool, assetCount, assetsOffset, atlases);
-  return { version: version2, assets, atlases };
+  if (kind !== "tile" && (value.collide !== void 0 || value.offset !== void 0 || value.drawScale !== void 0)) {
+    throw new AssetMetadataError(`${asset}: collide, offset and drawScale are tile fields, and this is a ${kind}`);
+  }
+  const animations = readAnimations(value.animations, asset, kind);
+  return {
+    kind,
+    animations,
+    plays: readPlays(value.plays, asset, animations, kind),
+    blocking: value.blocking === true,
+    foreground: value.foreground === true,
+    roof: value.roof === true,
+    door: value.door === true,
+    water: value.water === true,
+    minimap: minimap ?? 0,
+    collide: readCollide(value.collide, asset),
+    offset: readOffset(value.offset, asset),
+    drawScale: readDrawScale(value.drawScale, asset),
+    nineGrid: readNineGrid(value.nineGrid, asset),
+    scale: readScale(value.scale, asset)
+  };
 }
-class Pool {
-  buffer;
-  offset;
-  length;
-  decoder = new TextDecoder("utf-8", { fatal: true });
-  constructor(buffer, offset, length) {
-    this.buffer = buffer;
-    this.offset = offset;
-    this.length = length;
+function parseAssetMetadata(text2) {
+  let parsed2;
+  try {
+    parsed2 = JSON.parse(text2);
+  } catch (error) {
+    throw new AssetMetadataError(`not JSON: ${error.message}`);
   }
-  read(what, nameOffset, nameLength) {
-    if (nameOffset < this.offset || nameOffset + nameLength > this.offset + this.length) {
-      throw new AssetIndexError(`${what}: name range [${nameOffset}, +${nameLength}] outside the string pool`);
-    }
-    try {
-      return this.decoder.decode(new Uint8Array(this.buffer, nameOffset, nameLength));
-    } catch (error) {
-      throw new AssetIndexError(`${what}: bad UTF-8 name (${error.message})`);
-    }
+  if (!isRecord$2(parsed2)) {
+    throw new AssetMetadataError("not an object");
   }
-}
-function readAtlases(view, pool, atlasCount, atlasesOffset) {
-  const atlases = new Array(atlasCount);
-  for (let index = 0; index < atlasCount; index += 1) {
-    const base = atlasesOffset + index * ATLAS_SIZE;
-    atlases[index] = {
-      index,
-      width: view.getUint16(base, true),
-      height: view.getUint16(base + 2, true),
-      name: pool.read(`atlas ${index}`, view.getUint32(base + 4, true), view.getUint32(base + 8, true))
-    };
+  const version2 = parsed2.version;
+  if (version2 !== METADATA_VERSION) {
+    throw new AssetMetadataError(`unsupported version ${String(version2)}, reader speaks v${METADATA_VERSION}`);
+  }
+  const rawAssets = parsed2.assets;
+  if (rawAssets !== void 0 && !isRecord$2(rawAssets)) {
+    throw new AssetMetadataError("assets is not a map of name to entry");
   }
-  return atlases;
-}
-function readAssets(view, pool, assetCount, assetsOffset, atlases) {
   const assets = /* @__PURE__ */ new Map();
-  for (let index = 0; index < assetCount; index += 1) {
-    const base = assetsOffset + index * ASSET_SIZE;
-    const name = pool.read(`asset ${index}`, view.getUint32(base, true), view.getUint16(base + 4, true));
-    if (assets.has(name)) {
-      throw new AssetIndexError(`duplicate asset name ${name}`);
-    }
-    const atlasIndex = view.getUint16(base + 6, true);
-    const atlas = atlases[atlasIndex];
-    if (atlas === void 0) {
-      throw new AssetIndexError(`asset ${name}: atlasIndex ${atlasIndex} ≥ atlasCount ${atlases.length}`);
+  for (const [name, entry] of Object.entries(rawAssets ?? {})) {
+    assets.set(name, readEntry(entry, name));
+  }
+  return { version: version2, assets };
+}
+function writeAssetMetadata(metadata) {
+  const assets = {};
+  for (const [name, entry] of [...metadata.assets].sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0)) {
+    const out = { kind: entry.kind };
+    if (entry.blocking) out.blocking = true;
+    if (entry.foreground) out.foreground = true;
+    if (entry.roof) out.roof = true;
+    if (entry.door) out.door = true;
+    if (entry.water) out.water = true;
+    if (entry.minimap !== 0) out.minimap = entry.minimap;
+    if (entry.collide !== void 0) out.collide = entry.collide;
+    if (entry.offset !== void 0) out.offset = entry.offset;
+    if (entry.drawScale !== void 0) out.drawScale = entry.drawScale;
+    if (entry.nineGrid !== void 0) out.nineGrid = entry.nineGrid;
+    if (entry.scale !== void 0) out.scale = entry.scale;
+    if (entry.animations.size > 0) {
+      const animations = {};
+      const ordered = [...entry.animations].sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0);
+      for (const [animation, frames] of ordered) {
+        animations[animation] = frames.map((frame) => frame.flip ? { asset: frame.asset, ms: frame.ms, flip: true } : { asset: frame.asset, ms: frame.ms });
+      }
+      out.animations = animations;
     }
-    const entry = {
-      name,
-      atlasIndex,
-      x: view.getUint16(base + 8, true),
-      y: view.getUint16(base + 10, true),
-      width: view.getUint16(base + 12, true),
-      height: view.getUint16(base + 14, true),
-      offsetX: view.getInt16(base + 16, true),
-      offsetY: view.getInt16(base + 18, true),
-      flags: view.getUint16(base + 20, true)
-    };
-    if (entry.x + entry.width > atlas.width || entry.y + entry.height > atlas.height) {
-      throw new AssetIndexError(
-        `asset ${name}: rectangle ${entry.x},${entry.y} ${entry.width}x${entry.height} leaves atlas ${atlas.name} (${atlas.width}x${atlas.height})`
-      );
+    if (entry.plays.size > 0) {
+      const plays = {};
+      for (const [animation, play] of [...entry.plays].sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0)) plays[animation] = play;
+      out.plays = plays;
     }
-    assets.set(name, entry);
+    assets[name] = out;
   }
-  return assets;
+  return `${JSON.stringify({ version: metadata.version, assets }, null, 2)}
+`;
 }
-const U16_MAX = 65535;
-const I16_MIN = -32768;
-const I16_MAX = 32767;
-function writeAssetIndex(atlases, assets) {
-  const encoder2 = new TextEncoder();
-  const ordered = [...assets].sort((left, right) => compareBytes(encoder2, left.name, right.name));
-  const seen = /* @__PURE__ */ new Set();
-  for (const asset of ordered) {
-    if (seen.has(asset.name)) throw new AssetIndexError(`duplicate asset name ${asset.name}`);
-    seen.add(asset.name);
-    if (asset.atlasIndex >= atlases.length) {
-      throw new AssetIndexError(`asset ${asset.name}: atlasIndex ${asset.atlasIndex} ≥ atlasCount ${atlases.length}`);
+class IdMapError extends Error {
+  // Assigned in the body: the suites run under Node's strip-only TypeScript
+  // mode, which rejects parameter properties (docs/notes.md n-0023).
+  constructor(message) {
+    super(message);
+    this.name = "IdMapError";
+  }
+}
+const SECTIONS = ["looktypes", "frames"];
+const WHOLE_NUMBER = /^(0|[1-9][0-9]*)$/;
+const FRAME_KEY = /^(0|[1-9][0-9]*):(0|[1-9][0-9]*)$/;
+function parseIdMap(raw) {
+  const record = asObject(raw, "the id map");
+  for (const section2 of Object.keys(record)) {
+    if (!SECTIONS.includes(section2)) {
+      throw new IdMapError(`unknown section ${section2}: the map has looktypes and frames`);
     }
-    checkU16(asset.name, { x: asset.x, y: asset.y, width: asset.width, height: asset.height, flags: asset.flags });
-    checkI16(asset.name, { offsetX: asset.offsetX, offsetY: asset.offsetY });
-    const atlas = atlases[asset.atlasIndex];
-    if (asset.x + asset.width > atlas.width || asset.y + asset.height > atlas.height) {
-      throw new AssetIndexError(`asset ${asset.name}: rectangle leaves atlas ${atlas.name} (${atlas.width}x${atlas.height})`);
+  }
+  const looktypes = /* @__PURE__ */ new Map();
+  const frames = /* @__PURE__ */ new Map();
+  const names = /* @__PURE__ */ new Set();
+  for (const [key, value] of Object.entries(section(record, "looktypes"))) {
+    if (!WHOLE_NUMBER.test(key)) {
+      throw new IdMapError(`looktype key ${key} is not a whole number`);
     }
+    const name = assetName(value, `looktype ${key}`);
+    looktypes.set(Number(key), name);
+    names.add(name);
   }
-  for (const atlas of atlases) {
-    checkU16(atlas.name, { width: atlas.width, height: atlas.height });
+  for (const [key, value] of Object.entries(section(record, "frames"))) {
+    if (!FRAME_KEY.test(key)) {
+      throw new IdMapError(`frame key ${key} is not packId:frameId`);
+    }
+    const name = assetName(value, `frame ${key}`);
+    frames.set(key, name);
+    names.add(name);
   }
-  const pool = [];
-  const ranges = /* @__PURE__ */ new Map();
-  const intern = (text2) => {
-    const found = ranges.get(text2);
-    if (found !== void 0) return found;
-    const bytes = encoder2.encode(text2);
-    const range = { offset: pool.length, length: bytes.length };
-    if (range.length > U16_MAX) throw new AssetIndexError(`name too long: ${text2}`);
-    pool.push(...bytes);
-    ranges.set(text2, range);
-    return range;
+  return {
+    nameForLooktype: (looktype) => looktypes.get(looktype) ?? null,
+    nameForFrame: (packId, frameId) => frames.get(`${packId}:${frameId}`) ?? null,
+    names,
+    looktypeCount: looktypes.size,
+    frameCount: frames.size
   };
-  for (const asset of ordered) intern(asset.name);
-  for (const atlas of atlases) intern(atlas.name);
-  const assetsOffset = HEADER_SIZE$1;
-  const atlasesOffset = assetsOffset + ordered.length * ASSET_SIZE;
-  const stringsOffset = atlasesOffset + atlases.length * ATLAS_SIZE;
-  const buffer = new ArrayBuffer(stringsOffset + pool.length);
-  const view = new DataView(buffer);
-  view.setUint32(0, EAI_MAGIC, true);
-  view.setUint32(4, EAI_VERSION, true);
-  view.setUint32(8, ordered.length, true);
-  view.setUint32(12, atlases.length, true);
-  view.setUint32(16, assetsOffset, true);
-  view.setUint32(20, atlasesOffset, true);
-  view.setUint32(24, stringsOffset, true);
-  view.setUint32(28, pool.length, true);
-  ordered.forEach((asset, index) => {
-    const base = assetsOffset + index * ASSET_SIZE;
-    const range = ranges.get(asset.name);
-    view.setUint32(base, stringsOffset + range.offset, true);
-    view.setUint16(base + 4, range.length, true);
-    view.setUint16(base + 6, asset.atlasIndex, true);
-    view.setUint16(base + 8, asset.x, true);
-    view.setUint16(base + 10, asset.y, true);
-    view.setUint16(base + 12, asset.width, true);
-    view.setUint16(base + 14, asset.height, true);
-    view.setInt16(base + 16, asset.offsetX, true);
-    view.setInt16(base + 18, asset.offsetY, true);
-    view.setUint16(base + 20, asset.flags, true);
-  });
-  atlases.forEach((atlas, index) => {
-    const base = atlasesOffset + index * ATLAS_SIZE;
-    const range = ranges.get(atlas.name);
-    view.setUint16(base, atlas.width, true);
-    view.setUint16(base + 2, atlas.height, true);
-    view.setUint32(base + 4, stringsOffset + range.offset, true);
-    view.setUint32(base + 8, range.length, true);
-  });
-  new Uint8Array(buffer).set(new Uint8Array(pool), stringsOffset);
-  return buffer;
-}
-function compareBytes(encoder2, left, right) {
-  const a = encoder2.encode(left);
-  const b = encoder2.encode(right);
-  for (let index = 0; index < Math.min(a.length, b.length); index += 1) {
-    const difference = (a[index] ?? 0) - (b[index] ?? 0);
-    if (difference !== 0) return difference;
-  }
-  return a.length - b.length;
 }
-function checkU16(what, fields) {
-  for (const [field, value] of Object.entries(fields)) {
-    if (!Number.isInteger(value) || value < 0 || value > U16_MAX) {
-      throw new AssetIndexError(`${what}: ${field} ${value} does not fit in a u16`);
-    }
+function checkNamesAgainstIndex(map, index, declared = /* @__PURE__ */ new Set()) {
+  const absent = [...map.names].filter((name) => !index.assets.has(name) && !declared.has(name)).sort();
+  if (absent.length > 0) {
+    throw new IdMapError(`the id map names assets the index does not hold: ${absent.join(", ")}`);
   }
 }
-function checkI16(what, fields) {
-  for (const [field, value] of Object.entries(fields)) {
-    if (!Number.isInteger(value) || value < I16_MIN || value > I16_MAX) {
-      throw new AssetIndexError(`${what}: ${field} ${value} does not fit in an i16`);
-    }
+function asObject(value, what) {
+  if (value === null || typeof value !== "object" || Array.isArray(value)) {
+    throw new IdMapError(`${what} must be a JSON object`);
   }
+  return value;
 }
-const METADATA_ENTRY = "meta.json";
-const METADATA_VERSION = 1;
-const ANIMATION_KEYS = [
-  "idle",
-  "stand-north",
-  "stand-south",
-  "stand-west",
-  "stand-east",
-  "walk-north",
-  "walk-south",
-  "walk-west",
-  "walk-east",
-  "attack-north",
-  "attack-south",
-  "attack-west",
-  "attack-east",
-  "icon"
-];
-const ANIMATION_KEY_SET = new Set(ANIMATION_KEYS);
-function isAnimationKey(key) {
-  return ANIMATION_KEY_SET.has(key);
+function section(record, name) {
+  const value = record[name];
+  return value === void 0 ? {} : asObject(value, `${name}`);
 }
-const ASSET_KINDS = ["outfit", "tile", "item", "effect", "ui"];
-const UI_SCALES = ["stretch", "repeat", "round"];
-const PLAY_EVERY_MIN_MS = 250;
-const PLAY_EVERY_MAX_MS = 6e5;
-const MAX_ANIMATION_NAME = 48;
-const ANIMATION_NAME = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
-function isAnimationName(name) {
-  return name.length <= MAX_ANIMATION_NAME && ANIMATION_NAME.test(name);
+function assetName(value, what) {
+  if (typeof value !== "string" || value.trim() === "") {
+    throw new IdMapError(`${what}: the asset name must be a non-empty string`);
+  }
+  return value;
 }
-class AssetMetadataError extends Error {
-  // Assigned in the body: the suites run under Node's strip-only TypeScript
-  // mode, which rejects parameter properties (docs/notes.md n-0023).
+const EAC_MAGIC = 826491205;
+const EAC_VERSION = 1;
+const INDEX_ENTRY = "assets.eai";
+const ID_MAP_ENTRY = "id-map.json";
+const HEADER_SIZE = 32;
+const FLAG_MASKED = 1;
+const MASK_KEY = Uint8Array.from([69, 116, 101, 114, 110, 105, 116, 121, 77, 69, 45, 115, 101, 97, 108, 33]);
+class ContainerError extends Error {
+  // Assigned in the body: Node's strip-only TypeScript mode rejects parameter
+  // properties (docs/notes.md n-0023).
   constructor(message) {
     super(message);
-    this.name = "AssetMetadataError";
+    this.name = "ContainerError";
   }
 }
-function isRecord$2(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
+function maskByte(value, offset) {
+  const key = MASK_KEY[offset % MASK_KEY.length];
+  const drift = Math.imul(offset, 31) + (offset >>> 5) & 255;
+  return (value ^ key ^ drift) & 255;
 }
-const MAX_ANIMATION_FRAMES = 64;
-function readFrames(value, asset, animation) {
-  if (!Array.isArray(value)) {
-    throw new AssetMetadataError(`${asset}: animation ${animation} is not a list of frames`);
+function maskInto(target, start, source) {
+  for (let index = 0; index < source.length; index += 1) {
+    target[start + index] = maskByte(source[index], start + index);
   }
-  if (value.length > MAX_ANIMATION_FRAMES) {
-    throw new AssetMetadataError(`${asset}: animation ${animation} has ${value.length} frames, and an animation holds at most ${MAX_ANIMATION_FRAMES}`);
+}
+function sealContainer(entries) {
+  const seen = /* @__PURE__ */ new Set();
+  for (const entry of entries) {
+    if (seen.has(entry.name)) throw new ContainerError(`duplicate entry name ${entry.name}`);
+    seen.add(entry.name);
   }
-  return value.map((raw, index) => {
-    if (!isRecord$2(raw)) {
-      throw new AssetMetadataError(`${asset}: animation ${animation} frame ${index} is not a frame`);
-    }
-    const name = raw.asset;
-    if (typeof name !== "string" || name === "") {
-      throw new AssetMetadataError(`${asset}: animation ${animation} frame ${index} names no asset`);
-    }
-    const ms = raw.ms;
-    if (typeof ms !== "number" || !Number.isInteger(ms) || ms < 0) {
-      throw new AssetMetadataError(
-        `${asset}: animation ${animation} frame ${index} has duration ${String(ms)}, which is not a whole number of milliseconds at or above zero`
-      );
-    }
-    return { asset: name, ms, flip: raw.flip === true };
+  const encoder2 = new TextEncoder();
+  const ordered = [...entries].sort((left, right) => left.name < right.name ? -1 : left.name > right.name ? 1 : 0);
+  const names = ordered.map((entry) => encoder2.encode(entry.name));
+  const tocLength = names.reduce((total, name) => total + 2 + name.length + 8, 0);
+  const tocOffset = HEADER_SIZE;
+  const payloadOffset = tocOffset + tocLength;
+  const payloadLength = ordered.reduce((total, entry) => total + entry.bytes.length, 0);
+  const out = new Uint8Array(payloadOffset + payloadLength);
+  const view = new DataView(out.buffer);
+  view.setUint32(0, EAC_MAGIC, true);
+  view.setUint32(4, EAC_VERSION, true);
+  view.setUint32(8, ordered.length, true);
+  view.setUint32(12, tocOffset, true);
+  view.setUint32(16, tocLength, true);
+  view.setUint32(20, payloadOffset, true);
+  view.setUint32(24, FLAG_MASKED, true);
+  view.setUint32(28, 0, true);
+  const toc = new Uint8Array(tocLength);
+  const tocView = new DataView(toc.buffer);
+  let cursor = 0;
+  let entryOffset = payloadOffset;
+  ordered.forEach((entry, index) => {
+    const name = names[index];
+    tocView.setUint16(cursor, name.length, true);
+    cursor += 2;
+    toc.set(name, cursor);
+    cursor += name.length;
+    tocView.setUint32(cursor, entryOffset, true);
+    cursor += 4;
+    tocView.setUint32(cursor, entry.bytes.length, true);
+    cursor += 4;
+    maskInto(out, entryOffset, entry.bytes);
+    entryOffset += entry.bytes.length;
   });
+  maskInto(out, tocOffset, toc);
+  return out;
 }
-function readAnimations(value, asset, kind) {
-  const animations = /* @__PURE__ */ new Map();
-  if (value === void 0) return animations;
-  if (!isRecord$2(value)) {
-    throw new AssetMetadataError(`${asset}: animations is not a map of name to frames`);
-  }
-  for (const [name, frames] of Object.entries(value)) {
-    if (kind === "outfit" && !isAnimationKey(name)) {
-      throw new AssetMetadataError(`${asset}: unknown animation ${name} (expected one of ${ANIMATION_KEYS.join(", ")})`);
-    }
-    if (kind !== "outfit" && !isAnimationName(name)) {
-      throw new AssetMetadataError(`${asset}: animation ${name} is not a kebab-case name of at most ${MAX_ANIMATION_NAME} characters`);
-    }
-    animations.set(name, readFrames(frames, asset, name));
+function tileSpritePlacement(tx, ty, width, height, tileSize = TILE_SIZE) {
+  const overhangX = (width - tileSize) / 2;
+  const overhangY = (height - tileSize) / 2;
+  return { x: tx * tileSize - overhangX, y: ty * tileSize - overhangY };
+}
+function placeTileSprite(tx, ty, width, height, options = {}) {
+  const tileSize = options.tileSize ?? TILE_SIZE;
+  const scale = options.drawScale ?? 1;
+  const scaledWidth = width * scale;
+  const scaledHeight = height * scale;
+  const centred = tileSpritePlacement(tx, ty, scaledWidth, scaledHeight, tileSize);
+  return {
+    x: centred.x + (options.offset?.x ?? 0),
+    y: centred.y + (options.offset?.y ?? 0),
+    width: scaledWidth,
+    height: scaledHeight
+  };
+}
+class MapTextError extends Error {
+  // Assigned in the body: the suites run under Node's strip-only TypeScript
+  // mode, which rejects parameter properties (docs/notes.md n-0023).
+  constructor(message) {
+    super(message);
+    this.name = "MapTextError";
   }
-  return animations;
 }
-function readPlays(value, asset, animations, kind) {
-  const plays = /* @__PURE__ */ new Map();
-  if (value === void 0) return plays;
-  if (!isRecord$2(value)) throw new AssetMetadataError(`${asset}: plays is not a map of animation to how it plays`);
-  for (const [name, play] of Object.entries(value)) {
-    if (!animations.has(name)) throw new AssetMetadataError(`${asset}: plays names ${name}, and there is no such animation`);
-    if (!isRecord$2(play)) throw new AssetMetadataError(`${asset}: how ${name} plays is not an object`);
-    if (kind === "outfit" && play.mode !== "loop")
-      throw new AssetMetadataError(`${asset}: ${name} is an outfit's animation, which plays as the game drives it, in a loop`);
-    if (play.mode === "loop" || play.mode === "change") {
-      plays.set(name, { mode: play.mode });
+function tileKey(x, y, z) {
+  return `${x}:${y}:${z}`;
+}
+function scanTileSources(text2) {
+  const key = '"tiles"';
+  let at = text2.indexOf(key);
+  if (at === -1) return [];
+  at = text2.indexOf("[", at + key.length);
+  if (at === -1) return [];
+  const sources = [];
+  let depth = 0;
+  let inString = false;
+  let start = -1;
+  for (let index = at + 1; index < text2.length; index += 1) {
+    const char = text2[index];
+    if (inString) {
+      if (char === "\\") index += 1;
+      else if (char === '"') inString = false;
       continue;
     }
-    if (play.mode === "every") {
-      const ms = play.ms;
-      if (typeof ms !== "number" || !Number.isInteger(ms) || ms < PLAY_EVERY_MIN_MS || ms > PLAY_EVERY_MAX_MS) {
-        throw new AssetMetadataError(
-          `${asset}: ${name} plays every ${String(ms)} ms, and an interval is a whole ${PLAY_EVERY_MIN_MS} to ${PLAY_EVERY_MAX_MS} ms`
-        );
+    if (char === '"') {
+      inString = true;
+    } else if (char === "{") {
+      if (depth === 0) start = index;
+      depth += 1;
+    } else if (char === "}") {
+      depth -= 1;
+      if (depth === 0 && start !== -1) {
+        sources.push(text2.slice(start, index + 1));
+        start = -1;
       }
-      plays.set(name, { mode: "every", ms });
-      continue;
-    }
-    throw new AssetMetadataError(`${asset}: ${name} plays as ${String(play.mode)}, and an animation plays as loop, every or change`);
-  }
-  return plays;
-}
-function readNineGrid(value, asset) {
-  if (value === void 0) return void 0;
-  if (!isRecord$2(value)) {
-    throw new AssetMetadataError(`${asset}: nineGrid is not an object of four insets`);
-  }
-  const insets = {};
-  for (const edge of ["top", "right", "bottom", "left"]) {
-    const inset = value[edge];
-    if (inset === void 0) {
-      throw new AssetMetadataError(`${asset}: nineGrid declares no ${edge} inset`);
-    }
-    if (typeof inset !== "number" || !Number.isInteger(inset) || inset < 0) {
-      throw new AssetMetadataError(`${asset}: nineGrid ${edge} is ${String(inset)}, which is not a whole number of pixels at or above zero`);
+    } else if (char === "]" && depth === 0) {
+      break;
     }
-    insets[edge] = inset;
   }
-  return { top: insets.top, right: insets.right, bottom: insets.bottom, left: insets.left };
+  return sources;
 }
-function readScale(value, asset) {
-  if (value === void 0) return void 0;
-  if (typeof value !== "string" || !UI_SCALES.includes(value)) {
-    throw new AssetMetadataError(`${asset}: scale ${String(value)} is not one of ${UI_SCALES.join(", ")}`);
-  }
-  return value;
+function isTile(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const record = value;
+  return typeof record.x === "number" && typeof record.y === "number" && typeof record.z === "number" && Array.isArray(record.layers);
 }
-function readCollide(value, asset) {
-  if (value === void 0) return void 0;
-  if (!isRecord$2(value)) {
-    throw new AssetMetadataError(`${asset}: collide is not a box of x, y, w and h in cells`);
+function parseMapText(text2, path = "the map") {
+  let parsed2;
+  try {
+    parsed2 = JSON.parse(text2);
+  } catch (error) {
+    throw new MapTextError(`${path} is not valid JSON: ${error.message}`);
   }
-  const box = {};
-  for (const side of ["x", "y", "w", "h"]) {
-    const cells = value[side];
-    if (typeof cells !== "number" || !Number.isInteger(cells)) {
-      throw new AssetMetadataError(`${asset}: collide ${side} is ${String(cells)}, which is not a whole number of cells`);
-    }
-    box[side] = cells;
+  if (typeof parsed2 !== "object" || parsed2 === null || !Array.isArray(parsed2.tiles)) {
+    throw new MapTextError(`${path} holds no tiles array`);
   }
-  if (box.w < 1 || box.h < 1) {
-    throw new AssetMetadataError(`${asset}: collide is ${box.w}x${box.h} cells, and a box is at least one by one`);
+  const document = parsed2;
+  const sources = scanTileSources(text2);
+  if (sources.length !== document.tiles.length) {
+    throw new MapTextError(`${path}: the scanner found ${sources.length} tile sources for ${document.tiles.length} tiles`);
   }
-  return { x: box.x, y: box.y, w: box.w, h: box.h };
+  const byKey = /* @__PURE__ */ new Map();
+  document.tiles.forEach((tile, index) => {
+    if (!isTile(tile)) throw new MapTextError(`${path}: tile ${index} lacks x, y, z or layers`);
+    byKey.set(tileKey(tile.x, tile.y, tile.z), { tile, source: sources[index] });
+  });
+  return { document, sources: byKey };
 }
-const MAX_DRAW_OFFSET = TILE_SIZE * 8;
-const MIN_DRAW_SCALE = 0.05;
-const MAX_DRAW_SCALE = 8;
-function readOffset(value, asset) {
-  if (value === void 0) return void 0;
-  if (!isRecord$2(value) || typeof value.x !== "number" || typeof value.y !== "number" || !Number.isFinite(value.x) || !Number.isFinite(value.y)) {
-    throw new AssetMetadataError(`${asset}: offset is not an x and a y in pixels`);
+const TILE_KEYS = ["x", "y", "z", "layers", "blocking", "zone", "audioZone", "interact"];
+function serializeTile(tile) {
+  const ordered = {};
+  for (const key of TILE_KEYS) {
+    if (tile[key] !== void 0) ordered[key] = tile[key];
   }
-  for (const axis of ["x", "y"]) {
-    const px = value[axis];
-    if (Math.abs(px) > MAX_DRAW_OFFSET) {
-      throw new AssetMetadataError(`${asset}: offset ${axis} is ${px} px, and an offset is within ${MAX_DRAW_OFFSET} px of the tile`);
-    }
+  for (const key of Object.keys(tile)) {
+    if (!(key in ordered) && tile[key] !== void 0) ordered[key] = tile[key];
   }
-  return { x: value.x, y: value.y };
+  return JSON.stringify(ordered);
 }
-function readDrawScale(value, asset) {
-  if (value === void 0) return void 0;
-  if (typeof value !== "number" || !Number.isFinite(value) || value <= 0) {
-    throw new AssetMetadataError(`${asset}: drawScale is ${String(value)}, and a scale is a number above zero`);
+function formatMap(next, previous) {
+  const lines = [];
+  let changed = 0;
+  for (const tile of next.tiles) {
+    {
+      lines.push(serializeTile(tile));
+      changed += 1;
+    }
   }
-  if (value < MIN_DRAW_SCALE || value > MAX_DRAW_SCALE) {
-    throw new AssetMetadataError(`${asset}: drawScale is ${value}, and a scale is between ${MIN_DRAW_SCALE} and ${MAX_DRAW_SCALE}`);
+  const rest = {};
+  for (const key of Object.keys(next)) {
+    if (key !== "width" && key !== "height" && key !== "tiles") rest[key] = next[key];
   }
-  return value;
+  const trailer = Object.keys(rest).length === 0 ? "" : `,${JSON.stringify(rest).slice(1, -1)}`;
+  const head = `{"width":${JSON.stringify(next.width)},"height":${JSON.stringify(next.height)},"tiles":[`;
+  const body = lines.length === 0 ? "" : `
+${lines.join(",\n")}
+`;
+  return { text: `${head}${body}]${trailer}}
+`, changed };
 }
-function readEntry(value, asset) {
-  if (!isRecord$2(value)) {
-    throw new AssetMetadataError(`${asset}: not an entry`);
-  }
-  const kind = value.kind;
-  if (typeof kind !== "string") {
-    throw new AssetMetadataError(`${asset}: declares no kind`);
-  }
-  if (!ASSET_KINDS.includes(kind)) {
-    throw new AssetMetadataError(`${asset}: unknown kind ${kind} (expected ${ASSET_KINDS.join(", ")})`);
-  }
-  const minimap = value.minimap;
-  if (minimap !== void 0 && (typeof minimap !== "number" || !Number.isInteger(minimap))) {
-    throw new AssetMetadataError(`${asset}: minimap category is not a whole number`);
-  }
-  if (kind !== "ui" && (value.nineGrid !== void 0 || value.scale !== void 0)) {
-    throw new AssetMetadataError(`${asset}: nineGrid and scale are interface fields, and this is a ${kind}`);
-  }
-  if (kind !== "tile" && (value.collide !== void 0 || value.offset !== void 0 || value.drawScale !== void 0)) {
-    throw new AssetMetadataError(`${asset}: collide, offset and drawScale are tile fields, and this is a ${kind}`);
-  }
-  const animations = readAnimations(value.animations, asset, kind);
-  return {
-    kind,
-    animations,
-    plays: readPlays(value.plays, asset, animations, kind),
-    blocking: value.blocking === true,
-    foreground: value.foreground === true,
-    roof: value.roof === true,
-    door: value.door === true,
-    water: value.water === true,
-    minimap: minimap ?? 0,
-    collide: readCollide(value.collide, asset),
-    offset: readOffset(value.offset, asset),
-    drawScale: readDrawScale(value.drawScale, asset),
-    nineGrid: readNineGrid(value.nineGrid, asset),
-    scale: readScale(value.scale, asset)
-  };
+const ROUTE_MULTIPLE = 16;
+function blank(width, height) {
+  return { width, height, data: new Uint8ClampedArray(width * height * 4) };
 }
-function parseAssetMetadata(text2) {
-  let parsed2;
-  try {
-    parsed2 = JSON.parse(text2);
-  } catch (error) {
-    throw new AssetMetadataError(`not JSON: ${error.message}`);
-  }
-  if (!isRecord$2(parsed2)) {
-    throw new AssetMetadataError("not an object");
+const CELLS_PER_TILE = 64;
+const MAX_CELL = 16;
+const MIN_CELL = 8;
+const ROUTE_MAX_EDGE = 3840;
+const ROUTE_MAX_PIXELS = 8294400;
+const ROUTE_MIN_PIXELS = 655360;
+const ROUTE_STEP = 16;
+function gridForCells(cols, rows, cellsPerTile = CELLS_PER_TILE) {
+  if (!Number.isInteger(cols) || !Number.isInteger(rows) || cols <= 0 || rows <= 0) return null;
+  const drawn = (cell) => cols * cell <= ROUTE_MAX_EDGE && rows * cell <= ROUTE_MAX_EDGE && cols * cell * rows * cell <= ROUTE_MAX_PIXELS && cols * cell % ROUTE_STEP === 0 && rows * cell % ROUTE_STEP === 0;
+  const unscaled = (cell) => cols * cell * rows * cell >= ROUTE_MIN_PIXELS;
+  const canvas = (cell) => ({ width: cols * cell, height: rows * cell, cell, pxPerTile: cellsPerTile * cell });
+  if (drawn(MAX_CELL) && unscaled(MAX_CELL)) return canvas(MAX_CELL);
+  if (drawn(MAX_CELL)) {
+    for (let cell = MAX_CELL + 1; cell * Math.max(cols, rows) <= ROUTE_MAX_EDGE; cell += 1) if (drawn(cell) && unscaled(cell)) return canvas(cell);
+    return null;
   }
-  const version2 = parsed2.version;
-  if (version2 !== METADATA_VERSION) {
-    throw new AssetMetadataError(`unsupported version ${String(version2)}, reader speaks v${METADATA_VERSION}`);
+  for (let cell = MAX_CELL - 1; cell >= MIN_CELL; cell -= 1) if (drawn(cell) && unscaled(cell)) return canvas(cell);
+  return null;
+}
+const LEAST_CELLS_PER_TILE = 16;
+function cellCounts(cellsPerTile) {
+  const counts = [cellsPerTile];
+  for (let cells = cellsPerTile / 2; Number.isInteger(cells) && cells >= LEAST_CELLS_PER_TILE; cells /= 2) counts.push(cells);
+  return counts;
+}
+function gridCanvas(footprint, cellsPerTile = CELLS_PER_TILE) {
+  for (const cells of cellCounts(cellsPerTile)) {
+    const canvas = gridForCells(footprint.cols * cells, footprint.rows * cells, cells);
+    if (canvas !== null) return canvas;
   }
-  const rawAssets = parsed2.assets;
-  if (rawAssets !== void 0 && !isRecord$2(rawAssets)) {
-    throw new AssetMetadataError("assets is not a map of name to entry");
+  return null;
+}
+function gridProblem(footprint, cellsPerTile = CELLS_PER_TILE) {
+  if (gridCanvas(footprint, cellsPerTile) !== null) return null;
+  const least = cellCounts(cellsPerTile).at(-1);
+  const side = Math.floor(ROUTE_MAX_EDGE / (least * MIN_CELL));
+  const area = Math.floor(ROUTE_MAX_PIXELS / (least * MIN_CELL) ** 2);
+  return `a ${footprint.cols}×${footprint.rows} tile object is too large to draw on the grid: at most ${side} tile${side === 1 ? "" : "s"} on a side and ${area} tile${area === 1 ? "" : "s"} in all`;
+}
+const WINDOW_PX = { width: 1536, height: 1024 };
+const SCALES = [TILE_SIZE, TILE_SIZE / 2, TILE_SIZE / 4, TILE_SIZE / 8, TILE_SIZE / 16];
+function scaleFor(tilesWide, tilesHigh) {
+  if (tilesWide <= 0 || tilesHigh <= 0) return null;
+  for (const scale of SCALES) {
+    if (tilesWide * scale <= WINDOW_PX.width && tilesHigh * scale <= WINDOW_PX.height) return scale;
   }
-  const assets = /* @__PURE__ */ new Map();
-  for (const [name, entry] of Object.entries(rawAssets ?? {})) {
-    assets.set(name, readEntry(entry, name));
+  return null;
+}
+({
+  width: Math.floor(WINDOW_PX.width / SCALES.at(-1)),
+  height: Math.floor(WINDOW_PX.height / SCALES.at(-1))
+});
+function designCanvas(tiles) {
+  if (!Number.isInteger(tiles.cols) || !Number.isInteger(tiles.rows) || tiles.cols < 1 || tiles.rows < 1) return null;
+  const scale = scaleFor(tiles.cols, tiles.rows);
+  if (scale === null) return null;
+  return { cols: tiles.cols, rows: tiles.rows, scale, width: tiles.cols * scale, height: tiles.rows * scale };
+}
+const CONCEPT_ART = "concept-art";
+const OLD_CONCEPT_ART = "level-design";
+function currentKind(kind) {
+  return kind === OLD_CONCEPT_ART ? CONCEPT_ART : kind;
+}
+const DEFAULT_CONCEPT_SIZE = { width: 1536, height: 1024 };
+const DEFAULT_CONCEPT_TILES = { cols: 6, rows: 4 };
+const CONCEPT_SIDE = { min: 256, max: 1536 };
+const WINDOWS = [
+  { width: 1536, height: 1024 },
+  { width: 1024, height: 1536 }
+];
+function conceptSizeProblem(size) {
+  const { width, height } = size;
+  const side = (value) => Number.isInteger(value) && value >= CONCEPT_SIDE.min && value <= CONCEPT_SIDE.max && value % ROUTE_MULTIPLE === 0;
+  if (!side(width) || !side(height))
+    return `a concept art's sides are multiples of ${ROUTE_MULTIPLE} from ${CONCEPT_SIDE.min} to ${CONCEPT_SIDE.max} px, not ${width} × ${height}`;
+  if (!WINDOWS.some((window) => width <= window.width && height <= window.height))
+    return `a ${width} × ${height} px concept art is past the route's window: it fits within 1536 × 1024 or 1024 × 1536`;
+  return null;
+}
+function conceptShapeProblem(shape) {
+  if (shape.pixelArt === true) {
+    if (shape.size !== void 0) return "a pixel-art concept art is sized in tiles, not in pixels";
+    if (shape.background === "transparent") return "a pixel-art concept art is a whole area, with no background to cut away";
+    const tiles = shape.tiles ?? DEFAULT_CONCEPT_TILES;
+    return designCanvas(tiles) === null ? `a ${tiles.cols}×${tiles.rows} tile concept art does not fit the route's window` : null;
   }
-  return { version: version2, assets };
+  if (shape.tiles !== void 0) return "tiles are a pixel-art concept art's: ask for pixel art too";
+  return shape.size === void 0 ? null : conceptSizeProblem(shape.size);
 }
-function writeAssetMetadata(metadata) {
-  const assets = {};
-  for (const [name, entry] of [...metadata.assets].sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0)) {
-    const out = { kind: entry.kind };
-    if (entry.blocking) out.blocking = true;
-    if (entry.foreground) out.foreground = true;
-    if (entry.roof) out.roof = true;
-    if (entry.door) out.door = true;
-    if (entry.water) out.water = true;
-    if (entry.minimap !== 0) out.minimap = entry.minimap;
-    if (entry.collide !== void 0) out.collide = entry.collide;
-    if (entry.offset !== void 0) out.offset = entry.offset;
-    if (entry.drawScale !== void 0) out.drawScale = entry.drawScale;
-    if (entry.nineGrid !== void 0) out.nineGrid = entry.nineGrid;
-    if (entry.scale !== void 0) out.scale = entry.scale;
-    if (entry.animations.size > 0) {
-      const animations = {};
-      const ordered = [...entry.animations].sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0);
-      for (const [animation, frames] of ordered) {
-        animations[animation] = frames.map((frame) => frame.flip ? { asset: frame.asset, ms: frame.ms, flip: true } : { asset: frame.asset, ms: frame.ms });
-      }
-      out.animations = animations;
-    }
-    if (entry.plays.size > 0) {
-      const plays = {};
-      for (const [animation, play] of [...entry.plays].sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0)) plays[animation] = play;
-      out.plays = plays;
-    }
-    assets[name] = out;
+const MAX_ART_TAGS = 8;
+const TAG = /^[a-z0-9][a-z0-9-]{0,31}$/;
+function tagProblem(tag2) {
+  return TAG.test(tag2) ? null : `${JSON.stringify(tag2)} is not a tag: 1 to 32 lowercase letters, digits and dashes, starting with a letter or a digit`;
+}
+function tagOf(typed) {
+  return typed.trim().toLowerCase().replace(/[\s_]+/g, "-");
+}
+function tagsProblem(tags) {
+  if (tags.length > MAX_ART_TAGS) return `a concept art carries at most ${MAX_ART_TAGS} tags, not ${tags.length}`;
+  for (const tag2 of tags) {
+    const problem = tagProblem(tag2);
+    if (problem !== null) return problem;
   }
-  return `${JSON.stringify({ version: metadata.version, assets }, null, 2)}
-`;
+  const repeated = tags.find((tag2, at) => tags.indexOf(tag2) !== at);
+  return repeated === void 0 ? null : `${repeated} is given twice`;
 }
-class IdMapError extends Error {
-  // Assigned in the body: the suites run under Node's strip-only TypeScript
-  // mode, which rejects parameter properties (docs/notes.md n-0023).
+const SECTOR_SIDE$1 = 128;
+const SECTOR_CELLS = SECTOR_SIDE$1 * SECTOR_SIDE$1;
+const SECTOR_BYTES = 512 * 1024;
+const MAP_LEVELS = { first: 0, last: 14 };
+const LARGEST_MAP_SIDE = 1e4;
+const OUTLINE_ACROSS = Math.ceil(LARGEST_MAP_SIDE / SECTOR_SIDE$1);
+const SECTOR_FORMAT = 1;
+const MAGIC = [80, 86, 67];
+const PRESENT = 1;
+const AUDIO = 2;
+const INTERACT = 4;
+const EXTRA = 8;
+const U16 = 65535;
+const MAX_LAYERS = 255;
+const NAMED$1 = /* @__PURE__ */ new Set(["x", "y", "z", "layers", "blocking", "zone", "audioZone", "interact"]);
+class SectorError extends Error {
   constructor(message) {
     super(message);
-    this.name = "IdMapError";
+    this.name = "SectorError";
   }
 }
-const SECTIONS = ["looktypes", "frames"];
-const WHOLE_NUMBER = /^(0|[1-9][0-9]*)$/;
-const FRAME_KEY = /^(0|[1-9][0-9]*):(0|[1-9][0-9]*)$/;
-function parseIdMap(raw) {
-  const record = asObject(raw, "the id map");
-  for (const section2 of Object.keys(record)) {
-    if (!SECTIONS.includes(section2)) {
-      throw new IdMapError(`unknown section ${section2}: the map has looktypes and frames`);
+function u16(value, what) {
+  if (!Number.isInteger(value) || value < 0 || value > U16) throw new SectorError(`${what} is ${value}, and a sector holds a whole number from 0 to 65,535`);
+  return value;
+}
+function encodeSector(cells) {
+  if (cells.length !== SECTOR_CELLS) throw new SectorError(`a sector is ${SECTOR_CELLS} cells, not ${cells.length}`);
+  const encoder2 = new TextEncoder();
+  const bytes = [...MAGIC, SECTOR_FORMAT];
+  const push16 = (value) => bytes.push(value & 255, value >> 8);
+  for (const cell of cells) {
+    if (cell === void 0) {
+      bytes.push(0);
+      continue;
     }
-  }
-  const looktypes = /* @__PURE__ */ new Map();
-  const frames = /* @__PURE__ */ new Map();
-  const names = /* @__PURE__ */ new Set();
-  for (const [key, value] of Object.entries(section(record, "looktypes"))) {
-    if (!WHOLE_NUMBER.test(key)) {
-      throw new IdMapError(`looktype key ${key} is not a whole number`);
+    const extra = cell.extra === void 0 ? null : encoder2.encode(JSON.stringify(cell.extra));
+    if (extra !== null && extra.length > U16) throw new SectorError("a tile's extra fields are past 65,535 bytes");
+    if (cell.layers.length > MAX_LAYERS) throw new SectorError(`a tile has ${cell.layers.length} layers, and a sector holds at most ${MAX_LAYERS}`);
+    bytes.push(PRESENT | (cell.audioZone === void 0 ? 0 : AUDIO) | (cell.interact === void 0 ? 0 : INTERACT) | (extra === null ? 0 : EXTRA));
+    bytes.push(cell.layers.length);
+    for (const layer of cell.layers) push16(u16(layer, "a layer id"));
+    push16(u16(cell.blocking, "blocking"));
+    push16(u16(cell.zone, "a zone"));
+    if (cell.audioZone !== void 0) push16(u16(cell.audioZone, "an audio zone"));
+    if (cell.interact !== void 0) push16(u16(cell.interact, "interact"));
+    if (extra !== null) {
+      push16(extra.length);
+      for (const byte of extra) bytes.push(byte);
     }
-    const name = assetName(value, `looktype ${key}`);
-    looktypes.set(Number(key), name);
-    names.add(name);
   }
-  for (const [key, value] of Object.entries(section(record, "frames"))) {
-    if (!FRAME_KEY.test(key)) {
-      throw new IdMapError(`frame key ${key} is not packId:frameId`);
+  return Uint8Array.from(bytes);
+}
+function decodeSector(bytes) {
+  if (bytes.length < 4 || MAGIC.some((byte, index) => bytes[index] !== byte)) throw new SectorError("these bytes are not a map sector");
+  if (bytes[3] !== SECTOR_FORMAT) throw new SectorError(`a map sector of format ${bytes[3]} is not one this version reads`);
+  const decoder = new TextDecoder("utf-8", { fatal: true });
+  let at = 4;
+  const need = (count) => {
+    if (at + count > bytes.length) throw new SectorError("the sector's bytes end before its last cell");
+  };
+  const read8 = () => {
+    need(1);
+    return bytes[at++];
+  };
+  const read16 = () => {
+    need(2);
+    const value = bytes[at] | bytes[at + 1] << 8;
+    at += 2;
+    return value;
+  };
+  const cells = [];
+  for (let index = 0; index < SECTOR_CELLS; index += 1) {
+    const flags = read8();
+    if ((flags & PRESENT) === 0) {
+      cells.push(void 0);
+      continue;
     }
-    const name = assetName(value, `frame ${key}`);
-    frames.set(key, name);
-    names.add(name);
+    const count = read8();
+    const layers = [];
+    for (let layer = 0; layer < count; layer += 1) layers.push(read16());
+    const blocking = read16();
+    const zone = read16();
+    const audioZone = (flags & AUDIO) === 0 ? void 0 : read16();
+    const interact = (flags & INTERACT) === 0 ? void 0 : read16();
+    let extra;
+    if ((flags & EXTRA) !== 0) {
+      const length = read16();
+      need(length);
+      let parsed2;
+      try {
+        parsed2 = JSON.parse(decoder.decode(bytes.subarray(at, at + length)));
+      } catch {
+        throw new SectorError("a tile's extra fields are not JSON");
+      }
+      if (typeof parsed2 !== "object" || parsed2 === null || Array.isArray(parsed2)) throw new SectorError("a tile's extra fields are not an object");
+      const named = Object.keys(parsed2).find((key) => NAMED$1.has(key));
+      if (named !== void 0) throw new SectorError(`a tile's extra fields name ${named}, which the sector holds itself`);
+      extra = parsed2;
+      at += length;
+    }
+    cells.push({
+      layers,
+      blocking,
+      zone,
+      ...audioZone === void 0 ? {} : { audioZone },
+      ...interact === void 0 ? {} : { interact },
+      ...extra === void 0 ? {} : { extra }
+    });
   }
+  if (at !== bytes.length) throw new SectorError("the sector's bytes go on past its last cell");
+  return cells;
+}
+const NAMED = /* @__PURE__ */ new Set(["x", "y", "z", "layers", "blocking", "zone", "audioZone", "interact"]);
+function cellOfTile(tile) {
+  const extra = Object.fromEntries(Object.entries(tile).filter(([key]) => !NAMED.has(key)));
   return {
-    nameForLooktype: (looktype) => looktypes.get(looktype) ?? null,
-    nameForFrame: (packId, frameId) => frames.get(`${packId}:${frameId}`) ?? null,
-    names,
-    looktypeCount: looktypes.size,
-    frameCount: frames.size
+    layers: tile.layers,
+    blocking: tile.blocking,
+    zone: tile.zone,
+    ...tile.audioZone === void 0 ? {} : { audioZone: tile.audioZone },
+    ...tile.interact === void 0 ? {} : { interact: tile.interact },
+    ...Object.keys(extra).length === 0 ? {} : { extra }
   };
 }
-function checkNamesAgainstIndex(map, index, declared = /* @__PURE__ */ new Set()) {
-  const absent = [...map.names].filter((name) => !index.assets.has(name) && !declared.has(name)).sort();
-  if (absent.length > 0) {
-    throw new IdMapError(`the id map names assets the index does not hold: ${absent.join(", ")}`);
-  }
-}
-function asObject(value, what) {
-  if (value === null || typeof value !== "object" || Array.isArray(value)) {
-    throw new IdMapError(`${what} must be a JSON object`);
-  }
-  return value;
-}
-function section(record, name) {
-  const value = record[name];
-  return value === void 0 ? {} : asObject(value, `${name}`);
-}
-function assetName(value, what) {
-  if (typeof value !== "string" || value.trim() === "") {
-    throw new IdMapError(`${what}: the asset name must be a non-empty string`);
-  }
-  return value;
-}
-const EAC_MAGIC = 826491205;
-const EAC_VERSION = 1;
-const INDEX_ENTRY = "assets.eai";
-const ID_MAP_ENTRY = "id-map.json";
-const HEADER_SIZE = 32;
-const FLAG_MASKED = 1;
-const MASK_KEY = Uint8Array.from([69, 116, 101, 114, 110, 105, 116, 121, 77, 69, 45, 115, 101, 97, 108, 33]);
-class ContainerError extends Error {
+function tileOfCell(cell, x, y, z) {
+  return {
+    ...cell.extra ?? {},
+    x,
+    y,
+    z,
+    layers: [...cell.layers],
+    blocking: cell.blocking,
+    zone: cell.zone,
+    ...cell.audioZone === void 0 ? {} : { audioZone: cell.audioZone },
+    ...cell.interact === void 0 ? {} : { interact: cell.interact }
+  };
+}
+const MIRROR_MAP_DIRECTORY = "map";
+const MIRROR_INDEX_FILE = `${MIRROR_MAP_DIRECTORY}/index.json`;
+const MIRROR_FORMAT = 1;
+class MirrorError extends Error {
   // Assigned in the body: Node's strip-only TypeScript mode rejects parameter
   // properties (docs/notes.md n-0023).
   constructor(message) {
     super(message);
-    this.name = "ContainerError";
+    this.name = "MirrorError";
   }
 }
-function maskByte(value, offset) {
-  const key = MASK_KEY[offset % MASK_KEY.length];
-  const drift = Math.imul(offset, 31) + (offset >>> 5) & 255;
-  return (value ^ key ^ drift) & 255;
+function mirrorSectorPath(z, cx, cy) {
+  if (!isPlace(z, cx, cy)) throw new MirrorError(`no sector of a map is at level ${z}, column ${cx}, row ${cy}`);
+  return `${MIRROR_MAP_DIRECTORY}/${z}/${cx}-${cy}.bin`;
 }
-function maskInto(target, start, source) {
-  for (let index = 0; index < source.length; index += 1) {
-    target[start + index] = maskByte(source[index], start + index);
-  }
+function isPlace(z, cx, cy) {
+  const within = (value, last) => Number.isInteger(value) && value >= 0 && value <= last;
+  return within(z, MAP_LEVELS.last) && z >= MAP_LEVELS.first && within(cx, OUTLINE_ACROSS - 1) && within(cy, OUTLINE_ACROSS - 1);
 }
-function sealContainer(entries) {
+function isSize(value) {
+  const side = (n) => Number.isInteger(n) && n >= 1 && n <= LARGEST_MAP_SIDE;
+  return typeof value === "object" && value !== null && side(value.width) && side(value.height);
+}
+function mirrorIndexText(index) {
+  return `${JSON.stringify(index, null, 2)}
+`;
+}
+function parseMirrorIndex(text2) {
+  let value;
+  try {
+    value = JSON.parse(text2);
+  } catch {
+    throw new MirrorError(`${MIRROR_INDEX_FILE} is not JSON`);
+  }
+  const index = value;
+  if (typeof index !== "object" || index === null) throw new MirrorError(`${MIRROR_INDEX_FILE} is not an object`);
+  if (index.format !== MIRROR_FORMAT)
+    throw new MirrorError(`${MIRROR_INDEX_FILE} is in format ${String(index.format)}, and this reads format ${MIRROR_FORMAT}`);
+  if (!Number.isInteger(index.revision) || index.revision < 0) throw new MirrorError(`${MIRROR_INDEX_FILE} names no revision`);
+  if (!isSize(index.size) || !isSize(index.limit)) throw new MirrorError(`${MIRROR_INDEX_FILE} names no size or limit a map may have`);
+  if (!Array.isArray(index.names) || !Array.isArray(index.sectors)) throw new MirrorError(`${MIRROR_INDEX_FILE} lists no levels or sectors`);
+  for (const named of index.names) {
+    if (typeof named?.name !== "string" || !isPlace(named.z, 0, 0)) throw new MirrorError(`${MIRROR_INDEX_FILE} names a level that is none`);
+  }
   const seen = /* @__PURE__ */ new Set();
-  for (const entry of entries) {
-    if (seen.has(entry.name)) throw new ContainerError(`duplicate entry name ${entry.name}`);
-    seen.add(entry.name);
+  for (const sector of index.sectors) {
+    const [z, cx, cy, version2] = Array.isArray(sector) ? sector : [];
+    if (!isPlace(z, cx, cy) || !Number.isInteger(version2) || version2 < 1) {
+      throw new MirrorError(`${MIRROR_INDEX_FILE} lists a sector that is none: ${JSON.stringify(sector)}`);
+    }
+    const key = `${z}:${cx}:${cy}`;
+    if (cx * SECTOR_SIDE$1 >= index.size.width || cy * SECTOR_SIDE$1 >= index.size.height) {
+      throw new MirrorError(`${MIRROR_INDEX_FILE} lists the sector ${key}, outside the map's size`);
+    }
+    if (seen.has(key)) throw new MirrorError(`${MIRROR_INDEX_FILE} lists the sector ${key} twice`);
+    seen.add(key);
   }
-  const encoder2 = new TextEncoder();
-  const ordered = [...entries].sort((left, right) => left.name < right.name ? -1 : left.name > right.name ? 1 : 0);
-  const names = ordered.map((entry) => encoder2.encode(entry.name));
-  const tocLength = names.reduce((total, name) => total + 2 + name.length + 8, 0);
-  const tocOffset = HEADER_SIZE;
-  const payloadOffset = tocOffset + tocLength;
-  const payloadLength = ordered.reduce((total, entry) => total + entry.bytes.length, 0);
-  const out = new Uint8Array(payloadOffset + payloadLength);
-  const view = new DataView(out.buffer);
-  view.setUint32(0, EAC_MAGIC, true);
-  view.setUint32(4, EAC_VERSION, true);
-  view.setUint32(8, ordered.length, true);
-  view.setUint32(12, tocOffset, true);
-  view.setUint32(16, tocLength, true);
-  view.setUint32(20, payloadOffset, true);
-  view.setUint32(24, FLAG_MASKED, true);
-  view.setUint32(28, 0, true);
-  const toc = new Uint8Array(tocLength);
-  const tocView = new DataView(toc.buffer);
-  let cursor = 0;
-  let entryOffset = payloadOffset;
-  ordered.forEach((entry, index) => {
-    const name = names[index];
-    tocView.setUint16(cursor, name.length, true);
-    cursor += 2;
-    toc.set(name, cursor);
-    cursor += name.length;
-    tocView.setUint32(cursor, entryOffset, true);
-    cursor += 4;
-    tocView.setUint32(cursor, entry.bytes.length, true);
-    cursor += 4;
-    maskInto(out, entryOffset, entry.bytes);
-    entryOffset += entry.bytes.length;
-  });
-  maskInto(out, tocOffset, toc);
-  return out;
-}
-function tileSpritePlacement(tx, ty, width, height, tileSize = TILE_SIZE) {
-  const overhangX = (width - tileSize) / 2;
-  const overhangY = (height - tileSize) / 2;
-  return { x: tx * tileSize - overhangX, y: ty * tileSize - overhangY };
+  return index;
 }
-function placeTileSprite(tx, ty, width, height, options = {}) {
-  const tileSize = options.tileSize ?? TILE_SIZE;
-  const scale = options.drawScale ?? 1;
-  const scaledWidth = width * scale;
-  const scaledHeight = height * scale;
-  const centred = tileSpritePlacement(tx, ty, scaledWidth, scaledHeight, tileSize);
-  return {
-    x: centred.x + (options.offset?.x ?? 0),
-    y: centred.y + (options.offset?.y ?? 0),
-    width: scaledWidth,
-    height: scaledHeight
-  };
+async function readMirroredMap(index, read, inflate2) {
+  const tiles = [];
+  for (const [z, cx, cy] of index.sectors) {
+    const path = mirrorSectorPath(z, cx, cy);
+    let cells;
+    try {
+      cells = decodeSector(await inflate2(await read(path)));
+    } catch (error) {
+      throw new MirrorError(`${path} is not a sector the map can read: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    for (const [at, cell] of cells.entries()) {
+      if (cell === void 0) continue;
+      const x = cx * SECTOR_SIDE$1 + at % SECTOR_SIDE$1;
+      const y = cy * SECTOR_SIDE$1 + Math.floor(at / SECTOR_SIDE$1);
+      if (x >= index.size.width || y >= index.size.height) continue;
+      tiles.push(tileOfCell(cell, x, y, z));
+    }
+  }
+  tiles.sort((a, b) => a.z - b.z || a.y - b.y || a.x - b.x);
+  return { width: index.size.width, height: index.size.height, tiles };
 }
-const WINDOW_PX = { width: 1536, height: 1024 };
-const SCALES = [TILE_SIZE, TILE_SIZE / 2, TILE_SIZE / 4, TILE_SIZE / 8, TILE_SIZE / 16];
-function scaleFor(tilesWide, tilesHigh) {
-  if (tilesWide <= 0 || tilesHigh <= 0) return null;
-  for (const scale of SCALES) {
-    if (tilesWide * scale <= WINDOW_PX.width && tilesHigh * scale <= WINDOW_PX.height) return scale;
+function sectorsOfMap(map) {
+  const sectors = /* @__PURE__ */ new Map();
+  for (const tile of map.tiles) {
+    const { x, y, z } = tile;
+    if (!Number.isInteger(x) || !Number.isInteger(y) || x < 0 || y < 0 || x >= LARGEST_MAP_SIDE || y >= LARGEST_MAP_SIDE || !isPlace(z, 0, 0)) {
+      throw new MirrorError(`the tile at (${x}, ${y}) on level ${z} is at no place a map has`);
+    }
+    const cx = Math.floor(x / SECTOR_SIDE$1);
+    const cy = Math.floor(y / SECTOR_SIDE$1);
+    const key = `${z}:${cx}:${cy}`;
+    let sector = sectors.get(key);
+    if (sector === void 0) {
+      sector = { z, cx, cy, cells: new Array(SECTOR_CELLS) };
+      sectors.set(key, sector);
+    }
+    sector.cells[y % SECTOR_SIDE$1 * SECTOR_SIDE$1 + x % SECTOR_SIDE$1] = cellOfTile(tile);
   }
-  return null;
+  return [...sectors.values()].sort((a, b) => a.z - b.z || a.cy - b.cy || a.cx - b.cx);
 }
-({
-  width: Math.floor(WINDOW_PX.width / SCALES.at(-1)),
-  height: Math.floor(WINDOW_PX.height / SCALES.at(-1))
-});
+const SIGNATURE$1 = [137, 80, 78, 71, 13, 10, 26, 10];
+function isPng(bytes) {
+  return bytes.length >= 24 && SIGNATURE$1.every((byte, index) => bytes[index] === byte);
+}
+function pngSize(bytes) {
+  if (!isPng(bytes)) throw new RangeError("those bytes are not a PNG");
+  const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+  return { width: view.getUint32(16), height: view.getUint32(20) };
+}
+const GROUND_KINDS = /* @__PURE__ */ new Set(["ground", "floor", "wall", "cliff", "interior", "grass-stone"]);
+function isGroundName(name) {
+  const { inner } = splitTileset(name);
+  const kind = inner.split("/")[1] ?? "";
+  return GROUND_KINDS.has(kind) || inner.includes("/wang-");
+}
+const MAX_ASSEMBLED_PX = 4096;
 const REACHED = Array.from({ length: 16 }, (_value, mask) => [0, 1, 2, 3].filter((corner) => (mask >> corner & 1) === 1));
 REACHED.map((reached) => [0, 1, 2, 3].find((corner) => !reached.includes(corner)));
 Array.from({ length: 16 }, (_value, index) => index);
@@ -2702,7 +2805,7 @@ function assetOf(id2, raw) {
   if (!Array.isArray(files) || files.length === 0 || !files.every((file) => typeof file === "string" && isPulledPath(file))) {
     throw new PulledError(`${PULLED_FILE}: the asset ${id2} names a file that is not a picture under out/ or ref/`);
   }
-  return { kind, name, hash, files };
+  return { kind: currentKind(kind), name, hash, files };
 }
 function guideOf(raw) {
   if (raw === void 0 || raw === null) return null;
@@ -2750,7 +2853,7 @@ async function readRecord(local) {
 async function writeRecord(local, record) {
   await artBoundary(local).writeFileReplacing(recordPath(local), writePulled(record));
 }
-const REFERENCE_KINDS = /* @__PURE__ */ new Set(["level-design", "hud-mockup"]);
+const REFERENCE_KINDS = /* @__PURE__ */ new Set([CONCEPT_ART, "hud-mockup"]);
 function setPieces(asset) {
   return setPiecesOf(asset.kind, asset.images.length, asset.data);
 }
@@ -2819,23 +2922,28 @@ const date = (at) => at.slice(0, 10);
 function listed(assets) {
   if (assets.length === 0) return "No assets.";
   return assets.map(
-    (asset) => `${asset.id}  ${asset.kind.padEnd(12)}  ${(asset.name ?? "—").padEnd(28)}  ${asset.images} image${asset.images === 1 ? "" : "s"}  ${date(asset.createdAt)}`
+    (asset) => `${asset.id}  ${asset.kind.padEnd(12)}  ${(asset.name ?? "—").padEnd(28)}  ${asset.images} image${asset.images === 1 ? "" : "s"}  ${date(asset.createdAt)}${asset.tags === void 0 || asset.tags.length === 0 ? "" : `  #${asset.tags.join(" #")}`}`
   ).join("\n");
 }
 const list = {
   name: "list",
-  summary: "List the platform project's assets, of one kind when given, newest first",
-  usage: "[<kind>] [--before <id>]",
-  options: { before: { type: "string", value: "<id>", description: "the page after the asset with this id, as the last page said" } },
+  summary: "List the platform project's assets, of one kind and carrying one tag when given, newest first",
+  usage: "[<kind>] [--tag <tag>] [--before <id>]",
+  options: {
+    tag: { type: "string", value: "<tag>", description: "only the concept art carrying this tag, such as anchor" },
+    before: { type: "string", value: "<id>", description: "the page after the asset with this id, as the last page said" }
+  },
   positionals: [0, 1],
   run: async (context, args) => {
     const local = await projectHere(context.io.cwd);
     const project = linkedOf(local);
     const platform = await signedIn(context);
     const [kind] = args.positionals;
-    const page = await platform.web.assets(project, kind ?? null, stringOf(args, "before") ?? null);
+    const given = stringOf(args, "tag");
+    const tag2 = given === void 0 ? null : tagOf(given);
+    const page = await platform.web.assets(project, kind ?? null, stringOf(args, "before") ?? null, tag2);
     const more = page.next === null ? "" : `
-More: pixel-vibing-cli list${kind === void 0 ? "" : ` ${kind}`} --before ${page.next}`;
+More: pixel-vibing-cli list${kind === void 0 ? "" : ` ${kind}`}${tag2 === null ? "" : ` --tag ${tag2}`} --before ${page.next}`;
     answer(context, page, `${listed(page.assets)}${more}`);
   }
 };
@@ -2856,6 +2964,39 @@ const pull = {
     answer(context, pulled, pulledWords(pulled));
   }
 };
+const tag = {
+  name: "tag",
+  summary: "Say what a concept art is for: set its tags, by its id or its name, or show them when none are given",
+  usage: "<id|name> [<tag>…] [--none]",
+  options: { none: { type: "boolean", description: "take every tag off it" } },
+  positionals: [1, 9],
+  run: async (context, args) => {
+    const local = await projectHere(context.io.cwd);
+    const project = linkedOf(local);
+    const [ref, ...typed] = args.positionals;
+    const none = flagOf(args, "none");
+    if (none && typed.length > 0) throw new CliError("--none takes every tag off: give tags or --none, not both");
+    const platform = await signedIn(context);
+    if (typed.length === 0 && !none) {
+      const asset = await platform.web.asset(project, ref);
+      if (asset.kind !== CONCEPT_ART) throw new CliError(`${ref} is ${asset.kind}: only concept art carries tags`);
+      const tags2 = asset.tags ?? [];
+      const offered = (await platform.web.tags(project)).map((each) => each.name);
+      answer(
+        context,
+        { id: asset.id, tags: tags2, offered },
+        `${tags2.length === 0 ? `${ref} carries no tag.` : `${ref}: #${tags2.join(" #")}`}
+The project's tags: ${offered.join(", ")}`
+      );
+      return;
+    }
+    const tags = typed.map(tagOf);
+    const problem = tagsProblem(tags);
+    if (problem !== null) throw new CliError(problem);
+    const set = await platform.web.tagAsset(project, ref, tags);
+    answer(context, set, set.tags.length === 0 ? `${ref} carries no tag now.` : `${ref}: #${set.tags.join(" #")}`);
+  }
+};
 const DOWNLOAD_URL = "https://github.com/Pixel-Vibing/pixel-vibing/releases/latest";
 const EDITOR_VARIABLE = "PIXELVIBING_EDITOR";
 async function exists$1(path) {
@@ -2920,9 +3061,6 @@ function drawLayerOf(band, foreground) {
   if (foreground) return "foreground";
   return band === "ground" ? "ground" : "object";
 }
-function blank(width, height) {
-  return { width, height, data: new Uint8ClampedArray(width * height * 4) };
-}
 const SOLID = /^terrain\/ground\/([a-z0-9]+)$/;
 const WANG = /^terrain\/([a-z0-9]+)-([a-z0-9]+)\/wang-(\d{2})$/;
 function terrainTable(names) {
@@ -3900,60 +4038,14 @@ function drawCanvas(footprint) {
   if (pxPerTile === void 0) return null;
   return { width: footprint.cols * pxPerTile, height: footprint.rows * pxPerTile, pxPerTile };
 }
-const CELLS_PER_TILE = 64;
-const MAX_CELL = 16;
-const MIN_CELL = 8;
-const ROUTE_MAX_EDGE = 3840;
-const ROUTE_MAX_PIXELS = 8294400;
-const ROUTE_MIN_PIXELS = 655360;
-const ROUTE_STEP = 16;
-function gridForCells(cols, rows, cellsPerTile = CELLS_PER_TILE) {
-  if (!Number.isInteger(cols) || !Number.isInteger(rows) || cols <= 0 || rows <= 0) return null;
-  const drawn = (cell) => cols * cell <= ROUTE_MAX_EDGE && rows * cell <= ROUTE_MAX_EDGE && cols * cell * rows * cell <= ROUTE_MAX_PIXELS && cols * cell % ROUTE_STEP === 0 && rows * cell % ROUTE_STEP === 0;
-  const unscaled = (cell) => cols * cell * rows * cell >= ROUTE_MIN_PIXELS;
-  const canvas = (cell) => ({ width: cols * cell, height: rows * cell, cell, pxPerTile: cellsPerTile * cell });
-  if (drawn(MAX_CELL) && unscaled(MAX_CELL)) return canvas(MAX_CELL);
-  if (drawn(MAX_CELL)) {
-    for (let cell = MAX_CELL + 1; cell * Math.max(cols, rows) <= ROUTE_MAX_EDGE; cell += 1) if (drawn(cell) && unscaled(cell)) return canvas(cell);
-    return null;
-  }
-  for (let cell = MAX_CELL - 1; cell >= MIN_CELL; cell -= 1) if (drawn(cell) && unscaled(cell)) return canvas(cell);
-  return null;
-}
-const LEAST_CELLS_PER_TILE = 16;
-function cellCounts(cellsPerTile) {
-  const counts = [cellsPerTile];
-  for (let cells = cellsPerTile / 2; Number.isInteger(cells) && cells >= LEAST_CELLS_PER_TILE; cells /= 2) counts.push(cells);
-  return counts;
-}
-function gridCanvas(footprint, cellsPerTile = CELLS_PER_TILE) {
-  for (const cells of cellCounts(cellsPerTile)) {
-    const canvas = gridForCells(footprint.cols * cells, footprint.rows * cells, cells);
-    if (canvas !== null) return canvas;
-  }
-  return null;
-}
-function gridProblem(footprint, cellsPerTile = CELLS_PER_TILE) {
-  if (gridCanvas(footprint, cellsPerTile) !== null) return null;
-  const least = cellCounts(cellsPerTile).at(-1);
-  const side = Math.floor(ROUTE_MAX_EDGE / (least * MIN_CELL));
-  const area = Math.floor(ROUTE_MAX_PIXELS / (least * MIN_CELL) ** 2);
-  return `a ${footprint.cols}×${footprint.rows} tile object is too large to draw on the grid: at most ${side} tile${side === 1 ? "" : "s"} on a side and ${area} tile${area === 1 ? "" : "s"} in all`;
-}
-function designCanvas(tiles) {
-  if (!Number.isInteger(tiles.cols) || !Number.isInteger(tiles.rows) || tiles.cols < 1 || tiles.rows < 1) return null;
-  const scale = scaleFor(tiles.cols, tiles.rows);
-  if (scale === null) return null;
-  return { cols: tiles.cols, rows: tiles.rows, scale, width: tiles.cols * scale, height: tiles.rows * scale };
-}
 const GENERATED = {
   object: { references: 8, words: "an object" },
   creature: { references: 3, words: "a creature" },
-  "level-design": { references: 3, words: "a level design" },
+  [CONCEPT_ART]: { references: 8, words: "a concept art" },
   icons: { references: 0, words: "an icon set" },
   "ui-sketch": { references: 3, words: "a UI" }
 };
-const KIND_NAMES = { ui: "ui-sketch" };
+const KIND_NAMES = { ui: "ui-sketch", [OLD_CONCEPT_ART]: CONCEPT_ART };
 function listOf(given, what) {
   const items = given.split(",").map((item) => item.trim());
   if (items.some((item) => item === "")) throw new CliError(`${what} is a comma-separated list with no empty entry`);
@@ -4018,6 +4110,41 @@ async function sketchOf(context, path, instruction) {
   };
 }
 const MAX_DESIGN_TILES = 64;
+function pixelsOf(given, what) {
+  const match = /^(\d{1,4})[x×](\d{1,4})$/i.exec(given.trim());
+  if (match === null) throw new CliError(`${what} is <width>x<height> in px, such as 1536x1024, not ${given}`);
+  return { width: Number(match[1]), height: Number(match[2]) };
+}
+function conceptFields(args, asked, instruction) {
+  const pixelArt = flagOf(args, "pixel-art") || asked === OLD_CONCEPT_ART;
+  const transparent = flagOf(args, "transparent");
+  const sizeGiven = stringOf(args, "size");
+  const tilesGiven = stringOf(args, "tiles");
+  const size = sizeGiven === void 0 ? void 0 : pixelsOf(sizeGiven, "--size");
+  const tiles = tilesGiven === void 0 ? void 0 : sizeOf(tilesGiven, "--tiles");
+  if (tiles !== void 0 && (tiles.cols > MAX_DESIGN_TILES || tiles.rows > MAX_DESIGN_TILES))
+    throw new CliError(`a pixel-art concept art is 1 to ${MAX_DESIGN_TILES} tiles each way, not ${tiles.cols}×${tiles.rows}`);
+  const problem = conceptShapeProblem({
+    pixelArt,
+    ...size === void 0 ? {} : { size },
+    ...tiles === void 0 ? {} : { tiles },
+    ...transparent ? { background: "transparent" } : {}
+  });
+  if (problem !== null) throw new CliError(problem.replace("ask for pixel art too", "add --pixel-art"));
+  const tags = stringsOf(args, "tag").map(tagOf);
+  const tagged = tagsProblem(tags);
+  if (tagged !== null) throw new CliError(tagged);
+  const fields = {
+    ...pixelArt ? { pixelArt: true, tiles: tiles ?? DEFAULT_CONCEPT_TILES } : {},
+    ...size === void 0 ? {} : { size },
+    ...transparent ? { background: "transparent" } : {},
+    ...tags.length === 0 ? {} : { tags }
+  };
+  const drawn = tiles ?? DEFAULT_CONCEPT_TILES;
+  const shown2 = size ?? DEFAULT_CONCEPT_SIZE;
+  const what = pixelArt ? `a concept art ${drawn.cols}×${drawn.rows} tiles across, as pixel art` : `a concept art ${shown2.width}×${shown2.height} px${transparent ? ", its background cut away" : ""}`;
+  return { fields, words: `${what}${tags.length === 0 ? "" : ` tagged ${tags.join(", ")}`}: ${instruction}` };
+}
 const MAX_REFERENCE_BYTES = 16 * 1024 * 1024;
 function sizeOf(given, what) {
   const match = /^(\d{1,3})[x×](\d{1,3})$/i.exec(given.trim());
@@ -4049,6 +4176,10 @@ async function requestOf(context, asked, args) {
   const paths = stringsOf(args, "reference");
   if (paths.length > known.references)
     throw new CliError(known.references === 0 ? `${known.words} takes no reference` : `${known.words} takes at most ${known.references} references`);
+  if (kind !== CONCEPT_ART) {
+    for (const flag of ["pixel-art", "transparent"]) if (flagOf(args, flag)) throw new CliError(`--${flag} is a concept art's`);
+    if (stringsOf(args, "tag").length > 0) throw new CliError("--tag is a concept art's");
+  }
   if (kind === "ui-sketch") {
     for (const flag of ["names", "purpose", "size", "tiles"])
       if (stringOf(args, flag) !== void 0) throw new CliError(`--${flag} is not a UI's: its shapes are in the --sketch file`);
@@ -4065,13 +4196,17 @@ async function requestOf(context, asked, args) {
   if (stringOf(args, "sketch") !== void 0) throw new CliError("--sketch is a UI's");
   if (set) {
     const { fields, words: words2 } = iconFields(args);
-    if (stringOf(args, "tiles") !== void 0) throw new CliError("--tiles is a level design's");
+    if (stringOf(args, "tiles") !== void 0) throw new CliError("--tiles is a pixel-art concept art's");
     const body2 = { ...fields, ...instruction === "" ? {} : { instruction } };
     return { kind, body: body2, words: instruction === "" ? words2 : `${words2}; ${instruction}` };
   }
   for (const flag of ["names", "purpose"]) if (stringOf(args, flag) !== void 0) throw new CliError(`--${flag} is an icon set's`);
   const references = [];
   for (const path of paths) references.push(await referenceOf(context, path));
+  if (kind === CONCEPT_ART) {
+    const { fields, words: words2 } = conceptFields(args, asked, instruction);
+    return { kind, body: { instruction, ...fields }, ...references.length > 0 ? { images: { references } } : {}, words: words2 };
+  }
   const body = { instruction };
   let words = `${known.words}: ${instruction}`;
   if (kind === "object") {
@@ -4080,15 +4215,8 @@ async function requestOf(context, asked, args) {
     if (problem !== null) throw new CliError(problem);
     body.footprint = footprint;
     words = `an object ${footprint.cols}×${footprint.rows} tiles: ${instruction}`;
-  } else if (stringOf(args, "size") !== void 0) throw new CliError("--size is an object's");
-  if (kind === "level-design") {
-    const tiles = sizeOf(stringOf(args, "tiles") ?? "6x4", "--tiles");
-    if (tiles.cols > MAX_DESIGN_TILES || tiles.rows > MAX_DESIGN_TILES || designCanvas(tiles) === null) {
-      throw new CliError(`a ${tiles.cols}×${tiles.rows} tile level design is not one that is drawn: 1 to ${MAX_DESIGN_TILES} tiles each way`);
-    }
-    body.tiles = tiles;
-    words = `a level design ${tiles.cols}×${tiles.rows} tiles across: ${instruction}`;
-  } else if (stringOf(args, "tiles") !== void 0) throw new CliError("--tiles is a level design's");
+  } else if (stringOf(args, "size") !== void 0) throw new CliError("--size is an object's or a concept art's");
+  if (stringOf(args, "tiles") !== void 0) throw new CliError("--tiles is a pixel-art concept art's");
   return { kind, body, ...references.length > 0 ? { images: { references } } : {}, words };
 }
 async function confirmed(context, platform, what, prices, kind, yes) {
@@ -4118,8 +4246,8 @@ async function followed(context, platform, jobId) {
 }
 const generate = {
   name: "generate",
-  summary: "Generate an object, a creature, a level design, icons or a UI on the platform, then pull it",
-  usage: "<object|creature|level-design|icons|ui> [--instruction <text>] [--size <c>x<r>|<px>] [--tiles <c>x<r>] [--names <list>] [--purpose skill|item] [--sketch <json>] [--reference <png>]… [--yes]",
+  summary: "Generate an object, a creature, concept art, icons or a UI on the platform, then pull it",
+  usage: "<object|creature|concept-art|icons|ui> [--instruction <text>] [--size <c>x<r>|<w>x<h>|<px>] [--transparent] [--pixel-art] [--tiles <c>x<r>] [--tag <tag>]… [--names <list>] [--purpose skill|item] [--sketch <json>] [--reference <png>]… [--yes]",
   options: {
     instruction: {
       type: "string",
@@ -4129,11 +4257,19 @@ const generate = {
     size: {
       type: "string",
       value: "<cols>x<rows>|<px>",
-      description: "an object's footprint in tiles, 1x1 unless given; an icon's size, 16, 32 or 64 px, 32 unless given"
+      description: "an object's footprint in tiles, 1x1 unless given; a concept art's size in px, multiples of 16 within 1536x1024 or 1024x1536, 1536x1024 unless given; an icon's size, 16, 32 or 64 px, 32 unless given"
+    },
+    transparent: { type: "boolean", description: "cut a concept art's background away, for one thing alone" },
+    "pixel-art": { type: "boolean", description: "draw a concept art as pixel art some --tiles across, a level design to take apart" },
+    tag: {
+      type: "string",
+      multiple: true,
+      value: "<tag>",
+      description: "what a concept art is for, such as anchor, ui, character, environment, prop or level-design; at most 8"
     },
     names: { type: "string", value: "<list>", description: `an icon set's icons, comma-separated, at most ${MAX_ICONS}` },
     purpose: { type: "string", value: "skill|item", description: "whether an icon set is skills on badges or items alone; item unless given" },
-    tiles: { type: "string", value: "<cols>x<rows>", description: "how many tiles a level design is across, 6x4 unless given" },
+    tiles: { type: "string", value: "<cols>x<rows>", description: "how many tiles a pixel-art concept art is across, 6x4 unless given" },
     sketch: {
       type: "string",
       value: "<json>",
@@ -4616,7 +4752,7 @@ const move = {
     );
   }
 };
-const version = "0.46.0";
+const version = "0.49.0";
 const manifest = {
   version
 };
@@ -5098,6 +5234,7 @@ const COMMANDS = [
   generate,
   list,
   pull,
+  tag,
   seal,
   exportCommand,
   editor,