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

package/dist/fonts.d.ts

@@ -1,6 +1,6 @@
 import { TileflowFontBundleManifest, MapLibreStyle } from '@tileflow/core';
 import { TileflowEffectiveFontSourceIdentity, TileflowBuildStyles, TileflowBuildCatalog } from '@tileflow/core/build';
-import { T as TileflowBuildAsset } from './icons-B84H8Ymu.js';
+import { T as TileflowBuildAsset } from './icons-BIHpw5Zy.js';
 
 type TileflowFontCompilationTarget = 'hosted' | 'local';
 type TileflowFontCompilationIssue = {

package/dist/{icons-B84H8Ymu.d.ts → icons-BIHpw5Zy.d.ts}

@@ -1,4 +1,4 @@
-import { TileflowIconAppearance, TileflowIconLayoutMetadata, TileflowIconSetPin, TileflowLandmarkRegion, TileflowModelDirectory, TileflowTreeModel, TileflowIconSpriteIndex, TileflowIconSource, TileflowIconsLockfileV1, TileflowIconCompositionV1, TileflowIconPackageFileName, TileflowIconPackageManifest, TileflowIconDirectory } from '@tileflow/core';
+import { TileflowIconAppearance, TileflowIconLayoutMetadata, TileflowIconSetPin, TileflowLandmarkRegion, TileflowLandmarkFootprint, TileflowModelDirectory, TileflowTreeModel, TileflowIconSpriteIndex, TileflowIconSource, TileflowIconsLockfileV1, TileflowIconCompositionV1, TileflowIconPackageFileName, TileflowIconPackageManifest, TileflowIconDirectory } from '@tileflow/core';
 import { TileflowEffectiveModelSourceIdentity, TileflowEffectiveIconSourceIdentity, TileflowBuildCatalog, TileflowPreparedMapAssets } from '@tileflow/core/build';
 
 type TileflowRenderedIconCell = {
@@ -43,6 +43,13 @@ type PreparedTileflowBuildingModel = {
     /** Its file name, content-addressed: `<id>-<first 16 hex of its SHA-256>.glb`. */
     fileName: string;
     bytes: Uint8Array;
+    sha256: string;
+    /** The glTF binaries it was prepared from, nearest level first. */
+    sources: readonly Readonly<{
+        level: 'near' | 'mid' | 'far';
+        sha256: string;
+        byteLength: number;
+    }>[];
 };
 /** A building model's glTF binaries, nearest level first. */
 type TileflowBuildingModelLevels = Readonly<{
@@ -72,17 +79,21 @@ type TileflowLandmarkSource = Readonly<{
 /**
  * Packages the landmarks standing in one tile of a landmarks tileset into that tile's prepared
  * model file, the landmarks in the order of their ids. Every landmark's origin must fall in the
- * same zoom-14 tile. The result depends only on its input.
+ * same zoom-14 tile. It also returns each landmark's place and footprint, as the region's index
+ * names them. The result depends only on its input.
  */
 declare function packageTileflowLandmarkTile(landmarks: readonly TileflowLandmarkSource[]): Promise<{
     x: number;
     y: number;
     bytes: Uint8Array;
     sha256: string;
+    landmarks: readonly TileflowLandmarkFootprint[];
 }>;
 /**
- * Writes the index of one region of a landmarks tileset, `{region: [x, y], tiles: [[x, y,
- * sha256], ...]}`, as the bytes the tileset serves, with their SHA-256.
+ * Writes the index of one region of a landmarks tileset, `{region: [x, y], tiles: [[x, y, sha256,
+ * landmarks], ...]}`, as the bytes the tileset serves, with their SHA-256. A tile's `landmarks` are
+ * the ones `packageTileflowLandmarkTile` returned for it, or `readTileflowLandmarkTileFootprints`
+ * reads back from its bytes.
  */
 declare function encodeTileflowLandmarkRegion(region: TileflowLandmarkRegion): {
     bytes: Uint8Array;
@@ -403,4 +414,4 @@ declare function readTileflowIconDirectory(source: TileflowIconDirectory, option
     target: TileflowIconCompilationTarget;
 }): Promise<ReadTileflowIconDirectoryResult>;
 
-export { renderTileflowIconAtlasPreview as $, type TileflowIconCompilationIssue as A, type TileflowIconCompilationTarget as B, type CompileTileflowIconPackagesOptions as C, type TileflowIconDirectoryEntry as D, type TileflowIconDirectorySourceFile as E, type TileflowIconReplacement as F, type TileflowMapIconPackageBinding as G, type TileflowRenderedIcon as H, type InspectTileflowIconCatalogsOptions as I, type TileflowRenderedIconCell as J, compileTileflowIconPackages as K, composeTileflowIconSources as L, getTileflowIconCacheDirectory as M, getTileflowIconWatchPaths as N, iconFileExtensions as O, type PreparedTileflowBuildCatalog as P, inspectTileflowIconCatalogs as Q, type ReadTileflowIconDirectoryResult as R, loadTileflowIconSetArtifact as S, type TileflowBuildAsset as T, packTileflowRenderedIcons as U, type VerifiedTileflowIconArtifact as V, prepareTileflowCatalogIcons as W, prepareTileflowMapTreeModels as X, readTileflowIconDirectory as Y, readTileflowIconsLockfile as Z, readTileflowIconsLockfileText as _, type TileflowIconResolutionOptions as a, storeTileflowIconSetArtifact as a0, verifyTileflowIconArtifact as a1, writeTileflowIconsLockfile as a2, type TileflowSourceCatalog as b, type PreparedTileflowCatalog as c, type TileflowBuildingModelLevels as d, type TileflowLandmarkSource as e, encodeTileflowLandmarkRegion as f, prepareTileflowBuildingModel as g, type CompileTileflowIconPackagesResult as h, type CompiledTileflowIconPackage as i, type CompiledTileflowIconPackageFile as j, type ComposeTileflowIconSourcesOptions as k, type TileflowComposedIconContributor as l, type TileflowComposedIconSources as m, type TileflowComposedIconWinner as n, type TileflowIconCacheOptions as o, packageTileflowLandmarkTile as p, type TileflowIconCatalog as q, type TileflowIconCatalogAtlasRectangle as r, type TileflowIconCatalogContributor as s, type TileflowIconCatalogIcon as t, type TileflowIconCatalogIconSource as u, type TileflowIconCatalogInspection as v, type TileflowIconCatalogMap as w, type TileflowIconCatalogRenderedDensity as x, type TileflowIconCatalogSourceFormat as y, TileflowIconCompilationError as z };
+export { readTileflowIconsLockfileText as $, TileflowIconCompilationError as A, type TileflowIconCompilationIssue as B, type CompileTileflowIconPackagesOptions as C, type TileflowIconCompilationTarget as D, type TileflowIconDirectoryEntry as E, type TileflowIconDirectorySourceFile as F, type TileflowIconReplacement as G, type TileflowMapIconPackageBinding as H, type InspectTileflowIconCatalogsOptions as I, type TileflowRenderedIcon as J, type TileflowRenderedIconCell as K, compileTileflowIconPackages as L, composeTileflowIconSources as M, getTileflowIconCacheDirectory as N, getTileflowIconWatchPaths as O, type PreparedTileflowBuildCatalog as P, iconFileExtensions as Q, type ReadTileflowIconDirectoryResult as R, inspectTileflowIconCatalogs as S, type TileflowBuildAsset as T, loadTileflowIconSetArtifact as U, type VerifiedTileflowIconArtifact as V, packTileflowRenderedIcons as W, prepareTileflowCatalogIcons as X, prepareTileflowMapTreeModels as Y, readTileflowIconDirectory as Z, readTileflowIconsLockfile as _, type TileflowIconResolutionOptions as a, renderTileflowIconAtlasPreview as a0, storeTileflowIconSetArtifact as a1, verifyTileflowIconArtifact as a2, writeTileflowIconsLockfile as a3, type TileflowSourceCatalog as b, type PreparedTileflowCatalog as c, type TileflowBuildingModelLevels as d, type TileflowLandmarkSource as e, encodeTileflowLandmarkRegion as f, prepareTileflowBuildingModel as g, type CompileTileflowIconPackagesResult as h, type CompiledTileflowIconPackage as i, type CompiledTileflowIconPackageFile as j, type ComposeTileflowIconSourcesOptions as k, type PreparedTileflowBuildingModel as l, type TileflowComposedIconContributor as m, type TileflowComposedIconSources as n, type TileflowComposedIconWinner as o, packageTileflowLandmarkTile as p, type TileflowIconCacheOptions as q, type TileflowIconCatalog as r, type TileflowIconCatalogAtlasRectangle as s, type TileflowIconCatalogContributor as t, type TileflowIconCatalogIcon as u, type TileflowIconCatalogIconSource as v, type TileflowIconCatalogInspection as w, type TileflowIconCatalogMap as x, type TileflowIconCatalogRenderedDensity as y, type TileflowIconCatalogSourceFormat as z };

package/dist/icons.d.ts

@@ -1,3 +1,3 @@
 import '@tileflow/core';
 import '@tileflow/core/build';
-export { C as CompileTileflowIconPackagesOptions, h as CompileTileflowIconPackagesResult, i as CompiledTileflowIconPackage, j as CompiledTileflowIconPackageFile, k as ComposeTileflowIconSourcesOptions, I as InspectTileflowIconCatalogsOptions, P as PreparedTileflowBuildCatalog, c as PreparedTileflowCatalog, R as ReadTileflowIconDirectoryResult, T as TileflowBuildAsset, l as TileflowComposedIconContributor, m as TileflowComposedIconSources, n as TileflowComposedIconWinner, o as TileflowIconCacheOptions, q as TileflowIconCatalog, r as TileflowIconCatalogAtlasRectangle, s as TileflowIconCatalogContributor, t as TileflowIconCatalogIcon, u as TileflowIconCatalogIconSource, v as TileflowIconCatalogInspection, w as TileflowIconCatalogMap, x as TileflowIconCatalogRenderedDensity, y as TileflowIconCatalogSourceFormat, z as TileflowIconCompilationError, A as TileflowIconCompilationIssue, B as TileflowIconCompilationTarget, D as TileflowIconDirectoryEntry, E as TileflowIconDirectorySourceFile, F as TileflowIconReplacement, a as TileflowIconResolutionOptions, G as TileflowMapIconPackageBinding, H as TileflowRenderedIcon, J as TileflowRenderedIconCell, b as TileflowSourceCatalog, V as VerifiedTileflowIconArtifact, K as compileTileflowIconPackages, L as composeTileflowIconSources, M as getTileflowIconCacheDirectory, N as getTileflowIconWatchPaths, O as iconFileExtensions, Q as inspectTileflowIconCatalogs, S as loadTileflowIconSetArtifact, U as packTileflowRenderedIcons, W as prepareTileflowCatalogIcons, X as prepareTileflowMapTreeModels, Y as readTileflowIconDirectory, Z as readTileflowIconsLockfile, _ as readTileflowIconsLockfileText, $ as renderTileflowIconAtlasPreview, a0 as storeTileflowIconSetArtifact, a1 as verifyTileflowIconArtifact, a2 as writeTileflowIconsLockfile } from './icons-B84H8Ymu.js';
+export { C as CompileTileflowIconPackagesOptions, h as CompileTileflowIconPackagesResult, i as CompiledTileflowIconPackage, j as CompiledTileflowIconPackageFile, k as ComposeTileflowIconSourcesOptions, I as InspectTileflowIconCatalogsOptions, P as PreparedTileflowBuildCatalog, l as PreparedTileflowBuildingModel, c as PreparedTileflowCatalog, R as ReadTileflowIconDirectoryResult, T as TileflowBuildAsset, m as TileflowComposedIconContributor, n as TileflowComposedIconSources, o as TileflowComposedIconWinner, q as TileflowIconCacheOptions, r as TileflowIconCatalog, s as TileflowIconCatalogAtlasRectangle, t as TileflowIconCatalogContributor, u as TileflowIconCatalogIcon, v as TileflowIconCatalogIconSource, w as TileflowIconCatalogInspection, x as TileflowIconCatalogMap, y as TileflowIconCatalogRenderedDensity, z as TileflowIconCatalogSourceFormat, A as TileflowIconCompilationError, B as TileflowIconCompilationIssue, D as TileflowIconCompilationTarget, E as TileflowIconDirectoryEntry, F as TileflowIconDirectorySourceFile, G as TileflowIconReplacement, a as TileflowIconResolutionOptions, H as TileflowMapIconPackageBinding, J as TileflowRenderedIcon, K as TileflowRenderedIconCell, b as TileflowSourceCatalog, V as VerifiedTileflowIconArtifact, L as compileTileflowIconPackages, M as composeTileflowIconSources, N as getTileflowIconCacheDirectory, O as getTileflowIconWatchPaths, Q as iconFileExtensions, S as inspectTileflowIconCatalogs, U as loadTileflowIconSetArtifact, W as packTileflowRenderedIcons, X as prepareTileflowCatalogIcons, Y as prepareTileflowMapTreeModels, Z as readTileflowIconDirectory, _ as readTileflowIconsLockfile, $ as readTileflowIconsLockfileText, a0 as renderTileflowIconAtlasPreview, a1 as storeTileflowIconSetArtifact, a2 as verifyTileflowIconArtifact, a3 as writeTileflowIconsLockfile } from './icons-BIHpw5Zy.js';

package/dist/icons.js

@@ -17,7 +17,7 @@ import {
   storeTileflowIconSetArtifact,
   verifyTileflowIconArtifact,
   writeTileflowIconsLockfile
-} from "./chunk-F4PLTZS4.js";
+} from "./chunk-5RT4CHSK.js";
 import "./chunk-7C4F6GAX.js";
 export {
   TileflowIconCompilationError,

package/dist/preview.js

@@ -196,6 +196,40 @@ var previewSceneClient = String.raw`
         };
 `;
 
+// src/preview-scene-themes.ts
+function createPreviewSceneThemes(map, readSun) {
+  const cache = {
+    value: void 0,
+    snapshot() {
+      if (!cache.value) {
+        const metadata = map.getStyle()?.metadata;
+        cache.value = { metadata, sun: readSun(metadata) };
+      }
+      return cache.value;
+    },
+    invalidate() {
+      cache.value = void 0;
+    },
+    release() {
+      map.off("styledata", cache.invalidate);
+      map.off("style.load", cache.invalidate);
+      map.off("remove", cache.release);
+      cache.invalidate();
+    }
+  };
+  map.on("styledata", cache.invalidate);
+  map.on("style.load", cache.invalidate);
+  map.on("remove", cache.release);
+  return {
+    getSun() {
+      return cache.snapshot().sun;
+    },
+    getThemeMetadata(key) {
+      return { values: [cache.snapshot().metadata?.[key]], position: 0 };
+    }
+  };
+}
+
 // src/preview-html.ts
 function renderTileflowPreviewHtml(preview, basePath, initialStatus, isSemanticPreview, fontFaces = [], fitViewport = false, controls) {
   const styleUrl = preview ? `${basePath}/styles/${preview.mapName}/${preview.themeName}.json${controls ? `?${new URLSearchParams({ controls })}` : ""}` : void 0;
@@ -314,6 +348,7 @@ function renderTileflowPreviewHtml(preview, basePath, initialStatus, isSemanticP
       import {loadTileflowStyleFonts} from "${basePath}/__runtime/tileflow-browser.js";
       import {registerTileflowContourProtocol} from "${basePath}/__runtime/tileflow-browser.js";
       import {registerTileflowPmtilesProtocol} from "${basePath}/__runtime/tileflow-browser.js";
+      import {attachTileflowNotices} from "${basePath}/__runtime/tileflow-browser.js";
       import {createTileflowBuildings3D, createTileflowStreetLights, createTileflowVegetation} from "${basePath}/__runtime/tileflow-browser.js";
       import {readTileflowSunPreset, resolveTileflowSun, tileflowDefaultSunPreset} from "${basePath}/__runtime/tileflow-browser.js";
 
@@ -372,7 +407,7 @@ function renderTileflowPreviewHtml(preview, basePath, initialStatus, isSemanticP
         if (values[0] === "off") return false;
         return fallback;
       }
-      let threeDimensionalEnabled = readToggleFromUrl("buildings3d", false);
+      let threeDimensionalEnabled = readToggleFromUrl("buildings3d", true);
       let treesEnabled = readToggleFromUrl("trees3d", true);
       const landmarkState = {
         active: [],
@@ -1985,7 +2020,7 @@ function renderTileflowPreviewHtml(preview, basePath, initialStatus, isSemanticP
       // buildings, trees and street lights look, and the controls only show and hide them. The
       // vegetation control hides all trees when off. The preview shows one theme at a
       // time, so the style on screen holds the sun and the design.
-      const coreScene = {buildings: undefined, trees: undefined, lights: undefined, buildingsShown: false, animation: "0"};
+      const coreScene = {buildings: undefined, trees: undefined, lights: undefined, buildingsShown: undefined, animation: "0"};
       const runtimeLayerVisibility = {};
       globalThis.__tileflowPreviewScene = coreScene;
       globalThis.__tileflowRuntimeVisibility = (id, visible) => {
@@ -2001,16 +2036,16 @@ function renderTileflowPreviewHtml(preview, basePath, initialStatus, isSemanticP
         ...(coreScene.trees ? {"tileflow-trees-3d": {controller:"Vegetation", state:{visible:runtimeLayerVisibility["tileflow-trees-3d"] !== false, representation:coreScene.trees.representation}, stats:coreScene.trees.stats}} : {}),
         ...(coreScene.lights ? {"tileflow-street-lights": {controller:"Street lights", state:{visible:runtimeLayerVisibility["tileflow-street-lights"] !== false, mounted:true}, stats:coreScene.lights.stats}} : {})
       });
+      const createPreviewSceneThemes = ${createPreviewSceneThemes.toString()};
+      const coreSceneThemeControllers = new WeakMap();
       function coreSceneThemes(map) {
-        return {
-          getSun() {
-            const preset = readTileflowSunPreset(map.getStyle()?.metadata);
-            return resolveTileflowSun(preset ?? tileflowDefaultSunPreset);
-          },
-          getThemeMetadata(key) {
-            return {values: [map.getStyle()?.metadata?.[key]], position: 0};
-          }
-        };
+        let controller = coreSceneThemeControllers.get(map);
+        if (!controller) {
+          controller = createPreviewSceneThemes(map, metadata =>
+            resolveTileflowSun(readTileflowSunPreset(metadata) ?? tileflowDefaultSunPreset));
+          coreSceneThemeControllers.set(map, controller);
+        }
+        return controller;
       }
       let mountingCoreScene = false;
       function mountCoreScene(map) {
@@ -2031,10 +2066,10 @@ function renderTileflowPreviewHtml(preview, basePath, initialStatus, isSemanticP
           }
           coreScene.trees.setVisible(treesEnabled && runtimeLayerVisibility["tileflow-trees-3d"] !== false);
           coreScene.trees.setViewMode(threeDimensionalEnabled ? "3d" : "2d");
-          // Street lights have no capture fallback, so they shine only with the 3D control on.
+          // Street lights require an explicit map opt-in and the 3D control; defaults stay off.
           if (!coreScene.lights && threeDimensionalEnabled && metadata["tileflow:street-lights"]) {
             coreScene.lights = createTileflowStreetLights({map, controller});
-          } else if (coreScene.lights && !threeDimensionalEnabled) {
+          } else if (coreScene.lights && (!threeDimensionalEnabled || !metadata["tileflow:street-lights"])) {
             coreScene.lights.dispose();
             coreScene.lights = undefined;
           }
@@ -2349,6 +2384,7 @@ function renderTileflowPreviewHtml(preview, basePath, initialStatus, isSemanticP
           ...resolveInitialMapOptions(previewMapOptions)
         });
         globalThis.__tileflowPreviewMap = map;
+        attachTileflowNotices(map);
         devtoolsObserver?.attach(map);
         installMapBenchmark(map);
         if (window.parent === window) map.addControl(new maplibregl.NavigationControl(), "top-right");

package/dist/server.d.ts

@@ -5,7 +5,7 @@ import '@tileflow/core';
 import '@tileflow/core/build';
 import '@tileflow/core/manifest';
 import '@tileflow/core/native-profile';
-import './icons-B84H8Ymu.js';
+import './icons-BIHpw5Zy.js';
 import './config.js';
 
 declare const tileflowComparisonSchemaVersion: 1;