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

package/dist/{receipt-DhFOATRO.d.ts → receipt-CfZkzyXd.d.ts}

@@ -127,5 +127,96 @@ declare function createTileflowCaptureReceipt(input: CreateTileflowCaptureReceip
 declare function serializeTileflowCaptureReceipt(receipt: TileflowCaptureReceipt): string;
 declare function parseTileflowCaptureReceipt(source: string | Uint8Array): TileflowCaptureReceipt;
 declare function validateTileflowCaptureReceipt(value: unknown): TileflowCaptureReceipt;
+declare const tileflowShotReceiptSchemaVersion: 1;
+declare const tileflowShotReceiptLimits: Readonly<{
+    maximumBytes: number;
+}>;
+/**
+ * Durable evidence for one rendered shot. Frames are deterministic, so `frames.sha256` identifies
+ * the pixels; `output.sha256` identifies the written video or frame set, whose encoder bytes may
+ * differ between runs.
+ */
+type TileflowShotReceiptV1 = {
+    schemaVersion: 1;
+    kind: 'shot';
+    shot: {
+        name: string;
+        map: string;
+        theme: string;
+        sha256: string;
+    };
+    /** The compiled style of the shot's theme. */
+    style: {
+        sha256: string;
+    };
+    /** Present when the shot blends themes: each blended theme's compiled style, in blend order. */
+    blend?: {
+        themes: Array<{
+            name: string;
+            styleSha256: string;
+        }>;
+    };
+    timing: {
+        fps: 24 | 25 | 30 | 50 | 60;
+        frameCount: number;
+        durationMs: number;
+    };
+    image: {
+        cssWidth: number;
+        cssHeight: number;
+        physicalWidth: number;
+        physicalHeight: number;
+        dpr: 1 | 2;
+    };
+    /** SHA-256 of each frame's PNG SHA-256 in lowercase hex, one per line, in frame order. */
+    frames: {
+        sha256: string;
+    };
+    output: {
+        kind: 'frames';
+        sha256: string;
+    } | {
+        kind: 'webm';
+        codec: 'vp8' | 'vp9';
+        sha256: string;
+    };
+    renderer: TileflowCaptureRendererIdentity;
+    platform: {
+        os: string;
+        architecture: string;
+    };
+    data: TileflowCaptureDataIdentity;
+    verification: {
+        data: 'rendered';
+        style: 'rendered';
+    };
+    networkDependent: boolean;
+};
+type CreateTileflowShotReceiptInput = {
+    blend?: Array<{
+        name: string;
+        styleSha256: string;
+    }>;
+    data: TileflowCaptureDataInput;
+    dpr: 1 | 2;
+    durationMs: number;
+    fps: 24 | 25 | 30 | 50 | 60;
+    frameCount: number;
+    framesSha256: string;
+    height: number;
+    map: string;
+    networkDependent: boolean;
+    output: TileflowShotReceiptV1['output'];
+    renderer: TileflowCaptureRendererIdentity;
+    shot: string;
+    shotSha256: string;
+    styleSha256: string;
+    theme: string;
+    width: number;
+};
+declare function createTileflowShotReceipt(input: CreateTileflowShotReceiptInput): TileflowShotReceiptV1;
+declare function serializeTileflowShotReceipt(receipt: TileflowShotReceiptV1): string;
+declare function parseTileflowShotReceipt(source: string | Uint8Array): TileflowShotReceiptV1;
+declare function validateTileflowShotReceipt(value: unknown): TileflowShotReceiptV1;
 
-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 };
+export { type CreateTileflowCaptureReceiptInput as C, type TileflowCaptureRendererIdentity as T, type TileflowShotReceiptV1 as a, type TileflowCaptureReceipt as b, type TileflowCaptureDataInput as c, type TileflowCaptureWorldIdentity as d, type CreateTileflowShotReceiptInput as e, type TileflowCaptureDataBindings as f, type TileflowCaptureDataCapabilities as g, type TileflowCaptureDataIdentity as h, type TileflowCaptureDataSemantics as i, type TileflowCaptureDataSource as j, type TileflowCaptureVectorIdentity as k, type TileflowCaptureVerification as l, createTileflowCaptureReceipt as m, createTileflowCaptureRendererIdentity as n, createTileflowShotReceipt as o, parseTileflowCaptureReceipt as p, parseTileflowShotReceipt as q, serializeTileflowShotReceipt as r, serializeTileflowCaptureReceipt as s, tileflowCaptureReceiptLimits as t, tileflowCaptureReceiptSchemaVersion as u, tileflowCaptureRuntime as v, tileflowShotReceiptLimits as w, tileflowShotReceiptSchemaVersion as x, validateTileflowCaptureReceipt as y, validateTileflowShotReceipt as z };

package/dist/receipt.d.ts

