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

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",
@@ -898,6 +902,7 @@ var init_visual_semantics = __esm({
       "fadeDuration",
       "gapWidth",
       "groundOcclusion",
+      "groundOcclusionRadius",
       "haloBlur",
       "haloWidth",
       "height",
@@ -6008,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",
@@ -11827,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 } : {}
           }
         ]
@@ -11998,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] } : {}
         }
       ])
@@ -13747,6 +13785,7 @@ 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 } : {},
@@ -13836,6 +13875,7 @@ var tileflowDefaultBuildings3DDesign = Object.freeze({
   shadows: true,
   occlusion: true,
   groundOcclusion: 0.16,
+  groundOcclusionRadius: 3,
   modelOcclusion: 0.75
 });
 function tileflowBuildingsMetadata(design) {
@@ -13876,7 +13916,11 @@ function readTileflowBuildings3D(metadata) {
     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)
@@ -13934,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 = {}) {
@@ -14100,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({
@@ -14138,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";
@@ -15009,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
   );
@@ -15100,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",
@@ -17272,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(),
@@ -17340,6 +17483,7 @@ 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(),
@@ -17393,8 +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(),
@@ -17542,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."
@@ -17765,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,
@@ -18420,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(),
@@ -20621,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) ? {
@@ -20651,7 +20807,13 @@ function tileflowBuildings3DDesignOf(module, context, layers2, buildingModels, t
     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)
@@ -20842,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] : []
@@ -20938,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",
@@ -21097,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 }
@@ -21108,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 } : {},
@@ -21215,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 } : {}
     }
@@ -21587,6 +21776,7 @@ var TileflowMapResolutionError = class extends Error {
 var tileflowMapMergeStrategies = {
   atmosphere: "atomic",
   boundaryAreas: "atomic",
+  camera: "deep",
   data: "atomic",
   defaultTheme: "atomic",
   extends: "lineage",

package/dist/{manifest-types-B0lQjabX.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';

package/dist/manifest.d.ts

@@ -1,5 +1,5 @@
-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 { 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) => {