@valbuild/shared 0.123.0 → 0.123.3

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

@@ -1,118 +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';
 import FlexSearch from 'flexsearch';
-
-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 { b as base64DataUrlToUint8Array } from '../../dist/utils-00f3e1df.esm.js';
 
 function remirrorToRichTextSource(node, configDirectory, remoteOptions) {
   var files = {};
@@ -1012,97 +904,96 @@ var InlineRender = z.object({
   as: z.literal("inline")
 });
 var FieldRender = InlineRender.optional();
-var SerializedStringSchema = z.object({
-  type: z.literal("string"),
+
+/**
+ * The fields EVERY serialized schema carries, in one place.
+ *
+ * Spread into each schema below rather than retyped, because retyping them is
+ * exactly how they went missing: `customValidate` and `description` were
+ * declared on six of the eighteen schemas and silently dropped by the other
+ * twelve. A field added to the base of `SerializedSchema` needs adding here and
+ * nowhere else.
+ *
+ * `type`, `opt` and whatever is particular to the schema stay at the call site
+ * - those differ per schema, so there is nothing to share.
+ */
+var commonSchemaFields = {
   render: FieldRender,
+  preview: z.literal(true).optional(),
+  // Whether the schema declares a `.validate()`. The function cannot serialize,
+  // so this flag is what tells the Studio to run the custom validators on the
+  // main thread against the real instance - dropped, and they never run at all.
+  // See `hasCustomValidate` in `ui/spa/validation/customValidate.ts`.
+  customValidate: z["boolean"]().optional(),
+  readonly: z["boolean"]().optional(),
+  hidden: z["boolean"]().optional(),
+  description: z.string().optional()
+};
+var SerializedStringSchema = z.object(_objectSpread2(_objectSpread2({}, commonSchemaFields), {}, {
+  type: z.literal("string"),
   // `.multiline()`. Stripped like any undeclared key if it goes missing here,
   // which is a single-line input where the author asked for a text box.
   multiline: z["boolean"]().optional(),
-  preview: z.literal(true).optional(),
   options: z.object({
     maxLength: z.number().optional(),
     minLength: z.number().optional(),
     regexp: z.object({
+      // `.regexp(re, message)`'s message. Written by
+      // `StringSchema.executeSerialize`, so omitting it here strips the
+      // author's own wording and leaves the generic "Expected string to
+      // match reg exp: …" in its place.
+      message: z.string().optional(),
       source: z.string(),
       flags: z.string()
-    }).optional()
+    }).optional(),
+    customValidate: z["boolean"]().optional()
   }).optional(),
   opt: z["boolean"](),
-  raw: z["boolean"](),
-  readonly: z["boolean"]().optional(),
-  hidden: z["boolean"]().optional()
-});
-var SerializedLiteralSchema = z.object({
+  raw: z["boolean"]()
+}));
+var SerializedLiteralSchema = z.object(_objectSpread2(_objectSpread2({}, commonSchemaFields), {}, {
   type: z.literal("literal"),
-  render: FieldRender,
-  preview: z.literal(true).optional(),
   value: z.string(),
-  opt: z["boolean"](),
-  readonly: z["boolean"]().optional(),
-  hidden: z["boolean"]().optional()
-});
-var SerializedBooleanSchema = z.object({
+  opt: z["boolean"]()
+}));
+var SerializedBooleanSchema = z.object(_objectSpread2(_objectSpread2({}, commonSchemaFields), {}, {
   type: z.literal("boolean"),
-  render: FieldRender,
-  preview: z.literal(true).optional(),
-  opt: z["boolean"](),
-  readonly: z["boolean"]().optional(),
-  hidden: z["boolean"]().optional()
-});
-var SerializedNumberSchema = z.object({
+  opt: z["boolean"]()
+}));
+var SerializedNumberSchema = z.object(_objectSpread2(_objectSpread2({}, commonSchemaFields), {}, {
   type: z.literal("number"),
-  render: FieldRender,
-  preview: z.literal(true).optional(),
   options: z.object({
     max: z.number().optional(),
     min: z.number().optional()
   }).optional(),
-  opt: z["boolean"](),
-  readonly: z["boolean"]().optional(),
-  hidden: z["boolean"]().optional()
-});
+  opt: z["boolean"]()
+}));
 var SerializedObjectSchema = z.lazy(function () {
-  return z.object({
+  return z.object(_objectSpread2(_objectSpread2({}, commonSchemaFields), {}, {
     type: z.literal("object"),
-    render: FieldRender,
-    preview: z.literal(true).optional(),
     items: z.record(z.string(), SerializedSchema),
-    opt: z["boolean"](),
-    readonly: z["boolean"]().optional(),
-    hidden: z["boolean"]().optional()
-  });
+    opt: z["boolean"]()
+  }));
 });
 var SerializedArraySchema = z.lazy(function () {
-  return z.object({
+  return z.object(_objectSpread2(_objectSpread2({}, commonSchemaFields), {}, {
     type: z.literal("array"),
-    render: FieldRender,
-    preview: z.literal(true).optional(),
     item: SerializedSchema,
-    opt: z["boolean"](),
-    readonly: z["boolean"]().optional(),
-    hidden: z["boolean"]().optional()
-  });
+    opt: z["boolean"]()
+  }));
 });
 var SerializedUnionSchema = z.lazy(function () {
-  return z.union([z.object({
+  return z.union([z.object(_objectSpread2(_objectSpread2({}, commonSchemaFields), {}, {
     type: z.literal("union"),
-    render: FieldRender,
-    preview: z.literal(true).optional(),
     key: SerializedLiteralSchema,
     items: z.array(SerializedLiteralSchema),
-    opt: z["boolean"](),
-    readonly: z["boolean"]().optional(),
-    hidden: z["boolean"]().optional()
-  }), z.object({
+    opt: z["boolean"]()
+  })), z.object(_objectSpread2(_objectSpread2({}, commonSchemaFields), {}, {
     type: z.literal("union"),
-    render: FieldRender,
-    preview: z.literal(true).optional(),
     key: z.string(),
     items: z.array(SerializedObjectSchema),
-    opt: z["boolean"](),
-    readonly: z["boolean"]().optional(),
-    hidden: z["boolean"]().optional()
-  })]);
+    opt: z["boolean"]()
+  }))]);
 });
 var ImageEncodeOption = z.union([z.literal(false), z.object({
   type: z.literal("webp"),
@@ -1115,15 +1006,16 @@ var ImageOptions = z.object({
   accept: z.string().optional(),
   encode: ImageEncodeOption.optional()
 });
-var SerializedImageSchema = z.object({
+var SerializedImageSchema = z.object(_objectSpread2(_objectSpread2({}, commonSchemaFields), {}, {
   type: z.literal("image"),
-  render: FieldRender,
-  preview: z.literal(true).optional(),
   options: ImageOptions.optional(),
   opt: z["boolean"](),
-  readonly: z["boolean"]().optional(),
-  hidden: z["boolean"]().optional()
-});
+  // `.remote()`, and the gallery a gallery-backed field reads its metadata
+  // from. Neither is cosmetic: dropped, a remote field looks local and a
+  // gallery-backed one looks like it holds its own dimensions.
+  remote: z["boolean"]().optional(),
+  referencedModule: z.string().optional()
+}));
 var RichTextOptions = z.lazy(function () {
   return z.object({
     // Set by `.maxLength()` / `.minLength()`, not by the options argument.
@@ -1146,20 +1038,14 @@ var RichTextOptions = z.lazy(function () {
     img: z.union([z["boolean"](), SerializedImageSchema]).optional()
   });
 });
-var SerializedRichTextSchema = z.object({
+var SerializedRichTextSchema = z.object(_objectSpread2(_objectSpread2({}, commonSchemaFields), {}, {
   type: z.literal("richtext"),
-  render: FieldRender,
-  preview: z.literal(true).optional(),
   options: RichTextOptions.optional(),
-  opt: z["boolean"](),
-  readonly: z["boolean"]().optional(),
-  hidden: z["boolean"]().optional()
-});
+  opt: z["boolean"]()
+}));
 var SerializedRecordSchema = z.lazy(function () {
-  return z.object({
+  return z.object(_objectSpread2(_objectSpread2({}, commonSchemaFields), {}, {
     type: z.literal("record"),
-    render: FieldRender,
-    preview: z.literal(true).optional(),
     item: SerializedSchema,
     opt: z["boolean"](),
     // Optional gallery marker for files/images
@@ -1170,16 +1056,12 @@ var SerializedRecordSchema = z.lazy(function () {
     remote: z["boolean"]().optional(),
     encode: ImageEncodeOption.optional(),
     alt: SerializedSchema.optional(),
-    moduleMetadata: z.record(z.string(), z.record(z.string(), z.any())).optional(),
-    readonly: z["boolean"]().optional(),
-    hidden: z["boolean"]().optional()
-  }).passthrough();
+    moduleMetadata: z.record(z.string(), z.record(z.string(), z.any())).optional()
+  })).passthrough();
 });
 var SerializedKeyOfSchema = z.lazy(function () {
-  return z.object({
+  return z.object(_objectSpread2(_objectSpread2({}, commonSchemaFields), {}, {
     type: z.literal("keyOf"),
-    render: FieldRender,
-    preview: z.literal(true).optional(),
     path: SourcePath,
     schema: z.union([z.object({
       type: z.literal("object"),
@@ -1190,82 +1072,54 @@ var SerializedKeyOfSchema = z.lazy(function () {
       opt: z["boolean"]().optional()
     })]).optional(),
     values: z.union([z.literal("string"), z.array(z.string())]),
-    opt: z["boolean"](),
-    readonly: z["boolean"]().optional(),
-    hidden: z["boolean"]().optional()
-  });
+    opt: z["boolean"]()
+  }));
 });
 var FileOptions = z.object({
   accept: z.string().optional()
 });
-var SerializedFileSchema = z.object({
+var SerializedFileSchema = z.object(_objectSpread2(_objectSpread2({}, commonSchemaFields), {}, {
   type: z.literal("file"),
-  render: FieldRender,
-  preview: z.literal(true).optional(),
   options: FileOptions.optional(),
   opt: z["boolean"](),
-  readonly: z["boolean"]().optional(),
-  hidden: z["boolean"]().optional()
-});
+  // See `SerializedImageSchema` above: `.remote()` and the gallery a
+  // gallery-backed field reads from.
+  remote: z["boolean"]().optional(),
+  referencedModule: z.string().optional()
+}));
 var DateOptions = z.object({
   from: z.string().optional(),
   to: z.string().optional()
 });
-var SerializedDateSchema = z.object({
+var SerializedDateSchema = z.object(_objectSpread2(_objectSpread2({}, commonSchemaFields), {}, {
   type: z.literal("date"),
-  render: FieldRender,
-  preview: z.literal(true).optional(),
   options: DateOptions.optional(),
-  opt: z["boolean"](),
-  customValidate: z["boolean"]().optional(),
-  readonly: z["boolean"]().optional(),
-  hidden: z["boolean"]().optional(),
-  description: z.string().optional()
-});
-var SerializedDateTimeSchema = z.object({
+  opt: z["boolean"]()
+}));
+var SerializedDateTimeSchema = z.object(_objectSpread2(_objectSpread2({}, commonSchemaFields), {}, {
   type: z.literal("dateTime"),
-  render: FieldRender,
-  preview: z.literal(true).optional(),
   options: DateOptions.optional(),
-  opt: z["boolean"](),
-  customValidate: z["boolean"]().optional(),
-  readonly: z["boolean"]().optional(),
-  hidden: z["boolean"]().optional(),
-  description: z.string().optional()
-});
+  opt: z["boolean"]()
+}));
 var ColorOptions = z.object({
   format: z["enum"](["hex", "rgb", "hsl", "oklch"]).optional(),
   alpha: z["boolean"]().optional()
 });
-var SerializedColorSchema = z.object({
+var SerializedColorSchema = z.object(_objectSpread2(_objectSpread2({}, commonSchemaFields), {}, {
   type: z.literal("color"),
-  render: FieldRender,
-  preview: z.literal(true).optional(),
   options: ColorOptions.optional(),
-  opt: z["boolean"](),
-  customValidate: z["boolean"]().optional(),
-  readonly: z["boolean"]().optional(),
-  hidden: z["boolean"]().optional(),
-  description: z.string().optional()
-});
+  opt: z["boolean"]()
+}));
 var CodeOptions = z.object({
   language: z["enum"](CODE_LANGUAGES).optional()
 });
-var SerializedCodeSchema = z.object({
+var SerializedCodeSchema = z.object(_objectSpread2(_objectSpread2({}, commonSchemaFields), {}, {
   type: z.literal("code"),
-  render: FieldRender,
-  preview: z.literal(true).optional(),
   options: CodeOptions.optional(),
-  opt: z["boolean"](),
-  customValidate: z["boolean"]().optional(),
-  readonly: z["boolean"]().optional(),
-  hidden: z["boolean"]().optional(),
-  description: z.string().optional()
-});
-var SerializedRouteSchema = z.object({
+  opt: z["boolean"]()
+}));
+var SerializedRouteSchema = z.object(_objectSpread2(_objectSpread2({}, commonSchemaFields), {}, {
   type: z.literal("route"),
-  render: FieldRender,
-  preview: z.literal(true).optional(),
   options: z.object({
     include: z.object({
       source: z.string(),
@@ -1277,11 +1131,8 @@ var SerializedRouteSchema = z.object({
     }).optional(),
     customValidate: z["boolean"]().optional()
   }).optional(),
-  opt: z["boolean"](),
-  customValidate: z["boolean"]().optional(),
-  readonly: z["boolean"]().optional(),
-  hidden: z["boolean"]().optional()
-});
+  opt: z["boolean"]()
+}));
 
 // A settings module, and each section inside one, serialize as this - the
 // shape is recursive because `items` holds sections which are themselves
@@ -1289,17 +1140,11 @@ var SerializedRouteSchema = z.object({
 // (see core/src/schema/settings.ts), but they are accepted here because they
 // are part of the declared type.
 var SerializedSettingsSchema = z.lazy(function () {
-  return z.object({
+  return z.object(_objectSpread2(_objectSpread2({}, commonSchemaFields), {}, {
     type: z.literal("settings"),
-    render: FieldRender,
-    preview: z.literal(true).optional(),
     items: z.record(z.string(), SerializedSchema),
-    opt: z["boolean"](),
-    customValidate: z["boolean"]().optional(),
-    readonly: z["boolean"]().optional(),
-    hidden: z["boolean"]().optional(),
-    description: z.string().optional()
-  });
+    opt: z["boolean"]()
+  }));
 });
 var SerializedSchema = z.union([SerializedStringSchema, SerializedLiteralSchema, SerializedBooleanSchema, SerializedNumberSchema, SerializedObjectSchema, SerializedArraySchema, SerializedUnionSchema, SerializedRichTextSchema, SerializedRecordSchema, SerializedKeyOfSchema, SerializedRouteSchema, SerializedFileSchema, SerializedDateSchema, SerializedDateTimeSchema, SerializedColorSchema, SerializedCodeSchema, SerializedSettingsSchema, SerializedImageSchema]);
 
@@ -2963,16 +2808,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;
@@ -3652,10 +3487,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(),
@@ -3683,170 +3514,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
  */
@@ -4328,84 +3995,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.
  *
@@ -5686,6 +5275,28 @@ function getRefParts(ref) {
  * them — an agent and an editor searching the same project should find the same
  * things.
  */
+/**
+ * The parts of FlexSearch's `Index` this module uses.
+ *
+ * Structural, rather than importing flexsearch's own `Index`, because
+ * {@link SearchIndex} is EXPORTED — and a `.d.ts` that names `flexsearch` pulls
+ * that package's `declare module "flexsearch"` into every consumer's TypeScript
+ * program. Ambient module declarations are global to a program, so a consumer
+ * with its own flexsearch at another version then checks its OWN calls against
+ * the copy we dragged in, whichever of the two wins.
+ *
+ * That is not hypothetical: `@valbuild/shared` gained a flexsearch dependency
+ * in 0.123.0 for `search_content`, and valbuild/web — which pins flexsearch
+ * 0.7 and calls `new flexsearch.Document({ language: "en", … })` — stopped
+ * building on 0.123.2, because 0.8's `DocumentOptions` has no `language`. Its
+ * own resolved copy was still 0.7; only the types had been replaced.
+ *
+ * Three methods is all this module calls, and none of their signatures here is
+ * a guess: `add` and `remove` are used in `indexModule`/`removeModule`, and
+ * `search`'s result is only ever `.length`-ed, `.slice`-d and mapped over as
+ * ids. `FlexSearch.Index` is still constructed with the real library in
+ * {@link createSearchIndex} — a value import, which does not reach the `.d.ts`.
+ */
 
 /** An index with nothing in it. Fill it with {@link indexModule}. */
 function createSearchIndex() {
@@ -5787,9 +5398,9 @@ function removeModule(searchIndex, moduleFilePath) {
     _step;
   try {
     for (_iterator.s(); !(_step = _iterator.n()).done;) {
-      var id = _step.value;
-      index.remove(id);
-      pathToLabel["delete"](id);
+      var _id = _step.value;
+      index.remove(_id);
+      pathToLabel["delete"](_id);
     }
   } catch (err) {
     _iterator.e(err);
@@ -5871,4 +5482,4 @@ function performSearch(searchIndex, query) {
   };
 }
 
-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_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, buildSearchIndex, checkCompatibility, chooseEncoded, concatModulePath, createRegExpFromPattern, createSearchIndex, createValClient, describeContainerAtPath, emptyOf, explainIncompatible, filterBlockingValidationErrors, filterRoutesByPatterns, findSimilar, fitWithin, flattenRichText, getErrorMessageFromUnknownJson, getFilenameFromRef, getInlineImgInfo, getNextAppRouterSitemapTree, getNextAppRouterSourceFolder, getPatternFromModuleFilePath, getRefParts, getRoutesOf, getRoutesWithModulePaths, getSourceAt, indexModule, isMimeTypeAccepted, isRemoteSchema, isSkippedSource, isValCanvasFrame, isValCanvasPageMessage, isValCanvasStudioMessage, levenshtein, newestCommitSha, parseRoutePattern, partitionValidationErrors, performSearch, remirrorToRichTextSource, removeModule, resolveEncodeSettings, resolveSchemaSourceFixForError, resolveSchemaSourceFixes, resolveSerializedSchemaAtPath, richTextToRemirror, safeParsePatch, sourcePathOfChild, toolNames, traverseSchemaSource, urlOf, validateRoutePatterns, withExtension, withValCanvasParam };
+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 };