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

package/dist/{icon-composition-HUh_Lj8Z.d.ts → icon-composition-B1A2udKb.d.ts}

@@ -1,4 +1,4 @@
-import { bd as TileflowThemeColorValue, r as TileflowSymbolStyle, D as TileflowAreaStyle, a1 as TileflowLineStackStyle, q as TileflowLineStyle, o as TileflowExtrusionStyle, bg as TileflowThemeNumberValue, bj as TileflowThemeValue, m as TileflowBackgroundStyle, p as TileflowFillStyle, a6 as TileflowMarkerSymbolStyle, n as TileflowCircleStyle, aU as TileflowSymbolPlacement, b1 as TileflowTerrainHillshadeStyle, b0 as TileflowTerrainEncoding, be as TileflowThemeFontValue, bf as TileflowThemeImageValue, c0 as TileflowTypographyStyle, X as TileflowLight, c1 as ResolvedTileflowTypography, f as TileflowTimeOfDayVariants, e as TileflowTimeOfDay, w as TileflowLabelsModuleConfig, y as TileflowPoiModuleConfig, u as TileflowRoadsModuleConfig, ah as TileflowProjection, aX as TileflowTerrain, bk as TileflowViewConfig, M as MapLibreStyle, bo as ValidationResult } from './manifest-types-DnhSJjCM.js';
+import { bd as TileflowThemeColorValue, r as TileflowSymbolStyle, D as TileflowAreaStyle, a1 as TileflowLineStackStyle, q as TileflowLineStyle, o as TileflowExtrusionStyle, bg as TileflowThemeNumberValue, bj as TileflowThemeValue, m as TileflowBackgroundStyle, p as TileflowFillStyle, a6 as TileflowMarkerSymbolStyle, n as TileflowCircleStyle, aU as TileflowSymbolPlacement, b1 as TileflowTerrainHillshadeStyle, b0 as TileflowTerrainEncoding, be as TileflowThemeFontValue, bf as TileflowThemeImageValue, c0 as TileflowTypographyStyle, X as TileflowLight, c1 as ResolvedTileflowTypography, f as TileflowTimeOfDayVariants, e as TileflowTimeOfDay, w as TileflowLabelsModuleConfig, y as TileflowPoiModuleConfig, u as TileflowRoadsModuleConfig, ah as TileflowProjection, aX as TileflowTerrain, bk as TileflowViewConfig, M as MapLibreStyle, bo as ValidationResult } from './manifest-types-B0lQjabX.js';
 import * as zod from 'zod';
 import { z } from 'zod';
 import { T as TileflowCaptureScene, a as TileflowCaptureShot } from './capture-shot-ChPQvPyi.js';
