@tileflow/capture 0.1.0-alpha.16 → 0.1.0-alpha.17

package/README.md

@@ -85,8 +85,8 @@ cost in advance or verify prepared CI, not as a prerequisite for normal capture.
 
 `createTileflowCaptureReceipt`, `parseTileflowCaptureReceipt`,
 `validateTileflowCaptureReceipt`, and `serializeTileflowCaptureReceipt` implement the strict,
-bounded schema-version-1 receipt contract. A receipt contains image/scene/style hashes, dimensions,
-renderer/platform identity, required nullable `source.tilesetVersion` evidence, and
+bounded schema-version-2 receipt contract. A receipt contains image/scene/style hashes, dimensions,
+renderer/platform identity, the required resolved `data` identity, and
 remote-dependency state; it contains no time, user, origin,
 repository, absolute path, config source, environment, or credential.
 

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { Browser } from 'playwright';
-import { TileflowCaptureScene } from '@tileflow/core';
+import { TileflowDataIdentity, TileflowCaptureScene } from '@tileflow/core';
 import { TileflowBuildArtifacts } from '@tileflow/dev';
 
 type TileflowCaptureRendererIdentity = {
@@ -38,12 +38,12 @@ declare class TileflowCaptureBrowserManager {
     close(): Promise<void>;
 }
 
-declare const tileflowCaptureReceiptSchemaVersion: 1;
+declare const tileflowCaptureReceiptSchemaVersion: 2;
 declare const tileflowCaptureReceiptLimits: Readonly<{
     maximumBytes: number;
 }>;
 type TileflowCaptureReceipt = {
-    schemaVersion: 1;
+    schemaVersion: 2;
     scene: {
         name: string;
         map: string;
@@ -66,13 +66,12 @@ type TileflowCaptureReceipt = {
         os: string;
         architecture: string;
     };
-    source: {
-        tilesetVersion: string | null;
-    };
+    data: TileflowDataIdentity;
     networkDependent: boolean;
 };
 type CreateTileflowCaptureReceiptInput = {
     dpr: 1 | 2;
+    data: TileflowDataIdentity;
     height: number;
     map: string;
     networkDependent: boolean;
@@ -81,7 +80,6 @@ type CreateTileflowCaptureReceiptInput = {
     scene: string;
     sceneSha256: string;
     styleSha256: string;
-    sourceVersion?: string;
     target: 'map' | 'application';
     width: number;
 };

package/dist/index.js

@@ -1206,7 +1206,7 @@ import {
   tileflowCaptureSceneLimits as tileflowCaptureSceneLimits2,
   tileflowCaptureSceneNameSchema
 } from "@tileflow/core";
-var tileflowCaptureReceiptSchemaVersion = 1;
+var tileflowCaptureReceiptSchemaVersion = 2;
 var tileflowCaptureReceiptLimits = Object.freeze({ maximumBytes: 64 * 1024 });
 function createTileflowCaptureReceipt(input) {
   return validateTileflowCaptureReceipt({
@@ -1228,7 +1228,7 @@ function createTileflowCaptureReceipt(input) {
     },
     renderer: input.renderer,
     platform: { os: process.platform, architecture: process.arch },
-    source: { tilesetVersion: input.sourceVersion ?? null },
+    data: input.data,
     networkDependent: input.networkDependent
   });
 }
@@ -1264,7 +1264,7 @@ function validateTileflowCaptureReceipt(value) {
     "image",
     "renderer",
     "platform",
-    "source",
+    "data",
     "networkDependent"
   ];
   if (receipt.schemaVersion !== tileflowCaptureReceiptSchemaVersion) {
@@ -1315,8 +1315,20 @@ function validateTileflowCaptureReceipt(value) {
   if (typeof receipt.networkDependent !== "boolean") {
     throw invalidReceipt("The baseline receipt has an invalid network dependency flag.");
   }
-  const source = requireRecord(receipt.source, "source");
-  requireExactKeys(source, ["tilesetVersion"]);
+  const data = requireRecord(receipt.data, "data");
+  requireExactKeys(data, [
+    "kind",
+    ...data.revision === void 0 ? [] : ["revision"],
+    "schema",
+    "schemaVersion",
+    "sourceId"
+  ]);
+  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.");
+  }
   return {
     schemaVersion: tileflowCaptureReceiptSchemaVersion,
     scene: {
@@ -1348,7 +1360,13 @@ function validateTileflowCaptureReceipt(value) {
       os: requireBoundedString(platform.os, "platform.os"),
       architecture: requireBoundedString(platform.architecture, "platform.architecture")
     },
-    source: { tilesetVersion: requireNullableSourceVersion(source.tilesetVersion) },
+    data: {
+      kind: data.kind,
+      ...data.revision === void 0 ? {} : { revision: requireSourceRevision(data.revision) },
+      schema: data.schema,
+      schemaVersion: requirePositiveInteger(data.schemaVersion, "data.schemaVersion"),
+      sourceId: data.sourceId
+    },
     networkDependent: receipt.networkDependent
   };
 }
@@ -1399,10 +1417,9 @@ function requireBoundedString(value, field) {
   }
   return value;
 }
-function requireNullableSourceVersion(value) {
-  if (value === null) return null;
+function requireSourceRevision(value) {
   if (typeof value !== "string" || !/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/.test(value)) {
-    throw invalidReceipt("The baseline receipt has an invalid source.tilesetVersion.");
+    throw invalidReceipt("The baseline receipt has an invalid data.revision.");
   }
   return value;
 }
@@ -1529,6 +1546,7 @@ var TileflowCaptureSessionImpl = class {
       ]);
       const target = scene.target.kind;
       const receipt = createTileflowCaptureReceipt({
+        data: style.metadata?.["tileflow:data"],
         dpr: scene.viewport.dpr,
         height: rendered.height,
         map: scene.map,
@@ -1538,7 +1556,6 @@ var TileflowCaptureSessionImpl = class {
         scene: sceneName,
         sceneSha256,
         styleSha256,
-        ...typeof style.metadata?.["tileflow:tilesetVersion"] === "string" ? { sourceVersion: style.metadata["tileflow:tilesetVersion"] } : {},
         target,
         width: rendered.width
       });
@@ -2034,7 +2051,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 && baseline.source.tilesetVersion === actual.source.tilesetVersion;
+  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 && serializeCanonicalJson3(baseline.data) === serializeCanonicalJson3(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;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tileflow/capture",
-  "version": "0.1.0-alpha.16",
+  "version": "0.1.0-alpha.17",
   "description": "Deterministic local visual capture and comparison for Tileflow maps.",
   "type": "module",
   "sideEffects": false,
@@ -37,22 +37,22 @@
     "access": "public"
   },
   "dependencies": {
+    "@tileflow/core": ">=0.1.0-alpha.19 <0.1.0-beta.0",
+    "@tileflow/dev": ">=0.1.0-alpha.18 <0.1.0-beta.0",
     "maplibre-gl": "5.24.0",
     "pixelmatch": "7.2.0",
     "playwright": "1.60.0",
-    "pngjs": "7.0.0",
-    "@tileflow/dev": "0.1.0-alpha.16",
-    "@tileflow/core": "0.1.0-alpha.16"
+    "pngjs": "7.0.0"
   },
   "devDependencies": {
     "@types/node": "^25.9.2",
     "@types/pngjs": "6.0.5",
-    "next": "16.2.11",
+    "next": "16.3.0",
     "react": "^19.2.7",
     "react-dom": "^19.2.7",
     "vite": "^8.0.16",
     "webpack": "5.108.3",
-    "@tileflow/react": "0.1.0-alpha.16"
+    "@tileflow/react": "0.1.0-alpha.19"
   },
   "scripts": {
     "build": "tsup src/index.ts --format esm --dts --clean --platform node",