@valbuild/shared 0.152.1 → 0.153.1

package/CHANGELOG.md

@@ -1,5 +1,55 @@
 # @valbuild/shared
 
+## 0.153.1
+
+### Patch Changes
+
+- [#1031](https://github.com/valbuild/val/pull/1031) [`6ec1a5d`](https://github.com/valbuild/val/commit/6ec1a5d244f0d6e064eca4135f167dfa79744f9a) Thanks [@freekh](https://github.com/freekh)! - A page no longer shows content made for code it does not have yet. When the Studio is ahead of the page (it picked up a code change first, or the browser is still running the previous build), the page keeps showing its own content for the modules whose schema changed, and says "The code changed" with a **Reload** button — in the overlay on your site, and above the page in the Studio. In local development the page usually catches up a moment later by itself, and the notice goes away without a reload.
+
+- [#1027](https://github.com/valbuild/val/pull/1027) [`b14870b`](https://github.com/valbuild/val/commit/b14870bebdc128234bb16e4ea06a0151d18c4771) Thanks [@freekh](https://github.com/freekh)! - The Sketchpad's linked text is gone, and so are its "needs code" badges.
+
+  - **Linked text is removed.** A heading or paragraph can no longer be linked to a content field (`{field: …}`), and typing in a sketchpad never changes the site's content: the sketch is a plan, and **Build** is what changes the pages. A sketch that still has a `{field: …}` from 0.152.0 shows it as plain text, and can be deleted.
+  - **No "needs code" badges.** A box of a kind the site does not have, and a new route the site has no page type for, are no longer marked. A box's kind still suggests the site's own kinds.
+  - **Narrow columns keep their shape.** In a row of several columns, a box's header stays on one line (a long kind is cut short, and shown in full on hover), and a box naming an image the project does not have says so in a few lines, with the file's name on one, instead of breaking the path over many.
+
+## 0.153.0
+
+### Minor Changes
+
+- [#1016](https://github.com/valbuild/val/pull/1016) [`2e70d13`](https://github.com/valbuild/val/commit/2e70d13cf7ca25874900c9ea25227df2876727b9) Thanks [@freekh](https://github.com/freekh)! - Editing content in a proposal whose code changed, before the proposal is built again:
+
+  - **A module the proposal adds** can be edited and saved right away. Its content is read from the new file and saved. Before, those edits were dropped. If the module's content is made by code (not written out in the file), the save waits and says to build the proposal first.
+  - **A module whose schema moved because a file it imports changed** (for example a shared `src/schemas/*.ts`) is no longer read with the old schema. Pages keep showing the content as built until the proposal is built again.
+  - **Edits that no longer fit the schema** can be handed to the assistant. The banner that lists them has a **Have the assistant move it** button for each one. You still discard the held edit yourself afterwards.
+
+  For this, `@valbuild/tanstack-build` records which files each Val module imports, and the `val.server.ts` it generates passes that to Val as the new optional `moduleDependencies` option of `initValServer` and `initValContent`. You do not need to set it yourself. A site built before this has no `moduleDependencies` and works as before.
+
+- [#1016](https://github.com/valbuild/val/pull/1016) [`2e70d13`](https://github.com/valbuild/val/commit/2e70d13cf7ca25874900c9ea25227df2876727b9) Thanks [@freekh](https://github.com/freekh)! - Removed what 0.151.0 kept only so that a Studio, a page and a server from the release before could still talk to each other during a deploy:
+
+  - **`PUT /api/val/sources/~`** is gone. Nothing in 0.151.0 asked it: the Studio reads modules through `GET /api/val/manifest` and `GET /api/val/modules/~<path>`, and `fetchVal`, `useVal` and the MCP tools read the server's content in-process. If a script or test of yours read content through it, read one module with `GET /api/val/modules/~<path>` instead. Its answer has the module's `source` and `version`, and an `entries` map holding the `.jsonValues()` entries pending changes touched.
+  - **`ValDraft.base`** is gone from the type. It has not been sent or read since 0.151.0, so a `draft` you pass to `ValProvider` is not affected.
+  - **A page no longer accepts edits relayed by a Studio from before 0.151.0.** Such a Studio sent each module as a bare `source`. After the upgrade, the Studio and your pages come from the same deploy, so this only matters while an older Studio is still open in a tab during a rollout. Reloading that tab fixes it.
+  - **`/api/val/stat`** no longer needs `sourcesSha` and `schemaSha`. The Studio now tells your local server which version it last saw, and the server still sends both fields for a Studio of 0.151.0. They stop being sent in the next release.
+
+### Patch Changes
+
+- [#1028](https://github.com/valbuild/val/pull/1028) [`27e51ba`](https://github.com/valbuild/val/commit/27e51baadce61b2cbee2d5ef227aae045ccb2e21) Thanks [@freekh](https://github.com/freekh)! - Another editor's keystroke costs the Studio less. Locally (`pnpm dev`, and
+  anywhere `/stat` long-polls), the Studio no longer asks for the manifest or
+  the changed module after someone else types: `/stat` now carries what
+  `GET /manifest` would have answered, and the module's new version is computed
+  from the patch the Studio already fetched. Where neither can be used (an
+  older server, a version that does not match), the Studio asks for them as
+  before.
+
+- [#1030](https://github.com/valbuild/val/pull/1030) [`efa1f7d`](https://github.com/valbuild/val/commit/efa1f7d810f3c4e4e21502c9cc81ce86da93650c) Thanks [@freekh](https://github.com/freekh)! - **Point the assistant at something on the page.** With the preview open, the assistant has a **Select** in its header: press it, click a field on the page, and what you picked shows above the message box and goes with your next message, so "make this shorter" means that field. In code mode it can pick any element, outlined in the proposal's colour. Press the × on it to take it off.
+
+  - Selecting a field to edit has moved from the preview's toolbar to the top of the editor column, beside **Structure | On page**. Esc turns it off, from the Studio or from the page.
+  - On a desktop the assistant now sits beside the preview instead of over it, so it never covers what you point it at.
+  - The assistant can read the page in the preview, and take a picture of it, to see what you see.
+
+- Updated dependencies [[`67145fd`](https://github.com/valbuild/val/commit/67145fd16e35f2e3e0988ca5690fe5a4f84c1a41)]:
+  - @valbuild/core@0.153.0
+
 ## 0.152.1
 
 ### Patch Changes

package/client/dist/valbuild-shared-client.cjs.dev.js

@@ -2,12 +2,13 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var getSitemapTree = require('../../dist/getSitemapTree-dc61b8b6.cjs.dev.js');
+var getSitemapTree = require('../../dist/getSitemapTree-09399379.cjs.dev.js');
 require('../../dist/createForOfIteratorHelper-f2d7ac6d.cjs.dev.js');
 require('@valbuild/core');
 
 
 
+exports.CODE_CHANGED_EVENT = getSitemapTree.CODE_CHANGED_EVENT;
 exports.DEFAULT_CANVAS_SELECTION = getSitemapTree.DEFAULT_CANVAS_SELECTION;
 exports.DEFAULT_CANVAS_SELECTION_SOFT = getSitemapTree.DEFAULT_CANVAS_SELECTION_SOFT;
 exports.QUICK_PREVIEW_PARAM = getSitemapTree.QUICK_PREVIEW_PARAM;
@@ -31,6 +32,8 @@ exports.getPageRouterSitemapTree = getSitemapTree.getPageRouterSitemapTree;
 exports.getPageRouterSourceFolder = getSitemapTree.getPageRouterSourceFolder;
 exports.getPatternFromModuleFilePath = getSitemapTree.getPatternFromModuleFilePath;
 exports.getTanStackRouterSourceFolder = getSitemapTree.getTanStackRouterSourceFolder;
+exports.isCanvasSelectionColor = getSitemapTree.isCanvasSelectionColor;
+exports.isCodeChangedDetail = getSitemapTree.isCodeChangedDetail;
 exports.isQuickPreviewFiles = getSitemapTree.isQuickPreviewFiles;
 exports.isTanStackRoutesFolder = getSitemapTree.isTanStackRoutesFolder;
 exports.isValCanvasFrame = getSitemapTree.isValCanvasFrame;

package/client/dist/valbuild-shared-client.cjs.prod.js

@@ -2,12 +2,13 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var getSitemapTree = require('../../dist/getSitemapTree-d0942fca.cjs.prod.js');
+var getSitemapTree = require('../../dist/getSitemapTree-7ed70b4a.cjs.prod.js');
 require('../../dist/createForOfIteratorHelper-9ca2078d.cjs.prod.js');
 require('@valbuild/core');
 
 
 
+exports.CODE_CHANGED_EVENT = getSitemapTree.CODE_CHANGED_EVENT;
 exports.DEFAULT_CANVAS_SELECTION = getSitemapTree.DEFAULT_CANVAS_SELECTION;
 exports.DEFAULT_CANVAS_SELECTION_SOFT = getSitemapTree.DEFAULT_CANVAS_SELECTION_SOFT;
 exports.QUICK_PREVIEW_PARAM = getSitemapTree.QUICK_PREVIEW_PARAM;
@@ -31,6 +32,8 @@ exports.getPageRouterSitemapTree = getSitemapTree.getPageRouterSitemapTree;
 exports.getPageRouterSourceFolder = getSitemapTree.getPageRouterSourceFolder;
 exports.getPatternFromModuleFilePath = getSitemapTree.getPatternFromModuleFilePath;
 exports.getTanStackRouterSourceFolder = getSitemapTree.getTanStackRouterSourceFolder;
+exports.isCanvasSelectionColor = getSitemapTree.isCanvasSelectionColor;
+exports.isCodeChangedDetail = getSitemapTree.isCodeChangedDetail;
 exports.isQuickPreviewFiles = getSitemapTree.isQuickPreviewFiles;
 exports.isTanStackRoutesFolder = getSitemapTree.isTanStackRoutesFolder;
 exports.isValCanvasFrame = getSitemapTree.isValCanvasFrame;

package/client/dist/valbuild-shared-client.esm.js

@@ -1,3 +1,3 @@
-export { D as DEFAULT_CANVAS_SELECTION, e as DEFAULT_CANVAS_SELECTION_SOFT, Q as QUICK_PREVIEW_PARAM, v as QUICK_PREVIEW_RENDER_SCRIPT, u as QUICK_PREVIEW_SERVICE_WORKER_PATH, z as QUICK_PREVIEW_SERVICE_WORKER_SOURCE, x as QUICK_PREVIEW_STORE_MESSAGE, b as VAL_AI_SESSION_STORAGE_KEY, d as VAL_CANVAS_MESSAGE, c as VAL_CANVAS_PARAM, V as VAL_CONFIG_SESSION_STORAGE_KEY, a as VAL_THEME_SESSION_STORAGE_KEY, j as attachElementPicker, k as createPickerOverlay, h as describeElement, l as elementLabel, q as findBySelector, E as formatRoutePattern, F as getNextAppRouterSourceFolder, J as getPageRouterSitemapTree, H as getPageRouterSourceFolder, K as getPatternFromModuleFilePath, G as getTanStackRouterSourceFolder, y as isQuickPreviewFiles, I as isTanStackRoutesFolder, g as isValCanvasFrame, i as isValCanvasPageMessage, f as isValCanvasStudioMessage, m as modifierLabel, p as pageLocationOf, C as parseRoutePattern, o as readPageSnapshot, r as restoreScroll, t as screenshotPage, s as startElementPicking, A as storeQuickPreview, n as watchPageLocation, B as withQuickPreviewParam, w as withValCanvasParam } from '../../dist/getSitemapTree-2b22cf1b.esm.js';
+export { C as CODE_CHANGED_EVENT, D as DEFAULT_CANVAS_SELECTION, e as DEFAULT_CANVAS_SELECTION_SOFT, Q as QUICK_PREVIEW_PARAM, y as QUICK_PREVIEW_RENDER_SCRIPT, x as QUICK_PREVIEW_SERVICE_WORKER_PATH, B as QUICK_PREVIEW_SERVICE_WORKER_SOURCE, z as QUICK_PREVIEW_STORE_MESSAGE, b as VAL_AI_SESSION_STORAGE_KEY, d as VAL_CANVAS_MESSAGE, c as VAL_CANVAS_PARAM, V as VAL_CONFIG_SESSION_STORAGE_KEY, a as VAL_THEME_SESSION_STORAGE_KEY, l as attachElementPicker, n as createPickerOverlay, k as describeElement, o as elementLabel, u as findBySelector, H as formatRoutePattern, I as getNextAppRouterSourceFolder, M as getPageRouterSitemapTree, K as getPageRouterSourceFolder, N as getPatternFromModuleFilePath, J as getTanStackRouterSourceFolder, f as isCanvasSelectionColor, j as isCodeChangedDetail, A as isQuickPreviewFiles, L as isTanStackRoutesFolder, h as isValCanvasFrame, i as isValCanvasPageMessage, g as isValCanvasStudioMessage, m as modifierLabel, p as pageLocationOf, G as parseRoutePattern, t as readPageSnapshot, r as restoreScroll, v as screenshotPage, s as startElementPicking, E as storeQuickPreview, q as watchPageLocation, F as withQuickPreviewParam, w as withValCanvasParam } from '../../dist/getSitemapTree-6d875612.esm.js';
 import '../../dist/createForOfIteratorHelper-9b80f1a2.esm.js';
 import '@valbuild/core';

package/dist/declarations/src/client/index.d.ts

@@ -16,6 +16,7 @@
  */
 export * from "../internal/sessionStorage.js";
 export * from "../internal/valCanvasProtocol.js";
+export * from "../internal/codeChangedEvent.js";
 export * from "../internal/elementPicker.js";
 export * from "../internal/pageInspection.js";
 export * from "../internal/pageScreenshot.js";

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

@@ -119,6 +119,69 @@ export declare const SketchpadSummary: z.ZodObject<{
 export type SketchpadSummaryT = z.infer<typeof SketchpadSummary>;
 /** The most text a sketchpad holds, in UTF-8 bytes: a page, not a site. */
 export declare const SKETCHPAD_MAX_TEXT_LENGTH: number;
+/**
+ * A manifest as the server answers it: what each module IS on the server
+ * (`GET /manifest`, and the same answer on `/stat` when the Studio asks for it
+ * there -- one function on the server answers both, `manifestAnswer`).
+ */
+export declare const ManifestJson: z.ZodObject<{
+    project: z.ZodObject<{
+        build: z.ZodString;
+        seq: z.ZodNumber;
+    }, z.core.$strip>;
+    modules: z.ZodRecord<z.ZodString & z.ZodType<ModuleFilePath, string, z.core.$ZodTypeInternals<ModuleFilePath, string>>, z.ZodObject<{
+        schema: z.ZodString;
+        base: z.ZodString;
+        chain: z.ZodString;
+    }, z.core.$strip>>;
+    tag: z.ZodOptional<z.ZodString>;
+    since: z.ZodOptional<z.ZodNumber>;
+    superseded: z.ZodOptional<z.ZodBoolean>;
+    registry: z.ZodOptional<z.ZodObject<{
+        entry: z.ZodString;
+        core: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ManifestJsonT = z.infer<typeof ManifestJson>;
+/**
+ * The manifest a `/stat` answer carries, when the request said which one the
+ * Studio holds (`manifest` on the request): what `GET /manifest` would have
+ * answered for it, so another editor's keystroke costs no manifest request.
+ *
+ * - A manifest, whole or a delta. A delta names the ETag it is relative to
+ *   (`sinceTag`): a Studio uses it only while it holds exactly that one.
+ * - `unchanged`: the manifest the request named, at `seq`, is still the
+ *   one for this answer's `seq`. Decided by `seq` alone, and not read: a
+ *   Studio reads a manifest only for a stat whose `seq` moved. It keeps the
+ *   next request naming the same manifest.
+ *
+ * Optional: absent from a server of the release before, and from an answer
+ * to a request that did not ask, and then the Studio reads `GET /manifest`.
+ */
+export declare const StatManifest: z.ZodUnion<readonly [z.ZodObject<{
+    project: z.ZodObject<{
+        build: z.ZodString;
+        seq: z.ZodNumber;
+    }, z.core.$strip>;
+    modules: z.ZodRecord<z.ZodString & z.ZodType<ModuleFilePath, string, z.core.$ZodTypeInternals<ModuleFilePath, string>>, z.ZodObject<{
+        schema: z.ZodString;
+        base: z.ZodString;
+        chain: z.ZodString;
+    }, z.core.$strip>>;
+    tag: z.ZodOptional<z.ZodString>;
+    since: z.ZodOptional<z.ZodNumber>;
+    superseded: z.ZodOptional<z.ZodBoolean>;
+    registry: z.ZodOptional<z.ZodObject<{
+        entry: z.ZodString;
+        core: z.ZodString;
+    }, z.core.$strip>>;
+    sinceTag: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    unchanged: z.ZodLiteral<true>;
+    tag: z.ZodString;
+    seq: z.ZodNumber;
+}, z.core.$strip>]>;
+export type StatManifestT = z.infer<typeof StatManifest>;
 export declare const Api: {
     "/draft/enable": {
         GET: {
@@ -585,11 +648,19 @@ export declare const Api: {
         POST: {
             req: {
                 body: z.ZodNullable<z.ZodObject<{
-                    sourcesSha: z.ZodString;
-                    schemaSha: z.ZodString;
+                    sourcesSha: z.ZodOptional<z.ZodString>;
+                    schemaSha: z.ZodOptional<z.ZodString>;
+                    version: z.ZodOptional<z.ZodObject<{
+                        build: z.ZodString;
+                        seq: z.ZodNumber;
+                    }, z.core.$strip>>;
                     baseSha: z.ZodString;
                     patches: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     jsonEntriesSha: z.ZodOptional<z.ZodString>;
+                    manifest: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                        tag: z.ZodString;
+                        seq: z.ZodNumber;
+                    }, z.core.$strip>>>;
                 }, z.core.$strip>>;
                 cookies: {
                     val_session: z.ZodOptional<z.ZodString>;
@@ -615,8 +686,8 @@ export declare const Api: {
                 json: z.ZodUnion<readonly [z.ZodObject<{
                     type: z.ZodUnion<readonly [z.ZodLiteral<"request-again">, z.ZodLiteral<"no-change">, z.ZodLiteral<"did-change">]>;
                     baseSha: z.ZodString;
-                    schemaSha: z.ZodString;
-                    sourcesSha: z.ZodString;
+                    schemaSha: z.ZodOptional<z.ZodString>;
+                    sourcesSha: z.ZodOptional<z.ZodString>;
                     patches: z.ZodArray<z.ZodString & z.ZodType<import("@valbuild/core").PatchId, string, z.core.$ZodTypeInternals<import("@valbuild/core").PatchId, string>>>;
                     appliedPatches: z.ZodOptional<z.ZodArray<z.ZodString & z.ZodType<import("@valbuild/core").PatchId, string, z.core.$ZodTypeInternals<import("@valbuild/core").PatchId, string>>>>;
                     publishingPatches: z.ZodOptional<z.ZodArray<z.ZodString & z.ZodType<import("@valbuild/core").PatchId, string, z.core.$ZodTypeInternals<import("@valbuild/core").PatchId, string>>>>;
@@ -653,13 +724,36 @@ export declare const Api: {
                         build: z.ZodString;
                         seq: z.ZodNumber;
                     }, z.core.$strip>>;
+                    manifest: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+                        project: z.ZodObject<{
+                            build: z.ZodString;
+                            seq: z.ZodNumber;
+                        }, z.core.$strip>;
+                        modules: z.ZodRecord<z.ZodString & z.ZodType<ModuleFilePath, string, z.core.$ZodTypeInternals<ModuleFilePath, string>>, z.ZodObject<{
+                            schema: z.ZodString;
+                            base: z.ZodString;
+                            chain: z.ZodString;
+                        }, z.core.$strip>>;
+                        tag: z.ZodOptional<z.ZodString>;
+                        since: z.ZodOptional<z.ZodNumber>;
+                        superseded: z.ZodOptional<z.ZodBoolean>;
+                        registry: z.ZodOptional<z.ZodObject<{
+                            entry: z.ZodString;
+                            core: z.ZodString;
+                        }, z.core.$strip>>;
+                        sinceTag: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>, z.ZodObject<{
+                        unchanged: z.ZodLiteral<true>;
+                        tag: z.ZodString;
+                        seq: z.ZodNumber;
+                    }, z.core.$strip>]>>;
                 }, z.core.$strip>, z.ZodObject<{
                     type: z.ZodLiteral<"use-websocket">;
                     url: z.ZodString;
                     nonce: z.ZodString;
                     baseSha: z.ZodString;
-                    schemaSha: z.ZodString;
-                    sourcesSha: z.ZodString;
+                    schemaSha: z.ZodOptional<z.ZodString>;
+                    sourcesSha: z.ZodOptional<z.ZodString>;
                     commitSha: z.ZodOptional<z.ZodString>;
                     patches: z.ZodArray<z.ZodString & z.ZodType<import("@valbuild/core").PatchId, string, z.core.$ZodTypeInternals<import("@valbuild/core").PatchId, string>>>;
                     appliedPatches: z.ZodOptional<z.ZodArray<z.ZodString & z.ZodType<import("@valbuild/core").PatchId, string, z.core.$ZodTypeInternals<import("@valbuild/core").PatchId, string>>>>;
@@ -711,6 +805,29 @@ export declare const Api: {
                         build: z.ZodString;
                         seq: z.ZodNumber;
                     }, z.core.$strip>>;
+                    manifest: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+                        project: z.ZodObject<{
+                            build: z.ZodString;
+                            seq: z.ZodNumber;
+                        }, z.core.$strip>;
+                        modules: z.ZodRecord<z.ZodString & z.ZodType<ModuleFilePath, string, z.core.$ZodTypeInternals<ModuleFilePath, string>>, z.ZodObject<{
+                            schema: z.ZodString;
+                            base: z.ZodString;
+                            chain: z.ZodString;
+                        }, z.core.$strip>>;
+                        tag: z.ZodOptional<z.ZodString>;
+                        since: z.ZodOptional<z.ZodNumber>;
+                        superseded: z.ZodOptional<z.ZodBoolean>;
+                        registry: z.ZodOptional<z.ZodObject<{
+                            entry: z.ZodString;
+                            core: z.ZodString;
+                        }, z.core.$strip>>;
+                        sinceTag: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>, z.ZodObject<{
+                        unchanged: z.ZodLiteral<true>;
+                        tag: z.ZodString;
+                        seq: z.ZodNumber;
+                    }, z.core.$strip>]>>;
                 }, z.core.$strip>]>;
             }, z.core.$strip>]>;
         };
@@ -1430,100 +1547,6 @@ export declare const Api: {
             }, z.core.$strip>]>;
         };
     };
-    /**
-     * @deprecated The whole tree. Nothing of this release asks it: the Studio
-     * reads modules by version (`GET /manifest`, `GET /modules/~`), the draft
-     * readers and MCP read the head in-process. Kept, with `exclude_patches`
-     * (`BaseAlignment`'s fetch) and the ignored `validate_sources` and
-     * `validate_binary_files`, for a Studio of the release before; goes in the
-     * release after the one that ships this (see "Release-delayed deletions"
-     * in `docs/plans/one-content-model.md`).
-     */
-    "/sources/~": {
-        PUT: {
-            req: {
-                path: z.ZodOptional<z.ZodString>;
-                query: {
-                    validate_sources: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string, string[]>> & z.ZodType<"true" | "false", string[], z.core.$ZodTypeInternals<"true" | "false", string[]>>, z.ZodTransform<boolean, "true" | "false">>>;
-                    validate_binary_files: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string, string[]>> & z.ZodType<"true" | "false", string[], z.core.$ZodTypeInternals<"true" | "false", string[]>>, z.ZodTransform<boolean, "true" | "false">>>;
-                    exclude_patches: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string, string[]>> & z.ZodType<"true" | "false", string[], z.core.$ZodTypeInternals<"true" | "false", string[]>>, z.ZodTransform<boolean, "true" | "false">>>;
-                    apply_patches: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string, string[]>> & z.ZodType<"true" | "false", string[], z.core.$ZodTypeInternals<"true" | "false", string[]>>, z.ZodTransform<boolean, "true" | "false">>>;
-                };
-                cookies: {
-                    val_session: z.ZodOptional<z.ZodString>;
-                };
-            };
-            res: z.ZodUnion<readonly [z.ZodObject<{
-                status: z.ZodLiteral<401>;
-                json: z.ZodObject<{
-                    message: z.ZodString;
-                }, z.core.$strip>;
-            }, z.core.$strip>, z.ZodObject<{
-                status: z.ZodLiteral<401>;
-                json: z.ZodObject<{
-                    message: z.ZodString;
-                }, z.core.$strip>;
-            }, z.core.$strip>, z.ZodObject<{
-                status: z.ZodLiteral<500>;
-                json: z.ZodObject<{
-                    message: z.ZodString;
-                    details: z.ZodUnion<readonly [z.ZodArray<z.ZodObject<{
-                        message: z.ZodString;
-                        path: z.ZodOptional<z.ZodString & z.ZodType<ModuleFilePath, string, z.core.$ZodTypeInternals<ModuleFilePath, string>>>;
-                    }, z.core.$strip>>, z.ZodObject<{
-                        message: z.ZodString;
-                    }, z.core.$strip>]>;
-                }, z.core.$strip>;
-            }, z.core.$strip>, z.ZodObject<{
-                status: z.ZodLiteral<409>;
-                json: z.ZodObject<{
-                    message: z.ZodString;
-                }, z.core.$strip>;
-            }, z.core.$strip>, z.ZodObject<{
-                status: z.ZodLiteral<400>;
-                json: z.ZodObject<{
-                    message: z.ZodString;
-                    details: z.ZodArray<z.ZodObject<{
-                        message: z.ZodString;
-                        path: z.ZodOptional<z.ZodString & z.ZodType<ModuleFilePath, string, z.core.$ZodTypeInternals<ModuleFilePath, string>>>;
-                    }, z.core.$strip>>;
-                }, z.core.$strip>;
-            }, z.core.$strip>, z.ZodObject<{
-                status: z.ZodLiteral<200>;
-                json: z.ZodObject<{
-                    schemaSha: z.ZodString;
-                    sourcesSha: z.ZodString;
-                    modules: z.ZodRecord<z.ZodString & z.ZodType<ModuleFilePath, string, z.core.$ZodTypeInternals<ModuleFilePath, string>>, z.ZodObject<{
-                        preview: z.ZodOptional<z.ZodAny>;
-                        source: z.ZodOptional<z.ZodAny>;
-                        baseSource: z.ZodOptional<z.ZodAny>;
-                        patches: z.ZodOptional<z.ZodObject<{
-                            applied: z.ZodArray<z.ZodString & z.ZodType<import("@valbuild/core").PatchId, string, z.core.$ZodTypeInternals<import("@valbuild/core").PatchId, string>>>;
-                            skipped: z.ZodOptional<z.ZodArray<z.ZodString & z.ZodType<import("@valbuild/core").PatchId, string, z.core.$ZodTypeInternals<import("@valbuild/core").PatchId, string>>>>;
-                            errors: z.ZodOptional<z.ZodRecord<z.ZodString & z.ZodType<import("@valbuild/core").PatchId, string, z.core.$ZodTypeInternals<import("@valbuild/core").PatchId, string>>, z.ZodObject<{
-                                message: z.ZodString;
-                            }, z.core.$strip>>>;
-                        }, z.core.$strip>>;
-                        validationErrors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodObject<{
-                            message: z.ZodString;
-                            value: z.ZodOptional<z.ZodUnknown>;
-                            fatal: z.ZodOptional<z.ZodBoolean>;
-                            fixes: z.ZodOptional<z.ZodArray<z.ZodType<"image:add-metadata" | "image:check-metadata" | "image:upload-remote" | "image:download-remote" | "image:check-remote" | "images:check-remote" | "images:upload-remote" | "file:add-metadata" | "file:check-metadata" | "file:upload-remote" | "file:download-remote" | "file:check-remote" | "files:check-remote" | "files:upload-remote" | "video:add-metadata" | "video:upload-remote" | "video:download-remote" | "videos:add-metadata" | "videos:check-remote" | "videos:upload-remote" | "keyof:check-keys" | "image:check-gallery" | "file:check-gallery" | "video:check-gallery" | "router:check-route" | "locale:check-locale" | "router:check-locale-param" | "images:check-unique-folder" | "files:check-unique-folder" | "images:check-all-files" | "files:check-all-files" | "videos:check-unique-folder" | "videos:check-all-files" | "jsonValues:extract-entry" | "record:fill-keys" | "external:upload" | "view:check-module" | "remote:rewrite-host", unknown, z.core.$ZodTypeInternals<"image:add-metadata" | "image:check-metadata" | "image:upload-remote" | "image:download-remote" | "image:check-remote" | "images:check-remote" | "images:upload-remote" | "file:add-metadata" | "file:check-metadata" | "file:upload-remote" | "file:download-remote" | "file:check-remote" | "files:check-remote" | "files:upload-remote" | "video:add-metadata" | "video:upload-remote" | "video:download-remote" | "videos:add-metadata" | "videos:check-remote" | "videos:upload-remote" | "keyof:check-keys" | "image:check-gallery" | "file:check-gallery" | "video:check-gallery" | "router:check-route" | "locale:check-locale" | "router:check-locale-param" | "images:check-unique-folder" | "files:check-unique-folder" | "images:check-all-files" | "files:check-all-files" | "videos:check-unique-folder" | "videos:check-all-files" | "jsonValues:extract-entry" | "record:fill-keys" | "external:upload" | "view:check-module" | "remote:rewrite-host", unknown>>>>;
-                        }, z.core.$strip>>>>;
-                        version: z.ZodOptional<z.ZodObject<{
-                            schema: z.ZodString;
-                            base: z.ZodString;
-                            chain: z.ZodString;
-                        }, z.core.$strip>>;
-                    }, z.core.$strip>>;
-                    project: z.ZodOptional<z.ZodObject<{
-                        build: z.ZodString;
-                        seq: z.ZodNumber;
-                    }, z.core.$strip>>;
-                }, z.core.$strip>;
-            }, z.core.$strip>]>;
-        };
-    };
     /**
      * One module by version: phase 6 of `docs/plans/one-content-model.md`
      * ("The Studio loads everything from one place"). `GET /modules/~<path>`,

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

@@ -0,0 +1,15 @@
+import type { ModuleFilePath } from "@valbuild/core";
+/**
+ * The `val-overlay-spa` event a page sends when what it renders and what the
+ * Studio relays have stopped agreeing about the code: these modules came
+ * made with another schema than this page's build has. The on-site overlay
+ * shows it with a reload; in the Studio's canvas the bridge passes it on
+ * (`codeChanged` in `valCanvasProtocol.ts`). An empty list takes it back.
+ */
+export declare const CODE_CHANGED_EVENT = "codeChanged";
+export type CodeChangedDetail = {
+    type: typeof CODE_CHANGED_EVENT;
+    modules: ModuleFilePath[];
+};
+/** Whether a `val-overlay-spa` event's detail is a {@link CodeChangedDetail}. */
+export declare function isCodeChangedDetail(detail: unknown): detail is CodeChangedDetail;

package/dist/declarations/src/internal/content/version.d.ts

@@ -1,4 +1,4 @@
-import { type ModuleFilePath, type PatchId } from "@valbuild/core";
+import { type ModuleFilePath, type PatchId, type SelectorSource, type ValModule } from "@valbuild/core";
 import { z } from "zod";
 /**
  * What a module's content IS: the schema it is read and patched with, the
@@ -81,6 +81,15 @@ export declare function chainOf(ids: readonly PatchId[]): string;
  * (from what it holds in `SchemaStore`), so the two compare.
  */
 export declare function schemaVersionOf(serializedSchema: unknown): string;
+/**
+ * The version of the schema a reader's own code has for a module: what the
+ * readers hold relayed or drafted content's version against (`layered`'s
+ * schema rule), so content is never read with a schema it was not made for.
+ * The server readers (`fetchVal`) and the page's hooks (`useVal`) alike.
+ * Hashed once per module object, which a build makes once: a load cost, not
+ * a read cost.
+ */
+export declare function readerSchemaVersion(module: ValModule<SelectorSource>): string | null;
 /**
  * A module's base version, from its base source: what the module evaluates
  * to, or what a content version or a publish put in its place. `.jsonValues()`

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

@@ -42,6 +42,12 @@ export type ElementPickerOptions = {
     modifier: PickModifier;
     /** On without the modifier: a Select button, or a touch screen. */
     active: () => boolean;
+    /**
+     * Only what shows a Val field can be picked: the field's element is taken
+     * for anything inside it, and nothing outside one is. The Studio's
+     * assistant outside code mode, where what can be changed is content.
+     */
+    fieldsOnly?: () => boolean;
     /** The element under the pointer while picking; `null` when not picking. */
     onHover: (element: Element | null) => void;
     onPick: (element: Element) => void;
@@ -88,6 +94,8 @@ export type ElementPicking = {
 export declare function startElementPicking(root: HTMLElement, options: {
     modifier: PickModifier;
     active: () => boolean;
+    /** See `ElementPickerOptions.fieldsOnly`. */
+    fieldsOnly?: () => boolean;
     color: string;
     onPick: (picked: PickedElement) => void;
     /** Esc while `active`: the Studio turns Select off. */

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

@@ -58,3 +58,4 @@ export * from "./patchSets/selectionClosure.js";
 export * from "./patchSets/schemaTypesOfPath.js";
 export * from "./proposalMerge/trees.js";
 export * from "./selfCheck.js";
+export * from "./codeChangedEvent.js";

package/dist/declarations/src/internal/sketchpad/sketchFormat.d.ts

@@ -5,8 +5,6 @@
  * --- /about                   a route: what follows is the page at /about
  * # Our people                 text (a heading: #, ## or ###)
  * We are 40 people in Oslo.    text (a paragraph)
- * ## Hi {field: /x.val.ts?p="t"}  text linked to a content field: typing
- *                              in it writes the field
  * [image: Team photo]          placeholder: [kind] or [kind: label]
  * [hero: Roof](image: /a.jpg)  a placeholder with an image (or video) in it
  * icon hero M3 5h18v14H3z      how every [hero] box is drawn: SVG path data
@@ -62,13 +60,6 @@ export type SketchText = {
     /** 0 is a paragraph; 1-3 are headings. */
     level: 0 | 1 | 2 | 3;
     text: string;
-    /**
-     * The content field this text is linked to, as a source path
-     * (`/content/home.val.ts?p="hero"."title"`): typing in the block writes
-     * the field. Written `{field: <source path>}` at the end of the line. One
-     * block per field: a second link to the same field is not one.
-     */
-    field?: string;
 };
 export type SketchPlaceholder = {
     type: "placeholder";
@@ -109,7 +100,7 @@ export declare function parseSketch(source: string): ParsedSketch;
  * The line a text block is written as. Line breaks become spaces, and a
  * paragraph that would read as something else is kept as text with `\`.
  */
-export declare function formatSketchText(level: SketchText["level"], text: string, field?: string): string;
+export declare function formatSketchText(level: SketchText["level"], text: string): string;
 /** The line a placeholder is written as. */
 export declare function formatSketchBox(placeholder: Pick<SketchPlaceholder, "kind" | "label" | "media">): string;
 /**
@@ -122,12 +113,6 @@ export declare function formatSketchBox(placeholder: Pick<SketchPlaceholder, "ki
  * it is not on the page.
  */
 export declare function formatSketch(blocks: SketchNode[], icons: Record<string, string>): string;
-/**
- * The text of every block linked to a field, by field: what the Studio
- * writes to the content when a linked block changes. The first block wins,
- * as `formatSketch` keeps only its link.
- */
-export declare function sketchFieldTexts(blocks: SketchNode[]): Map<string, string>;
 /** The pages a sketch is about, in the order it gives them. */
 export declare function sketchRoutes(blocks: SketchNode[]): string[];
 /**

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

@@ -211,6 +211,13 @@ export type ValCanvasPageMessage = {
      */
     val: typeof VAL_CANVAS_MESSAGE;
     type: "elementPickingStopped";
+} | {
+    /**
+     * Esc on the page while picking FIELDS (`setPicking`): Content's Select
+     * turns off. Its twin for any element is `elementPickingStopped`.
+     */
+    val: typeof VAL_CANVAS_MESSAGE;
+    type: "pickingStopped";
 } | ({
     /**
      * Where the page is: its path and scroll, as it moves. A new build
@@ -245,6 +252,16 @@ export type ValCanvasPageMessage = {
     type: "quickPreviewStored";
     id: string;
     error?: string;
+} | {
+    /**
+     * Modules the Studio sent made with another schema than this page's
+     * build has: the page shows its bundle's content for them instead, and
+     * the Studio says the code changed, with a reload. An empty list: the
+     * page's code caught up (`CodeChangedDetail`).
+     */
+    val: typeof VAL_CANVAS_MESSAGE;
+    type: "codeChanged";
+    modules: ModuleFilePath[];
 };
 /** What the studio tells the page. */
 export type ValCanvasStudioMessage = {
@@ -275,20 +292,12 @@ export type ValCanvasStudioMessage = {
     type: "sourceUpdate";
     moduleFilePath: ModuleFilePath;
     /**
-     * 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.
+     * The module as a read (`ModuleRead`: its source and version), which
+     * the page keeps as it is. `unknown` because the page's own types are
+     * the ones that give it meaning; nothing in between should be
+     * interpreting it.
      */
-    read?: unknown;
+    read: unknown;
 } | {
     /**
      * Everything the studio holds has been sent.
@@ -374,6 +383,17 @@ export type ValCanvasStudioMessage = {
     modifier: PickModifier;
     /** Whether the studio still holds the last pick: false takes its outline down. */
     keepPicked: boolean;
+    /**
+     * Only Val's fields can be picked (`fieldsOnly` in `elementPicker.ts`):
+     * the Studio's assistant outside code mode. Absent is any element, so
+     * a studio that predates it is answered as before.
+     */
+    fieldsOnly?: boolean;
+    /**
+     * What to outline in, instead of the `theme`'s selection colour: code
+     * mode's proposal colour. A bridge that predates it uses the theme's.
+     */
+    color?: string;
 } | {
     /** Scroll to where the page before this one was (`location`). */
     val: typeof VAL_CANVAS_MESSAGE;
@@ -414,6 +434,7 @@ export type ValCanvasStudioMessage = {
 };
 /** Narrow an unknown `event.data` to a message from the page. */
 export declare function isValCanvasPageMessage(data: unknown): data is ValCanvasPageMessage;
+export declare function isCanvasSelectionColor(value: unknown): value is string;
 /** Narrow an unknown `event.data` to a message from the studio. */
 export declare function isValCanvasStudioMessage(data: unknown): data is ValCanvasStudioMessage;
 /**

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

@@ -16,7 +16,12 @@ export type StudioBuilder = {
     publishArtifacts: Builder["publishArtifacts"];
     /** A build's name, before building it: see `buildInputId`. */
     buildInputId: Builder["buildInputId"];
-    /** A tree's Val modules, as one module to evaluate: see `bundleValModules`. */
-    bundleValModules: Builder["bundleValModules"];
+    /**
+     * A tree's Val modules, as one module to evaluate: see `bundleValModules`.
+     * The Studio evaluates the code and nothing else; what each module depends
+     * on is for the server build (`moduleDependencies`), so it is not asked of
+     * the builder here.
+     */
+    bundleValModules: (...args: Parameters<Builder["bundleValModules"]>) => Promise<Pick<Awaited<ReturnType<Builder["bundleValModules"]>>, "code">>;
 };
 export {};