@valbuild/shared 0.146.4 → 0.148.0

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

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var getSitemapTree = require('../../dist/getSitemapTree-95b00d3f.cjs.dev.js');
+var getSitemapTree = require('../../dist/getSitemapTree-f6254b32.cjs.dev.js');
 var core = require('@valbuild/core');
 var zod = require('zod');
 var zodValidationError = require('zod-validation-error');
@@ -273,7 +273,7 @@ function convertImageNode(path, node, files, configDirectory, remoteOptions) {
       } else {
         console.error("Patched image URL does not start with /api/val/files: " + url);
       }
-    } else if (remoteOptions && noParamsUrl.startsWith(remoteOptions.remoteHost)) ; else if (!noParamsUrl.startsWith("/public")) {
+    } else if (core.Internal.remote.splitRemoteRef(noParamsUrl).status === "success") ; else if (!noParamsUrl.startsWith("/public")) {
       noParamsUrl = "/public".concat(noParamsUrl);
     } else {
       console.error("Unpatched image URL starts with /public: " + url);
@@ -1054,6 +1054,10 @@ var PatchBlock = zod.z.object({
   parentRef: ParentRef$1
 });
 
+var SourcePath = zod.z.string().transform(function (path) {
+  return path;
+});
+
 function _objectWithoutPropertiesLoose(r, e) {
   if (null == r) return {};
   var t = {};
@@ -1076,10 +1080,6 @@ function _objectWithoutProperties(e, t) {
   return i;
 }
 
-var SourcePath = zod.z.string().transform(function (path) {
-  return path;
-});
-
 var ModuleFilePath$1 = zod.z.string().transform(function (path) {
   return path;
 });
@@ -1196,6 +1196,8 @@ var SerializedDiscriminatedUnionSchema = zod.z.lazy(function () {
 var SerializedEnumSchema = zod.z.object(getSitemapTree._objectSpread2(getSitemapTree._objectSpread2({}, commonSchemaFields), {}, {
   type: zod.z.literal("enum"),
   values: zod.z.array(zod.z.string()),
+  locales: zod.z.record(zod.z.string(), zod.z.string()).optional(),
+  nullLocale: zod.z.string().optional(),
   opt: zod.z["boolean"]()
 }));
 var ImageEncodeOption = zod.z.union([zod.z.literal(false), zod.z.object({
@@ -1275,6 +1277,7 @@ var SerializedRecordSchema = zod.z.lazy(function () {
     render: FieldRender,
     type: zod.z.literal("record"),
     item: SerializedSchema,
+    params: zod.z.record(zod.z.string(), SerializedSchema).optional(),
     opt: zod.z["boolean"](),
     // Optional gallery marker for files/images/videos
     mediaType: zod.z.union([zod.z.literal("files"), zod.z.literal("images"), zod.z.literal("videos")]).optional(),
@@ -1618,7 +1621,7 @@ var ValConfig = zod.z.object({
   gitCommit: zod.z.string().optional(),
   gitBranch: zod.z.string().optional()
 });
-var ValidationFixZ = zod.z.union([zod.z.literal("image:add-metadata"), zod.z.literal("image:check-metadata"), zod.z.literal("image:check-remote"), zod.z.literal("image:upload-remote"), zod.z.literal("image:download-remote"), zod.z.literal("images:check-remote"), zod.z.literal("images:upload-remote"), zod.z.literal("file:add-metadata"), zod.z.literal("video:add-metadata"), zod.z.literal("video:upload-remote"), zod.z.literal("video:download-remote"), zod.z.literal("videos:add-metadata"), zod.z.literal("videos:check-remote"), zod.z.literal("videos:upload-remote"), zod.z.literal("file:check-metadata"), zod.z.literal("file:check-remote"), zod.z.literal("file:upload-remote"), zod.z.literal("file:download-remote"), zod.z.literal("files:check-remote"), zod.z.literal("files:upload-remote"), zod.z.literal("keyof:check-keys"), zod.z.literal("image:check-gallery"), zod.z.literal("file:check-gallery"), zod.z.literal("video:check-gallery"), zod.z.literal("router:check-route"), zod.z.literal("locale:check-locale"), zod.z.literal("record:fill-keys"), zod.z.literal("images:check-unique-folder"), zod.z.literal("files:check-unique-folder"), zod.z.literal("images:check-all-files"), zod.z.literal("files:check-all-files"), zod.z.literal("videos:check-unique-folder"), zod.z.literal("videos:check-all-files"), zod.z.literal("jsonValues:extract-entry"), zod.z.literal("view:check-module")]);
+var ValidationFixZ = zod.z.union([zod.z.literal("image:add-metadata"), zod.z.literal("image:check-metadata"), zod.z.literal("image:check-remote"), zod.z.literal("image:upload-remote"), zod.z.literal("image:download-remote"), zod.z.literal("images:check-remote"), zod.z.literal("images:upload-remote"), zod.z.literal("file:add-metadata"), zod.z.literal("video:add-metadata"), zod.z.literal("video:upload-remote"), zod.z.literal("video:download-remote"), zod.z.literal("videos:add-metadata"), zod.z.literal("videos:check-remote"), zod.z.literal("videos:upload-remote"), zod.z.literal("file:check-metadata"), zod.z.literal("file:check-remote"), zod.z.literal("file:upload-remote"), zod.z.literal("file:download-remote"), zod.z.literal("files:check-remote"), zod.z.literal("files:upload-remote"), zod.z.literal("keyof:check-keys"), zod.z.literal("image:check-gallery"), zod.z.literal("file:check-gallery"), zod.z.literal("video:check-gallery"), zod.z.literal("router:check-route"), zod.z.literal("locale:check-locale"), zod.z.literal("router:check-locale-param"), zod.z.literal("record:fill-keys"), zod.z.literal("images:check-unique-folder"), zod.z.literal("files:check-unique-folder"), zod.z.literal("images:check-all-files"), zod.z.literal("files:check-all-files"), zod.z.literal("videos:check-unique-folder"), zod.z.literal("videos:check-all-files"), zod.z.literal("jsonValues:extract-entry"), zod.z.literal("view:check-module"), zod.z.literal("external:upload"), zod.z.literal("remote:rewrite-host")]);
 var ValidationError = zod.z.object({
   message: zod.z.string(),
   value: zod.z.unknown().optional(),
@@ -2020,7 +2023,13 @@ var Api = {
           coreVersion: zod.z.string(),
           remoteFileBuckets: zod.z.array(zod.z.object({
             bucket: zod.z.string()
-          }))
+          })),
+          /**
+           * The host new refs name, from the project's settings: its own
+           * address for a Hosted project whose files are in R2. Optional,
+           * for a content service that predates it.
+           */
+          remoteHost: zod.z.string().optional()
         })
       }), zod.z.object({
         status: zod.z.literal(400),
@@ -2766,6 +2775,105 @@ var Api = {
       })])
     }
   },
+  /**
+   * The Studio's full check, one module per request: its sources against its
+   * schema and its local files against their bytes, on the content the caller
+   * is looking at. See `docs/plans/studio-validate.md`.
+   */
+  "/validate": {
+    POST: {
+      req: {
+        body: zod.z.object({
+          moduleFilePath: ModuleFilePath,
+          /**
+           * The patches the caller is showing, applied over base. Omitted
+           * means every pending patch, as `/sources/~`; empty means base.
+           */
+          patchIds: zod.z.array(PatchId).optional()
+        }),
+        cookies: {
+          val_session: zod.z.string().optional()
+        }
+      },
+      res: zod.z.union([unauthorizedResponse, notFoundResponse, zod.z.object({
+        status: zod.z.literal(500),
+        json: zod.z.object({
+          message: zod.z.string()
+        })
+      }), /** No full check on this server (one running in a browser tab). */
+      zod.z.object({
+        status: zod.z.literal(501),
+        json: zod.z.object({
+          message: zod.z.string()
+        })
+      }), zod.z.object({
+        status: zod.z.literal(200),
+        json: zod.z.object({
+          moduleFilePath: ModuleFilePath,
+          errors: zod.z.record(zod.z.string(), zod.z.array(ValidationError)),
+          /** Set when the module's source could not be read at all. */
+          invalidSource: zod.z.string().optional(),
+          /**
+           * Hosts that did not serve this module's remote files: one entry
+           * per host, however many files it holds. Optional so a server
+           * from before remote checks still parses.
+           */
+          remoteHosts: zod.z.array(zod.z.object({
+            host: zod.z.string(),
+            status: zod.z.union([zod.z.literal("missing"), zod.z.literal("unreachable")]),
+            details: zod.z.string(),
+            sourcePaths: zod.z.array(SourcePath)
+          })).optional()
+        })
+      })])
+    }
+  },
+  /**
+   * The patch that fixes one error the full check reported. The server finds
+   * the error again rather than trusting the caller's copy, and builds only the
+   * fixes `STUDIO_FIXES` lists. The patch is returned, not applied: the Studio
+   * adds it as a pending change like any edit.
+   */
+  "/validate/fix": {
+    POST: {
+      req: {
+        body: zod.z.object({
+          moduleFilePath: ModuleFilePath,
+          sourcePath: SourcePath,
+          fix: ValidationFixZ,
+          patchIds: zod.z.array(PatchId).optional()
+        }),
+        cookies: {
+          val_session: zod.z.string().optional()
+        }
+      },
+      res: zod.z.union([unauthorizedResponse, notFoundResponse, zod.z.object({
+        status: zod.z.literal(400),
+        json: zod.z.object({
+          message: zod.z.string()
+        })
+      }), zod.z.object({
+        status: zod.z.literal(500),
+        json: zod.z.object({
+          message: zod.z.string()
+        })
+      }), /** No full check on this server (one running in a browser tab). */
+      zod.z.object({
+        status: zod.z.literal(501),
+        json: zod.z.object({
+          message: zod.z.string()
+        })
+      }), zod.z.object({
+        status: zod.z.literal(200),
+        json: zod.z.object({
+          patch: Patch,
+          remainingErrors: zod.z.array(ValidationError.extend({
+            sourcePath: zod.z.string().optional()
+          }))
+        })
+      })])
+    }
+  },
   "/publish-job-prepare": {
     POST: {
       req: {
@@ -3745,8 +3853,11 @@ function detailsOf(json) {
 }
 var DEFAULT_ERROR_MESSAGE = "Unknown error with unknown message from server";
 
-var createValClient = function createValClient(host, config // We want to use this in the future
-) {
+var createValClient = function createValClient(host, config, options) {
+  var _options$fetch;
+  var send = (_options$fetch = options === null || options === void 0 ? void 0 : options.fetch) !== null && _options$fetch !== void 0 ? _options$fetch : function (input, init) {
+    return fetch(input, init);
+  };
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
   var anyApi = Api;
   return /*#__PURE__*/function () {
@@ -3837,7 +3948,7 @@ var createValClient = function createValClient(host, config // We want to use th
           case 2:
             _context2.p = 2;
             _context2.n = 3;
-            return fetch("".concat(host).concat(fullPath), {
+            return send("".concat(host).concat(fullPath), {
               method: method,
               headers: {
                 "Content-Type": "application/json"
@@ -3971,6 +4082,29 @@ function isRetryable(error) {
   return false;
 }
 
+/**
+ * A Val demo, as the page hands it to the Studio.
+ *
+ * In a demo the Studio talks to Val's own server running in the same tab
+ * (`@valbuild/server/browser`) instead of to an API route, and the page that
+ * starts that server is the app's (`<ValApp demo>`) while the Studio is a
+ * separate bundle loaded by a script tag. A window property is how the two
+ * meet, the same way `window.__VAL_MODULES__` hands the Studio the project's
+ * modules. See `docs/plans/demo-mode.md`.
+ */
+
+/*
+ * A global `var` rather than a `Window` member: this package is compiled
+ * without the DOM's types, and a `var` in global scope is also a property of
+ * `window` where they exist.
+ */
+
+/** The demo this page was started with, or null outside a demo. */
+function getValDemo() {
+  var _globalThis$__VAL_DEM;
+  return (_globalThis$__VAL_DEM = globalThis.__VAL_DEMO__) !== null && _globalThis$__VAL_DEM !== void 0 ? _globalThis$__VAL_DEM : null;
+}
+
 function _arrayWithHoles(r) {
   if (Array.isArray(r)) return r;
 }
@@ -4850,7 +4984,7 @@ function declaredLocales(snapshot) {
  * these has to resolve all of them, and the two that leaked did so by adding a
  * fix here and not to a condition somewhere else.
  */
-var SCHEMA_SOURCE_FIXES = ["keyof:check-keys", "image:check-gallery", "file:check-gallery", "video:check-gallery", "router:check-route", "locale:check-locale", "record:fill-keys"];
+var SCHEMA_SOURCE_FIXES = ["keyof:check-keys", "image:check-gallery", "file:check-gallery", "video:check-gallery", "router:check-route", "locale:check-locale", "router:check-locale-param", "record:fill-keys"];
 
 /** Whether an error is a marker only the whole project can answer. */
 function isSchemaSourceFixError(error) {
@@ -5040,21 +5174,51 @@ function resolveSchemaSourceFixForError(error, snapshot) {
       })
     };
   }
-  if (fixes.includes("record:fill-keys")) {
+  if (fixes.includes("router:check-locale-param")) {
     var _value = error.value;
-    if (getSitemapTree._typeof(_value) !== "object" || _value === null) {
+    var _ref7 = getSitemapTree._typeof(_value) === "object" && _value !== null ? _value : {},
+      name = _ref7.name,
+      segment = _ref7.segment;
+    if (typeof name !== "string" || typeof segment !== "string") {
+      return {
+        status: "remaining",
+        error: getSitemapTree._objectSpread2(getSitemapTree._objectSpread2({}, error), {}, {
+          message: "Expected route locale parameter validation error to have a 'value' with 'name' and 'segment'. ".concat(TYPE_ERROR_MESSAGE),
+          typeError: true,
+          fixes: undefined
+        })
+      };
+    }
+    // A project that declares no languages is not translated, and a
+    // `[locale]` segment there is the app's own business.
+    if (declaredLocales(snapshot).length === 0) {
+      return {
+        status: "resolved"
+      };
+    }
+    return {
+      status: "remaining",
+      error: getSitemapTree._objectSpread2(getSitemapTree._objectSpread2({}, error), {}, {
+        message: "This route has a '".concat(name, "' segment (").concat(segment, "), but nothing says which of the project's languages it can be, so its pages are not in any language and '/xx/\u2026' validates. Give the parameter a locale schema: s.router(router, { ").concat(name, ": urlLocale, \u2026 }, item), where urlLocale is an s.enum(\u2026).locales({ \u2026 }) or s.locale(). If '").concat(name, "' is not a language here, give it a schema of its own instead, e.g. { ").concat(name, ": s.enum(\u2026) }."),
+        fixes: undefined
+      })
+    };
+  }
+  if (fixes.includes("record:fill-keys")) {
+    var _value2 = error.value;
+    if (getSitemapTree._typeof(_value2) !== "object" || _value2 === null) {
       return {
         status: "remaining",
         error: getSitemapTree._objectSpread2(getSitemapTree._objectSpread2({}, error), {}, {
-          message: "Expected record key validation error to have a 'value' object. Found: ".concat(getSitemapTree._typeof(_value), ". ").concat(TYPE_ERROR_MESSAGE),
+          message: "Expected record key validation error to have a 'value' object. Found: ".concat(getSitemapTree._typeof(_value2), ". ").concat(TYPE_ERROR_MESSAGE),
           typeError: true,
           fixes: undefined
         })
       };
     }
-    var _ref7 = _value,
-      present = _ref7.present,
-      declared = _ref7.declared;
+    var _ref8 = _value2,
+      present = _ref8.present,
+      declared = _ref8.declared;
     if (!Array.isArray(present)) {
       return {
         status: "remaining",
@@ -5206,7 +5370,8 @@ function resolveSchemaSourceFixes(validationErrors, snapshot) {
  *
  * THE question the whole feature turns on. A locale scope is a subtree in one
  * language, and three things open one: a `locale` field on an object, a record
- * keyed by `s.locale()`, and a locale segment in a segmented key. Once this can
+ * keyed by `s.locale()`, and a locale parameter in a router's key
+ * (`s.router(router, { locale: … }, item)`, where the URL names the language). Once this can
  * be answered from the schema and the source alone, everything downstream falls
  * out of it — the Studio's locale filter, deep links, `<html lang>`, and knowing
  * what to translate from and into.
@@ -5235,7 +5400,79 @@ function localeAt(path, snapshot) {
     return null;
   }
   var segments = modulePath ? core.Internal.splitModulePath(modulePath) : [];
-  return walk(schema, source, segments, available);
+  return walk(schema, source, segments, available, moduleFilePath);
+}
+
+/**
+ * The language a locale schema's value MEANS, or `null` if it means none of
+ * the project's.
+ *
+ * `s.locale()` stores the tag itself. An enum with `.locales(...)` stores a
+ * value that stands for one — `nb` for `nb-NO` — and, on a router parameter,
+ * `null` for a URL that left the segment out, which `{ null: tag }` names.
+ * Anything else is not a locale and means nothing here.
+ *
+ * Callers reading a FIELD pass only strings: a field that holds `null` has no
+ * language, whatever its schema says about URLs.
+ */
+function localeMeantBy(schema, value, available) {
+  if (schema.type === "locale") {
+    return value === null ? null : core.localeOfValue(value, available);
+  }
+  if (schema.type === "enum" && schema.locales !== undefined) {
+    var tag = enumLocaleTag(schema, value);
+    return tag === undefined ? null : core.localeOfValue(tag, available);
+  }
+  return null;
+}
+
+/**
+ * The tag an enum's `.locales(...)` maps a value to, as written — `null` is
+ * the `{ null }` mapping — or `undefined` where it maps none.
+ *
+ * An own property: a plain object inherits `toString` and the rest, and an
+ * enum value is allowed to be spelled like one.
+ */
+function enumLocaleTag(schema, value) {
+  if (value === null) {
+    return schema.nullLocale;
+  }
+  return schema.locales !== undefined && Object.prototype.hasOwnProperty.call(schema.locales, value) ? schema.locales[value] : undefined;
+}
+
+/**
+ * Whether a schema is a locale: `s.locale()`, or an enum `.locales(...)` made
+ * one.
+ */
+function isLocaleSchema(schema) {
+  return schema.type === "locale" || schema.type === "enum" && schema.locales !== undefined;
+}
+
+/**
+ * The language a router's key is in, where one of its route parameters is a
+ * locale — `/nb/blog/hei` is `nb-NO` when `locale` maps `nb` to it.
+ */
+function localeOfRouteKey(schema, moduleFilePath, key, available) {
+  if (schema.params === undefined || schema.router === undefined) {
+    return null;
+  }
+  var pattern = core.routePatternOf(schema.router, moduleFilePath);
+  if (pattern === null) {
+    return null;
+  }
+  var values = core.matchRoutePattern(key, pattern);
+  if (values === null) {
+    return null;
+  }
+  for (var _i = 0, _Object$entries = Object.entries(schema.params); _i < _Object$entries.length; _i++) {
+    var _Object$entries$_i = _slicedToArray(_Object$entries[_i], 2),
+      name = _Object$entries$_i[0],
+      param = _Object$entries$_i[1];
+    if (isLocaleSchema(param) && Object.prototype.hasOwnProperty.call(values, name)) {
+      return localeMeantBy(param, values[name], available);
+    }
+  }
+  return null;
 }
 
 /**
@@ -5250,7 +5487,7 @@ function localeAt(path, snapshot) {
  * these can fire on a well-formed path; taking the innermost is what makes the
  * answer well-defined while a project is mid-fix.
  */
-function walk(schema, source, segments, available) {
+function walk(schema, source, segments, available, moduleFilePath) {
   var entered = enter(schema, source, available);
   var locale = entered.locale;
   var currentSchema = entered.schema;
@@ -5264,14 +5501,21 @@ function walk(schema, source, segments, available) {
         return locale;
       }
       if (currentSchema.type === "record") {
-        var _currentSchema$key;
-        if (((_currentSchema$key = currentSchema.key) === null || _currentSchema$key === void 0 ? void 0 : _currentSchema$key.type) === "locale") {
+        if (currentSchema.key !== undefined && isLocaleSchema(currentSchema.key)) {
           // In a locale-keyed record the KEY is the language, so the segment we
-          // are about to take is the answer.
-          var resolved = core.localeOfValue(segment, available);
+          // are about to take is the answer — the tag itself for `s.locale()`,
+          // the tag it stands for when the key is an enum with `.locales()`.
+          var resolved = localeMeantBy(currentSchema.key, segment, available);
           if (resolved !== null) {
             locale = resolved;
           }
+        } else if (currentSchema.params !== undefined) {
+          // A router whose URL names the language: the key is a URL, and one of
+          // its parameters is the answer.
+          var _resolved = localeOfRouteKey(currentSchema, moduleFilePath, segment, available);
+          if (_resolved !== null) {
+            locale = _resolved;
+          }
         }
         currentSchema = currentSchema.item;
       } else if (currentSchema.type === "array") {
@@ -5327,18 +5571,18 @@ function localeOfObjectField(schema, source, available) {
   if (schema.type !== "object" || !isJsonObject(source)) {
     return null;
   }
-  for (var _i = 0, _Object$entries = Object.entries(schema.items); _i < _Object$entries.length; _i++) {
-    var _Object$entries$_i = _slicedToArray(_Object$entries[_i], 2),
-      key = _Object$entries$_i[0],
-      item = _Object$entries$_i[1];
-    if (item.type !== "locale") {
+  for (var _i2 = 0, _Object$entries2 = Object.entries(schema.items); _i2 < _Object$entries2.length; _i2++) {
+    var _Object$entries2$_i = _slicedToArray(_Object$entries2[_i2], 2),
+      key = _Object$entries2$_i[0],
+      item = _Object$entries2$_i[1];
+    if (!isLocaleSchema(item)) {
       continue;
     }
     var value = source[key];
     if (typeof value !== "string") {
       return null;
     }
-    return core.localeOfValue(value, available);
+    return localeMeantBy(item, value, available);
   }
   return null;
 }
@@ -6173,6 +6417,16 @@ function partitionValidationErrors(validationErrors) {
     skipped: skipped
   };
 }
+
+/**
+ * Whether the Studio leaves this error to the server, which repairs it on
+ * save, rather than showing it and holding a publish back for it. One rule
+ * for every gate: `val publish` asks the same question, so the CLI does not
+ * refuse what the Studio would publish.
+ */
+function isRepairedOnSave(error) {
+  return isSkippedFix(error);
+}
 function isSkippedFix(error) {
   var _error$fixes;
   var fixes = (_error$fixes = error.fixes) !== null && _error$fixes !== void 0 ? _error$fixes : [];
@@ -6227,6 +6481,7 @@ function isSkippableFixCode(fix) {
     case "video:check-gallery":
     case "router:check-route":
     case "locale:check-locale":
+    case "router:check-locale-param":
     case "record:fill-keys":
     case "jsonValues:extract-entry":
       // `jsonValues:extract-entry` is an entry inlined in the `.val.ts`. The
@@ -6241,6 +6496,12 @@ function isSkippableFixCode(fix) {
       // under `val external upload` and never under a blanket `--fix`. Surfacing
       // it is the whole point: someone has to decide.
       return false;
+    case "remote:rewrite-host":
+      // Reported only by the server's full check (the Studio's Validate page,
+      // `val validate`), which asks the ref's host -- never by a schema, so
+      // the Studio's own validator never holds one. Were it to, a person has
+      // to see it: the host is gone, and nothing on save repoints the ref.
+      return false;
     default:
       {
         return false;
@@ -6280,6 +6541,33 @@ function filterBlockingValidationErrors(validationErrors, schemas, sources) {
   return partitionValidationErrors(resolved).surfaced;
 }
 
+/**
+ * The fixes the Studio's full check offers a **Fix** button for.
+ *
+ * Each is one `createFixPatch` can build without a disk: it reads a file's
+ * bytes through `FixFiles`, or needs no bytes at all. The server refuses any
+ * other code on `/validate/fix`, and the Studio shows those errors with the
+ * command to run instead of a button — so a code is added here when its fix
+ * can run in http mode and on the platform, not before. See
+ * `docs/plans/studio-validate.md`, "Order of work".
+ */
+var STUDIO_FIXES = ["image:add-metadata", "image:check-metadata", "file:add-metadata", "file:check-metadata", "video:add-metadata", "videos:add-metadata", "view:check-module",
+// A stale remote ref: re-read through `FixFiles.readRemoteFile`, rewritten
+// on the host it was already on.
+"image:check-remote", "file:check-remote",
+// One entry of an `s.imagedir()` / `s.filedir()`: removed when its file is
+// gone, rewritten from its bytes when they disagree. Built for that entry
+// alone, never the whole directory (`fixForStudio`).
+"images:check-all-files", "files:check-all-files",
+// A platform ref on a host that no longer serves its project, pointed at
+// the project's own `valstart.dev` address. Derived from the ref alone.
+"remote:rewrite-host"];
+function isStudioFix(fix) {
+  return STUDIO_FIXES.some(function (studioFix) {
+    return studioFix === fix;
+  });
+}
+
 /**
  * Every decision `encode` makes, with none of the pixels.
  *
@@ -6388,6 +6676,63 @@ function isSkippedSource(sourceMimeType, targetMimeType, needsDownscale) {
   return sourceMimeType === targetMimeType && !needsDownscale;
 }
 
+/**
+ * The types the Studio can write with WebAssembly when the canvas cannot.
+ *
+ * libwebp, compiled to WebAssembly (`@jsquash/webp`, loaded by
+ * `packages/ui/spa/utils/webpWasm.ts`). One entry because `encode` has one
+ * `type`; a second type is a second encoder to host, not a second string here.
+ */
+var WASM_ENCODED_MIME_TYPES = ["image/webp"];
+
+/**
+ * Whether to encode the canvas's pixels with WebAssembly, given what the
+ * canvas's own encoder handed back.
+ *
+ * `canvas.toBlob` answers a type it cannot write with a PNG instead of an error,
+ * and Safari -- the browser people take their photos in -- cannot write WebP.
+ * The pixels on that canvas are already decoded, oriented and scaled, so the
+ * only thing missing is the encoder, and libwebp in WebAssembly is that.
+ *
+ * Only then, and that is what keeps the WebAssembly lazy: a browser whose
+ * canvas wrote the type is never asked to download an encoder, even when its
+ * WebP then loses to the original on size -- a second encoder of the same
+ * format would lose for the same reason.
+ *
+ * `null` -- no blob at all -- is not "cannot write this type" either. It is a
+ * canvas that failed to serialize anything, under memory pressure for instance,
+ * and says nothing about WebP: a Chromium tab that hits it is still a browser
+ * that writes WebP, and must not start downloading an encoder because of it.
+ */
+function shouldEncodeWithWasm(input) {
+  return WASM_ENCODED_MIME_TYPES.includes(input.targetMimeType) && input.canvasOutputType !== null && input.canvasOutputType !== input.targetMimeType;
+}
+
+/**
+ * What to scale an image down to when nothing could write the type asked for:
+ * the source's own format, when it is one every canvas can write.
+ *
+ * The second fallback, after {@link shouldEncodeWithWasm}: it is what a browser
+ * whose canvas cannot write WebP gets when the WebAssembly encoder could not be
+ * loaded either (offline, a blocked host, a failed instantiation). Without it,
+ * `chooseEncoded` would rightly refuse the canvas's PNG and upload the original
+ * -- every photo at the camera's full size, the one case `maxWidth` exists
+ * for. Scaling it down as a JPEG keeps the half of `encode` this browser can do.
+ *
+ * Only when a downscale is needed: re-encoding a JPEG that already fits, as a
+ * JPEG, is a second generation of loss for a few percent. And never into a
+ * type `accept` refuses, for the reason `isMimeTypeAccepted` gives.
+ */
+function fallbackMimeType(sourceMimeType, needsDownscale, accept) {
+  if (!needsDownscale) {
+    return null;
+  }
+  if (sourceMimeType !== "image/jpeg" && sourceMimeType !== "image/png") {
+    return null;
+  }
+  return isMimeTypeAccepted(sourceMimeType, accept) ? sourceMimeType : null;
+}
+
 /**
  * Whether to upload what the encoder produced, or the file that was picked.
  *
@@ -8584,6 +8929,7 @@ exports.VAL_CANVAS_MESSAGE = getSitemapTree.VAL_CANVAS_MESSAGE;
 exports.VAL_CANVAS_PARAM = getSitemapTree.VAL_CANVAS_PARAM;
 exports.VAL_CONFIG_SESSION_STORAGE_KEY = getSitemapTree.VAL_CONFIG_SESSION_STORAGE_KEY;
 exports.VAL_THEME_SESSION_STORAGE_KEY = getSitemapTree.VAL_THEME_SESSION_STORAGE_KEY;
+exports.formatRoutePattern = getSitemapTree.formatRoutePattern;
 exports.getNextAppRouterSourceFolder = getSitemapTree.getNextAppRouterSourceFolder;
 exports.getPageRouterSitemapTree = getSitemapTree.getPageRouterSitemapTree;
 exports.getPageRouterSourceFolder = getSitemapTree.getPageRouterSourceFolder;
@@ -8640,6 +8986,7 @@ exports.RemirrorTextMark = RemirrorTextMark;
 exports.RestoreVerdict = RestoreVerdict;
 exports.RichTextOptions = RichTextOptions;
 exports.SCHEMA_SOURCE_FIXES = SCHEMA_SOURCE_FIXES;
+exports.STUDIO_FIXES = STUDIO_FIXES;
 exports.SerializedArraySchema = SerializedArraySchema;
 exports.SerializedBooleanSchema = SerializedBooleanSchema;
 exports.SerializedCodeSchema = SerializedCodeSchema;
@@ -8673,6 +9020,7 @@ exports.ValCommit = ValCommit;
 exports.ValDeployment = ValDeployment;
 exports.VideoOptions = VideoOptions;
 exports.VideoStreamOption = VideoStreamOption;
+exports.WASM_ENCODED_MIME_TYPES = WASM_ENCODED_MIME_TYPES;
 exports.accentRamp = accentRamp;
 exports.buildDuplicatePatch = buildDuplicatePatch;
 exports.buildEmptyAtPathPatch = buildEmptyAtPathPatch;
@@ -8691,7 +9039,9 @@ exports.createValClient = createValClient;
 exports.declaredLocales = declaredLocales;
 exports.describeContainerAtPath = describeContainerAtPath;
 exports.emptyOf = emptyOf;
+exports.enumLocaleTag = enumLocaleTag;
 exports.explainIncompatible = explainIncompatible;
+exports.fallbackMimeType = fallbackMimeType;
 exports.filterBlockingValidationErrors = filterBlockingValidationErrors;
 exports.filterRoutesByPatterns = filterRoutesByPatterns;
 exports.findSimilar = findSimilar;
@@ -8706,16 +9056,21 @@ exports.getRefParts = getRefParts;
 exports.getRoutesOf = getRoutesOf;
 exports.getRoutesWithModulePaths = getRoutesWithModulePaths;
 exports.getSourceAt = getSourceAt;
+exports.getValDemo = getValDemo;
 exports.indexModule = indexModule;
 exports.isInsidePatchSetPath = isInsidePatchSetPath;
+exports.isLocaleSchema = isLocaleSchema;
 exports.isMimeTypeAccepted = isMimeTypeAccepted;
 exports.isRemoteSchema = isRemoteSchema;
+exports.isRepairedOnSave = isRepairedOnSave;
 exports.isSchemaSourceFixError = isSchemaSourceFixError;
 exports.isSkippedSource = isSkippedSource;
+exports.isStudioFix = isStudioFix;
 exports.joinSharedChanges = joinSharedChanges;
 exports.keyOfRecordPath = keyOfRecordPath;
 exports.levenshtein = levenshtein;
 exports.localeAt = localeAt;
+exports.localeMeantBy = localeMeantBy;
 exports.memoizePerRequest = memoizePerRequest;
 exports.newestCommitSha = newestCommitSha;
 exports.parseArtifacts = parseArtifacts;
@@ -8751,6 +9106,7 @@ exports.safeParsePatch = safeParsePatch;
 exports.schemaErrorsOf = schemaErrorsOf;
 exports.schemaTypesOfPath = schemaTypesOfPath;
 exports.selectionClosure = selectionClosure;
+exports.shouldEncodeWithWasm = shouldEncodeWithWasm;
 exports.sideFiles = sideFiles;
 exports.sideSource = sideSource;
 exports.sourcePathOfChild = sourcePathOfChild;