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

package/README.md

@@ -195,9 +195,8 @@ validation, browser startup, resource loading, MapLibre readiness, and screensho
 Resource diagnostics contain safe classification and origin/status information, not credentials,
 query strings, response bodies, raw browser stacks, or DOM contents.
 
-New receipts use schema version 4. Version-2 and version-3 receipts remain readable as historical
-evidence, not as newly verified version-4 captures. Import `@tileflow/capture/receipt` for receipt-only
-tooling without loading the capture runtime. World selectors resolve once per capture session to
+Receipts use schema version 4; parsing rejects any other version. Import
+`@tileflow/capture/receipt` for receipt-only tooling without loading the capture runtime. World selectors resolve once per capture session to
 an immutable release. Capture retains the complete resolved TileJSON, including its zoom range,
 bounds, attribution and vector-layer metadata. Above the data's maximum zoom, MapLibre enlarges
 available tiles while preserving the scene camera. Retries reuse the same frozen metadata.

package/THIRD_PARTY_NOTICES.md

@@ -18,7 +18,7 @@ the platform-specific headless shell into its versioned per-user browser cache;
 distribution carries Chromium's license and credits. Chromium source and license information are
 available at https://www.chromium.org/chromium-projects/.
 
-## MapLibre GL JS 6.9.0
+## MapLibre GL JS 6.13.0
 
 Copyright (c) 2023 MapLibre contributors. Licensed under BSD-3-Clause. The installed `maplibre-gl`
 package includes `LICENSE.txt`, including notices for code derived from Mapbox GL JS and other

package/dist/{chunk-BSTB4FN6.js → chunk-VNDAYGXY.js}

