@tileflow/dev 0.1.0-alpha.30 → 0.1.0-alpha.31

package/dist/{chunk-A2VTI43Y.js → chunk-IR22ZTQW.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-7C4F6GAX.js";
 
 // src/icons.ts
-import { readdir as readdir2, readFile, realpath as realpath3, stat } from "fs/promises";
+import { readdir as readdir3, readFile as readFile2, realpath as realpath3, stat } from "fs/promises";
 import { extname, isAbsolute as isAbsolute2, relative as relative2, resolve as resolvePath, sep as sep2 } from "path";
 import { SaxesParser } from "saxes";
 import {
@@ -849,7 +849,7 @@ async function composeTileflowIconSources(input, options) {
       source: winner.source
     }))
   };
-  function addWinner(ordinal, icon, identity, source) {
+  function addWinner(ordinal, icon, identity2, source) {
     pixelBytes += icon.oneX.rgba.byteLength + icon.twoX.rgba.byteLength;
     const maximumPixelBytes = (tileflowIconPackageLimits3.maxAtlasDimension ** 2 + (tileflowIconPackageLimits3.maxAtlasDimension / 2) ** 2) * 4;
     if (winners.size >= tileflowIconPackageLimits3.maxIconCount || pixelBytes > maximumPixelBytes)
@@ -857,7 +857,7 @@ async function composeTileflowIconSources(input, options) {
         "ICON_COMPOSITION_INVALID",
         "Composed rendered cells exceed the final sprite capacity"
       );
-    winners.set(icon.id, { ordinal, icon, identity, source });
+    winners.set(icon.id, { ordinal, icon, identity: identity2, source });
   }
 }
 function isPathInside(root, candidate) {
@@ -939,6 +939,559 @@ function transform(grid, width, height) {
   }
 }
 
