@tileflow/maps 0.1.0-alpha.7 → 0.1.0-alpha.9

package/docs/design-and-assets.md

@@ -43,7 +43,8 @@ never determines landmark color.
 The generalized footprint pass ends at z15 with the same opacity at which the
 detail pass begins.
 
-POI symbols and names form one collision unit. Each category retains its own filter, and candidates
+POI symbols and names form one collision unit. Each category retains its own filter and layer
+(`placement.order: 'categories'`), and destinations listed first are placed first. Candidates
 must carry the schema-bound `poiCategory`, `poiFilterRank`, and `poiSizeRank` fields (`category`,
 `filter_rank`, and `size_rank` in World V1). Size ranks must be 0–16, filter ranks must be
 nonnegative, and the producer's `minZoom` (`min_zoom`) is honored when present. Landmarks, culture,
@@ -66,7 +67,9 @@ Regular fallback.
 `baedeker` is a self-contained travel-atlas and town-plan design with open warm paper, fine coral
 building and residential hatching, paper-negative streets, dominant black railways, horizontally
 engraved cyan water, ring-stippled gardens, and browser-derived Mapterhorn contours. Travel POIs
-are rendered as compact serif labels without modern pictograms. It declares
+are rendered as compact serif labels without modern pictograms; stations and landmarks use the
+semibold face, so each category keeps its own layer and the categories listed first are placed
+first. It declares
 `[baedekerIcons]`, whose eight original Tileflow SVG patterns describe hachures, orchards, paper
 grain, public gardens, residential blocks, sand, water lines, and wetlands, plus
 `[baedekerFonts]`, its own package copy of Cormorant Garamond Regular, SemiBold, and Italic. Its
@@ -137,7 +140,8 @@ and `[siegfriedThemes]` exposes the two complete visual vocabularies for safe de
 Fine technical road strokes, survey-like uppercase labels, precise building footprints, contour
 dimensions, and dedicated landscape and water hatches replace naturalistic map color. It declares
 the canonical Noto Sans glyph provider and only `[blueprintIcons]`, whose four original patterns
-and schematic POI node form its complete sprite vocabulary.
+and schematic POI node form its complete sprite vocabulary. Medical and transport callouts start
+before the other POI labels, so each category keeps its own layer, placed in the listed order.
 Prominent building height callouts use World `render_height`; the map does not require unpublished
 building names or raw heights.
 
@@ -149,15 +153,32 @@ lighting without changing a source, filter, layer order, zoom gate, collision ru
 sidewalk patterns live in the shared `[streetsIcons]` atlas and the selected theme resolves the
 semantic `roads.sidewalkPattern` image token to the correct asset.
 
-Streets uses one ranked destination hierarchy in both themes. Major transit and cultural anchors
-appear first; lodging, health, education, services, shopping, food, coffee, and parking enter
-progressively as the camera approaches street level. Each visible destination is one collision
-unit made from a colored circular pictogram and an optional neutral name, so the marker remains
-useful when the label cannot fit. The pictogram scale grows gently from 1× at z12 to 1.06× at z17,
-giving detailed street views a little more visual presence without increasing POI density.
-Portal-number labels are intentionally disabled. The ten POI
-pictograms are adapted from the pinned CC0 Maki subset documented in
-`THIRD_PARTY_NOTICES.md`; their containers, colors, sizing, and composition are Tileflow-authored.
+Streets places every POI category in World's importance order, with one density for the whole
+module: `filter_rank` and then `size_rank` decide which destinations win, so a metro station is not
+displaced by a nearby cash machine because of its category, and no category waits for a later
+zoom. Its labels give street and place names priority over everyday destinations; World's two most
+important ranks (`prominentRank: 1`) are placed before them, so landmarks such as Palais du Louvre,
+Plaza Mayor, or Battery Park remain at z14. Each destination is one collision unit made from a
+colored disc and its name in the category color: both must fit. Parking and public toilets are
+self-explanatory and appear as a disc alone; other unnamed POIs are omitted. Three-pixel icon and
+text padding keeps nearby names available without disabling collision. Portal-number labels are
+disabled.
+
+Pictograms follow World's transport `mode` first, then its POI `type`, then the category. World's
+own `icon` field is coarser (one `shop` for every store, one `transport` for metro, bus, and cable
+car), so Streets reads the type. `src/official/streets-poi.ts` owns the type and mode tables, the
+85 pictograms, and their disc palette; `scripts/generate-streets-poi-icons.ts` writes each light
+disc and its `-dark` variant, a pale disc with a dark pictogram. Themes bind each type's pictogram
+through a `poi.pictogram.<id>` image token and each category's default pictogram through Core's
+`poi.<category>` image role, so a theme that replaces a category role replaces that category's
+default pictogram. The pictograms keep the CC0 Maki provenance documented in
+`THIRD_PARTY_NOTICES.md`.
+
+Regional hillshade uses the public Mapterhorn TileJSON endpoint with Terrarium encoding, from
+z5 to before z14. Day and night use separate highlight, accent, and shadow tokens. The DEM is a
+remote runtime dependency with its own attribution, and `terrain: 'none'` removes it. The layer
+adds shaded relief without displacing geometry. Flat building footprints, runtime-toggle
+extrusions, and the existing vegetation renderer remain separate from the hillshade.
 
 Road references use a compact Tileflow-owned family of generic rectangular and circular shields.
 The data's normalized `shield_kind` selects neutral, blue, green, red, orange, yellow, or circular
@@ -175,8 +196,8 @@ and the overview candidate schedule keep regional views legible while preserving
 at street scale.
 
 The two palettes are Tileflow-owned, deterministic snapshots calibrated from rendered Mapbox
-Standard `default/day` and `default/night` references on 2026-08-27. They do not import Mapbox style
-JSON, rules, assets, or runtime dependencies. Public roles such as `surface.background`,
+Standard `default/day` and `default/night` references on 2026-10-14. The [Standard playground](https://docs.mapbox.com/playground/standard-style/) is the visual
+reference; the map does not import its style JSON, assets, or runtime dependencies. Public roles such as `surface.background`,
 `landuse.industrial`, `landuse.medical`, `labels.settlement`, `labels.neighborhood`, and
 `labels.road` remain independently wired; `hydro.ocean` also separates Standard Night's deep sea
 from urban and inland water. An agent can alter one cartographic intent without

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tileflow/maps",
-  "version": "0.1.0-alpha.7",
+  "version": "0.1.0-alpha.9",
   "license": "Apache-2.0",
   "description": "Official themed Streets, Baedeker, Cívica, Ferraris, Härad, Siegfried, Soundings, and Blueprint maps for Tileflow.",
   "type": "module",
@@ -53,12 +53,12 @@
     "access": "public"
   },
   "peerDependencies": {
-    "@tileflow/core": ">=0.1.0-alpha.30 <0.1.0-beta.0"
+    "@tileflow/core": ">=0.1.0-alpha.35 <0.1.0-beta.0"
   },
   "devDependencies": {
     "@maplibre/maplibre-gl-style-spec": "24.8.5",
-    "@maplibre/maplibre-gl-style-spec-v6": "npm:@maplibre/maplibre-gl-style-spec@26.4.2",
-    "@tileflow/core": "0.1.0-alpha.30"
+    "@maplibre/maplibre-gl-style-spec-v6": "npm:@maplibre/maplibre-gl-style-spec@26.4.4",
+    "@tileflow/core": "0.1.0-alpha.35"
   },
   "scripts": {
     "build": "tsup src/index.ts --format esm --dts --clean --no-splitting",