@@ -488,7 +488,7 @@ type TileflowBuildingsThreeDimensionalStyle = {
     colorVariation?: TileflowThemeNumberValue;
     /** How strongly roof outlines and outer corners catch the light, from 0 (default) to 1. */
     edges?: TileflowThemeNumberValue;
-    /** Radius in metres for softened exterior corners and roof lighting, from 0 to 1; defaults to 0.8. */
+    /** Radius in metres for softened exterior corners and roof lighting, from 0 to 1.5; defaults to 0.8. */
     edgeRadius?: number;
     /** Their own colour, drawn unlit; without it they take the building's colour, lightened. */
     edgeColor?: TileflowThemeColorValue;
@@ -528,6 +528,12 @@ type TileflowBuildingsThreeDimensionalStyle = {
         colorMix?: TileflowThemeNumberValue;
         metallic?: TileflowThemeNumberValue;
         roughness?: TileflowThemeNumberValue;
+        /** Normalize matte light to ordinary buildings, or retain physical glTF lighting (default). */
+        shading?: 'physical' | 'map';
+        /** Role multiplier for model ambient occlusion, from zero to one; defaults to one. */
+        ambientOcclusion?: TileflowThemeNumberValue;
+        /** Named-part colour contribution after the role tint, from zero to one; defaults to one. */
+        partColorMix?: TileflowThemeNumberValue;
         /** Independent HSL ranges, seeded by model identity; no window geometry is invented. */
         colorVariation?: {
             hue: readonly [TileflowThemeNumberValue, TileflowThemeNumberValue];
@@ -548,6 +554,8 @@ type TileflowBuildingsThreeDimensionalStyle = {
     };
     /** Contact shadow at the foot of the walls and in tight corners; defaults to true. */
     occlusion?: boolean;
+    /** Ground contact shadow strength, from 0 to 1; defaults to 0.16. Facade shading is independent. */
+    groundOcclusion?: TileflowThemeNumberValue;
     /** Prepared model ambient occlusion strength, from 0 to 1; defaults to 0.75. */
     modelOcclusion?: TileflowThemeNumberValue;
     /** Shadows from the sun, on the buildings and the flat map; defaults to true. */

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-import { u as TileflowBoundaryClass, w as TileflowBoundaryClassTier, x as TileflowBoundaryFamily, y as TileflowOverlayPlacement, z as TileflowMapLibreOverlay, d as TileflowMap, A as TileflowMapScene, B as TileflowMapShot, C as ResolveMapOptions, R as ResolvedTileflowMap, D as TileflowIconAppearance, O as OpenMapTilesFieldBindings, E as TileflowLayerDomain, F as TileflowBandPlacement, G as OpenMapTilesLayerBindings, H as tileflowCompilationPhases, I as tileflowCompilationPlannerStages, J as tileflowCompilationReportSchemaVersion, K as TileflowSemanticModuleName, L as tileflowHostedSourceLimit, M as tileflowOverlayPlacements, N as ResolvedTileflowTheme, P as TileflowThemeColorScheme, Q as TileflowIconSource, S as TileflowModelLightingRole, U as TileflowBuildingSurfaceDesign, V as TileflowModel, W as TileflowModelBytes, X as TileflowVegetationMode } from './icon-composition-HUh_Lj8Z.js';
-export { Y as OpenMapTilesSchema, Z as OpenMapTilesSchemaOptions, _ as ParkLayerSemantics, $ as ResolvedBathymetry, a0 as ResolvedBathymetryRelief, a1 as ResolvedBoundaryAreas, a2 as ResolvedMarine, a3 as ResolvedMarineSource, a4 as ResolvedTileflowData, a5 as ResolvedTileflowThemeTokens, a6 as TileflowAddressesModuleConfig, a7 as TileflowAddressesModuleOptions, a8 as TileflowAerowaysModuleConfig, a9 as TileflowAerowaysModuleOptions, aa as TileflowAtmosphere, ab as TileflowAtmosphereOptions, ac as TileflowAuthoringModules, ad as TileflowBarrierClass, ae as TileflowBarrierStyle, af as TileflowBathymetryConfig, ag as TileflowBathymetryDemSourceIdentity, ah as TileflowBathymetryDisplay, ai as TileflowBathymetryNameLayer, aj as TileflowBathymetryNamePlacement, ak as TileflowBathymetryNameStyle, al as TileflowBathymetryNameZoomRange, am as TileflowBathymetryOptions, an as TileflowBathymetryReliefConfig, ao as TileflowBathymetryVectorLayers, ap as TileflowBoundariesModuleConfig, aq as TileflowBoundariesModuleOptions, ar as TileflowBoundaryAreas, as as TileflowBoundaryAreasConfig, at as TileflowBoundaryAreasSourceIdentity, au as TileflowBuildingMode, av as TileflowBuildingModelPart, aw as TileflowBuildingModelPlacementConfig, ax as TileflowBuildingSurfaces, ay as TileflowBuildingsModuleConfig, az as TileflowBuildingsModuleOptions, aA as TileflowBuildingsThreeDimensionalStyle, aB as TileflowCompilationDesignDecision, aC as TileflowCompilationDiagnostic, aD as TileflowCompilationDomainReport, aE as TileflowCompilationFailure, aF as TileflowCompilationOptions, aG as TileflowCompilationPhase, aH as TileflowCompilationPlannerDecision, aI as TileflowCompilationPlannerStage, aJ as TileflowCompilationReport, aK as TileflowCompilationResult, aL as TileflowCompilationSuccess, h as TileflowDataCompatibilityIssue, aM as TileflowDataConfig, i as TileflowDataFieldRequirement, j as TileflowDataFieldType, aN as TileflowDataIdentity, k as TileflowDataLayerRequirement, b as TileflowDataRequirementsV1, aO as TileflowDerivedMap, aP as TileflowDisableOperation, aQ as TileflowFontDirectory, aR as TileflowGlyphs, aS as TileflowHostedSourceCollection, aT as TileflowHostedTilesetSource, aU as TileflowHostedTilesetType, a as TileflowIconCompositionV1, aV as TileflowIconContributorIdentity, aW as TileflowIconDirectory, aX as TileflowIconSetError, aY as TileflowIconSetErrorCode, aZ as TileflowIconSetReference, a_ as TileflowIconSetSource, a$ as TileflowLandModuleConfig, b0 as TileflowLandModuleOptions, b1 as TileflowLandcoverClass, b2 as TileflowLandformClass, b3 as TileflowLandformsModuleConfig, b4 as TileflowLandformsModuleOptions, b5 as TileflowLanduseClass, b6 as TileflowLayerBand, b7 as TileflowLocalDirectory, b8 as TileflowMapDesign, b9 as TileflowMapIdentity, ba as TileflowMapLibreOverlayLayer, bb as TileflowMapTooling, bc as TileflowMarine, bd as TileflowMarineConfig, be as TileflowMarineMode, bf as TileflowMarineSourceConfig, bg as TileflowMarineSourceIdentity, bh as TileflowModelDirectory, bi as TileflowModelEmitter, bj as TileflowModelLevelBytes, bk as TileflowModelMaterial, bl as TileflowModelMaterialRange, bm as TileflowModelMesh, bn as TileflowModelPart, bo as TileflowModelSurface, bp as TileflowModelSurfaceBytes, bq as TileflowModelTexture, br as TileflowModelTextureReference, bs as TileflowModuleOperation, bt as TileflowModulePatch, bu as TileflowNauticalAreaLabelStyles, bv as TileflowNauticalModuleConfig, bw as TileflowNauticalModuleOptions, l as TileflowObservedDataContractV1, bx as TileflowOverlayCollection, by as TileflowPackageDirectory, bz as TileflowPreparedIconCapabilities, bA as TileflowRasterDemSourceRequirementV1, bB as TileflowRefineOperation, bC as TileflowRemoveOperation, T as TileflowRenderedIconIdentity, bD as TileflowReset, bE as TileflowResolvedThemeSelection, bF as TileflowSemanticModules, bG as TileflowSky, bH as TileflowSkyColours, bI as TileflowSkyMetadata, bJ as TileflowSkyOptions, bK as TileflowSkyTimesOfDay, c as TileflowSourceRequirementsV1, bL as TileflowStandaloneMap, e as TileflowStyleOptions, bM as TileflowSun, bN as TileflowSunPreset, bO as TileflowTheme, bP as TileflowThemeAmbient, bQ as TileflowThemeAuditContext, bR as TileflowThemeAuditDiagnostic, bS as TileflowThemeAuditError, bT as TileflowThemeAuditScope, bU as TileflowThemeDefinition, bV as TileflowThemeLighting, bW as TileflowThemeName, bX as TileflowThemeSun, bY as TileflowThemeTokens, bZ as TileflowThemeTypography, b_ as TileflowThemeTypographyStyle, b$ as TileflowTransitModuleConfig, c0 as TileflowTransitModuleOptions, c1 as TileflowTransitRailStyle, c2 as TileflowTreeForm, c3 as TileflowTreeFormMix, c4 as TileflowTreeModel, c5 as TileflowTreeModelMesh, c6 as TileflowTreeRegion, c7 as TileflowVegetation3D, c8 as TileflowVegetationModuleConfig, c9 as TileflowVegetationModuleOptions, ca as TileflowVegetationThreeDimensionalStyle, cb as TileflowVisualValueCategory, cc as TileflowWaterModuleConfig, cd as TileflowWaterModuleOptions, ce as TileflowWaterwayClass, cf as TileflowWorldData, cg as TileflowWorldReleaseReference, ch as TileflowWorldSelection, ci as TileflowWorldV1Schema, cj as VectorTilesData, ck as addresses, cl as aeroways, cm as assertTileflowMapThemeValues, cn as assertTileflowSdfPixels, co as auditTileflowMapThemeValues, cp as auditTileflowThemeValues, cq as bathymetry, cr as boundaries, cs as buildings, ct as checkTileflowModelSurface, cu as classifyTileflowVisualProperty, cv as collectTileflowIconSetReferences, cw as createStyle, cx as createStyleResult, cy as decodeTileflowTreeModel, cz as defineTheme, cA as disable, cB as encodeTileflowTreeModel, cC as hashTileflowIconComposition, cD as hostedTileset, cE as iconSet, r as inferTileflowDataRequirements, s as inferTileflowSourceRequirements, cF as isCanonicalOpenMapTilesSchema, cG as isSafeLocalPmtilesPath, cH as isTileflowBoundaryClass, cI as isTileflowBoundaryFamily, cJ as isTileflowCompilationPhase, cK as isTileflowIconSetSource, cL as isTileflowLocalDirectory, cM as isTileflowModelPartName, cN as land, cO as landforms, cP as maplibreOverlay, cQ as mixTileflowSunPresets, cR as nautical, cS as openMapTiles, cT as openMapTilesContractVersion, cU as parseTileflowIconComposition, cV as parseTileflowMap, cW as readTileflowSky, cX as readTileflowSunPreset, cY as readTileflowVegetation3D, cZ as refine, c_ as remove, c$ as reset, d0 as resolveBoundaryAreas, d1 as resolveMarine, d2 as resolveThemeSelection, d3 as resolveThemeValues, d4 as resolveTileflowData, d5 as resolveTileflowSun, d6 as resolveTileflowTheme, d7 as tileflowBandPlacements, d8 as tileflowBathymetryDemSourceId, d9 as tileflowBathymetryNameLayerLimits, da as tileflowBathymetrySourceId, db as tileflowBathymetryV1Schema, dc as tileflowBoundaryAreasV1Schema, dd as tileflowBoundaryClassTiers, de as tileflowBoundaryClasses, df as tileflowBoundaryFamilies, dg as tileflowDefaultSunPreset, dh as tileflowIconAppearanceSchema, di as tileflowIconAuthorMetadataSchema, dj as tileflowIconCompositionMaximumBytes, dk as tileflowIconCompositionSchema, dl as tileflowIconMetadataFileName, dm as tileflowIconSetIdSchema, dn as tileflowIconSetPackageIdSchema, dp as tileflowIconSetReferenceSchema, dq as tileflowIconSetSourceSchema, dr as tileflowIconSetTeamIdSchema, ds as tileflowIconSetVersionIdSchema, dt as tileflowIconSourceLimit, du as tileflowInsideRings, dv as tileflowLandformClasses, dw as tileflowLayerBands, dx as tileflowLocalDirectoryMaximumLength, dy as tileflowLocalDirectoryMessage, dz as tileflowMapIdSchema, dA as tileflowModelArchitecturalPartNames, dB as tileflowModelDefaultLightingRole, dC as tileflowModelImageSize, dD as tileflowModelLightingRoles, dE as tileflowModelLimits, dF as tileflowModelParts, dG as tileflowModelSurfaceLimits, dH as tileflowModelTextureChannels, dI as tileflowModelVertexBytes, dJ as tileflowNauticalFacilityIcons, dK as tileflowNauticalImageRoles, dL as tileflowNauticalNotice, dM as tileflowNauticalPromoteId, dN as tileflowNauticalSourceId, dO as tileflowNauticalV1Schema, dP as tileflowPrimarySourceId, dQ as tileflowRenderedIconIdentitySchema, dR as tileflowRingsOverlap, dS as tileflowSkyAtSun, dT as tileflowSkyMetadataKey, dU as tileflowStyleSunPreset, dV as tileflowSunDirection, dW as tileflowSunMetadataKey, dX as tileflowSunPosition, dY as tileflowThemeLimits, dZ as tileflowTreeForms, d_ as tileflowTreeModelIdPattern, d$ as tileflowTreeModelLimits, e0 as tileflowVegetationMetadataKey, e1 as tileflowWorld, e2 as tileflowWorldGeneration, e3 as tileflowWorldTileJsonUrl, e4 as tileflowWorldV1Schema, e5 as transit, e6 as validateTileflowCompiledIconCapabilities, v as validateTileflowDataCompatibility, e7 as validateTileflowMap, e8 as validateTileflowWorldV1Tilejson, e9 as vectorTiles, ea as vegetation, eb as water } from './icon-composition-HUh_Lj8Z.js';
+import { u as TileflowBoundaryClass, w as TileflowBoundaryClassTier, x as TileflowBoundaryFamily, y as TileflowOverlayPlacement, z as TileflowMapLibreOverlay, d as TileflowMap, A as TileflowMapScene, B as TileflowMapShot, C as ResolveMapOptions, R as ResolvedTileflowMap, D as TileflowIconAppearance, O as OpenMapTilesFieldBindings, E as TileflowLayerDomain, F as TileflowBandPlacement, G as OpenMapTilesLayerBindings, H as tileflowCompilationPhases, I as tileflowCompilationPlannerStages, J as tileflowCompilationReportSchemaVersion, K as TileflowSemanticModuleName, L as tileflowHostedSourceLimit, M as tileflowOverlayPlacements, N as ResolvedTileflowTheme, P as TileflowThemeColorScheme, Q as TileflowIconSource, S as TileflowModelLightingRole, U as TileflowBuildingSurfaceDesign, V as TileflowModel, W as TileflowModelBytes, X as TileflowVegetationMode } from './icon-composition-B1A2udKb.js';
+export { Y as OpenMapTilesSchema, Z as OpenMapTilesSchemaOptions, _ as ParkLayerSemantics, $ as ResolvedBathymetry, a0 as ResolvedBathymetryRelief, a1 as ResolvedBoundaryAreas, a2 as ResolvedMarine, a3 as ResolvedMarineSource, a4 as ResolvedTileflowData, a5 as ResolvedTileflowThemeTokens, a6 as TileflowAddressesModuleConfig, a7 as TileflowAddressesModuleOptions, a8 as TileflowAerowaysModuleConfig, a9 as TileflowAerowaysModuleOptions, aa as TileflowAtmosphere, ab as TileflowAtmosphereOptions, ac as TileflowAuthoringModules, ad as TileflowBarrierClass, ae as TileflowBarrierStyle, af as TileflowBathymetryConfig, ag as TileflowBathymetryDemSourceIdentity, ah as TileflowBathymetryDisplay, ai as TileflowBathymetryNameLayer, aj as TileflowBathymetryNamePlacement, ak as TileflowBathymetryNameStyle, al as TileflowBathymetryNameZoomRange, am as TileflowBathymetryOptions, an as TileflowBathymetryReliefConfig, ao as TileflowBathymetryVectorLayers, ap as TileflowBoundariesModuleConfig, aq as TileflowBoundariesModuleOptions, ar as TileflowBoundaryAreas, as as TileflowBoundaryAreasConfig, at as TileflowBoundaryAreasSourceIdentity, au as TileflowBuildingMode, av as TileflowBuildingModelPart, aw as TileflowBuildingModelPlacementConfig, ax as TileflowBuildingSurfaces, ay as TileflowBuildingsModuleConfig, az as TileflowBuildingsModuleOptions, aA as TileflowBuildingsThreeDimensionalStyle, aB as TileflowCompilationDesignDecision, aC as TileflowCompilationDiagnostic, aD as TileflowCompilationDomainReport, aE as TileflowCompilationFailure, aF as TileflowCompilationOptions, aG as TileflowCompilationPhase, aH as TileflowCompilationPlannerDecision, aI as TileflowCompilationPlannerStage, aJ as TileflowCompilationReport, aK as TileflowCompilationResult, aL as TileflowCompilationSuccess, h as TileflowDataCompatibilityIssue, aM as TileflowDataConfig, i as TileflowDataFieldRequirement, j as TileflowDataFieldType, aN as TileflowDataIdentity, k as TileflowDataLayerRequirement, b as TileflowDataRequirementsV1, aO as TileflowDerivedMap, aP as TileflowDisableOperation, aQ as TileflowFontDirectory, aR as TileflowGlyphs, aS as TileflowHostedSourceCollection, aT as TileflowHostedTilesetSource, aU as TileflowHostedTilesetType, a as TileflowIconCompositionV1, aV as TileflowIconContributorIdentity, aW as TileflowIconDirectory, aX as TileflowIconSetError, aY as TileflowIconSetErrorCode, aZ as TileflowIconSetReference, a_ as TileflowIconSetSource, a$ as TileflowLandModuleConfig, b0 as TileflowLandModuleOptions, b1 as TileflowLandcoverClass, b2 as TileflowLandformClass, b3 as TileflowLandformsModuleConfig, b4 as TileflowLandformsModuleOptions, b5 as TileflowLanduseClass, b6 as TileflowLayerBand, b7 as TileflowLocalDirectory, b8 as TileflowMapDesign, b9 as TileflowMapIdentity, ba as TileflowMapLibreOverlayLayer, bb as TileflowMapTooling, bc as TileflowMarine, bd as TileflowMarineConfig, be as TileflowMarineMode, bf as TileflowMarineSourceConfig, bg as TileflowMarineSourceIdentity, bh as TileflowModelDirectory, bi as TileflowModelEmitter, bj as TileflowModelLevelBytes, bk as TileflowModelMaterial, bl as TileflowModelMaterialRange, bm as TileflowModelMesh, bn as TileflowModelPart, bo as TileflowModelSurface, bp as TileflowModelSurfaceBytes, bq as TileflowModelTexture, br as TileflowModelTextureReference, bs as TileflowModuleOperation, bt as TileflowModulePatch, bu as TileflowNauticalAreaLabelStyles, bv as TileflowNauticalModuleConfig, bw as TileflowNauticalModuleOptions, l as TileflowObservedDataContractV1, bx as TileflowOverlayCollection, by as TileflowPackageDirectory, bz as TileflowPreparedIconCapabilities, bA as TileflowRasterDemSourceRequirementV1, bB as TileflowRefineOperation, bC as TileflowRemoveOperation, T as TileflowRenderedIconIdentity, bD as TileflowReset, bE as TileflowResolvedThemeSelection, bF as TileflowSemanticModules, bG as TileflowSky, bH as TileflowSkyColours, bI as TileflowSkyMetadata, bJ as TileflowSkyOptions, bK as TileflowSkyTimesOfDay, c as TileflowSourceRequirementsV1, bL as TileflowStandaloneMap, e as TileflowStyleOptions, bM as TileflowSun, bN as TileflowSunPreset, bO as TileflowTheme, bP as TileflowThemeAmbient, bQ as TileflowThemeAuditContext, bR as TileflowThemeAuditDiagnostic, bS as TileflowThemeAuditError, bT as TileflowThemeAuditScope, bU as TileflowThemeDefinition, bV as TileflowThemeLighting, bW as TileflowThemeName, bX as TileflowThemeSun, bY as TileflowThemeTokens, bZ as TileflowThemeTypography, b_ as TileflowThemeTypographyStyle, b$ as TileflowTransitModuleConfig, c0 as TileflowTransitModuleOptions, c1 as TileflowTransitRailStyle, c2 as TileflowTreeForm, c3 as TileflowTreeFormMix, c4 as TileflowTreeModel, c5 as TileflowTreeModelMesh, c6 as TileflowTreeRegion, c7 as TileflowVegetation3D, c8 as TileflowVegetationModuleConfig, c9 as TileflowVegetationModuleOptions, ca as TileflowVegetationThreeDimensionalStyle, cb as TileflowVisualValueCategory, cc as TileflowWaterModuleConfig, cd as TileflowWaterModuleOptions, ce as TileflowWaterwayClass, cf as TileflowWorldData, cg as TileflowWorldReleaseReference, ch as TileflowWorldSelection, ci as TileflowWorldV1Schema, cj as VectorTilesData, ck as addresses, cl as aeroways, cm as assertTileflowMapThemeValues, cn as assertTileflowSdfPixels, co as auditTileflowMapThemeValues, cp as auditTileflowThemeValues, cq as bathymetry, cr as boundaries, cs as buildings, ct as checkTileflowModelSurface, cu as classifyTileflowVisualProperty, cv as collectTileflowIconSetReferences, cw as createStyle, cx as createStyleResult, cy as decodeTileflowTreeModel, cz as defineTheme, cA as disable, cB as encodeTileflowTreeModel, cC as hashTileflowIconComposition, cD as hostedTileset, cE as iconSet, r as inferTileflowDataRequirements, s as inferTileflowSourceRequirements, cF as isCanonicalOpenMapTilesSchema, cG as isSafeLocalPmtilesPath, cH as isTileflowBoundaryClass, cI as isTileflowBoundaryFamily, cJ as isTileflowCompilationPhase, cK as isTileflowIconSetSource, cL as isTileflowLocalDirectory, cM as isTileflowModelPartName, cN as land, cO as landforms, cP as maplibreOverlay, cQ as mixTileflowSunPresets, cR as nautical, cS as openMapTiles, cT as openMapTilesContractVersion, cU as parseTileflowIconComposition, cV as parseTileflowMap, cW as readTileflowSky, cX as readTileflowSunPreset, cY as readTileflowVegetation3D, cZ as refine, c_ as remove, c$ as reset, d0 as resolveBoundaryAreas, d1 as resolveMarine, d2 as resolveThemeSelection, d3 as resolveThemeValues, d4 as resolveTileflowData, d5 as resolveTileflowSun, d6 as resolveTileflowTheme, d7 as tileflowBandPlacements, d8 as tileflowBathymetryDemSourceId, d9 as tileflowBathymetryNameLayerLimits, da as tileflowBathymetrySourceId, db as tileflowBathymetryV1Schema, dc as tileflowBoundaryAreasV1Schema, dd as tileflowBoundaryClassTiers, de as tileflowBoundaryClasses, df as tileflowBoundaryFamilies, dg as tileflowDefaultSunPreset, dh as tileflowIconAppearanceSchema, di as tileflowIconAuthorMetadataSchema, dj as tileflowIconCompositionMaximumBytes, dk as tileflowIconCompositionSchema, dl as tileflowIconMetadataFileName, dm as tileflowIconSetIdSchema, dn as tileflowIconSetPackageIdSchema, dp as tileflowIconSetReferenceSchema, dq as tileflowIconSetSourceSchema, dr as tileflowIconSetTeamIdSchema, ds as tileflowIconSetVersionIdSchema, dt as tileflowIconSourceLimit, du as tileflowInsideRings, dv as tileflowLandformClasses, dw as tileflowLayerBands, dx as tileflowLocalDirectoryMaximumLength, dy as tileflowLocalDirectoryMessage, dz as tileflowMapIdSchema, dA as tileflowModelArchitecturalPartNames, dB as tileflowModelDefaultLightingRole, dC as tileflowModelImageSize, dD as tileflowModelLightingRoles, dE as tileflowModelLimits, dF as tileflowModelParts, dG as tileflowModelSurfaceLimits, dH as tileflowModelTextureChannels, dI as tileflowModelVertexBytes, dJ as tileflowNauticalFacilityIcons, dK as tileflowNauticalImageRoles, dL as tileflowNauticalNotice, dM as tileflowNauticalPromoteId, dN as tileflowNauticalSourceId, dO as tileflowNauticalV1Schema, dP as tileflowPrimarySourceId, dQ as tileflowRenderedIconIdentitySchema, dR as tileflowRingsOverlap, dS as tileflowSkyAtSun, dT as tileflowSkyMetadataKey, dU as tileflowStyleSunPreset, dV as tileflowSunDirection, dW as tileflowSunMetadataKey, dX as tileflowSunPosition, dY as tileflowThemeLimits, dZ as tileflowTreeForms, d_ as tileflowTreeModelIdPattern, d$ as tileflowTreeModelLimits, e0 as tileflowVegetationMetadataKey, e1 as tileflowWorld, e2 as tileflowWorldGeneration, e3 as tileflowWorldTileJsonUrl, e4 as tileflowWorldV1Schema, e5 as transit, e6 as validateTileflowCompiledIconCapabilities, v as validateTileflowDataCompatibility, e7 as validateTileflowMap, e8 as validateTileflowWorldV1Tilejson, e9 as vectorTiles, ea as vegetation, eb as water } from './icon-composition-B1A2udKb.js';
 import { z } from 'zod';
-import { V as ValidationMessage, i as TileflowExpression, j as TileflowFixedValue, k as TileflowThemeTokenReference, l as TileflowThemeColorOperation, m as TileflowBackgroundStyle, n as TileflowCircleStyle, o as TileflowExtrusionStyle, p as TileflowFillStyle, q as TileflowLineStyle, r as TileflowSymbolStyle, M as MapLibreStyle, s as TileflowRoadsModuleOptions, u as TileflowRoadsModuleConfig, v as TileflowLabelsModuleOptions, w as TileflowLabelsModuleConfig, x as TileflowPoiModuleOptions, y as TileflowPoiModuleConfig } from './manifest-types-DnhSJjCM.js';
-export { z as MapLibreSprite, A as TileflowAerodromeCodeDetail, B as TileflowAlignment, C as TileflowAnalytics, D as TileflowAreaStyle, E as TileflowBackgroundPaint, F as TileflowCirclePaint, G as TileflowColor, H as TileflowColorStyleValue, I as TileflowExtrusionPaint, J as TileflowFillPaint, K as TileflowIconAnchor, L as TileflowIconLayout, N as TileflowIconPaint, O as TileflowIconStyle, P as TileflowIconTextFit, Q as TileflowImageStyleValue, R as TileflowLabelDetail, S as TileflowLabelLanguage, U as TileflowLabelStyles, W as TileflowLayerRange, X as TileflowLight, Y as TileflowLineCap, Z as TileflowLineHatchStyle, _ as TileflowLineJoin, $ as TileflowLineLayout, a0 as TileflowLinePaint, a1 as TileflowLineStackStyle, a2 as TileflowManifestFetchOptions, a3 as TileflowManifestLoadOptions, a4 as TileflowMapMode, a5 as TileflowMapModeOptions, a6 as TileflowMarkerSymbolStyle, a7 as TileflowMountainBikeScale, a8 as TileflowNumberInsetsStyleValue, a9 as TileflowNumberStyleValue, aa as TileflowPlaceLabelClass, ab as TileflowPoiCategory, ac as TileflowPoiCategoryStyle, ad as TileflowPoiColorMode, ae as TileflowPoiDensity, af as TileflowPoiPlacementOrder, ag as TileflowPriorityOrder, ah as TileflowProjection, ai as TileflowResolvedRuntimeTheme, aj as TileflowRoadAreaStyle, ak as TileflowRoadClass, al as TileflowRoadClassStyle, am as TileflowRoadCrossingStyle, an as TileflowRoadDetail, ao as TileflowRoadExtras, ap as TileflowRoadHierarchy, aq as TileflowRoadLabelDetail, ar as TileflowRoadLayerStyle, as as TileflowRoadModifier, at as TileflowRoadOutline, au as TileflowRoadRestriction, av as TileflowRoadRoundaboutStyle, aw as TileflowRoadServiceType, ax as TileflowRoadShieldDetail, ay as TileflowRoadShieldStyles, az as TileflowRoadSidewalkStyle, aA as TileflowRoadStreetLightStyle, aB as TileflowRoadStructure, aC as TileflowRoadTreatmentLayerStyle, aD as TileflowRoadTreatmentLineStyle, aE as TileflowRoadTreatmentStyle, aF as TileflowRoadWeight, aG as TileflowRuntimeCenterLike, a as TileflowRuntimeColorScheme, T as TileflowRuntimeManifest, aH as TileflowRuntimeManifestMap, b as TileflowRuntimeManifestMapEntry, c as TileflowRuntimeManifestTheme, aI as TileflowRuntimeSource, aJ as TileflowRuntimeSourceValidation, aK as TileflowRuntimeStyle, aL as TileflowRuntimeStyleOptions, d as TileflowRuntimeSystemThemes, aM as TileflowRuntimeViewOptions, aN as TileflowSessionController, aO as TileflowSessionGrantResponse, aP as TileflowStringStyleValue, aQ as TileflowStructuralStyleValue, aR as TileflowStyleFontFace, aS as TileflowStyleValue, aT as TileflowSymbolOverlap, aU as TileflowSymbolPlacement, aV as TileflowSymbolPlacementStyle, aW as TileflowSymbolZOrder, aX as TileflowTerrain, aY as TileflowTerrainConfig, aZ as TileflowTerrainContourLabelStyle, a_ as TileflowTerrainContourLineStyle, a$ as TileflowTerrainContoursConfig, b0 as TileflowTerrainEncoding, b1 as TileflowTerrainHillshadeStyle, b2 as TileflowTerrainLayerRange, b3 as TileflowTerrainMode, b4 as TileflowTextAnchor, b5 as TileflowTextBackground, b6 as TileflowTextJustify, b7 as TileflowTextLayout, b8 as TileflowTextPaint, b9 as TileflowTextStyle, ba as TileflowThemeBlendSelection, bb as TileflowThemeColorAlpha, bc as TileflowThemeColorMix, bd as TileflowThemeColorValue, be as TileflowThemeFontValue, bf as TileflowThemeImageValue, bg as TileflowThemeNumberValue, bh as TileflowThemeSelection, bi as TileflowThemeTokenCategory, bj as TileflowThemeValue, e as TileflowTimeOfDay, f as TileflowTimeOfDayVariants, bk as TileflowViewConfig, bl as TileflowWaterLabelClass, bm as TileflowZoomInterpolation, bn as TileflowZoomValue, bo as ValidationResult, bp as assertValidTileflowRuntimeSource, bq as clearTileflowManifestCache, br as color, bs as createTileflowSessionController, bt as createTileflowSessionId, bu as defaultTileflowManifestUrl, bv as defaultTileflowRuntimeView, bw as fixed, bx as getTileflowAnalyticsApiUrl, by as getTileflowStyleFontFaces, bz as inferTileflowAnalyticsFromStyleUrl, bA as isTileflowTimeOfDay, bB as loadTileflowManifest, bC as mergeTileflowAnalytics, bD as nearestTileflowBlendTheme, bE as normalizeTileflowRuntimeCenter, bF as normalizeTileflowStaticImageSize, bG as normalizeTileflowUrl, bH as resolveTileflowAnalyticsRequestUrl, bI as resolveTileflowManifestMap, bJ as resolveTileflowMapMode, bK as resolveTileflowRuntimeStyle, bL as resolveTileflowRuntimeTheme, bM as resolveTileflowRuntimeThemeBlend, bN as resolveTileflowRuntimeView, bO as resolveTileflowStaticImageUrl, bP as shouldLoadTileflowManifest, bQ as startTileflowSession, bR as tileflowPoiCategories, t as tileflowRuntimeManifestLimits, g as tileflowRuntimeManifestVersion, bS as tileflowStyleFontFaceLimits, bT as tileflowStyleFontFacesMetadataKey, bU as tileflowThemeBlendLimits, bV as tileflowThemeTokenCategories, bW as tileflowTimesOfDay, bX as token, bY as validateTileflowRuntimeSource, bZ as validateTileflowThemeBlendSelection, b_ as validateTileflowThemeSelection, b$ as zoom } from './manifest-types-DnhSJjCM.js';
+import { V as ValidationMessage, i as TileflowExpression, j as TileflowFixedValue, k as TileflowThemeTokenReference, l as TileflowThemeColorOperation, m as TileflowBackgroundStyle, n as TileflowCircleStyle, o as TileflowExtrusionStyle, p as TileflowFillStyle, q as TileflowLineStyle, r as TileflowSymbolStyle, M as MapLibreStyle, s as TileflowRoadsModuleOptions, u as TileflowRoadsModuleConfig, v as TileflowLabelsModuleOptions, w as TileflowLabelsModuleConfig, x as TileflowPoiModuleOptions, y as TileflowPoiModuleConfig } from './manifest-types-B0lQjabX.js';
+export { z as MapLibreSprite, A as TileflowAerodromeCodeDetail, B as TileflowAlignment, C as TileflowAnalytics, D as TileflowAreaStyle, E as TileflowBackgroundPaint, F as TileflowCirclePaint, G as TileflowColor, H as TileflowColorStyleValue, I as TileflowExtrusionPaint, J as TileflowFillPaint, K as TileflowIconAnchor, L as TileflowIconLayout, N as TileflowIconPaint, O as TileflowIconStyle, P as TileflowIconTextFit, Q as TileflowImageStyleValue, R as TileflowLabelDetail, S as TileflowLabelLanguage, U as TileflowLabelStyles, W as TileflowLayerRange, X as TileflowLight, Y as TileflowLineCap, Z as TileflowLineHatchStyle, _ as TileflowLineJoin, $ as TileflowLineLayout, a0 as TileflowLinePaint, a1 as TileflowLineStackStyle, a2 as TileflowManifestFetchOptions, a3 as TileflowManifestLoadOptions, a4 as TileflowMapMode, a5 as TileflowMapModeOptions, a6 as TileflowMarkerSymbolStyle, a7 as TileflowMountainBikeScale, a8 as TileflowNumberInsetsStyleValue, a9 as TileflowNumberStyleValue, aa as TileflowPlaceLabelClass, ab as TileflowPoiCategory, ac as TileflowPoiCategoryStyle, ad as TileflowPoiColorMode, ae as TileflowPoiDensity, af as TileflowPoiPlacementOrder, ag as TileflowPriorityOrder, ah as TileflowProjection, ai as TileflowResolvedRuntimeTheme, aj as TileflowRoadAreaStyle, ak as TileflowRoadClass, al as TileflowRoadClassStyle, am as TileflowRoadCrossingStyle, an as TileflowRoadDetail, ao as TileflowRoadExtras, ap as TileflowRoadHierarchy, aq as TileflowRoadLabelDetail, ar as TileflowRoadLayerStyle, as as TileflowRoadModifier, at as TileflowRoadOutline, au as TileflowRoadRestriction, av as TileflowRoadRoundaboutStyle, aw as TileflowRoadServiceType, ax as TileflowRoadShieldDetail, ay as TileflowRoadShieldStyles, az as TileflowRoadSidewalkStyle, aA as TileflowRoadStreetLightStyle, aB as TileflowRoadStructure, aC as TileflowRoadTreatmentLayerStyle, aD as TileflowRoadTreatmentLineStyle, aE as TileflowRoadTreatmentStyle, aF as TileflowRoadWeight, aG as TileflowRuntimeCenterLike, a as TileflowRuntimeColorScheme, T as TileflowRuntimeManifest, aH as TileflowRuntimeManifestMap, b as TileflowRuntimeManifestMapEntry, c as TileflowRuntimeManifestTheme, aI as TileflowRuntimeSource, aJ as TileflowRuntimeSourceValidation, aK as TileflowRuntimeStyle, aL as TileflowRuntimeStyleOptions, d as TileflowRuntimeSystemThemes, aM as TileflowRuntimeViewOptions, aN as TileflowSessionController, aO as TileflowSessionGrantResponse, aP as TileflowStringStyleValue, aQ as TileflowStructuralStyleValue, aR as TileflowStyleFontFace, aS as TileflowStyleValue, aT as TileflowSymbolOverlap, aU as TileflowSymbolPlacement, aV as TileflowSymbolPlacementStyle, aW as TileflowSymbolZOrder, aX as TileflowTerrain, aY as TileflowTerrainConfig, aZ as TileflowTerrainContourLabelStyle, a_ as TileflowTerrainContourLineStyle, a$ as TileflowTerrainContoursConfig, b0 as TileflowTerrainEncoding, b1 as TileflowTerrainHillshadeStyle, b2 as TileflowTerrainLayerRange, b3 as TileflowTerrainMode, b4 as TileflowTextAnchor, b5 as TileflowTextBackground, b6 as TileflowTextJustify, b7 as TileflowTextLayout, b8 as TileflowTextPaint, b9 as TileflowTextStyle, ba as TileflowThemeBlendSelection, bb as TileflowThemeColorAlpha, bc as TileflowThemeColorMix, bd as TileflowThemeColorValue, be as TileflowThemeFontValue, bf as TileflowThemeImageValue, bg as TileflowThemeNumberValue, bh as TileflowThemeSelection, bi as TileflowThemeTokenCategory, bj as TileflowThemeValue, e as TileflowTimeOfDay, f as TileflowTimeOfDayVariants, bk as TileflowViewConfig, bl as TileflowWaterLabelClass, bm as TileflowZoomInterpolation, bn as TileflowZoomValue, bo as ValidationResult, bp as assertValidTileflowRuntimeSource, bq as clearTileflowManifestCache, br as color, bs as createTileflowSessionController, bt as createTileflowSessionId, bu as defaultTileflowManifestUrl, bv as defaultTileflowRuntimeView, bw as fixed, bx as getTileflowAnalyticsApiUrl, by as getTileflowStyleFontFaces, bz as inferTileflowAnalyticsFromStyleUrl, bA as isTileflowTimeOfDay, bB as loadTileflowManifest, bC as mergeTileflowAnalytics, bD as nearestTileflowBlendTheme, bE as normalizeTileflowRuntimeCenter, bF as normalizeTileflowStaticImageSize, bG as normalizeTileflowUrl, bH as resolveTileflowAnalyticsRequestUrl, bI as resolveTileflowManifestMap, bJ as resolveTileflowMapMode, bK as resolveTileflowRuntimeStyle, bL as resolveTileflowRuntimeTheme, bM as resolveTileflowRuntimeThemeBlend, bN as resolveTileflowRuntimeView, bO as resolveTileflowStaticImageUrl, bP as shouldLoadTileflowManifest, bQ as startTileflowSession, bR as tileflowPoiCategories, t as tileflowRuntimeManifestLimits, g as tileflowRuntimeManifestVersion, bS as tileflowStyleFontFaceLimits, bT as tileflowStyleFontFacesMetadataKey, bU as tileflowThemeBlendLimits, bV as tileflowThemeTokenCategories, bW as tileflowTimesOfDay, bX as token, bY as validateTileflowRuntimeSource, bZ as validateTileflowThemeBlendSelection, b_ as validateTileflowThemeSelection, b$ as zoom } from './manifest-types-B0lQjabX.js';
 export { N as NormalizedTileflowCaptureScene, b as NormalizedTileflowCaptureShot, c as NormalizedTileflowCaptureShotCamera, d as TileflowCaptureApplicationTarget, e as TileflowCaptureBoundsCamera, f as TileflowCaptureCamera, g as TileflowCaptureCenterCamera, h as TileflowCaptureMapTarget, T as TileflowCaptureScene, a as TileflowCaptureShot, i as TileflowCaptureShotBlend, j as TileflowCaptureShotEasing, k as TileflowCaptureShotFrame, l as TileflowCaptureShotKeyframe, m as TileflowCaptureTarget, n as TileflowCaptureViewport, o as normalizeTileflowCaptureId, p as normalizeTileflowCaptureScene, q as normalizeTileflowCaptureShot, t as tileflowCaptureApplicationTargetSchema, r as tileflowCaptureBoundsCameraSchema, s as tileflowCaptureCameraSchema, u as tileflowCaptureCenterCameraSchema, v as tileflowCaptureIdSchema, w as tileflowCaptureMapTargetSchema, x as tileflowCaptureSceneLimits, y as tileflowCaptureSceneNameSchema, z as tileflowCaptureSceneSchema, A as tileflowCaptureSceneSchemaVersion, B as tileflowCaptureShotBlendSchema, C as tileflowCaptureShotFrameCount, D as tileflowCaptureShotFrames, E as tileflowCaptureShotKeyframeSchema, F as tileflowCaptureShotLimits, G as tileflowCaptureShotNameSchema, H as tileflowCaptureShotSchema, I as tileflowCaptureShotSchemaVersion, J as tileflowCaptureTargetSchema, K as tileflowCaptureViewportSchema } from './capture-shot-ChPQvPyi.js';
 export { tileflowPortableIdSchema, tileflowThemeNameSchema } from './capture.js';
 export { parseTileflowRuntimeManifest, safeParseTileflowRuntimeManifest, tileflowRuntimeManifestSchema } from './manifest.js';
@@ -1529,6 +1529,12 @@ type TileflowModelRoleLighting = Readonly<{
     colorMix?: number;
     metallic?: number;
     roughness?: number;
+    /** Map shading normalizes sunlight to the surrounding extruded buildings. */
+    shading?: 'physical' | 'map';
+    /** Multiplier for the scene's model ambient occlusion. Defaults to one. */
+    ambientOcclusion?: number;
+    /** Contribution of named part colours after the role tint. Defaults to one. */
+    partColorMix?: number;
     colorVariation?: Readonly<{
         hue: readonly [number, number];
         saturation: readonly [number, number];
@@ -1596,6 +1602,8 @@ type TileflowBuildings3DDesign = Readonly<{
     /** Shadows from the sun, and contact shadow at the foot of the walls. */
     shadows: boolean;
     occlusion: boolean;
+    /** Ground contact shadow strength; facade shading is independent. */
+    groundOcclusion?: number;
     /** Strength of prepared model ambient visibility; zero leaves the sky contribution unchanged. */
     modelOcclusion?: number;
     /** Building models the map places in its city, each replacing the buildings under it. */
@@ -1703,7 +1711,7 @@ type TileflowModelEntry = TileflowModel & Readonly<{
 /** What compresses a file's buffers: meshoptimizer's encoder, once ready. */
 type TileflowModelCompressor = Readonly<{
     reorderMesh(indices: Uint32Array, triangles: boolean, optsize: boolean): [Uint32Array, number];
-    encodeGltfBuffer(source: Uint8Array, count: number, size: number, mode: string): Uint8Array;
+    encodeGltfBuffer(source: Uint8Array, count: number, size: number, mode: string, version?: number): Uint8Array;
 }>;
 /** What decompresses them: meshoptimizer's decoder, once ready. */
 type TileflowModelDecompressor = Readonly<{

package/dist/index.js

@@ -897,6 +897,7 @@ var init_visual_semantics = __esm({
       "lightness",
       "fadeDuration",
       "gapWidth",
+      "groundOcclusion",
       "haloBlur",
       "haloWidth",
       "height",
@@ -9013,6 +9014,7 @@ function resolvePoi(request) {
     density: request?.density ?? 2,
     detailZoom: request?.detailZoom ?? 17,
     densityByCategory: { ...request?.densityByCategory },
+    maxRankByType: { ...request?.maxRankByType },
     icons: request?.icons ?? true,
     labels: request?.labels ?? true,
     minZoom: request?.minZoom ?? 0,
@@ -9500,6 +9502,9 @@ function compileCategory(category, request, semantics, context, language, select
 }
 function createPoiSelection(semantics, context, language) {
   const { fields: fields2 } = context.data.schema;
+  const typeRankCaps = Object.entries(semantics.maxRankByType).sort(
+    ([a], [b]) => a.localeCompare(b)
+  );
   const shown = /* @__PURE__ */ new Map();
   const iconOnlyTypes = [...new Set(semantics.placement.iconOnlyTypes)];
   const iconOnly = () => iconOnlyTypes.length ? ["match", ["get", fields2.poiType], iconOnlyTypes, true, false] : ["literal", false];
@@ -9535,6 +9540,14 @@ function createPoiSelection(semantics, context, language) {
         [">=", sizeRank, 0],
         ["<=", sizeRank, 16]
       ];
+      if (typeRankCaps.length) {
+        result.push([
+          "match",
+          ["get", fields2.poiType],
+          ...typeRankCaps.flatMap(([type, rank]) => [type, ["<=", filterRank, rank]]),
+          true
+        ]);
+      }
       if (!semantics.icons || !semantics.labels) return result;
       const textless = categories.filter((category) => !shown.get(category)?.text);
       const iconless = categories.filter((category) => !shown.get(category)?.icon);
@@ -13736,6 +13749,9 @@ function readModelRoleLighting(value) {
       ...entry.colorMix === void 0 ? {} : { colorMix: bounded(entry.colorMix, 0, 1, 1) },
       ...entry.metallic === void 0 ? {} : { metallic: bounded(entry.metallic, 0, 1, 0) },
       ...entry.roughness === void 0 ? {} : { roughness: bounded(entry.roughness, 0, 1, 1) },
+      ...entry.shading === "map" || entry.shading === "physical" ? { shading: entry.shading } : {},
+      ...entry.ambientOcclusion === void 0 ? {} : { ambientOcclusion: bounded(entry.ambientOcclusion, 0, 1, 1) },
+      ...entry.partColorMix === void 0 ? {} : { partColorMix: bounded(entry.partColorMix, 0, 1, 1) },
       ...readRoleColorVariation(entry.colorVariation),
       emissiveHeight: Array.isArray(gradient) && gradient.length === 5 && gradient.every(
         (v, i) => typeof v === "number" && Number.isFinite(v) && v <= 1 && v >= (i === 4 ? -1 : 0)
@@ -13819,6 +13835,7 @@ var tileflowDefaultBuildings3DDesign = Object.freeze({
   windows: false,
   shadows: true,
   occlusion: true,
+  groundOcclusion: 0.16,
   modelOcclusion: 0.75
 });
 function tileflowBuildingsMetadata(design) {
@@ -13845,7 +13862,7 @@ function readTileflowBuildings3D(metadata) {
     },
     color: color3,
     edges: within(value.edges, 1, 0),
-    edgeRadius: within(value.edgeRadius, 1, defaults4.edgeRadius),
+    edgeRadius: within(value.edgeRadius, 1.5, defaults4.edgeRadius),
     lighting: value.lighting === "style" ? "style" : defaults4.lighting,
     colorVariation: within(value.colorVariation, 1, 0),
     verticalGradient: value.verticalGradient !== false,
@@ -13858,6 +13875,7 @@ function readTileflowBuildings3D(metadata) {
     ...readTileflowBuildingsEntrance(value.entrance),
     shadows: typeof value.shadows === "boolean" ? value.shadows : defaults4.shadows,
     occlusion: typeof value.occlusion === "boolean" ? value.occlusion : defaults4.occlusion,
+    groundOcclusion: within(value.groundOcclusion, 1, defaults4.groundOcclusion),
     modelOcclusion: within(value.modelOcclusion, 1, defaults4.modelOcclusion),
     ...modelsOf(value.models),
     ...modelColorsOf(value.modelColors),
@@ -17324,6 +17342,9 @@ var modelRoleLightingSchema = z7.object({
   colorMix: boundedThemeNumberSchema(0, 1).optional(),
   metallic: boundedThemeNumberSchema(0, 1).optional(),
   roughness: boundedThemeNumberSchema(0, 1).optional(),
+  shading: z7.enum(["physical", "map"]).optional(),
+  ambientOcclusion: boundedThemeNumberSchema(0, 1).optional(),
+  partColorMix: boundedThemeNumberSchema(0, 1).optional(),
   colorVariation: z7.object({
     hue: z7.tuple([boundedThemeNumberSchema(0, 360), boundedThemeNumberSchema(0, 360)]),
     saturation: z7.tuple([boundedThemeNumberSchema(0, 100), boundedThemeNumberSchema(0, 100)]),
@@ -17350,7 +17371,7 @@ var buildingsModuleSchema = z7.object({
     lighting: z7.enum(["style", "sun"]).optional(),
     colorVariation: boundedThemeNumberSchema(0, 1).optional(),
     edges: boundedThemeNumberSchema(0, 1).optional(),
-    edgeRadius: z7.number().min(0).max(1).optional(),
+    edgeRadius: z7.number().min(0).max(1.5).optional(),
     edgeColor: themeColorValueSchema.optional(),
     nightLight: boundedThemeNumberSchema(0, 2).optional(),
     floodLight: z7.object({
@@ -17373,6 +17394,7 @@ var buildingsModuleSchema = z7.object({
     }).strict().optional(),
     entrance: z7.object({ buildings: entranceBandSchema.optional(), models: entranceBandSchema.optional() }).strict().optional(),
     occlusion: z7.boolean().optional(),
+    groundOcclusion: boundedThemeNumberSchema(0, 1).optional(),
     modelOcclusion: boundedThemeNumberSchema(0, 1).optional(),
     shadows: z7.boolean().optional(),
     windows: z7.boolean().optional(),
@@ -17621,6 +17643,17 @@ var poiModuleSchema = z7.object({
   type: z7.literal("poi"),
   detailZoom: z7.number().finite().gt(16).max(24).optional(),
   categories: z7.array(z7.enum(tileflowPoiCategories)).optional(),
+  maxRankByType: z7.record(
+    z7.string().regex(/^[a-z0-9]+(?:_[a-z0-9]+)*$/u, "Expected a World POI type"),
+    z7.union([
+      z7.literal(0),
+      z7.literal(1),
+      z7.literal(2),
+      z7.literal(3),
+      z7.literal(4),
+      z7.literal(5)
+    ])
+  ).describe("Fixed maximum World filter rank per POI type, independent of zoom detail.").optional(),
   color: z7.enum(["uniform", "category"]).optional(),
   density: z7.union([z7.literal(1), z7.literal(2), z7.literal(3), z7.literal(4), z7.literal(5)]).describe(
     "POI density from 1 to 5. Defaults to 2; native collisions determine which eligible names fit."
@@ -20617,6 +20650,7 @@ function tileflowBuildings3DDesignOf(module, context, layers2, buildingModels, t
     ...readTileflowBuildingsEntrance(style.entrance),
     shadows: typeof style.shadows === "boolean" ? style.shadows : defaults4.shadows,
     occlusion: typeof style.occlusion === "boolean" ? style.occlusion : defaults4.occlusion,
+    groundOcclusion: number(style.groundOcclusion, defaults4.groundOcclusion),
     modelOcclusion: number(style.modelOcclusion, defaults4.modelOcclusion),
     ...placedModels(style.models, buildingModels),
     ...modelColours(style.modelColors),
@@ -25396,7 +25430,13 @@ function encodeTileflowModels(models, compressor) {
       return bufferViews.length - 1;
     }
     const mode = vertices ? "ATTRIBUTES" : "TRIANGLES";
-    const packed = compressor.encodeGltfBuffer(bytes, count, stride, mode);
+    const packed = compressor.encodeGltfBuffer(
+      bytes,
+      count,
+      stride,
+      mode,
+      vertices ? 1 : void 0
+    );
     const byteOffset = addBlob(packed);
     const fallbackOffset = fallbackLength;
     fallbackLength += bytes.byteLength + (4 - bytes.byteLength % 4) % 4;
@@ -25844,6 +25884,24 @@ function quantise(mesh, compressor) {
     order = new Array(unique);
     for (const [index, vertex] of kept.entries())
       if (remap[index] !== 4294967295) order[remap[index]] = vertex;
+  } else if (compressor) {
+    for (const { from, count: length } of mesh.surface.ranges) {
+      const range2 = indices.slice(from, from + length);
+      const [remap, unique] = compressor.reorderMesh(range2, true, false);
+      const global = new Uint32Array(unique);
+      for (const [vertex, local] of remap.entries())
+        if (local !== 4294967295) global[local] = vertex;
+      for (const [at, local] of range2.entries()) indices[from + at] = global[local];
+    }
+    const renumber = new Uint32Array(kept.length).fill(4294967295);
+    order = [];
+    for (const [at, vertex] of indices.entries()) {
+      if (renumber[vertex] === 4294967295) {
+        renumber[vertex] = order.length;
+        order.push(kept[vertex]);
+      }
+      indices[at] = renumber[vertex];
+    }
   }
   const vertices = new Uint8Array(order.length * tileflowModelVertexBytes);
   const attributes = mesh.surface ? new Float32Array(order.length * 8) : void 0;

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

@@ -586,6 +586,8 @@ type TileflowPoiModuleConfig = {
     density?: TileflowPoiDensity;
     /** Category overrides of density, with the same zoom-dependent detail allowance. */
     densityByCategory?: Partial<Record<TileflowPoiCategory, TileflowPoiDensity>>;
+    /** Fixed maximum World filter rank per POI type (0–5), independent of zoom detail. */
+    maxRankByType?: Readonly<Record<string, 0 | 1 | 2 | 3 | 4 | 5>>;
     /** Zoom for the second extra rank of POI detail. Must exceed 16; defaults to 17. */
     detailZoom?: number;
     icons?: boolean;

package/dist/manifest.d.ts

@@ -1,5 +1,5 @@
-import { T as TileflowRuntimeManifest } from './manifest-types-DnhSJjCM.js';
-export { a as TileflowRuntimeColorScheme, b as TileflowRuntimeManifestMapEntry, c as TileflowRuntimeManifestTheme, d as TileflowRuntimeSystemThemes, e as TileflowTimeOfDay, f as TileflowTimeOfDayVariants, t as tileflowRuntimeManifestLimits, g as tileflowRuntimeManifestVersion, h as tileflowTimeOfDayManifestVersion } from './manifest-types-DnhSJjCM.js';
+import { T as TileflowRuntimeManifest } from './manifest-types-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 { z } from 'zod';
 
 declare const tileflowRuntimeManifestSchema: z.ZodType<TileflowRuntimeManifest>;

package/dist/native.d.ts

@@ -362,4 +362,90 @@ declare function planTileflowThemeBlend(styles: readonly MapLibreStyle[], option
 /** Fills one blend template for a position. Plain values pass through unchanged. */
 declare function fillTileflowThemeBlendTemplate(template: unknown, position: number): unknown;
 
-export { type TileflowNativeAbortSignal, type TileflowNativeInitialView, type TileflowNativeInitialViewOptions, type TileflowNativeManifestAcquire, type TileflowNativeManifestLoadOptions, type TileflowNativeManifestOperation, type TileflowNativeManifestReader, type TileflowNativeManifestResponse, type TileflowNativeManifestResult, type TileflowNativeNetworkOptions, type TileflowNativeResourceUrlOptions, type TileflowNativeSource, type TileflowNativeSourceController, TileflowNativeSourceError, type TileflowNativeSourceErrorCode, type TileflowNativeSourceErrorField, type TileflowNativeSourceOptions, type TileflowNativeSourceState, TileflowNativeUrlError, type TileflowNativeUrlErrorCode, type TileflowNativeUrlField, type TileflowThemeBlendClock, TileflowThemeBlendError, type TileflowThemeBlendImage, type TileflowThemeBlendOptions, type TileflowThemeBlendPaint, type TileflowThemeBlendPlan, type TileflowThemeBlendSelection, type TileflowThemeBlendSwitch, type TileflowTimeOfDay, type TileflowTimeOfDayVariants, createTileflowNativeSourceController, fillTileflowThemeBlendTemplate, loadTileflowNativeManifest, nearestTileflowBlendTheme, planTileflowThemeBlend, resolveTileflowNativeInitialView, resolveTileflowNativeManifestUrl, resolveTileflowNativeResourceUrl, tileflowNativeManifestLimits, tileflowNativeUrlLimits, tileflowThemeBlendLimits, validateTileflowThemeBlendSelection };
+/**
+ * Boundaries families. Each one has its own license, attribution, TileJSON path and style source
+ * ID; families are never merged.
+ */
+declare const tileflowBoundaryFamilies: Readonly<{
+    boundaries: Readonly<{
+        attribution: "© OpenStreetMap contributors";
+        license: "ODbL-1.0";
+        path: "/tiles/boundaries/tiles.json";
+        sourceId: "tileflow-boundaries";
+    }>;
+}>;
+type TileflowBoundaryFamily = keyof typeof tileflowBoundaryFamilies;
+
+/** A value a choropleth can colour: a number for scales, a string for categories. */
+type TileflowBoundaryValue = number | string;
+/** One row of an application's data, keyed by a registry ID or an official code. */
+type TileflowBoundaryRow = Readonly<{
+    key: number | string;
+    /** `null` leaves the area without a value. */
+    value: TileflowBoundaryValue | null;
+}>;
+/** Keys present on every `boundary_area` polygon, usable without the lookup table. */
+type TileflowBoundaryFeatureKey = 'id' | 'iso_3166_1' | 'ref';
+/** Rows joined to areas by one polygon key. */
+type TileflowBoundaryValues = Readonly<{
+    joinBy: TileflowBoundaryFeatureKey;
+    rows: readonly TileflowBoundaryRow[];
+}>;
+
+type FeatureTarget = {
+    id?: number | string;
+    source: string;
+    sourceLayer?: string;
+};
+/** The part of a MapLibre map the controller uses. */
+type TileflowFeatureStateMap = {
+    getSource(id: string): unknown;
+    getStyle?(): {
+        sources?: Record<string, unknown>;
+    } | undefined;
+    off(type: 'styledata', listener: () => void): unknown;
+    on(type: 'styledata', listener: () => void): unknown;
+    removeFeatureState(target: FeatureTarget, key?: string): void;
+    setFeatureState(target: FeatureTarget & {
+        id: number | string;
+    }, state: Record<string, unknown>): void;
+};
+type CreateBoundaryFeatureStateOptions = Readonly<{
+    /** Defaults to `boundaries`. */
+    family?: TileflowBoundaryFamily;
+    /** Also set the values on `boundary_label` points, for labels styled by value. */
+    labels?: boolean;
+    /** Feature-state key; it must match the choropleth's `state`. Defaults to `value`. */
+    state?: string;
+}>;
+type TileflowBoundaryFeatureState = Readonly<{
+    /** Remove every value this controller set. */
+    clear: () => void;
+    /** Remove the values and stop following style reloads. */
+    dispose: () => void;
+    /**
+     * Replace the values. Rows must be keyed by the source's feature ID: `id` by default, or `ref`
+     * when the map declares `promoteId: 'ref'`. Rows with a `null` value are removed.
+     */
+    set: (values: TileflowBoundaryValues) => void;
+}>;
+/**
+ * Keep Boundaries feature-state in sync with application rows. Values survive a style reload: the
+ * controller sets them again once the source is back.
+ */
+declare function createBoundaryFeatureState(map: TileflowFeatureStateMap, options?: CreateBoundaryFeatureStateOptions): TileflowBoundaryFeatureState;
+
+/** Public selectors only; authority is acquired separately for each protected resource. */
+type TileflowMobileDiscovery = Readonly<{
+    version: 1;
+    mapId: string;
+    deploymentVersion: number;
+    representations: Readonly<Partial<Record<'native-v1' | 'webview-v1', Readonly<{
+        manifestUrl: string;
+    }>>>>;
+}>;
+declare const tileflowMobileDiscoveryMaximumBytes = 4096;
+/** Bind every advertised representation to the exact Hosted origin and Map being requested. */
+declare function parseTileflowMobileDiscovery(value: unknown, discoveryUrl: string): TileflowMobileDiscovery;
+
+export { type CreateBoundaryFeatureStateOptions, type TileflowBoundaryFamily, type TileflowBoundaryFeatureState, type TileflowBoundaryRow, type TileflowBoundaryValues, type TileflowFeatureStateMap, type TileflowMobileDiscovery, type TileflowNativeAbortSignal, type TileflowNativeInitialView, type TileflowNativeInitialViewOptions, type TileflowNativeManifestAcquire, type TileflowNativeManifestLoadOptions, type TileflowNativeManifestOperation, type TileflowNativeManifestReader, type TileflowNativeManifestResponse, type TileflowNativeManifestResult, type TileflowNativeNetworkOptions, type TileflowNativeResourceUrlOptions, type TileflowNativeSource, type TileflowNativeSourceController, TileflowNativeSourceError, type TileflowNativeSourceErrorCode, type TileflowNativeSourceErrorField, type TileflowNativeSourceOptions, type TileflowNativeSourceState, TileflowNativeUrlError, type TileflowNativeUrlErrorCode, type TileflowNativeUrlField, type TileflowThemeBlendClock, TileflowThemeBlendError, type TileflowThemeBlendImage, type TileflowThemeBlendOptions, type TileflowThemeBlendPaint, type TileflowThemeBlendPlan, type TileflowThemeBlendSelection, type TileflowThemeBlendSwitch, type TileflowTimeOfDay, type TileflowTimeOfDayVariants, createBoundaryFeatureState, createTileflowNativeSourceController, fillTileflowThemeBlendTemplate, loadTileflowNativeManifest, nearestTileflowBlendTheme, parseTileflowMobileDiscovery, planTileflowThemeBlend, resolveTileflowNativeInitialView, resolveTileflowNativeManifestUrl, resolveTileflowNativeResourceUrl, tileflowBoundaryFamilies, tileflowMobileDiscoveryMaximumBytes, tileflowNativeManifestLimits, tileflowNativeUrlLimits, tileflowThemeBlendLimits, validateTileflowThemeBlendSelection };

package/dist/native.js

@@ -5951,18 +5951,211 @@ function snapshotView(input) {
 
 // src/native.ts
 init_theme_blend();
+
+// src/boundary-areas/schema.ts
+var tileflowBoundaryClasses = [
+  "country",
+  "dependency",
+  "region",
+  "province_or_county",
+  "municipality",
+  "district",
+  "neighbourhood"
+];
+var tileflowBoundaryClassTiers = ["primary", "secondary"];
+var tileflowBoundaryAreasV1Schema = Object.freeze({
+  classes: tileflowBoundaryClasses,
+  /** First zoom at which each class appears, by tier. */
+  classMinzoom: Object.freeze({
+    country: Object.freeze({ primary: 0, secondary: 0 }),
+    dependency: Object.freeze({ primary: 0, secondary: 0 }),
+    region: Object.freeze({ primary: 3, secondary: 3 }),
+    province_or_county: Object.freeze({ primary: 6, secondary: 7 }),
+    municipality: Object.freeze({ primary: 8, secondary: 8 }),
+    district: Object.freeze({ primary: 10, secondary: 10 }),
+    neighbourhood: Object.freeze({ primary: 11, secondary: 11 })
+  }),
+  fields: Object.freeze({
+    adminDepth: "admin_depth",
+    adminLevel: "admin_level",
+    class: "class",
+    classTier: "class_tier",
+    iso31661: "iso_3166_1",
+    iso31662: "iso_3166_2",
+    name: "name",
+    nuts: "nuts",
+    ref: "ref",
+    wikidata: "wikidata"
+  }),
+  layers: Object.freeze({ areas: "boundary_area", labels: "boundary_label" }),
+  /** Properties present on `boundary_area` polygons. */
+  areaProperties: Object.freeze([
+    "class",
+    "class_tier",
+    "admin_level",
+    "admin_depth",
+    "ref",
+    "iso_3166_1"
+  ]),
+  maxzoom: 12,
+  minzoom: 0,
+  product: "boundaries-v1",
+  schemaVersion: 1,
+  tiers: tileflowBoundaryClassTiers
+});
+var tileflowBoundaryFamilies = Object.freeze({
+  boundaries: Object.freeze({
+    attribution: "\xA9 OpenStreetMap contributors",
+    license: "ODbL-1.0",
+    path: "/tiles/boundaries/tiles.json",
+    sourceId: "tileflow-boundaries"
+  })
+});
+function isTileflowBoundaryFamily(value) {
+  return typeof value === "string" && Object.hasOwn(tileflowBoundaryFamilies, value);
+}
+
+// src/boundary-areas/feature-state.ts
+function createBoundaryFeatureState(map2, options = {}) {
+  const family = options.family ?? "boundaries";
+  if (!isTileflowBoundaryFamily(family)) {
+    throw new Error(`Unknown Tileflow Boundaries family: ${String(family)}.`);
+  }
+  const source = tileflowBoundaryFamilies[family].sourceId;
+  const stateKey = options.state?.trim() || "value";
+  const sourceLayers = [
+    tileflowBoundaryAreasV1Schema.layers.areas,
+    ...options.labels ? [tileflowBoundaryAreasV1Schema.layers.labels] : []
+  ];
+  let applied = /* @__PURE__ */ new Map();
+  let disposed = false;
+  const write = (id, value) => {
+    for (const sourceLayer of sourceLayers) {
+      map2.setFeatureState({ id, source, sourceLayer }, { [stateKey]: value });
+    }
+  };
+  const erase = (id) => {
+    for (const sourceLayer of sourceLayers) {
+      map2.removeFeatureState({ id, source, sourceLayer }, stateKey);
+    }
+  };
+  const sourceReady = () => map2.getSource(source) !== void 0;
+  let pendingReload = false;
+  const onStyleData = () => {
+    if (!sourceReady()) {
+      pendingReload = true;
+      return;
+    }
+    if (!pendingReload) return;
+    pendingReload = false;
+    for (const [id, value] of applied) write(id, value);
+  };
+  map2.on("styledata", onStyleData);
+  const assertOpen = () => {
+    if (disposed) throw new Error("This Boundaries feature-state controller was disposed.");
+  };
+  return Object.freeze({
+    clear() {
+      assertOpen();
+      if (sourceReady()) for (const id of applied.keys()) erase(id);
+      applied = /* @__PURE__ */ new Map();
+    },
+    dispose() {
+      if (disposed) return;
+      if (sourceReady()) for (const id of applied.keys()) erase(id);
+      applied = /* @__PURE__ */ new Map();
+      map2.off("styledata", onStyleData);
+      disposed = true;
+    },
+    set(values) {
+      assertOpen();
+      const featureKey = promotedKey(map2, source) ?? "id";
+      if (values.joinBy !== featureKey) {
+        throw new Error(
+          `Boundaries feature-state is keyed by ${featureKey}; join the rows to ${featureKey} first with joinBoundaryRows.`
+        );
+      }
+      const next = /* @__PURE__ */ new Map();
+      for (const row of values.rows) {
+        if (row.value === null) continue;
+        if (featureKey === "id") {
+          if (typeof row.key !== "number" || !Number.isSafeInteger(row.key) || row.key < 0) {
+            throw new Error("Boundaries feature-state rows keyed by id need integer keys.");
+          }
+        } else if (typeof row.key !== "string" || !row.key) {
+          throw new Error("Boundaries feature-state rows keyed by ref need string keys.");
+        }
+        next.set(row.key, row.value);
+      }
+      if (sourceReady()) {
+        for (const id of applied.keys()) if (!next.has(id)) erase(id);
+        for (const [id, value] of next) if (applied.get(id) !== value) write(id, value);
+      } else {
+        pendingReload = true;
+      }
+      applied = next;
+    }
+  });
+}
+function promotedKey(map2, source) {
+  const definition = map2.getStyle?.()?.sources?.[source];
+  const promoteId = definition?.promoteId;
+  if (promoteId === void 0) return void 0;
+  const value = typeof promoteId === "string" ? promoteId : promoteId[tileflowBoundaryAreasV1Schema.layers.areas];
+  return value === "ref" ? "ref" : void 0;
+}
+
+// src/mobile-discovery.ts
+var tileflowMobileDiscoveryMaximumBytes = 4096;
+function parseTileflowMobileDiscovery(value, discoveryUrl) {
+  const fail = () => {
+    throw new Error("Invalid mobile discovery.");
+  };
+  if (typeof discoveryUrl !== "string" || discoveryUrl.length > 2048) return fail();
+  const url = parseNativeUrl(discoveryUrl);
+  const match = /^\/maps\/(map_[A-Za-z0-9_-]{16})\/mobile\/manifest\.json$/u.exec(url.pathname);
+  if (!match || url.protocol !== "https:" || discoveryUrl !== `${url.origin}${url.pathname}`)
+    return fail();
+  const record2 = (candidate) => candidate !== null && typeof candidate === "object" && !Array.isArray(candidate);
+  if (!record2(value) || Object.keys(value).sort().join(",") !== "deploymentVersion,mapId,representations,version")
+    return fail();
+  if (value.version !== 1 || value.mapId !== match[1] || !Number.isSafeInteger(value.deploymentVersion) || Number(value.deploymentVersion) < 1 || !record2(value.representations))
+    return fail();
+  const representations = {};
+  const entries = Object.entries(value.representations);
+  if (!entries.length || entries.length > 2) fail();
+  for (const [profile, representation] of entries) {
+    if (profile !== "native-v1" && profile !== "webview-v1") return fail();
+    if (!record2(representation) || Object.keys(representation).join(",") !== "manifestUrl")
+      return fail();
+    const path = profile === "native-v1" ? "native" : "mobile/webview-v1";
+    const expected = `${url.origin}/maps/${value.mapId}/${path}/manifest.json`;
+    if (representation.manifestUrl !== expected) fail();
+    representations[profile] = Object.freeze({ manifestUrl: expected });
+  }
+  return Object.freeze({
+    version: 1,
+    mapId: value.mapId,
+    deploymentVersion: Number(value.deploymentVersion),
+    representations: Object.freeze(representations)
+  });
+}
 export {
   TileflowNativeSourceError,
   TileflowNativeUrlError,
   TileflowThemeBlendError,
+  createBoundaryFeatureState,
   createTileflowNativeSourceController,
   fillTileflowThemeBlendTemplate,
   loadTileflowNativeManifest,
   nearestTileflowBlendTheme,
+  parseTileflowMobileDiscovery,
   planTileflowThemeBlend,
   resolveTileflowNativeInitialView,
   resolveTileflowNativeManifestUrl,
   resolveTileflowNativeResourceUrl,
+  tileflowBoundaryFamilies,
+  tileflowMobileDiscoveryMaximumBytes,
   tileflowNativeManifestLimits,
   tileflowNativeUrlLimits,
   tileflowThemeBlendLimits,