@valbuild/shared 0.151.0 → 0.152.1

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

@@ -10,7 +10,7 @@ var wrapNativeSuper = require('../../dist/wrapNativeSuper-933f991e.cjs.dev.js');
 var zodValidationError = require('zod-validation-error');
 var fp = require('@valbuild/core/fp');
 var patch = require('@valbuild/core/patch');
-var getSitemapTree = require('../../dist/getSitemapTree-59c5ed5d.cjs.dev.js');
+var getSitemapTree = require('../../dist/getSitemapTree-dc61b8b6.cjs.dev.js');
 var FlexSearch = require('flexsearch');
 var utils = require('../../dist/utils-d3d8b4b5.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
@@ -11757,7 +11885,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;
@@ -11766,7 +11893,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;
@@ -11829,6 +11955,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 +12107,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

@@ -10,7 +10,7 @@ var wrapNativeSuper = require('../../dist/wrapNativeSuper-8673414f.cjs.prod.js')
 var zodValidationError = require('zod-validation-error');
 var fp = require('@valbuild/core/fp');
 var patch = require('@valbuild/core/patch');
-var getSitemapTree = require('../../dist/getSitemapTree-6b9024d1.cjs.prod.js');
+var getSitemapTree = require('../../dist/getSitemapTree-d0942fca.cjs.prod.js');
 var FlexSearch = require('flexsearch');
 var utils = require('../../dist/utils-32bcaca2.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
@@ -11757,7 +11885,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;
@@ -11766,7 +11893,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;
@@ -11829,6 +11955,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 +12107,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;