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

package/README.md

@@ -36,7 +36,7 @@ needs no API key, but serving a map can still cause requests to its remote data
 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.
+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.
 
@@ -139,14 +139,20 @@ contract, including experimental preview-only rendering; it does not promise hos
 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 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, palette cards with actual style swatches, 3D view,
+**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.
@@ -165,19 +171,21 @@ Inspection reads resident data without issuing tile requests. MLT and inaccessib
 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
+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. **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 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.

package/dist/artifacts.d.ts

@@ -3,8 +3,8 @@ export { tileflowLandmarkRegionOf, tileflowLandmarkRegionZoom, tileflowLandmarkT
 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 { 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';
+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';
 
 /**

package/dist/artifacts.js

@@ -31,7 +31,7 @@ import {
   usesTileflowLineBackgroundGlyphs,
   writeTileflowArtifactPlan,
   writeTileflowBuildArtifacts
-} from "./chunk-CM6ZTYDJ.js";
+} from "./chunk-WJOF6USY.js";
 import {
   getTileflowAssetBasePath,
   getTileflowAssetFileName,
@@ -43,7 +43,7 @@ import {
   encodeTileflowLandmarkRegion,
   packageTileflowLandmarkTile,
   prepareTileflowBuildingModel
-} from "./chunk-F4PLTZS4.js";
+} from "./chunk-QYU4OW5A.js";
 import "./chunk-7C4F6GAX.js";
 import "./chunk-KDFTE4Q5.js";
 import {

package/dist/{chunk-F4PLTZS4.js → chunk-QYU4OW5A.js}

@@ -25,7 +25,7 @@ import {
   sha256Hex as sha256Hex3,
   tileflowIconIdPattern,
   tileflowIconPackageLimits as tileflowIconPackageLimits4,
-  tileflowModelContentType
+  tileflowModelContentType as tileflowModelContentType2
 } from "@tileflow/core";
 
 // src/icon-composition.ts
@@ -949,8 +949,12 @@ import {
   compareCodeUnits as compareCodeUnits4,
   encodeTileflowModels,
   encodeTileflowTreeModel,
+  hashTileflowModelBundleManifest,
   serializeTileflowLandmarkRegion,
   tileflowLandmarkTileOf,
+  tileflowModelBundleFileName,
+  tileflowModelBundleLimits,
+  tileflowModelContentType,
   tileflowTreeModelLimits as tileflowTreeModelLimits2
 } from "@tileflow/core";
 
@@ -1746,6 +1750,34 @@ function buildingModelEntry(id, levels) {
     )
   };
 }
+async function createTileflowModelBundle(buildings) {
+  const entries = Object.entries(buildings).sort(([a], [b]) => compareCodeUnits4(a, b));
+  if (entries.length === 0) return void 0;
+  const totalBytes = entries.reduce((total, [, model]) => total + model.bytes.byteLength, 0);
+  if (totalBytes > tileflowModelBundleLimits.maxPackageBytes)
+    throw new RangeError(
+      `The map's building models together are ${totalBytes} bytes once prepared; a hosted map takes at most ${tileflowModelBundleLimits.maxPackageBytes}. Simplify or remove models.`
+    );
+  const manifest = {
+    format: "tileflow-model-bundle-v1",
+    models: entries.map(([id, model]) => ({
+      byteLength: model.bytes.byteLength,
+      contentType: tileflowModelContentType,
+      file: model.fileName,
+      id,
+      sha256: model.sha256
+    }))
+  };
+  return {
+    contentHash: await hashTileflowModelBundleManifest(manifest),
+    manifest,
+    files: entries.map(([, model]) => ({
+      contentType: tileflowModelContentType,
+      fileName: model.fileName,
+      source: model.bytes
+    }))
+  };
+}
 function sha256Of(bytes) {
   return createHash("sha256").update(bytes).digest("hex");
 }
@@ -1840,8 +1872,9 @@ async function prepareTileflowMapTreeModels(directories, options) {
         failing = entry.near;
         const prepared2 = await prepareTileflowBuildingModel(id, files2);
         buildings[id] = {
-          fileName: `${id}-${prepared2.sha256.slice(0, 16)}.glb`,
-          bytes: prepared2.bytes
+          fileName: tileflowModelBundleFileName(id, prepared2.sha256),
+          bytes: prepared2.bytes,
+          sha256: prepared2.sha256
         };
       } catch (error) {
         issues.push({
@@ -2182,7 +2215,7 @@ async function prepareTileflowCatalogIcons(project, options) {
     const buildingModels = {};
     for (const [id, model] of Object.entries(models.buildings)) {
       const fileName = `models/${mapName}/${model.fileName}`;
-      assets.push({ contentType: tileflowModelContentType, fileName, source: model.bytes });
+      assets.push({ contentType: tileflowModelContentType2, fileName, source: model.bytes });
       buildingModels[id] = joinUrl(options.assetBaseUrl, fileName);
     }
     mapAssets[mapName] = {
@@ -2800,6 +2833,7 @@ export {
   prepareTileflowBuildingModel,
   packageTileflowLandmarkTile,
   encodeTileflowLandmarkRegion,
+  createTileflowModelBundle,
   prepareTileflowMapTreeModels,
   renderTileflowIconAtlasPreview,
   TileflowIconCompilationError,

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

@@ -8,7 +8,7 @@ import {
 import {
   getTileflowIconWatchPaths,
   prepareTileflowCatalogIcons
-} from "./chunk-F4PLTZS4.js";
+} from "./chunk-QYU4OW5A.js";
 import {
   TileflowStyleValidationError,
   normalizeTileflowStyleValidationIssues,
@@ -2518,7 +2518,8 @@ function retargetLocalFontAssetUrl(source, assets, generation) {
 function getMapBuildAssets(mapName, assets, fontAssets) {
   const selected = /* @__PURE__ */ new Map();
   for (const asset of assets) {
-    if (asset.fileName.startsWith(`icons/${mapName}/`)) selected.set(asset.fileName, asset);
+    if (asset.fileName.startsWith(`icons/${mapName}/`) || asset.fileName.startsWith(`models/${mapName}/`))
+      selected.set(asset.fileName, asset);
   }
   for (const asset of fontAssets) {
     selected.set(asset.fileName, asset);