@valbuild/shared 0.146.4 → 0.148.0

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

@@ -1,6 +1,6 @@
-import { _ as _createForOfIteratorHelper, o as _objectSpread2, q as _arrayLikeToArray, r as _unsupportedIterableToArray, s as _typeof, t as _defineProperty, u as _toPropertyKey } from '../../dist/getSitemapTree-e65acefe.esm.js';
-export { D as DEFAULT_CANVAS_SELECTION, e as DEFAULT_CANVAS_SELECTION_SOFT, 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 getNextAppRouterSourceFolder, m as getPageRouterSitemapTree, k as getPageRouterSourceFolder, n as getPatternFromModuleFilePath, j as getTanStackRouterSourceFolder, l as isTanStackRoutesFolder, g as isValCanvasFrame, i as isValCanvasPageMessage, f as isValCanvasStudioMessage, p as parseRoutePattern, w as withValCanvasParam } from '../../dist/getSitemapTree-e65acefe.esm.js';
-import { Internal, CODE_LANGUAGES, resolveSettingsModule, missingDeclaredKeys, localeOfValue, discriminatedUnionBranchOf, DEFAULT_COLOR_FORMAT, declaredKeySetOf } from '@valbuild/core';
+import { _ as _createForOfIteratorHelper, q as _objectSpread2, r as _arrayLikeToArray, s as _unsupportedIterableToArray, t as _typeof, u as _defineProperty, v as _toPropertyKey } from '../../dist/getSitemapTree-c70ea145.esm.js';
+export { D as DEFAULT_CANVAS_SELECTION, e as DEFAULT_CANVAS_SELECTION_SOFT, 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 formatRoutePattern, j as getNextAppRouterSourceFolder, n as getPageRouterSitemapTree, l as getPageRouterSourceFolder, o as getPatternFromModuleFilePath, k as getTanStackRouterSourceFolder, m as isTanStackRoutesFolder, g as isValCanvasFrame, i as isValCanvasPageMessage, f as isValCanvasStudioMessage, p as parseRoutePattern, w as withValCanvasParam } from '../../dist/getSitemapTree-c70ea145.esm.js';
+import { Internal, CODE_LANGUAGES, resolveSettingsModule, missingDeclaredKeys, localeOfValue, discriminatedUnionBranchOf, routePatternOf, matchRoutePattern, DEFAULT_COLOR_FORMAT, declaredKeySetOf } from '@valbuild/core';
 import { z } from 'zod';
 import { fromError } from 'zod-validation-error';
 import FlexSearch from 'flexsearch';
@@ -266,7 +266,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 (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);
@@ -1047,6 +1047,10 @@ var PatchBlock = z.object({
   parentRef: ParentRef$1
 });
 
