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

package/dist/artifacts.d.ts

@@ -153,6 +153,12 @@ type TileflowBuildArtifactsOptions = {
     assetBaseUrl?: string;
     config?: string;
     cwd?: string;
+    /**
+     * Native local preview only: the exact HTTP origin serving these artifacts, such as
+     * `http://127.0.0.1:3333`. Native checks accept HTTP resources at this origin only; every other
+     * origin still requires HTTPS. It is never inferred, and web or production output rejects it.
+     */
+    developmentOrigin?: string;
     /**
      * Explicit shared Icon Set resolution settings for this build.
      *
@@ -206,7 +212,7 @@ type TileflowArtifactPlan = TileflowBuildArtifacts & {
     schemaVersion: typeof tileflowArtifactPlanSchemaVersion;
     sourceProject: TileflowSourceCatalog;
 };
-type CreateTileflowArtifactPlanOptions = Pick<TileflowBuildArtifactsOptions, 'apiBaseUrl' | 'assetBaseUrl' | 'inspection' | 'renderer' | 'styleBaseUrl' | 'target'> & {
+type CreateTileflowArtifactPlanOptions = Pick<TileflowBuildArtifactsOptions, 'apiBaseUrl' | 'assetBaseUrl' | 'developmentOrigin' | 'inspection' | 'renderer' | 'styleBaseUrl' | 'target'> & {
     inputFiles?: readonly string[];
 };
 type WriteTileflowArtifactPlanOptions = {

package/dist/artifacts.js

@@ -27,7 +27,7 @@ import {
   usesTileflowLineBackgroundGlyphs,
   writeTileflowArtifactPlan,
   writeTileflowBuildArtifacts
-} from "./chunk-4HVIEMKM.js";
+} from "./chunk-LXSFLPIU.js";
 import "./chunk-ONYQNLNA.js";
 import {
   getTileflowAssetBasePath,

package/dist/{chunk-4HVIEMKM.js → chunk-LXSFLPIU.js}

@@ -47,7 +47,7 @@ import { dirname as dirname2, relative as relative2, resolve as resolve4, sep as
 import {
   compareCodeUnits as compareCodeUnits2,
   getTileflowStyleFontFaces as getTileflowStyleFontFaces2,
-  serializeCanonicalJson as serializeCanonicalJson4,
+  serializeCanonicalJson as serializeCanonicalJson3,
   tileflowMapIdSchema,
   tileflowThemeNameSchema
 } from "@tileflow/core";
@@ -62,10 +62,10 @@ import {
 import { parseTileflowRuntimeManifest } from "@tileflow/core/manifest";
 import {
   createTileflowNativeBuildRecord as createTileflowNativeBuildRecord2,
-  createTileflowNativeDiagnostic as createTileflowNativeDiagnostic4,
+  createTileflowNativeDiagnostic as createTileflowNativeDiagnostic3,
   resolveTileflowRenderer,
   tileflowNativeBuildRecordFileName,
-  TileflowNativeCompatibilityError as TileflowNativeCompatibilityError5
+  TileflowNativeCompatibilityError as TileflowNativeCompatibilityError4
 } from "@tileflow/core/native-profile";
 
 // src/line-background-glyphs.ts
@@ -587,6 +587,114 @@ import {
   validateTileflowNativePreparedStyle
 } from "@tileflow/core/native-profile";
 
+// src/native-layer-references.ts
+var overlayKeys = [
+  "above-water",
+  "below-roads",
+  "above-roads",
+  "above-buildings",
+  "below-labels",
+  "above-labels"
+];
+function object(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) throw new Error();
+  return value;
+}
+function identifier(layer) {
+  if (typeof layer.id !== "string" || !layer.id.length) throw new Error();
+  return layer.id;
+}
+function rebindNativeLayerReferences(input, lowered, changes) {
+  try {
+    const originalIndexes = /* @__PURE__ */ new Map();
+    const finalIndexes = /* @__PURE__ */ new Map();
+    const starts = /* @__PURE__ */ new Map();
+    const transformed = /* @__PURE__ */ new Map();
+    let previous = -1;
+    for (const change of changes) {
+      if (!Number.isSafeInteger(change.inputLayer) || change.inputLayer <= previous || change.inputLayer >= input.layers.length || !Number.isSafeInteger(change.outputStart) || !Number.isSafeInteger(change.outputCount) || change.outputCount < 1 || change.outputCount > 32 || !Array.isArray(change.properties) || !["line-cap", "line-dasharray", "line-cap,line-dasharray"].includes(
+        change.properties.join(",")
+      ))
+        throw new Error();
+      previous = change.inputLayer;
+      transformed.set(change.inputLayer, change);
+    }
+    for (const [index, layer] of lowered.layers.entries()) {
+      const id = identifier(layer);
+      if (finalIndexes.has(id)) throw new Error();
+      finalIndexes.set(id, index);
+    }
+    let offset = 0;
+    for (const [index, layer] of input.layers.entries()) {
+      const id = identifier(layer);
+      if (originalIndexes.has(id)) throw new Error();
+      originalIndexes.set(id, index);
+      starts.set(id, offset);
+      const change = transformed.get(index);
+      if (change && (change.outputStart !== offset || layer.type !== "line")) throw new Error();
+      const count = change?.outputCount ?? 1;
+      if (offset + count > lowered.layers.length) throw new Error();
+      for (let branch = 0; branch < count; branch++) {
+        const candidate = lowered.layers[offset + branch];
+        if (!change && identifier(candidate) !== id) throw new Error();
+        if (candidate.type !== layer.type || candidate.source !== layer.source || candidate["source-layer"] !== layer["source-layer"])
+          throw new Error();
+      }
+      offset += count;
+    }
+    if (offset !== lowered.layers.length) throw new Error();
+    const metadata = lowered.metadata === void 0 ? void 0 : { ...object(lowered.metadata) };
+    const originalMetadata = input.metadata === void 0 ? void 0 : object(input.metadata);
+    if (originalMetadata?.["tileflow:overlay-placement-manifest"] !== void 0) {
+      if (!metadata) throw new Error();
+      const overlay = object(originalMetadata["tileflow:overlay-placement-manifest"]);
+      const anchors = object(overlay.anchors);
+      if (overlay.schemaVersion !== 1 || Object.keys(anchors).length !== overlayKeys.length || overlayKeys.some((key2) => !Object.hasOwn(anchors, key2)))
+        throw new Error();
+      const updated = {};
+      for (const key2 of overlayKeys) {
+        const anchor = anchors[key2];
+        if (anchor === null) {
+          updated[key2] = null;
+          continue;
+        }
+        if (typeof anchor !== "string" || !starts.has(anchor)) throw new Error();
+        updated[key2] = identifier(lowered.layers[starts.get(anchor)]);
+      }
+      metadata["tileflow:overlay-placement-manifest"] = { ...overlay, anchors: updated };
+    }
+    if (originalMetadata?.["tileflow:interaction-manifest"] !== void 0) {
+      if (!metadata) throw new Error();
+      const manifest = object(originalMetadata["tileflow:interaction-manifest"]);
+      if (manifest.version !== 2) throw new Error();
+      const domains = object(manifest.domains);
+      let rebound = manifest;
+      if (domains.poi !== void 0) {
+        const poi = object(domains.poi);
+        if (!Array.isArray(poi.layers) || poi.layers.length > 256) throw new Error();
+        const seen = /* @__PURE__ */ new Set();
+        const layers = poi.layers.map((value) => {
+          const entry = object(value);
+          if (typeof entry.layerId !== "string" || seen.has(entry.layerId)) throw new Error();
+          const index = originalIndexes.get(entry.layerId);
+          if (index === void 0 || index !== entry.priority || transformed.has(index) || !finalIndexes.has(entry.layerId))
+            throw new Error();
+          const original = input.layers[index];
+          if (original.source !== entry.source || original["source-layer"] !== entry.sourceLayer)
+            throw new Error();
+          seen.add(entry.layerId);
+          return { ...entry, priority: finalIndexes.get(entry.layerId) };
+        });
+        rebound = { ...manifest, domains: { ...domains, poi: { ...poi, layers } } };
+      }
+      metadata["tileflow:interaction-manifest"] = rebound;
+    }
+    return metadata === void 0 ? { ...lowered } : { ...lowered, metadata };
+  } catch {
+    return void 0;
+  }
+}
+
 // src/native-lowering.ts
 var nativeLoweringLimits = Object.freeze({
   maximumDecisionDepth: 16,
@@ -613,7 +721,7 @@ var NativeLoweringError = class extends Error {
 function fail(path, reason = "shape") {
   throw new NativeLoweringError(path, reason);
 }
-function object(value) {
+function object2(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value);
 }
 function operation(value, name, length) {
@@ -1054,21 +1162,21 @@ function lowerNativeStyleRepresentation(input, normalizeFilter = (filter) => fil
   const originalLayers = input.layers;
   const reserved = /* @__PURE__ */ new Set();
   for (const [index, layer] of originalLayers.entries()) {
-    if (!object(layer) || typeof layer.id !== "string" || reserved.has(layer.id))
+    if (!object2(layer) || typeof layer.id !== "string" || reserved.has(layer.id))
       fail(`/layers/${index}/id`);
     reserved.add(layer.id);
   }
   let projection = "none";
   if (input.projection !== void 0) {
-    if (!object(input.projection) || Object.keys(input.projection).length !== 1 || typeof input.projection.type !== "string" || !["globe", "mercator"].includes(input.projection.type))
+    if (!object2(input.projection) || Object.keys(input.projection).length !== 1 || typeof input.projection.type !== "string" || !["globe", "mercator"].includes(input.projection.type))
       fail("/projection");
     projection = input.projection.type === "globe" ? "globe-to-mercator" : "mercator-to-implicit";
   }
   const layers = [];
   const transformations = [];
   for (const [index, layer] of originalLayers.entries()) {
-    const source = object(input.sources) && typeof layer.source === "string" ? input.sources[layer.source] : void 0;
-    const lowered = lowerLayer(layer, index, object(source) && source.type === "vector");
+    const source = object2(input.sources) && typeof layer.source === "string" ? input.sources[layer.source] : void 0;
+    const lowered = lowerLayer(layer, index, object2(source) && source.type === "vector");
     if (!lowered) {
       layers.push(layer);
       continue;
@@ -1116,11 +1224,17 @@ function lowerNativeStyleRepresentation(input, normalizeFilter = (filter) => fil
 function documentUrl(map, theme) {
   return `https://artifacts.invalid/native/styles/${map}/${theme}.json`;
 }
+function urlOptions(map, theme, policy) {
+  return {
+    documentUrl: documentUrl(map, theme),
+    ...policy.developmentOrigin === void 0 ? {} : { developmentOrigin: policy.developmentOrigin }
+  };
+}
 function withContext(issue, map, theme) {
   const prefix = `/maps/${map}/themes/${theme}/style`;
   return { ...issue, path: prefix.length + issue.path.length <= 300 ? prefix + issue.path : prefix };
 }
-function lowerTileflowNativeCompiledStyles(input) {
+function lowerTileflowNativeCompiledStyles(input, policy = {}) {
   const styles = {};
   const transformations = [];
   for (const map of Object.keys(input).sort()) {
@@ -1128,7 +1242,7 @@ function lowerTileflowNativeCompiledStyles(input) {
     for (const theme of Object.keys(input[map]).sort()) {
       const original = input[map][theme];
       try {
-        const options = { documentUrl: documentUrl(map, theme), deferFontClosure: true };
+        const options = { ...urlOptions(map, theme, policy), deferFontClosure: true };
         const pending = validateTileflowNativeStyle(original, options);
         const blockers = pending.filter(
           (issue) => issue.code !== "NATIVE_UNSUPPORTED_STYLE" || !(issue.path === "/projection" || /^\/layers\/\d+\/(?:layout\/line-cap|paint\/line-dasharray)(?:\/|$)/u.test(issue.path))
@@ -1156,17 +1270,34 @@ function lowerTileflowNativeCompiledStyles(input) {
           original,
           (filter) => convertFilter(structuredClone(filter))
         );
-        const issues = validateTileflowNativePreparedStyle(lowered.style, options);
+        const style = rebindNativeLayerReferences(
+          original,
+          lowered.style,
+          lowered.layers
+        );
+        if (!style)
+          throw new TileflowNativeCompatibilityError([
+            withContext(
+              {
+                ...createTileflowNativeDiagnostic("NATIVE_UNSUPPORTED_STYLE", "/metadata"),
+                message: "Tileflow POI interaction or overlay placement metadata does not match the compiled layers.",
+                suggestion: "Rebuild with the Tileflow compiler; native lowering only rebinds POI priorities and overlay anchors that match the compiled layer order."
+              },
+              map,
+              theme
+            )
+          ]);
+        const issues = validateTileflowNativePreparedStyle(style, options);
         if (issues.length)
           throw new TileflowNativeCompatibilityError(
             issues.map((issue) => withContext(issue, map, theme))
           );
-        styles[map][theme] = lowered.style;
+        styles[map][theme] = style;
         transformations.push({
           map,
           theme,
           inputStyleSha256: createHash2("sha256").update(serializeCanonicalJson(original)).digest("hex"),
-          loweredStyleSha256: createHash2("sha256").update(serializeCanonicalJson(lowered.style)).digest("hex"),
+          loweredStyleSha256: createHash2("sha256").update(serializeCanonicalJson(style)).digest("hex"),
           inputLayers: lowered.inputLayers,
           outputLayers: lowered.outputLayers,
           projection: lowered.projection,
@@ -1190,13 +1321,13 @@ function lowerTileflowNativeCompiledStyles(input) {
   }
   return { styles, transformations };
 }
-function assertTileflowNativeCompiledStyles(project, styles) {
+function assertTileflowNativeCompiledStyles(project, styles, policy = {}) {
   const issues = [];
   for (const mapName of Object.keys(project.maps).sort()) {
     for (const theme of Object.keys(styles[mapName] ?? {}).sort()) {
       issues.push(
         ...validateTileflowNativePreparedStyle(styles[mapName][theme], {
-          documentUrl: documentUrl(mapName, theme),
+          ...urlOptions(mapName, theme, policy),
           deferFontClosure: true
         }).map((issue) => withContext(issue, mapName, theme))
       );
@@ -1204,7 +1335,7 @@ function assertTileflowNativeCompiledStyles(project, styles) {
   }
   if (issues.length) throw new TileflowNativeCompatibilityError(issues);
 }
-function prepareTileflowNativeStyles(input, assets) {
+function prepareTileflowNativeStyles(input, assets, policy = {}) {
   const issues = [];
   const result = {};
   for (const map of Object.keys(input).sort()) {
@@ -1218,7 +1349,7 @@ function prepareTileflowNativeStyles(input, assets) {
     for (const theme of Object.keys(input[map]).sort()) {
       const original = input[map][theme];
       const preflight = validateTileflowNativePreparedStyle(original, {
-        documentUrl: documentUrl(map, theme),
+        ...urlOptions(map, theme, policy),
         deferFontClosure: true
       });
       if (preflight.length) {
@@ -1262,9 +1393,9 @@ function prepareTileflowNativeStyles(input, assets) {
         ...faces.length ? { "font-faces": nativeFaces } : {}
       };
       issues.push(
-        ...validateTileflowNativePreparedStyle(style, {
-          documentUrl: documentUrl(map, theme)
-        }).map((issue) => withContext(issue, map, theme))
+        ...validateTileflowNativePreparedStyle(style, urlOptions(map, theme, policy)).map(
+          (issue) => withContext(issue, map, theme)
+        )
       );
       result[map][theme] = style;
     }
@@ -1282,8 +1413,8 @@ function isNativeFontAsset(asset) {
   const expectedHash = /-([a-f0-9]{64})\.(?:ttf|otf)$/u.exec(asset.fileName)?.[1];
   return expectedHash === createHash2("sha256").update(bytes).digest("hex");
 }
-function assertTileflowNativeGeneratedStyle(style, map, theme) {
-  const issues = validateTileflowNativePreparedStyle(style, { documentUrl: documentUrl(map, theme) });
+function assertTileflowNativeGeneratedStyle(style, map, theme, policy = {}) {
+  const issues = validateTileflowNativePreparedStyle(style, urlOptions(map, theme, policy));
   if (issues.length) {
     throw new TileflowNativeCompatibilityError(
       issues.map((issue) => withContext(issue, map, theme))
@@ -1422,6 +1553,7 @@ var TileflowArtifactSessionImpl = class {
       assetBaseUrl: options.assetBaseUrl,
       config: options.config,
       cwd: this.#cwd,
+      ...options.developmentOrigin === void 0 ? {} : { developmentOrigin: options.developmentOrigin },
       // Trusted shared Icon Set resolution settings, supplied once by the owning command.
       ...options.icons ? { icons: options.icons } : {},
       inspection: options.inspection,
@@ -1889,7 +2021,7 @@ function boundDiagnosticText(value, limit) {
 
 // src/hosted-native-artifacts.ts
 import { createHash as createHash3 } from "crypto";
-import { serializeCanonicalJson as serializeCanonicalJson3 } from "@tileflow/core";
+import { serializeCanonicalJson as serializeCanonicalJson2 } from "@tileflow/core";
 import {
   inferTileflowDataRequirements,
   inferTileflowSourceRequirements,
@@ -1897,135 +2029,17 @@ import {
 } from "@tileflow/core/build";
 import {
   createTileflowNativeBuildRecord,
-  TileflowNativeCompatibilityError as TileflowNativeCompatibilityError4,
-  createTileflowNativeDiagnostic as createTileflowNativeDiagnostic3
+  TileflowNativeCompatibilityError as TileflowNativeCompatibilityError3,
+  createTileflowNativeDiagnostic as createTileflowNativeDiagnostic2
 } from "@tileflow/core/native-profile";
-
-// src/native-hosted-provenance.ts
-import { serializeCanonicalJson as serializeCanonicalJson2 } from "@tileflow/core";
-import {
-  createTileflowNativeDiagnostic as createTileflowNativeDiagnostic2,
-  TileflowNativeCompatibilityError as TileflowNativeCompatibilityError3
-} from "@tileflow/core/native-profile";
-var overlayKeys = [
-  "above-water",
-  "below-roads",
-  "above-roads",
-  "above-buildings",
-  "below-labels",
-  "above-labels"
-];
-function object2(value) {
-  if (!value || typeof value !== "object" || Array.isArray(value)) throw new Error();
-  return value;
-}
-function identifier(layer) {
-  if (typeof layer.id !== "string" || !layer.id.length) throw new Error();
-  return layer.id;
-}
-function finalizeNativeHostedProvenance(input, lowered, changes) {
-  try {
-    const result = JSON.parse(serializeCanonicalJson2(lowered));
-    const originalIndexes = /* @__PURE__ */ new Map();
-    const finalIndexes = /* @__PURE__ */ new Map();
-    const starts = /* @__PURE__ */ new Map();
-    const transformed = /* @__PURE__ */ new Map();
-    let previous = -1;
-    for (const change of changes) {
-      if (!Number.isSafeInteger(change.inputLayer) || change.inputLayer <= previous || change.inputLayer >= input.layers.length || !Number.isSafeInteger(change.outputStart) || !Number.isSafeInteger(change.outputCount) || change.outputCount < 1 || change.outputCount > 32 || !Array.isArray(change.properties) || !["line-cap", "line-dasharray", "line-cap,line-dasharray"].includes(
-        change.properties.join(",")
-      ))
-        throw new Error();
-      previous = change.inputLayer;
-      transformed.set(change.inputLayer, change);
-    }
-    for (const [index, layer] of result.layers.entries()) {
-      const id = identifier(layer);
-      if (finalIndexes.has(id)) throw new Error();
-      finalIndexes.set(id, index);
-    }
-    let offset = 0;
-    for (const [index, layer] of input.layers.entries()) {
-      const id = identifier(layer);
-      if (originalIndexes.has(id)) throw new Error();
-      originalIndexes.set(id, index);
-      starts.set(id, offset);
-      const change = transformed.get(index);
-      if (change && (change.outputStart !== offset || layer.type !== "line")) throw new Error();
-      const count = change?.outputCount ?? 1;
-      if (offset + count > result.layers.length) throw new Error();
-      for (let branch = 0; branch < count; branch++) {
-        const candidate = result.layers[offset + branch];
-        if (!change && identifier(candidate) !== id) throw new Error();
-        if (candidate.type !== layer.type || candidate.source !== layer.source || candidate["source-layer"] !== layer["source-layer"])
-          throw new Error();
-      }
-      offset += count;
-    }
-    if (offset !== result.layers.length) throw new Error();
-    const metadata = result.metadata === void 0 ? void 0 : object2(result.metadata);
-    const originalMetadata = input.metadata === void 0 ? void 0 : object2(input.metadata);
-    if (originalMetadata?.["tileflow:overlay-placement-manifest"] !== void 0) {
-      if (!metadata) throw new Error();
-      const overlay = object2(originalMetadata["tileflow:overlay-placement-manifest"]);
-      const anchors = object2(overlay.anchors);
-      if (overlay.schemaVersion !== 1 || Object.keys(anchors).length !== overlayKeys.length || overlayKeys.some((key2) => !Object.hasOwn(anchors, key2)))
-        throw new Error();
-      const updated = {};
-      for (const key2 of overlayKeys) {
-        const anchor = anchors[key2];
-        if (anchor === null) {
-          updated[key2] = null;
-          continue;
-        }
-        if (typeof anchor !== "string" || !starts.has(anchor)) throw new Error();
-        updated[key2] = identifier(result.layers[starts.get(anchor)]);
-      }
-      metadata["tileflow:overlay-placement-manifest"] = { ...overlay, anchors: updated };
-    }
-    if (originalMetadata?.["tileflow:interaction-manifest"] !== void 0) {
-      if (!metadata) throw new Error();
-      const manifest = object2(
-        JSON.parse(serializeCanonicalJson2(originalMetadata["tileflow:interaction-manifest"]))
-      );
-      if (manifest.version !== 2) throw new Error();
-      const domains = object2(manifest.domains);
-      if (domains.poi !== void 0) {
-        const poi = object2(domains.poi);
-        if (!Array.isArray(poi.layers) || poi.layers.length > 256) throw new Error();
-        const seen = /* @__PURE__ */ new Set();
-        poi.layers = poi.layers.map((value) => {
-          const entry = object2(value);
-          if (typeof entry.layerId !== "string" || seen.has(entry.layerId)) throw new Error();
-          const index = originalIndexes.get(entry.layerId);
-          if (index === void 0 || index !== entry.priority || transformed.has(index) || !finalIndexes.has(entry.layerId))
-            throw new Error();
-          const original = input.layers[index];
-          if (original.source !== entry.source || original["source-layer"] !== entry.sourceLayer)
-            throw new Error();
-          seen.add(entry.layerId);
-          return { ...entry, priority: finalIndexes.get(entry.layerId) };
-        });
-      }
-      metadata["tileflow:interaction-manifest"] = manifest;
-    }
-    return result;
-  } catch {
-    throw new TileflowNativeCompatibilityError3([
-      createTileflowNativeDiagnostic2("NATIVE_UNSUPPORTED_STYLE", "/metadata")
-    ]);
-  }
-}
-
-// src/hosted-native-artifacts.ts
-var digest2 = (value) => createHash3("sha256").update(serializeCanonicalJson3(value)).digest("hex");
-var invalidSource = () => new TileflowNativeCompatibilityError4([
-  createTileflowNativeDiagnostic3("NATIVE_UNSUPPORTED_SOURCE", "/sources")
+var digest2 = (value) => createHash3("sha256").update(serializeCanonicalJson2(value)).digest("hex");
+var invalidSource = () => new TileflowNativeCompatibilityError3([
+  createTileflowNativeDiagnostic2("NATIVE_UNSUPPORTED_SOURCE", "/sources")
 ]);
 async function prepareTileflowHostedNativeDeployment(input) {
-  const webStyles = JSON.parse(serializeCanonicalJson3(input.styles));
+  const webStyles = JSON.parse(serializeCanonicalJson2(input.styles));
   const validationStyles = JSON.parse(
-    serializeCanonicalJson3(webStyles)
+    serializeCanonicalJson2(webStyles)
   );
   for (const style of Object.values(validationStyles)) {
     for (const [sourceId, binding] of Object.entries(input.teamSources)) {
@@ -2036,14 +2050,6 @@ async function prepareTileflowHostedNativeDeployment(input) {
     }
   }
   const lowered = lowerTileflowNativeCompiledStyles({ [input.mapId]: validationStyles });
-  for (const transformation of lowered.transformations) {
-    const name = transformation.theme;
-    lowered.styles[input.mapId][name] = finalizeNativeHostedProvenance(
-      validationStyles[name],
-      lowered.styles[input.mapId][name],
-      transformation.layers
-    );
-  }
   const projected = prepareTileflowNativeStyles(lowered.styles, input.assets)[input.mapId];
   for (const [name, style] of Object.entries(projected)) {
     for (const sourceId of Object.keys(input.teamSources)) {
@@ -2051,11 +2057,11 @@ async function prepareTileflowHostedNativeDeployment(input) {
       if (!source) throw invalidSource();
       source.url = `tileflow://hosted-sources/${sourceId}`;
     }
-    if (serializeCanonicalJson3(style.sources) !== serializeCanonicalJson3(webStyles[name].sources))
+    if (serializeCanonicalJson2(style.sources) !== serializeCanonicalJson2(webStyles[name].sources))
       throw invalidSource();
   }
   const nativeBuild = JSON.parse(
-    serializeCanonicalJson3(input.buildManifest)
+    serializeCanonicalJson2(input.buildManifest)
   );
   const mapBuild = nativeBuild.maps[input.mapId];
   if (!mapBuild) throw invalidSource();
@@ -2174,12 +2180,16 @@ function assertValidTileflowStyles(project, styles) {
 async function createTileflowArtifactPlan(prepared, options = {}) {
   const renderer = resolveTileflowRenderer(options.renderer);
   if (renderer === "native" && options.inspection) {
-    throw new TileflowNativeCompatibilityError5([
-      createTileflowNativeDiagnostic4("NATIVE_RENDERER_UNSUPPORTED", "/inspection")
+    throw new TileflowNativeCompatibilityError4([
+      createTileflowNativeDiagnostic3("NATIVE_RENDERER_UNSUPPORTED", "/inspection")
     ]);
   }
+  assertNativeDevelopmentOrigin(options);
+  const nativeUrls = {
+    developmentOrigin: options.developmentOrigin
+  };
   if (renderer === "native") {
-    assertTileflowNativeCompiledStyles(prepared.project, {});
+    assertTileflowNativeCompiledStyles(prepared.project, {}, nativeUrls);
   } else if (options.target === "production" && hasLocalTilesetSources(prepared.project)) {
     throw new TileflowLocalTilesetProductionError();
   }
@@ -2192,9 +2202,10 @@ async function createTileflowArtifactPlan(prepared, options = {}) {
     apiBaseUrl: options.apiBaseUrl,
     mapAssets: prepared.mapAssets
   });
-  const nativeLowering = renderer === "native" ? lowerTileflowNativeCompiledStyles(compiledStyles) : void 0;
+  const nativeLowering = renderer === "native" ? lowerTileflowNativeCompiledStyles(compiledStyles, nativeUrls) : void 0;
   const rendererStyles = nativeLowering?.styles ?? compiledStyles;
-  if (renderer === "native") assertTileflowNativeCompiledStyles(prepared.project, rendererStyles);
+  if (renderer === "native")
+    assertTileflowNativeCompiledStyles(prepared.project, rendererStyles, nativeUrls);
   const localTilesets = await prepareTileflowLocalTilesets(prepared.project, rendererStyles, {
     assetBaseUrl: resolveRendererAssetBaseUrl(options),
     baseDirectory: prepared.baseDirectory,
@@ -2208,8 +2219,8 @@ async function createTileflowArtifactPlan(prepared, options = {}) {
       target: "local"
     }).catch((error) => {
       if (renderer === "native" && error instanceof TileflowFontCompilationError) {
-        throw new TileflowNativeCompatibilityError5([
-          createTileflowNativeDiagnostic4("NATIVE_FONT_UNAVAILABLE", "/fonts")
+        throw new TileflowNativeCompatibilityError4([
+          createTileflowNativeDiagnostic3("NATIVE_FONT_UNAVAILABLE", "/fonts")
         ]);
       }
       throw error;
@@ -2218,7 +2229,7 @@ async function createTileflowArtifactPlan(prepared, options = {}) {
     const lineBackgroundGlyphs = renderer === "native" || options.target === "production" ? { providers: {}, styles: preparedFonts.styles } : prepareTileflowLineBackgroundGlyphs(preparedFonts.styles, {
       assetBaseUrl: resolveRendererAssetBaseUrl(options)
     });
-    const styles = renderer === "native" ? prepareTileflowNativeStyles(preparedFonts.styles, assets) : lineBackgroundGlyphs.styles;
+    const styles = renderer === "native" ? prepareTileflowNativeStyles(preparedFonts.styles, assets, nativeUrls) : lineBackgroundGlyphs.styles;
     const provenance = await createTileflowBuildProvenance(prepared.cwd);
     const buildManifest = await createTileflowMapBuildManifest(
       Object.fromEntries(
@@ -2270,7 +2281,7 @@ async function createTileflowArtifactPlan(prepared, options = {}) {
       buildManifest,
       ...renderer === "native" ? {
         nativeBuild: createTileflowNativeBuildRecord2(
-          hashBytes(serializeCanonicalJson4(buildManifest)),
+          hashBytes(serializeCanonicalJson3(buildManifest)),
           nativeLowering.transformations
         )
       } : {},
@@ -2289,7 +2300,7 @@ async function createTileflowArtifactPlan(prepared, options = {}) {
     const generationArtifacts = { ...partial, manifest };
     return {
       ...generationArtifacts,
-      files: createGenerationArtifactFiles(generationArtifacts, generation),
+      files: createGenerationArtifactFiles(generationArtifacts, generation, nativeUrls),
       inputs,
       project: prepared.project,
       schemaVersion: tileflowArtifactPlanSchemaVersion,
@@ -2302,6 +2313,7 @@ async function createTileflowArtifactPlan(prepared, options = {}) {
 }
 async function createTileflowBuildArtifacts(options = {}) {
   resolveTileflowRenderer(options.renderer);
+  assertNativeDevelopmentOrigin(options);
   const loaded = await loadValidTileflowConfigWithInputs(
     options.config ?? defaultTileflowConfigPath,
     {
@@ -2328,7 +2340,7 @@ function getStableTileflowArtifactFiles(artifacts) {
     {
       contentType: "application/json; charset=utf-8",
       fileName: tileflowMapBuildManifestFileName,
-      source: `${serializeCanonicalJson4(artifacts.buildManifest)}
+      source: `${serializeCanonicalJson3(artifacts.buildManifest)}
 `
     },
     {
@@ -2350,7 +2362,7 @@ function getStableTileflowArtifactFiles(artifacts) {
       {
         contentType: "application/json; charset=utf-8",
         fileName: tileflowNativeBuildRecordFileName,
-        source: `${serializeCanonicalJson4(artifacts.nativeBuild)}
+        source: `${serializeCanonicalJson3(artifacts.nativeBuild)}
 `
       }
     ] : []
@@ -2403,7 +2415,7 @@ function createGenerationManifest(manifest, generation, assets) {
     )
   };
 }
-function createGenerationArtifactFiles(artifacts, generation) {
+function createGenerationArtifactFiles(artifacts, generation, nativeUrls) {
   const prefix = `generations/${generation}`;
   const stableFiles = getStableTileflowArtifactFiles(artifacts);
   const immutableStyles = Object.entries(artifacts.styles).flatMap(
@@ -2423,7 +2435,7 @@ function createGenerationArtifactFiles(artifacts, generation) {
         (source) => retargetLocalFontAssetUrl(source, artifacts.assets, generation)
       );
       if (artifacts.nativeBuild)
-        assertTileflowNativeGeneratedStyle(generationStyle, mapName, themeName);
+        assertTileflowNativeGeneratedStyle(generationStyle, mapName, themeName, nativeUrls);
       return {
         contentType: "application/json; charset=utf-8",
         fileName: `${prefix}/styles/${mapName}/${themeName}.json`,
@@ -2950,6 +2962,13 @@ function hashArtifactGeneration(files) {
   }
   return hash.digest("hex");
 }
+function assertNativeDevelopmentOrigin(options) {
+  if (options.developmentOrigin !== void 0 && (resolveTileflowRenderer(options.renderer) !== "native" || options.target === "production")) {
+    throw new TileflowNativeCompatibilityError4([
+      createTileflowNativeDiagnostic3("NATIVE_RENDERER_UNSUPPORTED", "/developmentOrigin")
+    ]);
+  }
+}
 function resolveRendererAssetBaseUrl(options) {
   const base = resolveAssetBaseUrl(options);
   return options.renderer === "native" ? nativePublicBase(base) : base;

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

@@ -4,7 +4,7 @@ import {
   parseTileflowLineBackgroundGlyphPath,
   tileflowArtifactSessionSchemaVersion,
   tileflowLineBackgroundGlyphRoute
-} from "./chunk-4HVIEMKM.js";
+} from "./chunk-LXSFLPIU.js";
 import {
   normalizeTileflowBasePath
 } from "./chunk-UTRO4IBQ.js";

package/dist/index.js

@@ -31,7 +31,7 @@ import {
   isTileflowRequestUrl,
   tileflowComparisonSchemaVersion,
   writeTileflowNodeResponse
-} from "./chunk-YOTMY5XT.js";
+} from "./chunk-QYM2CUZB.js";
 import {
   TileflowHostedManifestOverwriteError,
   TileflowLocalTilesetProductionError,
@@ -61,7 +61,7 @@ import {
   usesTileflowLineBackgroundGlyphs,
   writeTileflowArtifactPlan,
   writeTileflowBuildArtifacts
-} from "./chunk-4HVIEMKM.js";
+} from "./chunk-LXSFLPIU.js";
 import {
   inspectTileflowPmtiles,
   inspectTileflowPmtilesForLocalUse

package/dist/server.js

@@ -9,11 +9,11 @@ import {
   isTileflowRequestUrl,
   tileflowComparisonSchemaVersion,
   writeTileflowNodeResponse
-} from "./chunk-YOTMY5XT.js";
+} from "./chunk-QYM2CUZB.js";
 import {
   createTileflowArtifactDiagnostics,
   tileflowArtifactSessionSchemaVersion
-} from "./chunk-4HVIEMKM.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.28",
+  "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.30 <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",