@valbuild/shared 0.150.18 → 0.151.0

package/dist/declarations/src/internal/quickPreview.d.ts

@@ -20,6 +20,14 @@
  *    document's `/_app/` requests from the files, and everything else from
  *    the network: the HTML is the last build's, rendered by its server, and
  *    the new code takes it over in the browser.
+ * 4. It takes it over by RENDERING it, not by hydrating it. Hydration keeps
+ *    the markup the server sent wherever only an attribute differs -- React
+ *    mends text, never a `className` -- so a change to classes and props,
+ *    which is most of what the design tab changes, hydrated into the old
+ *    page and showed nothing. The worker adds a script to the end of that
+ *    document's `<body>` ({@link QUICK_PREVIEW_RENDER_SCRIPT}) that takes the
+ *    server's markup out before the app's scripts run, so hydration finds
+ *    nothing to keep and React renders the page with the new code.
  *
  * What it cannot show, and the tab says so: anything on the server. Server
  * functions, API routes and loaders that run there are the last build's, as
@@ -34,6 +42,14 @@
 export declare const QUICK_PREVIEW_PARAM = "val_quick";
 /** Where Val's API serves the worker: under `/api/val`. */
 export declare const QUICK_PREVIEW_SERVICE_WORKER_PATH = "/quick-preview-sw.js";
+/**
+ * What a quick preview's document runs before the app's scripts: the
+ * server's markup out of `<body>`, every script left where it is -- the
+ * router's dehydrated state and the app's entry are among them. Hydration
+ * then finds the body empty and React renders the page, with the new code's
+ * attributes and classes, where it would have kept the old ones.
+ */
+export declare const QUICK_PREVIEW_RENDER_SCRIPT: string;
 /** What the page sends the worker to store a preview's files. */
 export declare const QUICK_PREVIEW_STORE_MESSAGE = "val-quick-preview-store";
 /**
@@ -54,7 +70,7 @@ export declare function isQuickPreviewFiles(value: unknown): value is QuickPrevi
  * The worker, as the source it is served as: plain, and small, because it is
  * served as a file of its own (`demoServiceWorker.ts` is the same).
  */
-export declare const QUICK_PREVIEW_SERVICE_WORKER_SOURCE = "\n\"use strict\";\nconst PARAM = \"val_quick\";\nconst CACHE = \"val-quick-preview\";\nconst PREFIX = \"/__val_quick/\";\nconst INDEX = PREFIX + \"index\";\nconst KEEP = 4;\n\nself.addEventListener(\"install\", () => self.skipWaiting());\nself.addEventListener(\"activate\", (event) => {\n  event.waitUntil(self.clients.claim());\n});\n\nself.addEventListener(\"message\", (event) => {\n  const data = event.data;\n  if (!data || data.type !== \"val-quick-preview-store\") return;\n  const port = event.ports && event.ports[0];\n  event.waitUntil(\n    store(data.id, data.files).then(\n      () => port && port.postMessage({ ok: true }),\n      (error) =>\n        port &&\n        port.postMessage({\n          ok: false,\n          message: String((error && error.message) || error),\n        }),\n    ),\n  );\n});\n\nfunction keyOf(id, path) {\n  return PREFIX + id + \"/\" + path;\n}\n\nasync function store(id, files) {\n  const cache = await caches.open(CACHE);\n  for (const path of Object.keys(files)) {\n    const file = files[path];\n    const body = file.base64\n      ? Uint8Array.from(atob(file.body), (c) => c.charCodeAt(0))\n      : file.body;\n    await cache.put(\n      keyOf(id, path),\n      new Response(body, {\n        headers: { \"Content-Type\": file.contentType, \"Cache-Control\": \"no-store\" },\n      }),\n    );\n  }\n  // The newest few previews are kept; older ones are deleted.\n  const index = await cache.match(INDEX);\n  const ids = [id].concat(\n    (index ? await index.json() : []).filter((other) => other !== id),\n  );\n  const dropped = ids.slice(KEEP);\n  if (dropped.length > 0) {\n    for (const request of await cache.keys()) {\n      const path = new URL(request.url).pathname;\n      if (dropped.some((old) => path.startsWith(PREFIX + old + \"/\"))) {\n        await cache.delete(request);\n      }\n    }\n  }\n  await cache.put(INDEX, new Response(JSON.stringify(ids.slice(0, KEEP))));\n}\n\n/** Which preview a document is: by its id, or by the address it was opened at. */\nconst byClient = new Map();\nasync function previewOf(clientId) {\n  if (!clientId) return null;\n  if (byClient.has(clientId)) return byClient.get(clientId);\n  const client = await self.clients.get(clientId);\n  const id = client ? new URL(client.url).searchParams.get(PARAM) : null;\n  byClient.set(clientId, id);\n  return id;\n}\n\nself.addEventListener(\"fetch\", (event) => {\n  const url = new URL(event.request.url);\n  if (url.origin !== self.location.origin) return;\n  if (event.request.mode === \"navigate\") {\n    if (event.resultingClientId) {\n      byClient.set(event.resultingClientId, url.searchParams.get(PARAM));\n    }\n    return;\n  }\n  if (!url.pathname.startsWith(\"/_app/\")) return;\n  event.respondWith(serve(event, url));\n});\n\nasync function serve(event, url) {\n  const id = await previewOf(event.clientId);\n  if (id) {\n    const hit = await caches.match(keyOf(id, url.pathname.slice(6)), {\n      cacheName: CACHE,\n    });\n    if (hit) return hit;\n  }\n  return fetch(event.request);\n}\n";
+export declare const QUICK_PREVIEW_SERVICE_WORKER_SOURCE: string;
 /**
  * Store a preview's files in the worker, registering it first: what the
  * bridge does when the tab sends `quickPreview`. `swUrl` is the worker's

package/dist/declarations/src/internal/search/searchIndex.d.ts

@@ -57,6 +57,28 @@ export type SearchIndex = {
      * re-indexing one module exists to avoid.
      */
     docsByModule: Map<ModuleFilePath, Set<string>>;
+    /**
+     * For a module whose root is a record: each entry's documents, and the
+     * value they were made from, by key -- so indexing it again walks only the
+     * entries whose value is a different object (see {@link indexModule}).
+     */
+    /**
+     * What each module was last indexed from, whole: the same source object
+     * under a schema that says the same is not walked again. Removing a
+     * document from a big index is slow (FlexSearch looks for it everywhere),
+     * so indexing an unchanged module again was the cost of a pass.
+     */
+    walkedByModule: Map<ModuleFilePath, {
+        source: Json;
+        schema: string;
+    }>;
+    entriesByModule: Map<ModuleFilePath, {
+        schema: SerializedSchema;
+        entries: Map<string, {
+            source: Json;
+            docs: string[];
+        }>;
+    }>;
 };
 /** An index with nothing in it. Fill it with {@link indexModule}. */
 export declare function createSearchIndex(): SearchIndex;
@@ -70,10 +92,19 @@ export declare function createSearchIndex(): SearchIndex;
  * `.jsonValues()` entries are indexed only once their content is loaded — an
  * un-loaded entry is an opaque marker that {@link traverseSchemaSource} skips, so
  * the index is naturally PARTIAL and grows as batches land. That is why the search
