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

package/dist/build.d.ts

@@ -1,7 +1,7 @@
-import { T as TileflowCaptureScene } from './capture-scene-D6soWztE.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-BiOTwrvD.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-BiOTwrvD.js';
-import { M as MapLibreStyle, T as TileflowRuntimeManifest } from './manifest-types-CTT2eLbp.js';
+import { T as TileflowCaptureScene } from './capture-scene-BaAJjGq7.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-Befmn-zZ.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-Befmn-zZ.js';
+import { M as MapLibreStyle, T as TileflowRuntimeManifest } from './manifest-types-E7m23eXL.js';
 import { z } from 'zod';
 
 declare const tileflowMapRevisionSchemaVersion: 1;
@@ -146,8 +146,8 @@ declare const tileflowRendererDeploymentArtifactSchema: z.ZodObject<{
     teamSources: z.ZodRecord<z.ZodString, z.ZodObject<{
         tileset: z.ZodString;
         type: z.ZodEnum<{
-            vector: "vector";
             raster: "raster";
+            vector: "vector";
         }>;
     }, z.core.$strict>>;
     view: z.ZodOptional<z.ZodObject<{
@@ -204,8 +204,8 @@ declare const tileflowRendererDeploymentArtifactSchema: z.ZodObject<{
                             }>;
                             id: z.ZodString;
                             kind: z.ZodEnum<{
-                                pattern: "pattern";
                                 icon: "icon";
+                                pattern: "pattern";
                             }>;
                             sha256: z.ZodString;
                         }, z.core.$strict>, z.ZodObject<{
@@ -259,13 +259,6 @@ declare const tileflowRendererDeploymentArtifactSchema: z.ZodObject<{
                             }, z.core.$strict>], "kind">>;
                             winners: z.ZodArray<z.ZodObject<{
                                 id: z.ZodString;
-                                width: z.ZodNumber;
-                                height: z.ZodNumber;
-                                layout: z.ZodOptional<z.ZodObject<{
-                                    stretchX: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>>;
-                                    stretchY: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>>;
-                                    content: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
-                                }, z.core.$strict>>;
                                 appearance: z.ZodOptional<z.ZodObject<{
                                     representation: z.ZodLiteral<"sdf">;
                                     defaults: z.ZodObject<{
@@ -275,6 +268,13 @@ declare const tileflowRendererDeploymentArtifactSchema: z.ZodObject<{
                                         haloBlur: z.ZodNumber;
                                     }, z.core.$strict>;
                                 }, z.core.$strict>>;
+                                layout: z.ZodOptional<z.ZodObject<{
+                                    stretchX: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>>;
+                                    stretchY: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>>;
+                                    content: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+                                }, z.core.$strict>>;
+                                width: z.ZodNumber;
+                                height: z.ZodNumber;
                                 pixelSha256: z.ZodObject<{
                                     oneX: z.ZodString;
                                     twoX: z.ZodString;
@@ -316,40 +316,6 @@ declare const tileflowRendererDeploymentArtifactSchema: z.ZodObject<{
             styles: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         }, z.core.$strict>;
         native: z.ZodObject<{
-            buildRecord: z.ZodLazy<z.core.$ZodObject<{
-                schemaVersion: z.ZodLiteral<2>;
-                renderer: z.ZodLiteral<"native">;
-                profile: z.ZodLiteral<"native-v1">;
-                validation: z.ZodLiteral<"static-artifacts">;
-                preparationVersion: z.ZodLiteral<"native-lowering-v1">;
-                engines: z.ZodLazy<z.core.$ZodObject<{
-                    android: z.ZodLiteral<"13.2.0">;
-                    ios: z.ZodLiteral<"6.26.0">;
-                }, z.core.$strict>>;
-                buildManifestSha256: z.ZodString;
-                transformations: z.ZodArray<z.ZodLazy<z.core.$ZodObject<{
-                    map: z.ZodString;
-                    theme: z.ZodString;
-                    inputStyleSha256: z.ZodString;
-                    loweredStyleSha256: z.ZodString;
-                    inputLayers: z.ZodNumber;
-                    outputLayers: z.ZodNumber;
-                    projection: z.ZodEnum<{
-                        none: "none";
-                        "mercator-to-implicit": "mercator-to-implicit";
-                        "globe-to-mercator": "globe-to-mercator";
-                    }>;
-                    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";
-                        }>>;
-                    }, z.core.$strict>>>;
-                }, z.core.$strict>>>;
-            }, z.core.$strict>>;
             buildManifest: z.ZodObject<{
                 schemaVersion: z.ZodLiteral<1>;
                 maps: z.ZodRecord<z.ZodString, z.ZodObject<{
@@ -396,8 +362,8 @@ declare const tileflowRendererDeploymentArtifactSchema: z.ZodObject<{
                             }>;
                             id: z.ZodString;
                             kind: z.ZodEnum<{
-                                pattern: "pattern";
                                 icon: "icon";
+                                pattern: "pattern";
                             }>;
                             sha256: z.ZodString;
                         }, z.core.$strict>, z.ZodObject<{
@@ -451,13 +417,6 @@ declare const tileflowRendererDeploymentArtifactSchema: z.ZodObject<{
                             }, z.core.$strict>], "kind">>;
                             winners: z.ZodArray<z.ZodObject<{
                                 id: z.ZodString;
-                                width: z.ZodNumber;
-                                height: z.ZodNumber;
-                                layout: z.ZodOptional<z.ZodObject<{
-                                    stretchX: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>>;
-                                    stretchY: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>>;
-                                    content: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
-                                }, z.core.$strict>>;
                                 appearance: z.ZodOptional<z.ZodObject<{
                                     representation: z.ZodLiteral<"sdf">;
                                     defaults: z.ZodObject<{
@@ -467,6 +426,13 @@ declare const tileflowRendererDeploymentArtifactSchema: z.ZodObject<{
                                         haloBlur: z.ZodNumber;
                                     }, z.core.$strict>;
                                 }, z.core.$strict>>;
+                                layout: z.ZodOptional<z.ZodObject<{
+                                    stretchX: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>>;
+                                    stretchY: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>>;
+                                    content: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+                                }, z.core.$strict>>;
+                                width: z.ZodNumber;
+                                height: z.ZodNumber;
                                 pixelSha256: z.ZodObject<{
                                     oneX: z.ZodString;
                                     twoX: z.ZodString;
@@ -506,6 +472,47 @@ declare const tileflowRendererDeploymentArtifactSchema: z.ZodObject<{
                 }, z.core.$strict>>;
             }, z.core.$strict>;
             styles: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            buildRecord: z.ZodLazy<z.core.$ZodObject<{
+                schemaVersion: z.ZodLiteral<2>;
+                renderer: z.ZodLiteral<"native">;
+                profile: z.ZodLiteral<"native-v1">;
+                validation: z.ZodLiteral<"static-artifacts">;
+                preparationVersion: z.ZodLiteral<"native-lowering-v1">;
+                engines: z.ZodLazy<z.core.$ZodObject<{
+                    android: z.ZodLiteral<"13.2.0">;
+                    ios: z.ZodLiteral<"6.26.0">;
+                }, z.core.$strict>>;
+                buildManifestSha256: z.ZodString;
+                transformations: z.ZodArray<z.ZodLazy<z.core.$ZodObject<{
+                    map: z.ZodString;
+                    theme: z.ZodString;
+                    inputStyleSha256: z.ZodString;
+                    loweredStyleSha256: z.ZodString;
+                    inputLayers: z.ZodNumber;
+                    outputLayers: z.ZodNumber;
+                    projection: z.ZodEnum<{
+                        "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-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>>>;
+            }, z.core.$strict>>;
         }, z.core.$strict>;
     }, z.core.$strict>;
 }, z.core.$strict>;

package/dist/build.js

@@ -72,6 +72,7 @@ var canonicalLayers = {
   boundary: "boundary",
   building: "building",
   businessCorridor: "business_corridor",
+  canopy: "canopy",
   globalLandcover: "globallandcover",
   houseNumber: "housenumber",
   landcover: "landcover",
@@ -93,8 +94,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",
@@ -105,9 +108,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",
@@ -115,7 +118,6 @@ var canonicalFields = {
   foot: "foot",
   height: "height",
   hide3d: "hide_3d",
-  hasBusiness: "has_business",
   hasParts: "has_parts",
   horse: "horse",
   houseNumber: "housenumber",
@@ -150,7 +152,6 @@ var canonicalFields = {
   ref: "ref",
   refLength: "ref_length",
   renderHeight: "render_height",
-  renderMinZoom: "render_min_zoom",
   renderMinHeight: "render_min_height",
   service: "service",
   species: "species",
@@ -173,6 +174,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 {
@@ -190,14 +192,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",
@@ -291,6 +285,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)
       }
@@ -447,7 +442,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.");
   }
@@ -1340,7 +1335,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;
@@ -1410,7 +1405,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;
@@ -1528,6 +1523,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);
 }
@@ -2061,15 +2068,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
   ];
 }
@@ -4144,7 +4142,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]
@@ -4152,6 +4150,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];
 }
