@valbuild/shared 0.151.0 → 0.152.1

package/CHANGELOG.md

@@ -1,5 +1,49 @@
 # @valbuild/shared
 
+## 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
+
+- [#1015](https://github.com/valbuild/val/pull/1015) [`08a3977`](https://github.com/valbuild/val/commit/08a39779dbe43702a72ae57cbf8cf29b14e64672) Thanks [@freekh](https://github.com/freekh)! - The Sketchpad covers several pages, builds what it shows, and can be linked to the content.
+
+  - **Route dividers.** A sketchpad is no longer about one page. A `--- /about` line starts the part about a page, so one sketch can cover a page and the pages it links to. Press a route to see that page beside the sketch, in the Studio's own live preview, which follows edits as they are made. A divider's menu changes its page, or adds a new one from a page type the site has (`/blog/[slug]`). A route the site has no page type for is allowed too, and is marked as needing code.
+  - **Start from a page.** An empty sketchpad offers to start from a page. The assistant writes that page into it, images and all, and changes nothing.
+  - **Build.** The button that sent the sketchpad to the assistant is now **Build**. It sends the sketchpad as a card in the chat (press it to open the sketchpad), with a request to change the pages to match the sketch. It is disabled while the sketch is empty.
+  - **Images that exist.** A box shows an image from a gallery, from the site's content, or one uploaded to the chat, and the picker offers exactly those, with search and Upload (which puts the file in the chat first). A box naming any other image says so. When the assistant writes a sketch with an image that is not in the project, the write is refused. Images are named by their content path (`/public/val/hero.webp`) and shown where the site serves them, including uploads that are not published yet.
+  - **Block types.** A box's kind is a combobox of the kinds of section the site's pages have, read from the schema. Any other word is allowed, and is marked as a new type that needs code.
+  - **Drag.** Blocks, rows, columns and images can be dragged to a new place. Columns share a row equally, so the width controls are gone.
+  - **Highlights.** The assistant can point at blocks, in a colour and with a note (for example, the ones that need code), with `highlight_sketchpad_blocks`. The highlights can be cleared, by the person or by the assistant.
+  - **Linked text (a try-out).** A heading or paragraph can be linked to a plain text field with `{field: <source path>}`. Typing in it then changes that field, as typing in the field would. The block shows what it is linked to and has an **Unlink** button. When the field was changed elsewhere, the block says so and offers the field's text. A sketchpad the assistant starts from a page links its text this way.
+  - **Converting images.** The assistant can convert an image in the chat to WebP, or scale it down, with `convert_session_image`, using the same encoder as the Studio's uploads.
+
+### Patch Changes
+
+- [#1013](https://github.com/valbuild/val/pull/1013) [`3bb76d7`](https://github.com/valbuild/val/commit/3bb76d74d82b499aa15023838d63018a70fd7ce7) Thanks [@freekh](https://github.com/freekh)! - A save that the content service fails to take no longer looks like a successful one.
+
+  Before, when the content service answered a save with a server error (or could not be reached), the Studio treated the edit as invalid and dropped it: the field went back to its old value, and the status bar kept saying "All changes saved". Now:
+
+  - **Your edit is kept.** The field keeps what you typed.
+  - **The Studio says the save failed.** The status bar shows "Could not save" (never "All changes saved" while a save has failed or is still pending), and a notice says which service failed, with the service's own message under **Details**.
+  - **Try again** sends the same save again. The Studio also retries by itself in the background, so if you leave the tab open your changes are saved once the service is back.
+
+  Pressing Publish while a save has failed now says what failed, in the service's words, with a **Save again** button, instead of "Check the connection and try again".
+
+  Saves that the service refuses because of your plan, and saves that conflict with someone else's change, work as before.
+
+  Error messages from the content service also stop blaming your network. "Could not get your changes. It is most likely due to a network issue. Check your network connection" was shown even when the service had answered with a 500. These messages now say what actually happened (the service answered with an error, refused the request, or could not be reached from your site's server) and name the service. The status code and the service's response are kept as details for whoever needs to look into it. Publish failures now also show the service's own message, where they used to say "Unknown error".
+
 ## 0.151.0
 
 ### 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-59c5ed5d.cjs.dev.js');
+var getSitemapTree = require('../../dist/getSitemapTree-dc61b8b6.cjs.dev.js');
 require('../../dist/createForOfIteratorHelper-f2d7ac6d.cjs.dev.js');
 require('@valbuild/core');
 
@@ -31,7 +31,6 @@ exports.getPageRouterSitemapTree = getSitemapTree.getPageRouterSitemapTree;
 exports.getPageRouterSourceFolder = getSitemapTree.getPageRouterSourceFolder;
 exports.getPatternFromModuleFilePath = getSitemapTree.getPatternFromModuleFilePath;
 exports.getTanStackRouterSourceFolder = getSitemapTree.getTanStackRouterSourceFolder;
-exports.isDesignTabOrigin = getSitemapTree.isDesignTabOrigin;
 exports.isQuickPreviewFiles = getSitemapTree.isQuickPreviewFiles;
 exports.isTanStackRoutesFolder = getSitemapTree.isTanStackRoutesFolder;
 exports.isValCanvasFrame = getSitemapTree.isValCanvasFrame;
@@ -40,7 +39,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-d0942fca.cjs.prod.js');
 require('../../dist/createForOfIteratorHelper-9ca2078d.cjs.prod.js');
 require('@valbuild/core');
 
@@ -31,7 +31,6 @@ exports.getPageRouterSitemapTree = getSitemapTree.getPageRouterSitemapTree;
 exports.getPageRouterSourceFolder = getSitemapTree.getPageRouterSourceFolder;
 exports.getPatternFromModuleFilePath = getSitemapTree.getPatternFromModuleFilePath;
 exports.getTanStackRouterSourceFolder = getSitemapTree.getTanStackRouterSourceFolder;
-exports.isDesignTabOrigin = getSitemapTree.isDesignTabOrigin;
 exports.isQuickPreviewFiles = getSitemapTree.isQuickPreviewFiles;
 exports.isTanStackRoutesFolder = getSitemapTree.isTanStackRoutesFolder;
 exports.isValCanvasFrame = getSitemapTree.isValCanvasFrame;
@@ -40,7 +39,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, 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';
 import '../../dist/createForOfIteratorHelper-9b80f1a2.esm.js';
 import '@valbuild/core';

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

@@ -1265,6 +1265,22 @@ export declare const Api: {
                     }, z.core.$strip>]>;
                     headVersion: z.ZodOptional<z.ZodNumber>;
                 }, z.core.$strip>;
+            }, z.core.$strip>, z.ZodObject<{
+                status: z.ZodLiteral<502>;
+                json: z.ZodObject<{
+                    type: z.ZodLiteral<"service-error">;
+                    message: z.ZodString;
+                    details: z.ZodOptional<z.ZodString>;
+                    newPatchIds: z.ZodArray<z.ZodString & z.ZodType<import("@valbuild/core").PatchId, string, z.core.$ZodTypeInternals<import("@valbuild/core").PatchId, string>>>;
+                    parentRef: z.ZodUnion<readonly [z.ZodObject<{
+                        type: z.ZodLiteral<"head">;
+                        headBaseSha: z.ZodString;
+                    }, z.core.$strip>, z.ZodObject<{
+                        type: z.ZodLiteral<"patch">;
+                        patchId: z.ZodString & z.ZodType<import("@valbuild/core").PatchId, string, z.core.$ZodTypeInternals<import("@valbuild/core").PatchId, string>>;
+                    }, z.core.$strip>]>;
+                    headVersion: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strip>;
             }, z.core.$strip>, z.ZodObject<{
                 status: z.ZodLiteral<200>;
                 json: z.ZodObject<{
@@ -1315,6 +1331,7 @@ export declare const Api: {
                     error: z.ZodObject<{
                         message: z.ZodString;
                     }, z.core.$strip>;
+                    details: z.ZodOptional<z.ZodString>;
                 }, z.core.$strip>;
             }, z.core.$strip>, z.ZodObject<{
                 status: z.ZodLiteral<200>;

package/dist/declarations/src/internal/aiTools/toolNames.d.ts

@@ -1,2 +1,2 @@
-export declare const toolNames: readonly ["get_all_schema", "get_source", "search_content", "validate_content", "create_patch", "add_session_image_to_gallery", "remove_image_gallery_entry", "navigate_to", "get_current_context", "get_patches", "get_source_path_from_route", "set_session_name", "show_compare_view", "ask_user_question", "duplicate_source", "empty_at_path", "count_entries", "get_record_keys", "list_sketchpads", "create_sketchpad", "read_sketchpad", "write_sketchpad"];
+export declare const toolNames: readonly ["get_all_schema", "get_source", "search_content", "validate_content", "create_patch", "add_session_image_to_gallery", "remove_image_gallery_entry", "convert_session_image", "navigate_to", "get_current_context", "get_patches", "get_source_path_from_route", "set_session_name", "show_compare_view", "ask_user_question", "duplicate_source", "empty_at_path", "count_entries", "get_record_keys", "list_sketchpads", "create_sketchpad", "read_sketchpad", "write_sketchpad", "highlight_sketchpad_blocks", "clear_sketchpad_highlights"];
 export type ToolName = (typeof toolNames)[number];

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 = {

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

@@ -2,18 +2,24 @@
  * A page sketch: a page written as indented text, with four primitives.
  *
  * ```
+ * --- /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
  * row                          its children side by side
- *   col 2                      its children stacked; 2 shares of the row
- *     ## Design
+ *   col                        its children stacked; columns share a row
+ *     ## Design                equally
  *   col
  *     [button: Join us]
  * ```
  *
+ * A sketchpad is not one page's: a route divider starts the part about a
+ * page, so one sketch can cover a page and the two it links to.
+ *
  * It is a scratch pad, not a layout language: it says WHAT is on a page and
  * roughly WHERE, so an assistant and a person can agree on a page's content
  * before anyone worries about how it looks. The person never sees this text,
@@ -31,17 +37,23 @@
  * image. Media put in a box is written into the text too, so the assistant
  * that builds the page reads it exactly as the person left it.
  */
-export type SketchNode = SketchRow | SketchCol | SketchText | SketchPlaceholder;
+export type SketchNode = SketchRoute | SketchRow | SketchCol | SketchText | SketchPlaceholder;
+/** The start of the part about one page. Only at the top level. */
+export type SketchRoute = {
+    type: "route";
+    line: number;
+    /** The page's route as the site serves it: `/about`, `/blog/[slug]`. */
+    route: string;
+};
 export type SketchRow = {
     type: "row";
     line: number;
     children: SketchNode[];
 };
+/** Columns share their row equally: a sketch says what, not how wide. */
 export type SketchCol = {
     type: "col";
     line: number;
-    /** Shares of the enclosing row this column takes. */
-    weight: number;
     children: SketchNode[];
 };
 export type SketchText = {
@@ -50,6 +62,13 @@ 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";
@@ -58,10 +77,18 @@ export type SketchPlaceholder = {
     label: string | null;
     media: SketchMedia | null;
 };
+/**
+ * `src` names a file the project has, never a guess: its `path` exactly as
+ * the content has it (`/public/val/hero.webp`, or its remote URL), or an
+ * image uploaded to the assistant's session, `session:<key>`. Which files
+ * those are is the Studio's to check; the text only holds the name.
+ */
 export type SketchMedia = {
     type: "image" | "video";
     src: string;
 };
+/** The prefix of a `src` that is an image in the assistant's session. */
+export declare const SESSION_MEDIA_PREFIX = "session:";
 export type SketchError = {
     /** 1-based, like an editor's gutter. */
     line: number;
@@ -82,7 +109,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): string;
+export declare function formatSketchText(level: SketchText["level"], text: string, field?: string): string;
 /** The line a placeholder is written as. */
 export declare function formatSketchBox(placeholder: Pick<SketchPlaceholder, "kind" | "label" | "media">): string;
 /**
@@ -95,6 +122,14 @@ 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[];
 /**
  * What a list names a sketch by: its first top-level heading, the biggest
  * one first. Null for a sketch with no heading, which a list then names by

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

@@ -213,8 +213,8 @@ export type ValCanvasPageMessage = {
     type: "elementPickingStopped";
 } | ({
     /**
-     * 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;
@@ -358,7 +358,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

package/dist/{getSitemapTree-3c1b9e57.esm.js → getSitemapTree-2b22cf1b.esm.js}

@@ -7,12 +7,11 @@ var VAL_AI_SESSION_STORAGE_KEY = "val-ai-session";
 
 /**
  * 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:
@@ -30,7 +29,7 @@ var VAL_AI_SESSION_STORAGE_KEY = "val-ai-session";
  * 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
@@ -185,114 +184,6 @@ function withQuickPreviewParam(url, id) {
   return parsed.toString();
 }
 
-/**
- * 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.
- */
-function quickPreviewSiteOrigin(_x4) {
-  return _quickPreviewSiteOrigin.apply(this, arguments);
-}
-
-/** The site's origin, as this page's server named it: asked once per page. */
-function _quickPreviewSiteOrigin() {
-  _quickPreviewSiteOrigin = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee2(api) {
-    var fetchImpl,
-      res,
-      body,
-      siteUrl,
-      _args2 = arguments;
-    return _regenerator().w(function (_context2) {
-      while (1) switch (_context2.p = _context2.n) {
-        case 0:
-          fetchImpl = _args2.length > 1 && _args2[1] !== undefined ? _args2[1] : fetch;
-          _context2.n = 1;
-          return fetchImpl("".concat(api.replace(/\/+$/, ""), "/proposals-api"), {
-            credentials: "same-origin",
-            headers: {
-              Accept: "application/json"
-            }
-          });
-        case 1:
-          res = _context2.v;
-          if (res.ok) {
-            _context2.n = 2;
-            break;
-          }
-          return _context2.a(2, null);
-        case 2:
-          _context2.n = 3;
-          return res.json();
-        case 3:
-          body = _context2.v;
-          if (!(_typeof(body) !== "object" || body === null || !("siteUrl" in body))) {
-            _context2.n = 4;
-            break;
-          }
-          return _context2.a(2, null);
-        case 4:
-          siteUrl = body.siteUrl;
-          if (!(typeof siteUrl !== "string")) {
-            _context2.n = 5;
-            break;
-          }
-          return _context2.a(2, null);
-        case 5:
-          _context2.p = 5;
-          return _context2.a(2, new URL(siteUrl).origin);
-        case 6:
-          _context2.p = 6;
-          _context2.v;
-          return _context2.a(2, null);
-      }
-    }, _callee2, null, [[5, 6]]);
-  }));
-  return _quickPreviewSiteOrigin.apply(this, arguments);
-}
-var siteOriginOnce = 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.
- */
-function isDesignTabOrigin(_x5, _x6) {
-  return _isDesignTabOrigin.apply(this, arguments);
-}
-function _isDesignTabOrigin() {
-  _isDesignTabOrigin = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee3(origin, options) {
-    var site;
-    return _regenerator().w(function (_context3) {
-      while (1) switch (_context3.n) {
-        case 0:
-          if (!(origin === options.own)) {
-            _context3.n = 1;
-            break;
-          }
-          return _context3.a(2, true);
-        case 1:
-          siteOriginOnce !== null && siteOriginOnce !== void 0 ? siteOriginOnce : siteOriginOnce = quickPreviewSiteOrigin(options.api, options.fetchImpl)["catch"](function () {
-            return null;
-          });
-          _context3.n = 2;
-          return siteOriginOnce;
-        case 2:
-          site = _context3.v;
-          if (site === null) siteOriginOnce = null;
-          return _context3.a(2, site !== null && site === origin);
-      }
-    }, _callee3);
-  }));
-  return _isDesignTabOrigin.apply(this, arguments);
-}
-
 /** Marks a page load as the studio's canvas frame. */
 var VAL_CANVAS_PARAM = "val_canvas";
 
@@ -465,9 +356,9 @@ function withValCanvasParam(url) {
 /**
  * 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.
@@ -478,9 +369,8 @@ function withValCanvasParam(url) {
  *
  * 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`).
  */
 
@@ -1179,9 +1069,8 @@ function selectorOf(element, root) {
  * `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.
  *
@@ -1546,4 +1435,4 @@ function getPatternFromModuleFilePath(moduleFilePath, srcFolder) {
   .replace("/page.val.ts", "").replace("/page.val.js", "");
 }
 
-export { storeQuickPreview as A, withQuickPreviewParam as B, quickPreviewSiteOrigin as C, DEFAULT_CANVAS_SELECTION as D, isDesignTabOrigin as E, parseRoutePattern as F, formatRoutePattern as G, getNextAppRouterSourceFolder as H, getTanStackRouterSourceFolder as I, getPageRouterSourceFolder as J, isTanStackRoutesFolder as K, getPageRouterSitemapTree as L, getPatternFromModuleFilePath as M, QUICK_PREVIEW_PARAM as Q, VAL_CONFIG_SESSION_STORAGE_KEY as V, VAL_THEME_SESSION_STORAGE_KEY as a, VAL_AI_SESSION_STORAGE_KEY as b, VAL_CANVAS_PARAM as c, VAL_CANVAS_MESSAGE as d, DEFAULT_CANVAS_SELECTION_SOFT as e, isValCanvasStudioMessage as f, isValCanvasFrame as g, describeElement as h, isValCanvasPageMessage as i, attachElementPicker as j, createPickerOverlay as k, elementLabel as l, modifierLabel as m, watchPageLocation as n, readPageSnapshot as o, pageLocationOf as p, findBySelector as q, restoreScroll as r, startElementPicking as s, screenshotPage as t, QUICK_PREVIEW_SERVICE_WORKER_PATH as u, QUICK_PREVIEW_RENDER_SCRIPT as v, withValCanvasParam as w, QUICK_PREVIEW_STORE_MESSAGE as x, isQuickPreviewFiles as y, QUICK_PREVIEW_SERVICE_WORKER_SOURCE as z };
+export { storeQuickPreview as A, withQuickPreviewParam as B, parseRoutePattern as C, DEFAULT_CANVAS_SELECTION as D, formatRoutePattern as E, getNextAppRouterSourceFolder as F, getTanStackRouterSourceFolder as G, getPageRouterSourceFolder as H, isTanStackRoutesFolder as I, getPageRouterSitemapTree as J, getPatternFromModuleFilePath as K, QUICK_PREVIEW_PARAM as Q, VAL_CONFIG_SESSION_STORAGE_KEY as V, VAL_THEME_SESSION_STORAGE_KEY as a, VAL_AI_SESSION_STORAGE_KEY as b, VAL_CANVAS_PARAM as c, VAL_CANVAS_MESSAGE as d, DEFAULT_CANVAS_SELECTION_SOFT as e, isValCanvasStudioMessage as f, isValCanvasFrame as g, describeElement as h, isValCanvasPageMessage as i, attachElementPicker as j, createPickerOverlay as k, elementLabel as l, modifierLabel as m, watchPageLocation as n, readPageSnapshot as o, pageLocationOf as p, findBySelector as q, restoreScroll as r, startElementPicking as s, screenshotPage as t, QUICK_PREVIEW_SERVICE_WORKER_PATH as u, QUICK_PREVIEW_RENDER_SCRIPT as v, withValCanvasParam as w, QUICK_PREVIEW_STORE_MESSAGE as x, isQuickPreviewFiles as y, QUICK_PREVIEW_SERVICE_WORKER_SOURCE as z };