@tileflow/core 0.1.0-alpha.41 → 0.1.0-alpha.43

package/dist/index.js

@@ -882,6 +882,9 @@ var init_visual_semantics = __esm({
       "blur",
       "brightnessScale",
       "crownScale",
+      "crownAnchor",
+      "sizeAnchor",
+      "sizeCompression",
       "contrast",
       "dash",
       "exaggeration",
@@ -889,6 +892,7 @@ var init_visual_semantics = __esm({
       "emissiveVariation",
       "emissiveHeight",
       "colorMix",
+      "colorScale",
       "metallic",
       "roughness",
       "horizonBlend",
@@ -897,6 +901,8 @@ var init_visual_semantics = __esm({
       "lightness",
       "fadeDuration",
       "gapWidth",
+      "groundOcclusion",
+      "groundOcclusionRadius",
       "haloBlur",
       "haloWidth",
       "height",
@@ -6007,6 +6013,28 @@ function compileLand(request, context) {
       target: "land.background"
     });
   }
+  if (config.globalLandcoverUnderlay && schema.layers.globalLandcover && config.globalLandcover?.visible !== false) {
+    const underlay = config.globalLandcoverUnderlay;
+    contributions.push({
+      kind: "layer",
+      owner: "land",
+      slot: "land",
+      localOrder: 9,
+      target: "land.globalLandcoverUnderlay",
+      layer: {
+        id: "tileflow-global-landcover-underlay",
+        type: "raster",
+        source: "tileflow-landcover-underlay",
+        minzoom: underlay.minZoom ?? 0,
+        maxzoom: underlay.maxZoom ?? 11,
+        paint: {
+          "raster-opacity": toMapLibreStyleValue(underlay.opacity ?? 1),
+          "raster-fade-duration": 0,
+          "raster-resampling": "linear"
+        }
+      }
+    });
+  }
   if (schema.layers.globalLandcover && config.globalLandcover?.visible !== false) {
     contributions.push({
       kind: "layer",
@@ -9013,6 +9041,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 +9529,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 +9567,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);
@@ -11814,6 +11854,9 @@ function readTileflowVegetation3D(metadata) {
           {
             heightScale: scale(own.heightScale),
             crownScale: scale(own.crownScale),
+            ...typeof own.sizeAnchor === "number" && Number.isFinite(own.sizeAnchor) ? { sizeAnchor: clamp(own.sizeAnchor, [1, 45]) } : {},
+            ...typeof own.crownAnchor === "number" && Number.isFinite(own.crownAnchor) ? { crownAnchor: clamp(own.crownAnchor, [1, 25]) } : {},
+            ...typeof own.sizeCompression === "number" && Number.isFinite(own.sizeCompression) ? { sizeCompression: clamp(own.sizeCompression, [0, 1]) } : {},
             ...drawn.length > 0 ? { models: drawn } : {}
           }
         ]
@@ -11985,6 +12028,14 @@ function tileflowVegetationDescription(request, context) {
         {
           heightScale: number(own?.heightScale),
           crownScale: number(own?.crownScale),
+          ...own?.sizeAnchor === void 0 ? {} : { sizeAnchor: number(own.sizeAnchor) },
+          ...own?.crownAnchor === void 0 ? {} : { crownAnchor: number(own.crownAnchor) },
+          ...own?.sizeCompression === void 0 ? {} : {
+            sizeCompression: Math.max(
+              0,
+              Math.min(1, Number(toMapLibreStyleValue(own.sizeCompression)) || 0)
+            )
+          },
           ...own?.models?.length ? { models: [...own.models] } : {}
         }
       ])
@@ -13734,8 +13785,12 @@ function readModelRoleLighting(value) {
       ...typeof entry.emissiveColor === "string" ? { emissiveColor: entry.emissiveColor } : {},
       ...typeof entry.color === "string" ? { color: entry.color } : {},
       ...entry.colorMix === void 0 ? {} : { colorMix: bounded(entry.colorMix, 0, 1, 1) },
+      ...entry.colorScale === void 0 ? {} : { colorScale: bounded(entry.colorScale, 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)
@@ -13819,6 +13874,8 @@ var tileflowDefaultBuildings3DDesign = Object.freeze({
   windows: false,
   shadows: true,
   occlusion: true,
+  groundOcclusion: 0.16,
+  groundOcclusionRadius: 3,
   modelOcclusion: 0.75
 });
 function tileflowBuildingsMetadata(design) {
@@ -13845,7 +13902,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,
@@ -13858,7 +13915,12 @@ 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),
+    groundOcclusionRadius: within(value.groundOcclusionRadius, 20, defaults4.groundOcclusionRadius),
     modelOcclusion: within(value.modelOcclusion, 1, defaults4.modelOcclusion),
+    ...Array.isArray(value.flatLayers) && value.flatLayers.length <= 128 && value.flatLayers.every(
+      (entry) => isRecord7(entry) && typeof entry.id === "string" && typeof entry.visible === "boolean"
+    ) ? { flatLayers: value.flatLayers } : {},
     ...modelsOf(value.models),
     ...modelColorsOf(value.modelColors),
     ...landmarksOf(value.landmarks)
@@ -13916,6 +13978,9 @@ function isRecord7(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 
+// src/camera.ts
+var tileflowCameraMetadataKey = "tileflow:camera";
+
 // src/data/requirements.ts
 import { convertFilter } from "@maplibre/maplibre-gl-style-spec";
 function inferTileflowDataRequirements(style, options = {}) {
@@ -14082,6 +14147,60 @@ function compareCodeUnits4(left, right) {
   return left < right ? -1 : left > right ? 1 : 0;
 }
 
+// src/modules/roads/path-ground.ts
+var pathTarget = /^roads\.classes\.(pathway|footway|pedestrian|steps|cycleway)\.(surface|bridge|tunnel)\.(fill|casing|shadow)$/;
+function compilePathGroundFamilies(input, options) {
+  if (!options || Number(options.opacity ?? 1) === 0) return { families: input, active: false };
+  const scale = Number(options.widthScale ?? 1);
+  const scaled = (value) => {
+    if (Array.isArray(value) && value[0] === "interpolate" && Array.isArray(value[2]) && value[2][0] === "zoom")
+      return value.map((v, i) => i >= 4 && i % 2 === 0 ? ["*", v, scale] : v);
+    return ["*", value ?? 1, scale];
+  };
+  let active = false;
+  let families = input.flatMap((family) => {
+    const match3 = pathTarget.exec(family.target);
+    if (!match3 || match3[2] !== "surface") return [family];
+    const [, kind, , phase] = match3;
+    const appearance = { ...family.style.appearance };
+    if (phase === "casing") appearance["line-opacity"] = 0;
+    else {
+      appearance["line-color"] = options.groundColor;
+      appearance["line-width"] = scaled(appearance["line-width"]);
+      appearance["line-opacity"] = kind === "cycleway" && phase === "fill" ? 0 : Number(options.opacity ?? 1);
+    }
+    const base = { ...family, style: { ...family.style, appearance } };
+    if (phase === "casing" || kind === "cycleway" && phase === "fill") return [base];
+    active = true;
+    const overlay = {
+      ...base,
+      family: void 0,
+      key: base.key + ".onGreen",
+      target: base.target + ".onGreen",
+      feature: { ...base.feature, dataSource: "tileflow-path-ground" },
+      style: { ...base.style, appearance: { ...appearance, "line-color": options.greenColor } },
+      origins: base.origins.map((origin) => ({ ...origin, target: base.target + ".onGreen" }))
+    };
+    return [base, overlay];
+  });
+  for (const structure of ["surface", "bridge", "tunnel"]) {
+    const move = (family) => {
+      const match3 = pathTarget.exec(family.target.replace(/\.onGreen$/, ""));
+      return match3?.[2] === structure && (match3[3] === "fill" || structure === "surface" && match3[3] === "shadow");
+    };
+    const paths = families.filter(move);
+    families = families.filter((f) => !move(f));
+    const anchor = families.findIndex(
+      (f) => new RegExp(
+        `^roads\\.classes\\.(track|service|minor|tertiary|secondary|primary|trunk|motorway)\\.${structure}\\.casing$`
+      ).test(f.target)
+    );
+    if (anchor >= 0) families.splice(anchor, 0, ...paths);
+    else families.push(...paths);
+  }
+  return { families, active };
+}
+
 // src/notices.ts
 var tileflowNoticesMetadataKey = "tileflow:notices";
 var tileflowNoticeLimits = Object.freeze({
@@ -14120,6 +14239,26 @@ function isRecord8(value) {
   return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
 
+// src/path-ground-protocol.ts
+var tileflowPathGroundProtocol = "tileflow-path-ground";
+var tileflowPathGroundSource = "tileflow-path-ground";
+function pathGroundSourceConfig(data) {
+  return {
+    ...data.url ? { url: data.url } : { tiles: data.tiles },
+    minzoom: Math.max(12, data.minzoom ?? 0),
+    maxzoom: data.maxzoom ?? 15,
+    road: data.schema.layers.road,
+    landcover: data.schema.layers.landcover,
+    landuse: data.schema.layers.landuse,
+    class: data.schema.fields.class,
+    subclass: data.schema.fields.subclass,
+    brunnel: data.schema.fields.brunnel
+  };
+}
+function pathGroundProtocolUrl(source, tile = false) {
+  return `${tileflowPathGroundProtocol}://source/${tile ? "{z}/{x}/{y}.pbf" : "index.json"}?source=${encodeURIComponent(JSON.stringify(source))}`;
+}
+
 // src/resolved-map-schema.ts
 init_camera_limits();
 import { Color as Color3 } from "@maplibre/maplibre-gl-style-spec";
@@ -14991,10 +15130,18 @@ function physicalLayerIdForSemanticKey(semanticKey) {
     semanticKey
   );
   if (match3) return `tileflow-${match3[1]}-render-${match3[2].replaceAll(".", "-")}`;
+  match3 = /^roads\.classes\.(pathway|footway|pedestrian|steps|cycleway)\.surface\.(shadow|fill)-on-green$/u.exec(
+    semanticKey
+  );
+  if (match3) return `tileflow-road-surface-${match3[1]}-${match3[2]}-on-green`;
   match3 = /^roads\.classes\.([^.]+)\.(tunnel|surface|bridge)\.(shadow|casing|fill|hatch|rampFill)$/u.exec(
     semanticKey
   );
   if (match3) return `tileflow-road-${match3[2]}-${match3[1]}-${match3[3]}`;
+  match3 = /^roads\.classes\.(pathway|footway|pedestrian|steps|cycleway)\.surface\.(shadow|fill)\.onGreen$/u.exec(
+    semanticKey
+  );
+  if (match3) return `tileflow-road-surface-${match3[1]}-${match3[2]}-on-green`;
   match3 = /^roads\.cohorts\.(tunnel|surface|bridge)\.([^.]+)\.(shadow|casing|fill|rampFill)$/u.exec(
     semanticKey
   );
@@ -15082,6 +15229,7 @@ var exactPhysicalLayerIds = Object.freeze({
   "labels.junctions": "tileflow-label-road-junction",
   "land.background": "tileflow-background",
   "land.globalLandcover": "tileflow-global-landcover",
+  "land.globalLandcoverUnderlay": "tileflow-global-landcover-underlay",
   poi: "tileflow-poi",
   "landforms.classes": "tileflow-landforms",
   "roads.crossings": "tileflow-road-crossing",
@@ -17254,6 +17402,19 @@ var landModuleSchema = z7.object({
   }).strict().optional(),
   enabled: z7.boolean().optional(),
   globalLandcover: fillStyleSchema.optional(),
+  globalLandcoverUnderlay: z7.object({
+    url: z7.string().min(1),
+    coordinates: z7.tuple([
+      z7.tuple([z7.number(), z7.number()]),
+      z7.tuple([z7.number(), z7.number()]),
+      z7.tuple([z7.number(), z7.number()]),
+      z7.tuple([z7.number(), z7.number()])
+    ]),
+    attribution: z7.string().min(1),
+    opacity: numberValueSchema.optional(),
+    minZoom: z7.number().min(0).max(24).optional(),
+    maxZoom: z7.number().min(0).max(24).optional()
+  }).strict().optional(),
   landcover: z7.object({
     farmland: areaStyleSchema.optional(),
     flowerbed: areaStyleSchema.optional(),
@@ -17322,8 +17483,12 @@ var modelRoleLightingSchema = z7.object({
   emissiveColor: themeColorValueSchema.optional(),
   color: themeColorValueSchema.optional(),
   colorMix: boundedThemeNumberSchema(0, 1).optional(),
+  colorScale: 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)]),
@@ -17350,7 +17515,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({
@@ -17372,7 +17537,10 @@ var buildingsModuleSchema = z7.object({
       logo: modelRoleLightingSchema.optional()
     }).strict().optional(),
     entrance: z7.object({ buildings: entranceBandSchema.optional(), models: entranceBandSchema.optional() }).strict().optional(),
+    flatFootprints: z7.boolean().optional(),
     occlusion: z7.boolean().optional(),
+    groundOcclusion: boundedThemeNumberSchema(0, 1).optional(),
+    groundOcclusionRadius: boundedThemeNumberSchema(0, 20).optional(),
     modelOcclusion: boundedThemeNumberSchema(0, 1).optional(),
     shadows: z7.boolean().optional(),
     windows: z7.boolean().optional(),
@@ -17520,6 +17688,12 @@ var roadsModuleSchema = z7.object({
     "6": roadTreatmentStyleSchema.optional()
   }).strict().optional(),
   oneWayMarkers: z7.boolean().optional(),
+  pathGround: z7.object({
+    greenColor: themeColorValueSchema,
+    groundColor: themeColorValueSchema,
+    opacity: themeNumberValueSchema.optional(),
+    widthScale: themeNumberValueSchema.optional()
+  }).strict().optional(),
   outline: z7.enum(["none", "subtle", "strong"]).optional(),
   rampOrder: z7.enum(["below-roads", "by-class"]).describe(
     "Ramp fills draw below receiving roads by default. Use by-class to keep ramp fills in their road class order."
@@ -17621,6 +17795,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."
@@ -17732,6 +17917,9 @@ var modulesSchema = z7.object({
         z7.object({
           crownScale: boundedThemeNumberSchema(0.1, 10).optional(),
           heightScale: boundedThemeNumberSchema(0.1, 10).optional(),
+          sizeAnchor: boundedThemeNumberSchema(1, 45).optional(),
+          crownAnchor: boundedThemeNumberSchema(1, 25).optional(),
+          sizeCompression: boundedThemeNumberSchema(0, 1).optional(),
           models: z7.array(
             z7.string().max(64).regex(
               tileflowTreeModelIdPattern,
@@ -18387,6 +18575,7 @@ var systemThemesSchema = z7.object({ dark: tileflowThemeNameSchema, light: tilef
 var resolvedTileflowMapSchema = z7.object({
   atmosphere: atmosphereSchema.optional(),
   boundaryAreas: boundaryAreasSchema.optional(),
+  camera: z7.object({ adaptivePerspective: z7.boolean().optional() }).strict().optional(),
   data: dataSchema.optional(),
   defaultTheme: tileflowThemeNameSchema,
   fonts: fontDirectoriesSchema.optional(),
@@ -20588,7 +20777,7 @@ function tileflowBuildings3DDesignOf(module, context, layers2, buildingModels, t
                 ...own,
                 emissiveStrength: number(own.emissiveStrength, 0),
                 ...Object.fromEntries(
-                  ["emissiveVariation", "colorMix", "metallic", "roughness"].filter((key) => own[key] !== void 0).map((key) => [key, number(own[key], 0)])
+                  ["emissiveVariation", "colorMix", "colorScale", "metallic", "roughness"].filter((key) => own[key] !== void 0).map((key) => [key, number(own[key], 0)])
                 ),
                 ...Array.isArray(own.emissiveHeight) ? { emissiveHeight: own.emissiveHeight.map((v) => number(v, 0)) } : {},
                 ...isRecord13(own.colorVariation) ? {
@@ -20617,7 +20806,14 @@ 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),
+    groundOcclusionRadius: number(style.groundOcclusionRadius, defaults4.groundOcclusionRadius),
     modelOcclusion: number(style.modelOcclusion, defaults4.modelOcclusion),
+    ...style.flatFootprints === false ? {
+      flatLayers: layers2.filter(
+        (layer) => layer.id.startsWith("tileflow-buildings-") && (layer.type === "fill" || layer.type === "line") && layer.metadata?.["tileflow:3d-toggle"] === void 0
+      ).map((layer) => ({ id: layer.id, visible: layer.layout?.visibility !== "none" }))
+    } : {},
     ...placedModels(style.models, buildingModels),
     ...modelColours(style.modelColors),
     ...landmarksOf2(style.landmarks, tileflowLandmarks)
@@ -20808,6 +21004,7 @@ function compileSemanticStyleInternal(input, options, inspect, onReport) {
   });
   const platformSourceIds = [
     data.sourceId,
+    tileflowPathGroundSource,
     ...terrainSources.map(({ sourceId }) => sourceId),
     ...marineSources.map(({ sourceId }) => sourceId),
     ...boundaryAreas ? [boundaryAreas.sourceId] : []
@@ -20904,9 +21101,13 @@ function compileSemanticStyleInternal(input, options, inspect, onReport) {
       buildingTargetsOfOtherModes(modules.buildings)
     )
   );
+  const pathGround = compilePathGroundFamilies(
+    stackedFamilies,
+    modules.roads?.enabled === false ? void 0 : modules.roads?.pathGround
+  );
   const plannedFamilies = runCompilationPhase(
     "physical-planner",
-    () => planTileflowLayerFamilies(stackedFamilies)
+    () => planTileflowLayerFamilies(pathGround.families)
   );
   const loweredDomainIR = runCompilationPhase(
     "lowering",
@@ -21063,7 +21264,10 @@ function compileSemanticStyleInternal(input, options, inspect, onReport) {
   const primarySource = {
     type: "vector",
     ...data.url !== void 0 ? { url: data.url } : { tiles: data.tiles },
-    attribution: data.attribution,
+    attribution: [
+      data.attribution,
+      ...modules.land?.globalLandcoverUnderlay ? [modules.land.globalLandcoverUnderlay.attribution] : []
+    ].filter(Boolean).join(" | "),
     ...data.bounds ? { bounds: data.bounds } : {},
     ...data.maxzoom === void 0 ? {} : { maxzoom: data.maxzoom },
     ...data.minzoom === void 0 ? {} : { minzoom: data.minzoom }
@@ -21074,6 +21278,19 @@ function compileSemanticStyleInternal(input, options, inspect, onReport) {
   };
   const sources = {
     [data.sourceId]: primarySource,
+    ...pathGround.active ? {
+      [tileflowPathGroundSource]: {
+        type: "vector",
+        url: pathGroundProtocolUrl(pathGroundSourceConfig(data))
+      }
+    } : {},
+    ...modules.land?.enabled !== false && modules.land?.globalLandcoverUnderlay && data.schema.layers.globalLandcover && modules.land.globalLandcover?.visible !== false ? {
+      "tileflow-landcover-underlay": {
+        type: "image",
+        url: modules.land.globalLandcoverUnderlay.url,
+        coordinates: modules.land.globalLandcoverUnderlay.coordinates
+      }
+    } : {},
     ...marine?.bathymetry?.vector ? { [marine.bathymetry.vector.sourceId]: marine.bathymetry.vector.source } : {},
     ...marine?.bathymetry?.relief ? { [marine.bathymetry.relief.sourceId]: marine.bathymetry.relief.source } : {},
     ...marine?.nautical ? { [marine.nautical.sourceId]: marine.nautical.source } : {},
@@ -21181,6 +21398,12 @@ function compileSemanticStyleInternal(input, options, inspect, onReport) {
       [tileflowOverlayPlacementManifestMetadataKey]: overlayPlacementManifest,
       "tileflow:modules": Object.entries(modules).filter(([, module]) => !isRecord14(module) || module.enabled !== false).map(([name]) => name).sort(),
       ...config.view ? { "tileflow:view": config.view } : {},
+      ...config.camera?.adaptivePerspective !== void 0 ? {
+        [tileflowCameraMetadataKey]: {
+          version: 1,
+          adaptivePerspective: config.camera.adaptivePerspective
+        }
+      } : {},
       ...notices.length > 0 ? { [tileflowNoticesMetadataKey]: notices } : {},
       ...nauticalLights ? { [tileflowNauticalLightsMetadataKey]: nauticalLights } : {}
     }
@@ -21553,6 +21776,7 @@ var TileflowMapResolutionError = class extends Error {
 var tileflowMapMergeStrategies = {
   atmosphere: "atomic",
   boundaryAreas: "atomic",
+  camera: "deep",
   data: "atomic",
   defaultTheme: "atomic",
   extends: "lineage",
@@ -25396,7 +25620,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;
@@ -25844,6 +26074,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;

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

@@ -492,6 +492,14 @@ type TileflowRoadsModuleConfig = {
     modifiers?: Partial<Record<TileflowRoadModifier, TileflowRoadTreatmentStyle>>;
     mountainBike?: Partial<Record<TileflowMountainBikeScale, TileflowRoadTreatmentStyle>>;
     oneWayMarkers?: boolean;
+    /** Surface paths keep a ground-coloured fallback and white/green-ground clipped strokes. */
+    pathGround?: {
+        greenColor: TileflowThemeColorValue;
+        groundColor: TileflowThemeColorValue;
+        /** Zero disables derivation in this theme. */
+        opacity?: TileflowThemeNumberValue;
+        widthScale?: TileflowThemeNumberValue;
+    };
     outline?: TileflowRoadOutline;
     /** Draw ramp fills below receiving roads by default; `by-class` keeps their class's order. */
     rampOrder?: 'below-roads' | 'by-class';
@@ -586,6 +594,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-CwjHd4qc.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-CwjHd4qc.js';
 import { z } from 'zod';
 
 declare const tileflowRuntimeManifestSchema: z.ZodType<TileflowRuntimeManifest>;

package/dist/native-profile.d.ts

@@ -87,6 +87,8 @@ declare const tileflowNativeStyleTransformationSchema: z.ZodLazy<z.core.$ZodObje
     }>;
     /** Present when preparation removed a browser sky, which Native does not draw. */
     sky: z.ZodOptional<z.ZodLiteral<"removed">>;
+    /** Native keeps complete ground paths without the browser-derived green overlay. */
+    pathGround: z.ZodOptional<z.ZodLiteral<"ground-fallback">>;
     layers: z.ZodArray<z.ZodLazy<z.core.$ZodObject<{
         inputLayer: z.ZodNumber;
         outputStart: z.ZodNumber;
@@ -131,6 +133,8 @@ declare const tileflowNativeBuildRecordSchema: z.ZodLazy<z.core.$ZodObject<{
         }>;
         /** Present when preparation removed a browser sky, which Native does not draw. */
         sky: z.ZodOptional<z.ZodLiteral<"removed">>;
+        /** Native keeps complete ground paths without the browser-derived green overlay. */
+        pathGround: z.ZodOptional<z.ZodLiteral<"ground-fallback">>;
         layers: z.ZodArray<z.ZodLazy<z.core.$ZodObject<{
             inputLayer: z.ZodNumber;
             outputStart: z.ZodNumber;

package/dist/native-profile.js

@@ -8827,6 +8827,8 @@ var tileflowNativeStyleTransformationSchema = strictNativeObject({
   projection: z4.enum(["none", "mercator-to-implicit", "globe-to-mercator"]),
   /** Present when preparation removed a browser sky, which Native does not draw. */
   sky: z4.literal("removed").optional(),
+  /** Native keeps complete ground paths without the browser-derived green overlay. */
+  pathGround: z4.literal("ground-fallback").optional(),
   layers: z4.array(layerTransformationSchema).max(tileflowNativeProfileLimits.maximumLayers),
   symbolOverlap: z4.array(symbolOverlapTransformationSchema).max(tileflowNativeProfileLimits.maximumLayers)
 }).superRefine((style, context) => {