@valbuild/shared 0.152.0 → 0.153.0

package/CHANGELOG.md

@@ -1,5 +1,55 @@
 # @valbuild/shared
 
+## 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
+
+- [#1019](https://github.com/valbuild/val/pull/1019) [`b9089c8`](https://github.com/valbuild/val/commit/b9089c8787da8075722cc4ef3672beb61b288af4) Thanks [@freekh](https://github.com/freekh)! - **What the design tab needed is removed with it.** The page's canvas bridge
+  now answers `read_page`, `screenshot_page` and a quick preview only to the
+  Studio at the page's own origin, and no longer asks the server whether another
+  origin is the site's design tab. The site's server no longer writes a
+  proposal's files or offers the `patch-file` route: code and content are
+  changed in the proposal's own Studio. The assistant's `build_proposal` no
+  longer takes a `reason`.
+
 ## 0.152.0
 
 ### Minor Changes

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

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var getSitemapTree = require('../../dist/getSitemapTree-59c5ed5d.cjs.dev.js');
+var getSitemapTree = require('../../dist/getSitemapTree-32643b50.cjs.dev.js');
 require('../../dist/createForOfIteratorHelper-f2d7ac6d.cjs.dev.js');
 require('@valbuild/core');
 
@@ -31,7 +31,7 @@ exports.getPageRouterSitemapTree = getSitemapTree.getPageRouterSitemapTree;
 exports.getPageRouterSourceFolder = getSitemapTree.getPageRouterSourceFolder;
 exports.getPatternFromModuleFilePath = getSitemapTree.getPatternFromModuleFilePath;
 exports.getTanStackRouterSourceFolder = getSitemapTree.getTanStackRouterSourceFolder;
-exports.isDesignTabOrigin = getSitemapTree.isDesignTabOrigin;
+exports.isCanvasSelectionColor = getSitemapTree.isCanvasSelectionColor;
 exports.isQuickPreviewFiles = getSitemapTree.isQuickPreviewFiles;
 exports.isTanStackRoutesFolder = getSitemapTree.isTanStackRoutesFolder;
 exports.isValCanvasFrame = getSitemapTree.isValCanvasFrame;
@@ -40,7 +40,6 @@ exports.isValCanvasStudioMessage = getSitemapTree.isValCanvasStudioMessage;
 exports.modifierLabel = getSitemapTree.modifierLabel;
 exports.pageLocationOf = getSitemapTree.pageLocationOf;
 exports.parseRoutePattern = getSitemapTree.parseRoutePattern;
-exports.quickPreviewSiteOrigin = getSitemapTree.quickPreviewSiteOrigin;
 exports.readPageSnapshot = getSitemapTree.readPageSnapshot;
 exports.restoreScroll = getSitemapTree.restoreScroll;
 exports.screenshotPage = getSitemapTree.screenshotPage;

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

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var getSitemapTree = require('../../dist/getSitemapTree-6b9024d1.cjs.prod.js');
+var getSitemapTree = require('../../dist/getSitemapTree-a4738117.cjs.prod.js');
 require('../../dist/createForOfIteratorHelper-9ca2078d.cjs.prod.js');
 require('@valbuild/core');
 
@@ -31,7 +31,7 @@ exports.getPageRouterSitemapTree = getSitemapTree.getPageRouterSitemapTree;
 exports.getPageRouterSourceFolder = getSitemapTree.getPageRouterSourceFolder;
 exports.getPatternFromModuleFilePath = getSitemapTree.getPatternFromModuleFilePath;
 exports.getTanStackRouterSourceFolder = getSitemapTree.getTanStackRouterSourceFolder;
-exports.isDesignTabOrigin = getSitemapTree.isDesignTabOrigin;
+exports.isCanvasSelectionColor = getSitemapTree.isCanvasSelectionColor;
 exports.isQuickPreviewFiles = getSitemapTree.isQuickPreviewFiles;
 exports.isTanStackRoutesFolder = getSitemapTree.isTanStackRoutesFolder;
 exports.isValCanvasFrame = getSitemapTree.isValCanvasFrame;
@@ -40,7 +40,6 @@ exports.isValCanvasStudioMessage = getSitemapTree.isValCanvasStudioMessage;
 exports.modifierLabel = getSitemapTree.modifierLabel;
 exports.pageLocationOf = getSitemapTree.pageLocationOf;
 exports.parseRoutePattern = getSitemapTree.parseRoutePattern;
-exports.quickPreviewSiteOrigin = getSitemapTree.quickPreviewSiteOrigin;
 exports.readPageSnapshot = getSitemapTree.readPageSnapshot;
 exports.restoreScroll = getSitemapTree.restoreScroll;
 exports.screenshotPage = getSitemapTree.screenshotPage;

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, G as formatRoutePattern, H as getNextAppRouterSourceFolder, L as getPageRouterSitemapTree, J as getPageRouterSourceFolder, M as getPatternFromModuleFilePath, I as getTanStackRouterSourceFolder, E as isDesignTabOrigin, y as isQuickPreviewFiles, K as isTanStackRoutesFolder, g as isValCanvasFrame, i as isValCanvasPageMessage, f as isValCanvasStudioMessage, m as modifierLabel, p as pageLocationOf, F as parseRoutePattern, C as quickPreviewSiteOrigin, 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-3c1b9e57.esm.js';
+export { D as DEFAULT_CANVAS_SELECTION, e as DEFAULT_CANVAS_SELECTION_SOFT, Q as QUICK_PREVIEW_PARAM, x as QUICK_PREVIEW_RENDER_SCRIPT, v as QUICK_PREVIEW_SERVICE_WORKER_PATH, A as QUICK_PREVIEW_SERVICE_WORKER_SOURCE, y 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, k as attachElementPicker, l as createPickerOverlay, j as describeElement, n as elementLabel, t as findBySelector, F as formatRoutePattern, G as getNextAppRouterSourceFolder, K as getPageRouterSitemapTree, I as getPageRouterSourceFolder, L as getPatternFromModuleFilePath, H as getTanStackRouterSourceFolder, f as isCanvasSelectionColor, z as isQuickPreviewFiles, J as isTanStackRoutesFolder, h as isValCanvasFrame, i as isValCanvasPageMessage, g as isValCanvasStudioMessage, m as modifierLabel, p as pageLocationOf, E as parseRoutePattern, q as readPageSnapshot, r as restoreScroll, u as screenshotPage, s as startElementPicking, B as storeQuickPreview, o as watchPageLocation, C as withQuickPreviewParam, w as withValCanvasParam } from '../../dist/getSitemapTree-a887fed4.esm.js';
 import '../../dist/createForOfIteratorHelper-9b80f1a2.esm.js';
 import '@valbuild/core';

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/elementPicker.d.ts

@@ -1,9 +1,9 @@
 /**
  * Pointing at anything on a page, as Lovable's picker does: hover outlines
  * the element under the pointer, a click picks it, and the assistant is told
- * which (valbuild/home `docs/design-tab.md`).
+ * which.
  *
- * ANY element, not only what Val marks. The design tab changes code, and the
+ * ANY element, not only what Val marks. The assistant changes code, and the
  * thing a person wants changed is as often a wrapper, a gap or a button as a
  * field -- so a field's path is extra information when there is one
  * (`valPath`), never the condition for picking.
@@ -14,9 +14,8 @@
  *
  * Plain DOM, nothing of React's or the Studio's, and in `shared` because
  * both halves need it: the canvas bridge (`@valbuild/next`,
- * `@valbuild/tanstack`) runs it inside the proposal's page, which is another
- * origin than the design tab and the only place the page's elements can be
- * reached; the Studio's stories run it on a page of their own. Only the
+ * `@valbuild/tanstack`) runs it inside the page, the only place the page's
+ * elements can be reached; the Studio's stories run it on a page of their own. Only the
  * `PickedElement` crosses the frame (`valCanvasProtocol.ts`).
  */
 export type PickedElement = {
@@ -43,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;
@@ -89,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/pageInspection.d.ts

@@ -1,5 +1,5 @@
 /**
- * Looking at a page from the design tab (valbuild/home `docs/design-tab.md`):
+ * Looking at a page from the Studio:
  * where it is -- its path and scroll, so a new build opens at the same place
  * -- and what is on it, so the assistant can check its own change
  * (`read_page`).

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

@@ -3,9 +3,8 @@
  * `screenshot_page`, so it can see a change it made rather than only read it
  * (`read_page` gives the words and the boxes).
  *
- * Taken HERE because nothing else can: the design tab is another origin than
- * the proposal's page in its frame, and a browser lets no page photograph a
- * frame of another origin. So the bridge renders its own document --
+ * Taken HERE, in the page: a browser lets no page photograph a frame, so
+ * the bridge renders its own document --
  * `modern-screenshot` draws the DOM, with its computed styles, fonts and
  * same-origin images, into a canvas -- and hands back a JPEG.
  *

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

@@ -1,11 +1,10 @@
 /**
  * A quick preview: a proposal's page, running the proposal's CLIENT code
- * built in the design tab, without a build being uploaded or served
- * (valbuild/home `docs/design-tab.md`).
+ * built in the Studio, without a build being uploaded or served.
  *
  * A full build of a proposal bundles the app for the server and the browser,
  * uploads it, and has the platform render every page before it is served --
- * minutes. Most of what the design tab changes is components and styles,
+ * minutes. Most of what the assistant changes is components and styles,
  * which the browser half alone shows. So the tab bundles the app in its
  * builder worker, and a service worker on the proposal's address hands the
  * page that bundle instead of the served one:
@@ -23,7 +22,7 @@
  * 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
+ *    which is most of what the assistant 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
@@ -82,26 +81,3 @@ export declare function storeQuickPreview(id: string, files: QuickPreviewFiles,
 }): Promise<void>;
 /** The address of a page as a quick preview `id`. */
 export declare function withQuickPreviewParam(url: string, id: string): string;
-/**
- * The one origin allowed to send this page a quick preview: the site's, where
- * the design tab is, as this page's own Val server says it (the proposals
- * list's `siteUrl`). `null` when it does not say.
- *
- * A quick preview is code that runs on this address, so the bridge takes one
- * only from its parent, and only when that parent is the site: a page that
- * framed this one could otherwise post a script into the worker and open
- * the frame on it.
- */
-export declare function quickPreviewSiteOrigin(api: string, fetchImpl?: typeof fetch): Promise<string | null>;
-/**
- * Whether `origin` may ask this page for what only the design tab should
- * have -- what is on it (`readPage`), or code to run (`quickPreview`): this
- * page's own origin (the Studio's canvas), or the site's, where the design
- * tab is ({@link quickPreviewSiteOrigin}). Asked of the server once, and
- * again only while it has not said.
- */
-export declare function isDesignTabOrigin(origin: string, options: {
-    api: string;
-    own: string;
-    fetchImpl?: typeof fetch;
-}): Promise<boolean>;

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

@@ -211,10 +211,17 @@ 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. The design tab
-     * opens a new build there (`scrollTo`), so a new version replaces the
+     * Where the page is: its path and scroll, as it moves. A new build
+     * is opened there (`scrollTo`), so a new version replaces the
      * page in place rather than starting over at the top of the front page.
      */
     val: typeof VAL_CANVAS_MESSAGE;
@@ -275,20 +282,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`.
+     * 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.
      */
-    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;
+    read: unknown;
 } | {
     /**
      * Everything the studio holds has been sent.
@@ -358,7 +357,7 @@ export type ValCanvasStudioMessage = {
     picking: boolean;
 } | {
     /**
-     * Picking ANY element, as the design tab does (`elementPicker.ts`),
+     * Picking ANY element (`elementPicker.ts`),
      * rather than the fields Val tagged, as `setPicking` does.
      *
      * While `enabled`, holding `modifier` outlines what is under the
@@ -374,6 +373,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 +424,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 {};