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

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"),
@@ -332,7 +336,8 @@ var tileflowBrowserModule = `${readFileSync2(
   "utf8"
 )}
 globalThis.__tileflowRegisterContourProtocol = registerTileflowContourProtocol;
-globalThis.__tileflowRegisterPmtilesProtocol = registerTileflowPmtilesProtocol;`;
+globalThis.__tileflowRegisterPmtilesProtocol = registerTileflowPmtilesProtocol;
+globalThis.__tileflowAttachAtmosphere = attachTileflowAtmosphere;`;
 async function captureStandaloneTileflowScene(input) {
   if (input.scene.target.kind !== "map") {
     throw new TileflowCaptureError(
@@ -396,6 +401,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 +422,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 +905,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,
@@ -898,6 +918,7 @@ window.__tileflowCaptureLoad = async function(input) {
       style: input.style
     });
     window.__tileflowMap = map;
+    window.__tileflowAttachAtmosphere(map);
     return await waitForMapEvent(map, "load", input.mapEventTimeoutMs);
   } catch (error) {
     return {status: "failed", reason: "error", message: String(error?.message || error || "")};
@@ -1456,6 +1477,7 @@ function compareCodeUnits2(left, right) {
 }
 
 // src/world.ts
+import { createHash } from "crypto";
 import {
   isTileflowWorldReleaseId,
   tileflowWorldTileJsonUrl
@@ -1487,13 +1509,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 }
         }
       }
     };
@@ -1580,6 +1610,7 @@ async function resolveTileflowCaptureWorldTileJson(tileJsonUrl, options = {}) {
       releaseId
     },
     tileJsonUrl: normalizedUrl,
+    tileJson: text,
     tiles: [tileTemplate]
   };
 }
@@ -1839,7 +1870,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.25",
+  "version": "0.1.0-alpha.27",
   "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.27 <0.1.0-beta.0",
-    "@tileflow/dev": ">=0.1.0-alpha.26 <0.1.0-beta.0",
+    "@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",
     "pixelmatch": "7.2.0",
     "playwright": "1.62.1",
@@ -68,12 +68,12 @@
     "vite": "^8.0.16",
     "vue": "^3.5.39",
     "webpack": "5.108.3",
+    "@tileflow/maps": "0.1.0-alpha.6",
     "@tileflow/next": "0.1.0-alpha.24",
-    "@tileflow/react": "0.1.0-alpha.26",
-    "@tileflow/svelte": "0.1.0-alpha.25",
-    "@tileflow/maps": "0.1.0-alpha.5",
+    "@tileflow/react": "0.1.0-alpha.27",
     "@tileflow/vite": "0.1.0-alpha.24",
-    "@tileflow/vue": "0.1.0-alpha.25",
+    "@tileflow/svelte": "0.1.0-alpha.26",
+    "@tileflow/vue": "0.1.0-alpha.26",
     "@tileflow/webpack": "0.1.0-alpha.24"
   },
   "scripts": {