@@ -4,7 +4,6 @@ import { types as nodeUtilTypes } from "util";
 import {
   isTileflowWorldReleaseId,
   serializeCanonicalJson,
-  tileflowCaptureIdSchema,
   tileflowCaptureSceneLimits,
   tileflowCaptureSceneNameSchema,
   tileflowPortableIdSchema,
@@ -132,11 +131,10 @@ function parseTileflowCaptureReceipt(source) {
 function validateTileflowCaptureReceipt(value) {
   assertPlainReceiptData(value);
   const receipt = requireRecord(value, "receipt");
-  const schemaVersion = receipt.schemaVersion;
-  if (schemaVersion !== 2 && schemaVersion !== 3 && schemaVersion !== tileflowCaptureReceiptSchemaVersion) {
+  if (receipt.schemaVersion !== tileflowCaptureReceiptSchemaVersion) {
     throw invalidReceipt("The baseline receipt schema version is unsupported.");
   }
-  const commonKeys = [
+  requireExactKeys(receipt, [
     "schemaVersion",
     "scene",
     "style",
@@ -144,18 +142,14 @@ function validateTileflowCaptureReceipt(value) {
     "renderer",
     "platform",
     "data",
-    ...schemaVersion === 2 && receipt.verification === void 0 ? [] : ["verification"],
+    "verification",
     "networkDependent"
-  ];
-  requireExactKeys(receipt, commonKeys);
+  ]);
   const scene = requireRecord(receipt.scene, "scene");
-  requireExactKeys(
-    scene,
-    schemaVersion === tileflowCaptureReceiptSchemaVersion ? ["name", "map", "theme", "target", "sha256"] : ["name", "map", "target", "sha256"]
-  );
+  requireExactKeys(scene, ["name", "map", "theme", "target", "sha256"]);
   const name = requireSceneName(scene.name);
-  const map = schemaVersion === tileflowCaptureReceiptSchemaVersion ? requirePortableIdentifier(scene.map, "scene.map") : requireIdentifier(scene.map, "scene.map");
-  const theme = schemaVersion === tileflowCaptureReceiptSchemaVersion ? requireConcreteTheme(scene.theme) : void 0;
+  const map = requirePortableIdentifier(scene.map, "scene.map");
+  const theme = requireConcreteTheme(scene.theme);
   if (scene.target !== "map" && scene.target !== "application") {
     throw invalidReceipt("The baseline receipt has an invalid scene target.");
   }
@@ -197,13 +191,13 @@ function validateTileflowCaptureReceipt(value) {
   if (typeof receipt.networkDependent !== "boolean") {
     throw invalidReceipt("The baseline receipt has an invalid network dependency flag.");
   }
-  const data = schemaVersion === 2 ? validateDataIdentityV2(receipt.data) : validateDataIdentityV3(receipt.data);
+  const data = validateDataIdentity(receipt.data);
   const normalized = {
-    schemaVersion,
+    schemaVersion: tileflowCaptureReceiptSchemaVersion,
     scene: {
       name,
       map,
-      ...theme === void 0 ? {} : { theme },
+      theme,
       target: scene.target,
       sha256: requireHash(scene.sha256, "scene.sha256")
     },
@@ -237,61 +231,7 @@ function validateTileflowCaptureReceipt(value) {
   assertCanonicalReceiptByteLimit(normalized);
   return normalized;
 }
-function validateDataIdentityV2(value) {
-  const data = requireRecord(value, "data");
-  if (data.url !== void 0 && data.source !== void 0) {
-    throw invalidReceipt(
-      "The baseline receipt data identity must not mix legacy and safe sources."
-    );
-  }
-  requireExactKeys(data, [
-    ...data.bindings === void 0 ? [] : ["bindings"],
-    ...data.capabilities === void 0 ? [] : ["capabilities"],
-    "kind",
-    ...data.generation === void 0 ? [] : ["generation"],
-    ...data.revision === void 0 ? [] : ["revision"],
-    "schema",
-    "schemaVersion",
-    ...data.semantics === void 0 ? [] : ["semantics"],
-    "sourceId",
-    ...data.source === void 0 ? [] : ["source"],
-    ...data.url === void 0 ? [] : ["url"]
-  ]);
-  if (data.kind !== "tileflow-world" && data.kind !== "vector-tiles") {
-    throw invalidReceipt("The baseline receipt has an invalid data.kind.");
-  }
-  if (data.schema !== "openmaptiles" || data.sourceId !== "tileflow") {
-    throw invalidReceipt("The baseline receipt has an unsupported data contract.");
-  }
-  if (data.kind === "tileflow-world") {
-    const hasGeneration = data.generation !== void 0;
-    const hasLegacyRevision = data.revision !== void 0;
-    if (hasGeneration === hasLegacyRevision) {
-      throw invalidReceipt(
-        "The baseline receipt must identify World by one generation or one legacy revision."
-      );
-    }
-  } else if (data.generation !== void 0) {
-    throw invalidReceipt("The baseline receipt has an invalid data.generation.");
-  }
-  const bindings = data.bindings === void 0 ? void 0 : validateDataBindings(data.bindings, "data.bindings");
-  const capabilities = data.capabilities === void 0 ? void 0 : validateDataCapabilities(data.capabilities, "data.capabilities");
-  const source = data.source === void 0 ? data.url === void 0 ? void 0 : fingerprintLegacyDataUrl(data.url) : validateDataSource(data.source, "data.source");
-  const semantics = data.semantics === void 0 ? void 0 : validateDataSemantics(data.semantics, "data.semantics");
-  return {
-    ...bindings ? { bindings } : {},
-    ...capabilities ? { capabilities } : {},
-    ...data.generation === void 0 ? {} : { generation: requireWorldGeneration(data.generation) },
-    kind: data.kind,
-    ...data.revision === void 0 ? {} : { revision: requireSourceRevision(data.revision) },
-    schema: data.schema,
-    schemaVersion: requirePositiveInteger(data.schemaVersion, "data.schemaVersion"),
-    ...semantics ? { semantics } : {},
-    sourceId: data.sourceId,
-    ...source ? { source } : {}
-  };
-}
-function validateDataIdentityV3(value) {
+function validateDataIdentity(value) {
   const data = requireRecord(value, "data");
   if (data.kind === "tileflow-world") {
     requireExactKeys(data, [
@@ -304,13 +244,12 @@ function validateDataIdentityV3(value) {
       "releaseId",
       "schema",
       "schemaVersion",
-      ...data.semantics === void 0 ? [] : ["semantics"],
+      "semantics",
       "sourceId"
     ]);
     if (data.product !== "world-v1" || data.schema !== "openmaptiles" || data.sourceId !== "tileflow") {
       throw invalidReceipt("The baseline receipt has an unsupported World data contract.");
     }
-    const semantics2 = data.semantics === void 0 ? void 0 : validateDataSemantics(data.semantics, "data.semantics");
     return {
       archiveSha256: requireHash(data.archiveSha256, "data.archiveSha256"),
       contractSha256: requireHash(data.contractSha256, "data.contractSha256"),
@@ -321,7 +260,7 @@ function validateDataIdentityV3(value) {
       releaseId: requireWorldReleaseId(data.releaseId),
       schema: "openmaptiles",
       schemaVersion: requirePositiveInteger(data.schemaVersion, "data.schemaVersion"),
-      ...semantics2 ? { semantics: semantics2 } : {},
+      semantics: validateDataSemantics(data.semantics, "data.semantics"),
       sourceId: "tileflow"
     };
   }
@@ -329,41 +268,35 @@ function validateDataIdentityV3(value) {
     throw invalidReceipt("The baseline receipt has an invalid data.kind.");
   }
   requireExactKeys(data, [
-    ...data.bindings === void 0 ? [] : ["bindings"],
-    ...data.capabilities === void 0 ? [] : ["capabilities"],
+    "bindings",
+    "capabilities",
     "kind",
     ...data.revision === void 0 ? [] : ["revision"],
     "schema",
     "schemaVersion",
-    ...data.semantics === void 0 ? [] : ["semantics"],
-    "sourceId",
-    ...data.source === void 0 ? [] : ["source"]
+    "semantics",
+    "source",
+    "sourceId"
   ]);
   if (data.schema !== "openmaptiles" || data.sourceId !== "tileflow") {
     throw invalidReceipt("The baseline receipt has an unsupported data contract.");
   }
-  const bindings = data.bindings === void 0 ? void 0 : validateDataBindings(data.bindings, "data.bindings");
-  const capabilities = data.capabilities === void 0 ? void 0 : validateDataCapabilities(data.capabilities, "data.capabilities");
-  const semantics = data.semantics === void 0 ? void 0 : validateDataSemantics(data.semantics, "data.semantics");
   return {
-    ...bindings ? { bindings } : {},
-    ...capabilities ? { capabilities } : {},
+    bindings: validateDataBindings(data.bindings, "data.bindings"),
+    capabilities: validateDataCapabilities(data.capabilities, "data.capabilities"),
     kind: "vector-tiles",
     ...data.revision === void 0 ? {} : { revision: requireSourceRevision(data.revision) },
     schema: "openmaptiles",
     schemaVersion: requirePositiveInteger(data.schemaVersion, "data.schemaVersion"),
-    ...semantics ? { semantics } : {},
-    sourceId: "tileflow",
-    ...data.source === void 0 ? {} : { source: validateDataSource(data.source, "data.source") }
+    semantics: validateDataSemantics(data.semantics, "data.semantics"),
+    source: validateDataSource(data.source, "data.source"),
+    sourceId: "tileflow"
   };
 }
 function normalizeCaptureDataInput(input) {
   if (input.kind === "tileflow-world") return input;
   const { url, ...identity } = input;
-  return {
-    ...identity,
-    ...url === void 0 ? {} : { source: fingerprintLegacyDataUrl(url) }
-  };
+  return { ...identity, source: fingerprintDataUrl(url) };
 }
 function validateDataSemantics(value, field) {
   const semantics = requireRecord(value, field);
@@ -410,16 +343,18 @@ function validateDataCapabilities(value, field) {
   const capabilities = requireRecord(value, field);
   requireExactKeys(capabilities, [
     "businessCorridor",
-    ...capabilities.bathymetry === void 0 ? [] : ["bathymetry"],
+    "bathymetry",
+    "canopy",
     "globalLandcover",
     "tree"
   ]);
-  if (typeof capabilities.businessCorridor !== "boolean" || capabilities.bathymetry !== void 0 && typeof capabilities.bathymetry !== "boolean" || typeof capabilities.globalLandcover !== "boolean" || typeof capabilities.tree !== "boolean") {
+  if (typeof capabilities.businessCorridor !== "boolean" || typeof capabilities.bathymetry !== "boolean" || typeof capabilities.canopy !== "boolean" || typeof capabilities.globalLandcover !== "boolean" || typeof capabilities.tree !== "boolean") {
     throw invalidReceipt(`The baseline receipt has an invalid ${field} object.`);
   }
   return {
     businessCorridor: capabilities.businessCorridor,
-    ...capabilities.bathymetry === void 0 ? {} : { bathymetry: capabilities.bathymetry },
+    bathymetry: capabilities.bathymetry,
+    canopy: capabilities.canopy,
     globalLandcover: capabilities.globalLandcover,
     tree: capabilities.tree
   };
@@ -434,7 +369,6 @@ function validateDataSource(value, field) {
 }
 function validateVerification(value, target) {
   const expected = verificationForTarget(target);
-  if (value === void 0) return expected;
   const verification = requireRecord(value, "verification");
   requireExactKeys(verification, ["data", "style"]);
   if (verification.data !== expected.data || verification.style !== expected.style) {
@@ -513,11 +447,6 @@ function requireExactKeys(value, expected) {
     throw invalidReceipt("The baseline receipt contains missing or unsupported fields.");
   }
 }
-function requireIdentifier(value, field) {
-  const result = tileflowCaptureIdSchema.safeParse(value);
-  if (!result.success) throw invalidReceipt(`The baseline receipt has an invalid ${field}.`);
-  return result.data;
-}
 function requirePortableIdentifier(value, field) {
   const result = tileflowPortableIdSchema.safeParse(value);
   if (!result.success) throw invalidReceipt(`The baseline receipt has an invalid ${field}.`);
@@ -566,7 +495,7 @@ function requireSourceRevision(value) {
   }
   return value;
 }
-function fingerprintLegacyDataUrl(value) {
+function fingerprintDataUrl(value) {
   if (typeof value !== "string" || value.length < 1 || value.length > 2048) {
     throw invalidReceipt("The baseline receipt has an invalid data.url.");
   }
@@ -594,12 +523,6 @@ function isLoopbackHostname(value) {
   const hostname = value.toLowerCase().replace(/^\[|\]$/g, "");
   return hostname === "localhost" || hostname === "127.0.0.1" || hostname === "::1";
 }
-function requireWorldGeneration(value) {
-  if (value !== "v1") {
-    throw invalidReceipt("The baseline receipt has an invalid data.generation.");
-  }
-  return value;
-}
 function requireWorldReleaseId(value) {
   if (!isTileflowWorldReleaseId(value)) {
     throw invalidReceipt("The baseline receipt has an invalid data.releaseId.");

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { Browser } from 'playwright';
-import { T as TileflowCaptureRendererIdentity, a as TileflowCaptureReceiptV4, b as TileflowCaptureDataInput, c as TileflowCaptureWorldIdentityV3, d as TileflowCaptureReceipt } from './receipt-Q7wQ68tG.js';
-export { C as CreateTileflowCaptureReceiptInput, e as TileflowCaptureDataBindingsV2, f as TileflowCaptureDataCapabilitiesV2, g as TileflowCaptureDataIdentityV2, h as TileflowCaptureDataIdentityV3, i as TileflowCaptureDataSemanticsV2, j as TileflowCaptureDataSourceV2, k as TileflowCaptureReceiptV2, l as TileflowCaptureReceiptV3, m as TileflowCaptureVectorIdentityV3, n as TileflowCaptureVerificationV2, o as createTileflowCaptureReceipt, p as createTileflowCaptureRendererIdentity, q as parseTileflowCaptureReceipt, s as serializeTileflowCaptureReceipt, t as tileflowCaptureReceiptLimits, r as tileflowCaptureReceiptSchemaVersion, u as tileflowCaptureRuntime, v as validateTileflowCaptureReceipt } from './receipt-Q7wQ68tG.js';
+import { T as TileflowCaptureRendererIdentity, a as TileflowCaptureReceipt, b as TileflowCaptureDataInput, c as TileflowCaptureWorldIdentity } from './receipt-DhFOATRO.js';
+export { C as CreateTileflowCaptureReceiptInput, d as TileflowCaptureDataBindings, e as TileflowCaptureDataCapabilities, f as TileflowCaptureDataIdentity, g as TileflowCaptureDataSemantics, h as TileflowCaptureDataSource, i as TileflowCaptureVectorIdentity, j as TileflowCaptureVerification, k as createTileflowCaptureReceipt, l as createTileflowCaptureRendererIdentity, p as parseTileflowCaptureReceipt, s as serializeTileflowCaptureReceipt, t as tileflowCaptureReceiptLimits, m as tileflowCaptureReceiptSchemaVersion, n as tileflowCaptureRuntime, v as validateTileflowCaptureReceipt } from './receipt-DhFOATRO.js';
 import { TileflowCaptureScene, MapLibreStyle, NormalizedTileflowCaptureScene } from '@tileflow/core';
 import { TileflowIconResolutionOptions, TileflowBuildArtifacts, TileflowBuildAsset } from '@tileflow/dev/artifacts';
 
@@ -61,7 +61,7 @@ type TileflowCapture = {
     networkDependent: boolean;
     renderer: TileflowCaptureRendererIdentity;
     /** Newly captured evidence is always the concrete-theme receipt contract. */
-    receipt: TileflowCaptureReceiptV4;
+    receipt: TileflowCaptureReceipt;
     warnings: string[];
 };
 type TileflowCaptureResult = {
@@ -118,7 +118,7 @@ type FetchTileJson = (input: string, init: {
     signal?: AbortSignal;
 }) => Promise<Pick<Response, 'ok' | 'status' | 'text'>>;
 type TileflowCaptureResolvedWorldV1 = Readonly<{
-    identity: Omit<TileflowCaptureWorldIdentityV3, 'kind' | 'schema' | 'schemaVersion' | 'semantics' | 'sourceId'>;
+    identity: Omit<TileflowCaptureWorldIdentity, 'kind' | 'schema' | 'schemaVersion' | 'semantics' | 'sourceId'>;
     tileJsonUrl: string;
     tileJson: string;
     tiles: readonly [string];
@@ -321,13 +321,13 @@ type TileflowVisualReviewFrameIdentity = {
     };
 };
 type TileflowVisualReviewSide = {
-    scene: TileflowCaptureReceiptV4['scene'];
-    style: TileflowCaptureReceiptV4['style'];
+    scene: TileflowCaptureReceipt['scene'];
+    style: TileflowCaptureReceipt['style'];
     frame: TileflowVisualReviewFrameIdentity;
     image: TileflowVisualImageIdentity;
-    runtime: Pick<TileflowCaptureReceiptV4, 'renderer' | 'platform'>;
-    data: TileflowCaptureReceiptV4['data'];
-    verification: TileflowCaptureReceiptV4['verification'];
+    runtime: Pick<TileflowCaptureReceipt, 'renderer' | 'platform'>;
+    data: TileflowCaptureReceipt['data'];
+    verification: TileflowCaptureReceipt['verification'];
     palette: TileflowVisualPaletteColor[];
 };
 type TileflowVisualReviewComparison = {
@@ -365,4 +365,4 @@ declare const tileflowVisualReviewLimits: Readonly<{
     maximumAggregatePngBytes: number;
 }>;
 
-export { type CreateTileflowCaptureSessionOptions, type PreparedTileflowCaptureStyle, type TileflowBrowserInstallProgress, type TileflowBrowserLaunchOptions, type TileflowCapture, TileflowCaptureBrowserManager, TileflowCaptureDataInput, type TileflowCaptureDiagnostic, TileflowCaptureError, type TileflowCaptureErrorCode, type TileflowCaptureErrorDetails, type TileflowCaptureOptions, type TileflowCapturePhase, TileflowCaptureReceipt, TileflowCaptureReceiptV4, TileflowCaptureRendererIdentity, type TileflowCaptureResolvedWorldV1, type TileflowCaptureResourceDiagnostic, type TileflowCaptureResourceKind, type TileflowCaptureResult, type TileflowCaptureSession, TileflowCaptureWorldIdentityV3, TileflowCaptureWorldSession, type TileflowVisualAppearanceDelta, type TileflowVisualAppearanceProfile, type TileflowVisualAppearanceStatistics, type TileflowVisualBaseline, type TileflowVisualComparison, type TileflowVisualComparisonDocument, type TileflowVisualComparisonStatus, type TileflowVisualImageIdentity, type TileflowVisualPaletteColor, type TileflowVisualPixelMetric, type TileflowVisualReferenceAnalysis, type TileflowVisualReferenceAnalysisDocument, type TileflowVisualReferenceAnalysisOptions, type TileflowVisualReferenceAppearance, type TileflowVisualRegion, type TileflowVisualReviewAppearance, type TileflowVisualReviewCapture, type TileflowVisualReviewComparison, type TileflowVisualReviewDefinition, type TileflowVisualReviewDocument, TileflowVisualReviewError, type TileflowVisualReviewFrameIdentity, type TileflowVisualReviewOptions, type TileflowVisualReviewSide, type TileflowVisualReviewStatus, type TileflowVisualRuntimeIdentity, type TileflowVisualSceneIdentity, analyzeTileflowCaptureReference, captureErrorMessage, captureTileflowScenes, compareTileflowCaptureToBaseline, compareTileflowCapturesForReview, createTileflowCaptureBrowserEnvironment, createTileflowCaptureSession, createTileflowVisualComparisonDocument, createTileflowVisualReferenceAnalysisDocument, createTileflowVisualReviewDocument, launchTileflowCaptureBrowser, resolveTileflowApplicationUrl, resolveTileflowCaptureWorldTileJson, serializeTileflowVisualComparison, setupTileflowCaptureBrowser, tileflowCaptureResultSchemaVersion, tileflowSyntheticAssetOrigin, tileflowVisualArtifactLimits, tileflowVisualComparisonSchemaVersion, tileflowVisualEdgeThreshold, tileflowVisualPerceptualThreshold, tileflowVisualReviewLimits, tileflowVisualReviewSchemaVersion, tileflowWorldCurrentTileJsonUrl, validateTileflowVisualReferencePng };
+export { type CreateTileflowCaptureSessionOptions, type PreparedTileflowCaptureStyle, type TileflowBrowserInstallProgress, type TileflowBrowserLaunchOptions, type TileflowCapture, TileflowCaptureBrowserManager, TileflowCaptureDataInput, type TileflowCaptureDiagnostic, TileflowCaptureError, type TileflowCaptureErrorCode, type TileflowCaptureErrorDetails, type TileflowCaptureOptions, type TileflowCapturePhase, TileflowCaptureReceipt, TileflowCaptureRendererIdentity, type TileflowCaptureResolvedWorldV1, type TileflowCaptureResourceDiagnostic, type TileflowCaptureResourceKind, type TileflowCaptureResult, type TileflowCaptureSession, TileflowCaptureWorldIdentity, TileflowCaptureWorldSession, type TileflowVisualAppearanceDelta, type TileflowVisualAppearanceProfile, type TileflowVisualAppearanceStatistics, type TileflowVisualBaseline, type TileflowVisualComparison, type TileflowVisualComparisonDocument, type TileflowVisualComparisonStatus, type TileflowVisualImageIdentity, type TileflowVisualPaletteColor, type TileflowVisualPixelMetric, type TileflowVisualReferenceAnalysis, type TileflowVisualReferenceAnalysisDocument, type TileflowVisualReferenceAnalysisOptions, type TileflowVisualReferenceAppearance, type TileflowVisualRegion, type TileflowVisualReviewAppearance, type TileflowVisualReviewCapture, type TileflowVisualReviewComparison, type TileflowVisualReviewDefinition, type TileflowVisualReviewDocument, TileflowVisualReviewError, type TileflowVisualReviewFrameIdentity, type TileflowVisualReviewOptions, type TileflowVisualReviewSide, type TileflowVisualReviewStatus, type TileflowVisualRuntimeIdentity, type TileflowVisualSceneIdentity, analyzeTileflowCaptureReference, captureErrorMessage, captureTileflowScenes, compareTileflowCaptureToBaseline, compareTileflowCapturesForReview, createTileflowCaptureBrowserEnvironment, createTileflowCaptureSession, createTileflowVisualComparisonDocument, createTileflowVisualReferenceAnalysisDocument, createTileflowVisualReviewDocument, launchTileflowCaptureBrowser, resolveTileflowApplicationUrl, resolveTileflowCaptureWorldTileJson, serializeTileflowVisualComparison, setupTileflowCaptureBrowser, tileflowCaptureResultSchemaVersion, tileflowSyntheticAssetOrigin, tileflowVisualArtifactLimits, tileflowVisualComparisonSchemaVersion, tileflowVisualEdgeThreshold, tileflowVisualPerceptualThreshold, tileflowVisualReviewLimits, tileflowVisualReviewSchemaVersion, tileflowWorldCurrentTileJsonUrl, validateTileflowVisualReferencePng };

package/dist/index.js

@@ -7,7 +7,7 @@ import {
   tileflowCaptureReceiptLimits,
   tileflowCaptureReceiptSchemaVersion,
   validateTileflowCaptureReceipt
-} from "./chunk-BSTB4FN6.js";
+} from "./chunk-VNDAYGXY.js";
 
 // src/browser.ts
 import { spawn } from "child_process";
@@ -317,6 +317,11 @@ import { open } from "fs/promises";
 import { createRequire as createRequire2 } from "module";
 import { dirname as dirname2, join as join2 } from "path";
 import { getTileflowStyleFontFaces } from "@tileflow/core/runtime";
+import {
+  createTileflowLineBackgroundGlyphResponder,
+  parseTileflowLineBackgroundGlyphPath,
+  tileflowLineBackgroundGlyphRoute
+} from "@tileflow/dev/artifacts";
 import { assertValidTileflowStyle, TileflowStyleValidationError } from "@tileflow/dev/validation";
 
 // src/assets.ts
@@ -327,7 +332,6 @@ var require3 = createRequire2(import.meta.url);
 var mapLibreRuntimePaths = Object.freeze({
   css: require3.resolve("maplibre-gl/dist/maplibre-gl.css"),
   main: require3.resolve("maplibre-gl/dist/maplibre-gl.mjs"),
-  shared: require3.resolve("maplibre-gl/dist/maplibre-gl-shared.mjs"),
   worker: require3.resolve("maplibre-gl/dist/maplibre-gl-worker.mjs")
 });
 var tileflowCorePackagePath = require3.resolve("@tileflow/core/package.json");
@@ -409,6 +413,7 @@ async function captureStandaloneTileflowScene(input) {
     );
     const fontFaces = getTileflowStyleFontFaces(input.style);
     const remoteOrigins = /* @__PURE__ */ new Set();
+    let lineBackgroundGlyphs;
     let syntheticAssetFailure;
     const resourceFailures = [];
     let pageFailed = false;
@@ -439,6 +444,35 @@ async function captureStandaloneTileflowScene(input) {
           return;
         }
       }
+      if (url.origin === tileflowSyntheticAssetOrigin && url.pathname.startsWith(`/${tileflowLineBackgroundGlyphRoute}/`)) {
+        const glyphRequest = parseTileflowLineBackgroundGlyphPath(url.pathname);
+        const upstream = glyphRequest ? input.lineBackgroundGlyphs?.[glyphRequest.mapName] : void 0;
+        if (!glyphRequest || !upstream || url.search !== "") {
+          syntheticAssetFailure = url.pathname.slice(1) || "unknown";
+          await route.abort("blockedbyclient");
+          return;
+        }
+        const provider = new URL(
+          upstream.replace("{fontstack}", "stack").replace("{range}", "0-255")
+        );
+        if (!isLoopbackUrl(provider)) remoteOrigins.add(provider.origin);
+        lineBackgroundGlyphs ??= createTileflowLineBackgroundGlyphResponder({
+          cwd: input.glyphCacheDirectory ?? process.cwd()
+        });
+        const response = await lineBackgroundGlyphs(
+          upstream,
+          glyphRequest.fontStack,
+          glyphRequest.range
+        );
+        if (response.status !== 200) recordResourceFailure(url.toString(), response.status);
+        await route.fulfill({
+          body: Buffer.from(await response.arrayBuffer()),
+          contentType: response.headers.get("content-type") ?? "application/x-protobuf",
+          headers: { "Access-Control-Allow-Origin": "*" },
+          status: response.status
+        });
+        return;
+      }
       if (url.origin === tileflowSyntheticAssetOrigin) {
         const fileName = decodeURIComponent(url.pathname.slice(1));
         const localTileset = url.search === "" ? localTilesets.get(fileName) : void 0;
@@ -609,7 +643,6 @@ function createMapLibreRuntimeUrls(origin) {
     document: `${origin}/__runtime/document.html`,
     main: `${origin}/__runtime/maplibre-gl.mjs`,
     origin,
-    shared: `${origin}/__runtime/maplibre-gl-shared.mjs`,
     worker: `${origin}/__runtime/maplibre-gl-worker.mjs`
   });
 }
@@ -667,7 +700,7 @@ function getMapLibreRuntimeResponse(pathname, viewport) {
       status: 200
     };
   }
-  const asset = pathname === "/__runtime/maplibre-gl.mjs" ? mapLibreRuntimePaths.main : pathname === "/__runtime/maplibre-gl-shared.mjs" ? mapLibreRuntimePaths.shared : pathname === "/__runtime/maplibre-gl-worker.mjs" ? mapLibreRuntimePaths.worker : pathname === "/__runtime/maplibre-gl.css" ? mapLibreRuntimePaths.css : void 0;
+  const asset = pathname === "/__runtime/maplibre-gl.mjs" ? mapLibreRuntimePaths.main : pathname === "/__runtime/maplibre-gl-worker.mjs" ? mapLibreRuntimePaths.worker : pathname === "/__runtime/maplibre-gl.css" ? mapLibreRuntimePaths.css : void 0;
   if (!asset) return void 0;
   return {
     body: readFileSync2(asset, "utf8"),
@@ -1499,13 +1532,12 @@ var TileflowCaptureWorldSession = class {
     const source = requirePrimaryVectorSource(style);
     const lookupUrl = worldTileJsonLookupUrl(source, metadata);
     const resolution = await this.#resolveOne(lookupUrl, signal);
-    const semantics = validateSemantics(metadata.semantics);
     const data = {
       ...resolution.identity,
       kind: "tileflow-world",
       schema: requireLiteral(metadata.schema, "openmaptiles", "schema"),
       schemaVersion: requirePositiveInteger(metadata.schemaVersion, "schemaVersion"),
-      ...semantics ? { semantics } : {},
+      semantics: validateSemantics(metadata.semantics),
       sourceId: requireLiteral(metadata.sourceId, "tileflow", "sourceId")
     };
     const { tiles: _mutableTiles, url: _mutableUrl, ...sourceWithoutSelector } = source;
@@ -1691,7 +1723,6 @@ function validateExactTileTemplate(value, releaseId, descriptorSha256) {
   return value;
 }
 function validateSemantics(value) {
-  if (value === void 0) return void 0;
   const semantics = requireRecord(value, "data semantics");
   requireExactKeys(semantics, ["parkLayer"]);
   if (semantics.parkLayer !== "mixed" && semantics.parkLayer !== "protected-only") {
@@ -1873,6 +1904,10 @@ var TileflowCaptureSessionImpl = class {
         assets: [...artifacts.assets, ...prepared.assets ?? []],
         browser,
         ...artifacts.localTilesets ? { localTilesets: artifacts.localTilesets } : {},
+        ...artifacts.lineBackgroundGlyphs ? {
+          glyphCacheDirectory: resolve(this.#options.cwd ?? process.cwd()),
+          lineBackgroundGlyphs: artifacts.lineBackgroundGlyphs
+        } : {},
         scene,
         signal,
         style,
@@ -2151,9 +2186,6 @@ function validateTileflowVisualReferencePng(png) {
 async function analyzeTileflowCaptureReference(actualCapture, referencePng, options = {}) {
   const requestedRegion = snapshotTileflowVisualReferenceAnalysisOptions(options);
   const receipt = validateTileflowCaptureReceipt(actualCapture.receipt);
-  if (receipt.schemaVersion !== 4) {
-    throw invalidBaseline("Visual reference analysis requires a schema-v4 capture receipt.");
-  }
   const actualImage = await validatePngAgainstReceipt(actualCapture.png, receipt, "actual");
   const referenceImage = decodePng(referencePng, "reference");
   const dimensionsMatch = referenceImage.width === actualImage.width && referenceImage.height === actualImage.height;
@@ -2726,45 +2758,7 @@ function pixelMetric(changedPixels, totalPixels) {
   return { changedPixels, totalPixels, ratio: changedPixels / totalPixels };
 }
 function sameSceneIdentity(baseline, actual) {
-  return baseline.scene.name === actual.scene.name && baseline.scene.map === actual.scene.map && baseline.scene.target === actual.scene.target && baseline.scene.sha256 === actual.scene.sha256 && sameDataIdentity(baseline.data, actual.data);
-}
-function sameDataIdentity(baseline, actual) {
-  if (baseline.kind !== actual.kind || baseline.schema !== actual.schema || baseline.schemaVersion !== actual.schemaVersion || baseline.sourceId !== actual.sourceId) {
-    return false;
-  }
-  const baselineExactWorld = exactWorldIdentity(baseline);
-  const actualExactWorld = exactWorldIdentity(actual);
-  if (baselineExactWorld || actualExactWorld) {
-    if (!baselineExactWorld || !actualExactWorld) return false;
-    return baselineExactWorld.product === actualExactWorld.product && baselineExactWorld.releaseId === actualExactWorld.releaseId && baselineExactWorld.descriptorSha256 === actualExactWorld.descriptorSha256 && baselineExactWorld.archiveSha256 === actualExactWorld.archiveSha256 && baselineExactWorld.dataContractSha256 === actualExactWorld.dataContractSha256 && baselineExactWorld.contractSha256 === actualExactWorld.contractSha256 && sameOptionalSemantics(baselineExactWorld.semantics, actualExactWorld.semantics);
-  }
-  const baselineLegacy = baseline;
-  const actualLegacy = actual;
-  if (baselineLegacy.generation !== actualLegacy.generation || baselineLegacy.revision !== actualLegacy.revision || !sameOptionalSemantics(baselineLegacy.semantics, actualLegacy.semantics)) {
-    return false;
-  }
-  if (baselineLegacy.source && (!actualLegacy.source || baselineLegacy.source.kind !== actualLegacy.source.kind || baselineLegacy.source.sha256 !== actualLegacy.source.sha256)) {
-    return false;
-  }
-  if (baselineLegacy.capabilities && (!actualLegacy.capabilities || !isRecordSubset(baselineLegacy.capabilities, actualLegacy.capabilities))) {
-    return false;
-  }
-  if (baselineLegacy.bindings) {
-    if (!actualLegacy.bindings) return false;
-    if (!isRecordSubset(baselineLegacy.bindings.fields, actualLegacy.bindings.fields) || !isRecordSubset(baselineLegacy.bindings.layers, actualLegacy.bindings.layers)) {
-      return false;
-    }
-  }
-  return true;
-}
-function exactWorldIdentity(value) {
-  return value.kind === "tileflow-world" && "product" in value ? value : void 0;
-}
-function sameOptionalSemantics(baseline, actual) {
-  return baseline === void 0 || baseline.parkLayer === actual?.parkLayer;
-}
-function isRecordSubset(baseline, actual) {
-  return Object.entries(baseline).every(([key, value]) => actual[key] === value);
+  return baseline.scene.name === actual.scene.name && baseline.scene.map === actual.scene.map && baseline.scene.theme === actual.scene.theme && baseline.scene.target === actual.scene.target && baseline.scene.sha256 === actual.scene.sha256 && serializeCanonicalJson2(baseline.data) === serializeCanonicalJson2(actual.data);
 }
 function sameRuntimeIdentity(baseline, actual) {
   return baseline.renderer.tileflow === actual.renderer.tileflow && baseline.renderer.maplibre === actual.renderer.maplibre && baseline.renderer.playwright === actual.renderer.playwright && baseline.renderer.chromiumRevision === actual.renderer.chromiumRevision && baseline.renderer.chromiumVersion === actual.renderer.chromiumVersion && baseline.platform.os === actual.platform.os && baseline.platform.architecture === actual.platform.architecture;
@@ -3103,9 +3097,6 @@ async function validateReviewCapture(input, role) {
     throw invalidReview(`The ${role} capture receipt is invalid.`, error);
   }
   const receipt = parsedReceipt;
-  if (receipt.schemaVersion !== 4) {
-    throw invalidReview(`The ${role} review capture requires a schema-v4 receipt.`);
-  }
   if (definition.map !== receipt.scene.map || definition.theme !== receipt.scene.theme || definition.target.kind !== receipt.scene.target) {
     throw invalidReview(`The ${role} review identity does not match its capture receipt.`);
   }

package/dist/receipt-DhFOATRO.d.ts

@@ -0,0 +1,131 @@
+import { Browser } from 'playwright';
+
+type TileflowCaptureRendererIdentity = {
+    tileflow: string;
+    maplibre: string;
+    playwright: string;
+    chromiumRevision: string;
+    chromiumVersion: string;
+};
+declare const tileflowCaptureRuntime: Readonly<{
+    tileflow: string;
+    maplibre: string;
+    playwright: string;
+    chromiumRevision: string;
+    chromiumVersion: string;
+}>;
+declare function createTileflowCaptureRendererIdentity(browser?: Pick<Browser, 'version'>): TileflowCaptureRendererIdentity;
+
+declare const tileflowCaptureReceiptSchemaVersion: 4;
+declare const tileflowCaptureReceiptLimits: Readonly<{
+    maximumBytes: number;
+}>;
+type TileflowCaptureDataBindings = {
+    fields: Record<string, string>;
+    layers: Record<string, string>;
+};
+type TileflowCaptureDataCapabilities = {
+    businessCorridor: boolean;
+    bathymetry: boolean;
+    canopy: boolean;
+    globalLandcover: boolean;
+    tree: boolean;
+};
+type TileflowCaptureDataSource = {
+    kind: 'loopback' | 'opaque' | 'remote' | 'root-relative';
+    /** SHA-256 of a credential-free, query-free endpoint identity. */
+    sha256: string;
+};
+type TileflowCaptureDataSemantics = {
+    parkLayer: 'mixed' | 'protected-only';
+};
+/** Exact Tileflow World release identity. */
+type TileflowCaptureWorldIdentity = {
+    archiveSha256: string;
+    contractSha256: string;
+    dataContractSha256: string;
+    descriptorSha256: string;
+    kind: 'tileflow-world';
+    product: 'world-v1';
+    releaseId: string;
+    schema: 'openmaptiles';
+    schemaVersion: number;
+    semantics: TileflowCaptureDataSemantics;
+    sourceId: 'tileflow';
+};
+/** External vector-tile identity. Its endpoint is recorded only as a safe fingerprint. */
+type TileflowCaptureVectorIdentity = {
+    bindings: TileflowCaptureDataBindings;
+    capabilities: TileflowCaptureDataCapabilities;
+    kind: 'vector-tiles';
+    /** Explicit revision supplied by the data configuration. */
+    revision?: string;
+    schema: 'openmaptiles';
+    schemaVersion: number;
+    semantics: TileflowCaptureDataSemantics;
+    source: TileflowCaptureDataSource;
+    sourceId: 'tileflow';
+};
+/** Durable data identity owned by capture rather than the live core authoring API. */
+type TileflowCaptureDataIdentity = TileflowCaptureVectorIdentity | TileflowCaptureWorldIdentity;
+/**
+ * Data identity accepted by `createTileflowCaptureReceipt`. A vector `url` is transient input:
+ * it is converted to `source` and never returned or serialized.
+ */
+type TileflowCaptureDataInput = (Omit<TileflowCaptureVectorIdentity, 'source'> & {
+    url: string;
+}) | TileflowCaptureWorldIdentity;
+type TileflowCaptureVerification = {
+    data: 'expected-unverified' | 'rendered';
+    style: 'expected-unverified' | 'rendered';
+};
+type TileflowCaptureReceipt = {
+    schemaVersion: typeof tileflowCaptureReceiptSchemaVersion;
+    scene: {
+        name: string;
+        map: string;
+        theme: string;
+        target: 'map' | 'application';
+        sha256: string;
+    };
+    style: {
+        sha256: string;
+    };
+    image: {
+        sha256: string;
+        cssWidth: number;
+        cssHeight: number;
+        physicalWidth: number;
+        physicalHeight: number;
+        dpr: 1 | 2;
+    };
+    renderer: TileflowCaptureRendererIdentity;
+    platform: {
+        os: string;
+        architecture: string;
+    };
+    data: TileflowCaptureDataIdentity;
+    verification: TileflowCaptureVerification;
+    networkDependent: boolean;
+};
+type CreateTileflowCaptureReceiptInput = {
+    dpr: 1 | 2;
+    data: TileflowCaptureDataInput;
+    height: number;
+    map: string;
+    theme: string;
+    networkDependent: boolean;
+    pngSha256: string;
+    renderer: TileflowCaptureRendererIdentity;
+    scene: string;
+    sceneSha256: string;
+    styleSha256: string;
+    target: 'map' | 'application';
+    width: number;
+};
+declare function createTileflowCaptureReceipt(input: CreateTileflowCaptureReceiptInput): TileflowCaptureReceipt;
+declare function serializeTileflowCaptureReceipt(receipt: TileflowCaptureReceipt): string;
+declare function parseTileflowCaptureReceipt(source: string | Uint8Array): TileflowCaptureReceipt;
+declare function validateTileflowCaptureReceipt(value: unknown): TileflowCaptureReceipt;
+
+export { type CreateTileflowCaptureReceiptInput as C, type TileflowCaptureRendererIdentity as T, type TileflowCaptureReceipt as a, type TileflowCaptureDataInput as b, type TileflowCaptureWorldIdentity as c, type TileflowCaptureDataBindings as d, type TileflowCaptureDataCapabilities as e, type TileflowCaptureDataIdentity as f, type TileflowCaptureDataSemantics as g, type TileflowCaptureDataSource as h, type TileflowCaptureVectorIdentity as i, type TileflowCaptureVerification as j, createTileflowCaptureReceipt as k, createTileflowCaptureRendererIdentity as l, tileflowCaptureReceiptSchemaVersion as m, tileflowCaptureRuntime as n, parseTileflowCaptureReceipt as p, serializeTileflowCaptureReceipt as s, tileflowCaptureReceiptLimits as t, validateTileflowCaptureReceipt as v };

package/dist/receipt.d.ts

@@ -1,2 +1,2 @@
-export { C as CreateTileflowCaptureReceiptInput, e as TileflowCaptureDataBindingsV2, f as TileflowCaptureDataCapabilitiesV2, g as TileflowCaptureDataIdentityV2, h as TileflowCaptureDataIdentityV3, b as TileflowCaptureDataInput, i as TileflowCaptureDataSemanticsV2, j as TileflowCaptureDataSourceV2, d as TileflowCaptureReceipt, k as TileflowCaptureReceiptV2, l as TileflowCaptureReceiptV3, a as TileflowCaptureReceiptV4, m as TileflowCaptureVectorIdentityV3, n as TileflowCaptureVerificationV2, c as TileflowCaptureWorldIdentityV3, o as createTileflowCaptureReceipt, q as parseTileflowCaptureReceipt, s as serializeTileflowCaptureReceipt, t as tileflowCaptureReceiptLimits, r as tileflowCaptureReceiptSchemaVersion, v as validateTileflowCaptureReceipt } from './receipt-Q7wQ68tG.js';
+export { C as CreateTileflowCaptureReceiptInput, d as TileflowCaptureDataBindings, e as TileflowCaptureDataCapabilities, f as TileflowCaptureDataIdentity, b as TileflowCaptureDataInput, g as TileflowCaptureDataSemantics, h as TileflowCaptureDataSource, a as TileflowCaptureReceipt, i as TileflowCaptureVectorIdentity, j as TileflowCaptureVerification, c as TileflowCaptureWorldIdentity, k as createTileflowCaptureReceipt, p as parseTileflowCaptureReceipt, s as serializeTileflowCaptureReceipt, t as tileflowCaptureReceiptLimits, m as tileflowCaptureReceiptSchemaVersion, v as validateTileflowCaptureReceipt } from './receipt-DhFOATRO.js';
 import 'playwright';

package/dist/receipt.js

@@ -5,7 +5,7 @@ import {
   tileflowCaptureReceiptLimits,
   tileflowCaptureReceiptSchemaVersion,
   validateTileflowCaptureReceipt
-} from "./chunk-BSTB4FN6.js";
+} from "./chunk-VNDAYGXY.js";
 export {
   createTileflowCaptureReceipt,
   parseTileflowCaptureReceipt,

package/docs/receipts-and-comparison.md

@@ -15,8 +15,7 @@ For Tileflow World, Capture resolves the map's TileJSON selector once per sessio
 `tileflow.world` to identify `world-v1` with exact release, descriptor, archive, data-contract, and
 product-contract SHA-256 values, and renders every standalone scene from the returned immutable tile
 template. Repeated scenes and retries reuse that one resolution; another selector in the same
-session fails instead of mixing releases. Existing canonical schema-v2 and schema-v3 receipts remain
-readable as historical evidence and are never reclassified as schema v4.
+session fails instead of mixing releases. Parsing accepts only schema version 4.
 
 Capture reuses Core's exact World V1 release-ID contract: 12–128 characters matching
 `^world-v1-[a-z0-9][a-z0-9._-]*[a-z0-9]$`. Selector responses and durable receipts reject rather

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tileflow/capture",
-  "version": "0.1.0-alpha.27",
+  "version": "0.1.0-alpha.29",
   "license": "Apache-2.0",
   "description": "Deterministic local visual capture and comparison for Tileflow maps.",
   "engines": {
@@ -48,9 +48,9 @@
     "access": "public"
   },
   "dependencies": {
-    "@tileflow/core": ">=0.1.0-alpha.29 <0.1.0-beta.0",
-    "@tileflow/dev": ">=0.1.0-alpha.27 <0.1.0-beta.0",
-    "maplibre-gl": "6.9.0",
+    "@tileflow/core": ">=0.1.0-alpha.32 <0.1.0-beta.0",
+    "@tileflow/dev": ">=0.1.0-alpha.30 <0.1.0-beta.0",
+    "maplibre-gl": "6.13.0",
     "pixelmatch": "7.2.0",
     "playwright": "1.62.1",
     "pngjs": "7.0.0"
@@ -61,20 +61,20 @@
     "@types/pngjs": "6.0.5",
     "@vitejs/plugin-vue": "^6.0.8",
     "maplibre-gl-min": "npm:maplibre-gl@6.4.1",
-    "next": "16.3.3",
-    "react": "^19.2.7",
-    "react-dom": "^19.2.7",
-    "svelte": "^5.56.4",
+    "next": "16.3.8",
+    "react": "^19.3.0",
+    "react-dom": "^19.3.0",
+    "svelte": "^5.57.2",
     "vite": "^8.0.16",
-    "vue": "^3.5.39",
+    "vue": "^3.5.43",
     "webpack": "5.108.3",
-    "@tileflow/maps": "0.1.0-alpha.6",
-    "@tileflow/next": "0.1.0-alpha.24",
-    "@tileflow/react": "0.1.0-alpha.27",
-    "@tileflow/vite": "0.1.0-alpha.24",
-    "@tileflow/svelte": "0.1.0-alpha.26",
-    "@tileflow/vue": "0.1.0-alpha.26",
-    "@tileflow/webpack": "0.1.0-alpha.24"
+    "@tileflow/maps": "0.1.0-alpha.8",
+    "@tileflow/next": "0.1.0-alpha.25",
+    "@tileflow/vue": "0.1.0-alpha.28",
+    "@tileflow/svelte": "0.1.0-alpha.28",
+    "@tileflow/vite": "0.1.0-alpha.25",
+    "@tileflow/react": "0.1.0-alpha.29",
+    "@tileflow/webpack": "0.1.0-alpha.25"
   },
   "scripts": {
     "build": "tsup src/index.ts src/receipt.ts --format esm --dts --clean --platform node",

package/dist/receipt-Q7wQ68tG.d.ts

@@ -1,160 +0,0 @@
-import { Browser } from 'playwright';
-
-type TileflowCaptureRendererIdentity = {
-    tileflow: string;
-    maplibre: string;
-    playwright: string;
-    chromiumRevision: string;
-    chromiumVersion: string;
-};
-declare const tileflowCaptureRuntime: Readonly<{
-    tileflow: string;
-    maplibre: string;
-    playwright: string;
-    chromiumRevision: string;
-    chromiumVersion: string;
-}>;
-declare function createTileflowCaptureRendererIdentity(browser?: Pick<Browser, 'version'>): TileflowCaptureRendererIdentity;
-
-declare const tileflowCaptureReceiptSchemaVersion: 4;
-declare const tileflowCaptureReceiptLimits: Readonly<{
-    maximumBytes: number;
-}>;
-type TileflowCaptureDataBindingsV2 = {
-    fields: Record<string, string>;
-    layers: Record<string, string>;
-};
-type TileflowCaptureDataCapabilitiesV2 = {
-    businessCorridor: boolean;
-    /** Optional because receipts written before this capability existed remain valid schema v2. */
-    bathymetry?: boolean;
-    globalLandcover: boolean;
-    tree: boolean;
-};
-type TileflowCaptureDataSourceV2 = {
-    kind: 'loopback' | 'opaque' | 'remote' | 'root-relative';
-    /** SHA-256 of a credential-free, query-free endpoint identity. */
-    sha256: string;
-};
-type TileflowCaptureDataSemanticsV2 = {
-    parkLayer: 'mixed' | 'protected-only';
-};
-/** Durable schema-v2 data identity owned by capture rather than the live core authoring API. */
-type TileflowCaptureDataIdentityV2 = {
-    bindings?: TileflowCaptureDataBindingsV2;
-    capabilities?: TileflowCaptureDataCapabilitiesV2;
-    generation?: 'v1';
-    kind: 'tileflow-world' | 'vector-tiles';
-    revision?: string;
-    schema: 'openmaptiles';
-    schemaVersion: number;
-    /** Optional because earlier schema-v2 receipts predate explicit park semantics. */
-    semantics?: TileflowCaptureDataSemanticsV2;
-    sourceId: 'tileflow';
-    source?: TileflowCaptureDataSourceV2;
-};
-type TileflowCaptureWorldIdentityV3 = {
-    archiveSha256: string;
-    contractSha256: string;
-    dataContractSha256: string;
-    descriptorSha256: string;
-    kind: 'tileflow-world';
-    product: 'world-v1';
-    releaseId: string;
-    schema: 'openmaptiles';
-    schemaVersion: number;
-    semantics?: TileflowCaptureDataSemanticsV2;
-    sourceId: 'tileflow';
-};
-type TileflowCaptureVectorIdentityV3 = {
-    bindings?: {
-        fields: Readonly<Record<string, string>>;
-        layers: Readonly<Record<string, string>>;
-    };
-    capabilities?: {
-        businessCorridor: boolean;
-        bathymetry?: boolean;
-        globalLandcover: boolean;
-        tree: boolean;
-    };
-    kind: 'vector-tiles';
-    revision?: string;
-    schema: 'openmaptiles';
-    schemaVersion: number;
-    semantics?: TileflowCaptureDataSemanticsV2;
-    sourceId: 'tileflow';
-    /** Accepted only as transient input and converted to `source`; never returned or serialized. */
-    url?: string;
-};
-/** Exact data-identity input embedded in every newly written schema-v4 receipt. */
-type TileflowCaptureDataInput = TileflowCaptureVectorIdentityV3 | TileflowCaptureWorldIdentityV3;
-type TileflowCaptureDataIdentityV3 = (Omit<TileflowCaptureVectorIdentityV3, 'url'> & {
-    source?: TileflowCaptureDataSourceV2;
-}) | TileflowCaptureWorldIdentityV3;
-type TileflowCaptureVerificationV2 = {
-    data: 'expected-unverified' | 'rendered';
-    style: 'expected-unverified' | 'rendered';
-};
-type TileflowCaptureReceiptCommon = {
-    scene: {
-        name: string;
-        map: string;
-        target: 'map' | 'application';
-        sha256: string;
-    };
-    style: {
-        sha256: string;
-    };
-    image: {
-        sha256: string;
-        cssWidth: number;
-        cssHeight: number;
-        physicalWidth: number;
-        physicalHeight: number;
-        dpr: 1 | 2;
-    };
-    renderer: TileflowCaptureRendererIdentity;
-    platform: {
-        os: string;
-        architecture: string;
-    };
-    verification: TileflowCaptureVerificationV2;
-    networkDependent: boolean;
-};
-type TileflowCaptureReceiptV2 = TileflowCaptureReceiptCommon & {
-    schemaVersion: 2;
-    data: TileflowCaptureDataIdentityV2;
-};
-type TileflowCaptureReceiptV3 = TileflowCaptureReceiptCommon & {
-    schemaVersion: 3;
-    data: TileflowCaptureDataIdentityV3;
-};
-type TileflowCaptureReceiptV4 = Omit<TileflowCaptureReceiptCommon, 'scene'> & {
-    schemaVersion: 4;
-    data: TileflowCaptureDataIdentityV3;
-    scene: TileflowCaptureReceiptCommon['scene'] & {
-        theme: string;
-    };
-};
-type TileflowCaptureReceipt = TileflowCaptureReceiptV2 | TileflowCaptureReceiptV3 | TileflowCaptureReceiptV4;
-type CreateTileflowCaptureReceiptInput = {
-    dpr: 1 | 2;
-    data: TileflowCaptureDataInput;
-    height: number;
-    map: string;
-    theme: string;
-    networkDependent: boolean;
-    pngSha256: string;
-    renderer: TileflowCaptureRendererIdentity;
-    scene: string;
-    sceneSha256: string;
-    styleSha256: string;
-    target: 'map' | 'application';
-    width: number;
-};
-declare function createTileflowCaptureReceipt(input: CreateTileflowCaptureReceiptInput): TileflowCaptureReceiptV4;
-declare function serializeTileflowCaptureReceipt(receipt: TileflowCaptureReceipt): string;
-declare function parseTileflowCaptureReceipt(source: string | Uint8Array): TileflowCaptureReceipt;
-declare function validateTileflowCaptureReceipt(value: unknown): TileflowCaptureReceipt;
-
-export { type CreateTileflowCaptureReceiptInput as C, type TileflowCaptureRendererIdentity as T, type TileflowCaptureReceiptV4 as a, type TileflowCaptureDataInput as b, type TileflowCaptureWorldIdentityV3 as c, type TileflowCaptureReceipt as d, type TileflowCaptureDataBindingsV2 as e, type TileflowCaptureDataCapabilitiesV2 as f, type TileflowCaptureDataIdentityV2 as g, type TileflowCaptureDataIdentityV3 as h, type TileflowCaptureDataSemanticsV2 as i, type TileflowCaptureDataSourceV2 as j, type TileflowCaptureReceiptV2 as k, type TileflowCaptureReceiptV3 as l, type TileflowCaptureVectorIdentityV3 as m, type TileflowCaptureVerificationV2 as n, createTileflowCaptureReceipt as o, createTileflowCaptureRendererIdentity as p, parseTileflowCaptureReceipt as q, tileflowCaptureReceiptSchemaVersion as r, serializeTileflowCaptureReceipt as s, tileflowCaptureReceiptLimits as t, tileflowCaptureRuntime as u, validateTileflowCaptureReceipt as v };