@tileflow/dev 0.1.0-alpha.27 → 0.1.0-alpha.29

package/dist/{chunk-UCBGTEQV.js → chunk-QYM2CUZB.js}

@@ -1,7 +1,10 @@
 import {
   createTileflowArtifactSession,
-  tileflowArtifactSessionSchemaVersion
-} from "./chunk-QAMFAM3S.js";
+  createTileflowLineBackgroundGlyphResponder,
+  parseTileflowLineBackgroundGlyphPath,
+  tileflowArtifactSessionSchemaVersion,
+  tileflowLineBackgroundGlyphRoute
+} from "./chunk-LXSFLPIU.js";
 import {
   normalizeTileflowBasePath
 } from "./chunk-UTRO4IBQ.js";
@@ -1709,6 +1712,7 @@ function createTileflowDevRequestHandler(options = {}) {
   const cwd = options.cwd ?? process.cwd();
   const apiBaseUrl = options.apiBaseUrl ?? defaultTileflowApiUrl;
   let ownedSessionPromise;
+  const lineBackgroundGlyphs = createTileflowLineBackgroundGlyphResponder({ cwd });
   let closed = false;
   let lastOrigin;
   const loadOwnedSession = (origin) => {
@@ -1783,6 +1787,12 @@ function createTileflowDevRequestHandler(options = {}) {
         );
       }
       if (!artifacts) return unavailableArtifactsResponse(state);
+      if (path.startsWith(`/${tileflowLineBackgroundGlyphRoute}/`)) {
+        const glyphRequest = parseTileflowLineBackgroundGlyphPath(path);
+        const upstream = glyphRequest ? artifacts.lineBackgroundGlyphs?.[glyphRequest.mapName] : void 0;
+        if (!glyphRequest || !upstream) return jsonResponse2({ error: "Unknown glyph range." }, 404);
+        return await lineBackgroundGlyphs(upstream, glyphRequest.fontStack, glyphRequest.range);
+      }
       if (path.startsWith("/tilesets/")) {
         const fileName = path.replace(/^\/+/, "");
         const localTileset = artifacts.localTilesets?.find(
@@ -1985,7 +1995,7 @@ function getRequestPathname(url) {
   }
 }
 function isOwnedTileflowRequestPath(path) {
-  return path === "/" || path === "/build-manifest.json" || path === "/manifest.json" || path === "/__events" || path === "/__status" || getTileflowStyleInspectionSelection(path) !== void 0 || path.startsWith("/generations/") || path.startsWith("/icons/") || path.startsWith("/tilesets/") || getTileflowStyleSelection(path) !== void 0 || path.startsWith("/fonts/") || path.startsWith("/__runtime/");
+  return path === "/" || path === "/build-manifest.json" || path === "/manifest.json" || path === "/__events" || path === "/__status" || getTileflowStyleInspectionSelection(path) !== void 0 || path.startsWith("/generations/") || path.startsWith("/icons/") || path.startsWith("/tilesets/") || getTileflowStyleSelection(path) !== void 0 || path.startsWith("/fonts/") || path.startsWith(`/${tileflowLineBackgroundGlyphRoute}/`) || path.startsWith("/__runtime/");
 }
 function tileflowErrorResponse(error) {
   if (error instanceof Error && "code" in error && error.code === "PREVIEW_SELECTION_INVALID") {

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { CreateTileflowArtifactPlanOptions, TileflowArtifactAcquisition, TileflowArtifactDiagnostic, TileflowArtifactFile, TileflowArtifactInputGraph, TileflowArtifactPlan, TileflowArtifactSession, TileflowArtifactSessionOptions, TileflowArtifactSessionState, TileflowBuildArtifacts, TileflowBuildArtifactsOptions, TileflowBuildStyleInspections, TileflowHostedManifestOverwriteError, TileflowLocalTilesetFile, TileflowLocalTilesetProductionError, TileflowManifestOptions, WriteTileflowArtifactPlanOptions, WriteTileflowBuildArtifactsOptions, assertNoLocalTilesetsForProduction, assertTileflowSelfHostedManifestTarget, createTileflowArtifactDiagnostics, createTileflowArtifactPlan, createTileflowArtifactSession, createTileflowBuildArtifacts, createTileflowBuildProvenance, createTileflowManifest, createTileflowStyle, createTileflowStyles, disposeTileflowBuildArtifacts, getTileflowArtifactFiles, getTileflowAssetBasePath, getTileflowAssetFileName, getTileflowWatchPaths, isTileflowArtifactInputPath, joinTileflowPublicUrl, normalizeTileflowBasePath, prepareTileflowHostedNativeDeployment, prepareTileflowLocalTilesets, refreshTileflowArtifactSession, resolveTileflowArtifactPublicUrls, tileflowArtifactInventoryFileName, tileflowArtifactPlanSchemaVersion, tileflowArtifactSessionSchemaVersion, writeTileflowArtifactPlan, writeTileflowBuildArtifacts } from './artifacts.js';
+export { CreateTileflowArtifactPlanOptions, TileflowArtifactAcquisition, TileflowArtifactDiagnostic, TileflowArtifactFile, TileflowArtifactInputGraph, TileflowArtifactPlan, TileflowArtifactSession, TileflowArtifactSessionOptions, TileflowArtifactSessionState, TileflowBuildArtifacts, TileflowBuildArtifactsOptions, TileflowBuildStyleInspections, TileflowHostedManifestOverwriteError, TileflowLineBackgroundGlyphProviders, TileflowLineBackgroundGlyphResponder, TileflowLocalTilesetFile, TileflowLocalTilesetProductionError, TileflowManifestOptions, WriteTileflowArtifactPlanOptions, WriteTileflowBuildArtifactsOptions, assertNoLocalTilesetsForProduction, assertTileflowSelfHostedManifestTarget, createTileflowArtifactDiagnostics, createTileflowArtifactPlan, createTileflowArtifactSession, createTileflowBuildArtifacts, createTileflowBuildProvenance, createTileflowLineBackgroundGlyphResponder, createTileflowManifest, createTileflowStyle, createTileflowStyles, disposeTileflowBuildArtifacts, getTileflowArtifactFiles, getTileflowAssetBasePath, getTileflowAssetFileName, getTileflowWatchPaths, isTileflowArtifactInputPath, joinTileflowPublicUrl, normalizeTileflowBasePath, parseTileflowLineBackgroundGlyphPath, prepareTileflowHostedNativeDeployment, prepareTileflowLocalTilesets, refreshTileflowArtifactSession, resolveTileflowArtifactPublicUrls, tileflowArtifactInventoryFileName, tileflowArtifactPlanSchemaVersion, tileflowArtifactSessionSchemaVersion, tileflowLineBackgroundGlyphRoute, usesTileflowLineBackgroundGlyphs, writeTileflowArtifactPlan, writeTileflowBuildArtifacts } from './artifacts.js';
 export { LoadTileflowConfigOptions, LoadedTileflowConfig, TileflowValidationError, assertValidTileflowConfig, defaultTileflowApiUrl, defaultTileflowConfigPath, defaultTileflowManifestPath, getFirstTileflowMapName, getTileflowMapNames, loadTileflowConfig, loadTileflowConfigWithInputs, loadValidTileflowConfig, loadValidTileflowConfigWithInputs } from './config.js';
 export { CompiledTileflowFontBundle, PrepareTileflowStyleFontsOptions, PreparedTileflowStyleFonts, TileflowFontCompilationError, TileflowFontCompilationIssue, TileflowFontCompilationTarget, bindTileflowStyleFontBundle, getTileflowFontWatchPaths, prepareTileflowStyleFonts, replaceTileflowStyleFontSources } from './fonts.js';
 export { CompileTileflowIconPackagesOptions, CompileTileflowIconPackagesResult, CompiledTileflowIconPackage, CompiledTileflowIconPackageFile, ComposeTileflowIconSourcesOptions, InspectTileflowIconCatalogsOptions, PreparedTileflowBuildCatalog, PreparedTileflowCatalog, ReadTileflowIconDirectoryResult, TileflowBuildAsset, TileflowComposedIconContributor, TileflowComposedIconSources, TileflowComposedIconWinner, TileflowIconCacheOptions, TileflowIconCatalog, TileflowIconCatalogAtlasRectangle, TileflowIconCatalogContributor, TileflowIconCatalogIcon, TileflowIconCatalogIconSource, TileflowIconCatalogInspection, TileflowIconCatalogMap, TileflowIconCatalogRenderedDensity, TileflowIconCatalogSourceFormat, TileflowIconCompilationError, TileflowIconCompilationIssue, TileflowIconCompilationTarget, TileflowIconDirectoryEntry, TileflowIconDirectorySourceFile, TileflowIconReplacement, TileflowIconResolutionOptions, TileflowMapIconPackageBinding, TileflowRenderedIcon, TileflowRenderedIconCell, TileflowSourceCatalog, VerifiedTileflowIconArtifact, compileTileflowIconPackages, composeTileflowIconSources, getTileflowIconCacheDirectory, getTileflowIconWatchPaths, iconFileExtensions, inspectTileflowIconCatalogs, loadTileflowIconSetArtifact, packTileflowRenderedIcons, prepareTileflowCatalogIcons, readTileflowIconDirectory, readTileflowIconsLockfile, readTileflowIconsLockfileText, renderTileflowIconAtlasPreview, storeTileflowIconSetArtifact, verifyTileflowIconArtifact, writeTileflowIconsLockfile } from './icons.js';

package/dist/index.js

@@ -19,7 +19,7 @@ import {
   readBoundedTileflowResponse,
   renderTileflowPreviewHtml,
   resolveTileflowPreview
-} from "./chunk-6OJICHB3.js";
+} from "./chunk-CJGM6HTT.js";
 import {
   createTileflowArtifactStatus,
   createTileflowComparisonRequestHandler,
@@ -31,7 +31,7 @@ import {
   isTileflowRequestUrl,
   tileflowComparisonSchemaVersion,
   writeTileflowNodeResponse
-} from "./chunk-UCBGTEQV.js";
+} from "./chunk-QYM2CUZB.js";
 import {
   TileflowHostedManifestOverwriteError,
   TileflowLocalTilesetProductionError,
@@ -42,6 +42,7 @@ import {
   createTileflowArtifactSession,
   createTileflowBuildArtifacts,
   createTileflowBuildProvenance,
+  createTileflowLineBackgroundGlyphResponder,
   createTileflowManifest,
   createTileflowStyle,
   createTileflowStyles,
@@ -49,15 +50,18 @@ import {
   getTileflowArtifactFiles,
   getTileflowWatchPaths,
   isTileflowArtifactInputPath,
+  parseTileflowLineBackgroundGlyphPath,
   prepareTileflowHostedNativeDeployment,
   prepareTileflowLocalTilesets,
   refreshTileflowArtifactSession,
   tileflowArtifactInventoryFileName,
   tileflowArtifactPlanSchemaVersion,
   tileflowArtifactSessionSchemaVersion,
+  tileflowLineBackgroundGlyphRoute,
+  usesTileflowLineBackgroundGlyphs,
   writeTileflowArtifactPlan,
   writeTileflowBuildArtifacts
-} from "./chunk-QAMFAM3S.js";
+} from "./chunk-LXSFLPIU.js";
 import {
   inspectTileflowPmtiles,
   inspectTileflowPmtilesForLocalUse
@@ -140,6 +144,7 @@ export {
   createTileflowCommandSummary,
   createTileflowComparisonRequestHandler,
   createTileflowDevRequestHandler,
+  createTileflowLineBackgroundGlyphResponder,
   createTileflowManifest,
   createTileflowNodeRequest,
   createTileflowStructuredDiagnostics,
@@ -179,6 +184,7 @@ export {
   normalizeTileflowBasePath,
   normalizeTileflowLandmarkManifest,
   packTileflowRenderedIcons,
+  parseTileflowLineBackgroundGlyphPath,
   prepareTileflowCatalogIcons,
   prepareTileflowHostedNativeDeployment,
   prepareTileflowLocalTilesets,
@@ -203,6 +209,8 @@ export {
   tileflowArtifactSessionSchemaVersion,
   tileflowCommandDocumentSchemaVersion,
   tileflowComparisonSchemaVersion,
+  tileflowLineBackgroundGlyphRoute,
+  usesTileflowLineBackgroundGlyphs,
   validateTileflowStyle,
   verifyTileflowIconArtifact,
   writeTileflowArtifactPlan,

package/dist/preview.d.ts

@@ -58,6 +58,8 @@ type ResolvedTileflowPreview = {
     label: string;
     mapName: string;
     themeName: string;
+    /** Every theme of a map preview, in declaration order. A scene owns its theme and omits this. */
+    themeNames?: readonly string[];
     viewport?: NormalizedTileflowCaptureScene['viewport'];
 };
 declare class TileflowPreviewSelectionError extends Error {

package/dist/preview.js

@@ -5,7 +5,7 @@ import {
   readBoundedTileflowResponse,
   renderTileflowPreviewHtml,
   resolveTileflowPreview
-} from "./chunk-6OJICHB3.js";
+} from "./chunk-CJGM6HTT.js";
 import "./chunk-6MGFMKG3.js";
 import "./chunk-D4OE4ITL.js";
 export {

package/dist/server.js

@@ -9,11 +9,11 @@ import {
   isTileflowRequestUrl,
   tileflowComparisonSchemaVersion,
   writeTileflowNodeResponse
-} from "./chunk-UCBGTEQV.js";
+} from "./chunk-QYM2CUZB.js";
 import {
   createTileflowArtifactDiagnostics,
   tileflowArtifactSessionSchemaVersion
-} from "./chunk-QAMFAM3S.js";
+} from "./chunk-LXSFLPIU.js";
 import "./chunk-ONYQNLNA.js";
 import {
   getTileflowAssetBasePath,

package/docs/native-artifacts.md

@@ -73,6 +73,15 @@ layer ID, the lowering version and deterministic branch order, with collision ch
 whole input style. The original layer's replacements stay together; surrounding layers are not
 reordered. Existing sort-key expressions are retained, not simplified or replaced.
 
+Replacements shift the physical index of every later layer, so lowering rebinds the style's layer
+references from the recorded spans. Each `tileflow:interaction-manifest` POI `priority` becomes its
+layer's final index. An overlay placement anchor naming an expanded layer moves to that layer's first
+replacement, because anchors mark insertion-before boundaries. Metadata that the spans cannot prove,
+such as a POI priority that differs from its compiled layer index, a POI entry whose source does not
+match its layer or an anchor naming a missing layer, fails with `NATIVE_UNSUPPORTED_STYLE` at the
+style's `/metadata` pointer rather than being guessed. Local builds, watched sessions and native
+preview share this step with Hosted publication.
+
 Work is bounded per property by depth 16, 512 decision visits, 64 decision paths, 16 distinct
 outcomes and 64 dash elements; the product is limited to 32 physical layers and 32 zoom intervals
 per logical layer. Raw compiler input must fit 160,000 JSON nodes before any lowering. Its expanded
@@ -137,7 +146,8 @@ style SHA-256 values, input/output layer counts, projection normalization, and t
 output start/count and affected properties of each changed layer. Ordinals refer to the complete
 style layer arrays, including unchanged layers. These spans make the deterministic physical IDs
 traceable without duplicating layer definitions in the receipt. The input hash binds shared
-compiler output; the lowered hash precedes native font preparation and generation URL retargeting.
+compiler output; the lowered hash includes the rebound layer references and precedes native font
+preparation and generation URL retargeting.
 The build-manifest hash separately binds the final prepared styles and assets. All styles receive
 an entry, including styles for which no lowering was needed. Schema v1 build records do not imply
 this preparation policy and are not parsed as v2.
@@ -152,6 +162,13 @@ URLs remain relative to their owning documents. An explicit absolute or host-rel
 an inert `.invalid` document base only to check relative URL syntax; it does not publish that base
 or infer the application's real delivery origin.
 
+A served local preview can use an absolute HTTP base, such as `http://127.0.0.1:3333`, only when it
+also passes that exact origin as `developmentOrigin`. Native checks then accept HTTP resource URLs,
+such as the sprite and fonts, with that scheme, host and port. Every other origin still requires
+HTTPS, and browser protocols remain rejected. The option is never inferred from a base URL.
+Web preparation, `target: 'production'` and `writeTileflowBuildArtifacts()` reject it with
+`NATIVE_RENDERER_UNSUPPORTED` at `/developmentOrigin`, so written artifacts never depend on it.
+
 Omitting `renderer`, or specifying `renderer: 'web'`, preserves the existing web artifact bytes and
 output layout. The native record is absent from web plans.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tileflow/dev",
-  "version": "0.1.0-alpha.27",
+  "version": "0.1.0-alpha.29",
   "license": "Apache-2.0",
   "description": "Node development utilities for Tileflow configs and builds.",
   "type": "module",
@@ -90,7 +90,7 @@
   "dependencies": {
     "@mapbox/vector-tile": "3.0.0",
     "@maplibre/maplibre-gl-style-spec": "24.8.5",
-    "@tileflow/core": ">=0.1.0-alpha.29 <0.1.0-beta.0",
+    "@tileflow/core": ">=0.1.0-alpha.31 <0.1.0-beta.0",
     "chokidar": "4.0.3",
     "fflate": "0.8.3",
     "fontkit": "2.0.4",
@@ -102,7 +102,7 @@
     "three": "0.185.1"
   },
   "devDependencies": {
-    "@tileflow/maps": "0.1.0-alpha.6"
+    "@tileflow/maps": "0.1.0-alpha.7"
   },
   "optionalDependencies": {
     "sharp": "0.35.4"