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

package/dist/build.d.ts

@@ -1,7 +1,7 @@
 import { T as TileflowCaptureScene, a as TileflowCaptureShot } from './capture-shot-ChPQvPyi.js';
-import { T as TileflowRenderedIconIdentity, a as TileflowIconCompositionV1, R as ResolvedTileflowMap, b as TileflowDataRequirementsV1, c as TileflowSourceRequirementsV1, d as TileflowMap, e as TileflowStyleOptions, f as TileflowInspectedStyle, g as TileflowPreparedMapAssets } from './icon-composition-HUh_Lj8Z.js';
-export { h as TileflowDataCompatibilityIssue, i as TileflowDataFieldRequirement, j as TileflowDataFieldType, k as TileflowDataLayerRequirement, l as TileflowObservedDataContractV1, m as TileflowStyleInspection, n as TileflowStyleInspectionContribution, o as TileflowStyleInspectionLayer, p as TileflowStyleInspectionRenderOperation, q as collectMapLineage, r as inferTileflowDataRequirements, s as inferTileflowSourceRequirements, t as tileflowStyleInspectionSchemaVersion, v as validateTileflowDataCompatibility } from './icon-composition-HUh_Lj8Z.js';
-import { M as MapLibreStyle, f as TileflowTimeOfDayVariants, T as TileflowRuntimeManifest } from './manifest-types-DnhSJjCM.js';
+import { T as TileflowRenderedIconIdentity, a as TileflowIconCompositionV1, R as ResolvedTileflowMap, b as TileflowDataRequirementsV1, c as TileflowSourceRequirementsV1, d as TileflowMap, e as TileflowStyleOptions, f as TileflowInspectedStyle, g as TileflowPreparedMapAssets } from './icon-composition-Bbw9umUA.js';
+export { h as TileflowDataCompatibilityIssue, i as TileflowDataFieldRequirement, j as TileflowDataFieldType, k as TileflowDataLayerRequirement, l as TileflowObservedDataContractV1, m as TileflowStyleInspection, n as TileflowStyleInspectionContribution, o as TileflowStyleInspectionLayer, p as TileflowStyleInspectionRenderOperation, q as collectMapLineage, r as inferTileflowDataRequirements, s as inferTileflowSourceRequirements, t as tileflowStyleInspectionSchemaVersion, v as validateTileflowDataCompatibility } from './icon-composition-Bbw9umUA.js';
+import { M as MapLibreStyle, f as TileflowTimeOfDayVariants, T as TileflowRuntimeManifest } from './manifest-types-CwjHd4qc.js';
 import { z } from 'zod';
 
 declare const tileflowMapRevisionSchemaVersion: 1;
