@tileflow/dev 0.1.0-alpha.31 → 0.1.0-alpha.33

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.
+Debug'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,59 @@ 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 **Diagnostics**.
+Zoom, Pitch and Bearing appear as **Z**, **P** and **B** directly below it, with live Zoom and Pitch
+sliders and **Copy for AI**. Pitch and Bearing each have an inline reset to 0° within the map's
+camera limits. Camera resets preserve the current zoom and map position.
+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**.
+Side docking has a minimum width of 640 CSS pixels, including restored layouts.
+
+**Map** exposes time-of-day segments, theme cards with actual style swatches, 3D view,
+Off/Grow/Fade building animation, and the map's module settings. The command selects the map.
+Streets shows **Default**, **Faded** and **Monochrome**; Default keeps the compatible `light`
+theme ID in configs, URLs and capture commands. Time of day is selected independently.
+3D view defaults to on for every map. Buildings fade in between zoom 15 and 15.25.
+Toggling 3D view preserves the camera, including pitch; an explicit off setting stays off.
+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 themes 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. **Diagnostics** lists actionable findings under Readability, Style,
+Assets and Performance. Problems identify confirmed failures; Review findings describe situations
+that can be intentional. There are no quality scores or automatic camera tours. Style checks refresh
+when the map changes; **Check view** collects bounded current-view evidence and briefly samples
+drawing work. Findings open the affected layer and rule, show available evidence, and copy context
+for an agent. Unavailable observations and stale results remain explicit. **Diagnosis** in
+Layers describes the selected layer's zoom, visibility and feature-rule context without turning
+empty viewport queries into errors. Legacy `tab=beacon` links open Diagnostics.
+See [Map design diagnostics](https://github.com/tileflow/tileflow-sdk/blob/main/packages/dev/docs/map-design-diagnostics.md)
+for detectors, sampling and interpretation 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 +260,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-BdOehQmB.js';
+export { d as TileflowBuildingModelLevels, e as TileflowLandmarkSource, f as encodeTileflowLandmarkRegion, p as packageTileflowLandmarkTile, g as prepareTileflowBuildingModel } from './icons-BdOehQmB.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-2QXKVQ6O.js";
+} from "./chunk-WJOF6USY.js";
 import {
   getTileflowAssetBasePath,
   getTileflowAssetFileName,
@@ -35,7 +39,11 @@ import {
   normalizeTileflowBasePath,
   resolveTileflowArtifactPublicUrls
 } from "./chunk-UTRO4IBQ.js";
-import "./chunk-IR22ZTQW.js";
+import {
+  encodeTileflowLandmarkRegion,
+  packageTileflowLandmarkTile,
+  prepareTileflowBuildingModel
+} from "./chunk-QYU4OW5A.js";
 import "./chunk-7C4F6GAX.js";
 import "./chunk-KDFTE4Q5.js";
 import {
@@ -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,