@valbuild/shared 0.122.0 → 0.123.2

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

@@ -1,117 +1,10 @@
 import { Internal, CODE_LANGUAGES, DEFAULT_COLOR_FORMAT } from '@valbuild/core';
-import { b as base64DataUrlToUint8Array } from '../../dist/utils-00f3e1df.esm.js';
+import { _ as _createForOfIteratorHelper, k as _objectSpread2, l as _arrayLikeToArray, m as _unsupportedIterableToArray, n as _defineProperty, o as _typeof } from '../../dist/getSitemapTree-d3e98a2e.esm.js';
+export { b as VAL_AI_SESSION_STORAGE_KEY, d as VAL_CANVAS_MESSAGE, c as VAL_CANVAS_PARAM, V as VAL_CONFIG_SESSION_STORAGE_KEY, a as VAL_THEME_SESSION_STORAGE_KEY, h as getNextAppRouterSitemapTree, g as getNextAppRouterSourceFolder, j as getPatternFromModuleFilePath, f as isValCanvasFrame, i as isValCanvasPageMessage, e as isValCanvasStudioMessage, p as parseRoutePattern, w as withValCanvasParam } from '../../dist/getSitemapTree-d3e98a2e.esm.js';
 import { z } from 'zod';
 import { fromError } from 'zod-validation-error';
