@valbuild/shared 0.152.1 → 0.153.0

package/CHANGELOG.md

@@ -1,5 +1,43 @@
 # @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

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

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var getSitemapTree = require('../../dist/getSitemapTree-dc61b8b6.cjs.dev.js');
+var getSitemapTree = require('../../dist/getSitemapTree-32643b50.cjs.dev.js');
 require('../../dist/createForOfIteratorHelper-f2d7ac6d.cjs.dev.js');
 require('@valbuild/core');
 
@@ -31,6 +31,7 @@ exports.getPageRouterSitemapTree = getSitemapTree.getPageRouterSitemapTree;
 exports.getPageRouterSourceFolder = getSitemapTree.getPageRouterSourceFolder;
 exports.getPatternFromModuleFilePath = getSitemapTree.getPatternFromModuleFilePath;
 exports.getTanStackRouterSourceFolder = getSitemapTree.getTanStackRouterSourceFolder;
+exports.isCanvasSelectionColor = getSitemapTree.isCanvasSelectionColor;
 exports.isQuickPreviewFiles = getSitemapTree.isQuickPreviewFiles;
 exports.isTanStackRoutesFolder = getSitemapTree.isTanStackRoutesFolder;
 exports.isValCanvasFrame = getSitemapTree.isValCanvasFrame;

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

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var getSitemapTree = require('../../dist/getSitemapTree-d0942fca.cjs.prod.js');
+var getSitemapTree = require('../../dist/getSitemapTree-a4738117.cjs.prod.js');
 require('../../dist/createForOfIteratorHelper-9ca2078d.cjs.prod.js');
 require('@valbuild/core');
 
@@ -31,6 +31,7 @@ exports.getPageRouterSitemapTree = getSitemapTree.getPageRouterSitemapTree;
 exports.getPageRouterSourceFolder = getSitemapTree.getPageRouterSourceFolder;
 exports.getPatternFromModuleFilePath = getSitemapTree.getPatternFromModuleFilePath;
 exports.getTanStackRouterSourceFolder = getSitemapTree.getTanStackRouterSourceFolder;