- * UI loads the entries on the first query and re-indexes (debounced) as they
- * arrive, rather than pretending an empty result set is an answer.
+ * UI loads the entries on the first query and re-indexes as they arrive, rather
+ * than pretending an empty result set is an answer -- and why a module whose
+ * root is a record is re-indexed by entry ({@link indexRecordModule}): a pass
+ * per batch walks the batch, not the record.
+ */
+export declare function indexModule(searchIndex: SearchIndex, moduleFilePath: ModuleFilePath, source: Json, schema: SerializedSchema, 
+/**
+ * Stop by this time (`performance.now()`), for a caller that must not hold
+ * the thread: answers `false` when it stopped with entries of a record
+ * module still to walk, and the same call again goes on from there. A
+ * module that is not a record is walked whole, whatever the time.
  */
-export declare function indexModule(searchIndex: SearchIndex, moduleFilePath: ModuleFilePath, source: Json, schema: SerializedSchema): void;
+until?: number): boolean;
 /**
  * Drop everything indexed for one module.
  *

package/dist/declarations/src/internal/server/types.d.ts

@@ -45,7 +45,15 @@ export type ValServerJsonResult<Body extends Json | never = never, Error extends
     status: 400;
     json: Error;
 } : never);
-export type ValServerGenericResult = ValServerJsonResult<Json> | ValServerError | ValServerRedirectResult<ValCookiesNames> | ValServerResult<ValCookiesNames, string | ReadableStream<Uint8Array>>;
+/**
+ * Nothing moved since the ETag the caller sent back: no body, as HTTP
+ * requires of a 304.
+ */
+export type ValServerNotModified = {
+    status: 304;
+    headers?: Record<string, string | undefined>;
+};
+export type ValServerGenericResult = ValServerNotModified | ValServerJsonResult<Json> | ValServerError | ValServerRedirectResult<ValCookiesNames> | ValServerResult<ValCookiesNames, string | ReadableStream<Uint8Array>>;
 export type ValUIRequestHandler = (path: string, url: string) => Promise<ValServerGenericResult>;
 export type ValSession = {
     mode: "unauthorized";

package/dist/declarations/src/internal/valCanvasProtocol.d.ts

@@ -93,6 +93,26 @@ export type ValCanvasPageMessage = {
     draftMode: boolean;
     /** The URL the frame ended up on, which a redirect may have changed. */
     url: string;
+    /**
+     * The modules the page holds a draft of: what its server read for this
+     * request (`<ValProvider draft>`). The studio sends each of them in its
+     * catch-up, pending or not, so a draft that stopped being the draft
+     * before the studio was there to say so -- discarded, published -- is
+     * replaced rather than kept. Absent from a page of the release before,
+     * and from a page that read no draft.
+     */
+    holds?: ModuleFilePath[];
+    /**
+     * The version the page holds each of {@link holds} at, where its draft
+     * says (`draftHoldsVersions`): the studio does not send one it would
+     * send at the same version -- the same content. Absent from a page of
+     * the release before, which is sent everything it holds, as before.
+     */
+    holdsVersions?: Partial<Record<ModuleFilePath, {
+        schema: string;
+        base: string;
+        chain: string;
+    }>>;
 } | {
     val: typeof VAL_CANVAS_MESSAGE;
     type: "elements";
@@ -257,8 +277,18 @@ export type ValCanvasStudioMessage = {
     /**
      * The whole module source. `unknown` because the page's own types are the
      * ones that give it meaning; nothing in between should be interpreting it.
+     *
+     * @deprecated A page of this release reads `read`; this is for a page
+     * of the release before. Goes in the release after the one that ships
+     * `read`, with the bridges' fallback that reads it: see
+     * "Release-delayed deletions" in `docs/plans/one-content-model.md`.
      */
     source: unknown;
+    /**
+     * The same module as a read (`ModuleRead`), which the page keeps as it
+     * is. Optional: a Studio from the release before sends `source` alone.
+     */
+    read?: unknown;
 } | {
     /**
      * Everything the studio holds has been sent.
@@ -276,6 +306,22 @@ export type ValCanvasStudioMessage = {
      */
     val: typeof VAL_CANVAS_MESSAGE;
     type: "sourcesSynced";
+} | {
+    /**
+     * The server holds the editor's changes up to this version (`seq`, the
+     * server's `ProjectVersion.seq`; `null` from a server that reports
+     * none). Sent once after `sourcesSynced`, then every time it moves.
+     *
+     * What the page re-reads its server-rendered content on (a loader, a
+     * server component): those only show an edit once the server has it,
+     * so a refresh sent when the edit was typed raced the write and came
+     * back without it -- which a ten second safety refresh used to catch.
+     * A bridge of the release before ignores it, as it ignores any type it
+     * does not know.
+     */
+    val: typeof VAL_CANVAS_MESSAGE;
+    type: "confirmed";
+    seq: number | null;
 } | {
     /**
      * What colour to outline the page's content in.

package/dist/declarations/src/internal/valClientHeader.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Which Val package, at which version, sent a request to Val Build.
+ *
+ * Sent on every request a Val package makes to Val's own services from a
+ * server or a CLI -- the content host, `/api/login`, the analytics ingest --
+ * so Val Build can tell which versions are still out there and which old
+ * endpoints they still call. Without it an endpoint can never be retired with
+ * any confidence: a request from a site nobody has upgraded in a year looks
+ * exactly like one from yesterday's release.
+ *
+ * The value is a product token, `@valbuild/server@0.152.0`: the package whose
+ * code built the request, because that is what decides which endpoints are
+ * called. Not the framework binding or the app: those do not choose URLs.
+ *
+ * NOT sent from the browser. A custom header on a cross-origin request makes
+ * the browser send a CORS preflight, and a host that does not list the header
+ * in `Access-Control-Allow-Headers` refuses the request outright -- so adding
+ * it there is a change to every such host first.
+ *
+ * It identifies the code, not the caller: anyone can send any value, so it is
+ * for counting, never for deciding what a request may do.
+ */
+export declare const VAL_CLIENT_HEADER = "x-val-client";
+/** Packages that send {@link VAL_CLIENT_HEADER}. */
+export type ValClientPackage = "@valbuild/server" | "@valbuild/cli";
+/**
+ * `{ "x-val-client": "@valbuild/server@0.152.0" }`, to spread into a
+ * request's headers.
+ *
+ * A version that could not be read is sent as `unknown` rather than leaving
+ * the header out: "a server too broken to know its version" is still a thing
+ * worth counting, and it is not the same as "a version older than the header".
+ */
+export declare function valClientHeaders(pkg: ValClientPackage, version: string | null | undefined): {
+    [VAL_CLIENT_HEADER]: string;
+};

package/dist/declarations/src/publish/callJson.d.ts

@@ -19,3 +19,18 @@ export declare function isTransientPublishError(error: unknown): boolean;
  * `StudioPublishError` carrying the answer's own message.
  */
 export declare function callJson(fetchImpl: typeof fetch, url: string, method: "GET" | "POST", body?: unknown): Promise<unknown>;
+/**
+ * One JSON READ through this origin, BY VERSION: `held` is the answer the
+ * caller holds, with its `ETag`, which goes as `If-None-Match`. While the
+ * answer is still that one (a 304, with no body) it is `held` again;
+ * otherwise the new body, `parse`d, with its `ETag` -- `null` when the answer
+ * named none, so there is nothing to hold it by. Errors as {@link callJson}
+ * throws them.
+ */
+export declare function readJsonByVersion<T>(fetchImpl: typeof fetch, url: string, held: {
+    etag: string;
+    value: T;
+} | null, parse: (body: unknown) => T): Promise<{
+    etag: string | null;
+    value: T;
+}>;

package/dist/declarations/src/publish/jobClient.d.ts

@@ -24,7 +24,13 @@ export type StudioJobClient = {
      * failed: `types`, an upgrade's new type errors (Publish anyway on home's
      * upgrade page). Content refuses it over anything else.
      */
-    anyway?: "types"[]): Promise<PressResponse>;
+    anyway?: "types"[], 
+    /**
+     * The message of the commit Publish makes first, in a project connected
+     * to git (the proposal's branch, before it merges): from the project's
+     * `studio.commitMessage` setting. Absent: content's default.
+     */
+    commitMessage?: string): Promise<PressResponse>;
     /** Try again: resume a paused queue and press anew. */
     tryAgain(requestId: string, tab: string): Promise<PressResponse>;
     /** Where a press is. */

package/dist/declarations/src/publish/publishClient.d.ts

@@ -22,8 +22,9 @@
  *   own authorisation and a cookie sent to a storage host is a cookie leaked to
  *   one.
  */
-import { ArtifactsResponse, BuildTargetResponse, DeclareBody, DeclareResponse, PromoteResponse, StatusResponse, UploadSlot, VerifyResponse } from "../internal/index.js";
+import { ArtifactsResponse, BuildTargetResponse, DeclareBody, DeclareResponse, PromoteResponse, StatusResponse, UploadSlot, VerifyResponse, publishApiOf, type PublishApiAt } from "../internal/index.js";
 export { StudioPublishError, callJson, isTransientPublishError, } from "./callJson.js";
+export { publishApiOf, type PublishApiAt };
 /** An artifact the live build has and this publish re-declares by hash. */
 export type CarriedArtifact = {
     key: string;
@@ -77,19 +78,6 @@ export type StudioPublishClient = {
  * short of the finish.
  */
 export declare function isExpiredSlot(error: unknown): boolean;
-/**
- * Where content's publish API is reached: through Val's proxy on this origin
- * (`api`, the Studio), or directly (`publishApi`, `<content>/v1`: home's
- * upgrade page, whose `fetchImpl` adds the project token).
- */
-export type PublishApiAt = {
-    /** Val's API root on this origin, e.g. `/api/val`. */
-    api: string;
-} | {
-    /** Content's publish API itself, e.g. `https://content.val.build/v1`. */
-    publishApi: string;
-};
-export declare function publishApiOf(at: PublishApiAt): string;
 export declare function createStudioPublishClient(options: PublishApiAt & {
     fetchImpl?: typeof fetch;
 }): StudioPublishClient;

package/dist/{getSitemapTree-7c848c94.esm.js → getSitemapTree-3c1b9e57.esm.js}

@@ -27,6 +27,14 @@ var VAL_AI_SESSION_STORAGE_KEY = "val-ai-session";
  *    document's `/_app/` requests from the files, and everything else from
  *    the network: the HTML is the last build's, rendered by its server, and
  *    the new code takes it over in the browser.
+ * 4. It takes it over by RENDERING it, not by hydrating it. Hydration keeps
+ *    the markup the server sent wherever only an attribute differs -- React
+ *    mends text, never a `className` -- so a change to classes and props,
+ *    which is most of what the design tab changes, hydrated into the old
+ *    page and showed nothing. The worker adds a script to the end of that
+ *    document's `<body>` ({@link QUICK_PREVIEW_RENDER_SCRIPT}) that takes the
+ *    server's markup out before the app's scripts run, so hydration finds
+ *    nothing to keep and React renders the page with the new code.
  *
  * What it cannot show, and the tab says so: anything on the server. Server
  * functions, API routes and loaders that run there are the last build's, as
@@ -44,6 +52,15 @@ var QUICK_PREVIEW_PARAM = "val_quick";
 /** Where Val's API serves the worker: under `/api/val`. */
 var QUICK_PREVIEW_SERVICE_WORKER_PATH = "/quick-preview-sw.js";
 
+/**
+ * What a quick preview's document runs before the app's scripts: the
+ * server's markup out of `<body>`, every script left where it is -- the
+ * router's dehydrated state and the app's entry are among them. Hydration
+ * then finds the body empty and React renders the page, with the new code's
+ * attributes and classes, where it would have kept the old ones.
+ */
+var QUICK_PREVIEW_RENDER_SCRIPT = "<script>(function(){var b=document.body;if(!b)return;" + "Array.prototype.slice.call(b.childNodes).forEach(function(n){" + 'if(n.nodeName!=="SCRIPT")b.removeChild(n)})})()</script>';
+
 /** What the page sends the worker to store a preview's files. */
 var QUICK_PREVIEW_STORE_MESSAGE = "val-quick-preview-store";
 
@@ -70,7 +87,7 @@ function isQuickPreviewFiles(value) {
  * The worker, as the source it is served as: plain, and small, because it is
  * served as a file of its own (`demoServiceWorker.ts` is the same).
  */
-var QUICK_PREVIEW_SERVICE_WORKER_SOURCE = "\n\"use strict\";\nconst PARAM = \"".concat(QUICK_PREVIEW_PARAM, "\";\nconst CACHE = \"val-quick-preview\";\nconst PREFIX = \"/__val_quick/\";\nconst INDEX = PREFIX + \"index\";\nconst KEEP = 4;\n\nself.addEventListener(\"install\", () => self.skipWaiting());\nself.addEventListener(\"activate\", (event) => {\n  event.waitUntil(self.clients.claim());\n});\n\nself.addEventListener(\"message\", (event) => {\n  const data = event.data;\n  if (!data || data.type !== \"").concat(QUICK_PREVIEW_STORE_MESSAGE, "\") return;\n  const port = event.ports && event.ports[0];\n  event.waitUntil(\n    store(data.id, data.files).then(\n      () => port && port.postMessage({ ok: true }),\n      (error) =>\n        port &&\n        port.postMessage({\n          ok: false,\n          message: String((error && error.message) || error),\n        }),\n    ),\n  );\n});\n\nfunction keyOf(id, path) {\n  return PREFIX + id + \"/\" + path;\n}\n\nasync function store(id, files) {\n  const cache = await caches.open(CACHE);\n  for (const path of Object.keys(files)) {\n    const file = files[path];\n    const body = file.base64\n      ? Uint8Array.from(atob(file.body), (c) => c.charCodeAt(0))\n      : file.body;\n    await cache.put(\n      keyOf(id, path),\n      new Response(body, {\n        headers: { \"Content-Type\": file.contentType, \"Cache-Control\": \"no-store\" },\n      }),\n    );\n  }\n  // The newest few previews are kept; older ones are deleted.\n  const index = await cache.match(INDEX);\n  const ids = [id].concat(\n    (index ? await index.json() : []).filter((other) => other !== id),\n  );\n  const dropped = ids.slice(KEEP);\n  if (dropped.length > 0) {\n    for (const request of await cache.keys()) {\n      const path = new URL(request.url).pathname;\n      if (dropped.some((old) => path.startsWith(PREFIX + old + \"/\"))) {\n        await cache.delete(request);\n      }\n    }\n  }\n  await cache.put(INDEX, new Response(JSON.stringify(ids.slice(0, KEEP))));\n}\n\n/** Which preview a document is: by its id, or by the address it was opened at. */\nconst byClient = new Map();\nasync function previewOf(clientId) {\n  if (!clientId) return null;\n  if (byClient.has(clientId)) return byClient.get(clientId);\n  const client = await self.clients.get(clientId);\n  const id = client ? new URL(client.url).searchParams.get(PARAM) : null;\n  byClient.set(clientId, id);\n  return id;\n}\n\nself.addEventListener(\"fetch\", (event) => {\n  const url = new URL(event.request.url);\n  if (url.origin !== self.location.origin) return;\n  if (event.request.mode === \"navigate\") {\n    if (event.resultingClientId) {\n      byClient.set(event.resultingClientId, url.searchParams.get(PARAM));\n    }\n    return;\n  }\n  if (!url.pathname.startsWith(\"/_app/\")) return;\n  event.respondWith(serve(event, url));\n});\n\nasync function serve(event, url) {\n  const id = await previewOf(event.clientId);\n  if (id) {\n    const hit = await caches.match(keyOf(id, url.pathname.slice(6)), {\n      cacheName: CACHE,\n    });\n    if (hit) return hit;\n  }\n  return fetch(event.request);\n}\n");
+var QUICK_PREVIEW_SERVICE_WORKER_SOURCE = "\n\"use strict\";\nconst PARAM = \"".concat(QUICK_PREVIEW_PARAM, "\";\nconst RENDER = ").concat(JSON.stringify(QUICK_PREVIEW_RENDER_SCRIPT), ";\nconst CACHE = \"val-quick-preview\";\nconst PREFIX = \"/__val_quick/\";\nconst INDEX = PREFIX + \"index\";\nconst KEEP = 4;\n\nself.addEventListener(\"install\", () => self.skipWaiting());\nself.addEventListener(\"activate\", (event) => {\n  event.waitUntil(self.clients.claim());\n});\n\nself.addEventListener(\"message\", (event) => {\n  const data = event.data;\n  if (!data || data.type !== \"").concat(QUICK_PREVIEW_STORE_MESSAGE, "\") return;\n  const port = event.ports && event.ports[0];\n  event.waitUntil(\n    store(data.id, data.files).then(\n      () => port && port.postMessage({ ok: true }),\n      (error) =>\n        port &&\n        port.postMessage({\n          ok: false,\n          message: String((error && error.message) || error),\n        }),\n    ),\n  );\n});\n\nfunction keyOf(id, path) {\n  return PREFIX + id + \"/\" + path;\n}\n\nasync function store(id, files) {\n  const cache = await caches.open(CACHE);\n  for (const path of Object.keys(files)) {\n    const file = files[path];\n    const body = file.base64\n      ? Uint8Array.from(atob(file.body), (c) => c.charCodeAt(0))\n      : file.body;\n    await cache.put(\n      keyOf(id, path),\n      new Response(body, {\n        headers: { \"Content-Type\": file.contentType, \"Cache-Control\": \"no-store\" },\n      }),\n    );\n  }\n  // The newest few previews are kept; older ones are deleted.\n  const index = await cache.match(INDEX);\n  const ids = [id].concat(\n    (index ? await index.json() : []).filter((other) => other !== id),\n  );\n  const dropped = ids.slice(KEEP);\n  if (dropped.length > 0) {\n    for (const request of await cache.keys()) {\n      const path = new URL(request.url).pathname;\n      if (dropped.some((old) => path.startsWith(PREFIX + old + \"/\"))) {\n        await cache.delete(request);\n      }\n    }\n  }\n  await cache.put(INDEX, new Response(JSON.stringify(ids.slice(0, KEEP))));\n}\n\n/** Which preview a document is: by its id, or by the address it was opened at. */\nconst byClient = new Map();\nasync function previewOf(clientId) {\n  if (!clientId) return null;\n  if (byClient.has(clientId)) return byClient.get(clientId);\n  const client = await self.clients.get(clientId);\n  const id = client ? new URL(client.url).searchParams.get(PARAM) : null;\n  byClient.set(clientId, id);\n  return id;\n}\n\nself.addEventListener(\"fetch\", (event) => {\n  const url = new URL(event.request.url);\n  if (url.origin !== self.location.origin) return;\n  if (event.request.mode === \"navigate\") {\n    const id = url.searchParams.get(PARAM);\n    if (event.resultingClientId) byClient.set(event.resultingClientId, id);\n    if (id) event.respondWith(rendered(event.request));\n    return;\n  }\n  if (!url.pathname.startsWith(\"/_app/\")) return;\n  event.respondWith(serve(event, url));\n});\n\n/** A quick preview's document, with the script that has it rendered, not hydrated. */\nasync function rendered(request) {\n  const response = await fetch(request);\n  const type = response.headers.get(\"Content-Type\") || \"\";\n  if (!response.ok || !type.includes(\"text/html\")) return response;\n  const html = await response.text();\n  const at = html.lastIndexOf(\"</body>\");\n  if (at === -1) return new Response(html, response);\n  const headers = new Headers(response.headers);\n  headers.delete(\"Content-Length\");\n  headers.delete(\"Content-Encoding\");\n  return new Response(html.slice(0, at) + RENDER + html.slice(at), {\n    status: response.status,\n    statusText: response.statusText,\n    headers,\n  });\n}\n\nasync function serve(event, url) {\n  const id = await previewOf(event.clientId);\n  if (id) {\n    const hit = await caches.match(keyOf(id, url.pathname.slice(6)), {\n      cacheName: CACHE,\n    });\n    if (hit) return hit;\n  }\n  return fetch(event.request);\n}\n");
 
 /** How long the worker is given to install and store a preview. */
 var STORE_TIMEOUT_MS = 30000;
@@ -322,7 +339,23 @@ function isValCanvasPageMessage(data) {
   if (_typeof(data) !== "object" || data === null) return false;
   var message = data;
   if (message.val !== VAL_CANVAS_MESSAGE) return false;
-  return message.type === "ready" || message.type === "elements" || message.type === "clicked" || message.type === "pinch" || message.type === "zoom" || message.type === "refreshing" || message.type === "elementPickingStopped" || message.type === "elementPicked" && isPickedElement(data.element) || message.type === "location" && isPageLocation(data) || message.type === "pageRead" && typeof data.requestId === "string" || message.type === "pageScreenshot" && typeof data.requestId === "string" || message.type === "quickPreviewStored" && typeof data.id === "string";
+  return message.type === "ready" && isModulePathList(data.holds) && isHeldVersions(data.holdsVersions) || message.type === "elements" || message.type === "clicked" || message.type === "pinch" || message.type === "zoom" || message.type === "refreshing" || message.type === "elementPickingStopped" || message.type === "elementPicked" && isPickedElement(data.element) || message.type === "location" && isPageLocation(data) || message.type === "pageRead" && typeof data.requestId === "string" || message.type === "pageScreenshot" && typeof data.requestId === "string" || message.type === "quickPreviewStored" && typeof data.id === "string";
+}
+
+/** `holdsVersions` on `ready`: absent, or a version per module path. */
+function isHeldVersions(value) {
+  if (value === undefined) return true;
+  if (_typeof(value) !== "object" || value === null) return false;
+  return Object.values(value).every(function (version) {
+    return _typeof(version) === "object" && version !== null && typeof version.schema === "string" && typeof version.base === "string" && typeof version.chain === "string";
+  });
+}
+
+/** `holds` on `ready`: absent, or a list of module paths. */
+function isModulePathList(value) {
+  return value === undefined || Array.isArray(value) && value.every(function (path) {
+    return typeof path === "string";
+  });
 }
 function isPageLocation(value) {
   var location = value;
@@ -387,7 +420,7 @@ function isValCanvasStudioMessage(data) {
     var read = data;
     return typeof read.requestId === "string" && (read.selector === undefined || typeof read.selector === "string") && (read.maxItems === undefined || typeof read.maxItems === "number");
   }
-  return message.type === "rescan" || message.type === "highlight" || message.type === "setPicking" || message.type === "sourceUpdate" || message.type === "sourcesSynced";
+  return message.type === "rescan" || message.type === "highlight" || message.type === "setPicking" || message.type === "sourceUpdate" || message.type === "sourcesSynced" || message.type === "confirmed" && (data.seq === null || typeof data.seq === "number");
 }
 
 /**
@@ -1513,4 +1546,4 @@ function getPatternFromModuleFilePath(moduleFilePath, srcFolder) {
   .replace("/page.val.ts", "").replace("/page.val.js", "");
 }
 
-export { withQuickPreviewParam as A, quickPreviewSiteOrigin as B, isDesignTabOrigin as C, DEFAULT_CANVAS_SELECTION as D, parseRoutePattern as E, formatRoutePattern as F, getNextAppRouterSourceFolder as G, getTanStackRouterSourceFolder as H, getPageRouterSourceFolder as I, isTanStackRoutesFolder as J, getPageRouterSitemapTree as K, getPatternFromModuleFilePath as L, QUICK_PREVIEW_PARAM as Q, VAL_CONFIG_SESSION_STORAGE_KEY as V, VAL_THEME_SESSION_STORAGE_KEY as a, VAL_AI_SESSION_STORAGE_KEY as b, VAL_CANVAS_PARAM as c, VAL_CANVAS_MESSAGE as d, DEFAULT_CANVAS_SELECTION_SOFT as e, isValCanvasStudioMessage as f, isValCanvasFrame as g, describeElement as h, isValCanvasPageMessage as i, attachElementPicker as j, createPickerOverlay as k, elementLabel as l, modifierLabel as m, watchPageLocation as n, readPageSnapshot as o, pageLocationOf as p, findBySelector as q, restoreScroll as r, startElementPicking as s, screenshotPage as t, QUICK_PREVIEW_SERVICE_WORKER_PATH as u, QUICK_PREVIEW_STORE_MESSAGE as v, withValCanvasParam as w, isQuickPreviewFiles as x, QUICK_PREVIEW_SERVICE_WORKER_SOURCE as y, storeQuickPreview as z };
+export { storeQuickPreview as A, withQuickPreviewParam as B, quickPreviewSiteOrigin as C, DEFAULT_CANVAS_SELECTION as D, isDesignTabOrigin as E, parseRoutePattern as F, formatRoutePattern as G, getNextAppRouterSourceFolder as H, getTanStackRouterSourceFolder as I, getPageRouterSourceFolder as J, isTanStackRoutesFolder as K, getPageRouterSitemapTree as L, getPatternFromModuleFilePath as M, QUICK_PREVIEW_PARAM as Q, VAL_CONFIG_SESSION_STORAGE_KEY as V, VAL_THEME_SESSION_STORAGE_KEY as a, VAL_AI_SESSION_STORAGE_KEY as b, VAL_CANVAS_PARAM as c, VAL_CANVAS_MESSAGE as d, DEFAULT_CANVAS_SELECTION_SOFT as e, isValCanvasStudioMessage as f, isValCanvasFrame as g, describeElement as h, isValCanvasPageMessage as i, attachElementPicker as j, createPickerOverlay as k, elementLabel as l, modifierLabel as m, watchPageLocation as n, readPageSnapshot as o, pageLocationOf as p, findBySelector as q, restoreScroll as r, startElementPicking as s, screenshotPage as t, QUICK_PREVIEW_SERVICE_WORKER_PATH as u, QUICK_PREVIEW_RENDER_SCRIPT as v, withValCanvasParam as w, QUICK_PREVIEW_STORE_MESSAGE as x, isQuickPreviewFiles as y, QUICK_PREVIEW_SERVICE_WORKER_SOURCE as z };

package/dist/{getSitemapTree-98642b57.cjs.dev.js → getSitemapTree-59c5ed5d.cjs.dev.js}

@@ -47,6 +47,14 @@ var VAL_AI_SESSION_STORAGE_KEY = "val-ai-session";
  *    document's `/_app/` requests from the files, and everything else from
  *    the network: the HTML is the last build's, rendered by its server, and
  *    the new code takes it over in the browser.
+ * 4. It takes it over by RENDERING it, not by hydrating it. Hydration keeps
+ *    the markup the server sent wherever only an attribute differs -- React
+ *    mends text, never a `className` -- so a change to classes and props,
+ *    which is most of what the design tab changes, hydrated into the old
+ *    page and showed nothing. The worker adds a script to the end of that
+ *    document's `<body>` ({@link QUICK_PREVIEW_RENDER_SCRIPT}) that takes the
+ *    server's markup out before the app's scripts run, so hydration finds
+ *    nothing to keep and React renders the page with the new code.
  *
  * What it cannot show, and the tab says so: anything on the server. Server
  * functions, API routes and loaders that run there are the last build's, as
@@ -64,6 +72,15 @@ var QUICK_PREVIEW_PARAM = "val_quick";
 /** Where Val's API serves the worker: under `/api/val`. */
 var QUICK_PREVIEW_SERVICE_WORKER_PATH = "/quick-preview-sw.js";
 
+/**
+ * What a quick preview's document runs before the app's scripts: the
+ * server's markup out of `<body>`, every script left where it is -- the
+ * router's dehydrated state and the app's entry are among them. Hydration
+ * then finds the body empty and React renders the page, with the new code's
+ * attributes and classes, where it would have kept the old ones.
+ */
+var QUICK_PREVIEW_RENDER_SCRIPT = "<script>(function(){var b=document.body;if(!b)return;" + "Array.prototype.slice.call(b.childNodes).forEach(function(n){" + 'if(n.nodeName!=="SCRIPT")b.removeChild(n)})})()</script>';
+
 /** What the page sends the worker to store a preview's files. */
 var QUICK_PREVIEW_STORE_MESSAGE = "val-quick-preview-store";
 
@@ -90,7 +107,7 @@ function isQuickPreviewFiles(value) {
  * The worker, as the source it is served as: plain, and small, because it is
  * served as a file of its own (`demoServiceWorker.ts` is the same).
  */
-var QUICK_PREVIEW_SERVICE_WORKER_SOURCE = "\n\"use strict\";\nconst PARAM = \"".concat(QUICK_PREVIEW_PARAM, "\";\nconst CACHE = \"val-quick-preview\";\nconst PREFIX = \"/__val_quick/\";\nconst INDEX = PREFIX + \"index\";\nconst KEEP = 4;\n\nself.addEventListener(\"install\", () => self.skipWaiting());\nself.addEventListener(\"activate\", (event) => {\n  event.waitUntil(self.clients.claim());\n});\n\nself.addEventListener(\"message\", (event) => {\n  const data = event.data;\n  if (!data || data.type !== \"").concat(QUICK_PREVIEW_STORE_MESSAGE, "\") return;\n  const port = event.ports && event.ports[0];\n  event.waitUntil(\n    store(data.id, data.files).then(\n      () => port && port.postMessage({ ok: true }),\n      (error) =>\n        port &&\n        port.postMessage({\n          ok: false,\n          message: String((error && error.message) || error),\n        }),\n    ),\n  );\n});\n\nfunction keyOf(id, path) {\n  return PREFIX + id + \"/\" + path;\n}\n\nasync function store(id, files) {\n  const cache = await caches.open(CACHE);\n  for (const path of Object.keys(files)) {\n    const file = files[path];\n    const body = file.base64\n      ? Uint8Array.from(atob(file.body), (c) => c.charCodeAt(0))\n      : file.body;\n    await cache.put(\n      keyOf(id, path),\n      new Response(body, {\n        headers: { \"Content-Type\": file.contentType, \"Cache-Control\": \"no-store\" },\n      }),\n    );\n  }\n  // The newest few previews are kept; older ones are deleted.\n  const index = await cache.match(INDEX);\n  const ids = [id].concat(\n    (index ? await index.json() : []).filter((other) => other !== id),\n  );\n  const dropped = ids.slice(KEEP);\n  if (dropped.length > 0) {\n    for (const request of await cache.keys()) {\n      const path = new URL(request.url).pathname;\n      if (dropped.some((old) => path.startsWith(PREFIX + old + \"/\"))) {\n        await cache.delete(request);\n      }\n    }\n  }\n  await cache.put(INDEX, new Response(JSON.stringify(ids.slice(0, KEEP))));\n}\n\n/** Which preview a document is: by its id, or by the address it was opened at. */\nconst byClient = new Map();\nasync function previewOf(clientId) {\n  if (!clientId) return null;\n  if (byClient.has(clientId)) return byClient.get(clientId);\n  const client = await self.clients.get(clientId);\n  const id = client ? new URL(client.url).searchParams.get(PARAM) : null;\n  byClient.set(clientId, id);\n  return id;\n}\n\nself.addEventListener(\"fetch\", (event) => {\n  const url = new URL(event.request.url);\n  if (url.origin !== self.location.origin) return;\n  if (event.request.mode === \"navigate\") {\n    if (event.resultingClientId) {\n      byClient.set(event.resultingClientId, url.searchParams.get(PARAM));\n    }\n    return;\n  }\n  if (!url.pathname.startsWith(\"/_app/\")) return;\n  event.respondWith(serve(event, url));\n});\n\nasync function serve(event, url) {\n  const id = await previewOf(event.clientId);\n  if (id) {\n    const hit = await caches.match(keyOf(id, url.pathname.slice(6)), {\n      cacheName: CACHE,\n    });\n    if (hit) return hit;\n  }\n  return fetch(event.request);\n}\n");
+var QUICK_PREVIEW_SERVICE_WORKER_SOURCE = "\n\"use strict\";\nconst PARAM = \"".concat(QUICK_PREVIEW_PARAM, "\";\nconst RENDER = ").concat(JSON.stringify(QUICK_PREVIEW_RENDER_SCRIPT), ";\nconst CACHE = \"val-quick-preview\";\nconst PREFIX = \"/__val_quick/\";\nconst INDEX = PREFIX + \"index\";\nconst KEEP = 4;\n\nself.addEventListener(\"install\", () => self.skipWaiting());\nself.addEventListener(\"activate\", (event) => {\n  event.waitUntil(self.clients.claim());\n});\n\nself.addEventListener(\"message\", (event) => {\n  const data = event.data;\n  if (!data || data.type !== \"").concat(QUICK_PREVIEW_STORE_MESSAGE, "\") return;\n  const port = event.ports && event.ports[0];\n  event.waitUntil(\n    store(data.id, data.files).then(\n      () => port && port.postMessage({ ok: true }),\n      (error) =>\n        port &&\n        port.postMessage({\n          ok: false,\n          message: String((error && error.message) || error),\n        }),\n    ),\n  );\n});\n\nfunction keyOf(id, path) {\n  return PREFIX + id + \"/\" + path;\n}\n\nasync function store(id, files) {\n  const cache = await caches.open(CACHE);\n  for (const path of Object.keys(files)) {\n    const file = files[path];\n    const body = file.base64\n      ? Uint8Array.from(atob(file.body), (c) => c.charCodeAt(0))\n      : file.body;\n    await cache.put(\n      keyOf(id, path),\n      new Response(body, {\n        headers: { \"Content-Type\": file.contentType, \"Cache-Control\": \"no-store\" },\n      }),\n    );\n  }\n  // The newest few previews are kept; older ones are deleted.\n  const index = await cache.match(INDEX);\n  const ids = [id].concat(\n    (index ? await index.json() : []).filter((other) => other !== id),\n  );\n  const dropped = ids.slice(KEEP);\n  if (dropped.length > 0) {\n    for (const request of await cache.keys()) {\n      const path = new URL(request.url).pathname;\n      if (dropped.some((old) => path.startsWith(PREFIX + old + \"/\"))) {\n        await cache.delete(request);\n      }\n    }\n  }\n  await cache.put(INDEX, new Response(JSON.stringify(ids.slice(0, KEEP))));\n}\n\n/** Which preview a document is: by its id, or by the address it was opened at. */\nconst byClient = new Map();\nasync function previewOf(clientId) {\n  if (!clientId) return null;\n  if (byClient.has(clientId)) return byClient.get(clientId);\n  const client = await self.clients.get(clientId);\n  const id = client ? new URL(client.url).searchParams.get(PARAM) : null;\n  byClient.set(clientId, id);\n  return id;\n}\n\nself.addEventListener(\"fetch\", (event) => {\n  const url = new URL(event.request.url);\n  if (url.origin !== self.location.origin) return;\n  if (event.request.mode === \"navigate\") {\n    const id = url.searchParams.get(PARAM);\n    if (event.resultingClientId) byClient.set(event.resultingClientId, id);\n    if (id) event.respondWith(rendered(event.request));\n    return;\n  }\n  if (!url.pathname.startsWith(\"/_app/\")) return;\n  event.respondWith(serve(event, url));\n});\n\n/** A quick preview's document, with the script that has it rendered, not hydrated. */\nasync function rendered(request) {\n  const response = await fetch(request);\n  const type = response.headers.get(\"Content-Type\") || \"\";\n  if (!response.ok || !type.includes(\"text/html\")) return response;\n  const html = await response.text();\n  const at = html.lastIndexOf(\"</body>\");\n  if (at === -1) return new Response(html, response);\n  const headers = new Headers(response.headers);\n  headers.delete(\"Content-Length\");\n  headers.delete(\"Content-Encoding\");\n  return new Response(html.slice(0, at) + RENDER + html.slice(at), {\n    status: response.status,\n    statusText: response.statusText,\n    headers,\n  });\n}\n\nasync function serve(event, url) {\n  const id = await previewOf(event.clientId);\n  if (id) {\n    const hit = await caches.match(keyOf(id, url.pathname.slice(6)), {\n      cacheName: CACHE,\n    });\n    if (hit) return hit;\n  }\n  return fetch(event.request);\n}\n");
 
 /** How long the worker is given to install and store a preview. */
 var STORE_TIMEOUT_MS = 30000;
@@ -342,7 +359,23 @@ function isValCanvasPageMessage(data) {
   if (createForOfIteratorHelper._typeof(data) !== "object" || data === null) return false;
   var message = data;
   if (message.val !== VAL_CANVAS_MESSAGE) return false;
-  return message.type === "ready" || message.type === "elements" || message.type === "clicked" || message.type === "pinch" || message.type === "zoom" || message.type === "refreshing" || message.type === "elementPickingStopped" || message.type === "elementPicked" && isPickedElement(data.element) || message.type === "location" && isPageLocation(data) || message.type === "pageRead" && typeof data.requestId === "string" || message.type === "pageScreenshot" && typeof data.requestId === "string" || message.type === "quickPreviewStored" && typeof data.id === "string";
+  return message.type === "ready" && isModulePathList(data.holds) && isHeldVersions(data.holdsVersions) || message.type === "elements" || message.type === "clicked" || message.type === "pinch" || message.type === "zoom" || message.type === "refreshing" || message.type === "elementPickingStopped" || message.type === "elementPicked" && isPickedElement(data.element) || message.type === "location" && isPageLocation(data) || message.type === "pageRead" && typeof data.requestId === "string" || message.type === "pageScreenshot" && typeof data.requestId === "string" || message.type === "quickPreviewStored" && typeof data.id === "string";
+}
+
+/** `holdsVersions` on `ready`: absent, or a version per module path. */
+function isHeldVersions(value) {
+  if (value === undefined) return true;
+  if (createForOfIteratorHelper._typeof(value) !== "object" || value === null) return false;
+  return Object.values(value).every(function (version) {
+    return createForOfIteratorHelper._typeof(version) === "object" && version !== null && typeof version.schema === "string" && typeof version.base === "string" && typeof version.chain === "string";
+  });
+}
+
+/** `holds` on `ready`: absent, or a list of module paths. */
+function isModulePathList(value) {
+  return value === undefined || Array.isArray(value) && value.every(function (path) {
+    return typeof path === "string";
+  });
 }
 function isPageLocation(value) {
   var location = value;
@@ -407,7 +440,7 @@ function isValCanvasStudioMessage(data) {
     var read = data;
     return typeof read.requestId === "string" && (read.selector === undefined || typeof read.selector === "string") && (read.maxItems === undefined || typeof read.maxItems === "number");
   }
-  return message.type === "rescan" || message.type === "highlight" || message.type === "setPicking" || message.type === "sourceUpdate" || message.type === "sourcesSynced";
+  return message.type === "rescan" || message.type === "highlight" || message.type === "setPicking" || message.type === "sourceUpdate" || message.type === "sourcesSynced" || message.type === "confirmed" && (data.seq === null || typeof data.seq === "number");
 }
 
 /**
@@ -1536,6 +1569,7 @@ function getPatternFromModuleFilePath(moduleFilePath, srcFolder) {
 exports.DEFAULT_CANVAS_SELECTION = DEFAULT_CANVAS_SELECTION;
 exports.DEFAULT_CANVAS_SELECTION_SOFT = DEFAULT_CANVAS_SELECTION_SOFT;
 exports.QUICK_PREVIEW_PARAM = QUICK_PREVIEW_PARAM;
+exports.QUICK_PREVIEW_RENDER_SCRIPT = QUICK_PREVIEW_RENDER_SCRIPT;
 exports.QUICK_PREVIEW_SERVICE_WORKER_PATH = QUICK_PREVIEW_SERVICE_WORKER_PATH;
 exports.QUICK_PREVIEW_SERVICE_WORKER_SOURCE = QUICK_PREVIEW_SERVICE_WORKER_SOURCE;
 exports.QUICK_PREVIEW_STORE_MESSAGE = QUICK_PREVIEW_STORE_MESSAGE;

package/dist/{getSitemapTree-97713490.cjs.prod.js → getSitemapTree-6b9024d1.cjs.prod.js}

@@ -47,6 +47,14 @@ var VAL_AI_SESSION_STORAGE_KEY = "val-ai-session";
  *    document's `/_app/` requests from the files, and everything else from
  *    the network: the HTML is the last build's, rendered by its server, and
  *    the new code takes it over in the browser.
+ * 4. It takes it over by RENDERING it, not by hydrating it. Hydration keeps
+ *    the markup the server sent wherever only an attribute differs -- React
+ *    mends text, never a `className` -- so a change to classes and props,
+ *    which is most of what the design tab changes, hydrated into the old
+ *    page and showed nothing. The worker adds a script to the end of that
+ *    document's `<body>` ({@link QUICK_PREVIEW_RENDER_SCRIPT}) that takes the
+ *    server's markup out before the app's scripts run, so hydration finds
+ *    nothing to keep and React renders the page with the new code.
  *
  * What it cannot show, and the tab says so: anything on the server. Server
  * functions, API routes and loaders that run there are the last build's, as
@@ -64,6 +72,15 @@ var QUICK_PREVIEW_PARAM = "val_quick";
 /** Where Val's API serves the worker: under `/api/val`. */
 var QUICK_PREVIEW_SERVICE_WORKER_PATH = "/quick-preview-sw.js";
 
+/**
+ * What a quick preview's document runs before the app's scripts: the
+ * server's markup out of `<body>`, every script left where it is -- the
+ * router's dehydrated state and the app's entry are among them. Hydration
+ * then finds the body empty and React renders the page, with the new code's
+ * attributes and classes, where it would have kept the old ones.
+ */
+var QUICK_PREVIEW_RENDER_SCRIPT = "<script>(function(){var b=document.body;if(!b)return;" + "Array.prototype.slice.call(b.childNodes).forEach(function(n){" + 'if(n.nodeName!=="SCRIPT")b.removeChild(n)})})()</script>';
+
 /** What the page sends the worker to store a preview's files. */
 var QUICK_PREVIEW_STORE_MESSAGE = "val-quick-preview-store";
 
@@ -90,7 +107,7 @@ function isQuickPreviewFiles(value) {
  * The worker, as the source it is served as: plain, and small, because it is
  * served as a file of its own (`demoServiceWorker.ts` is the same).
  */
-var QUICK_PREVIEW_SERVICE_WORKER_SOURCE = "\n\"use strict\";\nconst PARAM = \"".concat(QUICK_PREVIEW_PARAM, "\";\nconst CACHE = \"val-quick-preview\";\nconst PREFIX = \"/__val_quick/\";\nconst INDEX = PREFIX + \"index\";\nconst KEEP = 4;\n\nself.addEventListener(\"install\", () => self.skipWaiting());\nself.addEventListener(\"activate\", (event) => {\n  event.waitUntil(self.clients.claim());\n});\n\nself.addEventListener(\"message\", (event) => {\n  const data = event.data;\n  if (!data || data.type !== \"").concat(QUICK_PREVIEW_STORE_MESSAGE, "\") return;\n  const port = event.ports && event.ports[0];\n  event.waitUntil(\n    store(data.id, data.files).then(\n      () => port && port.postMessage({ ok: true }),\n      (error) =>\n        port &&\n        port.postMessage({\n          ok: false,\n          message: String((error && error.message) || error),\n        }),\n    ),\n  );\n});\n\nfunction keyOf(id, path) {\n  return PREFIX + id + \"/\" + path;\n}\n\nasync function store(id, files) {\n  const cache = await caches.open(CACHE);\n  for (const path of Object.keys(files)) {\n    const file = files[path];\n    const body = file.base64\n      ? Uint8Array.from(atob(file.body), (c) => c.charCodeAt(0))\n      : file.body;\n    await cache.put(\n      keyOf(id, path),\n      new Response(body, {\n        headers: { \"Content-Type\": file.contentType, \"Cache-Control\": \"no-store\" },\n      }),\n    );\n  }\n  // The newest few previews are kept; older ones are deleted.\n  const index = await cache.match(INDEX);\n  const ids = [id].concat(\n    (index ? await index.json() : []).filter((other) => other !== id),\n  );\n  const dropped = ids.slice(KEEP);\n  if (dropped.length > 0) {\n    for (const request of await cache.keys()) {\n      const path = new URL(request.url).pathname;\n      if (dropped.some((old) => path.startsWith(PREFIX + old + \"/\"))) {\n        await cache.delete(request);\n      }\n    }\n  }\n  await cache.put(INDEX, new Response(JSON.stringify(ids.slice(0, KEEP))));\n}\n\n/** Which preview a document is: by its id, or by the address it was opened at. */\nconst byClient = new Map();\nasync function previewOf(clientId) {\n  if (!clientId) return null;\n  if (byClient.has(clientId)) return byClient.get(clientId);\n  const client = await self.clients.get(clientId);\n  const id = client ? new URL(client.url).searchParams.get(PARAM) : null;\n  byClient.set(clientId, id);\n  return id;\n}\n\nself.addEventListener(\"fetch\", (event) => {\n  const url = new URL(event.request.url);\n  if (url.origin !== self.location.origin) return;\n  if (event.request.mode === \"navigate\") {\n    if (event.resultingClientId) {\n      byClient.set(event.resultingClientId, url.searchParams.get(PARAM));\n    }\n    return;\n  }\n  if (!url.pathname.startsWith(\"/_app/\")) return;\n  event.respondWith(serve(event, url));\n});\n\nasync function serve(event, url) {\n  const id = await previewOf(event.clientId);\n  if (id) {\n    const hit = await caches.match(keyOf(id, url.pathname.slice(6)), {\n      cacheName: CACHE,\n    });\n    if (hit) return hit;\n  }\n  return fetch(event.request);\n}\n");
+var QUICK_PREVIEW_SERVICE_WORKER_SOURCE = "\n\"use strict\";\nconst PARAM = \"".concat(QUICK_PREVIEW_PARAM, "\";\nconst RENDER = ").concat(JSON.stringify(QUICK_PREVIEW_RENDER_SCRIPT), ";\nconst CACHE = \"val-quick-preview\";\nconst PREFIX = \"/__val_quick/\";\nconst INDEX = PREFIX + \"index\";\nconst KEEP = 4;\n\nself.addEventListener(\"install\", () => self.skipWaiting());\nself.addEventListener(\"activate\", (event) => {\n  event.waitUntil(self.clients.claim());\n});\n\nself.addEventListener(\"message\", (event) => {\n  const data = event.data;\n  if (!data || data.type !== \"").concat(QUICK_PREVIEW_STORE_MESSAGE, "\") return;\n  const port = event.ports && event.ports[0];\n  event.waitUntil(\n    store(data.id, data.files).then(\n      () => port && port.postMessage({ ok: true }),\n      (error) =>\n        port &&\n        port.postMessage({\n          ok: false,\n          message: String((error && error.message) || error),\n        }),\n    ),\n  );\n});\n\nfunction keyOf(id, path) {\n  return PREFIX + id + \"/\" + path;\n}\n\nasync function store(id, files) {\n  const cache = await caches.open(CACHE);\n  for (const path of Object.keys(files)) {\n    const file = files[path];\n    const body = file.base64\n      ? Uint8Array.from(atob(file.body), (c) => c.charCodeAt(0))\n      : file.body;\n    await cache.put(\n      keyOf(id, path),\n      new Response(body, {\n        headers: { \"Content-Type\": file.contentType, \"Cache-Control\": \"no-store\" },\n      }),\n    );\n  }\n  // The newest few previews are kept; older ones are deleted.\n  const index = await cache.match(INDEX);\n  const ids = [id].concat(\n    (index ? await index.json() : []).filter((other) => other !== id),\n  );\n  const dropped = ids.slice(KEEP);\n  if (dropped.length > 0) {\n    for (const request of await cache.keys()) {\n      const path = new URL(request.url).pathname;\n      if (dropped.some((old) => path.startsWith(PREFIX + old + \"/\"))) {\n        await cache.delete(request);\n      }\n    }\n  }\n  await cache.put(INDEX, new Response(JSON.stringify(ids.slice(0, KEEP))));\n}\n\n/** Which preview a document is: by its id, or by the address it was opened at. */\nconst byClient = new Map();\nasync function previewOf(clientId) {\n  if (!clientId) return null;\n  if (byClient.has(clientId)) return byClient.get(clientId);\n  const client = await self.clients.get(clientId);\n  const id = client ? new URL(client.url).searchParams.get(PARAM) : null;\n  byClient.set(clientId, id);\n  return id;\n}\n\nself.addEventListener(\"fetch\", (event) => {\n  const url = new URL(event.request.url);\n  if (url.origin !== self.location.origin) return;\n  if (event.request.mode === \"navigate\") {\n    const id = url.searchParams.get(PARAM);\n    if (event.resultingClientId) byClient.set(event.resultingClientId, id);\n    if (id) event.respondWith(rendered(event.request));\n    return;\n  }\n  if (!url.pathname.startsWith(\"/_app/\")) return;\n  event.respondWith(serve(event, url));\n});\n\n/** A quick preview's document, with the script that has it rendered, not hydrated. */\nasync function rendered(request) {\n  const response = await fetch(request);\n  const type = response.headers.get(\"Content-Type\") || \"\";\n  if (!response.ok || !type.includes(\"text/html\")) return response;\n  const html = await response.text();\n  const at = html.lastIndexOf(\"</body>\");\n  if (at === -1) return new Response(html, response);\n  const headers = new Headers(response.headers);\n  headers.delete(\"Content-Length\");\n  headers.delete(\"Content-Encoding\");\n  return new Response(html.slice(0, at) + RENDER + html.slice(at), {\n    status: response.status,\n    statusText: response.statusText,\n    headers,\n  });\n}\n\nasync function serve(event, url) {\n  const id = await previewOf(event.clientId);\n  if (id) {\n    const hit = await caches.match(keyOf(id, url.pathname.slice(6)), {\n      cacheName: CACHE,\n    });\n    if (hit) return hit;\n  }\n  return fetch(event.request);\n}\n");
 
 /** How long the worker is given to install and store a preview. */
 var STORE_TIMEOUT_MS = 30000;
@@ -342,7 +359,23 @@ function isValCanvasPageMessage(data) {
   if (createForOfIteratorHelper._typeof(data) !== "object" || data === null) return false;
   var message = data;
   if (message.val !== VAL_CANVAS_MESSAGE) return false;
-  return message.type === "ready" || message.type === "elements" || message.type === "clicked" || message.type === "pinch" || message.type === "zoom" || message.type === "refreshing" || message.type === "elementPickingStopped" || message.type === "elementPicked" && isPickedElement(data.element) || message.type === "location" && isPageLocation(data) || message.type === "pageRead" && typeof data.requestId === "string" || message.type === "pageScreenshot" && typeof data.requestId === "string" || message.type === "quickPreviewStored" && typeof data.id === "string";
+  return message.type === "ready" && isModulePathList(data.holds) && isHeldVersions(data.holdsVersions) || message.type === "elements" || message.type === "clicked" || message.type === "pinch" || message.type === "zoom" || message.type === "refreshing" || message.type === "elementPickingStopped" || message.type === "elementPicked" && isPickedElement(data.element) || message.type === "location" && isPageLocation(data) || message.type === "pageRead" && typeof data.requestId === "string" || message.type === "pageScreenshot" && typeof data.requestId === "string" || message.type === "quickPreviewStored" && typeof data.id === "string";
+}
+
+/** `holdsVersions` on `ready`: absent, or a version per module path. */
+function isHeldVersions(value) {
+  if (value === undefined) return true;
+  if (createForOfIteratorHelper._typeof(value) !== "object" || value === null) return false;
+  return Object.values(value).every(function (version) {
+    return createForOfIteratorHelper._typeof(version) === "object" && version !== null && typeof version.schema === "string" && typeof version.base === "string" && typeof version.chain === "string";
+  });
+}
+
+/** `holds` on `ready`: absent, or a list of module paths. */
+function isModulePathList(value) {
+  return value === undefined || Array.isArray(value) && value.every(function (path) {
+    return typeof path === "string";
+  });
 }
 function isPageLocation(value) {
   var location = value;
@@ -407,7 +440,7 @@ function isValCanvasStudioMessage(data) {
     var read = data;
     return typeof read.requestId === "string" && (read.selector === undefined || typeof read.selector === "string") && (read.maxItems === undefined || typeof read.maxItems === "number");
   }
-  return message.type === "rescan" || message.type === "highlight" || message.type === "setPicking" || message.type === "sourceUpdate" || message.type === "sourcesSynced";
+  return message.type === "rescan" || message.type === "highlight" || message.type === "setPicking" || message.type === "sourceUpdate" || message.type === "sourcesSynced" || message.type === "confirmed" && (data.seq === null || typeof data.seq === "number");
 }
 
 /**
@@ -1536,6 +1569,7 @@ function getPatternFromModuleFilePath(moduleFilePath, srcFolder) {
 exports.DEFAULT_CANVAS_SELECTION = DEFAULT_CANVAS_SELECTION;
 exports.DEFAULT_CANVAS_SELECTION_SOFT = DEFAULT_CANVAS_SELECTION_SOFT;
 exports.QUICK_PREVIEW_PARAM = QUICK_PREVIEW_PARAM;
+exports.QUICK_PREVIEW_RENDER_SCRIPT = QUICK_PREVIEW_RENDER_SCRIPT;
 exports.QUICK_PREVIEW_SERVICE_WORKER_PATH = QUICK_PREVIEW_SERVICE_WORKER_PATH;
 exports.QUICK_PREVIEW_SERVICE_WORKER_SOURCE = QUICK_PREVIEW_SERVICE_WORKER_SOURCE;
 exports.QUICK_PREVIEW_STORE_MESSAGE = QUICK_PREVIEW_STORE_MESSAGE;