@@ -1,2 +1,2 @@
-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';
+export { C as CreateTileflowCaptureReceiptInput, e as CreateTileflowShotReceiptInput, f as TileflowCaptureDataBindings, g as TileflowCaptureDataCapabilities, h as TileflowCaptureDataIdentity, c as TileflowCaptureDataInput, i as TileflowCaptureDataSemantics, j as TileflowCaptureDataSource, b as TileflowCaptureReceipt, k as TileflowCaptureVectorIdentity, l as TileflowCaptureVerification, d as TileflowCaptureWorldIdentity, a as TileflowShotReceiptV1, m as createTileflowCaptureReceipt, o as createTileflowShotReceipt, p as parseTileflowCaptureReceipt, q as parseTileflowShotReceipt, s as serializeTileflowCaptureReceipt, r as serializeTileflowShotReceipt, t as tileflowCaptureReceiptLimits, u as tileflowCaptureReceiptSchemaVersion, w as tileflowShotReceiptLimits, x as tileflowShotReceiptSchemaVersion, y as validateTileflowCaptureReceipt, z as validateTileflowShotReceipt } from './receipt-CfZkzyXd.js';
 import 'playwright';

package/dist/receipt.js

@@ -1,16 +1,28 @@
 import {
   createTileflowCaptureReceipt,
+  createTileflowShotReceipt,
   parseTileflowCaptureReceipt,
+  parseTileflowShotReceipt,
   serializeTileflowCaptureReceipt,
+  serializeTileflowShotReceipt,
   tileflowCaptureReceiptLimits,
   tileflowCaptureReceiptSchemaVersion,
-  validateTileflowCaptureReceipt
-} from "./chunk-VNDAYGXY.js";
+  tileflowShotReceiptLimits,
+  tileflowShotReceiptSchemaVersion,
+  validateTileflowCaptureReceipt,
+  validateTileflowShotReceipt
+} from "./chunk-BI5PWIH4.js";
 export {
   createTileflowCaptureReceipt,
+  createTileflowShotReceipt,
   parseTileflowCaptureReceipt,
+  parseTileflowShotReceipt,
   serializeTileflowCaptureReceipt,
+  serializeTileflowShotReceipt,
   tileflowCaptureReceiptLimits,
   tileflowCaptureReceiptSchemaVersion,
-  validateTileflowCaptureReceipt
+  tileflowShotReceiptLimits,
+  tileflowShotReceiptSchemaVersion,
+  validateTileflowCaptureReceipt,
+  validateTileflowShotReceipt
 };

package/docs/receipts-and-comparison.md

@@ -24,6 +24,14 @@ than normalize uppercase, whitespace, another generation, or an incomplete bound
 Receipt-only tooling can import these contracts from `@tileflow/capture/receipt` without loading the
 Playwright capture runtime.
 
+`createTileflowShotReceipt`, `parseTileflowShotReceipt`, `validateTileflowShotReceipt`, and
+`serializeTileflowShotReceipt` implement the separate schema-version-1 shot receipt, identified by
+`kind: "shot"` and bounded to 64 KiB. It records the shot and its theme and blend styles, timing,
+dimensions, renderer, platform, data identity, and two hashes: `frames.sha256`, computed from every
+frame's PNG SHA-256 in order, identifies the rendered pixels, and `output.sha256` identifies the
+written WebM file or, for the `frames` output, equals `frames.sha256`. The still-receipt parser
+rejects shot receipts, and the shot-receipt parser rejects still receipts.
+
 The following comparison fragments assume captures and PNG/receipt bytes that the caller has
 already loaded and validated. See the package README for a complete baseline-file example.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tileflow/capture",
-  "version": "0.1.0-alpha.29",
+  "version": "0.1.0-alpha.31",
   "license": "Apache-2.0",
   "description": "Deterministic local visual capture and comparison for Tileflow maps.",
   "engines": {
@@ -48,8 +48,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@tileflow/core": ">=0.1.0-alpha.32 <0.1.0-beta.0",
-    "@tileflow/dev": ">=0.1.0-alpha.30 <0.1.0-beta.0",
+    "@tileflow/core": ">=0.1.0-alpha.35 <0.1.0-beta.0",
+    "@tileflow/dev": ">=0.1.0-alpha.32 <0.1.0-beta.0",
     "maplibre-gl": "6.13.0",
     "pixelmatch": "7.2.0",
     "playwright": "1.62.1",
@@ -68,12 +68,12 @@
     "vite": "^8.0.16",
     "vue": "^3.5.43",
     "webpack": "5.108.3",
-    "@tileflow/maps": "0.1.0-alpha.8",
+    "@tileflow/react": "0.1.0-alpha.30",
     "@tileflow/next": "0.1.0-alpha.25",
-    "@tileflow/vue": "0.1.0-alpha.28",
-    "@tileflow/svelte": "0.1.0-alpha.28",
+    "@tileflow/svelte": "0.1.0-alpha.29",
+    "@tileflow/maps": "0.1.0-alpha.9",
+    "@tileflow/vue": "0.1.0-alpha.29",
     "@tileflow/vite": "0.1.0-alpha.25",
-    "@tileflow/react": "0.1.0-alpha.29",
     "@tileflow/webpack": "0.1.0-alpha.25"
   },
   "scripts": {