+var SourcePath = z.string().transform(function (path) {
+  return path;
+});
+
 function _objectWithoutPropertiesLoose(r, e) {
   if (null == r) return {};
   var t = {};
@@ -1069,10 +1073,6 @@ function _objectWithoutProperties(e, t) {
   return i;
 }
 
-var SourcePath = z.string().transform(function (path) {
-  return path;
-});
-
 var ModuleFilePath$1 = z.string().transform(function (path) {
   return path;
 });
@@ -1189,6 +1189,8 @@ var SerializedDiscriminatedUnionSchema = z.lazy(function () {
 var SerializedEnumSchema = z.object(_objectSpread2(_objectSpread2({}, commonSchemaFields), {}, {
   type: z.literal("enum"),
   values: z.array(z.string()),
+  locales: z.record(z.string(), z.string()).optional(),
+  nullLocale: z.string().optional(),
   opt: z["boolean"]()
 }));
 var ImageEncodeOption = z.union([z.literal(false), z.object({
@@ -1268,6 +1270,7 @@ var SerializedRecordSchema = z.lazy(function () {
     render: FieldRender,
     type: z.literal("record"),
     item: SerializedSchema,
+    params: z.record(z.string(), SerializedSchema).optional(),
     opt: z["boolean"](),
     // Optional gallery marker for files/images/videos
     mediaType: z.union([z.literal("files"), z.literal("images"), z.literal("videos")]).optional(),
@@ -1611,7 +1614,7 @@ var ValConfig = z.object({
   gitCommit: z.string().optional(),
   gitBranch: z.string().optional()
 });
-var ValidationFixZ = z.union([z.literal("image:add-metadata"), z.literal("image:check-metadata"), z.literal("image:check-remote"), z.literal("image:upload-remote"), z.literal("image:download-remote"), z.literal("images:check-remote"), z.literal("images:upload-remote"), z.literal("file:add-metadata"), z.literal("video:add-metadata"), z.literal("video:upload-remote"), z.literal("video:download-remote"), z.literal("videos:add-metadata"), z.literal("videos:check-remote"), z.literal("videos:upload-remote"), z.literal("file:check-metadata"), z.literal("file:check-remote"), z.literal("file:upload-remote"), z.literal("file:download-remote"), z.literal("files:check-remote"), z.literal("files:upload-remote"), z.literal("keyof:check-keys"), z.literal("image:check-gallery"), z.literal("file:check-gallery"), z.literal("video:check-gallery"), z.literal("router:check-route"), z.literal("locale:check-locale"), z.literal("record:fill-keys"), z.literal("images:check-unique-folder"), z.literal("files:check-unique-folder"), z.literal("images:check-all-files"), z.literal("files:check-all-files"), z.literal("videos:check-unique-folder"), z.literal("videos:check-all-files"), z.literal("jsonValues:extract-entry"), z.literal("view:check-module")]);
+var ValidationFixZ = z.union([z.literal("image:add-metadata"), z.literal("image:check-metadata"), z.literal("image:check-remote"), z.literal("image:upload-remote"), z.literal("image:download-remote"), z.literal("images:check-remote"), z.literal("images:upload-remote"), z.literal("file:add-metadata"), z.literal("video:add-metadata"), z.literal("video:upload-remote"), z.literal("video:download-remote"), z.literal("videos:add-metadata"), z.literal("videos:check-remote"), z.literal("videos:upload-remote"), z.literal("file:check-metadata"), z.literal("file:check-remote"), z.literal("file:upload-remote"), z.literal("file:download-remote"), z.literal("files:check-remote"), z.literal("files:upload-remote"), z.literal("keyof:check-keys"), z.literal("image:check-gallery"), z.literal("file:check-gallery"), z.literal("video:check-gallery"), z.literal("router:check-route"), z.literal("locale:check-locale"), z.literal("router:check-locale-param"), z.literal("record:fill-keys"), z.literal("images:check-unique-folder"), z.literal("files:check-unique-folder"), z.literal("images:check-all-files"), z.literal("files:check-all-files"), z.literal("videos:check-unique-folder"), z.literal("videos:check-all-files"), z.literal("jsonValues:extract-entry"), z.literal("view:check-module"), z.literal("external:upload"), z.literal("remote:rewrite-host")]);
 var ValidationError = z.object({
   message: z.string(),
   value: z.unknown().optional(),
@@ -2013,7 +2016,13 @@ var Api = {
           coreVersion: z.string(),
           remoteFileBuckets: z.array(z.object({
             bucket: 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: z.string().optional()
         })
       }), z.object({
         status: z.literal(400),
@@ -2759,6 +2768,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: z.object({
+          moduleFilePath: ModuleFilePath,
+          /**
+           * The patches the caller is showing, applied over base. Omitted
+           * means every pending patch, as `/sources/~`; empty means base.
+           */
+          patchIds: z.array(PatchId).optional()
+        }),
+        cookies: {
+          val_session: z.string().optional()
+        }
+      },
+      res: z.union([unauthorizedResponse, notFoundResponse, z.object({
+        status: z.literal(500),
+        json: z.object({
+          message: z.string()
+        })
+      }), /** No full check on this server (one running in a browser tab). */
+      z.object({
+        status: z.literal(501),
+        json: z.object({
+          message: z.string()
+        })
+      }), z.object({
+        status: z.literal(200),
+        json: z.object({
+          moduleFilePath: ModuleFilePath,
+          errors: z.record(z.string(), z.array(ValidationError)),
+          /** Set when the module's source could not be read at all. */
+          invalidSource: 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: z.array(z.object({
+            host: z.string(),
+            status: z.union([z.literal("missing"), z.literal("unreachable")]),
+            details: z.string(),
+            sourcePaths: 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: z.object({
+          moduleFilePath: ModuleFilePath,
+          sourcePath: SourcePath,
+          fix: ValidationFixZ,
+          patchIds: z.array(PatchId).optional()
+        }),
+        cookies: {
+          val_session: z.string().optional()
+        }
+      },
+      res: z.union([unauthorizedResponse, notFoundResponse, z.object({
+        status: z.literal(400),
+        json: z.object({
+          message: z.string()
+        })
+      }), z.object({
+        status: z.literal(500),
+        json: z.object({
+          message: z.string()
+        })
+      }), /** No full check on this server (one running in a browser tab). */
+      z.object({
+        status: z.literal(501),
+        json: z.object({
+          message: z.string()
+        })
+      }), z.object({
+        status: z.literal(200),
+        json: z.object({
+          patch: Patch,
+          remainingErrors: z.array(ValidationError.extend({
+            sourcePath: z.string().optional()
+          }))
+        })
+      })])
+    }
+  },
   "/publish-job-prepare": {
     POST: {
       req: {
@@ -3738,8 +3846,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 () {
@@ -3830,7 +3941,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"
@@ -3964,6 +4075,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;
 }
@@ -4843,7 +4977,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) {
@@ -5033,21 +5167,51 @@ function resolveSchemaSourceFixForError(error, snapshot) {
       })
     };
   }
-  if (fixes.includes("record:fill-keys")) {
+  if (fixes.includes("router:check-locale-param")) {
     var _value = error.value;
-    if (_typeof(_value) !== "object" || _value === null) {
+    var _ref7 = _typeof(_value) === "object" && _value !== null ? _value : {},
+      name = _ref7.name,
+      segment = _ref7.segment;
+    if (typeof name !== "string" || typeof segment !== "string") {
+      return {
+        status: "remaining",
+        error: _objectSpread2(_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: _objectSpread2(_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 (_typeof(_value2) !== "object" || _value2 === null) {
       return {
         status: "remaining",
         error: _objectSpread2(_objectSpread2({}, error), {}, {
-          message: "Expected record key validation error to have a 'value' object. Found: ".concat(_typeof(_value), ". ").concat(TYPE_ERROR_MESSAGE),
+          message: "Expected record key validation error to have a 'value' object. Found: ".concat(_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",
@@ -5199,7 +5363,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.
@@ -5228,7 +5393,79 @@ function localeAt(path, snapshot) {
     return null;
   }
   var segments = modulePath ? 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 : localeOfValue(value, available);
+  }
+  if (schema.type === "enum" && schema.locales !== undefined) {
+    var tag = enumLocaleTag(schema, value);
+    return tag === undefined ? null : 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 = routePatternOf(schema.router, moduleFilePath);
+  if (pattern === null) {
+    return null;
+  }
+  var values = 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;
 }
 
 /**
@@ -5243,7 +5480,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;
@@ -5257,14 +5494,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 = 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") {
@@ -5320,18 +5564,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 localeOfValue(value, available);
+    return localeMeantBy(item, value, available);
   }
   return null;
 }
@@ -6166,6 +6410,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 : [];
@@ -6220,6 +6474,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
@@ -6234,6 +6489,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;
@@ -6273,6 +6534,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.
  *
@@ -6381,6 +6669,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.
  *
@@ -8570,4 +8915,4 @@ function schemaErrorsOf(schema, moduleFilePath, source) {
   return errors;
 }
 
-export { AA_LARGE, AA_TEXT, Api, BRAND_CONTRAST_PAIRS, 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, PatchId, PatchJSON, PatchSets, PlanRefusalError, PublishProtocolError, RAMP_STEPS, RemirrorBr, RemirrorBulletList, RemirrorHeading, RemirrorImage, RemirrorJSON, RemirrorLinkMark, RemirrorListItem, RemirrorOrderedList, RemirrorParagraph, RemirrorText, RemirrorTextMark, RestoreVerdict, RichTextOptions, SCHEMA_SOURCE_FIXES, SerializedArraySchema, SerializedBooleanSchema, SerializedCodeSchema, SerializedColorSchema, SerializedDateSchema, SerializedDateTimeSchema, SerializedDiscriminatedUnionSchema, SerializedEnumSchema, SerializedFileSchema, SerializedImageSchema, SerializedKeyOfSchema, SerializedLiteralSchema, SerializedLocaleSchema, SerializedNumberSchema, SerializedObjectSchema, SerializedRecordSchema, SerializedRichTextSchema, SerializedRouteSchema, SerializedSchema, SerializedSettingsSchema, SerializedStringSchema, SerializedValViewSchema, SerializedVideoSchema, SharedValConfig, VAL_ENABLE_COOKIE_NAME, VAL_GREEN_RAMP, VAL_SESSION_COOKIE, VAL_STATE_COOKIE, VAL_STUDIO_HEADER, ValCommit, ValDeployment, VideoOptions, VideoStreamOption, accentRamp, buildDuplicatePatch, buildEmptyAtPathPatch, buildFileRefValue, buildImageGalleryPatch, buildRemoveImageGalleryEntryPatch, buildSearchIndex, chainHeadOf, checkCompatibility, chooseEncoded, concatModulePath, contrastRatio, createRegExpFromPattern, createSearchIndex, createValClient, declaredLocales, describeContainerAtPath, emptyOf, explainIncompatible, filterBlockingValidationErrors, filterRoutesByPatterns, findSimilar, fitWithin, flattenRichText, forEachRichTextImage, getErrorMessageFromUnknownJson, getFilenameFromRef, getInlineImgInfo, getKeyOfRecordAt, getRefParts, getRoutesOf, getRoutesWithModulePaths, getSourceAt, indexModule, isInsidePatchSetPath, isMimeTypeAccepted, isRemoteSchema, isSchemaSourceFixError, isSkippedSource, joinSharedChanges, keyOfRecordPath, levenshtein, localeAt, memoizePerRequest, newestCommitSha, parseArtifacts, parseBuildTarget, parseCancel, parseDeclare, parseDiscard, parseJob, parseNewestCiRun, parsePress, parseProblems, parseProjectSource, parsePromote, parsePublishToken, parseRenew, parseRequestStatus, parseStatus, parseUpdateTarget, parseVerify, partitionValidationErrors, performSearch, relativeLuminance, remirrorToRichTextSource, removeModule, resolveEncodeSettings, resolvePairGround, resolveSchemaSourceFixForError, resolveSchemaSourceFixes, resolveSerializedSchemaAtPath, richTextImageSchema, richTextToRemirror, safeParsePatch, schemaErrorsOf, schemaTypesOfPath, selectionClosure, sideFiles, sideSource, sourcePathOfChild, themeCustomProperties, toolNames, traverseSchemaSource, urlOf, validateRoutePatterns, withExtension };
+export { AA_LARGE, AA_TEXT, Api, BRAND_CONTRAST_PAIRS, 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, PatchId, PatchJSON, PatchSets, PlanRefusalError, PublishProtocolError, RAMP_STEPS, RemirrorBr, RemirrorBulletList, RemirrorHeading, RemirrorImage, RemirrorJSON, RemirrorLinkMark, RemirrorListItem, RemirrorOrderedList, RemirrorParagraph, RemirrorText, RemirrorTextMark, RestoreVerdict, RichTextOptions, SCHEMA_SOURCE_FIXES, STUDIO_FIXES, SerializedArraySchema, SerializedBooleanSchema, SerializedCodeSchema, SerializedColorSchema, SerializedDateSchema, SerializedDateTimeSchema, SerializedDiscriminatedUnionSchema, SerializedEnumSchema, SerializedFileSchema, SerializedImageSchema, SerializedKeyOfSchema, SerializedLiteralSchema, SerializedLocaleSchema, SerializedNumberSchema, SerializedObjectSchema, SerializedRecordSchema, SerializedRichTextSchema, SerializedRouteSchema, SerializedSchema, SerializedSettingsSchema, SerializedStringSchema, SerializedValViewSchema, SerializedVideoSchema, SharedValConfig, VAL_ENABLE_COOKIE_NAME, VAL_GREEN_RAMP, VAL_SESSION_COOKIE, VAL_STATE_COOKIE, VAL_STUDIO_HEADER, ValCommit, ValDeployment, VideoOptions, VideoStreamOption, WASM_ENCODED_MIME_TYPES, accentRamp, buildDuplicatePatch, buildEmptyAtPathPatch, buildFileRefValue, buildImageGalleryPatch, buildRemoveImageGalleryEntryPatch, buildSearchIndex, chainHeadOf, checkCompatibility, chooseEncoded, concatModulePath, contrastRatio, createRegExpFromPattern, createSearchIndex, createValClient, declaredLocales, describeContainerAtPath, emptyOf, enumLocaleTag, explainIncompatible, fallbackMimeType, filterBlockingValidationErrors, filterRoutesByPatterns, findSimilar, fitWithin, flattenRichText, forEachRichTextImage, getErrorMessageFromUnknownJson, getFilenameFromRef, getInlineImgInfo, getKeyOfRecordAt, getRefParts, getRoutesOf, getRoutesWithModulePaths, getSourceAt, getValDemo, indexModule, isInsidePatchSetPath, isLocaleSchema, isMimeTypeAccepted, isRemoteSchema, isRepairedOnSave, isSchemaSourceFixError, isSkippedSource, isStudioFix, joinSharedChanges, keyOfRecordPath, levenshtein, localeAt, localeMeantBy, memoizePerRequest, newestCommitSha, parseArtifacts, parseBuildTarget, parseCancel, parseDeclare, parseDiscard, parseJob, parseNewestCiRun, parsePress, parseProblems, parseProjectSource, parsePromote, parsePublishToken, parseRenew, parseRequestStatus, parseStatus, parseUpdateTarget, parseVerify, partitionValidationErrors, performSearch, relativeLuminance, remirrorToRichTextSource, removeModule, resolveEncodeSettings, resolvePairGround, resolveSchemaSourceFixForError, resolveSchemaSourceFixes, resolveSerializedSchemaAtPath, richTextImageSchema, richTextToRemirror, safeParsePatch, schemaErrorsOf, schemaTypesOfPath, selectionClosure, shouldEncodeWithWasm, sideFiles, sideSource, sourcePathOfChild, themeCustomProperties, toolNames, traverseSchemaSource, urlOf, validateRoutePatterns, withExtension };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@valbuild/shared",
-  "version": "0.146.4",
+  "version": "0.148.0",
   "private": false,
   "description": "Val shared types and utilities",
   "repository": {
@@ -37,7 +37,7 @@
     "flexsearch": "^0.8.212",
     "zod": "^4.4.3",
     "zod-validation-error": "^5.0.0",
-    "@valbuild/core": "0.146.2"
+    "@valbuild/core": "0.148.0"
   },
   "files": [
     "CHANGELOG.md",