+exports.isCanvasSelectionColor = getSitemapTree.isCanvasSelectionColor;
 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 { 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

@@ -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/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
@@ -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.
@@ -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 {};

package/dist/{getSitemapTree-dc61b8b6.cjs.dev.js → getSitemapTree-32643b50.cjs.dev.js}

@@ -250,7 +250,7 @@ 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" && 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";
+  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 === "pickingStopped" || 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. */
@@ -313,7 +313,7 @@ function isValCanvasStudioMessage(data) {
   }
   if (message.type === "pickElements") {
     var pick = data;
-    return typeof pick.enabled === "boolean" && typeof pick.active === "boolean" && typeof pick.keepPicked === "boolean" && PICK_MODIFIERS.includes(pick.modifier);
+    return typeof pick.enabled === "boolean" && typeof pick.active === "boolean" && typeof pick.keepPicked === "boolean" && PICK_MODIFIERS.includes(pick.modifier) && (pick.fieldsOnly === undefined || typeof pick.fieldsOnly === "boolean") && (pick.color === undefined || isCanvasSelectionColor(pick.color));
   }
   if (message.type === "scrollTo") {
     var scroll = data;
@@ -471,8 +471,15 @@ function attachElementPicker(root, options) {
   var picking = function picking(event) {
     return options.active() || held(event, options.modifier);
   };
+  var pickable = function pickable(element) {
+    var _options$fieldsOnly;
+    if (element === null || !root.contains(element)) return null;
+    if (((_options$fieldsOnly = options.fieldsOnly) === null || _options$fieldsOnly === void 0 ? void 0 : _options$fieldsOnly.call(options)) !== true) return element;
+    var field = element.closest("[data-val-path]");
+    return field !== null && root.contains(field) ? field : null;
+  };
   var target = function target(event) {
-    return event.target instanceof Element && root.contains(event.target) ? event.target : null;
+    return pickable(event.target instanceof Element ? event.target : null);
   };
   var onMove = function onMove(event) {
     last = {
@@ -533,8 +540,7 @@ function attachElementPicker(root, options) {
       return;
     }
     if (last === null) return;
-    var under = root.ownerDocument.elementFromPoint(last.x, last.y);
-    options.onHover(under !== null && root.contains(under) ? under : null);
+    options.onHover(pickable(root.ownerDocument.elementFromPoint(last.x, last.y)));
   };
   var onLeave = function onLeave() {
     last = null;
@@ -636,7 +642,9 @@ function createPickerOverlay(doc, initialColor) {
       left: "".concat(rect.left - 2, "px"),
       width: "".concat(rect.width + 4, "px"),
       height: "".concat(rect.height + 4, "px"),
-      border: "2px ".concat(kind === "hover" ? "solid" : "dashed", " ").concat(color)
+      // Dashed, both: it is what the assistant is pointed at, and the
+      // canvas's own field outlines -- Content's Select -- are solid.
+      border: "2px dashed ".concat(color)
     });
     if (kind === "hover") {
       label.textContent = elementLabel(element);
@@ -707,6 +715,7 @@ function startElementPicking(root, options) {
   var detach = attachElementPicker(root, {
     modifier: options.modifier,
     active: options.active,
+    fieldsOnly: options.fieldsOnly,
     onHover: function onHover(element) {
       return overlay.show("hover", element);
     },
@@ -1478,6 +1487,7 @@ exports.getPageRouterSitemapTree = getPageRouterSitemapTree;
 exports.getPageRouterSourceFolder = getPageRouterSourceFolder;
 exports.getPatternFromModuleFilePath = getPatternFromModuleFilePath;
 exports.getTanStackRouterSourceFolder = getTanStackRouterSourceFolder;
+exports.isCanvasSelectionColor = isCanvasSelectionColor;
 exports.isQuickPreviewFiles = isQuickPreviewFiles;
 exports.isTanStackRoutesFolder = isTanStackRoutesFolder;
 exports.isValCanvasFrame = isValCanvasFrame;

package/dist/{getSitemapTree-d0942fca.cjs.prod.js → getSitemapTree-a4738117.cjs.prod.js}

@@ -250,7 +250,7 @@ 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" && 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";
+  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 === "pickingStopped" || 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. */
@@ -313,7 +313,7 @@ function isValCanvasStudioMessage(data) {
   }
   if (message.type === "pickElements") {
     var pick = data;
-    return typeof pick.enabled === "boolean" && typeof pick.active === "boolean" && typeof pick.keepPicked === "boolean" && PICK_MODIFIERS.includes(pick.modifier);
+    return typeof pick.enabled === "boolean" && typeof pick.active === "boolean" && typeof pick.keepPicked === "boolean" && PICK_MODIFIERS.includes(pick.modifier) && (pick.fieldsOnly === undefined || typeof pick.fieldsOnly === "boolean") && (pick.color === undefined || isCanvasSelectionColor(pick.color));
   }
   if (message.type === "scrollTo") {
     var scroll = data;
@@ -471,8 +471,15 @@ function attachElementPicker(root, options) {
   var picking = function picking(event) {
     return options.active() || held(event, options.modifier);
   };
+  var pickable = function pickable(element) {
+    var _options$fieldsOnly;
+    if (element === null || !root.contains(element)) return null;
+    if (((_options$fieldsOnly = options.fieldsOnly) === null || _options$fieldsOnly === void 0 ? void 0 : _options$fieldsOnly.call(options)) !== true) return element;
+    var field = element.closest("[data-val-path]");
+    return field !== null && root.contains(field) ? field : null;
+  };
   var target = function target(event) {
-    return event.target instanceof Element && root.contains(event.target) ? event.target : null;
+    return pickable(event.target instanceof Element ? event.target : null);
   };
   var onMove = function onMove(event) {
     last = {
@@ -533,8 +540,7 @@ function attachElementPicker(root, options) {
       return;
     }
     if (last === null) return;
-    var under = root.ownerDocument.elementFromPoint(last.x, last.y);
-    options.onHover(under !== null && root.contains(under) ? under : null);
+    options.onHover(pickable(root.ownerDocument.elementFromPoint(last.x, last.y)));
   };
   var onLeave = function onLeave() {
     last = null;
@@ -636,7 +642,9 @@ function createPickerOverlay(doc, initialColor) {
       left: "".concat(rect.left - 2, "px"),
       width: "".concat(rect.width + 4, "px"),
       height: "".concat(rect.height + 4, "px"),
-      border: "2px ".concat(kind === "hover" ? "solid" : "dashed", " ").concat(color)
+      // Dashed, both: it is what the assistant is pointed at, and the
+      // canvas's own field outlines -- Content's Select -- are solid.
+      border: "2px dashed ".concat(color)
     });
     if (kind === "hover") {
       label.textContent = elementLabel(element);
@@ -707,6 +715,7 @@ function startElementPicking(root, options) {
   var detach = attachElementPicker(root, {
     modifier: options.modifier,
     active: options.active,
+    fieldsOnly: options.fieldsOnly,
     onHover: function onHover(element) {
       return overlay.show("hover", element);
     },
@@ -1478,6 +1487,7 @@ exports.getPageRouterSitemapTree = getPageRouterSitemapTree;
 exports.getPageRouterSourceFolder = getPageRouterSourceFolder;
 exports.getPatternFromModuleFilePath = getPatternFromModuleFilePath;
 exports.getTanStackRouterSourceFolder = getTanStackRouterSourceFolder;
+exports.isCanvasSelectionColor = isCanvasSelectionColor;
 exports.isQuickPreviewFiles = isQuickPreviewFiles;
 exports.isTanStackRoutesFolder = isTanStackRoutesFolder;
 exports.isValCanvasFrame = isValCanvasFrame;