@@ -141,6 +141,9 @@ declare function hashTileflowAssetSetIdentities(input: readonly TileflowBuildAss
  */
 declare function createStyleWithInspection(config: TileflowMap, options?: TileflowStyleOptions): TileflowInspectedStyle;
 
+/** Native keeps the complete ground stroke; its renderer cannot derive clipped vector tiles. */
+declare function prepareTileflowNativePathGround(style: MapLibreStyle): MapLibreStyle;
+
 /** These are transport/validation bounds, not renderer or commercial quotas. */
 declare const tileflowRendererDeploymentLimits: Readonly<{
     maximumBytes: number;
@@ -507,6 +510,7 @@ declare const tileflowRendererDeploymentArtifactSchema: z.ZodObject<{
                         none: "none";
                     }>;
                     sky: z.ZodOptional<z.ZodLiteral<"removed">>;
+                    pathGround: z.ZodOptional<z.ZodLiteral<"ground-fallback">>;
                     layers: z.ZodArray<z.ZodLazy<z.core.$ZodObject<{
                         inputLayer: z.ZodNumber;
                         outputStart: z.ZodNumber;
@@ -592,4 +596,4 @@ declare function createManifest(catalog: TileflowBuildCatalog, options?: {
     manifestVersion?: 1 | 2;
 }): TileflowRuntimeManifest;
 
-export { type TileflowBuildAssetIdentity, type TileflowBuildCatalog, type TileflowBuildInspectedStyles, type TileflowBuildStyles, type TileflowCompiledMapMetadata, TileflowDataRequirementsV1, type TileflowEffectiveFontSourceIdentity, type TileflowEffectiveIconSourceIdentity, type TileflowEffectiveMapSourceAssets, type TileflowEffectiveModelSourceIdentity, type TileflowHashableBuildAsset, TileflowInspectedStyle, type TileflowMapBuildInput, type TileflowMapBuildLineageEntry, type TileflowMapBuildManifestEntryV1, type TileflowMapBuildManifestV1, type TileflowMapBuildProvenanceV1, TileflowPreparedMapAssets, type TileflowRendererDeploymentArtifact, TileflowRendererDeploymentError, type TileflowRendererDeploymentResponse, TileflowSourceRequirementsV1, type TileflowThemeBuildManifestEntryV1, collectTileflowMapBuildLineage, createManifest, createStyleFromCatalog, createStyleFromCatalogWithInspection, createStyleWithInspection, createStylesFromCatalog, createStylesFromCatalogWithInspection, createTileflowMapBuildManifest, hashTileflowAssetSet, hashTileflowAssetSetIdentities, hashTileflowMapRevision, parseTileflowRendererDeploymentArtifact, tileflowMapBuildManifestFileName, tileflowMapBuildManifestSchemaVersion, tileflowMapRevisionCanonicalization, tileflowMapRevisionSchemaVersion, tileflowRendererDeploymentArtifactSchema, tileflowRendererDeploymentLimits, tileflowRendererDeploymentResponseSchema, tileflowSharedIconMapRevisionSchemaVersion };
+export { type TileflowBuildAssetIdentity, type TileflowBuildCatalog, type TileflowBuildInspectedStyles, type TileflowBuildStyles, type TileflowCompiledMapMetadata, TileflowDataRequirementsV1, type TileflowEffectiveFontSourceIdentity, type TileflowEffectiveIconSourceIdentity, type TileflowEffectiveMapSourceAssets, type TileflowEffectiveModelSourceIdentity, type TileflowHashableBuildAsset, TileflowInspectedStyle, type TileflowMapBuildInput, type TileflowMapBuildLineageEntry, type TileflowMapBuildManifestEntryV1, type TileflowMapBuildManifestV1, type TileflowMapBuildProvenanceV1, TileflowPreparedMapAssets, type TileflowRendererDeploymentArtifact, TileflowRendererDeploymentError, type TileflowRendererDeploymentResponse, TileflowSourceRequirementsV1, type TileflowThemeBuildManifestEntryV1, collectTileflowMapBuildLineage, createManifest, createStyleFromCatalog, createStyleFromCatalogWithInspection, createStyleWithInspection, createStylesFromCatalog, createStylesFromCatalogWithInspection, createTileflowMapBuildManifest, hashTileflowAssetSet, hashTileflowAssetSetIdentities, hashTileflowMapRevision, parseTileflowRendererDeploymentArtifact, prepareTileflowNativePathGround, tileflowMapBuildManifestFileName, tileflowMapBuildManifestSchemaVersion, tileflowMapRevisionCanonicalization, tileflowMapRevisionSchemaVersion, tileflowRendererDeploymentArtifactSchema, tileflowRendererDeploymentLimits, tileflowRendererDeploymentResponseSchema, tileflowSharedIconMapRevisionSchemaVersion };

package/dist/build.js

@@ -2536,6 +2536,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",
@@ -5161,6 +5183,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,
@@ -5644,6 +5667,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];
@@ -5679,6 +5705,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);
@@ -5909,6 +5943,9 @@ var visualNumberProperties = /* @__PURE__ */ new Set([
   "blur",
   "brightnessScale",
   "crownScale",
+  "crownAnchor",
+  "sizeAnchor",
+  "sizeCompression",
   "contrast",
   "dash",
   "exaggeration",
@@ -5916,6 +5953,7 @@ var visualNumberProperties = /* @__PURE__ */ new Set([
   "emissiveVariation",
   "emissiveHeight",
   "colorMix",
+  "colorScale",
   "metallic",
   "roughness",
   "horizonBlend",
@@ -5924,6 +5962,8 @@ var visualNumberProperties = /* @__PURE__ */ new Set([
   "lightness",
   "fadeDuration",
   "gapWidth",
+  "groundOcclusion",
+  "groundOcclusionRadius",
   "haloBlur",
   "haloWidth",
   "height",
@@ -9478,6 +9518,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] } : {}
         }
       ])
@@ -10972,8 +11020,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)
@@ -11057,6 +11109,8 @@ var tileflowDefaultBuildings3DDesign = Object.freeze({
   windows: false,
   shadows: true,
   occlusion: true,
+  groundOcclusion: 0.16,
+  groundOcclusionRadius: 3,
   modelOcclusion: 0.75
 });
 function tileflowBuildingsMetadata(design) {
@@ -11073,6 +11127,9 @@ function isRecord5(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 = {}) {
@@ -11239,6 +11296,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({
@@ -11247,6 +11358,52 @@ var tileflowNoticeLimits = Object.freeze({
   maxTextLength: 120
 });
 
+// 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))}`;
+}
+function parsePathGroundRequest(value) {
+  if (value.length > 16e3) throw new Error("Path context URL is too long");
+  const url = new URL(value);
+  if (url.protocol !== `${tileflowPathGroundProtocol}:` || url.hostname !== "source" || url.username || url.password || url.hash)
+    throw new Error("Invalid path context URL");
+  const source = JSON.parse(url.searchParams.get("source") ?? "null");
+  if (!source || !["road", "landcover", "landuse", "class", "subclass", "brunnel"].every(
+    (k) => typeof source[k] === "string"
+  ))
+    throw new Error("Invalid path context bindings");
+  if (!source.url && !source.tiles?.length) throw new Error("Missing path context source");
+  for (const endpoint of [source.url, ...source.tiles ?? []].filter((s) => !!s)) {
+    const u = new URL(
+      endpoint.replaceAll("{z}", "0").replaceAll("{x}", "0").replaceAll("{y}", "0")
+    );
+    if (!["https:", "http:"].includes(u.protocol) || u.username || u.password)
+      throw new Error("Path context requires an HTTP(S) vector source");
+  }
+  if (url.pathname === "/index.json") return { source };
+  const match3 = /^\/(\d{1,2})\/(\d+)\/(\d+)\.pbf$/.exec(url.pathname);
+  if (!match3) throw new Error("Invalid path context tile");
+  const [z16, x, y] = match3.slice(1).map(Number);
+  if (z16 < 0 || z16 > 24 || x < 0 || y < 0 || x >= 2 ** z16 || y >= 2 ** z16)
+    throw new Error("Invalid path context coordinates");
+  return { source, tile: { z: z16, x, y } };
+}
+
 // src/resolved-map-schema.ts
 import { Color as Color3 } from "@maplibre/maplibre-gl-style-spec";
 import { z as z5 } from "zod";
@@ -12119,10 +12276,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
   );
@@ -12210,6 +12375,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",
@@ -14305,6 +14471,19 @@ var landModuleSchema = z5.object({
   }).strict().optional(),
   enabled: z5.boolean().optional(),
   globalLandcover: fillStyleSchema.optional(),
+  globalLandcoverUnderlay: z5.object({
+    url: z5.string().min(1),
+    coordinates: z5.tuple([
+      z5.tuple([z5.number(), z5.number()]),
+      z5.tuple([z5.number(), z5.number()]),
+      z5.tuple([z5.number(), z5.number()]),
+      z5.tuple([z5.number(), z5.number()])
+    ]),
+    attribution: z5.string().min(1),
+    opacity: numberValueSchema.optional(),
+    minZoom: z5.number().min(0).max(24).optional(),
+    maxZoom: z5.number().min(0).max(24).optional()
+  }).strict().optional(),
   landcover: z5.object({
     farmland: areaStyleSchema.optional(),
     flowerbed: areaStyleSchema.optional(),
@@ -14373,8 +14552,12 @@ var modelRoleLightingSchema = z5.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: z5.enum(["physical", "map"]).optional(),
+  ambientOcclusion: boundedThemeNumberSchema(0, 1).optional(),
+  partColorMix: boundedThemeNumberSchema(0, 1).optional(),
   colorVariation: z5.object({
     hue: z5.tuple([boundedThemeNumberSchema(0, 360), boundedThemeNumberSchema(0, 360)]),
     saturation: z5.tuple([boundedThemeNumberSchema(0, 100), boundedThemeNumberSchema(0, 100)]),
@@ -14401,7 +14584,7 @@ var buildingsModuleSchema = z5.object({
     lighting: z5.enum(["style", "sun"]).optional(),
     colorVariation: boundedThemeNumberSchema(0, 1).optional(),
     edges: boundedThemeNumberSchema(0, 1).optional(),
-    edgeRadius: z5.number().min(0).max(1).optional(),
+    edgeRadius: z5.number().min(0).max(1.5).optional(),
     edgeColor: themeColorValueSchema.optional(),
     nightLight: boundedThemeNumberSchema(0, 2).optional(),
     floodLight: z5.object({
@@ -14423,7 +14606,10 @@ var buildingsModuleSchema = z5.object({
       logo: modelRoleLightingSchema.optional()
     }).strict().optional(),
     entrance: z5.object({ buildings: entranceBandSchema.optional(), models: entranceBandSchema.optional() }).strict().optional(),
+    flatFootprints: z5.boolean().optional(),
     occlusion: z5.boolean().optional(),
+    groundOcclusion: boundedThemeNumberSchema(0, 1).optional(),
+    groundOcclusionRadius: boundedThemeNumberSchema(0, 20).optional(),
     modelOcclusion: boundedThemeNumberSchema(0, 1).optional(),
     shadows: z5.boolean().optional(),
     windows: z5.boolean().optional(),
@@ -14571,6 +14757,12 @@ var roadsModuleSchema = z5.object({
     "6": roadTreatmentStyleSchema.optional()
   }).strict().optional(),
   oneWayMarkers: z5.boolean().optional(),
+  pathGround: z5.object({
+    greenColor: themeColorValueSchema,
+    groundColor: themeColorValueSchema,
+    opacity: themeNumberValueSchema.optional(),
+    widthScale: themeNumberValueSchema.optional()
+  }).strict().optional(),
   outline: z5.enum(["none", "subtle", "strong"]).optional(),
   rampOrder: z5.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."
@@ -14672,6 +14864,17 @@ var poiModuleSchema = z5.object({
   type: z5.literal("poi"),
   detailZoom: z5.number().finite().gt(16).max(24).optional(),
   categories: z5.array(z5.enum(tileflowPoiCategories)).optional(),
+  maxRankByType: z5.record(
+    z5.string().regex(/^[a-z0-9]+(?:_[a-z0-9]+)*$/u, "Expected a World POI type"),
+    z5.union([
+      z5.literal(0),
+      z5.literal(1),
+      z5.literal(2),
+      z5.literal(3),
+      z5.literal(4),
+      z5.literal(5)
+    ])
+  ).describe("Fixed maximum World filter rank per POI type, independent of zoom detail.").optional(),
   color: z5.enum(["uniform", "category"]).optional(),
   density: z5.union([z5.literal(1), z5.literal(2), z5.literal(3), z5.literal(4), z5.literal(5)]).describe(
     "POI density from 1 to 5. Defaults to 2; native collisions determine which eligible names fit."
@@ -14783,6 +14986,9 @@ var modulesSchema = z5.object({
         z5.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: z5.array(
             z5.string().max(64).regex(
               tileflowTreeModelIdPattern,
@@ -15438,6 +15644,7 @@ var systemThemesSchema = z5.object({ dark: tileflowThemeNameSchema, light: tilef
 var resolvedTileflowMapSchema = z5.object({
   atmosphere: atmosphereSchema.optional(),
   boundaryAreas: boundaryAreasSchema.optional(),
+  camera: z5.object({ adaptivePerspective: z5.boolean().optional() }).strict().optional(),
   data: dataSchema.optional(),
   defaultTheme: tileflowThemeNameSchema,
   fonts: fontDirectoriesSchema.optional(),
@@ -17557,7 +17764,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)) } : {},
                 ...isRecord10(own.colorVariation) ? {
@@ -17586,7 +17793,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),
     ...landmarksOf(style.landmarks, tileflowLandmarks)
@@ -17758,6 +17972,7 @@ function compileSemanticStyleInternal(input, options, inspect, onReport) {
   });
   const platformSourceIds = [
     data.sourceId,
+    tileflowPathGroundSource,
     ...terrainSources.map(({ sourceId }) => sourceId),
     ...marineSources.map(({ sourceId }) => sourceId),
     ...boundaryAreas ? [boundaryAreas.sourceId] : []
@@ -17854,9 +18069,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",
@@ -18013,7 +18232,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 }
@@ -18024,6 +18246,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 } : {},
@@ -18131,6 +18366,12 @@ function compileSemanticStyleInternal(input, options, inspect, onReport) {
       [tileflowOverlayPlacementManifestMetadataKey]: overlayPlacementManifest,
       "tileflow:modules": Object.entries(modules).filter(([, module]) => !isRecord11(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 } : {}
     }
@@ -19000,6 +19241,7 @@ var TileflowMapResolutionError = class extends Error {
 var tileflowMapMergeStrategies = {
   atmosphere: "atomic",
   boundaryAreas: "atomic",
+  camera: "deep",
   data: "atomic",
   defaultTheme: "atomic",
   extends: "lineage",
@@ -20045,6 +20287,41 @@ function assertIconCompositionMatchesMap(map, sources) {
   }
 }
 
+// src/path-ground-native.ts
+function prepareTileflowNativePathGround(style) {
+  const derived = style.sources[tileflowPathGroundSource];
+  if (derived?.type !== "vector" || typeof derived.url !== "string" || !derived.url.startsWith("tileflow-path-ground:"))
+    return style;
+  let source;
+  try {
+    const parsed = parsePathGroundRequest(derived.url);
+    if (parsed.tile) return style;
+    source = parsed.source;
+  } catch {
+    return style;
+  }
+  const overlays = style.layers.filter(
+    (layer) => "source" in layer && layer.source === tileflowPathGroundSource
+  );
+  if (!overlays.length || overlays.some((layer) => layer.type !== "line")) return style;
+  return {
+    ...style,
+    sources: {
+      ...style.sources,
+      [tileflowPathGroundSource]: {
+        type: "vector",
+        ...source.url ? { url: source.url } : { tiles: source.tiles },
+        ...source.minzoom === void 0 ? {} : { minzoom: source.minzoom },
+        ...source.maxzoom === void 0 ? {} : { maxzoom: source.maxzoom }
+      }
+    },
+    // Keep indices and metadata references stable while the complete ground paths remain visible.
+    layers: style.layers.map(
+      (layer) => layer.type === "line" && layer.source === tileflowPathGroundSource ? { ...layer, paint: { ...layer.paint, "line-opacity": 0 } } : layer
+    )
+  };
+}
+
 // src/style-inspection.ts
 function createStyleWithInspection(config, options = {}) {
   const compiled = parseTileflowMap(config);
@@ -20202,6 +20479,8 @@ var tileflowNativeStyleTransformationSchema = strictNativeObject({
   projection: z13.enum(["none", "mercator-to-implicit", "globe-to-mercator"]),
   /** Present when preparation removed a browser sky, which Native does not draw. */
   sky: z13.literal("removed").optional(),
+  /** Native keeps complete ground paths without the browser-derived green overlay. */
+  pathGround: z13.literal("ground-fallback").optional(),
   layers: z13.array(layerTransformationSchema).max(tileflowNativeProfileLimits.maximumLayers),
   symbolOverlap: z13.array(symbolOverlapTransformationSchema).max(tileflowNativeProfileLimits.maximumLayers)
 }).superRefine((style, context) => {
@@ -29724,6 +30003,7 @@ export {
   inferTileflowDataRequirements,
   inferTileflowSourceRequirements,
   parseTileflowRendererDeploymentArtifact,
+  prepareTileflowNativePathGround,
   tileflowMapBuildManifestFileName,
   tileflowMapBuildManifestSchemaVersion,
   tileflowMapRevisionCanonicalization,