@@ -6344,9 +6345,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,
@@ -6420,7 +6419,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,
@@ -6486,7 +6485,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, [
@@ -6508,7 +6507,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,
@@ -6557,7 +6556,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;
@@ -7162,7 +7161,7 @@ function cloneJson16(value) {
 
 // src/modules/vegetation/compiler.ts
 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(
     {
@@ -7182,7 +7181,6 @@ function compileVegetation(request, context) {
         strokeOpacity: 0.55,
         strokeWidth: 0.8
       },
-      minZoom,
       mode,
       threeDimensional: {
         barkColor: context.colors.vegetation.tree.bark,
@@ -9943,10 +9941,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: {
@@ -10852,6 +10850,7 @@ var textStyleSchema = z5.object({
   offset: numberOffsetValueSchema.optional(),
   optional: z5.boolean().optional(),
   opacity: numberValueSchema.optional(),
+  overlap: z5.enum(["always", "cooperative", "never"]).optional(),
   padding: numberValueSchema.optional(),
   pitchAlignment: z5.enum(["auto", "map", "viewport"]).optional(),
   radialOffset: numberValueSchema.optional(),
@@ -10897,6 +10896,7 @@ var iconStyleSchema = z5.object({
   opacity: numberValueSchema.optional(),
   keepUpright: z5.boolean().optional(),
   optional: z5.boolean().optional(),
+  overlap: z5.enum(["always", "cooperative", "never"]).optional(),
   padding: numberValueSchema.optional(),
   pitchAlignment: z5.enum(["auto", "map", "viewport"]).optional(),
   rotate: numberValueSchema.optional(),
@@ -11469,7 +11469,6 @@ var modulesSchema = z5.object({
     type: z5.literal("vegetation"),
     enabled: z5.boolean().optional(),
     flat: circleStyleSchema.optional(),
-    minZoom: zoomNumberSchema.optional(),
     mode: z5.enum(["3d", "flat"]).optional(),
     renderStack: renderStackSchema.optional(),
     threeDimensional: z5.object({
@@ -11505,6 +11504,7 @@ var layerBindingsSchema = z5.object({
   building: z5.string().trim().min(1),
   bathymetry: z5.string().trim().min(1).optional(),
   businessCorridor: z5.string().trim().min(1).optional(),
+  canopy: z5.string().trim().min(1).optional(),
   circularFeature: z5.string().trim().min(1).optional(),
   globalLandcover: z5.string().trim().min(1).optional(),
   houseNumber: z5.string().trim().min(1),
@@ -11532,34 +11532,34 @@ var fieldBindingsSchema = z5.object({
   bathymetryMinDepth: z5.string().trim().min(1).optional(),
   bathymetrySortKey: z5.string().trim().min(1).optional(),
   brunnel: z5.string().trim().min(1),
-  buildingKind: z5.string().trim().min(1),
   buildingTone: z5.string().trim().min(1),
+  canopyClearanceAtZoom15: z5.string().trim().min(1),
+  canopyCoverPercent: z5.string().trim().min(1),
+  canopyRank: z5.string().trim().min(1),
   capital: z5.string().trim().min(1),
-  circularClearanceExtraAtZoom15: z5.string().trim().min(1).optional(),
-  circularKind: z5.string().trim().min(1).optional(),
-  circularRadiusAtZoom15: z5.string().trim().min(1).optional(),
-  circularRadiusMeters: z5.string().trim().min(1).optional(),
-  circularInnerRadiusMeters: z5.string().trim().min(1).optional(),
-  circularOuterRadiusMeters: z5.string().trim().min(1).optional(),
+  circularClearanceExtraAtZoom15: z5.string().trim().min(1),
+  circularKind: z5.string().trim().min(1),
+  circularRadiusAtZoom15: z5.string().trim().min(1),
+  circularRadiusMeters: z5.string().trim().min(1),
+  circularInnerRadiusMeters: z5.string().trim().min(1),
+  circularOuterRadiusMeters: z5.string().trim().min(1),
   class: z5.string().trim().min(1),
   crossing: z5.string().trim().min(1),
-  classificationConfidence: z5.string().trim().min(1),
   confidence: z5.string().trim().min(1),
   circumference: z5.string().trim().min(1),
   diameterCrown: z5.string().trim().min(1),
   disputed: z5.string().trim().min(1),
-  direction: z5.string().trim().min(1).optional(),
+  direction: z5.string().trim().min(1),
   elevation: z5.string().trim().min(1),
   elevationFeet: z5.string().trim().min(1),
   expressway: z5.string().trim().min(1),
   foot: z5.string().trim().min(1),
   height: z5.string().trim().min(1),
-  hasBusiness: z5.string().trim().min(1),
-  hasParts: z5.string().trim().min(1).optional(),
+  hasParts: z5.string().trim().min(1),
   hide3d: z5.string().trim().min(1),
   horse: z5.string().trim().min(1),
   houseNumber: z5.string().trim().min(1),
-  importanceTier: z5.string().trim().min(1).optional(),
+  importanceTier: z5.string().trim().min(1),
   iata: z5.string().trim().min(1),
   icao: z5.string().trim().min(1),
   indoor: z5.string().trim().min(1),
@@ -11590,7 +11590,6 @@ var fieldBindingsSchema = z5.object({
   ref: z5.string().trim().min(1),
   refLength: z5.string().trim().min(1),
   renderHeight: z5.string().trim().min(1),
-  renderMinZoom: z5.string().trim().min(1),
   renderMinHeight: z5.string().trim().min(1),
   shieldKind: z5.string().trim().min(1).optional(),
   shieldLineLengthMeters: z5.string().trim().min(1).optional(),
@@ -11616,6 +11615,7 @@ var openMapTilesSchema = z5.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
     },
@@ -14697,6 +14697,15 @@ var tileflowCaptureSceneSchema = z8.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 isPortableApplicationPath(value) {
   if (value !== value.trim() || !value.startsWith("/") || value.startsWith("//") || value.includes("#") || value.includes("\\") || hasControlCharacter(value)) {
     return false;
@@ -15182,8 +15191,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"}`
       );
@@ -15899,6 +15908,13 @@ var layerTransformationSchema = strictNativeObject({
     "Expected unique, ordered properties"
   )
 });
+var symbolOverlapTransformationSchema = strictNativeObject({
+  inputLayer: layerCountSchema,
+  properties: z12.array(z12.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,
@@ -15907,7 +15923,8 @@ var tileflowNativeStyleTransformationSchema = strictNativeObject({
   inputLayers: layerCountSchema,
   outputLayers: layerCountSchema,
   projection: z12.enum(["none", "mercator-to-implicit", "globe-to-mercator"]),
-  layers: z12.array(layerTransformationSchema).max(tileflowNativeProfileLimits.maximumLayers)
+  layers: z12.array(layerTransformationSchema).max(tileflowNativeProfileLimits.maximumLayers),
+  symbolOverlap: z12.array(symbolOverlapTransformationSchema).max(tileflowNativeProfileLimits.maximumLayers)
 }).superRefine((style, context) => {
   let previous = -1;
   let added = 0;
@@ -15929,6 +15946,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: z12.literal(2),

package/dist/{capture-scene-D6soWztE.d.ts → capture-scene-BaAJjGq7.d.ts}

@@ -116,6 +116,16 @@ declare const tileflowCaptureSceneSchema: z.ZodObject<{
         }>>;
     }, z.core.$strict>], "kind">>;
 }, z.core.$strict>;
+/**
+ * Why a scene's bounds padding leaves no room for its bounds, or undefined when it fits: padding on
+ * both sides must be less than the viewport's shorter side. MapLibre GL JS 6.11.2+ leaves a globe
+ * camera where it was when it cannot fit, so the capture would show the wrong view. Checked where
+ * scenes are validated rather than in the schema, so the published reference keeps its shape.
+ */
+declare function tileflowCaptureSceneFitIssue(scene: Pick<TileflowCaptureScene, 'camera' | 'viewport'>): {
+    message: string;
+    path: ['camera', 'padding'];
+} | undefined;
 type TileflowCaptureCenterCamera = z.infer<typeof tileflowCaptureCenterCameraSchema>;
 type TileflowCaptureBoundsCamera = z.infer<typeof tileflowCaptureBoundsCameraSchema>;
 type TileflowCaptureCamera = z.infer<typeof tileflowCaptureCameraSchema>;
@@ -158,4 +168,4 @@ type NormalizedTileflowCaptureScene = {
 declare function normalizeTileflowCaptureScene(input: TileflowCaptureScene): NormalizedTileflowCaptureScene;
 declare function normalizeTileflowCaptureId(value: string | undefined): string | undefined;
 
-export { type NormalizedTileflowCaptureScene as N, type TileflowCaptureScene as T, type TileflowCaptureApplicationTarget as a, type TileflowCaptureBoundsCamera as b, type TileflowCaptureCamera as c, type TileflowCaptureCenterCamera as d, type TileflowCaptureMapTarget as e, type TileflowCaptureTarget as f, type TileflowCaptureViewport as g, normalizeTileflowCaptureScene as h, tileflowCaptureBoundsCameraSchema as i, tileflowCaptureCameraSchema as j, tileflowCaptureCenterCameraSchema as k, tileflowCaptureIdSchema as l, tileflowCaptureMapTargetSchema as m, normalizeTileflowCaptureId as n, tileflowCaptureSceneLimits as o, tileflowCaptureSceneNameSchema as p, tileflowCaptureSceneSchema as q, tileflowCaptureSceneSchemaVersion as r, tileflowCaptureTargetSchema as s, tileflowCaptureApplicationTargetSchema as t, tileflowCaptureViewportSchema as u };
+export { type NormalizedTileflowCaptureScene as N, type TileflowCaptureScene as T, type TileflowCaptureApplicationTarget as a, type TileflowCaptureBoundsCamera as b, type TileflowCaptureCamera as c, type TileflowCaptureCenterCamera as d, type TileflowCaptureMapTarget as e, type TileflowCaptureTarget as f, type TileflowCaptureViewport as g, normalizeTileflowCaptureScene as h, tileflowCaptureBoundsCameraSchema as i, tileflowCaptureCameraSchema as j, tileflowCaptureCenterCameraSchema as k, tileflowCaptureIdSchema as l, tileflowCaptureMapTargetSchema as m, normalizeTileflowCaptureId as n, tileflowCaptureSceneLimits as o, tileflowCaptureSceneNameSchema as p, tileflowCaptureSceneSchema as q, tileflowCaptureSceneSchemaVersion as r, tileflowCaptureTargetSchema as s, tileflowCaptureApplicationTargetSchema as t, tileflowCaptureViewportSchema as u, tileflowCaptureSceneFitIssue as v };

package/dist/capture.d.ts

@@ -1,4 +1,4 @@
-export { N as NormalizedTileflowCaptureScene, a as TileflowCaptureApplicationTarget, b as TileflowCaptureBoundsCamera, c as TileflowCaptureCamera, d as TileflowCaptureCenterCamera, e as TileflowCaptureMapTarget, T as TileflowCaptureScene, f as TileflowCaptureTarget, g as TileflowCaptureViewport, n as normalizeTileflowCaptureId, h as normalizeTileflowCaptureScene, t as tileflowCaptureApplicationTargetSchema, i as tileflowCaptureBoundsCameraSchema, j as tileflowCaptureCameraSchema, k as tileflowCaptureCenterCameraSchema, l as tileflowCaptureIdSchema, m as tileflowCaptureMapTargetSchema, o as tileflowCaptureSceneLimits, p as tileflowCaptureSceneNameSchema, q as tileflowCaptureSceneSchema, r as tileflowCaptureSceneSchemaVersion, s as tileflowCaptureTargetSchema, u as tileflowCaptureViewportSchema } from './capture-scene-D6soWztE.js';
+export { N as NormalizedTileflowCaptureScene, a as TileflowCaptureApplicationTarget, b as TileflowCaptureBoundsCamera, c as TileflowCaptureCamera, d as TileflowCaptureCenterCamera, e as TileflowCaptureMapTarget, T as TileflowCaptureScene, f as TileflowCaptureTarget, g as TileflowCaptureViewport, n as normalizeTileflowCaptureId, h as normalizeTileflowCaptureScene, t as tileflowCaptureApplicationTargetSchema, i as tileflowCaptureBoundsCameraSchema, j as tileflowCaptureCameraSchema, k as tileflowCaptureCenterCameraSchema, l as tileflowCaptureIdSchema, m as tileflowCaptureMapTargetSchema, v as tileflowCaptureSceneFitIssue, o as tileflowCaptureSceneLimits, p as tileflowCaptureSceneNameSchema, q as tileflowCaptureSceneSchema, r as tileflowCaptureSceneSchemaVersion, s as tileflowCaptureTargetSchema, u as tileflowCaptureViewportSchema } from './capture-scene-BaAJjGq7.js';
 import { z } from 'zod';
 
 /** Canonical, filesystem-safe identity shared by authored and emitted Tileflow resources. */

package/dist/capture.js

@@ -204,8 +204,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,
@@ -265,6 +276,7 @@ export {
   tileflowCaptureCenterCameraSchema,
   tileflowCaptureIdSchema,
   tileflowCaptureMapTargetSchema,
+  tileflowCaptureSceneFitIssue,
   tileflowCaptureSceneLimits,
   tileflowCaptureSceneNameSchema,
   tileflowCaptureSceneSchema,