@tileflow/maps 0.1.0-alpha.17 → 0.1.0-alpha.19

package/README.md

@@ -81,22 +81,20 @@ Streets has twelve theme/time combinations. Inspector offers **Default**, **Fade
 presets. Default retains the configuration key `light`: `theme="light" timeOfDay="night"`
 selects `dark`, while `theme="light" timeOfDay="day"` selects `light`. The other concrete themes
 are `dawn`, `dusk`, `faded`, `monochrome`, `dawn-faded`, `dawn-monochrome`, `dusk-faded`,
-`dusk-monochrome`, `dark-faded`, and `dark-monochrome`. Each combination selects a complete
-palette and artwork; time presets do not apply a global lighting tint to the flat map.
-
-Scene lighting is calibrated against Mapbox Standard. Streets owns its cartography: slate-blue
-roads with stronger regional outlines, neutral urban surfaces, pale warm rural ground, green
-parks and subtle cream buildings. Its palette is not a fixed copy of the provider's reference
-colors. Day uses category-colored POI discs; dark mode uses pale discs with dark pictograms.
-Maki pictograms distinguish transport modes and POI types. Scene-sun lighting preserves
-unshadowed roof paint while allowing light color to affect walls.
-
-At regional scales, the default day theme uses a packaged, attributed climate underlay to
-separate humid and dry regions. It fades out by zoom 11, where mapped land cover and land use
-supply local detail. Climate is broad context, not a claim of surveyed vegetation at a specific
-site. The other themes retain their own authored land-cover palettes. Urban and education
-areas use neutral surfaces; farmland stays pale, while mapped orchards and nurseries remain
-green. Underground footprints flagged `hide_3d` are omitted from the flat building layers. Streets
+`dusk-monochrome`, `dark-faded`, and `dark-monochrome`. All twelve appearances share roads, label placement, fonts and icon artwork.
+Colors and lighting vary; flat-map colors are authored independently.
+
+Scene lighting is calibrated against Mapbox Standard while retaining Streets' slate-blue roads,
+neutral urban surfaces, pale warm rural ground, green parks and cream buildings. All appearances
+share category-colored POI discs and Maki pictograms. Lighting preserves sunlit roof paint and
+tints walls. Daylight uses neutral direct light (0.2) and ambient fill (0.8); buildings and
+map-shaded models keep ambient fill at night, with local occlusion at contacts and recesses.
+
+Below zoom 11, daylight draws a climate image separating humid and dry regions; it is
+loaded only there and is broad context, not surveyed vegetation. Other appearances keep it clear.
+Urban and education areas use neutral surfaces; farmland stays pale, mapped orchards and nurseries
+green. Activity areas tint the ground by activity until buildings take over. Footprints drawn
+by building parts (`extrude: false`) are omitted from the flat building layers. Streets
 suspends duplicate flat building footprints in 3D so roads remain visible under open landmarks;
 2D mode restores ordinary footprints. Normal 3D buildings keep a small neutral/active tone difference. Authored models use
 the neutral building color and independently configurable window shading.
@@ -119,12 +117,12 @@ at junctions. Links remain narrower and draw before receiving roads. Tunnel casi
 surface and bridge casings are continuous. Construction fills and marks draw below roads in
 service. Crosswalks and compact blue-gray arrows fade in from z16.5.
 
-Daytime surface footpaths and cycleways use white strokes over mapped green ground and a
-muted gray-earth stroke elsewhere, at 92% of their authored width and without a casing.
+Surface footpaths and cycleways share geometry across appearances, at 92% of their authored
+width and without casings. Day uses white over mapped green ground and gray-earth elsewhere.
 The shared `roads.pathGround` compiler and browser protocol clip the green portions from the
 same vector tiles; a complete ground-colored path remains visible if context cannot load.
 Road carriageway outlines draw above these paths. This treatment belongs to the Streets
-definition and survives normal artifact regeneration; other themes retain their own path styles.
+definition and survives normal artifact regeneration in every palette and time preset.
 Road palettes, width profiles, building outlines and the overview backgrounds are authored here
 in Maps; consumers inherit them without installing a separately edited style snapshot.
 
@@ -150,10 +148,9 @@ Streets rounds exterior building corners with a 1.5-metre radius and softens the
 lighting transition (`threeDimensional.edgeRadius: 1.5`). Courtyards and tile cuts retain their shape.
 Shields use 9 px DINish Bold and closer spacing at z11–13. Street names yield to destinations
 and draw above flat footprints but below 3D buildings, with viewport-aligned letters.
