@tileflow/core 0.1.0-alpha.35 → 0.1.0-alpha.36

package/dist/browser.d.ts

@@ -380,386 +380,6 @@ type TileflowMarkerSymbolStyle = TileflowSymbolStyle & {
     marker?: TileflowCircleStyle;
 };
 
-type TileflowColor = `#${string}`;
-type TileflowRoadDetail = 'none' | 'highways' | 'major' | 'streets' | 'all';
-type TileflowRoadClass = 'motorway' | 'trunk' | 'primary' | 'secondary' | 'tertiary' | 'minor' | 'service' | 'track' | 'pathway' | 'footway' | 'cycleway' | 'steps' | 'pedestrian';
-type TileflowRoadHierarchy = 'subtle' | 'clear' | 'strong';
-type TileflowRoadWeight = 'thin' | 'regular' | 'bold';
-type TileflowRoadOutline = 'none' | 'subtle' | 'strong';
-type TileflowRoadStructure = 'bridge' | 'surface' | 'tunnel';
-type TileflowRoadExtras = {
-    paths?: boolean;
-};
-type TileflowRoadLayerStyle = TileflowLineStackStyle & {
-    hatch?: TileflowLineHatchStyle;
-};
-type TileflowRoadTreatmentLineStyle = Pick<TileflowLinePaint, 'blur' | 'color' | 'dash' | 'gapWidth' | 'offset' | 'opacity' | 'width'>;
-type TileflowRoadTreatmentLayerStyle = {
-    casing?: TileflowRoadTreatmentLineStyle;
-    fill?: TileflowRoadTreatmentLineStyle;
-    shadow?: TileflowRoadTreatmentLineStyle;
-};
-type TileflowRoadTreatmentStyle = Partial<Record<TileflowRoadStructure, TileflowRoadTreatmentLayerStyle>> & {
-    enabled?: boolean;
-    widthScale?: TileflowThemeNumberValue;
-};
-type TileflowRoadModifier = 'construction' | 'expressway' | 'indoor' | 'official' | 'ramp' | 'unpaved';
-type TileflowRoadRestriction = 'access' | 'bicycle' | 'foot' | 'horse' | 'toll';
-type TileflowMountainBikeScale = '0' | '0+' | '1' | '1+' | '2' | '2+' | '3' | '3+' | '4' | '5' | '6';
-type TileflowRoadServiceType = 'alley' | 'crossover' | 'driveway' | 'parkingAisle' | 'yard';
-type TileflowRoadClassStyle = Partial<Record<TileflowRoadStructure, TileflowRoadLayerStyle>> & {
-    enabled?: boolean;
-};
-type TileflowRoadAreaStyle = {
-    pedestrian?: TileflowAreaStyle;
-    pier?: TileflowAreaStyle;
-    road?: TileflowAreaStyle;
-};
-type TileflowRoadCrossingStyle = Omit<TileflowIconStyle, 'image'> & Required<Pick<TileflowIconStyle, 'image'>>;
-type TileflowRoadRoundaboutStyle = {
-    casing?: TileflowCircleStyle;
-    fill?: TileflowCircleStyle;
-};
-/**
- * How Core's street lights renderer lights the map's streets at night, from the lamps and lit
- * streets its data holds.
- */
-type TileflowRoadStreetLightStyle = {
-    /** The light of lamps whose data gives no colour; a warm white by default. */
-    color?: TileflowThemeColorValue;
-    /** Whether the map has street lights; defaults to true where the data binds street furniture. */
-    enabled?: boolean;
-    /**
-     * Where light is estimated where the data maps no lamps: `lit` (the default) along streets and
-     * pavements mapped as lit; `streets` also along streets the data says nothing about, in tiles
-     * that map few lamps, which invents light; `none` nowhere.
-     */
-    estimate?: 'lit' | 'streets' | 'none';
-    /** How bright the lights shine, from 0 to 2; defaults to 1. */
-    intensity?: TileflowThemeNumberValue;
-};
-type TileflowRoadSidewalkStyle = {
-    outline?: TileflowLineStyle;
-    pattern?: TileflowFillStyle;
-    surface?: TileflowFillStyle;
-};
-type TileflowRoadsModuleConfig = {
-    type: 'roads';
-    areas?: TileflowRoadAreaStyle;
-    classes?: Partial<Record<TileflowRoadClass, TileflowRoadClassStyle>>;
-    crossings?: TileflowRoadCrossingStyle;
-    detail?: TileflowRoadDetail;
-    extras?: TileflowRoadExtras;
-    hierarchy?: TileflowRoadHierarchy;
-    modifiers?: Partial<Record<TileflowRoadModifier, TileflowRoadTreatmentStyle>>;
-    mountainBike?: Partial<Record<TileflowMountainBikeScale, TileflowRoadTreatmentStyle>>;
-    oneWayMarkers?: boolean;
-    outline?: TileflowRoadOutline;
-    restrictions?: Partial<Record<TileflowRoadRestriction, TileflowRoadTreatmentStyle>>;
-    roundabouts?: TileflowRoadRoundaboutStyle;
-    serviceTypes?: Partial<Record<TileflowRoadServiceType, TileflowRoadTreatmentStyle>>;
-    sidewalks?: TileflowRoadSidewalkStyle;
-    streetLights?: TileflowRoadStreetLightStyle;
-    structures?: Partial<Record<TileflowRoadStructure, TileflowRoadLayerStyle>>;
-    weight?: TileflowRoadWeight;
-    widthScale?: Partial<Record<TileflowRoadClass, TileflowThemeNumberValue>>;
-};
-type TileflowLabelDetail = 'none' | 'major' | 'all';
-type TileflowAerodromeCodeDetail = 'none' | 'iata' | 'all';
-type TileflowRoadLabelDetail = TileflowRoadDetail;
-type TileflowLabelLanguage = 'auto' | 'local' | 'en' | (string & {});
-type TileflowPlaceLabelClass = 'city' | 'continent' | 'country' | 'neighborhood' | 'other' | 'state' | 'town' | 'village';
-type TileflowWaterLabelClass = 'line' | 'ocean' | 'other' | 'waterway';
-type TileflowRoadShieldDetail = 'none' | 'major' | 'all';
-type TileflowLabelCollisionPriority = 'balanced' | 'navigation';
-type TileflowRoadShieldStyles = {
-    default?: TileflowSymbolStyle;
-    detail?: TileflowSymbolStyle;
-    kinds?: Record<string, {
-        image: TileflowThemeImageValue;
-    }>;
-    overview?: TileflowSymbolStyle;
-    textColors?: Record<string, {
-        color: TileflowThemeColorValue;
-    }>;
-};
-type TileflowLabelStyles = {
-    aerodrome?: TileflowSymbolStyle;
-    junctions?: TileflowSymbolStyle;
-    places?: Partial<Record<TileflowPlaceLabelClass, TileflowSymbolStyle>>;
-    roads?: Partial<Record<TileflowRoadClass, TileflowSymbolStyle>>;
-    shields?: TileflowRoadShieldStyles;
-    water?: Partial<Record<TileflowWaterLabelClass, TileflowSymbolStyle>>;
-};
-type TileflowLabelsModuleConfig = {
-    type: 'labels';
-    aerodromeCodes?: TileflowAerodromeCodeDetail;
-    collisionPriority?: TileflowLabelCollisionPriority;
-    junctions?: boolean;
-    language?: TileflowLabelLanguage;
-    places?: TileflowLabelDetail;
-    roadClasses?: readonly TileflowRoadClass[];
-    roads?: TileflowRoadLabelDetail;
-    shields?: TileflowRoadShieldDetail;
-    styles?: TileflowLabelStyles;
-    water?: TileflowLabelDetail;
-};
-/** Closed editorial vocabulary emitted by Tileflow World's canonical POI projection. */
-declare const tileflowPoiCategories: readonly ["arts-entertainment", "education", "food-drink", "landmark", "lodging", "medical", "park-nature", "public-services", "religion", "retail", "sport-leisure", "transport", "visitor-amenity"];
-type TileflowPoiCategory = (typeof tileflowPoiCategories)[number];
-type TileflowPoiDensity = 1 | 2 | 3 | 4 | 5;
-type TileflowPoiColorMode = 'uniform' | 'category';
-/**
- * How POI categories are placed against each other. `importance` places every category in one
- * order, by World's ranks. `categories` gives each category its own layer and places the
- * categories in the order they are listed, the first on top; ranks order each category only.
- */
-type TileflowPoiPlacementOrder = 'categories' | 'importance';
-/**
- * The appearance of one POI category. With the default `importance` order every category shares
- * one placement layer, so categories may differ only in properties MapLibre evaluates per feature
- * (image, size, colors, font, offsets); layer-wide properties such as zoom ranges, padding,
- * overlap or `optional` must match, or the module uses `placement.order: 'categories'`.
- */
-type TileflowPoiCategoryStyle = Omit<TileflowMarkerSymbolStyle, 'priority'>;
-type TileflowPoiModuleConfig = {
-    type: 'poi';
-    categories?: readonly TileflowPoiCategory[];
-    color?: TileflowPoiColorMode;
-    /** One density for the whole module: World's ranks decide what each category shows. */
-    density?: TileflowPoiDensity;
-    icons?: boolean;
-    labels?: boolean;
-    minZoom?: number;
-    placement?: {
-        /**
-         * Places each pictogram with its name as one unit that needs room for both. Defaults to
-         * `false`.
-         */
-        coupleIconAndLabel?: boolean;
-        iconPadding?: number;
-        /**
-         * World POI `type` values whose pictogram explains them. When pictograms and names are both
-         * drawn, every other POI needs a name, and these types are drawn as a pictogram alone.
-         * Defaults to parking and public toilets.
-         */
-        iconOnlyTypes?: readonly string[];
-        /** Defaults to `importance`. */
-        order?: TileflowPoiPlacementOrder;
-        /**
-         * With the `importance` order, POIs whose World `filter_rank` is at most this value are placed
-         * before the map's road and place labels, and the others after them. A map that gives street
-         * names priority over POIs (labels `collisionPriority: 'navigation'`) keeps its landmarks this
-         * way. Unset, every POI is placed at the module's own position.
-         */
-        prominentRank?: 0 | 1 | 2 | 3 | 4 | 5;
-        textPadding?: number;
-    };
-    styles?: Partial<Record<TileflowPoiCategory, TileflowPoiCategoryStyle>>;
-};
-type MapLibreSprite = string | Array<{
-    id: string;
-    url: string;
-}>;
-type TileflowProjection = 'globe' | 'mercator';
-type TileflowLight = {
-    anchor?: 'map' | 'viewport';
-    color?: TileflowColor;
-    intensity?: number;
-    position?: readonly [number, number, number];
-};
-type MapLibreStyle = {
-    sky?: Record<string, unknown>;
-    version: 8;
-    name: string;
-    glyphs?: string;
-    light?: TileflowLight;
-    projection?: {
-        type: TileflowProjection;
-    };
-    sprite?: MapLibreSprite;
-    sources: Record<string, Record<string, unknown>>;
-    layers: Array<Record<string, unknown>>;
-    terrain?: Record<string, unknown>;
-    metadata?: Record<string, unknown>;
-};
-
-declare const tileflowSunMetadataKey = "tileflow:sun";
-/** A theme's sun and sky light with every value resolved; see `TileflowThemeSun`. */
-type TileflowSunPreset = Readonly<{
-    /** Degrees clockwise from north, from 0 to 360. */
-    azimuth: number;
-    /** Degrees above the horizon, from -90 to 90. */
-    altitude: number;
-    /** The direct light's colour. */
-    color: string;
-    /** The direct light's strength, from 0 to 1. */
-    intensity: number;
-    /** How dark the shadows the sun casts fall, from 0 (none) to 1. */
-    shadowIntensity: number;
-    /** The light from the sky, which reaches every surface and fills the shadows. */
-    ambient: Readonly<{
-        color: string;
-        intensity: number;
-    }>;
-}>;
-/** The sun as the map shows it, ready for an application's own layers. */
-type TileflowSun = Readonly<{
-    /** Degrees clockwise from north, from 0 to 360. */
-    azimuth: number;
-    /** Degrees above the horizon, from -90 to 90. */
-    altitude: number;
-    /** A unit vector towards the sun: x east, y north, z up. */
-    direction: readonly [number, number, number];
-    /** The direct light's colour, as a CSS colour. */
-    color: string;
-    /** The direct light's colour as sRGB channels from 0 to 1. */
-    rgb: readonly [number, number, number];
-    /**
-     * The direct light's strength, from 0 to 1. It fades to 0 as the sun sets: a sun below the
-     * horizon lights nothing and casts no shadow.
-     */
-    intensity: number;
-    /** How dark the shadows the sun casts fall, from 0 (none) to 1. */
-    shadowIntensity: number;
-    /** The light from the sky, which reaches every surface and fills the shadows. */
-    ambient: Readonly<{
-        color: string;
-        rgb: readonly [number, number, number];
-        intensity: number;
-    }>;
-    /**
-     * How bright flat, open ground is under this light, from 0 (dark) to 1: the sky's light plus the
-     * sun's at its height, each weighted by its colour's luminance. Use it to switch lamps or windows
-     * on as a scene darkens, whatever theme or sun lights it.
-     */
-    brightness: number;
-    /** Where the direction comes from: the themes, angles, or a date and place. */
-    source: 'theme' | 'direction' | 'date';
-}>;
-/** The sun of a theme that leaves a value unset: high in the south-south-west, in white light. */
-declare const tileflowDefaultSunPreset: TileflowSunPreset;
-/**
- * Where the sun stands for an instant and a place ([longitude, latitude] in degrees): its azimuth
- * in degrees clockwise from north and its apparent altitude above the horizon, with atmospheric
- * refraction. It follows NOAA's solar equations, accurate to about a hundredth of a degree for
- * years 1800 to 2200.
- */
-declare function tileflowSunPosition(date: Date | number, location: readonly [number, number]): Readonly<{
-    azimuth: number;
-    altitude: number;
-}>;
-/** A unit vector towards a direction in the sky: x east, y north, z up. */
-declare function tileflowSunDirection(azimuth: number, altitude: number): readonly [number, number, number];
-/**
- * The sun as the map shows it: a preset's light from a direction. Direct light fades out over the
- * sun's last degrees above the horizon and is gone below it.
- */
-declare function resolveTileflowSun(preset: TileflowSunPreset, direction?: Readonly<{
-    azimuth: number;
-    altitude: number;
-}>, source?: TileflowSun['source']): TileflowSun;
-/**
- * A preset `t` of the way from `from` to `to`: the azimuth turns the short way round, colours mix
- * in OKLab, as theme blends mix paint colours, and numbers linearly.
- */
-declare function mixTileflowSunPresets(from: TileflowSunPreset, to: TileflowSunPreset, t: number): TileflowSunPreset;
-/** Reads the sun a compiled style publishes, or undefined when its metadata has none. */
-declare function readTileflowSunPreset(metadata: unknown): TileflowSunPreset | undefined;
-/**
- * The sun of a compiled style: the one it publishes, else one read from its light (a style whose
- * theme describes no sun lights its extrusions from `light.position`), else the default.
- */
-declare function tileflowStyleSunPreset(style: {
-    light?: unknown;
-    metadata?: unknown;
-} | undefined): TileflowSunPreset;
-
-type TileflowThemeColorScheme = 'dark' | 'light';
-
-declare const tileflowRouteMetadataKey = "tileflow:route";
-/** The resolved inks of a route, from its outer glow to its bright core. */
-type TileflowRouteInks = Readonly<{
-    /** The chosen route's line. */
-    line: string;
-    /** The edge on each side of the line, which sets it apart from the roads under it. */
-    casing: string;
-    /** A thin line along the middle of the route. */
-    core: string;
-    /** A soft halo around the route. */
-    glow: string;
-    /** Other routes offered beside the chosen one. */
-    alternative: string;
-    /** Opacity of the glow, from 0 (no glow) to 1. */
-    glowOpacity: number;
-    /** Opacity of the core, from 0 (no core) to 1. */
-    coreOpacity: number;
-}>;
-/** The inks of a theme that sets no route tokens: a blue that reads on either kind of map. */
-declare const tileflowDefaultRouteInks: Readonly<Record<TileflowThemeColorScheme, TileflowRouteInks>>;
-/**
- * Reads the route inks a compiled style publishes, or undefined when its metadata has none (a
- * style compiled before route inks, or not by Tileflow).
- */
-declare function readTileflowRouteInks(metadata: unknown): TileflowRouteInks | undefined;
-/**
- * The route inks of a compiled style: those it publishes, or the defaults of its colour scheme
- * (from its `tileflow:colorScheme` metadata, else `fallbackScheme`).
- */
-declare function tileflowStyleRouteInks(style: {
-    metadata?: unknown;
-} | undefined, fallbackScheme?: TileflowThemeColorScheme): TileflowRouteInks;
-/**
- * Inks between two themes' inks, `t` of the way from `from` to `to`: colours mix in OKLab, as theme
- * blends mix paint colours, and opacities linearly.
- */
-declare function mixTileflowRouteInks(from: TileflowRouteInks, to: TileflowRouteInks, t: number): TileflowRouteInks;
-
-type TileflowRuntimeColorScheme = 'dark' | 'light';
-
-type TileflowAnalytics = {
-    apiUrl?: string;
-    endpoint?: string;
-    enabled?: boolean;
-    mapId?: string;
-    metadata?: Record<string, unknown>;
-    projectId?: string;
-    sdkVersion?: string;
-    source?: string;
-    styleId?: string;
-    surfaceId?: string;
-};
-type TileflowSessionController = {
-    readonly sessionId: string;
-    resolveRequestUrl(url: string, analytics: TileflowAnalytics | undefined): Promise<string | undefined>;
-};
-type TileflowRuntimeStyle = {
-    analytics?: TileflowAnalytics;
-    colorScheme?: TileflowRuntimeColorScheme;
-    /** An explicit empty array means the manifest declares that no web fonts are required. */
-    fontFaces?: TileflowStyleFontFace[];
-    revision?: string;
-    style: MapLibreStyle | string;
-    theme?: string;
-};
-type TileflowStyleFontFace = {
-    family: string;
-    source: string;
-    style?: 'italic' | 'normal' | 'oblique';
-    weight?: '100' | '200' | '300' | '400' | '500' | '600' | '700' | '800' | '900';
-};
-/**
- * A continuous blend of named themes of one Tileflow map. `position` places the map between
- * neighbouring themes: 0 is the first, 1 the second, and 1.25 a quarter of the way from the second
- * to the third.
- */
-type TileflowThemeBlendSelection = Readonly<{
-    /** From 0 to `themes.length - 1`. */
-    position: number;
-    /** Two to eight concrete theme names of the map, in blend order. */
-    themes: readonly string[];
-}>;
-
 type TileflowAddressesModuleOptions = {
     /** Styling for OpenMapTiles point house-number labels. */
     labels?: TileflowSymbolStyle;
@@ -794,19 +414,21 @@ type TileflowBuildingMode = '3d' | 'flat';
  * building colour (its extrusion), else its roofs'.
  */
 type TileflowBuildingsThreeDimensionalStyle = {
-    /** Use the style's extrusion light (default), or the theme controller's scene sun. */
+    /** Use the scene sun (default), or the style's native extrusion light. */
     lighting?: 'style' | 'sun';
     /** Per-building brightness variation, from 0 to 1; defaults to 0 (authored colour). */
     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. */
+    edgeRadius?: number;
     /** Their own colour, drawn unlit; without it they take the building's colour, lightened. */
     edgeColor?: TileflowThemeColorValue;
     /** How bright the buildings light the street at night, from 0 (none) to 2; defaults to 0. */
     nightLight?: TileflowThemeNumberValue;
-    /** Contact shadow at the foot of the walls and in tight corners; defaults to false. */
+    /** Contact shadow at the foot of the walls and in tight corners; defaults to true. */
     occlusion?: boolean;
-    /** Shadows from the sun, on the buildings and the flat map; defaults to false. */
+    /** Shadows from the sun, on the buildings and the flat map; defaults to true. */
     shadows?: boolean;
     /**
      * Invented night windows, lit by rooms: decoration, not data. With World's `class`, none on sheds,
@@ -859,8 +481,24 @@ type TileflowBuildingsModuleConfig = TileflowBuildingsModuleOptions & {
 
 type TileflowLanduseClass = 'cemetery' | 'civic' | 'commercial' | 'education' | 'government' | 'industrial' | 'medical' | 'military' | 'parking' | 'railway' | 'recreation' | 'residential';
 type TileflowLandcoverClass = 'farmland' | 'flowerbed' | 'grass' | 'ice' | 'meadow' | 'protected' | 'recreationGround' | 'rock' | 'sand' | 'scrub' | 'urbanPark' | 'villageGreen' | 'wetland' | 'wood';
+/** The barriers of the data's barrier layer (World's `traffic_control`) the land module draws. */
+type TileflowBarrierClass = 'fence' | 'hedge' | 'wall';
+/**
+ * A barrier's line, a shadow line drawn under it (usually offset with `translate`), and the fill of
+ * those mapped as areas, such as broad hedges.
+ */
+type TileflowBarrierStyle = {
+    area?: TileflowFillStyle;
+    shadow?: TileflowLineStyle;
+    line?: TileflowLineStyle;
+};
 type TileflowLandModuleOptions = {
     background?: TileflowBackgroundStyle;
+    /**
+     * Hedges, fences and walls, drawn at the top of the land band with hedges uppermost. A barrier
+     * without a style is not drawn, and neither is any when the data has no barrier layer.
+     */
+    barriers?: Partial<Record<TileflowBarrierClass, TileflowBarrierStyle>>;
     globalLandcover?: TileflowFillStyle;
     landcover?: Partial<Record<TileflowLandcoverClass, TileflowAreaStyle>>;
     landuse?: Partial<Record<TileflowLanduseClass, TileflowAreaStyle>>;
@@ -989,6 +627,10 @@ type TileflowTreeFields = Readonly<{
     canopyCover: string;
     /** A canopy point's measured canopy height, in metres. */
     canopyHeight: string;
+    /** The kind of barrier in the hedge layer: hedges are `hedge`. */
+    subclass: string;
+    /** A hedge's kind: `hedge_bank` when it stands on an earth bank. */
+    hedge: string;
 }>;
 type TileflowTreePlacementOptions = Readonly<{
     /** The tile's address, for regions and for a stable look per tree. */
@@ -1016,6 +658,11 @@ type TileflowTreeLayers = Readonly<{
     trees?: TileflowTileLayer;
     /** Decorative canopy points in parks and gardens (World's `canopy`). */
     canopy?: TileflowTileLayer;
+    /**
+     * World's `traffic_control`: its hedges, lines and areas of `subclass=hedge`, stand as clipped
+     * pieces along each line and round each area. Other barriers are left out.
+     */
+    hedges?: TileflowTileLayer;
 }>;
 /** Where some trees are in a placement, and how many of them have each rank or a lower one. */
 type TileflowTreeRange = Readonly<{
@@ -1034,7 +681,12 @@ type TileflowTreePlacement = Readonly<{
     /** `tileflowTreeBytes` bytes per tree, ordered by form, model, then rank; see the layout below. */
     trees: Uint8Array;
     forms: Readonly<Record<TileflowTreeForm, TileflowTreeFormRange>>;
-    /** The tallest tree, in metres. */
+    /**
+     * `tileflowTreeBytes` bytes per piece of hedge, as a tree's: its middle, its height, its length
+     * as the crown, and its turn along the hedge.
+     */
+    hedges: Uint8Array;
+    /** The tallest tree or hedge, in metres. */
     tallest: number;
     /** Trees from the data's trees and rows, and trees from canopy points. */
     mapped: number;
@@ -1059,19 +711,24 @@ declare function placeTileflowTrees(layers: TileflowTreeLayers, options: Tileflo
 declare const tileflowVegetationMetadataKey = "tileflow:vegetation";
 /** How a compiled map's 3D trees look and where their data is, resolved for one theme. */
 type TileflowVegetation3D = Readonly<{
-    /** The vector source and its layers with the trees and the canopy points. */
+    /** The vector source and its layers with the trees, the canopy points and the hedges. */
     source: string;
     layers: Readonly<{
         tree: string;
         canopy?: string;
+        hedge?: string;
     }>;
     fields: TileflowTreeFields;
-    /** Sunlit colours: bark, and the leaves of each kind of tree from darkest to lightest. */
+    /**
+     * Sunlit colours: bark, the leaves of each kind of tree from darkest to lightest, and those of
+     * hedges.
+     */
     colors: Readonly<{
         bark: string;
         broadleaf: readonly string[];
         conifer: readonly string[];
         palm: readonly string[];
+        hedge: readonly string[];
     }>;
     heightScale: number;
     crownScale: number;
@@ -1103,6 +760,13 @@ type TileflowVegetationThreeDimensionalStyle = {
     coniferColors?: readonly TileflowThemeColorValue[];
     /** Sunlit frond colours of palms, from darkest to lightest; the broadleaf colours by default. */
     palmColors?: readonly TileflowThemeColorValue[];
+    /**
+     * Whether the data's hedges stand as clipped green walls beside the trees, at their height or
+     * 1.3 m, a metre higher on an earth bank. Defaults to true where the data has hedges.
+     */
+    hedges?: boolean;
+    /** Sunlit colours of hedges, from darkest to lightest; the two darkest broadleaf colours by default. */
+    hedgeColors?: readonly TileflowThemeColorValue[];
     crownScale?: TileflowThemeNumberValue;
     heightScale?: TileflowThemeNumberValue;
     /**
@@ -1150,32 +814,269 @@ type TileflowVegetationModuleOptions = {
     visible?: boolean;
     threeDimensional?: TileflowVegetationThreeDimensionalStyle;
 };
-type TileflowVegetationModuleConfig = TileflowVegetationModuleOptions & {
-    type: 'vegetation';
+type TileflowVegetationModuleConfig = TileflowVegetationModuleOptions & {
+    type: 'vegetation';
+};
+
+type TileflowWaterwayClass = 'canal' | 'other' | 'river' | 'stream';
+/** Explicit placement for every geometry family in a declared Bathymetry name layer. */
+type TileflowBathymetryNamePlacement = {
+    point: 'point';
+    line: TileflowSymbolPlacement;
+    polygon: TileflowSymbolPlacement;
+};
+type TileflowBathymetryNameStyle = TileflowSymbolStyle & {
+    /** Overrides scalar placement for these names; omission preserves scalar placement. */
+    placementByGeometry?: TileflowBathymetryNamePlacement;
+};
+type TileflowWaterModuleOptions = {
+    bathymetry?: TileflowFillStyle;
+    /** Contour lines when declared by Bathymetry; otherwise approximate polygon band edges. */
+    bathymetryContours?: TileflowLineStyle;
+    /** Contour-depth or legacy band-floor labels, not measured survey soundings. */
+    bathymetryLabels?: TileflowSymbolStyle;
+    /** Names from an explicitly declared seafloor_landform layer. */
+    bathymetryLandforms?: TileflowBathymetryNameStyle;
+    /** Names from an explicitly declared water_name layer. */
+    bathymetryWaterNames?: TileflowBathymetryNameStyle;
+    bodies?: TileflowAreaStyle;
+    intermittent?: {
+        bodies?: TileflowAreaStyle;
+        waterways?: TileflowLineStyle;
+    };
+    waterways?: Partial<Record<TileflowWaterwayClass, TileflowLineStyle>>;
+};
+type TileflowWaterModuleConfig = TileflowWaterModuleOptions & {
+    type: 'water';
+};
+
+type TileflowColor = `#${string}`;
+type TileflowRoadDetail = 'none' | 'highways' | 'major' | 'streets' | 'all';
+type TileflowRoadClass = 'motorway' | 'trunk' | 'primary' | 'secondary' | 'tertiary' | 'minor' | 'service' | 'track' | 'pathway' | 'footway' | 'cycleway' | 'steps' | 'pedestrian';
+type TileflowRoadHierarchy = 'subtle' | 'clear' | 'strong';
+type TileflowRoadWeight = 'thin' | 'regular' | 'bold';
+type TileflowRoadOutline = 'none' | 'subtle' | 'strong';
+type TileflowRoadStructure = 'bridge' | 'surface' | 'tunnel';
+type TileflowRoadExtras = {
+    paths?: boolean;
+};
+type TileflowRoadLayerStyle = TileflowLineStackStyle & {
+    hatch?: TileflowLineHatchStyle;
+};
+type TileflowRoadTreatmentLineStyle = Pick<TileflowLinePaint, 'blur' | 'color' | 'dash' | 'gapWidth' | 'offset' | 'opacity' | 'width'>;
+type TileflowRoadTreatmentLayerStyle = {
+    casing?: TileflowRoadTreatmentLineStyle;
+    fill?: TileflowRoadTreatmentLineStyle;
+    shadow?: TileflowRoadTreatmentLineStyle;
+};
+type TileflowRoadTreatmentStyle = Partial<Record<TileflowRoadStructure, TileflowRoadTreatmentLayerStyle>> & {
+    enabled?: boolean;
+    widthScale?: TileflowThemeNumberValue;
+};
+type TileflowRoadModifier = 'construction' | 'expressway' | 'indoor' | 'official' | 'ramp' | 'unpaved';
+type TileflowRoadRestriction = 'access' | 'bicycle' | 'foot' | 'horse' | 'toll';
+type TileflowMountainBikeScale = '0' | '0+' | '1' | '1+' | '2' | '2+' | '3' | '3+' | '4' | '5' | '6';
+type TileflowRoadServiceType = 'alley' | 'crossover' | 'driveway' | 'parkingAisle' | 'yard';
+type TileflowRoadClassStyle = Partial<Record<TileflowRoadStructure, TileflowRoadLayerStyle>> & {
+    enabled?: boolean;
+};
+type TileflowRoadAreaStyle = {
+    pedestrian?: TileflowAreaStyle;
+    pier?: TileflowAreaStyle;
+    road?: TileflowAreaStyle;
+};
+type TileflowRoadCrossingStyle = Omit<TileflowIconStyle, 'image'> & Required<Pick<TileflowIconStyle, 'image'>>;
+type TileflowRoadRoundaboutStyle = {
+    /** Extra casing width in pixels, split equally across both edges; defaults to the road border. */
+    borderWidth?: TileflowNumberStyleValue;
+    casing?: TileflowCircleStyle;
+    /** Road width in pixels when metric radii are absent; defaults to the effective surface fill width. */
+    fallbackWidth?: TileflowNumberStyleValue;
+    fill?: TileflowCircleStyle;
+};
+/**
+ * How Core's street lights renderer lights the map's streets at night, from the lamps and lit
+ * streets its data holds.
+ */
+type TileflowRoadStreetLightStyle = {
+    /** The light of lamps whose data gives no colour; a warm white by default. */
+    color?: TileflowThemeColorValue;
+    /** Whether the map has street lights; defaults to false. Set true to opt in. */
+    enabled?: boolean;
+    /**
+     * Where light is estimated where the data maps no lamps: `lit` (the default) along streets and
+     * pavements mapped as lit; `streets` also along streets the data says nothing about, in tiles
+     * that map few lamps, which invents light; `none` nowhere.
+     */
+    estimate?: 'lit' | 'streets' | 'none';
+    /** How bright the lights shine, from 0 to 2; defaults to 1. */
+    intensity?: TileflowThemeNumberValue;
+};
+type TileflowRoadSidewalkStyle = {
+    outline?: TileflowLineStyle;
+    pattern?: TileflowFillStyle;
+    surface?: TileflowFillStyle;
+};
+type TileflowRoadsModuleConfig = {
+    type: 'roads';
+    areas?: TileflowRoadAreaStyle;
+    classes?: Partial<Record<TileflowRoadClass, TileflowRoadClassStyle>>;
+    crossings?: TileflowRoadCrossingStyle;
+    detail?: TileflowRoadDetail;
+    extras?: TileflowRoadExtras;
+    hierarchy?: TileflowRoadHierarchy;
+    modifiers?: Partial<Record<TileflowRoadModifier, TileflowRoadTreatmentStyle>>;
+    mountainBike?: Partial<Record<TileflowMountainBikeScale, TileflowRoadTreatmentStyle>>;
+    oneWayMarkers?: boolean;
+    outline?: TileflowRoadOutline;
+    /** Draw ramp fills below receiving roads by default; `by-class` keeps their class's order. */
+    rampOrder?: 'below-roads' | 'by-class';
+    restrictions?: Partial<Record<TileflowRoadRestriction, TileflowRoadTreatmentStyle>>;
+    roundabouts?: TileflowRoadRoundaboutStyle;
+    serviceTypes?: Partial<Record<TileflowRoadServiceType, TileflowRoadTreatmentStyle>>;
+    sidewalks?: TileflowRoadSidewalkStyle;
+    streetLights?: TileflowRoadStreetLightStyle;
+    structures?: Partial<Record<TileflowRoadStructure, TileflowRoadLayerStyle>>;
+    weight?: TileflowRoadWeight;
+    widthScale?: Partial<Record<TileflowRoadClass, TileflowThemeNumberValue>>;
+};
+type TileflowLabelDetail = 'none' | 'major' | 'all';
+type TileflowAerodromeCodeDetail = 'none' | 'iata' | 'all';
+type TileflowRoadLabelDetail = TileflowRoadDetail;
+type TileflowLabelLanguage = 'auto' | 'local' | 'en' | (string & {});
+type TileflowPlaceLabelClass = 'city' | 'continent' | 'country' | 'neighborhood' | 'other' | 'state' | 'town' | 'village';
+type TileflowWaterLabelClass = 'line' | 'ocean' | 'other' | 'waterway';
+type TileflowRoadShieldDetail = 'none' | 'major' | 'all';
+type TileflowLabelCollisionPriority = 'balanced' | 'navigation';
+type TileflowRoadShieldStyles = {
+    default?: TileflowSymbolStyle;
+    detail?: TileflowSymbolStyle;
+    kinds?: Record<string, {
+        image: TileflowThemeImageValue;
+    }>;
+    overview?: TileflowSymbolStyle;
+    textColors?: Record<string, {
+        color: TileflowThemeColorValue;
+    }>;
+};
+type TileflowLabelStyles = {
+    aerodrome?: TileflowSymbolStyle;
+    junctions?: TileflowSymbolStyle;
+    places?: Partial<Record<TileflowPlaceLabelClass, TileflowSymbolStyle>>;
+    roads?: Partial<Record<TileflowRoadClass, TileflowSymbolStyle>>;
+    shields?: TileflowRoadShieldStyles;
+    water?: Partial<Record<TileflowWaterLabelClass, TileflowSymbolStyle>>;
+};
+type TileflowLabelsModuleConfig = {
+    type: 'labels';
+    aerodromeCodes?: TileflowAerodromeCodeDetail;
+    collisionPriority?: TileflowLabelCollisionPriority;
+    junctions?: boolean;
+    language?: TileflowLabelLanguage;
+    places?: TileflowLabelDetail;
+    roadClasses?: readonly TileflowRoadClass[];
+    /**
+     * Where street names draw. `foreground` (the default) keeps them above buildings and
+     * vegetation. `ground` places them below buildings, with map-aligned text by default.
+     * Ground names retain their road-class collision order, but foreground symbols are offered
+     * first by the renderer; `collisionPriority` cannot make ground names outrank those symbols.
+     * Shields and junction numbers keep their foreground placement.
+     */
+    roadPlacement?: 'ground' | 'foreground';
+    roads?: TileflowRoadLabelDetail;
+    shields?: TileflowRoadShieldDetail;
+    styles?: TileflowLabelStyles;
+    water?: TileflowLabelDetail;
+};
+/** Closed editorial vocabulary emitted by Tileflow World's canonical POI projection. */
+declare const tileflowPoiCategories: readonly ["arts-entertainment", "education", "food-drink", "landmark", "lodging", "medical", "park-nature", "public-services", "religion", "retail", "sport-leisure", "transport", "visitor-amenity"];
+type TileflowPoiCategory = (typeof tileflowPoiCategories)[number];
+type TileflowPoiDensity = 1 | 2 | 3 | 4 | 5;
+type TileflowPoiColorMode = 'uniform' | 'category';
+/**
+ * How POI categories are placed against each other. `importance` places every category in one
+ * order, by World's ranks. `categories` gives each category its own layer and places the
+ * categories in the order they are listed, the first on top; ranks order each category only.
+ */
+type TileflowPoiPlacementOrder = 'categories' | 'importance';
+/**
+ * The appearance of one POI category. With the default `importance` order every category shares
+ * one placement layer, so categories may differ only in properties MapLibre evaluates per feature
+ * (image, size, colors, font, offsets); layer-wide properties such as zoom ranges, padding,
+ * overlap or `optional` must match, or the module uses `placement.order: 'categories'`.
+ */
+type TileflowPoiCategoryStyle = Omit<TileflowMarkerSymbolStyle, 'priority'>;
+type TileflowPoiModuleConfig = {
+    type: 'poi';
+    categories?: readonly TileflowPoiCategory[];
+    color?: TileflowPoiColorMode;
+    /** One density for the whole module: World's ranks decide what each category shows. */
+    density?: TileflowPoiDensity;
+    icons?: boolean;
+    labels?: boolean;
+    minZoom?: number;
+    placement?: {
+        /**
+         * Places each pictogram with its name as one unit that needs room for both. Defaults to
+         * `false`.
+         */
+        coupleIconAndLabel?: boolean;
+        iconPadding?: number;
+        /**
+         * World POI `type` values whose pictogram explains them. When pictograms and names are both
+         * drawn, every other POI needs a name, and these types are drawn as a pictogram alone.
+         * Defaults to parking and public toilets.
+         */
+        iconOnlyTypes?: readonly string[];
+        /** Defaults to `importance`. */
+        order?: TileflowPoiPlacementOrder;
+        /**
+         * With the `importance` order, POIs whose World `filter_rank` is at most this value are placed
+         * before the map's road and place labels, and the others after them. A map that gives street
+         * names priority over POIs (labels `collisionPriority: 'navigation'`) keeps its landmarks this
+         * way. Unset, every POI is placed at the module's own position.
+         */
+        prominentRank?: 0 | 1 | 2 | 3 | 4 | 5;
+        textPadding?: number;
+    };
+    styles?: Partial<Record<TileflowPoiCategory, TileflowPoiCategoryStyle>>;
+};
+type MapLibreSprite = string | Array<{
+    id: string;
+    url: string;
+}>;
+type TileflowProjection = 'globe' | 'mercator';
+type TileflowLight = {
+    anchor?: 'map' | 'viewport';
+    color?: TileflowColor;
+    intensity?: number;
+    position?: readonly [number, number, number];
 };
-
-type TileflowWaterwayClass = 'canal' | 'other' | 'river' | 'stream';
-type TileflowWaterModuleOptions = {
-    bathymetry?: TileflowFillStyle;
-    /** Contour lines when declared by Bathymetry; otherwise approximate polygon band edges. */
-    bathymetryContours?: TileflowLineStyle;
-    /** Contour-depth or legacy band-floor labels, not measured survey soundings. */
-    bathymetryLabels?: TileflowSymbolStyle;
-    /** Names from an explicitly declared seafloor_landform layer. */
-    bathymetryLandforms?: TileflowSymbolStyle;
-    /** Names from an explicitly declared water_name layer. */
-    bathymetryWaterNames?: TileflowSymbolStyle;
-    bodies?: TileflowAreaStyle;
-    intermittent?: {
-        bodies?: TileflowAreaStyle;
-        waterways?: TileflowLineStyle;
+type MapLibreStyle = {
+    sky?: Record<string, unknown>;
+    version: 8;
+    name: string;
+    glyphs?: string;
+    light?: TileflowLight;
+    projection?: {
+        type: TileflowProjection;
     };
-    waterways?: Partial<Record<TileflowWaterwayClass, TileflowLineStyle>>;
-};
-type TileflowWaterModuleConfig = TileflowWaterModuleOptions & {
-    type: 'water';
+    sprite?: MapLibreSprite;
+    sources: Record<string, Record<string, unknown>>;
+    layers: Array<Record<string, unknown>>;
+    terrain?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
 };
 
+/**
+ * Layer metadata naming the semantic module that owns a compiled layer, such as `roads` or `water`.
+ * Runtime features that address a module, such as map emphasis, read it instead of physical layer
+ * IDs. Layers that a theme blend splits or copies keep it.
+ */
+declare const tileflowLayerDomainMetadataKey: "tileflow:domain";
+
+type TileflowLayerDomain = TileflowSemanticModuleName | 'terrain';
+
 type TileflowSemanticModules = {
     addresses?: TileflowAddressesModuleConfig;
     aeroways?: TileflowAerowaysModuleConfig;
@@ -1193,14 +1094,181 @@ type TileflowSemanticModules = {
 };
 type TileflowSemanticModuleName = keyof TileflowSemanticModules;
 
+declare const tileflowSunMetadataKey = "tileflow:sun";
+/** A theme's sun and sky light with every value resolved; see `TileflowThemeSun`. */
+type TileflowSunPreset = Readonly<{
+    /** Degrees clockwise from north, from 0 to 360. */
+    azimuth: number;
+    /** Degrees above the horizon, from -90 to 90. */
+    altitude: number;
+    /** The direct light's colour. */
+    color: string;
+    /** The direct light's strength, from 0 to 1. */
+    intensity: number;
+    /** How dark the shadows the sun casts fall, from 0 (none) to 1. */
+    shadowIntensity: number;
+    /** The light from the sky, which reaches every surface and fills the shadows. */
+    ambient: Readonly<{
+        color: string;
+        intensity: number;
+    }>;
+}>;
+/** The sun as the map shows it, ready for an application's own layers. */
+type TileflowSun = Readonly<{
+    /** Degrees clockwise from north, from 0 to 360. */
+    azimuth: number;
+    /** Degrees above the horizon, from -90 to 90. */
+    altitude: number;
+    /** A unit vector towards the sun: x east, y north, z up. */
+    direction: readonly [number, number, number];
+    /** The direct light's colour, as a CSS colour. */
+    color: string;
+    /** The direct light's colour as sRGB channels from 0 to 1. */
+    rgb: readonly [number, number, number];
+    /**
+     * The direct light's strength, from 0 to 1. It fades to 0 as the sun sets: a sun below the
+     * horizon lights nothing and casts no shadow.
+     */
+    intensity: number;
+    /** How dark the shadows the sun casts fall, from 0 (none) to 1. */
+    shadowIntensity: number;
+    /** The light from the sky, which reaches every surface and fills the shadows. */
+    ambient: Readonly<{
+        color: string;
+        rgb: readonly [number, number, number];
+        intensity: number;
+    }>;
+    /**
+     * How bright flat, open ground is under this light, from 0 (dark) to 1: the sky's light plus the
+     * sun's at its height, each weighted by its colour's luminance. Use it to switch lamps or windows
+     * on as a scene darkens, whatever theme or sun lights it.
+     */
+    brightness: number;
+    /** Where the direction comes from: the themes, angles, or a date and place. */
+    source: 'theme' | 'direction' | 'date';
+}>;
+/** Unset sun values: high in the south-south-west, with soft white daylight and ambient fill. */
+declare const tileflowDefaultSunPreset: TileflowSunPreset;
 /**
- * Layer metadata naming the semantic module that owns a compiled layer, such as `roads` or `water`.
- * Runtime features that address a module, such as map emphasis, read it instead of physical layer
- * IDs. Layers that a theme blend splits or copies keep it.
+ * Where the sun stands for an instant and a place ([longitude, latitude] in degrees): its azimuth
+ * in degrees clockwise from north and its apparent altitude above the horizon, with atmospheric
+ * refraction. It follows NOAA's solar equations, accurate to about a hundredth of a degree for
+ * years 1800 to 2200.
  */
-declare const tileflowLayerDomainMetadataKey: "tileflow:domain";
+declare function tileflowSunPosition(date: Date | number, location: readonly [number, number]): Readonly<{
+    azimuth: number;
+    altitude: number;
+}>;
+/** A unit vector towards a direction in the sky: x east, y north, z up. */
+declare function tileflowSunDirection(azimuth: number, altitude: number): readonly [number, number, number];
+/**
+ * The sun as the map shows it: a preset's light from a direction. Direct light fades out over the
+ * sun's last degrees above the horizon and is gone below it.
+ */
+declare function resolveTileflowSun(preset: TileflowSunPreset, direction?: Readonly<{
+    azimuth: number;
+    altitude: number;
+}>, source?: TileflowSun['source']): TileflowSun;
+/**
+ * A preset `t` of the way from `from` to `to`: the azimuth turns the short way round, colours mix
+ * in OKLab, as theme blends mix paint colours, and numbers linearly.
+ */
+declare function mixTileflowSunPresets(from: TileflowSunPreset, to: TileflowSunPreset, t: number): TileflowSunPreset;
+/** Reads the sun a compiled style publishes, or undefined when its metadata has none. */
+declare function readTileflowSunPreset(metadata: unknown): TileflowSunPreset | undefined;
+/**
+ * The sun of a compiled style: the one it publishes, else one read from its light (a style whose
+ * theme describes no sun lights its extrusions from `light.position`), else the default.
+ */
+declare function tileflowStyleSunPreset(style: {
+    light?: unknown;
+    metadata?: unknown;
+} | undefined): TileflowSunPreset;
 
-type TileflowLayerDomain = TileflowSemanticModuleName | 'terrain';
+type TileflowThemeColorScheme = 'dark' | 'light';
+
+declare const tileflowRouteMetadataKey = "tileflow:route";
+/** The resolved inks of a route, from its outer glow to its bright core. */
+type TileflowRouteInks = Readonly<{
+    /** The chosen route's line. */
+    line: string;
+    /** The edge on each side of the line, which sets it apart from the roads under it. */
+    casing: string;
+    /** A thin line along the middle of the route. */
+    core: string;
+    /** A soft halo around the route. */
+    glow: string;
+    /** Other routes offered beside the chosen one. */
+    alternative: string;
+    /** Opacity of the glow, from 0 (no glow) to 1. */
+    glowOpacity: number;
+    /** Opacity of the core, from 0 (no core) to 1. */
+    coreOpacity: number;
+}>;
+/** The inks of a theme that sets no route tokens: a blue that reads on either kind of map. */
+declare const tileflowDefaultRouteInks: Readonly<Record<TileflowThemeColorScheme, TileflowRouteInks>>;
+/**
+ * Reads the route inks a compiled style publishes, or undefined when its metadata has none (a
+ * style compiled before route inks, or not by Tileflow).
+ */
+declare function readTileflowRouteInks(metadata: unknown): TileflowRouteInks | undefined;
+/**
+ * The route inks of a compiled style: those it publishes, or the defaults of its colour scheme
+ * (from its `tileflow:colorScheme` metadata, else `fallbackScheme`).
+ */
+declare function tileflowStyleRouteInks(style: {
+    metadata?: unknown;
+} | undefined, fallbackScheme?: TileflowThemeColorScheme): TileflowRouteInks;
+/**
+ * Inks between two themes' inks, `t` of the way from `from` to `to`: colours mix in OKLab, as theme
+ * blends mix paint colours, and opacities linearly.
+ */
+declare function mixTileflowRouteInks(from: TileflowRouteInks, to: TileflowRouteInks, t: number): TileflowRouteInks;
+
+type TileflowRuntimeColorScheme = 'dark' | 'light';
+
+type TileflowAnalytics = {
+    apiUrl?: string;
+    endpoint?: string;
+    enabled?: boolean;
+    mapId?: string;
+    metadata?: Record<string, unknown>;
+    projectId?: string;
+    sdkVersion?: string;
+    source?: string;
+    styleId?: string;
+    surfaceId?: string;
+};
+type TileflowSessionController = {
+    readonly sessionId: string;
+    resolveRequestUrl(url: string, analytics: TileflowAnalytics | undefined): Promise<string | undefined>;
+};
+type TileflowRuntimeStyle = {
+    analytics?: TileflowAnalytics;
+    colorScheme?: TileflowRuntimeColorScheme;
+    /** An explicit empty array means the manifest declares that no web fonts are required. */
+    fontFaces?: TileflowStyleFontFace[];
+    revision?: string;
+    style: MapLibreStyle | string;
+    theme?: string;
+};
+type TileflowStyleFontFace = {
+    family: string;
+    source: string;
+    style?: 'italic' | 'normal' | 'oblique';
+    weight?: '100' | '200' | '300' | '400' | '500' | '600' | '700' | '800' | '900';
+};
+/**
+ * A continuous blend of named themes of one Tileflow map. `position` places the map between
+ * neighbouring themes: 0 is the first, 1 the second, and 1.25 a quarter of the way from the second
+ * to the third.
+ */
+type TileflowThemeBlendSelection = Readonly<{
+    /** From 0 to `themes.length - 1`. */
+    position: number;
+    /** Two to eight concrete theme names of the map, in blend order. */
+    themes: readonly string[];
+}>;
 
 /**
  * Map emphasis lets an application's own content read first: chosen modules of the map recede
@@ -1286,6 +1354,79 @@ type TileflowAtmosphereMap = {
  */
 declare function attachTileflowAtmosphere(map: TileflowAtmosphereMap): () => void;
 
+/**
+ * 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;
+
 /** The drawn stretch of a line and its highlights, as shares of the line's length from its start. */
 type TileflowLineProgressState = Readonly<{
     /** Where the drawn stretch starts, from 0 (the default) to 1. */
@@ -1484,16 +1625,26 @@ declare function readTileflowMapTileSource(map: TileflowTileSourceMap, sourceId:
     maxzoom: number;
 } | undefined;
 
+type ShadowPoint = readonly number[];
+type ShadowBox = Readonly<{
+    min: ShadowPoint;
+    max: ShadowPoint;
+}>;
+type ShadowView = Readonly<{
+    /** Visible receiver points, in the caster box's metre frame. All casters still draw. */
+    receivers?: readonly ShadowPoint[];
+    /** Snap to world-aligned texels; omit for an unsnapped mathematical projection. */
+    resolution?: number;
+    origin?: ShadowPoint;
+    /** Metres per fixed world unit; keeps texel quantization independent of latitude scale. */
+    gridScale?: number;
+}>;
 /**
- * The sun's view of a box of buildings: an orthographic projection along `direction` (towards the
- * sun; x east, y north, z up, in metres) as a column-major matrix to clip space, with the metres its
- * depth runs over and the metres its wider side spans. It follows only the sun, never the camera,
- * so shadows hold still while the camera moves.
+ * The sun's orthographic view, in metres, with room for each caster's shadow to reach the ground.
+ * Optional receivers concentrate XY resolution without dropping offscreen casters along a ray;
+ * quantized extents and a world-anchored texel grid keep stationary shadows stable during pans.
  */
-declare function tileflowSunLightMatrix(direction: readonly number[], box: Readonly<{
-    min: readonly number[];
-    max: readonly number[];
-}>): {
+declare function tileflowSunLightMatrix(direction: readonly number[], box: ShadowBox, view?: ShadowView): {
     matrix: Float32Array;
     depth: number;
     extent: number;
@@ -1532,7 +1683,7 @@ type TileflowBuildings3DOptions = Readonly<{
     map: TileflowBuildings3DMap;
     /** The theme controller, for the sun and the buildings' design in every theme. */
     controller?: TileflowBuildings3DThemes;
-    /** The zoom from which buildings stand; below it they sink into the flat map. Defaults to 14.5. */
+    /** The zoom where buildings start fading in, reaching full opacity 0.25 zoom later. Defaults to 15. */
     minzoom?: number;
     /** The most tiles raised round the camera, from 1 to 64; defaults to 25. */
     maxTiles?: number;
@@ -1575,7 +1726,7 @@ type TileflowBuildings3D = {
 };
 declare const tileflowBuildings3DLayerId = "tileflow-buildings-3d";
 /**
- * Creates the renderer and puts its layer on the map, flat until `show()`. It reads the source's
+ * Creates the renderer, showing buildings automatically above zoom 15 unless hidden. It reads the source's
  * z15 tiles round the camera, the zoom at which World's buildings carry their heights.
  */
 declare function createTileflowBuildings3D(options: TileflowBuildings3DOptions): TileflowBuildings3D;
@@ -1589,6 +1740,10 @@ type TileflowBuildingMeshOptions = Readonly<{
     tileMetres: number;
     /** Height used where a building has none, in metres; defaults to 5, World's own fallback. */
     defaultHeight?: number;
+    /** Exterior corner radius in metres, up to 1; 0 leaves the footprint unchanged. */
+    edgeRadius?: number;
+    /** Maximum turn per rounded segment; defaults to 30 degrees for close views. */
+    cornerAngle?: number;
     /**
      * The tile's places (World's `poi` layer), for the night use of buildings when the tile's
      * buildings do not carry World's `night_use`: a place inside a building, or on its facade, gives
@@ -1602,8 +1757,17 @@ type TileflowBuildingMeshOptions = Readonly<{
      */
     masks?: readonly (readonly number[])[];
 }>;
+type BuildingMeshGroup = {
+    /** Conservative tile-space x/y bounds and maximum height in metres. */
+    bounds: [number, number, number, number, number];
+    roofsFrom: number;
+    roofsCount: number;
+    wallsFrom: number;
+    wallsCount: number;
+};
 /** One tile's buildings, ready to upload. */
 type TileflowBuildingMesh = Readonly<{
+    groups?: readonly BuildingMeshGroup[];
     vertices: Uint8Array;
     indices: Uint32Array;
     /** The first wall index: roofs come before it, walls from it. */
@@ -1655,6 +1819,11 @@ type TileflowStreetLightsMap = {
 };
 type TileflowStreetLightsOptions = Readonly<{
     map: TileflowStreetLightsMap;
+    /**
+     * By default, only a map that enables roads.streetLights supplies lights. Set true to opt in
+     * with the fallback design when metadata is absent, or false to keep every theme's lights off.
+     */
+    enabled?: boolean;
     /**
      * The theme controller, whose sun switches the lights on and off and whose themes hold the map's
      * street lights (the roads module's `streetLights`).
@@ -1726,7 +1895,9 @@ type TileflowBuildings3DDesign = Readonly<{
     color: string | readonly unknown[];
     /** How strongly roof outlines and outer corners catch the light, from 0 to 1. */
     edges: number;
-    /** Style extrusion light by default; scene sun lighting is opt-in. */
+    /** Exterior corner radius and roof lighting transition, in metres; 0 keeps sharp edges. */
+    edgeRadius?: number;
+    /** Scene sun lighting by default; `style` uses the native extrusion light. */
     lighting: 'style' | 'sun';
     /** Per-building brightness variation, from 0 to 1; 0 preserves the authored colour. */
     colorVariation: number;
@@ -1807,7 +1978,7 @@ type TileflowTrees3DOptions = Readonly<{
     controller?: TileflowTrees3DThemes;
     /** The vector source with the canopy points, when not the map's World source. */
     canopySource?: string;
-    /** The zoom from which trees stand; they fade in over the zoom above it. Defaults to 15. */
+    /** The zoom from which trees stand; they reach full opacity 0.25 zoom later. Defaults to 15. */
     minzoom?: number;
     /** The most tiles of trees round the camera, from 1 to 64; defaults to 25. */
     maxTiles?: number;
@@ -1836,7 +2007,8 @@ type TileflowTrees3D = {
     readonly scale: number;
     /**
      * Whether the map's style describes 3D trees (`vegetation({mode: '3d'})`), tiles of trees,
-     * trees placed (mapped and from canopy points) and trees drawn in the last frame.
+     * trees placed (mapped and from canopy points), pieces of hedge placed and trees drawn in the
+     * last frame.
      */
     readonly stats: Readonly<{
         declared: boolean;
@@ -1844,6 +2016,7 @@ type TileflowTrees3D = {
         trees: number;
         mapped: number;
         canopy: number;
+        hedges: number;
         drawn: number;
     }>;
     /** Takes the layer off the map and lets go of its buffers. */
@@ -2476,4 +2649,4 @@ declare function createTileflowTransformRequest<TRequest extends TileflowTransfo
     worldRequestBridge?: TileflowWorldRequestBridge;
 }): TileflowTransformRequest<TRequest, TResourceType>;
 
-export { type TileflowAtmosphereMap, type TileflowBrowserThemeBlendSelection, type TileflowBuildingMesh, type TileflowBuildingMeshOptions, type TileflowBuildingModelPlacement, type TileflowBuildings3D, type TileflowBuildings3DChange, type TileflowBuildings3DDesign, type TileflowBuildings3DMap, type TileflowBuildings3DOptions, type TileflowBuildings3DThemes, type TileflowComposedRequest, type TileflowContourProtocolHandler, type TileflowContourProtocolRegistrationOptions, type TileflowContourProtocolRegistry, type TileflowContourProtocolRequest, type TileflowContourProtocolResponse, type TileflowDepthMarker, type TileflowDepthMarkerHandle, type TileflowDepthMarkerMap, type TileflowDepthMarkers, type TileflowDepthMarkersOptions, type TileflowDynamicImage, type TileflowDynamicImageContext, type TileflowDynamicImageHandle, type TileflowEmphasis, type TileflowEmphasisArea, type TileflowEmphasisModule, type TileflowFairUseNotice, type TileflowFairUseNoticeController, type TileflowFairUseNoticeState, type TileflowFrameScheduler, type TileflowGroundLayer, type TileflowGroundLayers, type TileflowGroundLayersMap, type TileflowGroundLayersOptions, type TileflowGroundOrderMap, type TileflowLineProgressAnimation, type TileflowLineProgressController, type TileflowLineProgressGradientOptions, type TileflowLineProgressLayer, type TileflowLineProgressMap, type TileflowLineProgressOptions, type TileflowLineProgressShown, type TileflowLineProgressState, type TileflowMapLifecycleAttachment, type TileflowMapLifecycleEvent, type TileflowMapLifecycleSubscriber, type TileflowMapReadinessState, type TileflowPmtilesProtocolHandler, type TileflowPmtilesProtocolRegistrationOptions, type TileflowPmtilesProtocolRegistry, type TileflowRouteInks, type TileflowSessionSender, type TileflowSessionStarter, type TileflowShotCamera, type TileflowShotCue, type TileflowShotKeyframe, type TileflowShotMotion, type TileflowShotPlayback, type TileflowShotPlaybackOptions, type TileflowShotPlayerMap, type TileflowShotState, type TileflowStreetLightEstimate, type TileflowStreetLightLayers, type TileflowStreetLightPlacement, type TileflowStreetLightPlacementOptions, type TileflowStreetLights, type TileflowStreetLightsDesign, type TileflowStreetLightsMap, type TileflowStreetLightsOptions, type TileflowStyleFontLoadOptions, type TileflowStyleStateValue, type TileflowStyleSwitchMap, type TileflowSun, type TileflowSunPreset, type TileflowSunRequest, type TileflowThemeBlendRequest, type TileflowThemeBlendState, type TileflowThemeChangeOptions, type TileflowThemeController, type TileflowThemeTransition, type TileflowThemeTransitionOptions, type TileflowThemeTransitionPhase, type TileflowThemeTransitionResult, type TileflowTile, type TileflowTileAddress, type TileflowTileAreaRequest, type TileflowTileFeature, type TileflowTileGeometryType, type TileflowTileLayer, type TileflowTileReader, type TileflowTileReaderOptions, type TileflowTileRequestTransform, type TileflowTileSourceMap, type TileflowTransformRequest, type TileflowTransformRequestParameters, type TileflowTreeFields, type TileflowTreeForm, type TileflowTreeFormMix, type TileflowTreeFormRange, type TileflowTreeLayers, type TileflowTreePlacement, type TileflowTreePlacementOptions, type TileflowTreeRange, type TileflowTreeRegion, type TileflowTrees3D, type TileflowTrees3DChange, type TileflowTrees3DMap, type TileflowTrees3DOptions, type TileflowTrees3DThemes, type TileflowUserTransformRequest, type TileflowVectorTileDecodeOptions, type TileflowVegetation3D, type TileflowVegetationController, type TileflowVegetationDisplay, type TileflowVegetationOptions, type TileflowVegetationRepresentation, type TileflowViewMode, type TileflowWorldProtocolHandler, type TileflowWorldProtocolRequest, type TileflowWorldProtocolResponse, type TileflowWorldRequestBridge, attachTileflowAtmosphere, attachTileflowFairUseNotice, attachTileflowMapLifecycle, createTileflowBuildings3D, createTileflowDepthMarkers, createTileflowGroundLayers, createTileflowLineProgress, createTileflowSessionStarter, createTileflowStreetLights, createTileflowThemeController, createTileflowTileReader, createTileflowTransformRequest, createTileflowTrees3D, createTileflowVegetation, decodeTileflowVectorTile, getTileflowSystemColorScheme, loadTileflowStyleFonts, meshTileflowBuildings, mixTileflowRouteInks, mixTileflowSunPresets, placeTileflowStreetLights, placeTileflowTrees, playTileflowShot, readTileflowBuildings3D, readTileflowMapTileSource, readTileflowRouteInks, readTileflowStreetLights, readTileflowSunPreset, readTileflowVegetation3D, readTileflowVegetationDisplay, registerTileflowContourProtocol, registerTileflowPmtilesProtocol, registerTileflowWorldRequestBridge, resolveTileflowSun, resolveTileflowVegetationRepresentation, subscribeTileflowSystemColorScheme, tileflowBuildingExtent, tileflowBuildingModelPlacementLimit, tileflowBuildingVertexBytes, tileflowBuildings3DLayerId, tileflowBuildingsMetadataKey, tileflowDefaultRouteInks, tileflowDefaultSunPreset, tileflowDepthMarkerPlacement, tileflowFairUseNoticeMessage, tileflowGroundBeforeId, tileflowLayerDomainMetadataKey, tileflowLineProgressGradient, tileflowMaplibreContourVersion, tileflowPmtilesMaximumDirectoryDepth, tileflowPmtilesProtocol, tileflowRouteMetadataKey, tileflowShotStateAt, tileflowStreetLightBytes, tileflowStreetLightsLayerId, tileflowStreetLightsMetadataKey, tileflowStyleRouteInks, tileflowStyleSunPreset, tileflowSunDirection, tileflowSunLightMatrix, tileflowSunMetadataKey, tileflowSunPosition, tileflowTilePointToLngLat, tileflowTilesForBounds, tileflowTreeBytes, tileflowTreeFormOf, tileflowTreeForms, tileflowTrees3DLayerId, tileflowVegetationDisplayMetadataKey, tileflowVegetationMetadataKey, validateTileflowBrowserThemeBlendSelection, validateTileflowEmphasis };
+export { type CreateBoundaryFeatureStateOptions, type TileflowAtmosphereMap, type TileflowBoundaryFeatureState, type TileflowBrowserThemeBlendSelection, type TileflowBuildingMesh, type TileflowBuildingMeshOptions, type TileflowBuildingModelPlacement, type TileflowBuildings3D, type TileflowBuildings3DChange, type TileflowBuildings3DDesign, type TileflowBuildings3DMap, type TileflowBuildings3DOptions, type TileflowBuildings3DThemes, type TileflowComposedRequest, type TileflowContourProtocolHandler, type TileflowContourProtocolRegistrationOptions, type TileflowContourProtocolRegistry, type TileflowContourProtocolRequest, type TileflowContourProtocolResponse, type TileflowDepthMarker, type TileflowDepthMarkerHandle, type TileflowDepthMarkerMap, type TileflowDepthMarkers, type TileflowDepthMarkersOptions, type TileflowDynamicImage, type TileflowDynamicImageContext, type TileflowDynamicImageHandle, type TileflowEmphasis, type TileflowEmphasisArea, type TileflowEmphasisModule, type TileflowFairUseNotice, type TileflowFairUseNoticeController, type TileflowFairUseNoticeState, type TileflowFeatureStateMap, type TileflowFrameScheduler, type TileflowGroundLayer, type TileflowGroundLayers, type TileflowGroundLayersMap, type TileflowGroundLayersOptions, type TileflowGroundOrderMap, type TileflowLineProgressAnimation, type TileflowLineProgressController, type TileflowLineProgressGradientOptions, type TileflowLineProgressLayer, type TileflowLineProgressMap, type TileflowLineProgressOptions, type TileflowLineProgressShown, type TileflowLineProgressState, type TileflowMapLifecycleAttachment, type TileflowMapLifecycleEvent, type TileflowMapLifecycleSubscriber, type TileflowMapReadinessState, type TileflowPmtilesProtocolHandler, type TileflowPmtilesProtocolRegistrationOptions, type TileflowPmtilesProtocolRegistry, type TileflowRouteInks, type TileflowSessionSender, type TileflowSessionStarter, type TileflowShotCamera, type TileflowShotCue, type TileflowShotKeyframe, type TileflowShotMotion, type TileflowShotPlayback, type TileflowShotPlaybackOptions, type TileflowShotPlayerMap, type TileflowShotState, type TileflowStreetLightEstimate, type TileflowStreetLightLayers, type TileflowStreetLightPlacement, type TileflowStreetLightPlacementOptions, type TileflowStreetLights, type TileflowStreetLightsDesign, type TileflowStreetLightsMap, type TileflowStreetLightsOptions, type TileflowStyleFontLoadOptions, type TileflowStyleStateValue, type TileflowStyleSwitchMap, type TileflowSun, type TileflowSunPreset, type TileflowSunRequest, type TileflowThemeBlendRequest, type TileflowThemeBlendState, type TileflowThemeChangeOptions, type TileflowThemeController, type TileflowThemeTransition, type TileflowThemeTransitionOptions, type TileflowThemeTransitionPhase, type TileflowThemeTransitionResult, type TileflowTile, type TileflowTileAddress, type TileflowTileAreaRequest, type TileflowTileFeature, type TileflowTileGeometryType, type TileflowTileLayer, type TileflowTileReader, type TileflowTileReaderOptions, type TileflowTileRequestTransform, type TileflowTileSourceMap, type TileflowTransformRequest, type TileflowTransformRequestParameters, type TileflowTreeFields, type TileflowTreeForm, type TileflowTreeFormMix, type TileflowTreeFormRange, type TileflowTreeLayers, type TileflowTreePlacement, type TileflowTreePlacementOptions, type TileflowTreeRange, type TileflowTreeRegion, type TileflowTrees3D, type TileflowTrees3DChange, type TileflowTrees3DMap, type TileflowTrees3DOptions, type TileflowTrees3DThemes, type TileflowUserTransformRequest, type TileflowVectorTileDecodeOptions, type TileflowVegetation3D, type TileflowVegetationController, type TileflowVegetationDisplay, type TileflowVegetationOptions, type TileflowVegetationRepresentation, type TileflowViewMode, type TileflowWorldProtocolHandler, type TileflowWorldProtocolRequest, type TileflowWorldProtocolResponse, type TileflowWorldRequestBridge, attachTileflowAtmosphere, attachTileflowFairUseNotice, attachTileflowMapLifecycle, createBoundaryFeatureState, createTileflowBuildings3D, createTileflowDepthMarkers, createTileflowGroundLayers, createTileflowLineProgress, createTileflowSessionStarter, createTileflowStreetLights, createTileflowThemeController, createTileflowTileReader, createTileflowTransformRequest, createTileflowTrees3D, createTileflowVegetation, decodeTileflowVectorTile, getTileflowSystemColorScheme, loadTileflowStyleFonts, meshTileflowBuildings, mixTileflowRouteInks, mixTileflowSunPresets, placeTileflowStreetLights, placeTileflowTrees, playTileflowShot, readTileflowBuildings3D, readTileflowMapTileSource, readTileflowRouteInks, readTileflowStreetLights, readTileflowSunPreset, readTileflowVegetation3D, readTileflowVegetationDisplay, registerTileflowContourProtocol, registerTileflowPmtilesProtocol, registerTileflowWorldRequestBridge, resolveTileflowSun, resolveTileflowVegetationRepresentation, subscribeTileflowSystemColorScheme, tileflowBuildingExtent, tileflowBuildingModelPlacementLimit, tileflowBuildingVertexBytes, tileflowBuildings3DLayerId, tileflowBuildingsMetadataKey, tileflowDefaultRouteInks, tileflowDefaultSunPreset, tileflowDepthMarkerPlacement, tileflowFairUseNoticeMessage, tileflowGroundBeforeId, tileflowLayerDomainMetadataKey, tileflowLineProgressGradient, tileflowMaplibreContourVersion, tileflowPmtilesMaximumDirectoryDepth, tileflowPmtilesProtocol, tileflowRouteMetadataKey, tileflowShotStateAt, tileflowStreetLightBytes, tileflowStreetLightsLayerId, tileflowStreetLightsMetadataKey, tileflowStyleRouteInks, tileflowStyleSunPreset, tileflowSunDirection, tileflowSunLightMatrix, tileflowSunMetadataKey, tileflowSunPosition, tileflowTilePointToLngLat, tileflowTilesForBounds, tileflowTreeBytes, tileflowTreeFormOf, tileflowTreeForms, tileflowTrees3DLayerId, tileflowVegetationDisplayMetadataKey, tileflowVegetationMetadataKey, validateTileflowBrowserThemeBlendSelection, validateTileflowEmphasis };