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

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-BdOehQmB.js';
 
 type TileflowFontCompilationTarget = 'hosted' | 'local';
 type TileflowFontCompilationIssue = {

package/dist/{icons-B84H8Ymu.d.ts → icons-BdOehQmB.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, TileflowModelBundleManifest, 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,7 @@ type PreparedTileflowBuildingModel = {
     /** Its file name, content-addressed: `<id>-<first 16 hex of its SHA-256>.glb`. */
     fileName: string;
     bytes: Uint8Array;
+    sha256: string;
 };
 /** A building model's glTF binaries, nearest level first. */
 type TileflowBuildingModelLevels = Readonly<{
@@ -88,6 +89,23 @@ declare function encodeTileflowLandmarkRegion(region: TileflowLandmarkRegion): {
     bytes: Uint8Array;
     sha256: string;
 };
+/** A map's building models as the model bundle a hosted deploy uploads before its styles. */
+type TileflowModelBundle = {
+    /** The SHA-256 of the manifest's canonical JSON. */
+    contentHash: string;
+    manifest: TileflowModelBundleManifest;
+    /** Each model's prepared file, named as the manifest names it. */
+    files: {
+        contentType: string;
+        fileName: string;
+        source: Uint8Array;
+    }[];
+};
+/**
+ * Bundles a map's prepared building models, or returns undefined when it has none. Throws a
+ * `RangeError` an author can act on when the models together are too large to host.
+ */
+declare function createTileflowModelBundle(buildings: Readonly<Record<string, PreparedTileflowBuildingModel>>): Promise<TileflowModelBundle | undefined>;
 type PreparedTileflowTreeModels = {
     /** The prepared tree models by id. */
     models: Record<string, TileflowTreeModel>;
@@ -403,4 +421,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 { readTileflowIconDirectory 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 TileflowModelBundle as J, type TileflowRenderedIcon as K, type TileflowRenderedIconCell as L, compileTileflowIconPackages as M, composeTileflowIconSources as N, createTileflowModelBundle as O, type PreparedTileflowBuildCatalog as P, getTileflowIconCacheDirectory as Q, type ReadTileflowIconDirectoryResult as R, getTileflowIconWatchPaths as S, type TileflowBuildAsset as T, iconFileExtensions as U, type VerifiedTileflowIconArtifact as V, inspectTileflowIconCatalogs as W, loadTileflowIconSetArtifact as X, packTileflowRenderedIcons as Y, prepareTileflowCatalogIcons as Z, prepareTileflowMapTreeModels as _, type TileflowIconResolutionOptions as a, readTileflowIconsLockfile as a0, readTileflowIconsLockfileText as a1, renderTileflowIconAtlasPreview as a2, storeTileflowIconSetArtifact as a3, verifyTileflowIconArtifact as a4, writeTileflowIconsLockfile as a5, 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 TileflowModelBundle, K as TileflowRenderedIcon, L as TileflowRenderedIconCell, b as TileflowSourceCatalog, V as VerifiedTileflowIconArtifact, M as compileTileflowIconPackages, N as composeTileflowIconSources, O as createTileflowModelBundle, Q as getTileflowIconCacheDirectory, S as getTileflowIconWatchPaths, U as iconFileExtensions, W as inspectTileflowIconCatalogs, X as loadTileflowIconSetArtifact, Y as packTileflowRenderedIcons, Z as prepareTileflowCatalogIcons, _ as prepareTileflowMapTreeModels, $ as readTileflowIconDirectory, a0 as readTileflowIconsLockfile, a1 as readTileflowIconsLockfileText, a2 as renderTileflowIconAtlasPreview, a3 as storeTileflowIconSetArtifact, a4 as verifyTileflowIconArtifact, a5 as writeTileflowIconsLockfile } from './icons-BdOehQmB.js';

package/dist/icons.js

@@ -2,6 +2,7 @@ import {
   TileflowIconCompilationError,
   compileTileflowIconPackages,
   composeTileflowIconSources,
+  createTileflowModelBundle,
   getTileflowIconCacheDirectory,
   getTileflowIconWatchPaths,
   iconFileExtensions,
@@ -17,12 +18,13 @@ import {
   storeTileflowIconSetArtifact,
   verifyTileflowIconArtifact,
   writeTileflowIconsLockfile
-} from "./chunk-F4PLTZS4.js";
+} from "./chunk-QYU4OW5A.js";
 import "./chunk-7C4F6GAX.js";
 export {
   TileflowIconCompilationError,
   compileTileflowIconPackages,
   composeTileflowIconSources,
+  createTileflowModelBundle,
   getTileflowIconCacheDirectory,
   getTileflowIconWatchPaths,
   iconFileExtensions,

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;
@@ -372,7 +406,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 +2019,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 +2035,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 +2065,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;
           }

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-BdOehQmB.js';
 import './config.js';
 
 declare const tileflowComparisonSchemaVersion: 1;