-3D lights use Standard's effective theme presets, retrieved on 2026-10-18: southern sun by day,
-southeast at dawn, southwest at dusk and western moonlight at night. Monochrome has distinct
-directions and strengths. Tileflow holds zoom 14+ values; Standard varies intensity below z14.
-Shading differs; `controller.setSun({date, location})` uses the real sun instead of presets.
+3D lights use a southern sun by day, southeast at dawn, southwest at dusk and western moonlight
+at night. At each moment, palettes share light direction, strength and shadow geometry;
+only light colors change. `controller.setSun({date, location})` uses the real sun instead.
 Streets enables `camera.adaptivePerspective`. See camera, landmark and lighting settings in
 [3D buildings](https://github.com/tileflow/tileflow-sdk/blob/main/packages/core/README.md).
 The buildings' `threeDimensional.lighting` and `shadows` options control the effect, and each
@@ -169,7 +166,8 @@ Pedestrian paths group separately. Compact types preserve language;
 `labels.roadNameFormat: 'full'` keeps source names.
 Disabling roads omits their names.
 Road rings, ramp and surface ordering use [Core's replaceable defaults](https://github.com/tileflow/tileflow-sdk/blob/main/packages/core/README.md).
-Streets owns colors, widths, typography and time-of-day themes.
+All non-day themes grade day's ground, water, roads, trees and 2D/3D materials across zooms:
+yellow warmth at dawn, dimmer stone at dusk, cool night. Day palettes stay unchanged.
 Each theme paints a [street sky](https://github.com/tileflow/tileflow-sdk/blob/main/packages/core/README.md) with night stars; `atmosphere: true`
 on a globe map adds space around it. Mercator and native targets remain supported.
 
@@ -206,7 +204,7 @@ export default defineMap({
 
 POIs follow World ranks and category density, with extra detail for parks and transport.
 Generic airport POIs are limited to rank 0 to reduce misplaced business listings; the dedicated
-aerodrome layer continues to label mapped airports. This display policy does not repair source data.
+airport label layer continues to label mapped airports. This display policy does not repair source data.
 Road-reference repetition is reduced at z11–13 and retains its detail interval from z14.
 Gardens stay at ranks 0–1 at every zoom, keeping principal destinations while omitting botanical
 collections and some small independent gardens. Other park and landmark types retain their usual
@@ -327,7 +325,14 @@ concrete theme names remain available for existing applications and captures. Th
 is inherited when extending Streets without overriding it.
 See the [time-of-day contract](https://github.com/tileflow/tileflow-sdk/blob/main/packages/core/README.md#style-with-themes-and-semantic-modules).
 
-Streets packages its low-zoom climate artwork and attribution, contrasted routes and compact trees.
-Models inherit ordinary-building shading. Glass parts can be recoloured independently through
-`modelColors.glass`; windows use `modelLighting.window.colorScale: 0.94`.
+Streets packages contrasted routes and compact trees. Climate artwork and its attribution are
+retained for future URL delivery, but the underlay is not included in compiled styles.
+When the 3D view is active, available buildings and models appear at full height from zoom 14.25
+without zoom entrance animations.
+Pitch is capped at 38° through zoom 15; closer views use the application's maximum.
+Daylight combines warm limestone buildings, ivory model surfaces, smoked-blue glazing and warm
+roof tones under neutral sunlight and skylight. Models share ordinary-building shading, with
+soft contact shadows and ambient occlusion in recesses. Monochrome materials stay neutral.
+Glass parts can be recoloured independently through `modelColors.glass`; window roles retain
+that glass tint even on a shared stone part, with `modelLighting.window.colorScale: 0.96`.
 Other maps can override their colour and material without regenerating the model.

package/assets/streets/climate/build.py

@@ -1,7 +1,11 @@
-"""Rebuild the embedded, historical climate colour image (requires Pillow and NumPy)."""
+"""Rebuild the shared climate colour image, streets-climate-v1.png (requires Pillow and NumPy).
+
+Tileflow serves the PNG unchanged at an immutable URL named by its SHA-256; recipe.json records
+that digest, and Streets reads the URL from src/official/streets-climate.ts.
+"""
 from pathlib import Path
 from PIL import Image, ImageFilter
-import hashlib, json, base64, io
+import hashlib, json, io
 import numpy as np
 ROOT = Path(__file__).resolve().parent
 SOURCE = ROOT / 'koppen-geiger-1991-2020.tif'
@@ -37,11 +41,13 @@ projected = np.uint8(np.round(colour[low] * (1 - fraction[:, None, None]) +
 world = Image.fromarray(projected).resize((size, size), Image.Resampling.BILINEAR)
 buffer = io.BytesIO()
 world.save(buffer, format='PNG', optimize=True)
-uri = 'data:image/png;base64,' + base64.b64encode(buffer.getvalue()).decode()
-output = ROOT / '../../../src/official/streets-climate-image.ts'
-output.write_text('// Generated by assets/streets/climate/build.py. See its NOTICE.txt.\nexport const streetsClimateImage = ' + json.dumps(uri) + ';\n')
+image = buffer.getvalue()
+(ROOT / 'streets-climate-v1.png').write_bytes(image)
+recipe.update(image='streets-climate-v1.png', imageBytes=len(image),
+              imageSha256=hashlib.sha256(image).hexdigest())
 (ROOT / 'recipe.json').write_text(json.dumps(recipe, indent=2)+'\n')
 # Keep generated sources reproducible under the package formatter.
 import subprocess
-subprocess.run(['pnpm', 'exec', 'prettier', '--write', str(output.resolve()), str(ROOT / 'recipe.json')], cwd=ROOT.parents[4], check=True)
-print(json.dumps({'imageBytes':len(buffer.getvalue()), 'sourceSha256':recipe['sourceSha256']}))
+subprocess.run(['pnpm', 'exec', 'prettier', '--write', str(ROOT / 'recipe.json')], cwd=ROOT.parents[4], check=True)
+print(json.dumps({'imageBytes': len(image), 'imageSha256': recipe['imageSha256'],
+                  'sourceSha256': recipe['sourceSha256']}))

package/assets/streets/climate/recipe.json

@@ -9,5 +9,8 @@
   "blurDegrees": 0.25,
   "maxzoom": 4,
   "tileSize": 256,
-  "period": "1991\u20132020"
+  "period": "1991\u20132020",
+  "image": "streets-climate-v1.png",
+  "imageBytes": 820873,
+  "imageSha256": "bede2213b0ba74d77111fe182458ee30d219b989a9c11fe5ce121de1c549dfc4"
 }