-
-function _toPrimitive(t, r) {
-  if ("object" != typeof t || !t) return t;
-  var e = t[Symbol.toPrimitive];
-  if (void 0 !== e) {
-    var i = e.call(t, r || "default");
-    if ("object" != typeof i) return i;
-    throw new TypeError("@@toPrimitive must return a primitive value.");
-  }
-  return ("string" === r ? String : Number)(t);
-}
-
-function _toPropertyKey(t) {
-  var i = _toPrimitive(t, "string");
-  return "symbol" == typeof i ? i : i + "";
-}
-
-function _defineProperty(e, r, t) {
-  return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, {
-    value: t,
-    enumerable: !0,
-    configurable: !0,
-    writable: !0
-  }) : e[r] = t, e;
-}
-
-function ownKeys(e, r) {
-  var t = Object.keys(e);
-  if (Object.getOwnPropertySymbols) {
-    var o = Object.getOwnPropertySymbols(e);
-    r && (o = o.filter(function (r) {
-      return Object.getOwnPropertyDescriptor(e, r).enumerable;
-    })), t.push.apply(t, o);
-  }
-  return t;
-}
-function _objectSpread2(e) {
-  for (var r = 1; r < arguments.length; r++) {
-    var t = null != arguments[r] ? arguments[r] : {};
-    r % 2 ? ownKeys(Object(t), !0).forEach(function (r) {
-      _defineProperty(e, r, t[r]);
-    }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) {
-      Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r));
-    });
-  }
-  return e;
-}
-
-function _arrayLikeToArray(r, a) {
-  (null == a || a > r.length) && (a = r.length);
-  for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e];
-  return n;
-}
-
-function _unsupportedIterableToArray(r, a) {
-  if (r) {
-    if ("string" == typeof r) return _arrayLikeToArray(r, a);
-    var t = {}.toString.call(r).slice(8, -1);
-    return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0;
-  }
-}
-
-function _createForOfIteratorHelper(r, e) {
-  var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"];
-  if (!t) {
-    if (Array.isArray(r) || (t = _unsupportedIterableToArray(r)) || e && r && "number" == typeof r.length) {
-      t && (r = t);
-      var n = 0,
-        F = function () {};
-      return {
-        s: F,
-        n: function () {
-          return n >= r.length ? {
-            done: !0
-          } : {
-            done: !1,
-            value: r[n++]
-          };
-        },
-        e: function (r) {
-          throw r;
-        },
-        f: F
-      };
-    }
-    throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
-  }
-  var o,
-    a = !0,
-    u = !1;
-  return {
-    s: function () {
-      t = t.call(r);
-    },
-    n: function () {
-      var r = t.next();
-      return a = r.done, r;
-    },
-    e: function (r) {
-      u = !0, o = r;
-    },
-    f: function () {
-      try {
-        a || null == t.return || t.return();
-      } finally {
-        if (u) throw o;
-      }
-    }
-  };
-}
+import FlexSearch from 'flexsearch';
+import { b as base64DataUrlToUint8Array } from '../../dist/utils-00f3e1df.esm.js';
 
 function remirrorToRichTextSource(node, configDirectory, remoteOptions) {
   var files = {};
@@ -2962,16 +2855,6 @@ var Api = {
 // `number` is allowed because the client stringifies every query value before it
 // goes on the URL (see createValClient), so a numeric param round-trips fine.
 
-function _typeof(o) {
-  "@babel/helpers - typeof";
-
-  return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) {
-    return typeof o;
-  } : function (o) {
-    return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o;
-  }, _typeof(o);
-}
-
 function getErrorMessageFromUnknownJson(json, fallback) {
   if (_typeof(json) === "object" && json !== null && "message" in json && typeof json.message === "string") {
     return json.message;
@@ -3651,10 +3534,6 @@ function newestCommitSha(commits) {
   return (_newest$commitSha = (_newest = newest) === null || _newest === void 0 ? void 0 : _newest.commitSha) !== null && _newest$commitSha !== void 0 ? _newest$commitSha : null;
 }
 
-var VAL_CONFIG_SESSION_STORAGE_KEY = "val-config";
-var VAL_THEME_SESSION_STORAGE_KEY = "val-theme";
-var VAL_AI_SESSION_STORAGE_KEY = "val-ai-session";
-
 var SharedValConfig = z.object({
   contentHostUrl: z.string().optional(),
   appHostUrl: z.string().optional(),
@@ -3682,170 +3561,6 @@ var ValDeployment = z.object({
   createdAt: z.string()
 });
 
-// Strictly speaking this should be in the next package but it's shared, because we want to use it in the ui package. We want to resolve that somehow
-function getNextAppRouterSitemapTree(srcFolder, paths) {
-  var root = {
-    type: "node",
-    name: "/",
-    children: []
-  };
-  var _iterator = _createForOfIteratorHelper(paths),
-    _step;
-  try {
-    var _loop = function _loop() {
-        var path = _step.value;
-        var urlPath = path.urlPath,
-          moduleFilePathS = path.moduleFilePath;
-        var moduleFilePath = moduleFilePathS;
-        if (!urlPath.startsWith("/")) {
-          console.error("urlPath must start with /: ".concat(urlPath));
-          return 0; // continue
-        }
-        var pattern = getPatternFromModuleFilePath(moduleFilePath, srcFolder);
-        if (urlPath === "/") {
-          var fullPath = "/";
-          root.pattern = getPatternFromModuleFilePath(moduleFilePath, srcFolder);
-          root.page = {
-            fullPath: fullPath
-          };
-          root.sourcePath = Internal.joinModuleFilePathAndModulePath(moduleFilePath, "\"".concat(fullPath, "\""));
-          root.moduleFilePath = moduleFilePath;
-          return 0; // continue
-        }
-        var pathParts = urlPath.split("/").slice(1).filter(Boolean);
-        var currentNode = root;
-        pathParts.forEach(function (part, index) {
-          var hasChildren = index < pathParts.length - 1;
-          var isLast = index === pathParts.length - 1;
-          var fullPath = "/" + pathParts.slice(0, index + 1).join("/");
-          var sourcePath = Internal.joinModuleFilePathAndModulePath(moduleFilePath, "\"".concat(fullPath, "\""));
-          var node = hasChildren ? _objectSpread2(_objectSpread2({
-            type: "node",
-            name: part,
-            pattern: pattern,
-            moduleFilePath: moduleFilePath
-          }, isLast ? {
-            page: {
-              fullPath: fullPath
-            },
-            sourcePath: sourcePath
-          } : {}), {}, {
-            children: []
-          }) : {
-            type: "leaf",
-            name: part,
-            pattern: pattern,
-            fullPath: fullPath,
-            moduleFilePath: moduleFilePath,
-            sourcePath: sourcePath,
-            children: []
-          };
-          var existingNodeIndex = currentNode.children.findIndex(function (node) {
-            return node.name === part;
-          });
-          if (existingNodeIndex === -1) {
-            currentNode.children.push(node);
-            if (currentNode.type === "node") {
-              currentNode.isLinear = true;
-              if (currentNode.children.length > 1) {
-                delete currentNode.isLinear;
-              }
-            }
-            currentNode = node;
-          } else {
-            var existingNode = currentNode.children[existingNodeIndex];
-            if (existingNode.type === "leaf" && hasChildren) {
-              var _sourcePath = existingNode.sourcePath;
-              // convert leaf to node
-              currentNode.children[existingNodeIndex] = {
-                type: "node",
-                name: part,
-                pattern: pattern,
-                page: {
-                  fullPath: fullPath
-                },
-                sourcePath: _sourcePath,
-                children: existingNode.children,
-                moduleFilePath: moduleFilePath
-              };
-              currentNode = currentNode.children[existingNodeIndex];
-            } else if (existingNode.type === "node" && isLast) {
-              // add page, source path and module file path
-              existingNode.page = {
-                fullPath: fullPath
-              };
-              existingNode.sourcePath = sourcePath;
-              existingNode.moduleFilePath = moduleFilePath;
-              existingNode.pattern = pattern;
-            } else {
-              currentNode = currentNode.children[existingNodeIndex];
-            }
-          }
-        });
-      },
-      _ret;
-    for (_iterator.s(); !(_step = _iterator.n()).done;) {
-      _ret = _loop();
-      if (_ret === 0) continue;
-    }
-  } catch (err) {
-    _iterator.e(err);
-  } finally {
-    _iterator.f();
-  }
-  return root;
-}
-function getPatternFromModuleFilePath(moduleFilePath, srcFolder) {
-  return moduleFilePath.replace(srcFolder, "")
-  // TODO: hacky!
-  // remove route groups
-  .replace(/\/\([^/]+\)/g, "") // not sure we want to do this?
-  .replace("/page.val.ts", "").replace("/page.val.js", "");
-}
-
-function parseRoutePattern(pattern) {
-  if (pattern === "" || pattern === "/") {
-    return [];
-  }
-  var p = pattern.startsWith("/") ? pattern.slice(1) : pattern;
-  return p.split("/").map(function (part) {
-    var isOptionalParam = part.startsWith("[[") && part.endsWith("]]");
-    var isNonOptionalParam = part.startsWith("[") && part.endsWith("]");
-    var nameStart = isOptionalParam ? 2 : isNonOptionalParam ? 1 : 0;
-    var nameEnd = part.indexOf("]", nameStart);
-    var isArrayParam = part.slice(nameStart, nameStart + 3) === "...";
-    var paramName = part.slice(nameStart + (isArrayParam ? 3 : 0), nameEnd);
-    if (isOptionalParam || isNonOptionalParam) {
-      if (isArrayParam) {
-        return {
-          type: "array-param",
-          paramName: paramName,
-          optional: isOptionalParam
-        };
-      } else {
-        return {
-          type: "string-param",
-          paramName: paramName,
-          optional: isOptionalParam
-        };
-      }
-    }
-    return {
-      type: "literal",
-      name: part
-    };
-  });
-}
-
-function getNextAppRouterSourceFolder(moduleFilePath) {
-  if (moduleFilePath.startsWith("/app")) {
-    return "/app";
-  } else if (moduleFilePath.startsWith("/src/app")) {
-    return "/src/app";
-  }
-  return null;
-}
-
 /**
  * Shared route validation utilities
  */
@@ -4327,84 +4042,6 @@ function resolveSchemaSourceFixes(validationErrors, snapshot) {
   return result;
 }
 
-/**
- * The protocol between the studio's canvas and the page inside it.
- *
- * The canvas shows the running site in a frame. That frame is a different
- * document — the customer's app, rendered by their components — so the studio
- * cannot reach into it, and it cannot reach out. Everything they say to each
- * other goes through `postMessage`, and this is the vocabulary.
- *
- * It lives in `shared` because both halves have to agree on it: the page half
- * ships in `@valbuild/next`, the studio half in `@valbuild/ui`, and a message
- * shape defined twice is a message shape that will differ once.
- *
- * ## Why a query parameter turns it on
- *
- * The frame has to render the page as Val sees it — draft content, with
- * `data-val-path` on every element Val tracks — while *not* showing Val's own
- * overlay, because the studio is already the UI. Nothing about the cookies can
- * express that: they are per-origin, and the studio and the page share an
- * origin, so a cookie would change the customer's own tabs too. A parameter on
- * the frame's URL is scoped to exactly the one document that needs it.
- */
-
-/** Marks a page load as the studio's canvas frame. */
-var VAL_CANVAS_PARAM = "val_canvas";
-
-/**
- * Every message is tagged with this, and the tag is checked on receipt.
- *
- * A window receives messages from anything that has a handle on it —
- * extensions, embeds, other frames — and `event.data` is whatever they chose to
- * send. Checking a discriminator before reading anything else is what keeps a
- * stray message from being read as a canvas instruction.
- */
-var VAL_CANVAS_MESSAGE = "val-canvas";
-
-/** One element on the page that Val has a path for. */
-
-/** What the page tells the studio. */
-
-/** What the studio tells the page. */
-
-/** Narrow an unknown `event.data` to a message from the page. */
-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" || message.type === "elements" || message.type === "clicked" || message.type === "pinch" || message.type === "zoom" || message.type === "refreshing";
-}
-
-/** Narrow an unknown `event.data` to a message from the studio. */
-function isValCanvasStudioMessage(data) {
-  if (_typeof(data) !== "object" || data === null) return false;
-  var message = data;
-  if (message.val !== VAL_CANVAS_MESSAGE) return false;
-  return message.type === "rescan" || message.type === "highlight" || message.type === "setPicking" || message.type === "sourceUpdate" || message.type === "sourcesSynced";
-}
-
-/**
- * Whether this document was loaded as the studio's canvas frame.
- *
- * Reads the location directly rather than taking it as an argument, because
- * every caller wants the answer for the document it is running in, and passing
- * it around is how one of them ends up asking about the wrong one.
- */
-function isValCanvasFrame(search) {
-  try {
-    return new URLSearchParams(search).get(VAL_CANVAS_PARAM) !== null;
-  } catch (_unused) {
-    return false;
-  }
-}
-
-/** Add the canvas marker to a page URL. */
-function withValCanvasParam(url) {
-  var separator = url.includes("?") ? "&" : "?";
-  return "".concat(url).concat(separator).concat(VAL_CANVAS_PARAM, "=1");
-}
-
 /**
  * Local `yyyy-MM-dd`, which is the one thing this module used `date-fns` for.
  *
@@ -4666,13 +4303,21 @@ function checkGallerySchema(moduleSchema) {
   };
 }
 function buildImageGalleryPatch(args, moduleSchema) {
+  var _args$metadata$alt;
   var wrong = checkGallerySchema(moduleSchema);
   if (wrong) return wrong;
   var remote = isRemoteSchema(moduleSchema);
   var patch = [{
     op: "add",
     path: [args.filePath],
-    value: _objectSpread2({}, args.metadata)
+    value: _objectSpread2(_objectSpread2({}, args.metadata), {}, {
+      // `alt` is a REQUIRED field of a gallery entry (`s.images()` gives it a
+      // nullable string schema), so an entry written without one is invalid
+      // the moment it lands — and the caller that had no alt to give is the
+      // common case, not the odd one. Null is what the Studio's own upload
+      // writes there.
+      alt: (_args$metadata$alt = args.metadata.alt) !== null && _args$metadata$alt !== void 0 ? _args$metadata$alt : null
+    })
   }, {
     op: "file",
     path: [args.filePath],
@@ -5164,4 +4809,702 @@ function filterBlockingValidationErrors(validationErrors, schemas, sources) {
   return partitionValidationErrors(resolved).surfaced;
 }
 
-export { Api, BinaryFileRef, CodeOptions, ColorOptions, DEFAULT_ERROR_MESSAGE, DateOptions, FileOptions, HistoricalCommit, HistoricalModule, HistoricalPatchSet, HistoryError, ImageEncodeOption, ImageOptions, JSONValue, JSON_ENTRIES_BATCH_MAX, ModuleComparison, ParentRef$1 as ParentRef, Patch, PatchBlock, PatchGroup, PatchId, PatchJSON, RemirrorBr, RemirrorBulletList, RemirrorHeading, RemirrorImage, RemirrorJSON, RemirrorLinkMark, RemirrorListItem, RemirrorOrderedList, RemirrorParagraph, RemirrorText, RemirrorTextMark, RestoreVerdict, RichTextOptions, SerializedArraySchema, SerializedBooleanSchema, SerializedCodeSchema, SerializedColorSchema, SerializedDateSchema, SerializedDateTimeSchema, SerializedFileSchema, SerializedImageSchema, SerializedKeyOfSchema, SerializedLiteralSchema, SerializedNumberSchema, SerializedObjectSchema, SerializedRecordSchema, SerializedRichTextSchema, SerializedRouteSchema, SerializedSchema, SerializedSettingsSchema, SerializedStringSchema, SerializedUnionSchema, SharedValConfig, VAL_AI_SESSION_STORAGE_KEY, VAL_CANVAS_MESSAGE, VAL_CANVAS_PARAM, VAL_CONFIG_SESSION_STORAGE_KEY, VAL_ENABLE_COOKIE_NAME, VAL_SESSION_COOKIE, VAL_STATE_COOKIE, VAL_THEME_SESSION_STORAGE_KEY, ValCommit, ValDeployment, buildDuplicatePatch, buildEmptyAtPathPatch, buildFileRefValue, buildImageGalleryPatch, buildRemoveImageGalleryEntryPatch, checkCompatibility, createRegExpFromPattern, createValClient, describeContainerAtPath, emptyOf, explainIncompatible, filterBlockingValidationErrors, filterRoutesByPatterns, findSimilar, getErrorMessageFromUnknownJson, getInlineImgInfo, getNextAppRouterSitemapTree, getNextAppRouterSourceFolder, getPatternFromModuleFilePath, getRoutesOf, getRoutesWithModulePaths, getSourceAt, isRemoteSchema, isValCanvasFrame, isValCanvasPageMessage, isValCanvasStudioMessage, levenshtein, newestCommitSha, parseRoutePattern, partitionValidationErrors, remirrorToRichTextSource, resolveSchemaSourceFixForError, resolveSchemaSourceFixes, resolveSerializedSchemaAtPath, richTextToRemirror, safeParsePatch, toolNames, urlOf, validateRoutePatterns, withValCanvasParam };
+/**
+ * Every decision `encode` makes, with none of the pixels.
+ *
+ * The re-encode itself happens in two places that share nothing: the Studio
+ * runs it on a `<canvas>` before the upload leaves the browser
+ * (`packages/ui/spa/utils/encodeImage.ts`), and the MCP image tool runs it on
+ * `sharp` in the server process (`@valbuild/mcp`). What must NOT differ between
+ * them is what `s.image({ encode })` means — which images are converted, how
+ * far they are scaled, and when the original wins anyway. So the decisions live
+ * here, once, and each side supplies only its own encoder.
+ *
+ * See `architecture/media.md`.
+ */
+
+var ENCODE_DEFAULTS = {
+  quality: 0.8,
+  maxWidth: 2560,
+  maxHeight: 2560
+};
+var ENCODE_MIME_TYPE_OF = {
+  webp: "image/webp"
+};
+
+/**
+ * Formats an encoder cannot round-trip without losing something: SVG is vector,
+ * an animated GIF keeps only its first frame, and AVIF is already smaller than
+ * anything we would produce.
+ */
+var NEVER_ENCODED = ["image/svg+xml", "image/gif", "image/avif"];
+
+/** A dimension bound the encoder can act on, else the default. */
+function usableBound(value, fallback) {
+  return value !== undefined && Number.isFinite(value) && value > 0 ? value : fallback;
+}
+
+/**
+ * The schema's own option first, then the gallery it references, then off.
+ *
+ * Mirrors how `ImageField` resolves `accept` and `directory`. A gallery-backed
+ * field (`s.image(galleryVal)`) serializes with EMPTY options, so without the
+ * gallery fallback it could never inherit what the gallery asked for — and
+ * `s.image(galleryVal, { encode: false })` is how such a field opts back out.
+ *
+ * Nonsense numbers fall back to the defaults rather than through. `fitWithin`
+ * reads a bound of 0 (or NaN, or a negative) as "everything already fits", so
+ * an unusable `maxWidth` would otherwise SILENTLY disable the downscale it was
+ * asking for, and a `quality` outside 0–1 is ignored by `canvas.toBlob` just as
+ * quietly. Falling back is deliberately not throwing: a schema is evaluated by
+ * the CLI's `node:vm` sandbox and by the Next server, so a typo'd quality would
+ * take a whole project down over an upload-time optimisation.
+ */
+function resolveEncodeSettings(fieldOption, galleryOption) {
+  var option = fieldOption !== undefined ? fieldOption : galleryOption;
+  if (!option) {
+    return null;
+  }
+  var quality = option.quality;
+  return {
+    type: option.type,
+    quality: quality !== undefined && Number.isFinite(quality) && quality > 0 ? Math.min(quality, 1) : ENCODE_DEFAULTS.quality,
+    maxWidth: usableBound(option.maxWidth, ENCODE_DEFAULTS.maxWidth),
+    maxHeight: usableBound(option.maxHeight, ENCODE_DEFAULTS.maxHeight)
+  };
+}
+
+/**
+ * Dimensions scaled to fit inside the box, or null when the image already does.
+ *
+ * Null is the signal for "no downscale was needed", which the size comparison
+ * in {@link chooseEncoded} turns on.
+ */
+function fitWithin(width, height, maxWidth, maxHeight) {
+  if (!(width > 0) || !(height > 0) || !(maxWidth > 0) || !(maxHeight > 0) || width <= maxWidth && height <= maxHeight) {
+    return null;
+  }
+  var scale = Math.min(maxWidth / width, maxHeight / height);
+  return {
+    // At least one pixel: a very wide, very short image would otherwise round
+    // its height to zero, and a zero-sized canvas cannot be encoded.
+    width: Math.max(1, Math.round(width * scale)),
+    height: Math.max(1, Math.round(height * scale))
+  };
+}
+
+/**
+ * Whether a schema that declares `accept` would take this mime type.
+ *
+ * The same rules as `ImageSchema.executeValidate`, which validates the STORED
+ * mimeType against `accept` — so converting to a type `accept` forbids would
+ * upload a file the schema reports as invalid the moment it lands. Delegated to
+ * `@valbuild/core` rather than re-spelled, because a second reading of one
+ * `accept` string is how a converted image passes here and fails there.
+ */
+function isMimeTypeAccepted(mimeType, accept) {
+  if (!accept) {
+    return true;
+  }
+  return Internal.mimeTypeMatchesAccept(mimeType, accept);
+}
+
+/** Formats left alone: the lossy list, plus the target type when it already fits. */
+function isSkippedSource(sourceMimeType, targetMimeType, needsDownscale) {
+  if (NEVER_ENCODED.includes(sourceMimeType)) {
+    return true;
+  }
+  return sourceMimeType === targetMimeType && !needsDownscale;
+}
+
+/**
+ * Whether to upload what the encoder produced, or the file that was picked.
+ *
+ * Two ways the encoded bytes lose. They are not actually the type we asked for
+ * — `canvas.toBlob` answers an unsupported type with a PNG rather than with
+ * null, so "not null" is not the same question as "is a webp". Or they are
+ * simply bigger, which happens for small and flat images: measured, an 8x8
+ * solid PNG of 74 bytes becomes a 548 byte webp. A downscale overrides that,
+ * since the original is then the wrong size whatever it weighs.
+ */
+function chooseEncoded(input) {
+  if (input.encodedSize === null || input.encodedType !== input.targetMimeType) {
+    return false;
+  }
+  if (input.needsDownscale) {
+    return true;
+  }
+  return input.encodedSize < input.originalSize;
+}
+
+/**
+ * `photo.png` -> `photo.webp`. The extension is re-derived downstream too, but
+ * the name should not lie.
+ */
+function withExtension(filename, ext) {
+  var base = filename.split(".").slice(0, -1).join(".") || filename;
+  return "".concat(base, ".").concat(ext);
+}
+
+/**
+ * The one way to build a child's source path.
+ *
+ * There were five hand-rolled versions of this, three of them subtly different
+ * and two of them wrong, and the wrong ones were wrong in a way that hid: a
+ * module path segment has to be JSON-quoted if it is a string and bare if it is
+ * an array index, and both broken copies appended the raw key at the module
+ * root. An unquoted key parses fine as long as it contains no `.` — so every
+ * object field and every ordinary record key still resolved, and only a key with
+ * a dot in it broke. That is exactly what a media gallery is keyed by, so
+ * clicking a file in the Media panel navigated to
+ * `?p=/public/val/red-8x8_bfbd0.png`, which `splitModulePath` reads as the two
+ * segments `/public/val/red-8x8_bfbd0` and `png`, and the studio said the module
+ * was not found.
+ *
+ * So: one function, and never a template string. `Internal.createValPathOfItem`
+ * is the rule itself — `JSON.stringify` quotes a string and leaves a number
+ * bare, which is precisely the module-path grammar — and everything here defers
+ * to it rather than restating it.
+ */
+function sourcePathOfChild(parent, key) {
+  /**
+   * A parent that is already `…?p=` gets the key with no separator.
+   *
+   * The search index walks from `moduleFilePath + "?p="` rather than from the
+   * module file path, so that every path it produces has a module path — and
+   * `createValPathOfItem` would see the separator and join with a `.`, giving
+   * `?p=."title"`.
+   */
+  if (parent.endsWith(Internal.ModuleFilePathSep)) {
+    return "".concat(parent).concat(JSON.stringify(key));
+  }
+  var path = Internal.createValPathOfItem(parent, key);
+  if (path === undefined) {
+    // Only when the parent is empty, which callers cannot produce: every walk
+    // starts from a module file path. Thrown rather than skipped so a future
+    // change that breaks that assumption is loud.
+    throw new Error("Could not build a source path for '".concat(key, "' under ").concat(parent));
+  }
+  return path;
+}
+
+/**
+ * The same thing, for callers holding the module file path and module path apart.
+ *
+ * `ModulePath` is empty at the module root, which is the case both broken copies
+ * got wrong: there is no separator in the path yet, so the key is the first
+ * segment and still has to be quoted.
+ */
+function concatModulePath(moduleFilePath, modulePath, key) {
+  return sourcePathOfChild(modulePath ? Internal.joinModuleFilePathAndModulePath(moduleFilePath, modulePath) : moduleFilePath, key);
+}
+
+/**
+ * Traverses a schema and source pair, calling a callback for each leaf node.
+ * Handles all schema types including primitives, objects, arrays, records, unions, richtext, files, images, etc.
+ *
+ * @param source - The JSON source data
+ * @param schema - The serialized schema
+ * @param path - The current source path
+ * @param callback - Function called for each traversable node with { source, schema, path }
+ */
+function traverseSchemaSource(source, schema, path, callback) {
+  if (!(schema !== null && schema !== void 0 && schema.type)) {
+    throw new Error("Schema not found for " + path);
+  }
+  if (source === null) {
+    return;
+  }
+
+  // An un-loaded `.jsonValues()` entry is an opaque `{_type:"json"}` marker, not
+  // the value its schema describes. Skip it — its content is traversed once
+  // loaded, since the sync engine substitutes it in place of the marker.
+  //
+  // Without this the marker falls through to whichever branch its ITEM schema
+  // selects: an object/record item walks the marker's OWN keys, so an entry
+  // schema with a field named `_type` or `patch_id` would index the marker's
+  // internals as if they were content.
+  if (Internal.isJson(source)) {
+    return;
+  }
+
+  // Handle primitives
+  if (schema.type === "string") {
+    if (typeof source === "string") {
+      callback({
+        source: source,
+        schema: schema,
+        path: path
+      });
+    }
+    return;
+  }
+  if (schema.type === "number") {
+    if (typeof source === "number") {
+      callback({
+        source: source,
+        schema: schema,
+        path: path
+      });
+    }
+    return;
+  }
+  if (schema.type === "boolean") {
+    if (typeof source === "boolean") {
+      callback({
+        source: source,
+        schema: schema,
+        path: path
+      });
+    }
+    return;
+  }
+
+  // Handle richtext - flatten and call callback
+  if (schema.type === "richtext") {
+    callback({
+      source: source,
+      schema: schema,
+      path: path
+    });
+    return;
+  }
+
+  // Handle file/image
+  if (schema.type === "file" || schema.type === "image") {
+    if (source && _typeof(source) === "object" && "path" in source && typeof source.path === "string") {
+      callback({
+        source: source,
+        schema: schema,
+        path: path
+      });
+    }
+    return;
+  }
+
+  // Handle date
+  if (schema.type === "date") {
+    if (typeof source === "string") {
+      callback({
+        source: source,
+        schema: schema,
+        path: path
+      });
+    }
+    return;
+  }
+
+  // Handle dateTime
+  if (schema.type === "dateTime") {
+    if (typeof source === "string") {
+      callback({
+        source: source,
+        schema: schema,
+        path: path
+      });
+    }
+    return;
+  }
+
+  // Handle color
+  if (schema.type === "color") {
+    if (typeof source === "string") {
+      callback({
+        source: source,
+        schema: schema,
+        path: path
+      });
+    }
+    return;
+  }
+
+  // Handle code
+  if (schema.type === "code") {
+    if (typeof source === "string") {
+      callback({
+        source: source,
+        schema: schema,
+        path: path
+      });
+    }
+    return;
+  }
+
+  // Handle keyOf
+  if (schema.type === "keyOf") {
+    if (typeof source === "string" || typeof source === "number") {
+      callback({
+        source: source,
+        schema: schema,
+        path: path
+      });
+    }
+    return;
+  }
+
+  // Handle literal
+  if (schema.type === "literal") {
+    callback({
+      source: source,
+      schema: schema,
+      path: path
+    });
+    return;
+  }
+
+  // Handle route
+  if (schema.type === "route") {
+    if (typeof source === "string") {
+      callback({
+        source: source,
+        schema: schema,
+        path: path
+      });
+    }
+    return;
+  }
+
+  // Handle array
+  if (schema.type === "array") {
+    if (!Array.isArray(source)) {
+      return;
+    }
+    if (!schema.item) {
+      throw new Error("Schema (" + schema.type + ") item not found for " + path);
+    }
+    for (var i = 0; i < source.length; i++) {
+      var subPath = sourcePathOfChild(path, i);
+      traverseSchemaSource(source[i], schema.item, subPath, callback);
+    }
+    return;
+  }
+
+  // Handle object, record and settings
+  if (schema.type === "object" || schema.type === "record" ||
+  // Settings walks like an object, and starting from the SOURCE is what makes
+  // its optional keys work: an absent section has nothing to traverse.
+  schema.type === "settings") {
+    if (_typeof(source) !== "object" || source === null || Array.isArray(source)) {
+      return;
+    }
+    for (var key in source) {
+      var _schema$items;
+      var subSchema = schema.type === "record" ? schema.item : (_schema$items = schema.items) === null || _schema$items === void 0 ? void 0 : _schema$items[key];
+      if (!subSchema) {
+        continue;
+      }
+      var _subPath = sourcePathOfChild(path, key);
+      traverseSchemaSource(source[key], subSchema, _subPath, callback);
+    }
+    return;
+  }
+
+  // Handle union
+  if (schema.type === "union") {
+    var schemaKey = schema.key;
+    if (typeof schemaKey === "string") {
+      // Tagged union - find matching sub-schema
+      if (source && _typeof(source) === "object" && !Array.isArray(source) && schemaKey in source) {
+        var itemKey = source[schemaKey];
+        if (typeof itemKey === "string") {
+          var schemaOfItem = schema.items.filter(function (item) {
+            return item.type === "object";
+          }).find(function (item) {
+            var itemKeySchema = item.items[schemaKey];
+            if ((itemKeySchema === null || itemKeySchema === void 0 ? void 0 : itemKeySchema.type) === "literal") {
+              return itemKeySchema.value === itemKey;
+            }
+            return false;
+          });
+          if (schemaOfItem) {
+            traverseSchemaSource(source, schemaOfItem, path, callback);
+          }
+        }
+      }
+    } else {
+      // Literal union - treat as primitive
+      if (typeof source === "string") {
+        callback({
+          source: source,
+          schema: schema,
+          path: path
+        });
+      }
+    }
+    return;
+  }
+
+  // Exhaustive check
+  var exhaustiveCheck = schema;
+  throw new Error("Unsupported schema type: " + JSON.stringify(exhaustiveCheck));
+}
+
+/**
+ * Flattens richtext source to a plain string, extracting only text content.
+ * Used for indexing richtext content in search.
+ */
+function flattenRichText(source) {
+  var res = "";
+  function rec(child) {
+    if (typeof child === "string") {
+      res += child;
+    } else {
+      if (child && _typeof(child) === "object" && "children" in child && Array.isArray(child.children)) {
+        var _iterator = _createForOfIteratorHelper(child.children),
+          _step;
+        try {
+          for (_iterator.s(); !(_step = _iterator.n()).done;) {
+            var c = _step.value;
+            rec(c);
+          }
+        } catch (err) {
+          _iterator.e(err);
+        } finally {
+          _iterator.f();
+        }
+      }
+    }
+  }
+  rec({
+    children: source
+  });
+  return res;
+}
+
+/**
+ * Resolves a file ref (local path or remote URL) to a clean local-style path.
+ */
+function cleanRefPath(ref) {
+  var remoteRefRes = Internal.remote.splitRemoteRef(ref);
+  return remoteRefRes.status === "success" ? "/".concat(remoteRefRes.filePath) : ref;
+}
+
+/**
+ * Extract a human-readable filename from a file ref (local path or remote URL).
+ * Handles both remote refs (via splitRemoteRef) and plain `/public/...` paths.
+ */
+function getFilenameFromRef(ref) {
+  var cleanPath = cleanRefPath(ref);
+  return cleanPath.split("/").pop() || cleanPath;
+}
+
+/**
+ * Parse a file ref into its constituent parts: a clean path, filename, and
+ * folder (the path relative to `/public`).
+ *
+ * The `folder` strips the standard `/public` prefix so it shows a
+ * concise location like `/images` instead of `/public/images`.
+ */
+function getRefParts(ref) {
+  var cleanPath = cleanRefPath(ref);
+  var filename = cleanPath.split("/").pop() || cleanPath;
+  // Only strip a leading "/public" path segment: "/publicity/a.png" must keep its folder
+  var folder = cleanPath.replace(/^\/public(?=\/|$)/, "").replace(/\/[^/]+$/, "") || "/";
+  return {
+    cleanPath: cleanPath,
+    filename: filename,
+    folder: folder
+  };
+}
+
+/**
+ * The search index and the labels to render for its hits.
+ *
+ * Kept as a plain module rather than living inside a worker so it can be tested:
+ * a worker entry runs `self.onmessage` on import, which no test environment here
+ * provides.
+ *
+ * In `@valbuild/shared` rather than the Studio because there are now two
+ * realms searching the same content: the Studio's `SearchStore`, which keeps an
+ * index alive in a worker and re-indexes a module at a time, and the MCP
+ * `search_content` tool, which builds one per call and throws it away. What
+ * counts as a document, and what a hit is labelled, must not differ between
+ * them — an agent and an editor searching the same project should find the same
+ * things.
+ */
+
+/** An index with nothing in it. Fill it with {@link indexModule}. */
+function createSearchIndex() {
+  return {
+    index: new FlexSearch.Index({
+      tokenize: "forward"
+    }),
+    pathToLabel: new Map(),
+    docsByModule: new Map()
+  };
+}
+
+/**
+ * Index one module, replacing whatever was previously indexed for it.
+ *
+ * Remove-then-add rather than `update`, because the set of paths in a module is
+ * not stable: deleting an array item or a record entry means documents that must
+ * disappear, and `update` only revises ids it is given.
+ *
+ * `.jsonValues()` entries are indexed only once their content is loaded — an
+ * un-loaded entry is an opaque marker that {@link traverseSchemaSource} skips, so
+ * the index is naturally PARTIAL and grows as batches land. That is why the search
+ * UI loads the entries on the first query and re-indexes (debounced) as they
+ * arrive, rather than pretending an empty result set is an answer.
+ */
+function indexModule(searchIndex, moduleFilePath, source, schema) {
+  var index = searchIndex.index,
+    pathToLabel = searchIndex.pathToLabel,
+    docsByModule = searchIndex.docsByModule;
+  removeModule(searchIndex, moduleFilePath);
+  var docs = new Set();
+  docsByModule.set(moduleFilePath, docs);
+  var path = moduleFilePath + "?p=";
+  traverseSchemaSource(source, schema, path, function (_ref) {
+    var source = _ref.source,
+      schema = _ref.schema,
+      path = _ref.path;
+    if (source === null) {
+      return;
+    }
+    var searchText = "";
+    var label = "";
+
+    // Handle primitives
+    if (schema.type === "string" || schema.type === "number" || schema.type === "boolean" || schema.type === "date" || schema.type === "dateTime" || schema.type === "color" || schema.type === "code" || schema.type === "keyOf" || schema.type === "route") {
+      var _source$toString, _source$toString2;
+      searchText = (_source$toString = source === null || source === void 0 ? void 0 : source.toString()) !== null && _source$toString !== void 0 ? _source$toString : "";
+      label = (_source$toString2 = source === null || source === void 0 ? void 0 : source.toString()) !== null && _source$toString2 !== void 0 ? _source$toString2 : "";
+    } else if (schema.type === "literal") {
+      searchText = schema.value.toString();
+      label = schema.value.toString();
+    }
+    // Handle richtext - flatten to get text content
+    else if (schema.type === "richtext") {
+      searchText = flattenRichText(source);
+      // Use first 50 chars as label
+      label = searchText.substring(0, 50) || "richtext";
+    }
+    // Handle file/image
+    else if (schema.type === "file" || schema.type === "image") {
+      if (source !== null && _typeof(source) === "object" && "path" in source && typeof source.path === "string") {
+        // The label is the bare filename - the folder is shown separately in
+        // the UI - but both are searchable.
+        var _getRefParts = getRefParts(source.path),
+          filename = _getRefParts.filename,
+          folder = _getRefParts.folder;
+        var alt = "alt" in source ? source.alt : "";
+        searchText = filename + " " + folder + " " + alt;
+        label = filename;
+      }
+    }
+
+    // Add to index if we have search text
+    if (searchText) {
+      var _Internal$splitModule = Internal.splitModuleFilePathAndModulePath(path),
+        _Internal$splitModule2 = _slicedToArray(_Internal$splitModule, 2),
+        modulePath = _Internal$splitModule2[1];
+      var cleanPath = fastRemoveNonWordChars(modulePath) + " ";
+      index.add(path, cleanPath + " " + path + " " + searchText);
+      pathToLabel.set(path, label);
+      docs.add(path);
+    }
+  });
+}
+
+/**
+ * Drop everything indexed for one module.
+ *
+ * Also used for a module that has gone away entirely — otherwise its documents
+ * stay searchable and a hit navigates to a path that no longer exists.
+ */
+function removeModule(searchIndex, moduleFilePath) {
+  var index = searchIndex.index,
+    pathToLabel = searchIndex.pathToLabel,
+    docsByModule = searchIndex.docsByModule;
+  var existing = docsByModule.get(moduleFilePath);
+  if (existing === undefined) return;
+  var _iterator = _createForOfIteratorHelper(existing),
+    _step;
+  try {
+    for (_iterator.s(); !(_step = _iterator.n()).done;) {
+      var id = _step.value;
+      index.remove(id);
+      pathToLabel["delete"](id);
+    }
+  } catch (err) {
+    _iterator.e(err);
+  } finally {
+    _iterator.f();
+  }
+  docsByModule["delete"](moduleFilePath);
+}
+
+/**
+ * Index every module, from scratch.
+ *
+ * Now a loop over {@link indexModule} rather than its own walk, so the full
+ * build and the incremental one cannot drift in what they consider a document.
+ */
+function buildSearchIndex(modules) {
+  var searchIndex = createSearchIndex();
+  for (var moduleFilePathS in modules) {
+    var moduleFilePath = moduleFilePathS;
+    var _modules$moduleFilePa = modules[moduleFilePath],
+      source = _modules$moduleFilePa.source,
+      schema = _modules$moduleFilePa.schema;
+    indexModule(searchIndex, moduleFilePath, source, schema);
+  }
+  return searchIndex;
+}
+var NON_CHARS = new Set(["/", "-", "_", ".", ":", "?", "&", "=", "@", '"', "'"]);
+function fastRemoveNonWordChars(str) {
+  var result = "";
+  for (var i = 0; i < str.length; i++) {
+    var _char = str[i];
+    if (!NON_CHARS.has(_char)) {
+      result += _char;
+    } else {
+      result += " ";
+    }
+  }
+  return result;
+}
+
+/**
+ * How many hits are counted before `total` stops being a count.
+ *
+ * FlexSearch stops as soon as it has the number of ids it was asked for, so a
+ * `total` taken from a page-sized search is just the page size again — which
+ * reads as "that is all there is" to anyone who did not write it. Counting is
+ * asking for more ids than the page needs, so it costs an array of ids and no
+ * more; this bound is where that stops being free, and `totalIsLowerBound` says
+ * it was reached rather than letting the number quietly lie.
+ */
+var MAX_COUNTED_RESULTS = 10000;
+function performSearch(searchIndex, query) {
+  var limit = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 50;
+  var offset = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : 0;
+  if (searchIndex === null || !query.trim()) {
+    return {
+      results: [],
+      total: 0,
+      totalIsLowerBound: false
+    };
+  }
+  var index = searchIndex.index,
+    pathToLabel = searchIndex.pathToLabel;
+  var counted = Math.max(offset + limit, MAX_COUNTED_RESULTS);
+  var searchResults = index.search(query, {
+    limit: counted
+  });
+  var total = searchResults.length;
+  var paged = searchResults.slice(offset, offset + limit);
+  return {
+    results: paged.map(function (id) {
+      return {
+        path: id,
+        label: pathToLabel.get(id) || id
+      };
+    }),
+    total: total,
+    totalIsLowerBound: total >= counted
+  };
+}
+
+export { Api, BinaryFileRef, CodeOptions, ColorOptions, DEFAULT_ERROR_MESSAGE, DateOptions, ENCODE_DEFAULTS, ENCODE_MIME_TYPE_OF, FileOptions, HistoricalCommit, HistoricalModule, HistoricalPatchSet, HistoryError, ImageEncodeOption, ImageOptions, JSONValue, JSON_ENTRIES_BATCH_MAX, ModuleComparison, NEVER_ENCODED, ParentRef$1 as ParentRef, Patch, PatchBlock, PatchGroup, PatchId, PatchJSON, RemirrorBr, RemirrorBulletList, RemirrorHeading, RemirrorImage, RemirrorJSON, RemirrorLinkMark, RemirrorListItem, RemirrorOrderedList, RemirrorParagraph, RemirrorText, RemirrorTextMark, RestoreVerdict, RichTextOptions, SerializedArraySchema, SerializedBooleanSchema, SerializedCodeSchema, SerializedColorSchema, SerializedDateSchema, SerializedDateTimeSchema, SerializedFileSchema, SerializedImageSchema, SerializedKeyOfSchema, SerializedLiteralSchema, SerializedNumberSchema, SerializedObjectSchema, SerializedRecordSchema, SerializedRichTextSchema, SerializedRouteSchema, SerializedSchema, SerializedSettingsSchema, SerializedStringSchema, SerializedUnionSchema, SharedValConfig, VAL_ENABLE_COOKIE_NAME, VAL_SESSION_COOKIE, VAL_STATE_COOKIE, ValCommit, ValDeployment, buildDuplicatePatch, buildEmptyAtPathPatch, buildFileRefValue, buildImageGalleryPatch, buildRemoveImageGalleryEntryPatch, buildSearchIndex, checkCompatibility, chooseEncoded, concatModulePath, createRegExpFromPattern, createSearchIndex, createValClient, describeContainerAtPath, emptyOf, explainIncompatible, filterBlockingValidationErrors, filterRoutesByPatterns, findSimilar, fitWithin, flattenRichText, getErrorMessageFromUnknownJson, getFilenameFromRef, getInlineImgInfo, getRefParts, getRoutesOf, getRoutesWithModulePaths, getSourceAt, indexModule, isMimeTypeAccepted, isRemoteSchema, isSkippedSource, levenshtein, newestCommitSha, partitionValidationErrors, performSearch, remirrorToRichTextSource, removeModule, resolveEncodeSettings, resolveSchemaSourceFixForError, resolveSchemaSourceFixes, resolveSerializedSchemaAtPath, richTextToRemirror, safeParsePatch, sourcePathOfChild, toolNames, traverseSchemaSource, urlOf, validateRoutePatterns, withExtension };