@tileflow/dev 0.1.0-alpha.30 → 0.1.0-alpha.32

package/README.md

@@ -33,6 +33,13 @@ export default defineMap({id: 'madrid', version: 1, extends: streets});
 Loading the config executes its imports. It is not a sandbox for untrusted code. Local preparation
 needs no API key, but serving a map can still cause requests to its remote data or font providers.
 
+The CLI's local Map DevTools provides a dockable layer inspector, loaded tiles, assets, scene
+controls and frame timing. Its element picker selects a layer and evaluates its rules using the
+feature clicked on the map.
+Performance's Overdraw overlay uses a heatmap with a visible pass-count legend and explanation.
+See [Map DevTools and compiler inspection](https://github.com/tileflow/tileflow-sdk/blob/main/packages/dev/docs/local-comparison-workbench-and-compiler-inspection.md)
+for interaction details and observation limits.
+
 ## Prepare a generation
 
 <!-- docs:check -->
@@ -54,6 +61,12 @@ The artifact plan exposes files and observed inputs from the same generation. St
 `styles[map][theme]`, never as an implicit default-theme alias. Keep that generation alive for the
 whole operation, then release it. Do not reconstruct its asset list from directory guesses.
 
+Map-owned tree models are prepared alongside icons and embedded in the styles. Custom tools that
+compile icons separately can use `prepareTileflowMapTreeModels` from `@tileflow/dev/icons` with
+the map's model directories, base directory, working directory, target and diagnostic path. Pass
+its `models` result as `preparedAssets.models` when compiling the style; retain its source
+identities and watch paths when managing revisions. The artifact pipeline does this automatically.
+
 To write production output rather than manage it in memory:
 
 <!-- docs:check -->
@@ -123,7 +136,51 @@ Use `/artifacts` for preparation and output, `/server` for HTTP handling, `/conf
 loading, `/icons` and `/fonts` for asset preparation, `/inspect` for bounded inspection, `/tilesets`
 for local PMTiles inspection, and `/validation` for diagnostics. `/preview` is the local preview
 contract, including experimental preview-only rendering; it does not promise hosted support.
-The package has no root entry point.
+The package has no root entry point. `/server` also exposes the reusable Map DevTools shell. The CLI
+connects appearance controls and shared browser context through its optional local
+workflow adapter; see the [Map DevTools guide](https://github.com/tileflow/tileflow-sdk/blob/main/packages/dev/docs/local-comparison-workbench-and-compiler-inspection.md).
+The navigation contains **Map**, **Layers**, **Tiles**, **Assets**, **Debug** and **Beacon**.
+Zoom, Bearing and Pitch occupy a separate row directly below it, with a live zoom slider,
+**Reset** to restore all three initial camera values, and **Copy context for agent**.
+The active tab and selected layer remain in the URL across reloads. The menu provides left,
+right and bottom docking, System/Light/Dark appearance, and **Reset all changes**.
+
+**Map** exposes time-of-day segments, palette cards with actual style swatches, 3D view,
+Off/Grow/Fade building animation, and the map's module settings. The command selects the map.
+Changes update the existing map after a 300 ms pause while the form remains editable. Superseded
+compilations are discarded. Runtime controls do not recompile the style. Scene and layer edits
+share the header Undo/Redo controls; source files stay unchanged.
+
+**Layers** groups physical and runtime layers by module or draw order. Hover highlights geometry;
+selection keeps it highlighted independently of the element picker. The picker opens the clicked
+feature's layer in **Rules**. Rules expose live colors, numeric sliders, enums, expression curves,
+defaults, and checkboxes for temporarily disabling paint, layout and filters. Diagnosis, Data and
+Origin explain renderer state, sample features and available compiler provenance. **Visible**
+filters to the current viewport. Context can be reviewed as Markdown or JSON before copying.
+See [Layers inspection](https://github.com/tileflow/tileflow-sdk/blob/main/packages/dev/docs/layers-inspection.md).
+
+**Tiles** shows resident map tiles as a coordinate grid and source-grouped list. Source layers,
+Features and Info expose raw payload sizes, consumer layers, paginated features, GeoJSON and bounds.
+Inspection reads resident data without issuing tile requests. MLT and inaccessible renderer data
+have explicit unavailable states.
+
+**Assets** separates Icons, 3D models and Fonts. Icons lists real registered images and loads actual
+sprite variants for the map's palettes and times of day. Models previews bounded samples of loaded
+controller meshes, with available counts, bytes and LODs. Fonts renders editable samples from actual
+font files or glyphs and links back to consuming layers.
+
+**Debug** contains overdraw, collision and tile-boundary overlays, explanations, and controls for
+the map's actual pixel ratio. **Beacon** runs 48 checks across Rendering, Loading, Legibility,
+Accessibility, Cartography and Integrity. Choose Desktop/Mobile and Active tour (default), Quick check or All zooms. The active tour measures
+navigation and settled frames across the current view and five world cities within an approximately
+one-minute budget, reports partial coverage explicitly and restores the original camera. Findings
+link to Layers, Tiles and Debug and can be copied with evidence for an agent. Unknown or
+informational measurements do not contribute passing scores. See
+[Beacon map audits](https://github.com/tileflow/tileflow-sdk/blob/main/packages/dev/docs/beacon-map-audits.md)
+for sampling, scoring and measurement limits.
+
+The preview's globe rim follows the rendered canvas silhouette, including camera and viewport
+changes, and fades between zooms 3 and 6. Its colors follow the map's atmosphere when declared.
 
 Invalid compiled styles throw `TileflowStyleValidationError` with bounded issues. Keep diagnostics
 structured; do not return executable config, local paths, credentials, or complete generated byte
@@ -195,7 +252,7 @@ These references are also included under `docs/` in the installed package:
 
 - [Native artifact preparation](https://github.com/tileflow/tileflow-sdk/blob/main/packages/dev/docs/native-artifacts.md): static compatibility, renderer-qualified output, and limitations.
 - [Artifact lifecycle](https://github.com/tileflow/tileflow-sdk/blob/main/packages/dev/docs/artifact-lifecycle.md): generations, immutable snapshots, provenance, and cleanup.
-- [Local comparison and inspection](https://github.com/tileflow/tileflow-sdk/blob/main/packages/dev/docs/local-comparison-workbench-and-compiler-inspection.md): workbench controls and preview-only models.
+- [Local comparison and inspection](https://github.com/tileflow/tileflow-sdk/blob/main/packages/dev/docs/local-comparison-workbench-and-compiler-inspection.md): Map DevTools controls and preview-only models.
 - [Config diagnostics](https://github.com/tileflow/tileflow-sdk/blob/main/packages/dev/docs/structured-config-inspection-and-diagnostics.md): bounded, machine-readable inspection.
 - [PMTiles inspection](https://github.com/tileflow/tileflow-sdk/blob/main/packages/dev/docs/bounded-pmtiles-resource-inspection.md): metadata, sampling limits, and requested properties.
 - [Feature and icon inspection](https://github.com/tileflow/tileflow-sdk/blob/main/packages/dev/docs/bounded-vector-feature-inspection.md): supported sources, icon compilation, and delivered-pixel hashes.

package/THIRD_PARTY_NOTICES.md

@@ -2,8 +2,16 @@
 
 This file records third-party components used by Node preparation and preview. Official map artwork
 and fonts are owned and published by `@tileflow/maps`; `@tileflow/dev` does not carry an `assets/`
-directory. Runtime dependencies are installed as separate npm packages, and their code and native
-binaries are not copied into the dev package.
+directory. Map DevTools interface fonts are distributed separately under `ui-fonts/`. Node runtime dependencies are installed as separate npm packages. The browser inspector bundles
+the evaluator and decoders described below; native binaries are not copied into the dev package.
+
+## Map DevTools interface fonts
+
+Inter by Rasmus Andersson and JetBrains Mono by JetBrains are distributed under the SIL Open Font License 1.1. Their complete notices accompany the WOFF2 files in `ui-fonts/inter-OFL.txt` and `ui-fonts/jetbrains-mono-OFL.txt`. Source: <https://github.com/rsms/inter> and <https://github.com/JetBrains/JetBrainsMono>.
+
+Mona Sans and Hubot Sans by GitHub are distributed under the SIL Open Font License 1.1.
+Their complete notices accompany the WOFF2 files in `ui-fonts/mona-sans-OFL.txt` and
+`ui-fonts/hubot-sans-OFL.txt`. These fonts style the development interface and do not alter map text.
 
 ## Bitmap distance transform
 
@@ -31,7 +39,7 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SO
 ## Package-owned map fonts
 
 The generic font preparation pipeline reads map-owned TTF, OTF, and WOFF2 directories; it does not
-embed fonts in `@tileflow/dev`. Each source directory must carry its own `LICENSE.txt`, which is
+embed map fonts in `@tileflow/dev`. Each source directory must carry its own `LICENSE.txt`, which is
 copied into the deterministic build artifacts whenever that directory contributes a selected face.
 
 The source repository's generic font tests retain pinned Oxanium fixtures and their complete
@@ -85,3 +93,217 @@ Because `sharp` remains a separately installed optional package, users can insta
 or replace it independently of `@tileflow/dev`. Tileflow does not modify libvips and does not place a
 libvips shared library or a `sharp` native addon inside any Tileflow package tarball. Release smoke
 tests enforce that package boundary.
+
+## MapLibre style specification 24.8.5
+
+The Map DevTools browser bundle includes the expression evaluator and reference from
+`@maplibre/maplibre-gl-style-spec` 24.8.5. The following is the complete upstream `LICENSE.txt`,
+including its notices for incorporated code.
+
+Source: <https://github.com/maplibre/maplibre-style-spec/tree/v24.8.5>.
+
+```text
+Copyright (c) 2020, MapLibre contributors
+
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+    * Redistributions of source code must retain the above copyright notice,
+      this list of conditions and the following disclaimer.
+    * Redistributions in binary form must reproduce the above copyright notice,
+      this list of conditions and the following disclaimer in the documentation
+      and/or other materials provided with the distribution.
+    * Neither the name of MapLibre GL JS nor the names of its contributors
+      may be used to endorse or promote products derived from this software
+      without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
+CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+
+-------------------------------------------------------------------------------
+
+Contains code from mapbox-gl-js v1.13 and earlier
+
+Version v1.13 of mapbox-gl-js and earlier are licensed under a BSD-3-Clause license
+
+Copyright (c) 2020, Mapbox
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice,
+  this list of conditions and the following disclaimer.
+* Redistributions in binary form must reproduce the above copyright notice,
+  this list of conditions and the following disclaimer in the documentation
+  and/or other materials provided with the distribution.
+* Neither the name of Mapbox GL JS nor the names of its contributors
+  may be used to endorse or promote products derived from this software
+  without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
+CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
+EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+
+-------------------------------------------------------------------------------
+
+Contains code from glfx.js
+
+Copyright (C) 2011 by Evan Wallace
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+
+--------------------------------------------------------------------------------
+
+Contains a portion of d3-color https://github.com/d3/d3-color
+
+Copyright 2010-2016 Mike Bostock
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this
+  list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright notice,
+  this list of conditions and the following disclaimer in the documentation
+  and/or other materials provided with the distribution.
+
+* Neither the name of the author nor the names of contributors may be used to
+  endorse or promote products derived from this software without specific prior
+  written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+```
+
+## pbf 5.1.2
+
+The Map DevTools browser bundle includes the PBF reader to preview map font glyphs.
+Source: <https://github.com/mapbox/pbf/tree/v5.1.2>.
+
+```text
+Copyright (c) 2026, Mapbox
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this
+  list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright notice,
+  this list of conditions and the following disclaimer in the documentation
+  and/or other materials provided with the distribution.
+
+* Neither the name of pbf nor the names of its
+  contributors may be used to endorse or promote products derived from
+  this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+```
+
+## @mapbox/vector-tile 3.0.0
+
+The browser tile inspector bundles this MVT decoder to inspect resident vector tiles.
+Source: <https://github.com/mapbox/vector-tile-js/tree/v3.0.0>. License: BSD 3-Clause.
+
+Copyright (c) 2024, Mapbox
+
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+    * Redistributions of source code must retain the above copyright notice,
+      this list of conditions and the following disclaimer.
+    * Redistributions in binary form must reproduce the above copyright notice,
+      this list of conditions and the following disclaimer in the documentation
+      and/or other materials provided with the distribution.
+    * Neither the name of Mapbox nor the names of its contributors
+      may be used to endorse or promote products derived from this software
+      without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
+CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+## @mapbox/point-geometry 1.1.0
+
+Bundled with the vector-tile decoder for feature geometry.
+Source: <https://github.com/mapbox/point-geometry/tree/v1.1.0>. License: ISC.
+
+Copyright (c) 2024, Mapbox
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/dist/artifacts.d.ts

@@ -1,8 +1,10 @@
 import { MapLibreStyle, TileflowViewConfig, TileflowStyleOptions } from '@tileflow/core';
-import { TileflowBuildCatalog, TileflowBuildStyles, TileflowMapBuildManifestV1, TileflowRendererDeploymentArtifact, TileflowStyleInspection, TileflowMapBuildProvenanceV1, TileflowPreparedMapAssets } from '@tileflow/core/build';
+export { tileflowLandmarkRegionOf, tileflowLandmarkRegionZoom, tileflowLandmarkTileOf, tileflowLandmarkTileZoom } from '@tileflow/core';
+import { TileflowBuildCatalog, TileflowBuildStyles, TileflowMapBuildManifestV1, TileflowRendererDeploymentArtifact, TileflowPreparedMapAssets, TileflowStyleInspection, TileflowMapBuildProvenanceV1 } from '@tileflow/core/build';
 import { TileflowRuntimeManifest } from '@tileflow/core/manifest';
 import { TileflowRenderer, TileflowNativeBuildRecord } from '@tileflow/core/native-profile';
-import { TileflowBuildAsset, TileflowIconResolutionOptions, PreparedTileflowBuildCatalog, TileflowSourceCatalog, PreparedTileflowCatalog } from './icons.js';
+import { T as TileflowBuildAsset, a as TileflowIconResolutionOptions, P as PreparedTileflowBuildCatalog, b as TileflowSourceCatalog, c as PreparedTileflowCatalog } from './icons-B84H8Ymu.js';
+export { d as TileflowBuildingModelLevels, e as TileflowLandmarkSource, f as encodeTileflowLandmarkRegion, p as packageTileflowLandmarkTile, g as prepareTileflowBuildingModel } from './icons-B84H8Ymu.js';
 export { defaultTileflowConfigPath } from './config.js';
 
 /**
@@ -177,6 +179,8 @@ type TileflowBuildArtifactsOptions = {
 type TileflowBuildStyleInspections = Record<string, Record<string, TileflowStyleInspection>>;
 /** Compatibility shape consumed by sessions and capture callers. */
 type TileflowBuildArtifacts = {
+    /** Local-only prepared handles used to recompile module controls without resolving assets again. */
+    mapAssets?: Readonly<Record<string, TileflowPreparedMapAssets>>;
     assets: TileflowBuildAsset[];
     buildManifest: TileflowMapBuildManifestV1;
     /** Present only for native artifact preparation; never part of the runtime manifest. */

package/dist/artifacts.js

@@ -23,11 +23,15 @@ import {
   tileflowArtifactInventoryFileName,
   tileflowArtifactPlanSchemaVersion,
   tileflowArtifactSessionSchemaVersion,
+  tileflowLandmarkRegionOf,
+  tileflowLandmarkRegionZoom,
+  tileflowLandmarkTileOf,
+  tileflowLandmarkTileZoom,
   tileflowLineBackgroundGlyphRoute,
   usesTileflowLineBackgroundGlyphs,
   writeTileflowArtifactPlan,
   writeTileflowBuildArtifacts
-} from "./chunk-L56FLV4R.js";
+} from "./chunk-CM6ZTYDJ.js";
 import {
   getTileflowAssetBasePath,
   getTileflowAssetFileName,
@@ -35,12 +39,16 @@ import {
   normalizeTileflowBasePath,
   resolveTileflowArtifactPublicUrls
 } from "./chunk-UTRO4IBQ.js";
-import "./chunk-A2VTI43Y.js";
+import {
+  encodeTileflowLandmarkRegion,
+  packageTileflowLandmarkTile,
+  prepareTileflowBuildingModel
+} from "./chunk-F4PLTZS4.js";
 import "./chunk-7C4F6GAX.js";
 import "./chunk-KDFTE4Q5.js";
 import {
   defaultTileflowConfigPath
-} from "./chunk-6MGFMKG3.js";
+} from "./chunk-AQUGMUZW.js";
 import "./chunk-D4OE4ITL.js";
 import "./chunk-ONYQNLNA.js";
 export {
@@ -59,6 +67,7 @@ export {
   createTileflowStyles,
   defaultTileflowConfigPath,
   disposeTileflowBuildArtifacts,
+  encodeTileflowLandmarkRegion,
   getTileflowArtifactFiles,
   getTileflowAssetBasePath,
   getTileflowAssetFileName,
@@ -66,7 +75,9 @@ export {
   isTileflowArtifactInputPath,
   joinTileflowPublicUrl,
   normalizeTileflowBasePath,
+  packageTileflowLandmarkTile,
   parseTileflowLineBackgroundGlyphPath,
+  prepareTileflowBuildingModel,
   prepareTileflowHostedNativeDeployment,
   prepareTileflowLocalTilesets,
   refreshTileflowArtifactSession,
@@ -74,6 +85,10 @@ export {
   tileflowArtifactInventoryFileName,
   tileflowArtifactPlanSchemaVersion,
   tileflowArtifactSessionSchemaVersion,
+  tileflowLandmarkRegionOf,
+  tileflowLandmarkRegionZoom,
+  tileflowLandmarkTileOf,
+  tileflowLandmarkTileZoom,
   tileflowLineBackgroundGlyphRoute,
   usesTileflowLineBackgroundGlyphs,
   writeTileflowArtifactPlan,

package/dist/{chunk-6MGFMKG3.js → chunk-AQUGMUZW.js}

@@ -11,6 +11,7 @@ import {
   parseResolvedTileflowMap,
   parseTileflowMap,
   tileflowCaptureSceneNameSchema,
+  tileflowCaptureShotNameSchema,
   TileflowResolvedMapValidationError
 } from "@tileflow/core";
 import { collectTileflowMapBuildLineage } from "@tileflow/core/build";
@@ -85,6 +86,15 @@ function assertValidTileflowConfig(project) {
       });
     }
   }
+  for (const [shotId, shot] of Object.entries(project.shots ?? {})) {
+    if (!Object.hasOwn(project.maps, shot.map)) {
+      messages.push({
+        level: "error",
+        path: `shots.${shotId}.map`,
+        message: `Unknown Tileflow map "${shot.map}".`
+      });
+    }
+  }
   if (messages.length > 0) throw new TileflowValidationError(messages);
 }
 function asTileflowBuildCatalog(input, options = {}) {
@@ -117,7 +127,8 @@ function asTileflowBuildCatalog(input, options = {}) {
         key,
         resolved2,
         collectTileflowMapBuildLineage(map2),
-        normalizeSingularMapScenes(map2, resolved2.id)
+        normalizeSingularMapScenes(map2, resolved2.id),
+        normalizeSingularMapShots(map2, resolved2.id)
       ];
     });
     if (entries.length === 0) {
@@ -138,12 +149,25 @@ function asTileflowBuildCatalog(input, options = {}) {
         scenes2.set(sceneId, scene);
       }
     }
+    const shots2 = /* @__PURE__ */ new Map();
+    for (const [mapId, , , , mapShots] of entries) {
+      for (const [shotId, shot] of Object.entries(mapShots ?? {})) {
+        if (shots2.has(shotId)) {
+          throw tileflowConfigValidationError(
+            `maps.${mapId}.shots.${shotId}`,
+            new Error(`Tileflow workspace shot "${shotId}" is already defined by another map.`)
+          );
+        }
+        shots2.set(shotId, shot);
+      }
+    }
     return {
       mapMetadata: Object.fromEntries(
         entries.map(([id, map2, lineage]) => [id, { id, lineage, version: map2.version }])
       ),
       maps: Object.fromEntries(entries.map(([id, map2]) => [id, map2])),
-      ...scenes2.size > 0 ? { scenes: Object.fromEntries(scenes2) } : {}
+      ...scenes2.size > 0 ? { scenes: Object.fromEntries(scenes2) } : {},
+      ...shots2.size > 0 ? { shots: Object.fromEntries(shots2) } : {}
     };
   }
   const map = input;
@@ -154,6 +178,12 @@ function asTileflowBuildCatalog(input, options = {}) {
   } catch (error) {
     throw tileflowConfigValidationError("scenes", error);
   }
+  let shots;
+  try {
+    shots = normalizeSingularMapShots(map, resolved.id);
+  } catch (error) {
+    throw tileflowConfigValidationError("shots", error);
+  }
   return {
     mapMetadata: {
       [resolved.id]: {
@@ -163,7 +193,8 @@ function asTileflowBuildCatalog(input, options = {}) {
       }
     },
     maps: { [resolved.id]: resolved },
-    ...scenes ? { scenes } : {}
+    ...scenes ? { scenes } : {},
+    ...shots ? { shots } : {}
   };
 }
 function parseTileflowCatalogMap(map, path) {
@@ -215,6 +246,15 @@ function normalizeSingularMapScenes(map, mapId) {
     })
   );
 }
+function normalizeSingularMapShots(map, mapId) {
+  if (!map.shots) return void 0;
+  return Object.fromEntries(
+    Object.entries(map.shots).map(([shotId, shot]) => {
+      const normalizedShotId = tileflowCaptureShotNameSchema.parse(shotId);
+      return [normalizedShotId, { ...shot, map: mapId }];
+    })
+  );
+}
 function getTileflowMapNames(project) {
   return Object.keys(project.maps);
 }

package/dist/{chunk-L56FLV4R.js → chunk-CM6ZTYDJ.js}

@@ -8,7 +8,7 @@ import {
 import {
   getTileflowIconWatchPaths,
   prepareTileflowCatalogIcons
-} from "./chunk-A2VTI43Y.js";
+} from "./chunk-F4PLTZS4.js";
 import {
   TileflowStyleValidationError,
   normalizeTileflowStyleValidationIssues,
@@ -19,7 +19,7 @@ import {
   defaultTileflowConfigPath,
   getTileflowMapNames,
   loadValidTileflowConfigWithInputs
-} from "./chunk-6MGFMKG3.js";
+} from "./chunk-AQUGMUZW.js";
 import {
   isPathWithin
 } from "./chunk-D4OE4ITL.js";
@@ -666,7 +666,7 @@ function rebindNativeLayerReferences(input, lowered, changes) {
     if (originalMetadata?.["tileflow:interaction-manifest"] !== void 0) {
       if (!metadata) throw new Error();
       const manifest = object(originalMetadata["tileflow:interaction-manifest"]);
-      if (manifest.version !== 2) throw new Error();
+      if (manifest.version !== 3) throw new Error();
       const domains = object(manifest.domains);
       let rebound = manifest;
       if (domains.poi !== void 0) {
@@ -2124,6 +2124,12 @@ async function prepareTileflowHostedNativeDeployment(input) {
 }
 
 // src/artifacts.ts
+import {
+  tileflowLandmarkRegionOf,
+  tileflowLandmarkRegionZoom,
+  tileflowLandmarkTileOf,
+  tileflowLandmarkTileZoom
+} from "@tileflow/core";
 var tileflowArtifactPlanSchemaVersion = 1;
 var tileflowArtifactInventoryFileName = ".tileflow-artifacts.json";
 var TileflowHostedManifestOverwriteError = class extends Error {
@@ -2274,7 +2280,8 @@ async function createTileflowArtifactPlan(prepared, options = {}) {
               sourceAssets: {
                 fonts: preparedFonts.sourceIdentities[mapName] ?? [],
                 icons: prepared.mapIconSources[mapName] ?? [],
-                ...prepared.mapIconCompositions[mapName] ? { iconComposition: prepared.mapIconCompositions[mapName] } : {}
+                ...prepared.mapIconCompositions[mapName] ? { iconComposition: prepared.mapIconCompositions[mapName] } : {},
+                ...prepared.mapModelSources?.[mapName]?.length ? { models: prepared.mapModelSources[mapName] } : {}
               },
               styles: style
             }
@@ -2300,6 +2307,7 @@ async function createTileflowArtifactPlan(prepared, options = {}) {
       )
     };
     const partial = {
+      mapAssets: prepared.mapAssets,
       assets,
       buildManifest,
       ...renderer === "native" ? {
@@ -2454,7 +2462,12 @@ function createGenerationArtifactFiles(artifacts, generation, nativeUrls) {
       } : style;
       const replaceFontSources = artifacts.nativeBuild ? replaceTileflowNativeFontSources : replaceTileflowStyleFontSources;
       const generationStyle = replaceFontSources(
-        generationStyleWithSprite,
+        withGenerationBuildingModels(
+          generationStyleWithSprite,
+          mapName,
+          generation,
+          artifacts.assets
+        ),
         (source) => retargetLocalFontAssetUrl(source, artifacts.assets, generation)
       );
       if (artifacts.nativeBuild)
@@ -2588,6 +2601,27 @@ async function findNearestLockfile(cwd) {
     directory = parent;
   }
 }
+function withGenerationBuildingModels(style, mapName, generation, assets) {
+  const metadata = style.metadata;
+  const buildings = metadata?.["tileflow:buildings"];
+  if (!buildings || !Array.isArray(buildings.models)) return style;
+  const models = buildings.models.map((entry) => {
+    const url = entry.url;
+    if (typeof url !== "string" || isRelativePublicUrl(url)) return entry;
+    const file = url.slice(url.lastIndexOf("/") + 1);
+    const logical = `models/${mapName}/${file}`;
+    if (!url.endsWith(`/${logical}`) || !assets.some((asset) => asset.fileName === logical))
+      return entry;
+    return {
+      ...entry,
+      url: insertGenerationInPublicUrl(url, logical, generation)
+    };
+  });
+  return {
+    ...style,
+    metadata: { ...metadata, "tileflow:buildings": { ...buildings, models } }
+  };
+}
 function insertGenerationInPublicUrl(url, logicalPath, generation) {
   const marker = `/${logicalPath}`;
   const index = url.lastIndexOf(marker);
@@ -2938,7 +2972,10 @@ function assertTileflowArtifactFileName(fileName) {
   const logicalName = fileName.replace(/^generations\/[a-f0-9]{64}\//, "");
   const styleMatch = /^styles\/([^/]+)\/([^/]+)\.json$/u.exec(logicalName);
   const iconMatch = /^icons\/([^/]+)\/sprite(?:@2x)?\.(?:json|png)$/u.exec(logicalName);
-  if (fileName === "manifest.json" || fileName === tileflowMapBuildManifestFileName || fileName === tileflowNativeBuildRecordFileName || styleMatch && tileflowMapIdSchema.safeParse(styleMatch[1]).success && tileflowThemeNameSchema.safeParse(styleMatch[2]).success || iconMatch && tileflowMapIdSchema.safeParse(iconMatch[1]).success || /^tilesets\/[A-Za-z0-9][A-Za-z0-9._-]{0,127}\.pmtiles$/u.test(logicalName) || /^fonts\/[a-z0-9]+(?:-[a-z0-9]+)*-[a-f0-9]{64}\.(?:otf|ttf|woff2)$/.test(logicalName) || /^fonts\/licenses\/license-[a-f0-9]{64}\.txt$/.test(logicalName)) {
+  const modelMatch = /^models\/([^/]+)\/[a-z0-9]+(?:-[a-z0-9]+)*-[a-f0-9]{16}\.glb$/u.exec(
+    logicalName
+  );
+  if (fileName === "manifest.json" || fileName === tileflowMapBuildManifestFileName || fileName === tileflowNativeBuildRecordFileName || styleMatch && tileflowMapIdSchema.safeParse(styleMatch[1]).success && tileflowThemeNameSchema.safeParse(styleMatch[2]).success || iconMatch && tileflowMapIdSchema.safeParse(iconMatch[1]).success || modelMatch && tileflowMapIdSchema.safeParse(modelMatch[1]).success || /^tilesets\/[A-Za-z0-9][A-Za-z0-9._-]{0,127}\.pmtiles$/u.test(logicalName) || /^fonts\/[a-z0-9]+(?:-[a-z0-9]+)*-[a-f0-9]{64}\.(?:otf|ttf|woff2)$/.test(logicalName) || /^fonts\/licenses\/license-[a-f0-9]{64}\.txt$/.test(logicalName)) {
     return;
   }
   throw new Error(`Unexpected Tileflow managed artifact file name: ${fileName}`);
@@ -3057,5 +3094,9 @@ export {
   disposeTileflowBuildArtifacts,
   writeTileflowArtifactPlan,
   assertNoLocalTilesetsForProduction,
-  assertTileflowSelfHostedManifestTarget
+  assertTileflowSelfHostedManifestTarget,
+  tileflowLandmarkRegionOf,
+  tileflowLandmarkRegionZoom,
+  tileflowLandmarkTileOf,
+  tileflowLandmarkTileZoom
 };