@valbuild/shared 0.152.0 → 0.153.0

package/dist/{getSitemapTree-3c1b9e57.esm.js → getSitemapTree-a887fed4.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";
 
@@ -339,7 +230,7 @@ function isValCanvasPageMessage(data) {
   if (_typeof(data) !== "object" || data === null) return false;
   var message = data;
   if (message.val !== VAL_CANVAS_MESSAGE) return false;
-  return message.type === "ready" && isModulePathList(data.holds) && isHeldVersions(data.holdsVersions) || message.type === "elements" || message.type === "clicked" || message.type === "pinch" || message.type === "zoom" || message.type === "refreshing" || message.type === "elementPickingStopped" || message.type === "elementPicked" && isPickedElement(data.element) || message.type === "location" && isPageLocation(data) || message.type === "pageRead" && typeof data.requestId === "string" || message.type === "pageScreenshot" && typeof data.requestId === "string" || message.type === "quickPreviewStored" && typeof data.id === "string";
+  return message.type === "ready" && isModulePathList(data.holds) && isHeldVersions(data.holdsVersions) || message.type === "elements" || message.type === "clicked" || message.type === "pinch" || message.type === "zoom" || message.type === "refreshing" || message.type === "elementPickingStopped" || message.type === "pickingStopped" || message.type === "elementPicked" && isPickedElement(data.element) || message.type === "location" && isPageLocation(data) || message.type === "pageRead" && typeof data.requestId === "string" || message.type === "pageScreenshot" && typeof data.requestId === "string" || message.type === "quickPreviewStored" && typeof data.id === "string";
 }
 
 /** `holdsVersions` on `ready`: absent, or a version per module path. */
@@ -402,7 +293,7 @@ function isValCanvasStudioMessage(data) {
   }
   if (message.type === "pickElements") {
     var pick = data;
-    return typeof pick.enabled === "boolean" && typeof pick.active === "boolean" && typeof pick.keepPicked === "boolean" && PICK_MODIFIERS.includes(pick.modifier);
+    return typeof pick.enabled === "boolean" && typeof pick.active === "boolean" && typeof pick.keepPicked === "boolean" && PICK_MODIFIERS.includes(pick.modifier) && (pick.fieldsOnly === undefined || typeof pick.fieldsOnly === "boolean") && (pick.color === undefined || isCanvasSelectionColor(pick.color));
   }
   if (message.type === "scrollTo") {
     var scroll = data;
@@ -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`).
  */
 
@@ -561,8 +451,15 @@ function attachElementPicker(root, options) {
   var picking = function picking(event) {
     return options.active() || held(event, options.modifier);
   };
+  var pickable = function pickable(element) {
+    var _options$fieldsOnly;
+    if (element === null || !root.contains(element)) return null;
+    if (((_options$fieldsOnly = options.fieldsOnly) === null || _options$fieldsOnly === void 0 ? void 0 : _options$fieldsOnly.call(options)) !== true) return element;
+    var field = element.closest("[data-val-path]");
+    return field !== null && root.contains(field) ? field : null;
+  };
   var target = function target(event) {
-    return event.target instanceof Element && root.contains(event.target) ? event.target : null;
+    return pickable(event.target instanceof Element ? event.target : null);
   };
   var onMove = function onMove(event) {
     last = {
@@ -623,8 +520,7 @@ function attachElementPicker(root, options) {
       return;
     }
     if (last === null) return;
-    var under = root.ownerDocument.elementFromPoint(last.x, last.y);
-    options.onHover(under !== null && root.contains(under) ? under : null);
+    options.onHover(pickable(root.ownerDocument.elementFromPoint(last.x, last.y)));
   };
   var onLeave = function onLeave() {
     last = null;
@@ -726,7 +622,9 @@ function createPickerOverlay(doc, initialColor) {
       left: "".concat(rect.left - 2, "px"),
       width: "".concat(rect.width + 4, "px"),
       height: "".concat(rect.height + 4, "px"),
-      border: "2px ".concat(kind === "hover" ? "solid" : "dashed", " ").concat(color)
+      // Dashed, both: it is what the assistant is pointed at, and the
+      // canvas's own field outlines -- Content's Select -- are solid.
+      border: "2px dashed ".concat(color)
     });
     if (kind === "hover") {
       label.textContent = elementLabel(element);
@@ -797,6 +695,7 @@ function startElementPicking(root, options) {
   var detach = attachElementPicker(root, {
     modifier: options.modifier,
     active: options.active,
+    fieldsOnly: options.fieldsOnly,
     onHover: function onHover(element) {
       return overlay.show("hover", element);
     },
@@ -1179,9 +1078,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 +1444,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 { QUICK_PREVIEW_SERVICE_WORKER_SOURCE as A, storeQuickPreview as B, withQuickPreviewParam as C, DEFAULT_CANVAS_SELECTION as D, parseRoutePattern as E, formatRoutePattern as F, getNextAppRouterSourceFolder as G, getTanStackRouterSourceFolder as H, getPageRouterSourceFolder as I, isTanStackRoutesFolder as J, getPageRouterSitemapTree as K, getPatternFromModuleFilePath as L, 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, isCanvasSelectionColor as f, isValCanvasStudioMessage as g, isValCanvasFrame as h, isValCanvasPageMessage as i, describeElement as j, attachElementPicker as k, createPickerOverlay as l, modifierLabel as m, elementLabel as n, watchPageLocation as o, pageLocationOf as p, readPageSnapshot as q, restoreScroll as r, startElementPicking as s, findBySelector as t, screenshotPage as u, QUICK_PREVIEW_SERVICE_WORKER_PATH as v, withValCanvasParam as w, QUICK_PREVIEW_RENDER_SCRIPT as x, QUICK_PREVIEW_STORE_MESSAGE as y, isQuickPreviewFiles as z };

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-32643b50.cjs.dev.js');
 var FlexSearch = require('flexsearch');
 var utils = require('../../dist/utils-d3d8b4b5.cjs.dev.js');
 
@@ -1879,6 +1879,70 @@ var SketchErrorZ = zod.z.object({
 });
 /** The most text a sketchpad holds, in UTF-8 bytes: a page, not a site. */
 var SKETCHPAD_MAX_TEXT_LENGTH = 256 * 1024;
+
+/**
+ * A manifest as the server answers it: what each module IS on the server
+ * (`GET /manifest`, and the same answer on `/stat` when the Studio asks for it
+ * there -- one function on the server answers both, `manifestAnswer`).
+ */
+var ManifestJson = zod.z.object({
+  project: ProjectVersionSchema,
+  modules: zod.z.record(ModuleFilePath, ModuleVersionSchema),
+  /** This answer's ETag, as the header has it. */
+  tag: zod.z.string().optional(),
+  /**
+   * Present on a delta only: the `seq` of the manifest it is
+   * relative to, whose modules that are not named here did not
+   * move. Absent: every module is named.
+   */
+  since: zod.z.number().optional(),
+  /**
+   * The build that answered is a previous build still answering
+   * (http mode: the content service counted a newer one live).
+   * Its versions are right for its own bases, which the site does
+   * not serve any more: a Studio does not move to them, and asks
+   * again. Optional: absent from a live build and a server of the
+   * release before.
+   */
+  superseded: zod.z["boolean"]().optional(),
+  /**
+   * The answering build's `val.modules` registry, as an entry a
+   * Studio can import (`valModulesEntryPath`), and the Val it
+   * runs: where a Studio opened on another build takes this
+   * build's code in without reloading the page. Only a build the
+   * platform made and names (`publishBuild`) has one. Optional
+   * both ways: absent from any other server (local development,
+   * where HMR brings the code; a self-hosted deploy) and from a
+   * server of the release before, and ignored by a Studio of the
+   * release before.
+   */
+  registry: zod.z.object({
+    entry: zod.z.string(),
+    core: zod.z.string()
+  }).optional()
+});
+/**
+ * The manifest a `/stat` answer carries, when the request said which one the
+ * Studio holds (`manifest` on the request): what `GET /manifest` would have
+ * answered for it, so another editor's keystroke costs no manifest request.
+ *
+ * - A manifest, whole or a delta. A delta names the ETag it is relative to
+ *   (`sinceTag`): a Studio uses it only while it holds exactly that one.
+ * - `unchanged`: the manifest the request named, at `seq`, is still the
+ *   one for this answer's `seq`. Decided by `seq` alone, and not read: a
+ *   Studio reads a manifest only for a stat whose `seq` moved. It keeps the
+ *   next request naming the same manifest.
+ *
+ * Optional: absent from a server of the release before, and from an answer
+ * to a request that did not ask, and then the Studio reads `GET /manifest`.
+ */
+var StatManifest = zod.z.union([ManifestJson.extend({
+  sinceTag: zod.z.string().optional()
+}), zod.z.object({
+  unchanged: zod.z.literal(true),
+  tag: zod.z.string(),
+  seq: zod.z.number()
+})]);
 var Api = {
   "/draft/enable": {
     GET: {
@@ -2265,42 +2329,7 @@ var Api = {
         json: GenericError
       }), zod.z.object({
         status: zod.z.literal(200),
-        json: zod.z.object({
-          project: ProjectVersionSchema,
-          modules: zod.z.record(ModuleFilePath, ModuleVersionSchema),
-          /** This answer's ETag, as the header has it. */
-          tag: zod.z.string().optional(),
-          /**
-           * Present on a delta only: the `seq` of the manifest it is
-           * relative to, whose modules that are not named here did not
-           * move. Absent: every module is named.
-           */
-          since: zod.z.number().optional(),
-          /**
-           * The build that answered is a previous build still answering
-           * (http mode: the content service counted a newer one live).
-           * Its versions are right for its own bases, which the site does
-           * not serve any more: a Studio does not move to them, and asks
-           * again. Optional: absent from a live build and a server of the
-           * release before.
-           */
-          superseded: zod.z["boolean"]().optional(),
-          /**
-           * The answering build's `val.modules` registry, as an entry a
-           * Studio can import (`valModulesEntryPath`), and the Val it
-           * runs: where a Studio opened on another build takes this
-           * build's code in without reloading the page. Only a build the
-           * platform made and names (`publishBuild`) has one. Optional
-           * both ways: absent from any other server (local development,
-           * where HMR brings the code; a self-hosted deploy) and from a
-           * server of the release before, and ignored by a Studio of the
-           * release before.
-           */
-          registry: zod.z.object({
-            entry: zod.z.string(),
-            core: zod.z.string()
-          }).optional()
-        })
+        json: ManifestJson
       }),
       /*
        * Nothing moved since the ETag the client sent. No body on the wire;
@@ -2317,23 +2346,24 @@ var Api = {
       req: {
         body: zod.z.object({
           /**
-           * @deprecated Echoed by the Studio, and compared by the fs and
-           * memory long poll to see that another build answers. This
-           * release's Studio reads each module's version from
-           * `GET /manifest`; goes once the long poll compares the echoed
-           * version instead (see "Release-delayed deletions" in
+           * @deprecated Echoed by a Studio of the release that shipped the
+           * one content model, whose fs and memory long poll compared it to
+           * see another build; a Studio of the release after echoes
+           * {@link version} instead, and this only when it was sent. The
+           * request field goes once no Studio sends it (see
+           * "Release-delayed deletions" in
            * `docs/plans/one-content-model.md`).
            */
-          sourcesSha: zod.z.string(),
+          sourcesSha: zod.z.string().optional(),
+          /** @deprecated As `sourcesSha`. */
+          schemaSha: zod.z.string().optional(),
           /**
-           * @deprecated Echoed by the Studio, and compared by the fs and
-           * memory long poll to see that another build answers. This
-           * release's Studio reads each module's version from
-           * `GET /manifest`; goes once the long poll compares the echoed
-           * version instead (see "Release-delayed deletions" in
-           * `docs/plans/one-content-model.md`).
+           * The `version` the last answer carried: what the fs and memory
+           * long poll compare to see another build (the build the chain is
+           * relative to, `ValOps.chainBuild`). Optional: a Studio of the
+           * release before echoes the shas.
            */
-          schemaSha: zod.z.string(),
+          version: ProjectVersionSchema.optional(),
           baseSha: zod.z.string(),
           patches: zod.z.array(zod.z.string()).optional(),
           /**
@@ -2342,7 +2372,17 @@ var Api = {
            * jsonValues module's source is markers and the content sits behind a
            * thunk that `JSON.stringify` drops.
            */
-          jsonEntriesSha: zod.z.string().optional()
+          jsonEntriesSha: zod.z.string().optional(),
+          /**
+           * The manifest the Studio holds, by its ETag and `seq`, so the
+           * answer can carry what moved since (`manifest` on the answer):
+           * `null` when it holds none and can take one. Absent from a
+           * Studio of the release before, which reads `GET /manifest`.
+           */
+          manifest: zod.z.object({
+            tag: zod.z.string(),
+            seq: zod.z.number()
+          }).nullable().optional()
         }).nullable(),
         cookies: {
           val_session: zod.z.string().optional()
@@ -2363,21 +2403,16 @@ var Api = {
           type: zod.z.union([zod.z.literal("request-again"), zod.z.literal("no-change"), zod.z.literal("did-change")]),
           baseSha: zod.z.string(),
           /**
-           * @deprecated Read by a Studio of the release before
-           * (`BaseAlignment`, `SchemaFreshnessWatch`); this release's
-           * only echoes it, and reads each module's version from
-           * `GET /manifest`. Goes in two steps (see "Release-delayed
-           * deletions" in `docs/plans/one-content-model.md`).
-           */
-          schemaSha: zod.z.string(),
-          /**
-           * @deprecated Read by a Studio of the release before
-           * (`BaseAlignment`, `SchemaFreshnessWatch`); this release's
-           * only echoes it, and reads each module's version from
-           * `GET /manifest`. Goes in two steps (see "Release-delayed
-           * deletions" in `docs/plans/one-content-model.md`).
+           * @deprecated Still sent, for a Studio of the release that
+           * shipped the one content model, which echoes it; a Studio of
+           * the release after reads it as optional and echoes `version`.
+           * The server stops sending it in the release after that (see
+           * "Release-delayed deletions" in
+           * `docs/plans/one-content-model.md`).
            */
-          sourcesSha: zod.z.string(),
+          schemaSha: zod.z.string().optional(),
+          /** @deprecated As `schemaSha`. */
+          sourcesSha: zod.z.string().optional(),
           patches: zod.z.array(PatchId),
           /**
            * Of `patches`, the ones that have already SHIPPED.
@@ -2481,28 +2516,25 @@ var Api = {
            * answers, the higher `seq` is the newer. Optional: a server
            * that predates versions sends none.
            */
-          version: ProjectVersionSchema.optional()
+          version: ProjectVersionSchema.optional(),
+          /** See {@link StatManifest}. */
+          manifest: StatManifest.optional()
         }), zod.z.object({
           type: zod.z.literal("use-websocket"),
           url: zod.z.string(),
           nonce: zod.z.string(),
           baseSha: zod.z.string(),
           /**
-           * @deprecated Read by a Studio of the release before
-           * (`BaseAlignment`, `SchemaFreshnessWatch`); this release's
-           * only echoes it, and reads each module's version from
-           * `GET /manifest`. Goes in two steps (see "Release-delayed
-           * deletions" in `docs/plans/one-content-model.md`).
-           */
-          schemaSha: zod.z.string(),
-          /**
-           * @deprecated Read by a Studio of the release before
-           * (`BaseAlignment`, `SchemaFreshnessWatch`); this release's
-           * only echoes it, and reads each module's version from
-           * `GET /manifest`. Goes in two steps (see "Release-delayed
-           * deletions" in `docs/plans/one-content-model.md`).
+           * @deprecated Still sent, for a Studio of the release that
+           * shipped the one content model, which echoes it; a Studio of
+           * the release after reads it as optional and echoes `version`.
+           * The server stops sending it in the release after that (see
+           * "Release-delayed deletions" in
+           * `docs/plans/one-content-model.md`).
            */
-          sourcesSha: zod.z.string(),
+          schemaSha: zod.z.string().optional(),
+          /** @deprecated As `schemaSha`. */
+          sourcesSha: zod.z.string().optional(),
           /**
            * The commit this deployment was built from.
            *
@@ -2630,7 +2662,9 @@ var Api = {
            * answers, the higher `seq` is the newer. Optional: a server
            * that predates versions sends none.
            */
-          version: ProjectVersionSchema.optional()
+          version: ProjectVersionSchema.optional(),
+          /** See {@link StatManifest}. */
+          manifest: StatManifest.optional()
         })])
       })])
     }
@@ -3195,81 +3229,6 @@ var Api = {
       })])
     }
   },
-  /**
-   * @deprecated The whole tree. Nothing of this release asks it: the Studio
-   * reads modules by version (`GET /manifest`, `GET /modules/~`), the draft
-   * readers and MCP read the head in-process. Kept, with `exclude_patches`
-   * (`BaseAlignment`'s fetch) and the ignored `validate_sources` and
-   * `validate_binary_files`, for a Studio of the release before; goes in the
-   * release after the one that ships this (see "Release-delayed deletions"
-   * in `docs/plans/one-content-model.md`).
-   */
-  "/sources/~": {
-    PUT: {
-      req: {
-        path: zod.z.string().optional(),
-        query: {
-          validate_sources: onlyOneBooleanQueryParam.optional(),
-          validate_binary_files: onlyOneBooleanQueryParam.optional(),
-          exclude_patches: onlyOneBooleanQueryParam.optional(),
-          apply_patches: onlyOneBooleanQueryParam.optional()
-        },
-        cookies: {
-          val_session: zod.z.string().optional()
-        }
-      },
-      res: zod.z.union([unauthorizedResponse, zod.z.object({
-        status: zod.z.literal(401),
-        json: GenericError
-      }), zod.z.object({
-        status: zod.z.literal(500),
-        json: zod.z.object({
-          message: zod.z.string(),
-          details: zod.z.union([zod.z.array(ModulesError), GenericError])
-        })
-      }), zod.z.object({
-        status: zod.z.literal(409),
-        json: zod.z.object({
-          message: zod.z.string()
-        })
-      }), zod.z.object({
-        status: zod.z.literal(400),
-        json: zod.z.object({
-          message: zod.z.string(),
-          details: zod.z.array(ModulesError)
-        })
-      }), zod.z.object({
-        status: zod.z.literal(200),
-        json: zod.z.object({
-          schemaSha: zod.z.string(),
-          sourcesSha: zod.z.string(),
-          modules: zod.z.record(ModuleFilePath, zod.z.object({
-            preview: zod.z.any().optional(),
-            // TODO: improve this type
-            source: zod.z.any().optional(),
-            //.optional(), // TODO: Json zod type
-            baseSource: zod.z.any().optional(),
-            // pre-patch source for compare view; only set when the server applies patches (apply_patches=true) and the module has pending patches
-            patches: zod.z.object({
-              applied: zod.z.array(PatchId),
-              skipped: zod.z.array(PatchId).optional(),
-              errors: zod.z.record(PatchId, GenericError).optional()
-            }).optional(),
-            validationErrors: zod.z.record(zod.z.string(), zod.z.array(ValidationError)).optional(),
-            /**
-             * The version of `source` as answered: with the chain the
-             * server applied, or the empty chain when it applied none
-             * (`apply_patches=false`). Optional: an older server sends
-             * none.
-             */
-            version: ModuleVersionSchema.optional()
-          })),
-          /** The project version this tree was read at. See `/stat`. */
-          project: ProjectVersionSchema.optional()
-        })
-      })])
-    }
-  },
   /**
    * One module by version: phase 6 of `docs/plans/one-content-model.md`
    * ("The Studio loads everything from one place"). `GET /modules/~<path>`,
@@ -11885,7 +11844,7 @@ exports.getPageRouterSitemapTree = getSitemapTree.getPageRouterSitemapTree;
 exports.getPageRouterSourceFolder = getSitemapTree.getPageRouterSourceFolder;
 exports.getPatternFromModuleFilePath = getSitemapTree.getPatternFromModuleFilePath;
 exports.getTanStackRouterSourceFolder = getSitemapTree.getTanStackRouterSourceFolder;
-exports.isDesignTabOrigin = getSitemapTree.isDesignTabOrigin;
+exports.isCanvasSelectionColor = getSitemapTree.isCanvasSelectionColor;
 exports.isQuickPreviewFiles = getSitemapTree.isQuickPreviewFiles;
 exports.isTanStackRoutesFolder = getSitemapTree.isTanStackRoutesFolder;
 exports.isValCanvasFrame = getSitemapTree.isValCanvasFrame;
@@ -11894,7 +11853,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;
@@ -11930,6 +11888,7 @@ exports.JSONValue = JSONValue;
 exports.JSON_ENTRIES_BATCH_MAX = JSON_ENTRIES_BATCH_MAX;
 exports.LOCAL_FILE_IN_REMOTE_PROJECT_HINT = LOCAL_FILE_IN_REMOTE_PROJECT_HINT;
 exports.LOCAL_FILE_IN_REMOTE_PROJECT_WARNING = LOCAL_FILE_IN_REMOTE_PROJECT_WARNING;
+exports.ManifestJson = ManifestJson;
 exports.ModuleComparison = ModuleComparison;
 exports.ModuleVersionSchema = ModuleVersionSchema;
 exports.NEVER_ENCODED = NEVER_ENCODED;
@@ -11987,6 +11946,7 @@ exports.SerializedVideoSchema = SerializedVideoSchema;
 exports.SharedValConfig = SharedValConfig;
 exports.Sketchpad = Sketchpad;
 exports.SketchpadSummary = SketchpadSummary;
+exports.StatManifest = StatManifest;
 exports.VAL_CLIENT_HEADER = VAL_CLIENT_HEADER;
 exports.VAL_ENABLE_COOKIE_NAME = VAL_ENABLE_COOKIE_NAME;
 exports.VAL_GREEN_RAMP = VAL_GREEN_RAMP;