+// src/tree-models.ts
+import { createHash } from "crypto";
+import { lstat as lstat3, readdir as readdir2, readFile } from "fs/promises";
+import { join as join3 } from "path";
+import {
+  encodeTileflowTreeModel,
+  tileflowTreeModelLimits as tileflowTreeModelLimits2
+} from "@tileflow/core";
+
+// src/gltf-reader.ts
+var TileflowGltfError = class extends Error {
+  name = "TileflowGltfError";
+};
+var glbMagic = 1179937895;
+var jsonChunk = 1313821514;
+var binChunk = 5130562;
+var triangles = 4;
+var compressions = /* @__PURE__ */ new Set([
+  "KHR_draco_mesh_compression",
+  "EXT_meshopt_compression",
+  "KHR_meshopt_compression",
+  "KHR_mesh_quantization"
+]);
+var componentBytes = {
+  5120: 1,
+  5121: 1,
+  5122: 2,
+  5123: 2,
+  5125: 4,
+  5126: 4
+};
+var typeSizes = { SCALAR: 1, VEC2: 2, VEC3: 3, VEC4: 4 };
+function readTileflowGltfTriangles(bytes) {
+  const { json, bin } = chunks(bytes);
+  const required = array(json.extensionsRequired).filter((name) => typeof name === "string");
+  const compressed = required.find((name) => compressions.has(name));
+  if (compressed)
+    throw new TileflowGltfError(
+      `uses compressed geometry (${String(compressed)}); export it without compression`
+    );
+  for (const buffer of array(json.buffers))
+    if (record(buffer).uri !== void 0)
+      throw new TileflowGltfError("keeps its geometry in another file; export a single .glb");
+  const nodes = array(json.nodes).map(record);
+  const scenes = array(json.scenes).map(record);
+  const scene = scenes[typeof json.scene === "number" ? json.scene : 0];
+  const roots = scene ? array(scene.nodes) : nodes.map((_, index) => index).filter((index) => !nodes.some((node) => array(node.children).includes(index)));
+  const out = [];
+  const visit = (index, parent, depth) => {
+    if (typeof index !== "number" || !nodes[index])
+      throw new TileflowGltfError("names a node it does not hold");
+    if (depth > 64) throw new TileflowGltfError("nests its nodes more than 64 deep");
+    const node = nodes[index];
+    const world = multiply(parent, local(node));
+    if (typeof node.mesh === "number") out.push(...meshOf(json, bin, node.mesh, world));
+    for (const child of array(node.children)) visit(child, world, depth + 1);
+  };
+  for (const root of roots) visit(root, identity(), 0);
+  if (out.length === 0) throw new TileflowGltfError("holds no triangles in its scene");
+  return out;
+}
+function chunks(bytes) {
+  const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+  if (bytes.byteLength < 20 || view.getUint32(0, true) !== glbMagic)
+    throw new TileflowGltfError("is not a glTF binary; export the model as .glb");
+  if (view.getUint32(4, true) !== 2) throw new TileflowGltfError("is not glTF 2.0");
+  if (view.getUint32(8, true) !== bytes.byteLength)
+    throw new TileflowGltfError("is cut short or has trailing bytes");
+  let at = 12;
+  let json;
+  let bin;
+  while (at + 8 <= bytes.byteLength) {
+    const length = view.getUint32(at, true);
+    const type = view.getUint32(at + 4, true);
+    const start = at + 8;
+    if (start + length > bytes.byteLength) throw new TileflowGltfError("has a chunk past its end");
+    const body = bytes.subarray(start, start + length);
+    if (type === jsonChunk && json === void 0) {
+      try {
+        json = record(JSON.parse(new TextDecoder().decode(body)));
+      } catch {
+        throw new TileflowGltfError("has an unreadable JSON chunk");
+      }
+    } else if (type === binChunk && bin === void 0) bin = body;
+    at = start + length + (4 - length % 4) % 4;
+  }
+  if (!json) throw new TileflowGltfError("has no JSON chunk");
+  return { json, bin };
+}
+function meshOf(json, bin, index, world) {
+  const mesh = record(array(json.meshes)[index]);
+  const normalMatrix = inverseTranspose(world);
+  return array(mesh.primitives).map((value) => {
+    const primitive = record(value);
+    if ((primitive.mode ?? triangles) !== triangles)
+      throw new TileflowGltfError("draws points or lines; a tree model draws triangles");
+    const attributes = record(primitive.attributes);
+    if (typeof attributes.POSITION !== "number")
+      throw new TileflowGltfError("has a primitive without positions");
+    const raw = accessor(json, bin, attributes.POSITION, 3);
+    const count = raw.length / 3;
+    const positions = [];
+    for (let vertex = 0; vertex < count; vertex += 1) {
+      const [x, y, z] = transform2(
+        world,
+        raw[vertex * 3],
+        raw[vertex * 3 + 1],
+        raw[vertex * 3 + 2],
+        1
+      );
+      positions.push(x, -z, y);
+    }
+    let normals;
+    if (typeof attributes.NORMAL === "number") {
+      const rawNormals = accessor(json, bin, attributes.NORMAL, 3);
+      normals = [];
+      for (let vertex = 0; vertex < count; vertex += 1) {
+        const [x, y, z] = transform2(
+          normalMatrix,
+          rawNormals[vertex * 3],
+          rawNormals[vertex * 3 + 1],
+          rawNormals[vertex * 3 + 2],
+          0
+        );
+        const size = Math.hypot(x, y, z) || 1;
+        normals.push(x / size, -z / size, y / size);
+      }
+    }
+    const material = typeof primitive.material === "number" ? record(array(json.materials)[primitive.material]) : void 0;
+    const base = array(record(material?.pbrMetallicRoughness).baseColorFactor).map(Number);
+    const factor = base.length >= 3 && base.every(Number.isFinite) ? base : [1, 1, 1];
+    const colours = [];
+    const vertexColours = typeof attributes.COLOR_0 === "number" ? accessorWithSize(json, bin, attributes.COLOR_0) : void 0;
+    for (let vertex = 0; vertex < count; vertex += 1)
+      for (let channel = 0; channel < 3; channel += 1)
+        colours.push(
+          factor[channel] * (vertexColours ? vertexColours.values[vertex * vertexColours.size + channel] : 1)
+        );
+    const indices = typeof primitive.indices === "number" ? accessor(json, bin, primitive.indices, 1).map((value2) => Math.round(value2)) : Array.from({ length: count }, (_, vertex) => vertex);
+    if (indices.length % 3 !== 0 || indices.some((vertex) => vertex < 0 || vertex >= count))
+      throw new TileflowGltfError("has triangles that name missing vertices");
+    if (determinant(world) < 0)
+      for (let at = 0; at + 2 < indices.length; at += 3)
+        [indices[at + 1], indices[at + 2]] = [indices[at + 2], indices[at + 1]];
+    return {
+      material: typeof material?.name === "string" ? material.name : void 0,
+      positions,
+      normals,
+      colours,
+      indices
+    };
+  });
+}
+function accessor(json, bin, index, size) {
+  const read = accessorWithSize(json, bin, index);
+  if (read.size !== size)
+    throw new TileflowGltfError(`has an accessor of ${read.size} components where ${size} belong`);
+  return read.values;
+}
+function accessorWithSize(json, bin, index) {
+  const accessor2 = record(array(json.accessors)[index]);
+  if (accessor2.sparse !== void 0)
+    throw new TileflowGltfError("uses sparse accessors; export without them");
+  const size = typeSizes[String(accessor2.type)];
+  const component = Number(accessor2.componentType);
+  const bytesEach = componentBytes[component];
+  const count = Number(accessor2.count);
+  if (!size || !bytesEach || !Number.isInteger(count) || count < 0 || count > 1e6)
+    throw new TileflowGltfError("has an accessor Tileflow cannot read");
+  if (typeof accessor2.bufferView !== "number")
+    return { values: new Array(count * size).fill(0), size };
+  const view = record(array(json.bufferViews)[accessor2.bufferView]);
+  if (!bin || Number(view.buffer ?? 0) !== 0)
+    throw new TileflowGltfError("has geometry outside its binary chunk");
+  const stride = Number(view.byteStride ?? 0) || size * bytesEach;
+  const start = Number(view.byteOffset ?? 0) + Number(accessor2.byteOffset ?? 0);
+  const end = start + (count - 1) * stride + size * bytesEach;
+  if (count > 0 && (start < 0 || end > Number(view.byteOffset ?? 0) + Number(view.byteLength) || end > bin.byteLength))
+    throw new TileflowGltfError("has an accessor past the end of its buffer");
+  const data = new DataView(bin.buffer, bin.byteOffset, bin.byteLength);
+  const normalized = accessor2.normalized === true;
+  const values = [];
+  for (let item = 0; item < count; item += 1)
+    for (let part = 0; part < size; part += 1) {
+      const at = start + item * stride + part * bytesEach;
+      let value;
+      switch (component) {
+        case 5126:
+          value = data.getFloat32(at, true);
+          break;
+        case 5125:
+          value = data.getUint32(at, true);
+          break;
+        case 5123:
+          value = data.getUint16(at, true);
+          if (normalized) value /= 65535;
+          break;
+        case 5122:
+          value = data.getInt16(at, true);
+          if (normalized) value = Math.max(value / 32767, -1);
+          break;
+        case 5121:
+          value = data.getUint8(at);
+          if (normalized) value /= 255;
+          break;
+        default:
+          value = data.getInt8(at);
+          if (normalized) value = Math.max(value / 127, -1);
+      }
+      if (!Number.isFinite(value)) throw new TileflowGltfError("has a value that is not a number");
+      values.push(value);
+    }
+  return { values, size };
+}
+function identity() {
+  return [1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1];
+}
+function local(node) {
+  const matrix = array(node.matrix).map(Number);
+  if (matrix.length === 16 && matrix.every(Number.isFinite)) return matrix;
+  const [tx, ty, tz] = vector(node.translation, [0, 0, 0]);
+  const [qx, qy, qz, qw] = vector(node.rotation, [0, 0, 0, 1]);
+  const [sx, sy, sz] = vector(node.scale, [1, 1, 1]);
+  const [xx, yy, zz] = [qx * qx, qy * qy, qz * qz];
+  const [xy, xz, yz, wx, wy, wz] = [qx * qy, qx * qz, qy * qz, qw * qx, qw * qy, qw * qz];
+  return [
+    (1 - 2 * (yy + zz)) * sx,
+    2 * (xy + wz) * sx,
+    2 * (xz - wy) * sx,
+    0,
+    2 * (xy - wz) * sy,
+    (1 - 2 * (xx + zz)) * sy,
+    2 * (yz + wx) * sy,
+    0,
+    2 * (xz + wy) * sz,
+    2 * (yz - wx) * sz,
+    (1 - 2 * (xx + yy)) * sz,
+    0,
+    tx,
+    ty,
+    tz,
+    1
+  ];
+}
+function multiply(a, b) {
+  const out = new Array(16).fill(0);
+  for (let column = 0; column < 4; column += 1)
+    for (let row = 0; row < 4; row += 1)
+      for (let k = 0; k < 4; k += 1) out[column * 4 + row] += a[k * 4 + row] * b[column * 4 + k];
+  return out;
+}
+function transform2(m, x, y, z, w) {
+  return [
+    m[0] * x + m[4] * y + m[8] * z + m[12] * w,
+    m[1] * x + m[5] * y + m[9] * z + m[13] * w,
+    m[2] * x + m[6] * y + m[10] * z + m[14] * w
+  ];
+}
+function determinant(m) {
+  return m[0] * (m[5] * m[10] - m[9] * m[6]) - m[4] * (m[1] * m[10] - m[9] * m[2]) + m[8] * (m[1] * m[6] - m[5] * m[2]);
+}
+function inverseTranspose(m) {
+  const [a, b, c, d, e, f, g, h, i] = [
+    m[0],
+    m[1],
+    m[2],
+    m[4],
+    m[5],
+    m[6],
+    m[8],
+    m[9],
+    m[10]
+  ];
+  const det = determinant(m) || 1;
+  return [
+    (e * i - h * f) / det,
+    (g * f - d * i) / det,
+    (d * h - g * e) / det,
+    0,
+    (h * c - b * i) / det,
+    (a * i - g * c) / det,
+    (g * b - a * h) / det,
+    0,
+    (b * f - e * c) / det,
+    (d * c - a * f) / det,
+    (a * e - d * b) / det,
+    0,
+    0,
+    0,
+    0,
+    1
+  ];
+}
+function record(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value) ? value : {};
+}
+function array(value) {
+  return Array.isArray(value) ? value : [];
+}
+function vector(value, fallback) {
+  const list = array(value).map(Number);
+  return list.length === fallback.length && list.every(Number.isFinite) ? list : fallback;
+}
+
+// src/tree-model-mesh.ts
+import {
+  tileflowTreeModelLimits,
+  tileflowTreeParts
+} from "@tileflow/core";
+var tileflowTreeModelPartNames = ["bark", "leaves", "fronds", "stem"];
+function prepareTileflowTreeModelMesh(bytes, level) {
+  const primitives = readTileflowGltfTriangles(bytes);
+  const positions = [];
+  const normals = [];
+  const parts = [];
+  const luminance = [];
+  const indices = [];
+  for (const primitive of primitives) {
+    const part = partOf(primitive.material);
+    const offset = positions.length / 3;
+    const count2 = primitive.positions.length / 3;
+    positions.push(...primitive.positions);
+    for (let vertex = 0; vertex < count2; vertex += 1) {
+      parts.push(part);
+      normals.push(primitive.normals?.slice(vertex * 3, vertex * 3 + 3));
+      const [r, g, b] = primitive.colours.slice(vertex * 3, vertex * 3 + 3);
+      luminance.push(0.2126 * r + 0.7152 * g + 0.0722 * b);
+    }
+    for (const index of primitive.indices) indices.push(offset + index);
+  }
+  const count = positions.length / 3;
+  const triangleCount = indices.length / 3;
+  const limit = level === "near" ? tileflowTreeModelLimits.nearTriangles : tileflowTreeModelLimits.farTriangles;
+  if (triangleCount > limit)
+    throw new TileflowGltfError(
+      `has ${triangleCount.toLocaleString("en")} triangles; a ${level} tree model takes at most ${limit.toLocaleString("en")}. Simplify it (for example with Blender's Decimate modifier) and export it again`
+    );
+  if (count > tileflowTreeModelLimits.vertices)
+    throw new TileflowGltfError(
+      `has ${count.toLocaleString("en")} vertices; a tree model takes at most ${tileflowTreeModelLimits.vertices.toLocaleString("en")}. Merge vertices by distance and export it again`
+    );
+  let height = 0;
+  let reach = 0;
+  const crowned = parts.some((part) => isCrown(part));
+  for (let vertex = 0; vertex < count; vertex += 1) {
+    height = Math.max(height, positions[vertex * 3 + 2]);
+    if (!crowned || isCrown(parts[vertex]))
+      reach = Math.max(reach, Math.hypot(positions[vertex * 3], positions[vertex * 3 + 1]));
+  }
+  if (!(height > 0))
+    throw new TileflowGltfError(
+      "stands below its origin; put the origin where the trunk meets the ground, with the tree above it"
+    );
+  if (!(reach > 0)) throw new TileflowGltfError("has no width round its origin");
+  const across = 2 * reach;
+  const unit = [];
+  for (let vertex = 0; vertex < count; vertex += 1)
+    unit.push(
+      positions[vertex * 3] / across,
+      positions[vertex * 3 + 1] / across,
+      positions[vertex * 3 + 2] / height
+    );
+  const faceSums = new Array(count * 3).fill(0);
+  for (let at = 0; at + 2 < indices.length; at += 3) {
+    const [a, b, c] = [indices[at], indices[at + 1], indices[at + 2]];
+    const n = cross(sub(point(unit, b), point(unit, a)), sub(point(unit, c), point(unit, a)));
+    for (const vertex of [a, b, c])
+      for (let axis = 0; axis < 3; axis += 1) faceSums[vertex * 3 + axis] += n[axis];
+  }
+  const outNormals = [];
+  for (let vertex = 0; vertex < count; vertex += 1) {
+    const own = normals[vertex];
+    const n = own ? [own[0] * across, own[1] * across, own[2] * height] : faceSums.slice(vertex * 3, vertex * 3 + 3);
+    const size = Math.hypot(n[0], n[1], n[2]) || 1;
+    outNormals.push(n[0] / size, n[1] / size, n[2] / size);
+  }
+  const shades = new Array(count).fill(0);
+  for (const part of new Set(parts)) {
+    const members = parts.flatMap((value, vertex) => value === part ? [vertex] : []);
+    const mean = members.reduce((sum, vertex) => sum + luminance[vertex], 0) / members.length;
+    const spread = Math.max(0.06, mean * 0.6);
+    for (const vertex of members)
+      shades[vertex] = clamp((luminance[vertex] - mean) / spread, -1, 1);
+  }
+  let crownLow = 1;
+  let crownHigh = 0;
+  for (let vertex = 0; vertex < count; vertex += 1)
+    if (isCrown(parts[vertex])) {
+      crownLow = Math.min(crownLow, unit[vertex * 3 + 2]);
+      crownHigh = Math.max(crownHigh, unit[vertex * 3 + 2]);
+    }
+  const occlusion = [];
+  for (let vertex = 0; vertex < count; vertex += 1) {
+    const z = unit[vertex * 3 + 2];
+    if (!isCrown(parts[vertex])) {
+      occlusion.push(z > crownLow ? 0.55 : 0.8);
+      continue;
+    }
+    const up = crownHigh > crownLow ? (z - crownLow) / (crownHigh - crownLow) : 1;
+    const out = Math.min(1, Math.hypot(unit[vertex * 3], unit[vertex * 3 + 1]) / 0.5);
+    occlusion.push(clamp(0.4 + 0.35 * up + 0.3 * out, 0.35, 1));
+  }
+  return {
+    // The author's proportions: the trees it stands keep them around the sizes the data gives.
+    proportion: Math.min(3, Math.max(0.1, across / height)),
+    positions: unit,
+    normals: outNormals,
+    parts,
+    shades,
+    occlusion,
+    indices
+  };
+}
+function partOf(material) {
+  const name = material?.trim().toLowerCase().replace(/\.\d+$/u, "");
+  const part = tileflowTreeModelPartNames.find((candidate) => candidate === name);
+  if (part) return tileflowTreeParts[part];
+  throw new TileflowGltfError(
+    material === void 0 ? "has a mesh without a material; name each material bark, leaves, fronds or stem" : `has a material "${material}" that names no part of a tree; name each material bark, leaves, fronds or stem`
+  );
+}
+function isCrown(part) {
+  return part === tileflowTreeParts.leaves || part === tileflowTreeParts.fronds;
+}
+function point(list, vertex) {
+  return [list[vertex * 3], list[vertex * 3 + 1], list[vertex * 3 + 2]];
+}
+function sub(a, b) {
+  return [a[0] - b[0], a[1] - b[1], a[2] - b[2]];
+}
+function cross(a, b) {
+  return [
+    a[1] * b[2] - a[2] * b[1],
+    a[2] * b[0] - a[0] * b[2],
+    a[0] * b[1] - a[1] * b[0]
+  ];
+}
+function clamp(value, low, high) {
+  return Math.min(high, Math.max(low, value));
+}
+
+// src/tree-models.ts
+var TileflowTreeModelError = class extends Error {
+  code = "TREE_MODEL_INVALID";
+  issues;
+  phase = "tree-model-preparation";
+  constructor(issues) {
+    super(
+      [
+        "Invalid Tileflow tree models",
+        ...issues.map((issue) => `- ${issue.path}: ${issue.message}`)
+      ].join("\n")
+    );
+    this.name = "TileflowTreeModelError";
+    this.issues = issues;
+  }
+};
+var fileLimit = 8 * 1024 * 1024;
+var modelId = /^[a-z0-9]+(?:-[a-z0-9]+)*$/u;
+async function prepareTileflowMapTreeModels(directories, options) {
+  const resolved = await resolveTileflowAssetDirectories(directories, {
+    baseDirectory: options.baseDirectory,
+    configPath: options.configPath,
+    cwd: options.cwd,
+    kind: "models",
+    target: options.target
+  });
+  const issues = [];
+  const files = /* @__PURE__ */ new Map();
+  for (const directory of resolved) {
+    let names;
+    try {
+      names = (await readdir2(directory.realPath)).sort();
+    } catch {
+      issues.push({ message: "is not a readable directory", path: directory.configPath });
+      continue;
+    }
+    for (const name of names) {
+      const display = `${directory.configPath}/${name}`;
+      const lower = name.toLowerCase();
+      if (lower.endsWith(".gltf")) {
+        issues.push({
+          message: "is a text glTF; export the model as a glTF binary (.glb)",
+          path: display
+        });
+        continue;
+      }
+      if (!lower.endsWith(".glb")) continue;
+      const far = name.endsWith(".far.glb");
+      const id = name.slice(0, name.length - (far ? 8 : 4));
+      if (!modelId.test(id) || id.length > 64) {
+        issues.push({
+          message: "a model's file name is its id: lowercase letters, digits and hyphens, up to 64, such as royal-palm.glb",
+          path: display
+        });
+        continue;
+      }
+      const path = join3(directory.realPath, name);
+      const info = await lstat3(path).catch(() => void 0);
+      if (!info?.isFile()) {
+        issues.push({ message: "is not a regular file", path: display });
+        continue;
+      }
+      if (info.size > fileLimit) {
+        issues.push({ message: "is larger than 8 MiB", path: display });
+        continue;
+      }
+      const entry = files.get(id) ?? {};
+      entry[far ? "far" : "near"] = { path, display };
+      files.set(id, entry);
+    }
+  }
+  const models = {};
+  const identities = [];
+  for (const [id, entry] of [...files].sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0)) {
+    if (!entry.near) {
+      issues.push({ message: `has no ${id}.glb beside it`, path: entry.far.display });
+      continue;
+    }
+    const prepared = {};
+    for (const level of ["near", "far"]) {
+      const file = entry[level];
+      if (!file) continue;
+      try {
+        const bytes = new Uint8Array(await readFile(file.path));
+        prepared[level] = encodeTileflowTreeModel(
+          prepareTileflowTreeModelMesh(bytes, level),
+          level
+        );
+        identities.push({ id, level, sha256: createHash("sha256").update(bytes).digest("hex") });
+      } catch (error) {
+        issues.push({
+          message: error instanceof TileflowGltfError || error instanceof RangeError ? error.message : "cannot be read",
+          path: file.display
+        });
+      }
+    }
+    if (prepared.near)
+      models[id] = { near: prepared.near, ...prepared.far ? { far: prepared.far } : {} };
+  }
+  if (Object.keys(models).length > tileflowTreeModelLimits2.models)
+    issues.push({
+      message: `holds ${Object.keys(models).length} models; a map takes at most ${tileflowTreeModelLimits2.models}`,
+      path: options.configPath
+    });
+  if (issues.length > 0) throw new TileflowTreeModelError(issues);
+  return {
+    models,
+    identities,
+    watchPaths: resolved.filter((directory) => directory.watch).map((directory) => directory.realPath)
+  };
+}
+
 // src/icon-preview.ts
 import { renderTileflowIconAtlasPixels } from "@tileflow/core";
 async function renderTileflowIconAtlasPreview(source, index) {
@@ -1210,6 +1763,20 @@ async function prepareTileflowCatalogIcons(project, options) {
       });
     }
   }
