@tileflow/core 0.1.0-alpha.31 → 0.1.0-alpha.32

package/dist/index.js

@@ -2174,8 +2174,19 @@ var tileflowCaptureSceneSchema = z3.object({
   viewport: tileflowCaptureViewportSchema,
   target: tileflowCaptureTargetSchema.optional()
 }).strict();
+function tileflowCaptureSceneFitIssue(scene) {
+  if (scene.camera.type !== "bounds" || scene.camera.padding === void 0) return void 0;
+  const room = Math.min(scene.viewport.width, scene.viewport.height);
+  if (scene.camera.padding * 2 < room) return void 0;
+  return {
+    message: `Expected bounds padding less than half the viewport's shorter side (${room / 2} pixels)`,
+    path: ["camera", "padding"]
+  };
+}
 function normalizeTileflowCaptureScene(input) {
   const scene = tileflowCaptureSceneSchema.parse(input);
+  const fit = tileflowCaptureSceneFitIssue(scene);
+  if (fit) throw new RangeError(`${fit.path.join(".")}: ${fit.message}`);
   const camera = scene.camera.type === "center" ? {
     type: scene.camera.type,
     center: scene.camera.center,
@@ -2391,6 +2402,7 @@ var canonicalLayers = {
   boundary: "boundary",
   building: "building",
   businessCorridor: "business_corridor",
+  canopy: "canopy",
   globalLandcover: "globallandcover",
   houseNumber: "housenumber",
   landcover: "landcover",
@@ -2412,8 +2424,10 @@ var canonicalFields = {
   adminLevel: "admin_level",
   bicycle: "bicycle",
   brunnel: "brunnel",
-  buildingKind: "building_kind",
   buildingTone: "building_tone",
+  canopyClearanceAtZoom15: "clearance_px_z15",
+  canopyCoverPercent: "cover_pct",
+  canopyRank: "rank",
   capital: "capital",
   circularClearanceExtraAtZoom15: "clearance_extra_px_z15",
   circularInnerRadiusMeters: "inner_radius_m",
@@ -2424,9 +2438,9 @@ var canonicalFields = {
   class: "class",
   crossing: "crossing",
   circumference: "circumference",
-  classificationConfidence: "classification_confidence",
   confidence: "confidence",
   diameterCrown: "diameter_crown",
+  direction: "direction",
   disputed: "disputed",
   elevation: "ele",
   elevationFeet: "ele_ft",
@@ -2434,7 +2448,6 @@ var canonicalFields = {
   foot: "foot",
   height: "height",
   hide3d: "hide_3d",
-  hasBusiness: "has_business",
   hasParts: "has_parts",
   horse: "horse",
   houseNumber: "housenumber",
@@ -2469,7 +2482,6 @@ var canonicalFields = {
   ref: "ref",
   refLength: "ref_length",
   renderHeight: "render_height",
-  renderMinZoom: "render_min_zoom",
   renderMinHeight: "render_min_height",
   service: "service",
   species: "species",
@@ -2492,6 +2504,7 @@ function openMapTiles(options = {}) {
     delete fields.bathymetryMinDepth;
     delete fields.bathymetrySortKey;
   }
+  if (options.capabilities?.canopy === false) delete layers.canopy;
   if (options.capabilities?.globalLandcover === false) delete layers.globalLandcover;
   if (options.capabilities?.tree === false) delete layers.tree;
   return {
@@ -2509,14 +2522,6 @@ function tileflowWorldV1Schema(options = {}) {
     ...options,
     capabilities: { ...options.capabilities, bathymetry: true, globalLandcover: true },
     fields: {
-      circularClearanceExtraAtZoom15: "clearance_extra_px_z15",
-      circularInnerRadiusMeters: "inner_radius_m",
-      circularKind: "circle_kind",
-      circularOuterRadiusMeters: "outer_radius_m",
-      circularRadiusAtZoom15: "radius_px_z15",
-      circularRadiusMeters: "radius_m",
-      direction: "direction",
-      hasParts: "has_parts",
       shieldKind: "shield_kind",
       shieldLineLengthMeters: "shield_line_length_m",
       shieldNetwork: "shield_network",
@@ -2547,6 +2552,7 @@ function validateTileflowWorldV1Tilejson(tilejson, schema = tileflowWorldV1Schem
   const road = requireTilejsonLayer(layers, schema.layers.road, issues);
   const roadName = requireTilejsonLayer(layers, schema.layers.roadName, issues);
   const roadShield = requireTilejsonLayer(layers, schema.layers.roadShield, issues);
+  const canopy = optionalTilejsonLayer(layers, schema.layers.canopy, issues);
   if (bathymetry2) {
     if (bathymetry2.minzoom !== 0 || bathymetry2.maxzoom !== 9) {
       issues.push(`Tileflow World V1 ${schema.layers.bathymetry} must declare z0-z9.`);
@@ -2719,6 +2725,18 @@ function validateTileflowWorldV1Tilejson(tilejson, schema = tileflowWorldV1Schem
       requireTilejsonField(roadShield, schema.layers.roadShield, field2, ["Number"], issues);
     }
   }
+  if (canopy && schema.layers.canopy) {
+    if (canopy.minzoom !== 14 || canopy.maxzoom !== 15) {
+      issues.push(`Tileflow World V1 ${schema.layers.canopy} must declare native z14-z15.`);
+    }
+    for (const field2 of [
+      schema.fields.canopyRank,
+      schema.fields.canopyClearanceAtZoom15,
+      schema.fields.canopyCoverPercent
+    ]) {
+      requireTilejsonField(canopy, schema.layers.canopy, field2, ["Number"], issues);
+    }
+  }
   return issues;
 }
 function requireTilejsonLayer(layers, id2, issues) {
@@ -2735,6 +2753,13 @@ function requireTilejsonLayer(layers, id2, issues) {
   }
   return matches[0];
 }
+function optionalTilejsonLayer(layers, id2, issues) {
+  if (id2 === void 0) return void 0;
+  const declared = layers.some(
+    (layer) => typeof layer === "object" && layer !== null && layer.id === id2
+  );
+  return declared ? requireTilejsonLayer(layers, id2, issues) : void 0;
+}
 function requireNativeZoom15(layer, layerId, issues) {
   if (layer.minzoom !== 15 || layer.maxzoom !== 15) {
     issues.push(`Tileflow World V1 ${layerId} must declare native z15.`);
@@ -2839,7 +2864,7 @@ function resolveTileflowData(data, options = {}) {
   };
 }
 function isCanonicalOpenMapTilesSchema(schema) {
-  return (schema.semantics?.parkLayer ?? "mixed") === "mixed" && Object.entries(canonicalLayers).every(
+  return schema.semantics.parkLayer === "mixed" && Object.entries(canonicalLayers).every(
     ([key, value]) => schema.layers[key] === value
   ) && Object.entries(canonicalFields).every(
     ([key, value]) => schema.fields[key] === value
@@ -2857,6 +2882,7 @@ function dataIdentity(kind, schema, version, url) {
       capabilities: {
         businessCorridor: Boolean(schema.layers.businessCorridor),
         bathymetry: Boolean(schema.layers.bathymetry),
+        canopy: Boolean(schema.layers.canopy),
         globalLandcover: Boolean(schema.layers.globalLandcover),
         tree: Boolean(schema.layers.tree)
       }
@@ -3013,7 +3039,7 @@ function validateOpenMapTilesSchema(schema) {
       `Tileflow requires OpenMapTiles contract version ${openMapTilesContractVersion}.`
     );
   }
-  const parkLayer = schema.semantics?.parkLayer ?? "mixed";
+  const parkLayer = schema.semantics?.parkLayer;
   if (parkLayer !== "mixed" && parkLayer !== "protected-only") {
     throw new Error("Tileflow OpenMapTiles semantics.parkLayer is invalid.");
   }
@@ -3942,7 +3968,7 @@ function applyTextStyle(layer, style) {
     layout["text-variable-anchor"] = [...style.variableAnchors];
   }
   if (style.justify !== void 0) layout["text-justify"] = style.justify;
-  if (style.allowOverlap !== void 0) layout["text-allow-overlap"] = style.allowOverlap;
+  setOverlap(layout, "text", style);
   if (style.ignorePlacement !== void 0) layout["text-ignore-placement"] = style.ignorePlacement;
   if (style.keepUpright !== void 0) layout["text-keep-upright"] = style.keepUpright;
   if (style.optional !== void 0) layout["text-optional"] = style.optional;
@@ -4012,7 +4038,7 @@ function applyIconStyle(layer, style) {
   if (style.rotationAlignment !== void 0) {
     layout["icon-rotation-alignment"] = style.rotationAlignment;
   }
-  if (style.allowOverlap !== void 0) layout["icon-allow-overlap"] = style.allowOverlap;
+  setOverlap(layout, "icon", style);
   if (style.ignorePlacement !== void 0) layout["icon-ignore-placement"] = style.ignorePlacement;
   if (style.keepUpright !== void 0) layout["icon-keep-upright"] = style.keepUpright;
   if (style.optional !== void 0) layout["icon-optional"] = style.optional;
@@ -4130,6 +4156,18 @@ function withoutRange(value) {
   const { maxZoom: _maxZoom, minZoom: _minZoom, visible: _visible, ...rest } = value;
   return rest;
 }
+function setOverlap(layout, part, style) {
+  if (style.overlap !== void 0) layout[`${part}-overlap`] = style.overlap;
+  else if (style.allowOverlap !== void 0) layout[`${part}-allow-overlap`] = style.allowOverlap;
+  if (layout[`${part}-overlap`] !== void 0) delete layout[`${part}-allow-overlap`];
+}
+function withoutGovernedAllowOverlap(layout) {
+  const result = { ...layout };
+  for (const part of ["icon", "text"]) {
+    if (result[`${part}-overlap`] !== void 0) delete result[`${part}-allow-overlap`];
+  }
+  return result;
+}
 function setPaint(paint, property, value) {
   if (value !== void 0) paint[property] = toMapLibreStyleValue(value);
 }
@@ -4668,15 +4706,6 @@ function buildingColorExpression(context) {
     colors.destination,
     ["==", ["coalesce", ["get", fields.buildingTone], ""], "commercial"],
     colors.commercial,
-    // Defensive compatibility for immutable V8.9 archives. New candidates emit building_tone.
-    [
-      "any",
-      ["==", ["get", fields.hasBusiness], true],
-      ["==", ["get", fields.hasBusiness], 1],
-      ["==", ["get", fields.hasBusiness], "1"],
-      ["==", ["coalesce", ["get", fields.buildingKind], "generic"], "commercial"]
-    ],
-    colors.commercial,
     colors.generic
   ];
 }
@@ -6757,7 +6786,7 @@ function createPoiLayer(options) {
       ["==", ["get", options.categoryField], options.category],
       ["has", options.filterRankField],
       [">=", filterRank, 0],
-      ["<=", filterRank, options.density],
+      ["<=", filterRank, poiRankThreshold(options.density)],
       ["has", options.sizeRankField],
       [">=", sizeRank, 0],
       ["<=", sizeRank, 16]
@@ -6765,6 +6794,9 @@ function createPoiLayer(options) {
     layout: { "symbol-sort-key": poiSortKey(options.filterRankField, options.sizeRankField) }
   };
 }
+function poiRankThreshold(density) {
+  return ["+", ["step", ["zoom"], 0, 16, 1, 17, 2], density];
+}
 function numericPoiField(field2, fallback) {
   return ["to-number", ["get", field2], fallback];
 }
@@ -7704,9 +7736,7 @@ function compileSidewalks(request, context, contributions) {
 }
 function compileRoundabouts(request, context, contributions) {
   const { fields, layers } = context.data.schema;
-  if (!layers.circularFeature || !fields.circularKind || !fields.circularRadiusAtZoom15 || !fields.circularRadiusMeters || !fields.circularOuterRadiusMeters || !fields.circularInnerRadiusMeters) {
-    return;
-  }
+  if (!layers.circularFeature) return;
   const circularFields = {
     circularInnerRadiusMeters: fields.circularInnerRadiusMeters,
     circularOuterRadiusMeters: fields.circularOuterRadiusMeters,
@@ -7780,7 +7810,7 @@ function compileRoundabouts(request, context, contributions) {
 }
 function compileCrossings(request, context, contributions) {
   const { fields, layers } = context.data.schema;
-  if (!request || !layers.streetFurniture || !fields.direction) return;
+  if (!request || !layers.streetFurniture) return;
   const config = mergeTileflowDesign(
     {
       allowOverlap: true,
@@ -7846,7 +7876,7 @@ function circularRoadInnerRadius(fields, casing) {
       ["/", values.innerRadiusMeters, values.radiusMeters]
     ];
     const baseWidth = circularRoadBaseWidth(fields.class);
-    const fallbackWidth = level === 15 ? baseWidth : ["*", baseWidth, circularRoadLegacyScale(level)];
+    const fallbackWidth = level === 15 ? baseWidth : ["*", baseWidth, circularRoadFallbackScale(level)];
     const fallbackInnerRadius = ["-", centerlineRadius, ["/", fallbackWidth, 2]];
     const innerRadius = ["case", values.hasPhysicalRadii, physicalInnerRadius, fallbackInnerRadius];
     stops.push(level, [
@@ -7868,7 +7898,7 @@ function circularRoadStrokeWidth(fields, casing) {
       centerlineRadius,
       ["/", ["-", values.outerRadiusMeters, values.innerRadiusMeters], values.radiusMeters]
     ];
-    const fallbackWidth = level === 15 ? baseWidth : ["*", baseWidth, circularRoadLegacyScale(level)];
+    const fallbackWidth = level === 15 ? baseWidth : ["*", baseWidth, circularRoadFallbackScale(level)];
     stops.push(level, [
       "case",
       values.hasPhysicalRadii,
@@ -7917,7 +7947,7 @@ function circularRoadValues(fields) {
     radiusMeters
   };
 }
-function circularRoadLegacyScale(level) {
+function circularRoadFallbackScale(level) {
   const interpolationBase = 1.35;
   const progress = (interpolationBase ** (level - 15) - 1) / (interpolationBase ** (22 - 15) - 1);
   return 1 + progress * 1.2;
@@ -8524,7 +8554,7 @@ function cloneJson16(value) {
 // src/modules/vegetation/compiler.ts
 init_values();
 function compileVegetation(request, context) {
-  const minZoom = request?.flat?.minZoom ?? request?.minZoom ?? 16;
+  const minZoom = request?.flat?.minZoom ?? 16;
   const mode = request?.mode ?? "3d";
   const config = mergeTileflowDesign(
     {
@@ -8544,7 +8574,6 @@ function compileVegetation(request, context) {
         strokeOpacity: 0.55,
         strokeWidth: 0.8
       },
-      minZoom,
       mode,
       threeDimensional: {
         barkColor: context.colors.vegetation.tree.bark,
@@ -11364,10 +11393,10 @@ function applyRefinement(previous, refinement) {
     style: {
       ...previous.style,
       ...patch.style?.placement === void 0 ? {} : {
-        placement: {
+        placement: withoutGovernedAllowOverlap({
           ...previous.style.placement ?? {},
           ...patch.style.placement
-        }
+        })
       },
       ...patch.style?.appearance === void 0 ? {} : {
         appearance: {
@@ -12288,6 +12317,7 @@ var textStyleSchema = z6.object({
   offset: numberOffsetValueSchema.optional(),
   optional: z6.boolean().optional(),
   opacity: numberValueSchema.optional(),
+  overlap: z6.enum(["always", "cooperative", "never"]).optional(),
   padding: numberValueSchema.optional(),
   pitchAlignment: z6.enum(["auto", "map", "viewport"]).optional(),
   radialOffset: numberValueSchema.optional(),
@@ -12333,6 +12363,7 @@ var iconStyleSchema = z6.object({
   opacity: numberValueSchema.optional(),
   keepUpright: z6.boolean().optional(),
   optional: z6.boolean().optional(),
+  overlap: z6.enum(["always", "cooperative", "never"]).optional(),
   padding: numberValueSchema.optional(),
   pitchAlignment: z6.enum(["auto", "map", "viewport"]).optional(),
   rotate: numberValueSchema.optional(),
@@ -12905,7 +12936,6 @@ var modulesSchema = z6.object({
     type: z6.literal("vegetation"),
     enabled: z6.boolean().optional(),
     flat: circleStyleSchema.optional(),
-    minZoom: zoomNumberSchema.optional(),
     mode: z6.enum(["3d", "flat"]).optional(),
     renderStack: renderStackSchema.optional(),
     threeDimensional: z6.object({
@@ -12941,6 +12971,7 @@ var layerBindingsSchema = z6.object({
   building: z6.string().trim().min(1),
   bathymetry: z6.string().trim().min(1).optional(),
   businessCorridor: z6.string().trim().min(1).optional(),
+  canopy: z6.string().trim().min(1).optional(),
   circularFeature: z6.string().trim().min(1).optional(),
   globalLandcover: z6.string().trim().min(1).optional(),
   houseNumber: z6.string().trim().min(1),
@@ -12968,34 +12999,34 @@ var fieldBindingsSchema = z6.object({
   bathymetryMinDepth: z6.string().trim().min(1).optional(),
   bathymetrySortKey: z6.string().trim().min(1).optional(),
   brunnel: z6.string().trim().min(1),
-  buildingKind: z6.string().trim().min(1),
   buildingTone: z6.string().trim().min(1),
+  canopyClearanceAtZoom15: z6.string().trim().min(1),
+  canopyCoverPercent: z6.string().trim().min(1),
+  canopyRank: z6.string().trim().min(1),
   capital: z6.string().trim().min(1),
-  circularClearanceExtraAtZoom15: z6.string().trim().min(1).optional(),
-  circularKind: z6.string().trim().min(1).optional(),
-  circularRadiusAtZoom15: z6.string().trim().min(1).optional(),
-  circularRadiusMeters: z6.string().trim().min(1).optional(),
-  circularInnerRadiusMeters: z6.string().trim().min(1).optional(),
-  circularOuterRadiusMeters: z6.string().trim().min(1).optional(),
+  circularClearanceExtraAtZoom15: z6.string().trim().min(1),
+  circularKind: z6.string().trim().min(1),
+  circularRadiusAtZoom15: z6.string().trim().min(1),
+  circularRadiusMeters: z6.string().trim().min(1),
+  circularInnerRadiusMeters: z6.string().trim().min(1),
+  circularOuterRadiusMeters: z6.string().trim().min(1),
   class: z6.string().trim().min(1),
   crossing: z6.string().trim().min(1),
-  classificationConfidence: z6.string().trim().min(1),
   confidence: z6.string().trim().min(1),
   circumference: z6.string().trim().min(1),
   diameterCrown: z6.string().trim().min(1),
   disputed: z6.string().trim().min(1),
-  direction: z6.string().trim().min(1).optional(),
+  direction: z6.string().trim().min(1),
   elevation: z6.string().trim().min(1),
   elevationFeet: z6.string().trim().min(1),
   expressway: z6.string().trim().min(1),
   foot: z6.string().trim().min(1),
   height: z6.string().trim().min(1),
-  hasBusiness: z6.string().trim().min(1),
-  hasParts: z6.string().trim().min(1).optional(),
+  hasParts: z6.string().trim().min(1),
   hide3d: z6.string().trim().min(1),
   horse: z6.string().trim().min(1),
   houseNumber: z6.string().trim().min(1),
-  importanceTier: z6.string().trim().min(1).optional(),
+  importanceTier: z6.string().trim().min(1),
   iata: z6.string().trim().min(1),
   icao: z6.string().trim().min(1),
   indoor: z6.string().trim().min(1),
@@ -13026,7 +13057,6 @@ var fieldBindingsSchema = z6.object({
   ref: z6.string().trim().min(1),
   refLength: z6.string().trim().min(1),
   renderHeight: z6.string().trim().min(1),
-  renderMinZoom: z6.string().trim().min(1),
   renderMinHeight: z6.string().trim().min(1),
   shieldKind: z6.string().trim().min(1).optional(),
   shieldLineLengthMeters: z6.string().trim().min(1).optional(),
@@ -13052,6 +13082,7 @@ var openMapTilesSchema = z6.object({
     capabilities: schema.layers === void 0 ? void 0 : {
       businessCorridor: schema.layers.businessCorridor !== void 0,
       bathymetry: schema.layers.bathymetry !== void 0,
+      canopy: schema.layers.canopy !== void 0,
       globalLandcover: schema.layers.globalLandcover !== void 0,
       tree: schema.layers.tree !== void 0
     },
@@ -16340,8 +16371,8 @@ function validateMapScenes(map, mapId) {
       );
     }
     const result = tileflowCaptureSceneSchema.safeParse({ ...input, map: mapId });
-    if (!result.success) {
-      const issue = result.error.issues[0];
+    const issue = result.success ? tileflowCaptureSceneFitIssue(result.data) : result.error.issues[0];
+    if (!result.success || issue) {
       throw new Error(
         `Invalid Tileflow map "${map.id}". scenes.${sceneName}${issue?.path.length ? `.${issue.path.join(".")}` : ""}: ${issue?.message ?? "Invalid scene"}`
       );

package/dist/{manifest-types-CTT2eLbp.d.ts → manifest-types-E7m23eXL.d.ts}

@@ -125,6 +125,11 @@ type TileflowTextJustify = 'auto' | 'center' | 'left' | 'right';
 type TileflowIconAnchor = TileflowTextAnchor;
 type TileflowAlignment = 'auto' | 'map' | 'viewport';
 type TileflowIconTextFit = 'both' | 'height' | 'none' | 'width';
+/**
+ * How a symbol part treats collisions with symbols placed before it. `never` hides it, `always`
+ * shows it, and `cooperative` shows it unless the earlier symbol was placed with `never`.
+ */
+type TileflowSymbolOverlap = 'always' | 'cooperative' | 'never';
 /** Visibility and zoom bounds shared by every visual primitive. */
 type TileflowLayerRange = {
     maxZoom?: number;
@@ -221,6 +226,12 @@ type TileflowTextLayout = {
     maxWidth?: TileflowNumberStyleValue;
     offset?: TileflowNumberOffsetStyleValue;
     optional?: boolean;
+    /**
+     * Overlap mode. Takes precedence over `allowOverlap`, so the compiled layer carries only the mode.
+     * Native artifacts, whose renderer has no overlap modes, use `allowOverlap: false` for `never`
+     * and `true` otherwise.
+     */
+    overlap?: TileflowSymbolOverlap;
     padding?: TileflowNumberStyleValue;
     pitchAlignment?: TileflowAlignment;
     radialOffset?: TileflowNumberStyleValue;
@@ -246,6 +257,12 @@ type TileflowIconLayout = {
     keepUpright?: boolean;
     offset?: TileflowNumberOffsetStyleValue;
     optional?: boolean;
+    /**
+     * Overlap mode. Takes precedence over `allowOverlap`, so the compiled layer carries only the mode.
+     * Native artifacts, whose renderer has no overlap modes, use `allowOverlap: false` for `never`
+     * and `true` otherwise.
+     */
+    overlap?: TileflowSymbolOverlap;
     padding?: TileflowNumberStyleValue;
     pitchAlignment?: TileflowAlignment;
     rotate?: TileflowNumberStyleValue;
@@ -787,4 +804,4 @@ type TileflowRuntimeManifest = {
     version: typeof tileflowRuntimeManifestVersion;
 };
 
-export { type TileflowManifestFetchOptions as $, type TileflowAreaStyle as A, type TileflowBackgroundPaint as B, type TileflowCirclePaint as C, type TileflowColor as D, type TileflowColorStyleValue as E, type TileflowExtrusionPaint as F, type TileflowFillPaint as G, type TileflowIconAnchor as H, type TileflowIconLayout as I, type TileflowIconPaint as J, type TileflowIconStyle as K, type TileflowIconTextFit as L, type MapLibreStyle as M, type TileflowImageStyleValue as N, type TileflowLabelDetail as O, type TileflowLabelLanguage as P, type TileflowLabelStyles as Q, type TileflowLayerRange as R, type TileflowLight as S, type TileflowRuntimeManifest as T, type TileflowLineCap as U, type ValidationMessage as V, type TileflowLineHatchStyle as W, type TileflowLineJoin as X, type TileflowLineLayout as Y, type TileflowLinePaint as Z, type TileflowLineStackStyle as _, type TileflowRuntimeColorScheme as a, type TileflowTextBackground as a$, type TileflowManifestLoadOptions as a0, type TileflowMapMode as a1, type TileflowMapModeOptions as a2, type TileflowMarkerSymbolStyle as a3, type TileflowMountainBikeScale as a4, type TileflowNumberInsetsStyleValue as a5, type TileflowNumberStyleValue as a6, type TileflowPlaceLabelClass as a7, type TileflowPoiCategory as a8, type TileflowPoiCategoryStyle as a9, type TileflowRoadWeight as aA, type TileflowRuntimeCenterLike as aB, type TileflowRuntimeManifestMap as aC, type TileflowRuntimeSource as aD, type TileflowRuntimeSourceValidation as aE, type TileflowRuntimeStyle as aF, type TileflowRuntimeStyleOptions as aG, type TileflowRuntimeViewOptions as aH, type TileflowSessionController as aI, type TileflowSessionGrantResponse as aJ, type TileflowStringStyleValue as aK, type TileflowStructuralStyleValue as aL, type TileflowStyleFontFace as aM, type TileflowStyleValue as aN, type TileflowSymbolPlacement as aO, type TileflowSymbolPlacementStyle as aP, type TileflowSymbolZOrder as aQ, type TileflowTerrain as aR, type TileflowTerrainConfig as aS, type TileflowTerrainContourLabelStyle as aT, type TileflowTerrainContourLineStyle as aU, type TileflowTerrainContoursConfig as aV, type TileflowTerrainEncoding as aW, type TileflowTerrainHillshadeStyle as aX, type TileflowTerrainLayerRange as aY, type TileflowTerrainMode as aZ, type TileflowTextAnchor as a_, type TileflowPoiColorMode as aa, type TileflowPoiDensity as ab, type TileflowPriorityOrder as ac, type TileflowProjection as ad, type TileflowResolvedRuntimeTheme as ae, type TileflowRoadAreaStyle as af, type TileflowRoadClass as ag, type TileflowRoadClassStyle as ah, type TileflowRoadCrossingStyle as ai, type TileflowRoadDetail as aj, type TileflowRoadExtras as ak, type TileflowRoadHierarchy as al, type TileflowRoadLabelDetail as am, type TileflowRoadLayerStyle as an, type TileflowRoadModifier as ao, type TileflowRoadOutline as ap, type TileflowRoadRestriction as aq, type TileflowRoadRoundaboutStyle as ar, type TileflowRoadServiceType as as, type TileflowRoadShieldDetail as at, type TileflowRoadShieldStyles as au, type TileflowRoadSidewalkStyle as av, type TileflowRoadStructure as aw, type TileflowRoadTreatmentLayerStyle as ax, type TileflowRoadTreatmentLineStyle as ay, type TileflowRoadTreatmentStyle as az, type TileflowRuntimeManifestMapEntry as b, type TileflowTextJustify as b0, type TileflowTextLayout as b1, type TileflowTextPaint as b2, type TileflowTextStyle as b3, type TileflowThemeBlendSelection as b4, type TileflowThemeColorAlpha as b5, type TileflowThemeColorMix as b6, type TileflowThemeColorValue as b7, type TileflowThemeFontValue as b8, type TileflowThemeImageValue as b9, resolveTileflowAnalyticsRequestUrl as bA, resolveTileflowManifestMap as bB, resolveTileflowMapMode as bC, resolveTileflowRuntimeStyle as bD, resolveTileflowRuntimeTheme as bE, resolveTileflowRuntimeThemeBlend as bF, resolveTileflowRuntimeView as bG, resolveTileflowStaticImageUrl as bH, shouldLoadTileflowManifest as bI, startTileflowSession as bJ, tileflowPoiCategories as bK, tileflowStyleFontFaceLimits as bL, tileflowStyleFontFacesMetadataKey as bM, tileflowThemeBlendLimits as bN, tileflowThemeTokenCategories as bO, token as bP, validateTileflowRuntimeSource as bQ, validateTileflowThemeBlendSelection as bR, validateTileflowThemeSelection as bS, zoom as bT, type TileflowTypographyStyle as bU, type ResolvedTileflowTypography as bV, normalizeTileflowSurfaceId as bW, type TileflowThemeNumberValue as ba, type TileflowThemeSelection as bb, type TileflowThemeTokenCategory as bc, type TileflowThemeValue as bd, type TileflowViewConfig as be, type TileflowWaterLabelClass as bf, type TileflowZoomInterpolation as bg, type TileflowZoomValue as bh, type ValidationResult as bi, assertValidTileflowRuntimeSource as bj, clearTileflowManifestCache as bk, color as bl, createTileflowSessionController as bm, createTileflowSessionId as bn, defaultTileflowManifestUrl as bo, defaultTileflowRuntimeView as bp, fixed as bq, getTileflowAnalyticsApiUrl as br, getTileflowStyleFontFaces as bs, inferTileflowAnalyticsFromStyleUrl as bt, loadTileflowManifest as bu, mergeTileflowAnalytics as bv, nearestTileflowBlendTheme as bw, normalizeTileflowRuntimeCenter as bx, normalizeTileflowStaticImageSize as by, normalizeTileflowUrl as bz, type TileflowRuntimeManifestTheme as c, type TileflowRuntimeSystemThemes as d, tileflowRuntimeManifestVersion as e, type TileflowExpression as f, type TileflowFixedValue as g, type TileflowThemeTokenReference as h, type TileflowThemeColorOperation as i, type TileflowBackgroundStyle as j, type TileflowCircleStyle as k, type TileflowExtrusionStyle as l, type TileflowFillStyle as m, type TileflowLineStyle as n, type TileflowSymbolStyle as o, type TileflowRoadsModuleOptions as p, type TileflowRoadsModuleConfig as q, type TileflowLabelsModuleOptions as r, type TileflowLabelsModuleConfig as s, tileflowRuntimeManifestLimits as t, type TileflowPoiModuleOptions as u, type TileflowPoiModuleConfig as v, type MapLibreSprite as w, type TileflowAerodromeCodeDetail as x, type TileflowAlignment as y, type TileflowAnalytics as z };
+export { type TileflowManifestFetchOptions as $, type TileflowAreaStyle as A, type TileflowBackgroundPaint as B, type TileflowCirclePaint as C, type TileflowColor as D, type TileflowColorStyleValue as E, type TileflowExtrusionPaint as F, type TileflowFillPaint as G, type TileflowIconAnchor as H, type TileflowIconLayout as I, type TileflowIconPaint as J, type TileflowIconStyle as K, type TileflowIconTextFit as L, type MapLibreStyle as M, type TileflowImageStyleValue as N, type TileflowLabelDetail as O, type TileflowLabelLanguage as P, type TileflowLabelStyles as Q, type TileflowLayerRange as R, type TileflowLight as S, type TileflowRuntimeManifest as T, type TileflowLineCap as U, type ValidationMessage as V, type TileflowLineHatchStyle as W, type TileflowLineJoin as X, type TileflowLineLayout as Y, type TileflowLinePaint as Z, type TileflowLineStackStyle as _, type TileflowRuntimeColorScheme as a, type TileflowTextAnchor as a$, type TileflowManifestLoadOptions as a0, type TileflowMapMode as a1, type TileflowMapModeOptions as a2, type TileflowMarkerSymbolStyle as a3, type TileflowMountainBikeScale as a4, type TileflowNumberInsetsStyleValue as a5, type TileflowNumberStyleValue as a6, type TileflowPlaceLabelClass as a7, type TileflowPoiCategory as a8, type TileflowPoiCategoryStyle as a9, type TileflowRoadWeight as aA, type TileflowRuntimeCenterLike as aB, type TileflowRuntimeManifestMap as aC, type TileflowRuntimeSource as aD, type TileflowRuntimeSourceValidation as aE, type TileflowRuntimeStyle as aF, type TileflowRuntimeStyleOptions as aG, type TileflowRuntimeViewOptions as aH, type TileflowSessionController as aI, type TileflowSessionGrantResponse as aJ, type TileflowStringStyleValue as aK, type TileflowStructuralStyleValue as aL, type TileflowStyleFontFace as aM, type TileflowStyleValue as aN, type TileflowSymbolOverlap as aO, type TileflowSymbolPlacement as aP, type TileflowSymbolPlacementStyle as aQ, type TileflowSymbolZOrder as aR, type TileflowTerrain as aS, type TileflowTerrainConfig as aT, type TileflowTerrainContourLabelStyle as aU, type TileflowTerrainContourLineStyle as aV, type TileflowTerrainContoursConfig as aW, type TileflowTerrainEncoding as aX, type TileflowTerrainHillshadeStyle as aY, type TileflowTerrainLayerRange as aZ, type TileflowTerrainMode as a_, type TileflowPoiColorMode as aa, type TileflowPoiDensity as ab, type TileflowPriorityOrder as ac, type TileflowProjection as ad, type TileflowResolvedRuntimeTheme as ae, type TileflowRoadAreaStyle as af, type TileflowRoadClass as ag, type TileflowRoadClassStyle as ah, type TileflowRoadCrossingStyle as ai, type TileflowRoadDetail as aj, type TileflowRoadExtras as ak, type TileflowRoadHierarchy as al, type TileflowRoadLabelDetail as am, type TileflowRoadLayerStyle as an, type TileflowRoadModifier as ao, type TileflowRoadOutline as ap, type TileflowRoadRestriction as aq, type TileflowRoadRoundaboutStyle as ar, type TileflowRoadServiceType as as, type TileflowRoadShieldDetail as at, type TileflowRoadShieldStyles as au, type TileflowRoadSidewalkStyle as av, type TileflowRoadStructure as aw, type TileflowRoadTreatmentLayerStyle as ax, type TileflowRoadTreatmentLineStyle as ay, type TileflowRoadTreatmentStyle as az, type TileflowRuntimeManifestMapEntry as b, type TileflowTextBackground as b0, type TileflowTextJustify as b1, type TileflowTextLayout as b2, type TileflowTextPaint as b3, type TileflowTextStyle as b4, type TileflowThemeBlendSelection as b5, type TileflowThemeColorAlpha as b6, type TileflowThemeColorMix as b7, type TileflowThemeColorValue as b8, type TileflowThemeFontValue as b9, normalizeTileflowUrl as bA, resolveTileflowAnalyticsRequestUrl as bB, resolveTileflowManifestMap as bC, resolveTileflowMapMode as bD, resolveTileflowRuntimeStyle as bE, resolveTileflowRuntimeTheme as bF, resolveTileflowRuntimeThemeBlend as bG, resolveTileflowRuntimeView as bH, resolveTileflowStaticImageUrl as bI, shouldLoadTileflowManifest as bJ, startTileflowSession as bK, tileflowPoiCategories as bL, tileflowStyleFontFaceLimits as bM, tileflowStyleFontFacesMetadataKey as bN, tileflowThemeBlendLimits as bO, tileflowThemeTokenCategories as bP, token as bQ, validateTileflowRuntimeSource as bR, validateTileflowThemeBlendSelection as bS, validateTileflowThemeSelection as bT, zoom as bU, type TileflowTypographyStyle as bV, type ResolvedTileflowTypography as bW, normalizeTileflowSurfaceId as bX, type TileflowThemeImageValue as ba, type TileflowThemeNumberValue as bb, type TileflowThemeSelection as bc, type TileflowThemeTokenCategory as bd, type TileflowThemeValue as be, type TileflowViewConfig as bf, type TileflowWaterLabelClass as bg, type TileflowZoomInterpolation as bh, type TileflowZoomValue as bi, type ValidationResult as bj, assertValidTileflowRuntimeSource as bk, clearTileflowManifestCache as bl, color as bm, createTileflowSessionController as bn, createTileflowSessionId as bo, defaultTileflowManifestUrl as bp, defaultTileflowRuntimeView as bq, fixed as br, getTileflowAnalyticsApiUrl as bs, getTileflowStyleFontFaces as bt, inferTileflowAnalyticsFromStyleUrl as bu, loadTileflowManifest as bv, mergeTileflowAnalytics as bw, nearestTileflowBlendTheme as bx, normalizeTileflowRuntimeCenter as by, normalizeTileflowStaticImageSize as bz, type TileflowRuntimeManifestTheme as c, type TileflowRuntimeSystemThemes as d, tileflowRuntimeManifestVersion as e, type TileflowExpression as f, type TileflowFixedValue as g, type TileflowThemeTokenReference as h, type TileflowThemeColorOperation as i, type TileflowBackgroundStyle as j, type TileflowCircleStyle as k, type TileflowExtrusionStyle as l, type TileflowFillStyle as m, type TileflowLineStyle as n, type TileflowSymbolStyle as o, type TileflowRoadsModuleOptions as p, type TileflowRoadsModuleConfig as q, type TileflowLabelsModuleOptions as r, type TileflowLabelsModuleConfig as s, tileflowRuntimeManifestLimits as t, type TileflowPoiModuleOptions as u, type TileflowPoiModuleConfig as v, type MapLibreSprite as w, type TileflowAerodromeCodeDetail as x, type TileflowAlignment as y, type TileflowAnalytics as z };

package/dist/manifest.d.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { T as TileflowRuntimeManifest } from './manifest-types-CTT2eLbp.js';
-export { a as TileflowRuntimeColorScheme, b as TileflowRuntimeManifestMapEntry, c as TileflowRuntimeManifestTheme, d as TileflowRuntimeSystemThemes, t as tileflowRuntimeManifestLimits, e as tileflowRuntimeManifestVersion } from './manifest-types-CTT2eLbp.js';
+import { T as TileflowRuntimeManifest } from './manifest-types-E7m23eXL.js';
+export { a as TileflowRuntimeColorScheme, b as TileflowRuntimeManifestMapEntry, c as TileflowRuntimeManifestTheme, d as TileflowRuntimeSystemThemes, t as tileflowRuntimeManifestLimits, e as tileflowRuntimeManifestVersion } from './manifest-types-E7m23eXL.js';
 
 declare const tileflowRuntimeManifestSchema: z.ZodType<TileflowRuntimeManifest>;
 declare function parseTileflowRuntimeManifest(input: unknown): TileflowRuntimeManifest;

package/dist/native-profile.d.ts

@@ -62,7 +62,6 @@ declare const tileflowNativeProfileLimits: Readonly<{
 }>;
 /** Fixed output budget for a prepared native-v1 style, never a raw input allowance. */
 declare const tileflowNativePreparedStyleLimits: Readonly<{
-    maximumNodes: 540000;
     maximumStyleBytes: number;
     maximumDepth: 64;
     maximumSources: 128;
@@ -70,6 +69,7 @@ declare const tileflowNativePreparedStyleLimits: Readonly<{
     maximumIssues: 32;
     maximumFontFaces: 16;
     maximumFontBytes: number;
+    maximumNodes: 540000;
 }>;
 
 declare const tileflowNativeBuildRecordFileName = "native-build.json";
@@ -81,17 +81,24 @@ declare const tileflowNativeStyleTransformationSchema: z.ZodLazy<z.core.$ZodObje
     inputLayers: z.ZodNumber;
     outputLayers: z.ZodNumber;
     projection: z.ZodEnum<{
-        none: "none";
-        "mercator-to-implicit": "mercator-to-implicit";
         "globe-to-mercator": "globe-to-mercator";
+        "mercator-to-implicit": "mercator-to-implicit";
+        none: "none";
     }>;
     layers: z.ZodArray<z.ZodLazy<z.core.$ZodObject<{
         inputLayer: z.ZodNumber;
         outputStart: z.ZodNumber;
         outputCount: z.ZodNumber;
         properties: z.ZodArray<z.ZodEnum<{
-            "line-dasharray": "line-dasharray";
             "line-cap": "line-cap";
+            "line-dasharray": "line-dasharray";
+        }>>;
+    }, z.core.$strict>>>;
+    symbolOverlap: z.ZodArray<z.ZodLazy<z.core.$ZodObject<{
+        inputLayer: z.ZodNumber;
+        properties: z.ZodArray<z.ZodEnum<{
+            "icon-overlap": "icon-overlap";
+            "text-overlap": "text-overlap";
         }>>;
     }, z.core.$strict>>>;
 }, z.core.$strict>>;
@@ -116,17 +123,24 @@ declare const tileflowNativeBuildRecordSchema: z.ZodLazy<z.core.$ZodObject<{
         inputLayers: z.ZodNumber;
         outputLayers: z.ZodNumber;
         projection: z.ZodEnum<{
-            none: "none";
-            "mercator-to-implicit": "mercator-to-implicit";
             "globe-to-mercator": "globe-to-mercator";
+            "mercator-to-implicit": "mercator-to-implicit";
+            none: "none";
         }>;
         layers: z.ZodArray<z.ZodLazy<z.core.$ZodObject<{
             inputLayer: z.ZodNumber;
             outputStart: z.ZodNumber;
             outputCount: z.ZodNumber;
             properties: z.ZodArray<z.ZodEnum<{
-                "line-dasharray": "line-dasharray";
                 "line-cap": "line-cap";
+                "line-dasharray": "line-dasharray";
+            }>>;
+        }, z.core.$strict>>>;
+        symbolOverlap: z.ZodArray<z.ZodLazy<z.core.$ZodObject<{
+            inputLayer: z.ZodNumber;
+            properties: z.ZodArray<z.ZodEnum<{
+                "icon-overlap": "icon-overlap";
+                "text-overlap": "text-overlap";
             }>>;
         }, z.core.$strict>>>;
     }, z.core.$strict>>>;
@@ -135,21 +149,21 @@ type TileflowNativeBuildRecord = z.infer<typeof tileflowNativeBuildRecordSchema>
 declare function createTileflowNativeBuildRecord(buildManifestSha256: string, transformations?: readonly TileflowNativeStyleTransformation[]): TileflowNativeBuildRecord;
 
 declare const tileflowNativeDiagnosticCodeSchema: z.ZodEnum<{
-    NATIVE_UNSUPPORTED_STYLE: "NATIVE_UNSUPPORTED_STYLE";
-    NATIVE_UNSUPPORTED_SOURCE: "NATIVE_UNSUPPORTED_SOURCE";
     NATIVE_FONT_UNAVAILABLE: "NATIVE_FONT_UNAVAILABLE";
     NATIVE_MANIFEST_REQUIRED: "NATIVE_MANIFEST_REQUIRED";
     NATIVE_RENDERER_UNSUPPORTED: "NATIVE_RENDERER_UNSUPPORTED";
+    NATIVE_UNSUPPORTED_SOURCE: "NATIVE_UNSUPPORTED_SOURCE";
+    NATIVE_UNSUPPORTED_STYLE: "NATIVE_UNSUPPORTED_STYLE";
 }>;
 type TileflowNativeDiagnosticCode = z.infer<typeof tileflowNativeDiagnosticCodeSchema>;
 /** Uses the command diagnostic fields; renderer/profile are bounded additional context. */
 declare const tileflowNativeDiagnosticSchema: z.ZodLazy<z.core.$ZodObject<{
     code: z.ZodEnum<{
-        NATIVE_UNSUPPORTED_STYLE: "NATIVE_UNSUPPORTED_STYLE";
-        NATIVE_UNSUPPORTED_SOURCE: "NATIVE_UNSUPPORTED_SOURCE";
         NATIVE_FONT_UNAVAILABLE: "NATIVE_FONT_UNAVAILABLE";
         NATIVE_MANIFEST_REQUIRED: "NATIVE_MANIFEST_REQUIRED";
         NATIVE_RENDERER_UNSUPPORTED: "NATIVE_RENDERER_UNSUPPORTED";
+        NATIVE_UNSUPPORTED_SOURCE: "NATIVE_UNSUPPORTED_SOURCE";
+        NATIVE_UNSUPPORTED_STYLE: "NATIVE_UNSUPPORTED_STYLE";
     }>;
     phase: z.ZodLiteral<"native-compatibility">;
     severity: z.ZodLiteral<"error">;

package/dist/native-profile.js

@@ -8809,6 +8809,13 @@ var layerTransformationSchema = strictNativeObject({
     "Expected unique, ordered properties"
   )
 });
+var symbolOverlapTransformationSchema = strictNativeObject({
+  inputLayer: layerCountSchema,
+  properties: z4.array(z4.enum(["icon-overlap", "text-overlap"])).min(1).max(2).refine(
+    (properties2) => properties2.length === 1 || properties2[0] === "icon-overlap" && properties2[1] === "text-overlap",
+    "Expected unique, ordered properties"
+  )
+});
 var tileflowNativeStyleTransformationSchema = strictNativeObject({
   map: tileflowPortableIdSchema,
   theme: tileflowThemeNameSchema,
@@ -8817,7 +8824,8 @@ var tileflowNativeStyleTransformationSchema = strictNativeObject({
   inputLayers: layerCountSchema,
   outputLayers: layerCountSchema,
   projection: z4.enum(["none", "mercator-to-implicit", "globe-to-mercator"]),
-  layers: z4.array(layerTransformationSchema).max(tileflowNativeProfileLimits.maximumLayers)
+  layers: z4.array(layerTransformationSchema).max(tileflowNativeProfileLimits.maximumLayers),
+  symbolOverlap: z4.array(symbolOverlapTransformationSchema).max(tileflowNativeProfileLimits.maximumLayers)
 }).superRefine((style, context) => {
   let previous = -1;
   let added = 0;
@@ -8839,6 +8847,18 @@ var tileflowNativeStyleTransformationSchema = strictNativeObject({
       message: "Layer counts do not match transformation spans"
     });
   }
+  const partitioned = new Set(style.layers.map(({ inputLayer }) => inputLayer));
+  previous = -1;
+  for (const [index, layer] of style.symbolOverlap.entries()) {
+    if (layer.inputLayer <= previous || layer.inputLayer >= style.inputLayers || partitioned.has(layer.inputLayer)) {
+      context.addIssue({
+        code: "custom",
+        path: ["symbolOverlap", index],
+        message: "Invalid symbol overlap layer"
+      });
+    }
+    previous = layer.inputLayer;
+  }
 });
 var tileflowNativeBuildRecordSchema = strictNativeObject({
   schemaVersion: z4.literal(2),

package/dist/runtime.d.ts

@@ -1 +1 @@
-export { z as TileflowAnalytics, $ as TileflowManifestFetchOptions, a0 as TileflowManifestLoadOptions, a1 as TileflowMapMode, a2 as TileflowMapModeOptions, ae as TileflowResolvedRuntimeTheme, aB as TileflowRuntimeCenterLike, a as TileflowRuntimeColorScheme, T as TileflowRuntimeManifest, aC as TileflowRuntimeManifestMap, b as TileflowRuntimeManifestMapEntry, c as TileflowRuntimeManifestTheme, aD as TileflowRuntimeSource, aE as TileflowRuntimeSourceValidation, aF as TileflowRuntimeStyle, aG as TileflowRuntimeStyleOptions, d as TileflowRuntimeSystemThemes, aH as TileflowRuntimeViewOptions, aI as TileflowSessionController, aJ as TileflowSessionGrantResponse, aM as TileflowStyleFontFace, b4 as TileflowThemeBlendSelection, bb as TileflowThemeSelection, bj as assertValidTileflowRuntimeSource, bk as clearTileflowManifestCache, bm as createTileflowSessionController, bn as createTileflowSessionId, bo as defaultTileflowManifestUrl, bp as defaultTileflowRuntimeView, br as getTileflowAnalyticsApiUrl, bs as getTileflowStyleFontFaces, bt as inferTileflowAnalyticsFromStyleUrl, bu as loadTileflowManifest, bv as mergeTileflowAnalytics, bw as nearestTileflowBlendTheme, bx as normalizeTileflowRuntimeCenter, by as normalizeTileflowStaticImageSize, bW as normalizeTileflowSurfaceId, bz as normalizeTileflowUrl, bA as resolveTileflowAnalyticsRequestUrl, bB as resolveTileflowManifestMap, bC as resolveTileflowMapMode, bD as resolveTileflowRuntimeStyle, bE as resolveTileflowRuntimeTheme, bF as resolveTileflowRuntimeThemeBlend, bG as resolveTileflowRuntimeView, bH as resolveTileflowStaticImageUrl, bI as shouldLoadTileflowManifest, bJ as startTileflowSession, bL as tileflowStyleFontFaceLimits, bM as tileflowStyleFontFacesMetadataKey, bN as tileflowThemeBlendLimits, bQ as validateTileflowRuntimeSource, bR as validateTileflowThemeBlendSelection, bS as validateTileflowThemeSelection } from './manifest-types-CTT2eLbp.js';
+export { z as TileflowAnalytics, $ as TileflowManifestFetchOptions, a0 as TileflowManifestLoadOptions, a1 as TileflowMapMode, a2 as TileflowMapModeOptions, ae as TileflowResolvedRuntimeTheme, aB as TileflowRuntimeCenterLike, a as TileflowRuntimeColorScheme, T as TileflowRuntimeManifest, aC as TileflowRuntimeManifestMap, b as TileflowRuntimeManifestMapEntry, c as TileflowRuntimeManifestTheme, aD as TileflowRuntimeSource, aE as TileflowRuntimeSourceValidation, aF as TileflowRuntimeStyle, aG as TileflowRuntimeStyleOptions, d as TileflowRuntimeSystemThemes, aH as TileflowRuntimeViewOptions, aI as TileflowSessionController, aJ as TileflowSessionGrantResponse, aM as TileflowStyleFontFace, b5 as TileflowThemeBlendSelection, bc as TileflowThemeSelection, bk as assertValidTileflowRuntimeSource, bl as clearTileflowManifestCache, bn as createTileflowSessionController, bo as createTileflowSessionId, bp as defaultTileflowManifestUrl, bq as defaultTileflowRuntimeView, bs as getTileflowAnalyticsApiUrl, bt as getTileflowStyleFontFaces, bu as inferTileflowAnalyticsFromStyleUrl, bv as loadTileflowManifest, bw as mergeTileflowAnalytics, bx as nearestTileflowBlendTheme, by as normalizeTileflowRuntimeCenter, bz as normalizeTileflowStaticImageSize, bX as normalizeTileflowSurfaceId, bA as normalizeTileflowUrl, bB as resolveTileflowAnalyticsRequestUrl, bC as resolveTileflowManifestMap, bD as resolveTileflowMapMode, bE as resolveTileflowRuntimeStyle, bF as resolveTileflowRuntimeTheme, bG as resolveTileflowRuntimeThemeBlend, bH as resolveTileflowRuntimeView, bI as resolveTileflowStaticImageUrl, bJ as shouldLoadTileflowManifest, bK as startTileflowSession, bM as tileflowStyleFontFaceLimits, bN as tileflowStyleFontFacesMetadataKey, bO as tileflowThemeBlendLimits, bR as validateTileflowRuntimeSource, bS as validateTileflowThemeBlendSelection, bT as validateTileflowThemeSelection } from './manifest-types-E7m23eXL.js';

package/docs/authoring-model.md

@@ -220,10 +220,11 @@ The `vegetation` module binds individual-tree points from the optional OpenMapTi
 extension. Its default `mode: '3d'` emits a portable circle fallback plus metadata for runtimes
 that can upgrade the points to instanced 3D trees. `mode: 'flat'` keeps the MapLibre circles, and
 `flat` exposes the complete `CircleStyle` fallback. `threeDimensional` controls bark color,
-broadleaf and conifer palettes, and independent height and crown scales. The legacy `minZoom`
-shortcut remains available; `flat.minZoom` takes precedence when both are present. The binding
-includes height, crown diameter, genus, leaf type, and species fields so compatible runtimes can
-preserve source measurements and botanical form without hard-coding raw property names. The
+broadleaf and conifer palettes, and independent height and crown scales. `flat.minZoom` sets the
+first zoom with trees. The binding includes height, crown diameter, genus, leaf type, and species
+fields so compatible runtimes can preserve source measurements and botanical form without
+hard-coding raw property names. The module does not draw the unrelated, decorative `canopy` layer;
+render passes can, as in the [canopy grove recipe](data-is-separate-from-design.md). The
 pitched-scene stack follows physical height: pedestrian and transport surfaces, transport markings,
 buildings, then vegetation, so street paint never floats over 3D geometry. Text draws last: road
 names, route shields, junction numbers, and place, water, aerodrome, and POI annotations stay above