@valbuild/shared 0.151.0 → 0.152.0

package/CHANGELOG.md

@@ -1,5 +1,37 @@
 # @valbuild/shared
 
+## 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/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/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/internal/dist/valbuild-shared-internal.cjs.dev.js

@@ -3086,6 +3086,26 @@ var Api = {
           parentRef: ParentRef,
           headVersion: zod.z.number().optional()
         })
+      }),
+      /*
+       * The content service failed to take a patch: it answered with a
+       * server error, or could not be reached. Not the 400 above either,
+       * because the patches are fine -- the Studio keeps them and offers
+       * to send them again. `message` is for the editor and `details` (the
+       * status line and the service's own words) for whoever they ask.
+       *
+       * As with the 403, the patches BEFORE the failed one were saved.
+       */
+      zod.z.object({
+        status: zod.z.literal(502),
+        json: zod.z.object({
+          type: zod.z.literal("service-error"),
+          message: zod.z.string(),
+          details: zod.z.string().optional(),
+          newPatchIds: zod.z.array(PatchId),
+          parentRef: ParentRef,
+          headVersion: zod.z.number().optional()
+        })
       }), zod.z.object({
         status: zod.z.literal(200),
         json: zod.z.object({
@@ -3121,7 +3141,9 @@ var Api = {
         status: zod.z.literal(500),
         json: zod.z.object({
           message: zod.z.string(),
-          error: GenericError
+          error: GenericError,
+          /** What the content service said: its status line and words. */
+          details: zod.z.string().optional()
         })
       }), zod.z.object({
         status: zod.z.literal(200),
@@ -8239,24 +8261,30 @@ function emptyRecord(schema, context) {
   }));
 }
 
-var toolNames = ["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"];
+var toolNames = ["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"];
 
 /**
  * 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,
@@ -8275,7 +8303,21 @@ var toolNames = ["get_all_schema", "get_source", "search_content", "validate_con
  * that builds the page reads it exactly as the person left it.
  */
 
+/** The start of the part about one page. Only at the top level. */
+
+/** Columns share their row equally: a sketch says what, not how wide. */
+
+/**
+ * `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.
+ */
+
+/** The prefix of a `src` that is an image in the assistant's session. */
+var SESSION_MEDIA_PREFIX = "session:";
 var CONTAINER = /^(row|col)(?:\s+(\d+))?$/;
+var ROUTE = /^---(?:\s+(.*))?$/;
 var PLACEHOLDER = /^\[([^\]:]*)(?::([^\]]*))?\](?:\((image|video):\s*([^\s)]+)\s*\))?$/;
 var HAS_MEDIA = /^\[[^\]]*\]\(/;
 var ICON = /^icon\s+(\S+)\s+([Mm][\d\s.-].*)$/;
@@ -8318,6 +8360,32 @@ function parseSketch(source) {
     while (stack.length > 1 && indent <= stack[stack.length - 1].indent) {
       stack.pop();
     }
+    var route = ROUTE.exec(content);
+    if (route) {
+      var _route$;
+      var _path = ((_route$ = route[1]) !== null && _route$ !== void 0 ? _route$ : "").trim();
+      if (!_path.startsWith("/") || /\s/.test(_path)) {
+        errors.push({
+          line: line,
+          message: 'A route divider names one page by its route, like "--- /about".'
+        });
+      }
+      if (indent > 0) {
+        errors.push({
+          line: line,
+          message: "A route divider starts a page, so it goes at the top level, not indented."
+        });
+      }
+      // It closes everything open: what follows is another page.
+      stack.length = 1;
+      stack[0].lastIndent = 0;
+      blocks.push({
+        type: "route",
+        line: line,
+        route: _path
+      });
+      return;
+    }
     var parent = stack[stack.length - 1];
     var node = parseContent(content, line, errors);
 
@@ -8359,7 +8427,27 @@ function parseSketch(source) {
     errors: errors
   };
 }
-function parseContent(content, line, errors) {
+
+/** The link to a content field at the end of a text line. */
+var FIELD = / \{field: (\/[^{}]*)\}$/;
+function parseContent(whole, line, errors) {
+  var link = FIELD.exec(whole);
+  if (link) {
+    var node = parseLine(whole.slice(0, link.index), line, errors);
+    if (node.type !== "text") {
+      errors.push({
+        line: line,
+        message: "Only a heading or a paragraph is linked to a field: put {field: ...} at the end of one."
+      });
+      return node;
+    }
+    return createForOfIteratorHelper._objectSpread2(createForOfIteratorHelper._objectSpread2({}, node), {}, {
+      field: link[1].trim()
+    });
+  }
+  return parseLine(whole, line, errors);
+}
+function parseLine(content, line, errors) {
   // A leading backslash keeps a line that looks like a keyword as text.
   if (content.startsWith("\\")) {
     return {
@@ -8384,17 +8472,15 @@ function parseContent(content, line, errors) {
         children: []
       };
     }
-    var weight = container[2] === undefined ? 1 : Number(container[2]);
-    if (weight === 0) {
+    if (container[2] !== undefined) {
       errors.push({
         line: line,
-        message: "A col needs a weight of 1 or more."
+        message: 'Columns share a row equally, so a col takes no number: write "col".'
       });
     }
     return {
       type: "col",
       line: line,
-      weight: Math.max(weight, 1),
       children: []
     };
   }
@@ -8468,13 +8554,19 @@ function parseContent(content, line, errors) {
  * 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 `\`.
  */
-function formatSketchText(level, text) {
+function formatSketchText(level, text, field) {
   var flat = text.replace(/\s+/g, " ").trim();
+  var path = field === null || field === void 0 ? void 0 : field.replace(/\s+/g, " ").trim();
+  // A source path, and one the line can be read back with: no braces.
+  var link = path && /^\/[^{}]*$/.test(path) ? " {field: ".concat(path, "}") : "";
   if (level > 0) {
-    return "#".repeat(level) + " " + flat;
+    return "#".repeat(level) + " " + flat + link;
   }
-  var ambiguous = flat.startsWith("\\") || flat.startsWith("[") || CONTAINER.test(flat) || HEADING.test(flat) || ICON.test(flat);
-  return ambiguous ? "\\" + flat : flat;
+  // Read as the whole line will be, link and all: `icon x M` is text, and
+  // `icon x M {field: ...}` would be an icon.
+  var whole = flat + link;
+  var ambiguous = flat.startsWith("\\") || flat.startsWith("[") || CONTAINER.test(whole) || ROUTE.test(whole) || HEADING.test(whole) || ICON.test(whole);
+  return (ambiguous ? "\\" + flat : flat) + link;
 }
 
 /** The line a placeholder is written as. */
@@ -8499,17 +8591,26 @@ function formatSketchBox(placeholder) {
  */
 function formatSketch(blocks, icons) {
   var lines = [];
+  // One block per field: the first keeps the link.
+  var linked = new Set();
   var _walk = function walk(node, depth, inRow) {
     var indent = "  ".repeat(depth);
     switch (node.type) {
       case "text":
         if (node.text) {
-          lines.push(indent + formatSketchText(node.level, node.text));
+          var field = node.field && !linked.has(node.field) ? node.field : undefined;
+          if (field) {
+            linked.add(field);
+          }
+          lines.push(indent + formatSketchText(node.level, node.text, field));
         }
         return;
       case "placeholder":
         lines.push(indent + formatSketchBox(node));
         return;
+      case "route":
+        lines.push("--- ".concat(node.route));
+        return;
       case "row":
         lines.push(indent + "row");
         if (node.children.length === 0) {
@@ -8526,7 +8627,7 @@ function formatSketch(blocks, icons) {
           });
           return;
         }
-        lines.push(indent + (node.weight === 1 ? "col" : "col ".concat(node.weight)));
+        lines.push(indent + "col");
         node.children.forEach(function (child) {
           return _walk(child, depth + 1, false);
         });
@@ -8546,6 +8647,33 @@ function formatSketch(blocks, icons) {
   return all.length > 0 ? all.join("\n") + "\n" : "";
 }
 
+/**
+ * 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.
+ */
+function sketchFieldTexts(blocks) {
+  var texts = new Map();
+  var _walk2 = function walk(node) {
+    if (node.type === "text") {
+      if (node.field && node.text && !texts.has(node.field)) {
+        texts.set(node.field, node.text.replace(/\s+/g, " ").trim());
+      }
+    } else if (node.type === "row" || node.type === "col") {
+      node.children.forEach(_walk2);
+    }
+  };
+  blocks.forEach(_walk2);
+  return texts;
+}
+
+/** The pages a sketch is about, in the order it gives them. */
+function sketchRoutes(blocks) {
+  return blocks.flatMap(function (block) {
+    return block.type === "route" && block.route !== "" ? [block.route] : [];
+  });
+}
+
 /**
  * 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
@@ -11829,6 +11957,7 @@ exports.RestoreVerdict = RestoreVerdict;
 exports.RichTextOptions = RichTextOptions;
 exports.SCHEMA_SOURCE_FIXES = SCHEMA_SOURCE_FIXES;
 exports.SELF_CHECK_VERSION = SELF_CHECK_VERSION;
+exports.SESSION_MEDIA_PREFIX = SESSION_MEDIA_PREFIX;
 exports.SKETCHPAD_MAX_TEXT_LENGTH = SKETCHPAD_MAX_TEXT_LENGTH;
 exports.STAGED_SCHEMA_PREFIX = STAGED_SCHEMA_PREFIX;
 exports.STUDIO_FIXES = STUDIO_FIXES;
@@ -11980,6 +12109,8 @@ exports.selfCheck = selfCheck;
 exports.shouldEncodeWithWasm = shouldEncodeWithWasm;
 exports.sideFiles = sideFiles;
 exports.sideSource = sideSource;
+exports.sketchFieldTexts = sketchFieldTexts;
+exports.sketchRoutes = sketchRoutes;
 exports.sketchTitle = sketchTitle;
 exports.sourcePathOfChild = sourcePathOfChild;
 exports.storeWork = storeWork;

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

@@ -3086,6 +3086,26 @@ var Api = {
           parentRef: ParentRef,
           headVersion: zod.z.number().optional()
         })
+      }),
+      /*
+       * The content service failed to take a patch: it answered with a
+       * server error, or could not be reached. Not the 400 above either,
+       * because the patches are fine -- the Studio keeps them and offers
+       * to send them again. `message` is for the editor and `details` (the
+       * status line and the service's own words) for whoever they ask.
+       *
+       * As with the 403, the patches BEFORE the failed one were saved.
+       */
+      zod.z.object({
+        status: zod.z.literal(502),
+        json: zod.z.object({
+          type: zod.z.literal("service-error"),
+          message: zod.z.string(),
+          details: zod.z.string().optional(),
+          newPatchIds: zod.z.array(PatchId),
+          parentRef: ParentRef,
+          headVersion: zod.z.number().optional()
+        })
       }), zod.z.object({
         status: zod.z.literal(200),
         json: zod.z.object({
@@ -3121,7 +3141,9 @@ var Api = {
         status: zod.z.literal(500),
         json: zod.z.object({
           message: zod.z.string(),
-          error: GenericError
+          error: GenericError,
+          /** What the content service said: its status line and words. */
+          details: zod.z.string().optional()
         })
       }), zod.z.object({
         status: zod.z.literal(200),
@@ -8239,24 +8261,30 @@ function emptyRecord(schema, context) {
   }));
 }
 
-var toolNames = ["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"];
+var toolNames = ["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"];
 
 /**
  * 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,
@@ -8275,7 +8303,21 @@ var toolNames = ["get_all_schema", "get_source", "search_content", "validate_con
  * that builds the page reads it exactly as the person left it.
  */
 
+/** The start of the part about one page. Only at the top level. */
+
+/** Columns share their row equally: a sketch says what, not how wide. */
+
+/**
+ * `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.
+ */
+
+/** The prefix of a `src` that is an image in the assistant's session. */
+var SESSION_MEDIA_PREFIX = "session:";
 var CONTAINER = /^(row|col)(?:\s+(\d+))?$/;
+var ROUTE = /^---(?:\s+(.*))?$/;
 var PLACEHOLDER = /^\[([^\]:]*)(?::([^\]]*))?\](?:\((image|video):\s*([^\s)]+)\s*\))?$/;
 var HAS_MEDIA = /^\[[^\]]*\]\(/;
 var ICON = /^icon\s+(\S+)\s+([Mm][\d\s.-].*)$/;
@@ -8318,6 +8360,32 @@ function parseSketch(source) {
     while (stack.length > 1 && indent <= stack[stack.length - 1].indent) {
       stack.pop();
     }
+    var route = ROUTE.exec(content);
+    if (route) {
+      var _route$;
+      var _path = ((_route$ = route[1]) !== null && _route$ !== void 0 ? _route$ : "").trim();
+      if (!_path.startsWith("/") || /\s/.test(_path)) {
+        errors.push({
+          line: line,
+          message: 'A route divider names one page by its route, like "--- /about".'
+        });
+      }
+      if (indent > 0) {
+        errors.push({
+          line: line,
+          message: "A route divider starts a page, so it goes at the top level, not indented."
+        });
+      }
+      // It closes everything open: what follows is another page.
+      stack.length = 1;
+      stack[0].lastIndent = 0;
+      blocks.push({
+        type: "route",
+        line: line,
+        route: _path
+      });
+      return;
+    }
     var parent = stack[stack.length - 1];
     var node = parseContent(content, line, errors);
 
@@ -8359,7 +8427,27 @@ function parseSketch(source) {
     errors: errors
   };
 }
-function parseContent(content, line, errors) {
+
+/** The link to a content field at the end of a text line. */
+var FIELD = / \{field: (\/[^{}]*)\}$/;
+function parseContent(whole, line, errors) {
+  var link = FIELD.exec(whole);
+  if (link) {
+    var node = parseLine(whole.slice(0, link.index), line, errors);
+    if (node.type !== "text") {
+      errors.push({
+        line: line,
+        message: "Only a heading or a paragraph is linked to a field: put {field: ...} at the end of one."
+      });
+      return node;
+    }
+    return createForOfIteratorHelper._objectSpread2(createForOfIteratorHelper._objectSpread2({}, node), {}, {
+      field: link[1].trim()
+    });
+  }
+  return parseLine(whole, line, errors);
+}
+function parseLine(content, line, errors) {
   // A leading backslash keeps a line that looks like a keyword as text.
   if (content.startsWith("\\")) {
     return {
@@ -8384,17 +8472,15 @@ function parseContent(content, line, errors) {
         children: []
       };
     }
-    var weight = container[2] === undefined ? 1 : Number(container[2]);
-    if (weight === 0) {
+    if (container[2] !== undefined) {
       errors.push({
         line: line,
-        message: "A col needs a weight of 1 or more."
+        message: 'Columns share a row equally, so a col takes no number: write "col".'
       });
     }
     return {
       type: "col",
       line: line,
-      weight: Math.max(weight, 1),
       children: []
     };
   }
@@ -8468,13 +8554,19 @@ function parseContent(content, line, errors) {
  * 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 `\`.
  */
-function formatSketchText(level, text) {
+function formatSketchText(level, text, field) {
   var flat = text.replace(/\s+/g, " ").trim();
+  var path = field === null || field === void 0 ? void 0 : field.replace(/\s+/g, " ").trim();
+  // A source path, and one the line can be read back with: no braces.
+  var link = path && /^\/[^{}]*$/.test(path) ? " {field: ".concat(path, "}") : "";
   if (level > 0) {
-    return "#".repeat(level) + " " + flat;
+    return "#".repeat(level) + " " + flat + link;
   }
-  var ambiguous = flat.startsWith("\\") || flat.startsWith("[") || CONTAINER.test(flat) || HEADING.test(flat) || ICON.test(flat);
-  return ambiguous ? "\\" + flat : flat;
+  // Read as the whole line will be, link and all: `icon x M` is text, and
+  // `icon x M {field: ...}` would be an icon.
+  var whole = flat + link;
+  var ambiguous = flat.startsWith("\\") || flat.startsWith("[") || CONTAINER.test(whole) || ROUTE.test(whole) || HEADING.test(whole) || ICON.test(whole);
+  return (ambiguous ? "\\" + flat : flat) + link;
 }
 
 /** The line a placeholder is written as. */
@@ -8499,17 +8591,26 @@ function formatSketchBox(placeholder) {
  */
 function formatSketch(blocks, icons) {
   var lines = [];
+  // One block per field: the first keeps the link.
+  var linked = new Set();
   var _walk = function walk(node, depth, inRow) {
     var indent = "  ".repeat(depth);
     switch (node.type) {
       case "text":
         if (node.text) {
-          lines.push(indent + formatSketchText(node.level, node.text));
+          var field = node.field && !linked.has(node.field) ? node.field : undefined;
+          if (field) {
+            linked.add(field);
+          }
+          lines.push(indent + formatSketchText(node.level, node.text, field));
         }
         return;
       case "placeholder":
         lines.push(indent + formatSketchBox(node));
         return;
+      case "route":
+        lines.push("--- ".concat(node.route));
+        return;
       case "row":
         lines.push(indent + "row");
         if (node.children.length === 0) {
@@ -8526,7 +8627,7 @@ function formatSketch(blocks, icons) {
           });
           return;
         }
-        lines.push(indent + (node.weight === 1 ? "col" : "col ".concat(node.weight)));
+        lines.push(indent + "col");
         node.children.forEach(function (child) {
           return _walk(child, depth + 1, false);
         });
@@ -8546,6 +8647,33 @@ function formatSketch(blocks, icons) {
   return all.length > 0 ? all.join("\n") + "\n" : "";
 }
 
+/**
+ * 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.
+ */
+function sketchFieldTexts(blocks) {
+  var texts = new Map();
+  var _walk2 = function walk(node) {
+    if (node.type === "text") {
+      if (node.field && node.text && !texts.has(node.field)) {
+        texts.set(node.field, node.text.replace(/\s+/g, " ").trim());
+      }
+    } else if (node.type === "row" || node.type === "col") {
+      node.children.forEach(_walk2);
+    }
+  };
+  blocks.forEach(_walk2);
+  return texts;
+}
+
+/** The pages a sketch is about, in the order it gives them. */
+function sketchRoutes(blocks) {
+  return blocks.flatMap(function (block) {
+    return block.type === "route" && block.route !== "" ? [block.route] : [];
+  });
+}
+
 /**
  * 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
@@ -11829,6 +11957,7 @@ exports.RestoreVerdict = RestoreVerdict;
 exports.RichTextOptions = RichTextOptions;
 exports.SCHEMA_SOURCE_FIXES = SCHEMA_SOURCE_FIXES;
 exports.SELF_CHECK_VERSION = SELF_CHECK_VERSION;
+exports.SESSION_MEDIA_PREFIX = SESSION_MEDIA_PREFIX;
 exports.SKETCHPAD_MAX_TEXT_LENGTH = SKETCHPAD_MAX_TEXT_LENGTH;
 exports.STAGED_SCHEMA_PREFIX = STAGED_SCHEMA_PREFIX;
 exports.STUDIO_FIXES = STUDIO_FIXES;
@@ -11980,6 +12109,8 @@ exports.selfCheck = selfCheck;
 exports.shouldEncodeWithWasm = shouldEncodeWithWasm;
 exports.sideFiles = sideFiles;
 exports.sideSource = sideSource;
+exports.sketchFieldTexts = sketchFieldTexts;
+exports.sketchRoutes = sketchRoutes;
 exports.sketchTitle = sketchTitle;
 exports.sourcePathOfChild = sourcePathOfChild;
 exports.storeWork = storeWork;

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

@@ -3079,6 +3079,26 @@ var Api = {
           parentRef: ParentRef,
           headVersion: z.number().optional()
         })
+      }),
+      /*
+       * The content service failed to take a patch: it answered with a
+       * server error, or could not be reached. Not the 400 above either,
+       * because the patches are fine -- the Studio keeps them and offers
+       * to send them again. `message` is for the editor and `details` (the
+       * status line and the service's own words) for whoever they ask.
+       *
+       * As with the 403, the patches BEFORE the failed one were saved.
+       */
+      z.object({
+        status: z.literal(502),
+        json: z.object({
+          type: z.literal("service-error"),
+          message: z.string(),
+          details: z.string().optional(),
+          newPatchIds: z.array(PatchId),
+          parentRef: ParentRef,
+          headVersion: z.number().optional()
+        })
       }), z.object({
         status: z.literal(200),
         json: z.object({
@@ -3114,7 +3134,9 @@ var Api = {
         status: z.literal(500),
         json: z.object({
           message: z.string(),
-          error: GenericError
+          error: GenericError,
+          /** What the content service said: its status line and words. */
+          details: z.string().optional()
         })
       }), z.object({
         status: z.literal(200),
@@ -8232,24 +8254,30 @@ function emptyRecord(schema, context) {
   }));
 }
 
-var toolNames = ["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"];
+var toolNames = ["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"];
 
 /**
  * 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,
@@ -8268,7 +8296,21 @@ var toolNames = ["get_all_schema", "get_source", "search_content", "validate_con
  * that builds the page reads it exactly as the person left it.
  */
 
+/** The start of the part about one page. Only at the top level. */
+
+/** Columns share their row equally: a sketch says what, not how wide. */
+
+/**
+ * `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.
+ */
+
+/** The prefix of a `src` that is an image in the assistant's session. */
+var SESSION_MEDIA_PREFIX = "session:";
 var CONTAINER = /^(row|col)(?:\s+(\d+))?$/;
+var ROUTE = /^---(?:\s+(.*))?$/;
 var PLACEHOLDER = /^\[([^\]:]*)(?::([^\]]*))?\](?:\((image|video):\s*([^\s)]+)\s*\))?$/;
 var HAS_MEDIA = /^\[[^\]]*\]\(/;
 var ICON = /^icon\s+(\S+)\s+([Mm][\d\s.-].*)$/;
@@ -8311,6 +8353,32 @@ function parseSketch(source) {
     while (stack.length > 1 && indent <= stack[stack.length - 1].indent) {
       stack.pop();
     }
+    var route = ROUTE.exec(content);
+    if (route) {
+      var _route$;
+      var _path = ((_route$ = route[1]) !== null && _route$ !== void 0 ? _route$ : "").trim();
+      if (!_path.startsWith("/") || /\s/.test(_path)) {
+        errors.push({
+          line: line,
+          message: 'A route divider names one page by its route, like "--- /about".'
+        });
+      }
+      if (indent > 0) {
+        errors.push({
+          line: line,
+          message: "A route divider starts a page, so it goes at the top level, not indented."
+        });
+      }
+      // It closes everything open: what follows is another page.
+      stack.length = 1;
+      stack[0].lastIndent = 0;
+      blocks.push({
+        type: "route",
+        line: line,
+        route: _path
+      });
+      return;
+    }
     var parent = stack[stack.length - 1];
     var node = parseContent(content, line, errors);
 
@@ -8352,7 +8420,27 @@ function parseSketch(source) {
     errors: errors
   };
 }
-function parseContent(content, line, errors) {
+
+/** The link to a content field at the end of a text line. */
+var FIELD = / \{field: (\/[^{}]*)\}$/;
+function parseContent(whole, line, errors) {
+  var link = FIELD.exec(whole);
+  if (link) {
+    var node = parseLine(whole.slice(0, link.index), line, errors);
+    if (node.type !== "text") {
+      errors.push({
+        line: line,
+        message: "Only a heading or a paragraph is linked to a field: put {field: ...} at the end of one."
+      });
+      return node;
+    }
+    return _objectSpread2(_objectSpread2({}, node), {}, {
+      field: link[1].trim()
+    });
+  }
+  return parseLine(whole, line, errors);
+}
+function parseLine(content, line, errors) {
   // A leading backslash keeps a line that looks like a keyword as text.
   if (content.startsWith("\\")) {
     return {
@@ -8377,17 +8465,15 @@ function parseContent(content, line, errors) {
         children: []
       };
     }
-    var weight = container[2] === undefined ? 1 : Number(container[2]);
-    if (weight === 0) {
+    if (container[2] !== undefined) {
       errors.push({
         line: line,
-        message: "A col needs a weight of 1 or more."
+        message: 'Columns share a row equally, so a col takes no number: write "col".'
       });
     }
     return {
       type: "col",
       line: line,
-      weight: Math.max(weight, 1),
       children: []
     };
   }
@@ -8461,13 +8547,19 @@ function parseContent(content, line, errors) {
  * 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 `\`.
  */
-function formatSketchText(level, text) {
+function formatSketchText(level, text, field) {
   var flat = text.replace(/\s+/g, " ").trim();
+  var path = field === null || field === void 0 ? void 0 : field.replace(/\s+/g, " ").trim();
+  // A source path, and one the line can be read back with: no braces.
+  var link = path && /^\/[^{}]*$/.test(path) ? " {field: ".concat(path, "}") : "";
   if (level > 0) {
-    return "#".repeat(level) + " " + flat;
+    return "#".repeat(level) + " " + flat + link;
   }
-  var ambiguous = flat.startsWith("\\") || flat.startsWith("[") || CONTAINER.test(flat) || HEADING.test(flat) || ICON.test(flat);
-  return ambiguous ? "\\" + flat : flat;
+  // Read as the whole line will be, link and all: `icon x M` is text, and
+  // `icon x M {field: ...}` would be an icon.
+  var whole = flat + link;
+  var ambiguous = flat.startsWith("\\") || flat.startsWith("[") || CONTAINER.test(whole) || ROUTE.test(whole) || HEADING.test(whole) || ICON.test(whole);
+  return (ambiguous ? "\\" + flat : flat) + link;
 }
 
 /** The line a placeholder is written as. */
@@ -8492,17 +8584,26 @@ function formatSketchBox(placeholder) {
  */
 function formatSketch(blocks, icons) {
   var lines = [];
+  // One block per field: the first keeps the link.
+  var linked = new Set();
   var _walk = function walk(node, depth, inRow) {
     var indent = "  ".repeat(depth);
     switch (node.type) {
       case "text":
         if (node.text) {
-          lines.push(indent + formatSketchText(node.level, node.text));
+          var field = node.field && !linked.has(node.field) ? node.field : undefined;
+          if (field) {
+            linked.add(field);
+          }
+          lines.push(indent + formatSketchText(node.level, node.text, field));
         }
         return;
       case "placeholder":
         lines.push(indent + formatSketchBox(node));
         return;
+      case "route":
+        lines.push("--- ".concat(node.route));
+        return;
       case "row":
         lines.push(indent + "row");
         if (node.children.length === 0) {
@@ -8519,7 +8620,7 @@ function formatSketch(blocks, icons) {
           });
           return;
         }
-        lines.push(indent + (node.weight === 1 ? "col" : "col ".concat(node.weight)));
+        lines.push(indent + "col");
         node.children.forEach(function (child) {
           return _walk(child, depth + 1, false);
         });
@@ -8539,6 +8640,33 @@ function formatSketch(blocks, icons) {
   return all.length > 0 ? all.join("\n") + "\n" : "";
 }
 
+/**
+ * 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.
+ */
+function sketchFieldTexts(blocks) {
+  var texts = new Map();
+  var _walk2 = function walk(node) {
+    if (node.type === "text") {
+      if (node.field && node.text && !texts.has(node.field)) {
+        texts.set(node.field, node.text.replace(/\s+/g, " ").trim());
+      }
+    } else if (node.type === "row" || node.type === "col") {
+      node.children.forEach(_walk2);
+    }
+  };
+  blocks.forEach(_walk2);
+  return texts;
+}
+
+/** The pages a sketch is about, in the order it gives them. */
+function sketchRoutes(blocks) {
+  return blocks.flatMap(function (block) {
+    return block.type === "route" && block.route !== "" ? [block.route] : [];
+  });
+}
+
 /**
  * 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
@@ -11707,4 +11835,4 @@ var messageOf = function messageOf(error) {
   return error instanceof Error ? error.message : String(error);
 };
 
-export { AA_LARGE, AA_TEXT, AIToolCallSummaries, AnalyticsBeacon, Api, BRAND_CONTRAST_PAIRS, BinaryFileRef, ChainFold, CodeOptions, ColorOptions, DEFAULT_ERROR_MESSAGE, DateOptions, EMPTY_CHAIN, ENCODE_DEFAULTS, ENCODE_MIME_TYPE_OF, ENGINE, FileOptions, HistoricalCommit, HistoricalModule, HistoricalPatchSet, HistoryError, ImageEncodeOption, ImageOptions, JSONValue, JSON_ENTRIES_BATCH_MAX, LOCAL_FILE_IN_REMOTE_PROJECT_HINT, LOCAL_FILE_IN_REMOTE_PROJECT_WARNING, ModuleComparison, ModuleVersionSchema, NEVER_ENCODED, ParentRef$1 as ParentRef, Patch, PatchBlock, PatchId, PatchJSON, PatchSets, PlanRefusalError, ProjectVersionSchema, RAMP_STEPS, RemirrorBr, RemirrorBulletList, RemirrorHeading, RemirrorImage, RemirrorJSON, RemirrorLinkMark, RemirrorListItem, RemirrorOrderedList, RemirrorParagraph, RemirrorText, RemirrorTextMark, RestoreVerdict, RichTextOptions, SCHEMA_SOURCE_FIXES, SELF_CHECK_VERSION, SKETCHPAD_MAX_TEXT_LENGTH, STAGED_SCHEMA_PREFIX, STUDIO_FIXES, SerializedArraySchema, SerializedBooleanSchema, SerializedCodeSchema, SerializedColorSchema, SerializedDateSchema, SerializedDateTimeSchema, SerializedDiscriminatedUnionSchema, SerializedEnumSchema, SerializedFileSchema, SerializedImageSchema, SerializedKeyOfSchema, SerializedLiteralSchema, SerializedLocaleSchema, SerializedNumberSchema, SerializedObjectSchema, SerializedRecordSchema, SerializedRichTextSchema, SerializedRouteSchema, SerializedSchema, SerializedSettingsSchema, SerializedStringSchema, SerializedValViewSchema, SerializedVideoSchema, SharedValConfig, Sketchpad, SketchpadSummary, VAL_CLIENT_HEADER, VAL_ENABLE_COOKIE_NAME, VAL_GREEN_RAMP, VAL_SESSION_COOKIE, VAL_STATE_COOKIE, VAL_STUDIO_HEADER, ValCommit, ValDeployment, VideoOptions, VideoStreamOption, WARNING_FIXES, WASM_ENCODED_MIME_TYPES, accentRamp, applyChain, applyPatchRecord, baseModuleContent, baseVersionOf, buildDuplicatePatch, buildEmptyAtPathPatch, buildFileRefValue, buildImageGalleryPatch, buildRemoveImageGalleryEntryPatch, buildSearchIndex, bundleTier, chainHeadOf, chainOf, checkCompatibility, checkSketch, childSource, chooseEncoded, classifyJsonValuesOp, concatModulePath, contrastRatio, createRegExpFromPattern, createSearchIndex, createValClient, declaredLocales, describeContainerAtPath, emptyOf, engineWork, entryAddress, entryState, enumLocaleTag, expandJsonValuesRootOp, expandJsonValuesRootOpForKey, explainIncompatible, extendChain, fallbackMimeType, filterBlockingValidationErrors, filterRoutesByPatterns, findSimilar, fitWithin, flattenRichText, forEachRichTextImage, formatSketch, formatSketchBox, formatSketchText, getErrorMessageFromUnknownJson, getFilenameFromRef, getInlineImgInfo, getKeyOfRecordAt, getRefParts, getRoutesOf, getRoutesWithModulePaths, getSourceAt, getValDemo, hasLocaleRouteParam, indexModule, isInsidePatchSetPath, isJsonObject, isJsonValuesRootOp, isLocaleSchema, isMimeTypeAccepted, isRemoteSchema, isRepairedOnSave, isSchemaSourceFixError, isSkippedSource, isStudioFix, isValidationWarning, isWarningFix, joinSharedChanges, keyOfRecordPath, levenshtein, localeAt, localeMeantBy, localeOfModuleRoot, localeOfRouteKey, localeParamOfRouteKey, localeScopeAt, memoryTier, moduleKey, newestCommitSha, parseModuleKey, parseSketch, partitionValidationErrors, pathOfModuleKey, performSearch, proposalCustomProperties, rebaseContentOp, relativeLuminance, relocateForLocale, remirrorToRichTextSource, removeModule, resolveEncodeSettings, resolveEntry, resolvePairGround, resolveSchemaSourceFixForError, resolveSchemaSourceFixes, resolveSerializedSchemaAtPath, richTextImageSchema, richTextToRemirror, safeParsePatch, sameEntryVersion, sameModuleVersion, schemaErrorsOf, schemaTypesOfPath, schemaVersionOf, selectionClosure, selfCheck, shouldEncodeWithWasm, sideFiles, sideSource, sketchTitle, sourcePathOfChild, storeWork, themeCustomProperties, tiered, toolNames, traverseSchemaSource, urlOf, valClientHeaders, valModulesEntryFile, valModulesEntryPath, validateRoutePatterns, versionHashCount, wholeEntryKey, withExtension };
+export { AA_LARGE, AA_TEXT, AIToolCallSummaries, AnalyticsBeacon, Api, BRAND_CONTRAST_PAIRS, BinaryFileRef, ChainFold, CodeOptions, ColorOptions, DEFAULT_ERROR_MESSAGE, DateOptions, EMPTY_CHAIN, ENCODE_DEFAULTS, ENCODE_MIME_TYPE_OF, ENGINE, FileOptions, HistoricalCommit, HistoricalModule, HistoricalPatchSet, HistoryError, ImageEncodeOption, ImageOptions, JSONValue, JSON_ENTRIES_BATCH_MAX, LOCAL_FILE_IN_REMOTE_PROJECT_HINT, LOCAL_FILE_IN_REMOTE_PROJECT_WARNING, ModuleComparison, ModuleVersionSchema, NEVER_ENCODED, ParentRef$1 as ParentRef, Patch, PatchBlock, PatchId, PatchJSON, PatchSets, PlanRefusalError, ProjectVersionSchema, RAMP_STEPS, RemirrorBr, RemirrorBulletList, RemirrorHeading, RemirrorImage, RemirrorJSON, RemirrorLinkMark, RemirrorListItem, RemirrorOrderedList, RemirrorParagraph, RemirrorText, RemirrorTextMark, RestoreVerdict, RichTextOptions, SCHEMA_SOURCE_FIXES, SELF_CHECK_VERSION, SESSION_MEDIA_PREFIX, SKETCHPAD_MAX_TEXT_LENGTH, STAGED_SCHEMA_PREFIX, STUDIO_FIXES, SerializedArraySchema, SerializedBooleanSchema, SerializedCodeSchema, SerializedColorSchema, SerializedDateSchema, SerializedDateTimeSchema, SerializedDiscriminatedUnionSchema, SerializedEnumSchema, SerializedFileSchema, SerializedImageSchema, SerializedKeyOfSchema, SerializedLiteralSchema, SerializedLocaleSchema, SerializedNumberSchema, SerializedObjectSchema, SerializedRecordSchema, SerializedRichTextSchema, SerializedRouteSchema, SerializedSchema, SerializedSettingsSchema, SerializedStringSchema, SerializedValViewSchema, SerializedVideoSchema, SharedValConfig, Sketchpad, SketchpadSummary, VAL_CLIENT_HEADER, VAL_ENABLE_COOKIE_NAME, VAL_GREEN_RAMP, VAL_SESSION_COOKIE, VAL_STATE_COOKIE, VAL_STUDIO_HEADER, ValCommit, ValDeployment, VideoOptions, VideoStreamOption, WARNING_FIXES, WASM_ENCODED_MIME_TYPES, accentRamp, applyChain, applyPatchRecord, baseModuleContent, baseVersionOf, buildDuplicatePatch, buildEmptyAtPathPatch, buildFileRefValue, buildImageGalleryPatch, buildRemoveImageGalleryEntryPatch, buildSearchIndex, bundleTier, chainHeadOf, chainOf, checkCompatibility, checkSketch, childSource, chooseEncoded, classifyJsonValuesOp, concatModulePath, contrastRatio, createRegExpFromPattern, createSearchIndex, createValClient, declaredLocales, describeContainerAtPath, emptyOf, engineWork, entryAddress, entryState, enumLocaleTag, expandJsonValuesRootOp, expandJsonValuesRootOpForKey, explainIncompatible, extendChain, fallbackMimeType, filterBlockingValidationErrors, filterRoutesByPatterns, findSimilar, fitWithin, flattenRichText, forEachRichTextImage, formatSketch, formatSketchBox, formatSketchText, getErrorMessageFromUnknownJson, getFilenameFromRef, getInlineImgInfo, getKeyOfRecordAt, getRefParts, getRoutesOf, getRoutesWithModulePaths, getSourceAt, getValDemo, hasLocaleRouteParam, indexModule, isInsidePatchSetPath, isJsonObject, isJsonValuesRootOp, isLocaleSchema, isMimeTypeAccepted, isRemoteSchema, isRepairedOnSave, isSchemaSourceFixError, isSkippedSource, isStudioFix, isValidationWarning, isWarningFix, joinSharedChanges, keyOfRecordPath, levenshtein, localeAt, localeMeantBy, localeOfModuleRoot, localeOfRouteKey, localeParamOfRouteKey, localeScopeAt, memoryTier, moduleKey, newestCommitSha, parseModuleKey, parseSketch, partitionValidationErrors, pathOfModuleKey, performSearch, proposalCustomProperties, rebaseContentOp, relativeLuminance, relocateForLocale, remirrorToRichTextSource, removeModule, resolveEncodeSettings, resolveEntry, resolvePairGround, resolveSchemaSourceFixForError, resolveSchemaSourceFixes, resolveSerializedSchemaAtPath, richTextImageSchema, richTextToRemirror, safeParsePatch, sameEntryVersion, sameModuleVersion, schemaErrorsOf, schemaTypesOfPath, schemaVersionOf, selectionClosure, selfCheck, shouldEncodeWithWasm, sideFiles, sideSource, sketchFieldTexts, sketchRoutes, sketchTitle, sourcePathOfChild, storeWork, themeCustomProperties, tiered, toolNames, traverseSchemaSource, urlOf, valClientHeaders, valModulesEntryFile, valModulesEntryPath, validateRoutePatterns, versionHashCount, wholeEntryKey, withExtension };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@valbuild/shared",
-  "version": "0.151.0",
+  "version": "0.152.0",
   "private": false,
   "description": "Val shared types and utilities",
   "repository": {