+  const mapModelSources = {};
+  const modelWatchPaths = [];
+  for (const [mapName, map] of Object.entries(project.maps)) {
+    if (!map.models?.length) continue;
+    const models = await prepareTileflowMapTreeModels(map.models, {
+      baseDirectory: options.baseDirectory ?? options.cwd,
+      configPath: `maps.${mapName}.models`,
+      cwd: options.cwd,
+      target: "local"
+    });
+    mapAssets[mapName] = { ...mapAssets[mapName], models: models.models };
+    mapModelSources[mapName] = models.identities;
+    modelWatchPaths.push(...models.watchPaths);
+  }
   return {
     assets,
     baseDirectory: await realpath3(options.baseDirectory ?? options.cwd),
@@ -1217,10 +1784,11 @@ async function prepareTileflowCatalogIcons(project, options) {
     mapAssets,
     mapIconCompositions,
     mapIconSources,
+    ...Object.keys(mapModelSources).length > 0 ? { mapModelSources } : {},
     project,
     sourceProject: project,
     watchFiles: compiled.watchFiles,
-    watchPaths: compiled.watchPaths
+    watchPaths: [...compiled.watchPaths, ...modelWatchPaths]
   };
 }
 async function getTileflowIconWatchPaths(project, cwd, baseDirectory = cwd) {
@@ -1312,7 +1880,7 @@ async function inspectIconSource(directory, target, issues) {
   let entries;
   const issueCount = issues.length;
   try {
-    entries = await readdir2(directory.realPath, { withFileTypes: true });
+    entries = await readdir3(directory.realPath, { withFileTypes: true });
   } catch (error) {
     issues.push({
       message: describeFileSystemError(error, "Icon source could not be read"),
@@ -1360,7 +1928,7 @@ async function inspectIconSource(directory, target, issues) {
           throw new Error("Icon metadata exceeds its byte limit");
         metadata = tileflowIconAuthorMetadataSchema.parse(
           parseTileflowIconJson2(
-            await readFile(realEntryPath, "utf8"),
+            await readFile2(realEntryPath, "utf8"),
             tileflowIconPackageLimits4.maxSourceFileBytes
           )
         );
@@ -1429,7 +1997,7 @@ async function inspectIconSource(directory, target, issues) {
   for (const candidate of candidates) {
     const displayPath = candidate.displayPath;
     try {
-      const source = await readFile(candidate.path);
+      const source = await readFile2(candidate.path);
       if (source.byteLength !== candidate.size || source.byteLength > tileflowIconPackageLimits4.maxSourceFileBytes) {
         throw new Error("Icon changed while it was being validated");
       }

package/dist/config.js

@@ -10,7 +10,7 @@ import {
   loadTileflowConfigWithInputs,
   loadValidTileflowConfig,
   loadValidTileflowConfigWithInputs
-} from "./chunk-6MGFMKG3.js";
+} from "./chunk-AQUGMUZW.js";
 import "./chunk-D4OE4ITL.js";
 export {
   TileflowValidationError,

package/dist/icons.d.ts

@@ -1,5 +1,5 @@
 import { TileflowIconAppearance, TileflowIconLayoutMetadata, TileflowIconSetPin, TileflowIconSpriteIndex, TileflowIconSource, TileflowIconsLockfileV1, TileflowIconCompositionV1, TileflowIconPackageFileName, TileflowIconPackageManifest, TileflowIconDirectory } from '@tileflow/core';
-import { TileflowEffectiveIconSourceIdentity, TileflowBuildCatalog, TileflowPreparedMapAssets } from '@tileflow/core/build';
+import { TileflowEffectiveIconSourceIdentity, TileflowBuildCatalog, TileflowPreparedMapAssets, TileflowEffectiveModelSourceIdentity } from '@tileflow/core/build';
 
 type TileflowRenderedIconCell = {
     height: number;
@@ -126,6 +126,8 @@ type PreparedTileflowCatalog = {
     /** Ordered shared dependency receipts, present only for maps that declare an Icon Set. */
     mapIconCompositions: Record<string, TileflowIconCompositionV1>;
     mapIconSources: Record<string, readonly TileflowEffectiveIconSourceIdentity[]>;
+    /** The files of each map's own 3D models, for its revision. */
+    mapModelSources?: Record<string, readonly TileflowEffectiveModelSourceIdentity[]>;
     project: PreparedTileflowBuildCatalog;
     sourceProject: TileflowSourceCatalog;
     /** Exact files whose contents select the composition, such as the icon lock. */

package/dist/icons.js

@@ -16,7 +16,7 @@ import {
   storeTileflowIconSetArtifact,
   verifyTileflowIconArtifact,
   writeTileflowIconsLockfile
-} from "./chunk-A2VTI43Y.js";
+} from "./chunk-IR22ZTQW.js";
 import "./chunk-7C4F6GAX.js";
 export {
   TileflowIconCompilationError,

package/dist/inspect.js

@@ -8,7 +8,7 @@ import {
 import {
   defaultTileflowConfigPath,
   loadValidTileflowConfigWithInputs
-} from "./chunk-6MGFMKG3.js";
+} from "./chunk-AQUGMUZW.js";
 import "./chunk-D4OE4ITL.js";
 
 // src/inspect.ts