@tileflow/core 0.1.0-alpha.40 → 0.1.0-alpha.42

package/dist/index.js

@@ -897,6 +897,7 @@ var init_visual_semantics = __esm({
       "lightness",
       "fadeDuration",
       "gapWidth",
+      "groundOcclusion",
       "haloBlur",
       "haloWidth",
       "height",
@@ -3802,19 +3803,19 @@ function deriveGlyph(glyph, metrics) {
   const bitmap = new Uint8Array(width * rows);
   for (let row = 0; row < rows; row++) {
     const y = y0 + row + 0.5;
-    for (let column = 0; column < width; column++) {
-      const x = x0 + column + 0.5;
+    for (let column2 = 0; column2 < width; column2++) {
+      const x = x0 + column2 + 0.5;
       const distance = Math.min(x - cell.x0, cell.x1 - x, y - cell.y0, cell.y1 - y);
       const background = Math.min(CELL_VALUE, Math.max(0, CELL_EDGE + CELL_SLOPE * distance));
       let letter = 0;
       if (hasBitmap) {
-        const sourceColumn = x0 + column - sourceX;
+        const sourceColumn = x0 + column2 - sourceX;
         const sourceRow = y0 + row - sourceY;
         if (sourceColumn >= 0 && sourceColumn < sourceWidth && sourceRow >= 0 && sourceRow < sourceHeight) {
           letter = glyph.bitmap[sourceRow * sourceWidth + sourceColumn];
         }
       }
-      bitmap[row * width + column] = Math.round(Math.max(letter, background));
+      bitmap[row * width + column2] = Math.round(Math.max(letter, background));
     }
   }
   return {
@@ -9013,6 +9014,7 @@ function resolvePoi(request) {
     density: request?.density ?? 2,
     detailZoom: request?.detailZoom ?? 17,
     densityByCategory: { ...request?.densityByCategory },
+    maxRankByType: { ...request?.maxRankByType },
     icons: request?.icons ?? true,
     labels: request?.labels ?? true,
     minZoom: request?.minZoom ?? 0,
@@ -9500,6 +9502,9 @@ function compileCategory(category, request, semantics, context, language, select
 }
 function createPoiSelection(semantics, context, language) {
   const { fields: fields2 } = context.data.schema;
+  const typeRankCaps = Object.entries(semantics.maxRankByType).sort(
+    ([a], [b]) => a.localeCompare(b)
+  );
   const shown = /* @__PURE__ */ new Map();
   const iconOnlyTypes = [...new Set(semantics.placement.iconOnlyTypes)];
   const iconOnly = () => iconOnlyTypes.length ? ["match", ["get", fields2.poiType], iconOnlyTypes, true, false] : ["literal", false];
@@ -9535,6 +9540,14 @@ function createPoiSelection(semantics, context, language) {
         [">=", sizeRank, 0],
         ["<=", sizeRank, 16]
       ];
+      if (typeRankCaps.length) {
+        result.push([
+          "match",
+          ["get", fields2.poiType],
+          ...typeRankCaps.flatMap(([type, rank]) => [type, ["<=", filterRank, rank]]),
+          true
+        ]);
+      }
       if (!semantics.icons || !semantics.labels) return result;
       const textless = categories.filter((category) => !shown.get(category)?.text);
       const iconless = categories.filter((category) => !shown.get(category)?.icon);
@@ -13573,6 +13586,12 @@ var tileflowModelParts = Object.freeze({
   accent: 3,
   roof: 4
 });
+var tileflowModelArchitecturalPartNames = Object.freeze(
+  Object.keys(tileflowModelParts)
+);
+function isTileflowModelPartName(value) {
+  return typeof value === "string" && value.length <= 32 && /^[a-z][a-z0-9]*(?:[-_][a-z0-9]+)*$/u.test(value);
+}
 var tileflowModelLightingRoles = Object.freeze({
   unclassified: 0,
   wall: 1,
@@ -13582,7 +13601,16 @@ var tileflowModelLightingRoles = Object.freeze({
   lamp: 5,
   logo: 6
 });
-var tileflowModelDefaultLightingRoles = Object.freeze([1, 1, 4, 1, 3]);
+var architecturalRoles = {
+  surface: 1,
+  secondary: 1,
+  glass: 4,
+  accent: 1,
+  roof: 3
+};
+function tileflowModelDefaultLightingRole(part) {
+  return Object.hasOwn(architecturalRoles, part) ? architecturalRoles[part] : tileflowModelLightingRoles.unclassified;
+}
 var tileflowModelLimits = Object.freeze({
   /** Levels of detail, nearest first. */
   levels: 3,
@@ -13599,7 +13627,9 @@ var tileflowModelLimits = Object.freeze({
   /** Models in one prepared file, as a landmark tile holds them. */
   models: 512,
   /** Bytes of one prepared file. */
-  bytes: 16 * 1024 * 1024
+  bytes: 16 * 1024 * 1024,
+  /** Differently named parts of one level. */
+  parts: 16
 });
 var tileflowModelVertexBytes = 16;
 function tileflowInsideRings(rings, px, py) {
@@ -13719,6 +13749,9 @@ function readModelRoleLighting(value) {
       ...entry.colorMix === void 0 ? {} : { colorMix: bounded(entry.colorMix, 0, 1, 1) },
       ...entry.metallic === void 0 ? {} : { metallic: bounded(entry.metallic, 0, 1, 0) },
       ...entry.roughness === void 0 ? {} : { roughness: bounded(entry.roughness, 0, 1, 1) },
+      ...entry.shading === "map" || entry.shading === "physical" ? { shading: entry.shading } : {},
+      ...entry.ambientOcclusion === void 0 ? {} : { ambientOcclusion: bounded(entry.ambientOcclusion, 0, 1, 1) },
+      ...entry.partColorMix === void 0 ? {} : { partColorMix: bounded(entry.partColorMix, 0, 1, 1) },
       ...readRoleColorVariation(entry.colorVariation),
       emissiveHeight: Array.isArray(gradient) && gradient.length === 5 && gradient.every(
         (v, i) => typeof v === "number" && Number.isFinite(v) && v <= 1 && v >= (i === 4 ? -1 : 0)
@@ -13802,6 +13835,7 @@ var tileflowDefaultBuildings3DDesign = Object.freeze({
   windows: false,
   shadows: true,
   occlusion: true,
+  groundOcclusion: 0.16,
   modelOcclusion: 0.75
 });
 function tileflowBuildingsMetadata(design) {
@@ -13828,7 +13862,7 @@ function readTileflowBuildings3D(metadata) {
     },
     color: color3,
     edges: within(value.edges, 1, 0),
-    edgeRadius: within(value.edgeRadius, 1, defaults4.edgeRadius),
+    edgeRadius: within(value.edgeRadius, 1.5, defaults4.edgeRadius),
     lighting: value.lighting === "style" ? "style" : defaults4.lighting,
     colorVariation: within(value.colorVariation, 1, 0),
     verticalGradient: value.verticalGradient !== false,
@@ -13841,6 +13875,7 @@ function readTileflowBuildings3D(metadata) {
     ...readTileflowBuildingsEntrance(value.entrance),
     shadows: typeof value.shadows === "boolean" ? value.shadows : defaults4.shadows,
     occlusion: typeof value.occlusion === "boolean" ? value.occlusion : defaults4.occlusion,
+    groundOcclusion: within(value.groundOcclusion, 1, defaults4.groundOcclusion),
     modelOcclusion: within(value.modelOcclusion, 1, defaults4.modelOcclusion),
     ...modelsOf(value.models),
     ...modelColorsOf(value.modelColors),
@@ -13887,8 +13922,8 @@ function modelsOf(value) {
 function modelColorsOf(value) {
   if (!isRecord7(value)) return {};
   const colors = {};
-  for (const part of Object.keys(tileflowModelParts))
-    if (typeof value[part] === "string") colors[part] = value[part];
+  for (const [part, color3] of Object.entries(value))
+    if (isTileflowModelPartName(part) && typeof color3 === "string") colors[part] = color3;
   return Object.keys(colors).length > 0 ? { modelColors: colors } : {};
 }
 function landmarksOf(value) {
@@ -14317,7 +14352,7 @@ function limitError(message) {
   return new Error(site ? `${message} Called at ${site}.` : message);
 }
 function authoringCallSite(stack) {
-  const locations = (stack ?? "").split("\n").slice(1).map((line) => /\(?([^()\s]+?):(\d+):(\d+)\)?$/.exec(line.trim())).filter((match3) => match3 !== null).map(([, file, line, column]) => ({ file: file.replace(/^file:\/\//, ""), line, column }));
+  const locations = (stack ?? "").split("\n").slice(1).map((line) => /\(?([^()\s]+?):(\d+):(\d+)\)?$/.exec(line.trim())).filter((match3) => match3 !== null).map(([, file, line, column2]) => ({ file: file.replace(/^file:\/\//, ""), line, column: column2 }));
   const own = locations[0]?.file;
   const site = locations.find(({ file }) => file !== own && !file.startsWith("node:"));
   return site ? `${site.file}:${site.line}:${site.column}` : void 0;
@@ -17307,6 +17342,9 @@ var modelRoleLightingSchema = z7.object({
   colorMix: boundedThemeNumberSchema(0, 1).optional(),
   metallic: boundedThemeNumberSchema(0, 1).optional(),
   roughness: boundedThemeNumberSchema(0, 1).optional(),
+  shading: z7.enum(["physical", "map"]).optional(),
+  ambientOcclusion: boundedThemeNumberSchema(0, 1).optional(),
+  partColorMix: boundedThemeNumberSchema(0, 1).optional(),
   colorVariation: z7.object({
     hue: z7.tuple([boundedThemeNumberSchema(0, 360), boundedThemeNumberSchema(0, 360)]),
     saturation: z7.tuple([boundedThemeNumberSchema(0, 100), boundedThemeNumberSchema(0, 100)]),
@@ -17333,7 +17371,7 @@ var buildingsModuleSchema = z7.object({
     lighting: z7.enum(["style", "sun"]).optional(),
     colorVariation: boundedThemeNumberSchema(0, 1).optional(),
     edges: boundedThemeNumberSchema(0, 1).optional(),
-    edgeRadius: z7.number().min(0).max(1).optional(),
+    edgeRadius: z7.number().min(0).max(1.5).optional(),
     edgeColor: themeColorValueSchema.optional(),
     nightLight: boundedThemeNumberSchema(0, 2).optional(),
     floodLight: z7.object({
@@ -17356,6 +17394,7 @@ var buildingsModuleSchema = z7.object({
     }).strict().optional(),
     entrance: z7.object({ buildings: entranceBandSchema.optional(), models: entranceBandSchema.optional() }).strict().optional(),
     occlusion: z7.boolean().optional(),
+    groundOcclusion: boundedThemeNumberSchema(0, 1).optional(),
     modelOcclusion: boundedThemeNumberSchema(0, 1).optional(),
     shadows: z7.boolean().optional(),
     windows: z7.boolean().optional(),
@@ -17392,13 +17431,14 @@ var buildingsModuleSchema = z7.object({
         }).optional()
       }).strict()
     ).max(256).optional(),
-    modelColors: z7.object({
-      surface: themeColorValueSchema.optional(),
-      secondary: themeColorValueSchema.optional(),
-      glass: themeColorValueSchema.optional(),
-      accent: themeColorValueSchema.optional(),
-      roof: themeColorValueSchema.optional()
-    }).strict().optional(),
+    modelColors: z7.record(
+      z7.string().refine(isTileflowModelPartName, {
+        message: "A model part is named in lower-case words joined by hyphens or underscores, at most 32 characters."
+      }),
+      themeColorValueSchema
+    ).refine((colors) => Object.keys(colors).length <= 64, {
+      message: "A map colours at most 64 model parts."
+    }).optional(),
     landmarks: z7.union([
       z7.boolean(),
       z7.object({
@@ -17603,6 +17643,17 @@ var poiModuleSchema = z7.object({
   type: z7.literal("poi"),
   detailZoom: z7.number().finite().gt(16).max(24).optional(),
   categories: z7.array(z7.enum(tileflowPoiCategories)).optional(),
+  maxRankByType: z7.record(
+    z7.string().regex(/^[a-z0-9]+(?:_[a-z0-9]+)*$/u, "Expected a World POI type"),
+    z7.union([
+      z7.literal(0),
+      z7.literal(1),
+      z7.literal(2),
+      z7.literal(3),
+      z7.literal(4),
+      z7.literal(5)
+    ])
+  ).describe("Fixed maximum World filter rank per POI type, independent of zoom detail.").optional(),
   color: z7.enum(["uniform", "category"]).optional(),
   density: z7.union([z7.literal(1), z7.literal(2), z7.literal(3), z7.literal(4), z7.literal(5)]).describe(
     "POI density from 1 to 5. Defaults to 2; native collisions determine which eligible names fit."
@@ -20599,6 +20650,7 @@ function tileflowBuildings3DDesignOf(module, context, layers2, buildingModels, t
     ...readTileflowBuildingsEntrance(style.entrance),
     shadows: typeof style.shadows === "boolean" ? style.shadows : defaults4.shadows,
     occlusion: typeof style.occlusion === "boolean" ? style.occlusion : defaults4.occlusion,
+    groundOcclusion: number(style.groundOcclusion, defaults4.groundOcclusion),
     modelOcclusion: number(style.modelOcclusion, defaults4.modelOcclusion),
     ...placedModels(style.models, buildingModels),
     ...modelColours(style.modelColors),
@@ -20622,7 +20674,7 @@ function placedModels(value, served) {
     throw new Error(
       `The buildings module places missing 3D models: ${missing.join(", ")}. Add ${missing.map((id2) => `${id2}.glb`).join(
         ", "
-      )} to a map.models directory, with materials named surface, secondary, glass, accent or roof, and run the Node build so the directories are prepared.`
+      )} to a map.models directory, with each material named after its part, such as surface, glass, roof or water, and run the Node build so the directories are prepared.`
     );
   return {
     models: placements.map((entry) => ({
@@ -22949,17 +23001,17 @@ function parseBoundaryLookupCsv(text) {
       );
     }
     const row = {};
-    header.forEach((column, position) => {
+    header.forEach((column2, position) => {
       const cell = record4[position];
-      if (cell === "" || !lookupColumns.has(column)) return;
-      if (numericLookupColumns.has(column)) {
+      if (cell === "" || !lookupColumns.has(column2)) return;
+      if (numericLookupColumns.has(column2)) {
         const number = Number(cell);
         if (!Number.isSafeInteger(number)) {
-          throw new Error(`Boundaries lookup CSV row ${index + 2} has a non-integer ${column}.`);
+          throw new Error(`Boundaries lookup CSV row ${index + 2} has a non-integer ${column2}.`);
         }
-        row[column] = number;
+        row[column2] = number;
       } else {
-        row[column] = cell;
+        row[column2] = cell;
       }
     });
     if (row.class_tier !== void 0 && !isClassTier(row.class_tier)) {
@@ -25196,6 +25248,7 @@ function checkTileflowModelSurface(surface, vertices, indices) {
     const value = attributes[i];
     if (!Number.isFinite(value) || Math.abs(value) > 65536) fail("unbounded vertex attributes");
     if (i % 8 >= 4 && (value < 0 || value > 1)) fail("vertex RGBA must be zero to one");
+    if ((i % 8 === 2 || i % 8 === 3) && (value < 0 || value > 1)) fail("UV1 must be zero to one");
   }
   if (!Array.isArray(materials) || materials.length < 1 || materials.length > tileflowModelSurfaceLimits.materials)
     fail("material count exceeds the limit");
@@ -25277,7 +25330,7 @@ function checkTileflowModelSurface(surface, vertices, indices) {
       fail("emitter count exceeds the limit");
     for (const emitter of emitters) {
       if (!emitter || typeof emitter !== "object") fail("invalid area emitter");
-      if (!tuple(emitter.start, 3, -2e3, 2e3) || !tuple(emitter.end, 3, -2e3, 2e3) || !number(emitter.height, 0.01, 1e3) || emitter.depth !== void 0 && !number(emitter.depth, 0, 100) || !Object.hasOwn(tileflowModelLightingRoles, emitter.role) || !Object.hasOwn(tileflowModelParts, emitter.part))
+      if (!tuple(emitter.start, 3, -2e3, 2e3) || !tuple(emitter.end, 3, -2e3, 2e3) || !number(emitter.height, 0.01, 1e3) || emitter.depth !== void 0 && !number(emitter.depth, 0, 100) || !Object.hasOwn(tileflowModelLightingRoles, emitter.role) || !isTileflowModelPartName(emitter.part))
         fail("invalid area emitter");
       if (Math.hypot(emitter.end[0] - emitter.start[0], emitter.end[1] - emitter.start[1]) < 1e-3 || Math.abs(emitter.end[2] - emitter.start[2]) > 0.01)
         fail("an area emitter needs a horizontal lower edge");
@@ -25320,7 +25373,6 @@ var levelNames = ["near", "mid", "far"];
 var meshopt = "EXT_meshopt_compression";
 var quantisation = "KHR_mesh_quantization";
 var steps = 32767;
-var partCount2 = Object.keys(tileflowModelParts).length;
 var roleCount = Object.keys(tileflowModelLightingRoles).length;
 var modelId2 = /^[a-z0-9]+(?:-[a-z0-9]+)*$/u;
 var [glbMagic, jsonChunk, binChunk] = [1179937895, 1313821514, 5130562];
@@ -25378,7 +25430,13 @@ function encodeTileflowModels(models, compressor) {
       return bufferViews.length - 1;
     }
     const mode = vertices ? "ATTRIBUTES" : "TRIANGLES";
-    const packed = compressor.encodeGltfBuffer(bytes, count, stride, mode);
+    const packed = compressor.encodeGltfBuffer(
+      bytes,
+      count,
+      stride,
+      mode,
+      vertices ? 1 : void 0
+    );
     const byteOffset = addBlob(packed);
     const fallbackOffset = fallbackLength;
     fallbackLength += bytes.byteLength + (4 - bytes.byteLength % 4) % 4;
@@ -25459,20 +25517,33 @@ function encodeTileflowModels(models, compressor) {
       let surface;
       if (mesh.surface && level.attributes) {
         const attributes = level.attributes;
-        const data = new Uint8Array(
-          attributes.buffer,
-          attributes.byteOffset,
-          attributes.byteLength
-        );
-        const view = addView(data, level.count, 32, true);
         const uv = accessors.length;
+        const rest = new Float32Array(level.count * 6);
+        const second = new Uint16Array(level.count * 2);
+        for (let vertex = 0; vertex < level.count; vertex++) {
+          const at = vertex * 8;
+          rest.set([attributes[at], attributes[at + 1]], vertex * 6);
+          rest.set(attributes.subarray(at + 4, at + 8), vertex * 6 + 2);
+          second[vertex * 2] = Math.round(attributes[at + 2] * 65535);
+          second[vertex * 2 + 1] = Math.round(attributes[at + 3] * 65535);
+        }
+        const view = addView(new Uint8Array(rest.buffer), level.count, 24, true);
+        const lightmap = addView(new Uint8Array(second.buffer), level.count, 4, true);
         accessors.push(
-          { bufferView: view, byteOffset: 0, componentType: 5126, count: level.count, type: "VEC4" },
-          { bufferView: view, byteOffset: 16, componentType: 5126, count: level.count, type: "VEC4" }
+          { bufferView: view, byteOffset: 0, componentType: 5126, count: level.count, type: "VEC2" },
+          {
+            bufferView: lightmap,
+            byteOffset: 0,
+            componentType: 5123,
+            normalized: true,
+            count: level.count,
+            type: "VEC2"
+          },
+          { bufferView: view, byteOffset: 8, componentType: 5126, count: level.count, type: "VEC4" }
         );
         surface = {
-          version: 1,
-          attributes: [uv, uv + 1],
+          version: 2,
+          attributes: [uv, uv + 1, uv + 2],
           materials: mesh.surface.materials,
           textures: mesh.surface.textures.map(({ bytes, ...texture }) => ({
             ...texture,
@@ -25489,7 +25560,7 @@ function encodeTileflowModels(models, compressor) {
         mesh: meshes.length - 1,
         translation: [...level.centre],
         scale: [level.step, level.step, level.step],
-        ...surface ? { extras: { tileflow: { surface } } } : {}
+        extras: { tileflow: { parts: [...partNamesOf(mesh)], ...surface ? { surface } : {} } }
       });
     }
     roots.push(nodes.length);
@@ -25559,7 +25630,7 @@ async function decodeTileflowModels(buffer, decompressor) {
         if (source !== 0 || byteStride !== stride || count * byteStride !== length)
           throw new Error();
         if (filter !== void 0 && filter !== "NONE") throw new Error();
-        if (mode !== (stride > 4 ? "ATTRIBUTES" : "TRIANGLES")) throw new Error();
+        if (mode !== (view.target === 34963 ? "TRIANGLES" : "ATTRIBUTES")) throw new Error();
         out = new Uint8Array(length);
         decoder.decodeGltfBuffer(out, count, byteStride, slice(bin, byteOffset, byteLength), mode);
       } else {
@@ -25598,6 +25669,7 @@ async function decodeTileflowModels(buffer, decompressor) {
         }
         levels.push({
           vertices: level.vertices,
+          partNames: level.partNames,
           indices: level.indices,
           centre: level.centre,
           step: level.step,
@@ -25752,6 +25824,7 @@ function quantise(mesh, compressor) {
     ...low.map((value, axis) => Math.max(centre[axis] - value, high[axis] - centre[axis]))
   );
   const step2 = Math.max(reach, 1e-3) / steps;
+  const names = partNamesOf(mesh);
   const raw = new Uint8Array(count * tileflowModelVertexBytes);
   const view = new DataView(raw.buffer);
   for (let vertex = 0; vertex < count; vertex += 1) {
@@ -25773,12 +25846,12 @@ function quantise(mesh, compressor) {
     for (let axis = 0; axis < 3; axis += 1)
       view.setInt8(at + 8 + axis, clamp3(Math.round(normal[axis] * 127), -127, 127));
     const part = mesh.parts[vertex];
-    if (!Number.isInteger(part) || part < 0 || part >= partCount2)
+    if (!Number.isInteger(part) || part < 0 || part >= names.length)
       throw new RangeError(`Vertex ${vertex} has no part.`);
     raw[at + 12] = part;
     raw[at + 13] = Math.round((clamp3(mesh.shades[vertex], -1, 1) + 1) / 2 * 255);
     raw[at + 14] = Math.round(clamp3(mesh.occlusion[vertex], 0, 1) * 255);
-    const role = mesh.lightingRoles?.[vertex] ?? tileflowModelDefaultLightingRoles[part];
+    const role = mesh.lightingRoles?.[vertex] ?? tileflowModelDefaultLightingRole(names[part]);
     if (!Number.isInteger(role) || role < 0 || role >= roleCount)
       throw new RangeError(`Vertex ${vertex} has no lighting role.`);
     raw[at + 15] = role;
@@ -25811,6 +25884,24 @@ function quantise(mesh, compressor) {
     order = new Array(unique);
     for (const [index, vertex] of kept.entries())
       if (remap[index] !== 4294967295) order[remap[index]] = vertex;
+  } else if (compressor) {
+    for (const { from, count: length } of mesh.surface.ranges) {
+      const range2 = indices.slice(from, from + length);
+      const [remap, unique] = compressor.reorderMesh(range2, true, false);
+      const global = new Uint32Array(unique);
+      for (const [vertex, local] of remap.entries())
+        if (local !== 4294967295) global[local] = vertex;
+      for (const [at, local] of range2.entries()) indices[from + at] = global[local];
+    }
+    const renumber = new Uint32Array(kept.length).fill(4294967295);
+    order = [];
+    for (const [at, vertex] of indices.entries()) {
+      if (renumber[vertex] === 4294967295) {
+        renumber[vertex] = order.length;
+        order.push(kept[vertex]);
+      }
+      indices[at] = renumber[vertex];
+    }
   }
   const vertices = new Uint8Array(order.length * tileflowModelVertexBytes);
   const attributes = mesh.surface ? new Float32Array(order.length * 8) : void 0;
@@ -25861,6 +25952,10 @@ function checkModel(model) {
         throw new RangeError(`Every vertex of level ${at} needs a part, a shade and a light.`);
     if (level.lightingRoles && level.lightingRoles.length !== count)
       throw new RangeError(`Every vertex of level ${at} needs a lighting role.`);
+    if (!isPartNames(partNamesOf(level)))
+      throw new RangeError(
+        `Level ${at} names 1 to ${tileflowModelLimits.parts} different parts, each in lower-case words joined by hyphens or underscores.`
+      );
     if (level.surface) checkTileflowModelSurface(level.surface, count, level.indices.length);
     for (let index = 0; index < count; index += 1)
       for (let axis = 0; axis < 3; axis += 1) {
@@ -25949,6 +26044,9 @@ function readLevelNode(json, node2, name, viewBytes, hasLightingRoles) {
   const indexCount = index?.count;
   if (!width || index.type !== "SCALAR" || (index.byteOffset ?? 0) !== 0 || !Number.isInteger(indexCount) || indexCount < 3 || indexCount % 3 !== 0 || indexCount / 3 > tileflowModelLimits.triangles)
     throw new Error();
+  const own = node2.extras?.tileflow?.parts;
+  const partNames = own === void 0 ? tileflowModelArchitecturalPartNames : own;
+  if (!isPartNames(partNames)) throw new Error();
   const vertices = viewBytes(
     position.bufferView,
     tileflowModelVertexBytes,
@@ -25957,8 +26055,8 @@ function readLevelNode(json, node2, name, viewBytes, hasLightingRoles) {
   for (let vertex = 0; vertex < count; vertex += 1) {
     const at = vertex * tileflowModelVertexBytes;
     const part = vertices[at + 12];
-    if (part >= partCount2) throw new Error();
-    if (!hasLightingRoles) vertices[at + 15] = tileflowModelDefaultLightingRoles[part];
+    if (part >= partNames.length) throw new Error();
+    if (!hasLightingRoles) vertices[at + 15] = tileflowModelDefaultLightingRole(partNames[part]);
     else if (vertices[at + 15] >= roleCount) throw new Error();
   }
   const indexBytes = viewBytes(index.bufferView, width, indexCount * width);
@@ -25967,18 +26065,30 @@ function readLevelNode(json, node2, name, viewBytes, hasLightingRoles) {
   const physical = node2.extras?.tileflow?.surface;
   let surface;
   if (physical !== void 0) {
-    if (physical?.version !== 1 || !Array.isArray(physical.attributes) || physical.attributes.length !== 2)
+    if (physical?.version !== 2 || !Array.isArray(physical.attributes) || physical.attributes.length !== 3)
       throw new Error();
-    const uv = accessor(physical.attributes[0]);
-    const colour = accessor(physical.attributes[1]);
-    if (!uv || !colour || (uv.byteOffset ?? 0) !== 0 || colour.byteOffset !== 16 || uv.bufferView !== colour.bufferView || [uv, colour].some(
-      (value) => value.componentType !== 5126 || value.type !== "VEC4" || value.count !== count || value.normalized === true
-    ))
+    const [uv, lightmap, colour] = physical.attributes.map(accessor);
+    if (!uv || !lightmap || !colour || (uv.byteOffset ?? 0) !== 0 || colour.byteOffset !== 8 || (lightmap.byteOffset ?? 0) !== 0 || uv.bufferView !== colour.bufferView || uv.bufferView === lightmap.bufferView || uv.componentType !== 5126 || uv.type !== "VEC2" || colour.componentType !== 5126 || colour.type !== "VEC4" || lightmap.componentType !== 5123 || lightmap.type !== "VEC2" || lightmap.normalized !== true || [uv, lightmap, colour].some((value) => value.count !== count))
       throw new Error();
-    const attributeBytes = viewBytes(uv.bufferView, 32, count * 32);
+    const restBytes = viewBytes(uv.bufferView, 24, count * 24);
+    const lightmapBytes = viewBytes(lightmap.bufferView, 4, count * 4);
+    const rest = new Float32Array(
+      restBytes.buffer.slice(restBytes.byteOffset, restBytes.byteOffset + count * 24)
+    );
+    const second = new Uint16Array(
+      lightmapBytes.buffer.slice(lightmapBytes.byteOffset, lightmapBytes.byteOffset + count * 4)
+    );
+    const attributes = new Float32Array(count * 8);
+    for (let vertex = 0; vertex < count; vertex++) {
+      const at = vertex * 8;
+      attributes[at] = rest[vertex * 6];
+      attributes[at + 1] = rest[vertex * 6 + 1];
+      attributes[at + 2] = second[vertex * 2] / 65535;
+      attributes[at + 3] = second[vertex * 2 + 1] / 65535;
+      attributes.set(rest.subarray(vertex * 6 + 2, vertex * 6 + 6), at + 4);
+    }
     if (!Array.isArray(physical.textures) || physical.textures.length > 32) throw new Error();
-    surface = {
-      attributes: new Float32Array(attributeBytes.buffer, attributeBytes.byteOffset, count * 8),
+    const read = {
       materials: physical.materials,
       ranges: physical.ranges,
       textures: physical.textures.map((texture) => {
@@ -25989,10 +26099,12 @@ function readLevelNode(json, node2, name, viewBytes, hasLightingRoles) {
       }),
       ...physical.emitters === void 0 ? {} : { emitters: physical.emitters }
     };
-    checkTileflowModelSurface(surface, count, indexCount);
+    checkTileflowModelSurface({ ...read, attributes }, count, indexCount);
+    surface = { ...read, uv: column(attributes, 0), rgba: column(attributes, 4) };
   }
   return {
     vertices,
+    partNames: [...partNames],
     indices,
     centre: [centre[0], centre[1], centre[2]],
     step: scale[0],
@@ -26001,6 +26113,24 @@ function readLevelNode(json, node2, name, viewBytes, hasLightingRoles) {
     surface
   };
 }
+function column(attributes, first) {
+  const out = attributes.slice(first, first + 4);
+  for (let at = 8 + first; at < attributes.length; at += 8)
+    for (let component = 0; component < 4; component += 1)
+      if (attributes[at + component] !== out[component]) {
+        const all2 = new Float32Array(attributes.length / 2);
+        for (let vertex = 0; vertex < all2.length / 4; vertex += 1)
+          all2.set(attributes.subarray(vertex * 8 + first, vertex * 8 + first + 4), vertex * 4);
+        return all2;
+      }
+  return out;
+}
+function partNamesOf(mesh) {
+  return mesh.partNames ?? tileflowModelArchitecturalPartNames;
+}
+function isPartNames(names) {
+  return Array.isArray(names) && names.length >= 1 && names.length <= tileflowModelLimits.parts && names.every(isTileflowModelPartName) && new Set(names).size === names.length;
+}
 function readGlb(bytes) {
   if (bytes.byteLength < 20 || bytes.byteLength > tileflowModelLimits.bytes) throw new Error();
   const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
@@ -26150,8 +26280,7 @@ function validFootprint(footprint) {
 }
 function readTileflowLandmarkRegion(json) {
   if (!isRecord18(json)) return void 0;
-  const named = json.format === "tileflow-landmark-region-v2";
-  if (!named && json.format !== "tileflow-landmark-region-v1") return void 0;
+  if (json.format !== "tileflow-landmark-region-v2") return void 0;
   const region = json.region;
   if (json.zoom !== tileflowLandmarkTileZoom || !Array.isArray(region) || region.length !== 3 || region[0] !== tileflowLandmarkRegionZoom || !Array.isArray(json.tiles))
     return void 0;
@@ -26159,17 +26288,13 @@ function readTileflowLandmarkRegion(json) {
   if (!Number.isInteger(x) || !Number.isInteger(y)) return void 0;
   const tiles = [];
   for (const tile of json.tiles) {
-    if (!Array.isArray(tile) || tile.length !== (named ? 4 : 3)) return void 0;
+    if (!Array.isArray(tile) || tile.length !== 4) return void 0;
     const [tx, ty, hash, listed] = tile;
     if (!Number.isInteger(tx) || !Number.isInteger(ty) || typeof hash !== "string")
       return void 0;
     if (!sha256.test(hash)) return void 0;
     const [rx, ry] = tileflowLandmarkRegionOf([tx, ty]);
     if (rx !== x || ry !== y) return void 0;
-    if (!named) {
-      tiles.push([tx, ty, hash]);
-      continue;
-    }
     const landmarks = readLandmarks(listed, tx, ty);
     if (!landmarks) return void 0;
     tiles.push([tx, ty, hash, landmarks]);
@@ -26298,6 +26423,7 @@ export {
   isTileflowCompilationPhase,
   isTileflowIconSetSource,
   isTileflowLocalDirectory,
+  isTileflowModelPartName,
   isTileflowPortableId,
   isTileflowThemeName,
   isTileflowTimeOfDay,
@@ -26473,8 +26599,9 @@ export {
   tileflowMapDefaultMaxDepth,
   tileflowMapIdSchema,
   tileflowMaxPitch,
+  tileflowModelArchitecturalPartNames,
   tileflowModelContentType,
-  tileflowModelDefaultLightingRoles,
+  tileflowModelDefaultLightingRole,
   tileflowModelFileName,
   tileflowModelImageSize,
   tileflowModelLightingRoles,

package/dist/{manifest-types-DnhSJjCM.d.ts → manifest-types-B0lQjabX.d.ts}

@@ -586,6 +586,8 @@ type TileflowPoiModuleConfig = {
     density?: TileflowPoiDensity;
     /** Category overrides of density, with the same zoom-dependent detail allowance. */
     densityByCategory?: Partial<Record<TileflowPoiCategory, TileflowPoiDensity>>;
+    /** Fixed maximum World filter rank per POI type (0–5), independent of zoom detail. */
+    maxRankByType?: Readonly<Record<string, 0 | 1 | 2 | 3 | 4 | 5>>;
     /** Zoom for the second extra rank of POI detail. Must exceed 16; defaults to 17. */
     detailZoom?: number;
     icons?: boolean;

package/dist/manifest.d.ts

@@ -1,5 +1,5 @@
-import { T as TileflowRuntimeManifest } from './manifest-types-DnhSJjCM.js';
-export { a as TileflowRuntimeColorScheme, b as TileflowRuntimeManifestMapEntry, c as TileflowRuntimeManifestTheme, d as TileflowRuntimeSystemThemes, e as TileflowTimeOfDay, f as TileflowTimeOfDayVariants, t as tileflowRuntimeManifestLimits, g as tileflowRuntimeManifestVersion, h as tileflowTimeOfDayManifestVersion } from './manifest-types-DnhSJjCM.js';
+import { T as TileflowRuntimeManifest } from './manifest-types-B0lQjabX.js';
+export { a as TileflowRuntimeColorScheme, b as TileflowRuntimeManifestMapEntry, c as TileflowRuntimeManifestTheme, d as TileflowRuntimeSystemThemes, e as TileflowTimeOfDay, f as TileflowTimeOfDayVariants, t as tileflowRuntimeManifestLimits, g as tileflowRuntimeManifestVersion, h as tileflowTimeOfDayManifestVersion } from './manifest-types-B0lQjabX.js';
 import { z } from 'zod';
 
 declare const tileflowRuntimeManifestSchema: z.ZodType<TileflowRuntimeManifest>;