@tileflow/maps 0.1.0-alpha.6 → 0.1.0-alpha.8

package/README.md

@@ -66,9 +66,8 @@ to create an application-owned map.
 ### Blueprint naming
 
 Use `blueprint` and `blueprintIcons` for the architectural drawing map. Its map ID and
-asset directory are `blueprint`, its theme key is `blueprint`, and its theme ID is `blueprint-dark`.
-The earlier `sanFrancisto` and `sanFrancistoIcons` aliases have been removed. Migrate explicit
-`san-francisto` resource references to `blueprint`; the former grid ID is now `blueprint-grid`.
+asset directory are `blueprint`, its theme key is `blueprint`, its theme ID is `blueprint-dark`,
+and its grid artwork ID is `blueprint-grid`.
 
 <!-- docs:check -->
 
@@ -88,17 +87,11 @@ export default defineMap({
 
 Cyberpunk, Terminal, and Super Tile World are maintained in
 [Tileflow Community Maps](https://github.com/tileflow/community-maps), with editable source,
-assets, previews, and contribution instructions. They are no longer included in this package.
+assets, previews, and contribution instructions. They are not part of this package.
 The GitHub-distributed `@tileflow/community-maps` package exports `cyberpunk`, `terminal`, and
 `superTileWorld`, plus each map's font and icon descriptors. Install an exact Git commit using
 the instructions and compatible Core version in that repository.
 
-For existing applications, move imports to `@tileflow/community-maps`, rename `matrix` to
-`terminal`, and update explicit map and asset IDs. Cyberpunk uses the `cyberpunk-` asset prefix;
-Terminal uses `terminal-`. Super Tile World retains `super-tile-world` and its `stw-` artwork IDs.
-The earlier community `neonGrid` export is now `cyberpunk`. This is an explicit catalog migration;
-there are no compatibility snapshots or aliases for the removed maps in the SDK.
-
 Soundings is not a navigation product. Its depth-band edges are approximate reference geometry,
 not surveyed isolines or vessel-specific safety contours. Experimental nautical aids and hazards
 are not enabled by that official map.

package/dist/index.js

@@ -561,9 +561,8 @@ function landcoverPattern(target, pattern, classes, options = {}) {
   } : classSelector;
   const minZoom = options.minZoom ?? 9;
   return renderPass({
-    attachTo: target,
+    placement: { above: target },
     feature: "landcover",
-    phase: "overlay",
     renderer: "fill",
     selector,
     style: {
@@ -578,9 +577,8 @@ function landcoverPattern(target, pattern, classes, options = {}) {
 }
 function landusePattern(target, pattern, classes, minZoom, opacity) {
   return renderPass({
-    attachTo: target,
+    placement: { above: target },
     feature: "landuse",
-    phase: "overlay",
     renderer: "fill",
     selector: { field: "class", kind: "in", values: classes },
     style: {
@@ -872,9 +870,8 @@ var baedeker = bindOfficialMapTheme(
         }),
         {
           engravedBlocks: renderPass({
-            attachTo: "buildings.flat.fill",
+            placement: { above: "buildings.flat.fill" },
             feature: "building",
-            phase: "overlay",
             renderer: "fill",
             style: {
               minZoom: 14,
@@ -1503,7 +1500,6 @@ var baedeker = bindOfficialMapTheme(
           strokeOpacity: 0.78,
           strokeWidth: 0.8
         },
-        minZoom: 15,
         mode: "flat"
       }),
       water: withRenderStack(
@@ -1573,9 +1569,8 @@ var baedeker = bindOfficialMapTheme(
         }),
         {
           printLines: renderPass({
-            attachTo: "water.bodies.fill",
+            placement: { above: "water.bodies.fill" },
             feature: "water",
-            phase: "overlay",
             renderer: "fill",
             selector: {
               coerce: "number",
@@ -1596,9 +1591,8 @@ var baedeker = bindOfficialMapTheme(
             }
           }),
           intermittentPrintLines: renderPass({
-            attachTo: "water.intermittent.bodies.fill",
+            placement: { above: "water.intermittent.bodies.fill" },
             feature: "water",
-            phase: "overlay",
             renderer: "fill",
             selector: {
               coerce: "number",
@@ -1866,9 +1860,8 @@ var prominentBuildingSelector = {
 };
 function technicalLandPattern(target, feature, pattern, selector, minZoom, opacity) {
   return renderPass2({
-    attachTo: target,
+    placement: { above: target },
     feature,
-    phase: "overlay",
     renderer: "fill",
     selector,
     style: {
@@ -2209,9 +2202,8 @@ var blueprint = bindOfficialMapTheme(
         }),
         {
           footprintHatch: renderPass2({
-            attachTo: "buildings.flat.fill",
+            placement: { above: "buildings.flat.fill" },
             feature: "building",
-            phase: "overlay",
             renderer: "fill",
             // A section hatch is reserved for the few footprints that carry
             // architectural emphasis; ordinary building fills remain quiet.
@@ -2227,9 +2219,8 @@ var blueprint = bindOfficialMapTheme(
             }
           }),
           measuredEdge: renderPass2({
-            attachTo: "buildings.flat.outline",
+            placement: { above: "buildings.flat.outline" },
             feature: "building",
-            phase: "overlay",
             renderer: "line",
             selector: { geometry: "polygon", kind: "geometry" },
             style: {
@@ -2248,9 +2239,8 @@ var blueprint = bindOfficialMapTheme(
             }
           }),
           prominentOutline: renderPass2({
-            attachTo: "buildings.render.measuredEdge",
+            placement: { above: "buildings.render.measuredEdge" },
             feature: "building",
-            phase: "overlay",
             renderer: "line",
             selector: prominentBuildingSelector,
             style: {
@@ -2270,9 +2260,8 @@ var blueprint = bindOfficialMapTheme(
             }
           }),
           heightAnnotations: renderPass2({
-            attachTo: "buildings.render.prominentOutline",
+            placement: { above: "buildings.render.prominentOutline" },
             feature: "building",
-            phase: "annotation",
             renderer: "symbol",
             selector: {
               kind: "all",
@@ -2828,9 +2817,8 @@ var blueprint = bindOfficialMapTheme(
         }),
         {
           architecturalCallouts: renderPass2({
-            attachTo: "poi.visitor-amenity.label",
+            placement: { above: "poi.visitor-amenity.label" },
             feature: "poi",
-            phase: "annotation",
             renderer: "symbol",
             selector: {
               kind: "all",
@@ -3099,9 +3087,8 @@ var blueprint = bindOfficialMapTheme(
         }),
         {
           majorRoadCenterline: renderPass2({
-            attachTo: "roads.classes.motorway.surface.fill",
+            placement: { above: "roads.classes.motorway.surface.fill" },
             feature: "road",
-            phase: "overlay",
             renderer: "line",
             selector: {
               kind: "all",
@@ -3238,7 +3225,6 @@ var blueprint = bindOfficialMapTheme(
           strokeOpacity: 0.58,
           strokeWidth: 0.55
         },
-        minZoom: 16,
         mode: "flat"
       }),
       water: withRenderStack2(
@@ -3311,9 +3297,8 @@ var blueprint = bindOfficialMapTheme(
         }),
         {
           waterHatch: renderPass2({
-            attachTo: "water.bodies.fill",
+            placement: { above: "water.bodies.fill" },
             feature: "water",
-            phase: "overlay",
             renderer: "fill",
             selector: {
               coerce: "number",
@@ -3334,9 +3319,8 @@ var blueprint = bindOfficialMapTheme(
             }
           }),
           intermittentWaterHatch: renderPass2({
-            attachTo: "water.intermittent.bodies.fill",
+            placement: { above: "water.intermittent.bodies.fill" },
             feature: "water",
-            phase: "overlay",
             renderer: "fill",
             selector: {
               coerce: "number",
@@ -3537,11 +3521,10 @@ function destination(image, minZoom, color, featured = false, role = "caption")
     }
   };
 }
-function texture(attachTo, feature, selector, pattern, minZoom, opacity) {
+function texture(above, feature, selector, pattern, minZoom, opacity) {
   return renderPass3({
-    attachTo,
     feature,
-    phase: "overlay",
+    placement: { above },
     renderer: "fill",
     selector,
     style: {
@@ -3862,8 +3845,7 @@ var civica = bindOfficialMapTheme(
             0.15
           ),
           paperGrain: renderPass3({
-            attachTo: "land.background",
-            phase: "overlay",
+            placement: { above: "land.background" },
             renderer: "background",
             style: { pattern: "civica-paper-grain", opacity: 0.12 }
           })
@@ -3918,9 +3900,8 @@ var civica = bindOfficialMapTheme(
         }),
         {
           waterLines: renderPass3({
-            attachTo: "water.bodies.fill",
+            placement: { above: "water.bodies.fill" },
             feature: "water",
-            phase: "overlay",
             renderer: "fill",
             style: {
               pattern: "civica-water-lines",
@@ -3949,9 +3930,8 @@ var civica = bindOfficialMapTheme(
           // Core's ordinary building deck begins at z15. This separate plate lets
           // available generalized footprints describe the city at district scales.
           districtFootprints: renderPass3({
-            attachTo: "buildings.flat.fill",
+            placement: { below: "buildings.flat.fill" },
             feature: "building",
-            phase: "underlay",
             renderer: "fill",
             selector: { kind: "geometry", geometry: "polygon" },
             style: {
@@ -4375,9 +4355,9 @@ var civica = bindOfficialMapTheme(
       ),
       vegetation: vegetation3({
         mode: "flat",
-        minZoom: 19,
         flat: {
           color: ink.greenInk,
+          minZoom: 19,
           opacity: 0.5,
           radius: zoom3.linear([
             [19, 1.2],
@@ -4587,9 +4567,8 @@ function landcoverPattern2(target, pattern, classes, options = {}) {
   } : classSelector;
   const minZoom = options.minZoom ?? 9;
   return renderPass4({
-    attachTo: target,
+    placement: { above: target },
     feature: "landcover",
-    phase: "overlay",
     renderer: "fill",
     selector,
     style: {
@@ -4604,9 +4583,8 @@ function landcoverPattern2(target, pattern, classes, options = {}) {
 }
 function landusePattern2(target, pattern, classes, minZoom, opacity) {
   return renderPass4({
-    attachTo: target,
+    placement: { above: target },
     feature: "landuse",
-    phase: "overlay",
     renderer: "fill",
     selector: { field: "class", kind: "in", values: classes },
     style: {
@@ -4870,9 +4848,8 @@ var ferraris = bindOfficialMapTheme(
         }),
         {
           printShadow: renderPass4({
-            attachTo: "buildings.flat.fill",
+            placement: { below: "buildings.flat.fill" },
             feature: "building",
-            phase: "underlay",
             renderer: "fill",
             style: {
               color: ferrarisPalette.ink,
@@ -5365,7 +5342,6 @@ var ferraris = bindOfficialMapTheme(
           strokeOpacity: 0.62,
           strokeWidth: 0.7
         },
-        minZoom: 15,
         mode: "flat"
       }),
       water: withRenderStack4(
@@ -5453,9 +5429,8 @@ var ferraris = bindOfficialMapTheme(
         }),
         {
           ripples: renderPass4({
-            attachTo: "water.bodies.fill",
+            placement: { above: "water.bodies.fill" },
             feature: "water",
-            phase: "overlay",
             renderer: "fill",
             selector: {
               coerce: "number",
@@ -5476,9 +5451,8 @@ var ferraris = bindOfficialMapTheme(
             }
           }),
           intermittentRipples: renderPass4({
-            attachTo: "water.intermittent.bodies.fill",
+            placement: { above: "water.intermittent.bodies.fill" },
             feature: "water",
-            phase: "overlay",
             renderer: "fill",
             selector: {
               coerce: "number",
@@ -5662,9 +5636,8 @@ function landcoverPattern3(target, pattern, classes, options = {}) {
     opacityStops.push([options.highZoom, options.highZoomOpacity]);
   }
   return renderPass5({
-    attachTo: target,
+    placement: { above: target },
     feature: "landcover",
-    phase: "overlay",
     renderer: "fill",
     selector,
     style: {
@@ -5683,9 +5656,8 @@ function landusePattern3(target, pattern, classes, minZoom, opacity, maxZoom) {
     opacityStops.push([maxZoom - 2, opacity * 0.5], [maxZoom, 0]);
   }
   return renderPass5({
-    attachTo: target,
+    placement: { above: target },
     feature: "landuse",
-    phase: "overlay",
     renderer: "fill",
     selector: { field: "class", kind: "in", values: classes },
     style: {
@@ -6142,9 +6114,8 @@ var harad = bindOfficialMapTheme(
         }),
         {
           fieldBoundaries: renderPass5({
-            attachTo: "land.landcover.farmland.fill",
+            placement: { above: "land.landcover.farmland.fill" },
             feature: "landcover",
-            phase: "overlay",
             renderer: "line",
             selector: { field: "class", kind: "in", values: ["farmland"] },
             style: {
@@ -6395,7 +6366,6 @@ var harad = bindOfficialMapTheme(
           strokeOpacity: 0.5,
           strokeWidth: 0.55
         },
-        minZoom: 15,
         mode: "flat"
       }),
       water: withRenderStack5(
@@ -6479,9 +6449,8 @@ var harad = bindOfficialMapTheme(
         }),
         {
           printLines: renderPass5({
-            attachTo: "water.bodies.fill",
+            placement: { above: "water.bodies.fill" },
             feature: "water",
-            phase: "overlay",
             renderer: "fill",
             selector: {
               coerce: "number",
@@ -6502,9 +6471,8 @@ var harad = bindOfficialMapTheme(
             }
           }),
           intermittentPrintLines: renderPass5({
-            attachTo: "water.intermittent.bodies.fill",
+            placement: { above: "water.intermittent.bodies.fill" },
             feature: "water",
-            phase: "overlay",
             renderer: "fill",
             selector: {
               coerce: "number",
@@ -6898,9 +6866,8 @@ function landcoverFilter(classes, options = {}) {
 function landcoverPattern4(target, pattern, classes, options = {}) {
   const minZoom = options.minZoom ?? 9;
   return renderPass6({
-    attachTo: target,
+    placement: { above: target },
     feature: "landcover",
-    phase: "overlay",
     renderer: "fill",
     selector: landcoverFilter(classes, options),
     style: {
@@ -6915,9 +6882,8 @@ function landcoverPattern4(target, pattern, classes, options = {}) {
 }
 function postContourLandcoverPattern(target, pattern, classes, options) {
   return renderPass6({
-    attachTo: target,
+    placement: { above: target },
     feature: "landcover",
-    phase: "postRelief",
     renderer: "fill",
     requirements: ["land"],
     selector: landcoverFilter(classes, options),
@@ -7580,9 +7546,8 @@ var siegfried = bindOfficialMapTheme(
         }),
         {
           rockMask: renderPass6({
-            attachTo: "water.bodies.fill",
+            placement: { below: "water.bodies.fill" },
             feature: "landcover",
-            phase: "underlay",
             renderer: "fill",
             requirements: ["land"],
             selector: { field: "class", kind: "in", values: ["rock"] },
@@ -7613,18 +7578,16 @@ var siegfried = bindOfficialMapTheme(
             }
           ),
           glacierMask: renderPass6({
-            attachTo: "water.bodies.fill",
+            placement: { below: "water.bodies.fill" },
             feature: "landcover",
-            phase: "underlay",
             renderer: "fill",
             requirements: ["land"],
             selector: { field: "class", kind: "in", values: ["ice", "glacier"] },
             style: { color: siegfriedPalette.paper, minZoom: 7, opacity: 0.98 }
           }),
           glacierPattern: renderPass6({
-            attachTo: "water.render.glacierMask",
+            placement: { above: "water.render.glacierMask" },
             feature: "landcover",
-            phase: "postRelief",
             renderer: "fill",
             requirements: ["land"],
             selector: { field: "class", kind: "in", values: ["ice", "glacier"] },
@@ -7639,9 +7602,8 @@ var siegfried = bindOfficialMapTheme(
             }
           }),
           glacierOutline: renderPass6({
-            attachTo: "water.render.glacierPattern",
+            placement: { above: "water.render.glacierPattern" },
             feature: "landcover",
-            phase: "postRelief",
             renderer: "line",
             requirements: ["land"],
             selector: { field: "class", kind: "in", values: ["ice", "glacier"] },
@@ -7655,9 +7617,8 @@ var siegfried = bindOfficialMapTheme(
             }
           }),
           waterLines: renderPass6({
-            attachTo: "water.bodies.outline",
+            placement: { above: "water.bodies.outline" },
             feature: "water",
-            phase: "overlay",
             renderer: "fill",
             selector: {
               coerce: "number",
@@ -7678,9 +7639,8 @@ var siegfried = bindOfficialMapTheme(
             }
           }),
           intermittentWaterLines: renderPass6({
-            attachTo: "water.intermittent.bodies.fill",
+            placement: { above: "water.intermittent.bodies.fill" },
             feature: "water",
-            phase: "overlay",
             renderer: "fill",
             selector: {
               coerce: "number",
@@ -8174,9 +8134,8 @@ var soundings = bindOfficialMapTheme(
         {
           // Ferry names are operational context, not a recommended track.
           ferryLabels: renderPass7({
-            attachTo: "transit.ferry",
+            placement: { above: "transit.ferry" },
             feature: "roadName",
-            phase: "overlay",
             renderer: "symbol",
             selector: {
               kind: "all",
@@ -8364,9 +8323,8 @@ var soundings = bindOfficialMapTheme(
           // Piers remain visible even though the terrestrial road family is disabled.
           // A dark outer stroke and ivory deck read as charted shoreline structures.
           pierOutline: renderPass7({
-            attachTo: "water.bodies.outline",
+            placement: { above: "water.bodies.outline" },
             feature: "road",
-            phase: "overlay",
             renderer: "line",
             selector: {
               kind: "any",
@@ -8393,9 +8351,8 @@ var soundings = bindOfficialMapTheme(
             }
           }),
           pierDeck: renderPass7({
-            attachTo: "water.render.pierOutline",
+            placement: { above: "water.render.pierOutline" },
             feature: "road",
-            phase: "overlay",
             renderer: "line",
             selector: {
               kind: "any",
@@ -8421,9 +8378,8 @@ var soundings = bindOfficialMapTheme(
             }
           }),
           chartDots: renderPass7({
-            attachTo: "water.bodies.fill",
+            placement: { above: "water.bodies.fill" },
             feature: "water",
-            phase: "overlay",
             renderer: "fill",
             selector: {
               coerce: "number",
@@ -8444,9 +8400,8 @@ var soundings = bindOfficialMapTheme(
             }
           }),
           intermittentChartDots: renderPass7({
-            attachTo: "water.intermittent.bodies.fill",
+            placement: { above: "water.intermittent.bodies.fill" },
             feature: "water",
-            phase: "overlay",
             renderer: "fill",
             selector: {
               coerce: "number",
@@ -9377,13 +9332,13 @@ var circularRoadCasingWidth = circularRoadStrokeWidth(true);
 var expresswayWidthScale = 1.06;
 var tunnelBorderDash = [3, 3];
 var tunnelBorderWidth = 1;
-function circularRoadLegacyScale(level) {
+function circularRoadFallbackScale(level) {
   const interpolationBase = 1.35;
   const progress = (interpolationBase ** (level - 15) - 1) / (interpolationBase ** (22 - 15) - 1);
   return 1 + progress * 1.2;
 }
 function circularRoadWidthAtLevel(level) {
-  const scale = circularRoadLegacyScale(level);
+  const scale = circularRoadFallbackScale(level);
   return level === 15 ? circularRoadBaseWidth : expr9.multiply(circularRoadBaseWidth, scale);
 }
 function circularRoadCenterlineRadiusAtLevel(level) {
@@ -9631,9 +9586,8 @@ var namedCitySelector = {
 function streetsBoundaryRenderStack() {
   return {
     admin2Background: renderPass8({
-      attachTo: "boundaries.admin4",
+      placement: { below: "boundaries.admin4" },
       feature: "boundary",
-      phase: "underlay",
       renderer: "line",
       selector: {
         kind: "all",
@@ -9674,9 +9628,8 @@ function streetsBoundaryRenderStack() {
       }
     }),
     admin4Background: renderPass8({
-      attachTo: "boundaries.admin4",
+      placement: { below: "boundaries.admin4" },
       feature: "boundary",
-      phase: "underlay",
       renderer: "line",
       selector: {
         kind: "all",
@@ -9722,9 +9675,8 @@ function streetsBoundaryRenderStack() {
     // Standard uses the next tier as a restrained dotted municipal cue from
     // metro zooms onward, so Streets adds it as an explicit semantic pass.
     admin6: renderPass8({
-      attachTo: "boundaries.admin4",
+      placement: { above: "boundaries.admin4" },
       feature: "boundary",
-      phase: "overlay",
       renderer: "line",
       selector: {
         kind: "all",
@@ -9768,9 +9720,8 @@ function streetsBoundaryRenderStack() {
 function streetsLandRenderStack() {
   return {
     businessArea: renderPass8({
-      attachTo: "land.landuse.residential.fill",
+      placement: { above: "land.landuse.residential.fill" },
       feature: "landuse",
-      phase: "overlay",
       renderer: "fill",
       selector: { field: "class", kind: "compare", operator: "eq", value: "business_area" },
       style: {
@@ -9787,9 +9738,8 @@ function streetsBuildingRenderStack() {
     // fill and its close-colour outline carry the 2D building hierarchy; a
     // dark shadow at z15 would turn every footprint into a heavy sticker.
     flatShadow: renderPass8({
-      attachTo: "buildings.flat.fill",
+      placement: { below: "buildings.flat.fill" },
       feature: "building",
-      phase: "underlay",
       renderer: "line",
       style: {
         blur: 2,
@@ -9812,9 +9762,8 @@ function streetsBuildingRenderStack() {
       }
     }),
     shadowSoft: renderPass8({
-      attachTo: "buildings.flat.fill",
+      placement: { below: "buildings.flat.fill" },
       feature: "building",
-      phase: "underlay",
       renderer: "line",
       selector: visibleBuilding3dSelector,
       style: {
@@ -9829,9 +9778,8 @@ function streetsBuildingRenderStack() {
       }
     }),
     shadowCore: renderPass8({
-      attachTo: "buildings.flat.fill",
+      placement: { below: "buildings.flat.fill" },
       feature: "building",
-      phase: "underlay",
       renderer: "fill",
       selector: visibleBuilding3dSelector,
       style: {
@@ -9845,9 +9793,8 @@ function streetsBuildingRenderStack() {
       }
     }),
     extrusion: renderPass8({
-      attachTo: "buildings.flat.outline",
+      placement: { above: "buildings.flat.outline" },
       feature: "building",
-      phase: "overlay",
       renderer: "extrusion",
       selector: visibleBuilding3dSelector,
       style: {
@@ -9865,9 +9812,8 @@ function streetsBuildingRenderStack() {
 function streetsLabelRenderStack() {
   return {
     settlementMarker: renderPass8({
-      attachTo: "labels.places.city",
+      placement: { below: "labels.places.city" },
       feature: "place",
-      phase: "underlay",
       renderer: "circle",
       selector: namedCitySelector,
       style: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tileflow/maps",
-  "version": "0.1.0-alpha.6",
+  "version": "0.1.0-alpha.8",
   "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.29 <0.1.0-beta.0"
+    "@tileflow/core": ">=0.1.0-alpha.32 <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.29"
+    "@maplibre/maplibre-gl-style-spec-v6": "npm:@maplibre/maplibre-gl-style-spec@26.4.4",
+    "@tileflow/core": "0.1.0-alpha.32"
   },
   "scripts": {
     "build": "tsup src/index.ts --format esm --dts --clean --no-splitting",