@valbuild/shared 0.122.0 → 0.123.0

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

@@ -2,6 +2,7 @@ import { Internal, CODE_LANGUAGES, DEFAULT_COLOR_FORMAT } from '@valbuild/core';
 import { b as base64DataUrlToUint8Array } from '../../dist/utils-00f3e1df.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;
@@ -4666,13 +4667,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 +5173,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_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 };