@tileflow/capture 0.1.0-alpha.24 → 0.1.0-alpha.26

package/README.md

@@ -198,7 +198,10 @@ 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
-an immutable release. Remote-dependent rendering is not a guarantee of globally identical pixels
+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.
+Remote-dependent rendering is not a guarantee of globally identical pixels
 across platforms or future runs.
 
 Read the [capture contract](https://github.com/tileflow/tileflow-sdk/blob/main/docs/contracts/local-visual-capture.md)

package/dist/index.d.ts

@@ -2,7 +2,7 @@ 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 { TileflowCaptureScene, MapLibreStyle, NormalizedTileflowCaptureScene } from '@tileflow/core';
-import { TileflowIconResolutionOptions, TileflowBuildArtifacts } from '@tileflow/dev/artifacts';
+import { TileflowIconResolutionOptions, TileflowBuildArtifacts, TileflowBuildAsset } from '@tileflow/dev/artifacts';
 
 type TileflowBrowserInstallProgress = 'installing' | 'installed';
 type TileflowBrowserLaunchOptions = {
@@ -106,6 +106,11 @@ declare class TileflowCaptureError extends Error {
 }
 declare function captureErrorMessage(error: unknown, fallback: string): string;
 
+declare const tileflowSyntheticAssetOrigin = "https://tileflow.local.invalid";
+type TileflowCaptureAsset = TileflowBuildAsset & {
+    url?: string;
+};
+
 declare const tileflowWorldCurrentTileJsonUrl: "https://api.tileflow.dev/tiles/world/tiles.json";
 type FetchTileJson = (input: string, init: {
     cache: 'no-store';
@@ -115,9 +120,11 @@ type FetchTileJson = (input: string, init: {
 type TileflowCaptureResolvedWorldV1 = Readonly<{
     identity: Omit<TileflowCaptureWorldIdentityV3, 'kind' | 'schema' | 'schemaVersion' | 'semantics' | 'sourceId'>;
     tileJsonUrl: string;
+    tileJson: string;
     tiles: readonly [string];
 }>;
 type PreparedTileflowCaptureStyle = Readonly<{
+    assets?: TileflowCaptureAsset[];
     data: TileflowCaptureDataInput;
     style: MapLibreStyle;
 }>;
@@ -135,8 +142,6 @@ declare function resolveTileflowCaptureWorldTileJson(tileJsonUrl: string, option
     signal?: AbortSignal;
 }): Promise<TileflowCaptureResolvedWorldV1>;
 
-declare const tileflowSyntheticAssetOrigin = "https://tileflow.local.invalid";
-
 declare function resolveTileflowApplicationUrl(input: {
     appOrigin?: string;
     appUrl?: string;

package/dist/index.js

@@ -318,7 +318,11 @@ import { createRequire as createRequire2 } from "module";
 import { dirname as dirname2, join as join2 } from "path";
 import { getTileflowStyleFontFaces } from "@tileflow/core/runtime";
 import { assertValidTileflowStyle, TileflowStyleValidationError } from "@tileflow/dev/validation";
+
+// src/assets.ts
 var tileflowSyntheticAssetOrigin = "https://tileflow.local.invalid";
+
+// src/standalone.ts
 var require3 = createRequire2(import.meta.url);
 var mapLibreRuntimePaths = Object.freeze({
   css: require3.resolve("maplibre-gl/dist/maplibre-gl.css"),
@@ -396,6 +400,9 @@ async function captureStandaloneTileflowScene(input) {
     }, timeoutMs);
     timeout.unref?.();
     const assets = new Map(input.assets.map((asset) => [asset.fileName, asset]));
+    const frozenResources = new Map(
+      input.assets.filter((asset) => asset.url !== void 0).map((asset) => [asset.url, asset])
+    );
     const localTilesets = new Map(
       (input.localTilesets ?? []).map((tileset) => [tileset.fileName, tileset])
     );
@@ -414,6 +421,16 @@ async function captureStandaloneTileflowScene(input) {
     };
     await context.route("**/*", async (route) => {
       const url = new URL(route.request().url());
+      const frozenResource = frozenResources.get(url.toString());
+      if (frozenResource) {
+        await route.fulfill({
+          body: typeof frozenResource.source === "string" ? frozenResource.source : Buffer.from(frozenResource.source),
+          contentType: frozenResource.contentType,
+          headers: { "Access-Control-Allow-Origin": "*" },
+          status: 200
+        });
+        return;
+      }
       if (url.origin === mapLibreRuntimeUrls.origin) {
         const runtime = getMapLibreRuntimeResponse(url.pathname, input.scene.viewport);
         if (runtime) {
@@ -887,8 +904,10 @@ window.__tileflowCaptureLoad = async function(input) {
     await loadTileflowFontFaces(input.fontFaces || []);
     window.__tileflowRegisterContourProtocol?.({addProtocol: window.maplibregl.addProtocol});
     window.__tileflowRegisterPmtilesProtocol?.({addProtocol: window.maplibregl.addProtocol});
+    const data = input.style.metadata?.["tileflow:data"];
+    const worldSourceId = data?.kind === "tileflow-world" ? data.sourceId : undefined;
     window.__tileflowCaptureLoopbackSourceIds = Object.entries(input.style.sources || {})
-      .filter(([, source]) => isLoopbackSourceUrl(source?.url))
+      .filter(([sourceId, source]) => sourceId !== worldSourceId && isLoopbackSourceUrl(source?.url))
       .map(([sourceId]) => sourceId);
     const map = new window.maplibregl.Map({
       attributionControl: false,
@@ -1299,6 +1318,7 @@ async function captureApplicationTileflowScene(input) {
     if (termination === "aborted") {
       throw new TileflowCaptureError("ABORTED", "Tileflow capture was aborted.", { cause: error });
     }
+    if (error instanceof TileflowCaptureError && error.code === "APPLICATION_ERROR") throw error;
     if (termination === "timeout") {
       throw new TileflowCaptureError(
         "CAPTURE_TIMEOUT",
@@ -1455,6 +1475,7 @@ function compareCodeUnits2(left, right) {
 }
 
 // src/world.ts
+import { createHash } from "crypto";
 import {
   isTileflowWorldReleaseId,
   tileflowWorldTileJsonUrl
@@ -1486,13 +1507,21 @@ var TileflowCaptureWorldSession = class {
       sourceId: requireLiteral(metadata.sourceId, "tileflow", "sourceId")
     };
     const { tiles: _mutableTiles, url: _mutableUrl, ...sourceWithoutSelector } = source;
+    const tileJsonSha256 = createHash("sha256").update(resolution.tileJson).digest("hex");
+    const fileName = `capture/world/${tileJsonSha256}.json`;
+    const exactSelector = new URL(resolution.tileJsonUrl);
+    exactSelector.searchParams.set("worldReleaseId", resolution.identity.releaseId);
+    exactSelector.searchParams.set("worldDescriptorSha256", resolution.identity.descriptorSha256);
+    const url = exactSelector.toString();
     return {
+      assets: [{ contentType: "application/json", fileName, source: resolution.tileJson, url }],
       data,
       style: {
         ...style,
+        metadata: { ...style.metadata, "tileflow:captureWorldTileJsonSha256": tileJsonSha256 },
         sources: {
           ...style.sources,
-          tileflow: { ...sourceWithoutSelector, tiles: [...resolution.tiles] }
+          tileflow: { ...sourceWithoutSelector, url }
         }
       }
     };
@@ -1579,6 +1608,7 @@ async function resolveTileflowCaptureWorldTileJson(tileJsonUrl, options = {}) {
       releaseId
     },
     tileJsonUrl: normalizedUrl,
+    tileJson: text,
     tiles: [tileTemplate]
   };
 }
@@ -1838,7 +1868,7 @@ var TileflowCaptureSessionImpl = class {
         signal,
         timeoutMs: this.#options.timeoutMs
       }) : await captureStandaloneTileflowScene({
-        assets: artifacts.assets,
+        assets: [...artifacts.assets, ...prepared.assets ?? []],
         browser,
         ...artifacts.localTilesets ? { localTilesets: artifacts.localTilesets } : {},
         scene,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tileflow/capture",
-  "version": "0.1.0-alpha.24",
+  "version": "0.1.0-alpha.26",
   "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.26 <0.1.0-beta.0",
-    "@tileflow/dev": ">=0.1.0-alpha.25 <0.1.0-beta.0",
+    "@tileflow/core": ">=0.1.0-alpha.28 <0.1.0-beta.0",
+    "@tileflow/dev": ">=0.1.0-alpha.26 <0.1.0-beta.0",
     "maplibre-gl": "6.9.0",
     "pixelmatch": "7.2.0",
     "playwright": "1.62.1",
@@ -68,13 +68,13 @@
     "vite": "^8.0.16",
     "vue": "^3.5.39",
     "webpack": "5.108.3",
-    "@tileflow/maps": "0.1.0-alpha.4",
-    "@tileflow/react": "0.1.0-alpha.25",
-    "@tileflow/next": "0.1.0-alpha.23",
-    "@tileflow/svelte": "0.1.0-alpha.24",
-    "@tileflow/vite": "0.1.0-alpha.23",
-    "@tileflow/webpack": "0.1.0-alpha.23",
-    "@tileflow/vue": "0.1.0-alpha.24"
+    "@tileflow/maps": "0.1.0-alpha.5",
+    "@tileflow/next": "0.1.0-alpha.24",
+    "@tileflow/svelte": "0.1.0-alpha.25",
+    "@tileflow/react": "0.1.0-alpha.26",
+    "@tileflow/vite": "0.1.0-alpha.24",
+    "@tileflow/vue": "0.1.0-alpha.25",
+    "@tileflow/webpack": "0.1.0-alpha.24"
   },
   "scripts": {
     "build": "tsup src/index.ts src/receipt.ts --format esm --dts --clean --platform node",