@valbuild/server 0.126.0 → 0.127.0

package/CHANGELOG.md

@@ -1,5 +1,90 @@
 # @valbuild/server
 
+## 0.127.0
+
+### Minor Changes
+
+- [#608](https://github.com/valbuild/val/pull/608) [`7fa8699`](https://github.com/valbuild/val/commit/7fa869974bc895af992a7d5c18b76253636d7d65) Thanks [@freekh](https://github.com/freekh)! - A record whose schema declares its keys now holds every one of them.
+
+  Two key schemas enumerate their keys: `s.locale()`, whose set is the project's
+  `locales.available`, and a union of literals. For those, the keys are part of the
+  schema, so a missing one is a hole in the content rather than content nobody has
+  written yet — and validation now says so, naming what is missing.
+
+  ```typescript
+  s.record(s.locale(), s.object({ title: s.string() }));
+  // Missing key: 'nb-NO'. This record's keys are declared by its schema, so
+  // every one of them is an entry — an entry nobody has written yet is null,
+  // not absent.
+  ```
+
+  **An entry nobody has written yet is `null`.** Not an absent key: a null entry is
+  data you can count, filter and see in a diff, and it means half-translated
+  content stays _valid_ rather than blocking a publish. The value type of such a
+  record widens by `null` to match, so writing one in a `.val.ts` type-checks:
+
+  ```typescript
+  c.define(
+    "/content/jacket.val.ts",
+    s.record(s.locale(), s.object({ title: s.string() })),
+    {
+      "en-US": { title: "Winter jacket" },
+      "nb-NO": null, // nobody has translated this yet
+    },
+  );
+  ```
+
+  **This changes `s.record(s.union(...), item)`**, and closes a gap that was
+  already there: `s.record(s.union(s.literal("a"), s.literal("b")), item)` types as
+  `Record<"a" | "b", T>`, so TypeScript demanded both keys while the validator only
+  checked the ones present. It now checks them too, and — as above — accepts `null`
+  for an entry that has not been filled in. If you have such a record with keys
+  missing, validation will report them; adding the keys with `null` values is the
+  fix, and creating one from the Studio does it for you.
+
+  `emptyOf` creates these records with every key already in them rather than
+  empty, since an empty one is already missing keys. In the Studio use the
+  `useEmptyOf()` hook rather than importing `emptyOf` directly: a locale record's
+  keys are in the settings module, and the hook is what has read it.
+
+- [#608](https://github.com/valbuild/val/pull/608) [`5b7fe05`](https://github.com/valbuild/val/commit/5b7fe05cec6365f9cd1de9ba31e65ed4a87edb63) Thanks [@freekh](https://github.com/freekh)! - `s.locale()`: one of the project's languages.
+
+  The languages themselves are declared in the settings module (`locales.available`);
+  this says that a value is one of them.
+
+  ```typescript
+  // a field: everything in this entry is in this language
+  s.record(s.string(), s.object({ locale: s.locale(), title: s.string() }));
+
+  // a key: one entry per language
+  s.record(s.locale(), s.object({ title: s.string() }));
+  ```
+
+  Every locale in content is checked against the project's list, the way `keyOf`
+  and `route` are checked against what they point at. An undeclared language names
+  the ones the project has; a project that has declared none is told to declare
+  them rather than told the value is wrong.
+
+  A locale is stored as the tag itself — the value in content is `nb-NO`, and a
+  record keyed by `s.locale()` has `nb-NO` as its key. Spelling one differently
+  where it is stored (`/no/…` as a URL segment) is a real need and is deliberately
+  not in this release: it changes what is accepted as well as what is shown, so it
+  is being designed on its own rather than folded in here.
+
+  A locale is **never stega encoded**: it ends up in `<html lang>`, in `hreflang`
+  and in `Intl` constructors, none of which survive invisible characters.
+
+  `assistant.translation` joins the settings module alongside `context` and `tone`
+  — a note per language, keyed by language, so only the target language's rules are
+  sent when translating into it.
+
+### Patch Changes
+
+- Updated dependencies [[`7fa8699`](https://github.com/valbuild/val/commit/7fa869974bc895af992a7d5c18b76253636d7d65), [`600308d`](https://github.com/valbuild/val/commit/600308d0174990ad9f5c417147d160273489c65a), [`5b7fe05`](https://github.com/valbuild/val/commit/5b7fe05cec6365f9cd1de9ba31e65ed4a87edb63), [`88262ac`](https://github.com/valbuild/val/commit/88262ac8db068650a664981ef73556457d87741a), [`7072e07`](https://github.com/valbuild/val/commit/7072e07623c953a09ac14388ae22dada0b431ce3), [`29811c3`](https://github.com/valbuild/val/commit/29811c3f8c7e001a950e6f4833af6888e6a4efea), [`9983116`](https://github.com/valbuild/val/commit/99831164c5151aad7ca69de79e1d0d59878be251)]:
+  - @valbuild/core@0.127.0
+  - @valbuild/shared@0.127.0
+  - @valbuild/ui@0.127.0
+
 ## 0.126.0
 
 ### Patch Changes

package/dist/declarations/src/fixHandlers.d.ts

@@ -206,6 +206,6 @@ export declare function handleJsonValuesExtractEntry(ctx: FixHandlerContext): Pr
  * — just not by this command.
  */
 export declare function handleExternalUpload(): Promise<FixHandlerResult>;
-export declare const currentFixHandlers: Record<Exclude<ValidationFix, "keyof:check-keys" | "router:check-route">, FixHandler>;
+export declare const currentFixHandlers: Record<Exclude<ValidationFix, "keyof:check-keys" | "router:check-route" | "locale:check-locale" | "record:fill-keys">, FixHandler>;
 export declare const fixHandlers: Record<string, FixHandler>;
 export declare function createDefaultValFSHost(): IValFSHost;

package/dist/valbuild-server.cjs.dev.js

@@ -1748,6 +1748,7 @@ async function createService(projectRoot, host = {
   return new Service(projectRoot, sourceFileHandler, extracted);
 }
 class Service {
+  projectRoot;
   constructor(projectRoot, sourceFileHandler, extracted) {
     this.sourceFileHandler = sourceFileHandler;
     this.extracted = extracted;
@@ -2387,17 +2388,18 @@ function findNestedJsonValuesModuleErrors(schemas) {
 // #region ValOps
 class ValOps {
   /** Sources from val modules, immutable (without patches or anything)  */
-
+  sources;
   /** The sha256 / hash of all sources + all schemas + config */
-
+  baseSha;
   /** The sha256 / hash of all sources */
-
+  sourcesSha;
   /** The sha256 / hash of config */
-
+  configSha;
   /** Schema from val modules, immutable  */
-
+  schemas;
   /** The sha256 / hash of schema + config - if this changes users needs to reload */
-
+  schemaSha;
+  modulesErrors;
   /**
    * What the SHAs above are a fold over, so they can be recomputed.
    *
@@ -2405,7 +2407,7 @@ class ValOps {
    * without re-evaluating the modules is a save, and it has to be able to move
    * the SHAs with them.
    */
-
+  shaEntries;
   /**
    * The extraction's OWN module errors, which are what the fold was given.
    *
@@ -2413,7 +2415,7 @@ class ValOps {
    * `.jsonValues()` errors concatenated on, and those were never part of the
    * hash. Re-folding with the wrong list changes the base SHA for no reason.
    */
-
+  shaModuleErrors;
   /**
    * What a save has told us each `.jsonValues()` entry now holds.
    *
@@ -3173,7 +3175,8 @@ class ValOps {
     // (must include all modules, not just those being validated, since conflicts can come from any module)
     const galleryDirectoryToModules = new Map();
     // Build a schema/source snapshot so the shared resolver can cross-reference
-    // keyof:check-keys and router:check-route against every module's data.
+    // the marker fixes — a keyOf's key, a route, a locale tag, a record's
+    // declared keys — against every module's data. See `SCHEMA_SOURCE_FIXES`.
     const snapshot = {
       schemas: {},
       sources: {}
@@ -3253,7 +3256,7 @@ class ValOps {
         };
         if (validationErrors) {
           for (const validationError of validationErrors) {
-            var _validationError$fixe, _validationError$fixe2, _validationError$fixe3, _validationError$fixe4, _validationError$fixe5, _validationError$fixe6, _validationError$fixe7, _validationError$fixe8;
+            var _validationError$fixe, _validationError$fixe2, _validationError$fixe3, _validationError$fixe4, _validationError$fixe5, _validationError$fixe6;
             if (isOnlyFileCheckValidationError(validationError)) {
               if (files[sourcePath]) {
                 addError({
@@ -3267,13 +3270,13 @@ class ValOps {
               }
             } else if ((_validationError$fixe = validationError.fixes) !== null && _validationError$fixe !== void 0 && _validationError$fixe.includes("image:check-remote") || (_validationError$fixe2 = validationError.fixes) !== null && _validationError$fixe2 !== void 0 && _validationError$fixe2.includes("file:check-remote")) {
               remoteFiles[sourcePath] = validationError.value;
-            } else if ((_validationError$fixe3 = validationError.fixes) !== null && _validationError$fixe3 !== void 0 && _validationError$fixe3.includes("keyof:check-keys") || (_validationError$fixe4 = validationError.fixes) !== null && _validationError$fixe4 !== void 0 && _validationError$fixe4.includes("router:check-route")) {
+            } else if (internal.isSchemaSourceFixError(validationError)) {
               const resolved = internal.resolveSchemaSourceFixForError(validationError, snapshot);
               if (resolved && resolved.status === "remaining") {
                 addError(resolved.error);
               }
               // resolved.status === "resolved" → drop silently
-            } else if ((_validationError$fixe5 = validationError.fixes) !== null && _validationError$fixe5 !== void 0 && _validationError$fixe5.includes("images:check-unique-folder") || (_validationError$fixe6 = validationError.fixes) !== null && _validationError$fixe6 !== void 0 && _validationError$fixe6.includes("files:check-unique-folder")) {
+            } else if ((_validationError$fixe3 = validationError.fixes) !== null && _validationError$fixe3 !== void 0 && _validationError$fixe3.includes("images:check-unique-folder") || (_validationError$fixe4 = validationError.fixes) !== null && _validationError$fixe4 !== void 0 && _validationError$fixe4.includes("files:check-unique-folder")) {
               const TYPE_ERROR_MESSAGE = `This is most likely a Val version mismatch or Val bug.`;
               if (!validationError.value || typeof validationError.value !== "object") {
                 addError({
@@ -3298,7 +3301,7 @@ class ValOps {
                   // If conflictingModules is empty, directory is unique — silently drop the error.
                 }
               }
-            } else if ((_validationError$fixe7 = validationError.fixes) !== null && _validationError$fixe7 !== void 0 && _validationError$fixe7.includes("images:check-all-files") || (_validationError$fixe8 = validationError.fixes) !== null && _validationError$fixe8 !== void 0 && _validationError$fixe8.includes("files:check-all-files")) ; else {
+            } else if ((_validationError$fixe5 = validationError.fixes) !== null && _validationError$fixe5 !== void 0 && _validationError$fixe5.includes("images:check-all-files") || (_validationError$fixe6 = validationError.fixes) !== null && _validationError$fixe6 !== void 0 && _validationError$fixe6.includes("files:check-all-files")) ; else {
               addError(validationError);
             }
           }
@@ -4158,8 +4161,8 @@ class ValOps {
   // #endregion history
 }
 function isOnlyFileCheckValidationError(validationError) {
-  var _validationError$fixe9;
-  if ((_validationError$fixe9 = validationError.fixes) !== null && _validationError$fixe9 !== void 0 && _validationError$fixe9.every(f => f === "file:check-metadata" || f === "image:check-metadata")) {
+  var _validationError$fixe7;
+  if ((_validationError$fixe7 = validationError.fixes) !== null && _validationError$fixe7 !== void 0 && _validationError$fixe7.every(f => f === "file:check-metadata" || f === "image:check-metadata")) {
     return true;
   }
   return false;
@@ -5680,6 +5683,7 @@ function serializeSchemaSafely(schema) {
 }
 class ValOpsFS extends ValOps {
   static VAL_DIR = ".val";
+  host;
   constructor(contentUrl, rootDir, valModules, options) {
     super(valModules, options);
     this.contentUrl = contentUrl;
@@ -5692,6 +5696,7 @@ class ValOpsFS extends ValOps {
    * Change detection for `.jsonValues()` entry files, which no sha can see (their
    * content lives behind a thunk that `JSON.stringify` drops).
    */
+  jsonEntryFilesFingerprint;
 
   /**
    * Unpublished changes repair threw away, waiting to be told to somebody.
@@ -7221,6 +7226,8 @@ const NonceResponse = z.z.object({
  */
 const PATCH_GROUPS_CACHE_MS = 1000;
 class ValOpsHttp extends ValOps {
+  authHeaders;
+  root;
   constructor(contentUrl, project, commitSha,
   // TODO: CommitSha
   branch,
@@ -13576,6 +13583,8 @@ const MAX_CACHE_SIZE = 100 * 1024 * 1024; // 100 mb
 const MAX_OBJECT_KEY_SIZE = 2 ** 27; // https://stackoverflow.com/questions/13367391/is-there-a-limit-on-length-of-the-key-string-in-js-object
 
 class ValModuleLoader {
+  cache;
+  cacheSize;
   constructor(projectRoot, compilerOptions,
   // TODO: remove this?
   sourceFileHandler, host = {
@@ -15255,9 +15264,10 @@ async function handleExternalUpload() {
   };
 }
 
-// Fix handler registry. `keyof:check-keys` and `router:check-route` are
-// resolved upfront by the shared resolveSchemaSourceFixes — they never reach
-// this registry, so they're excluded from the key set.
+// Fix handler registry. `keyof:check-keys`, `router:check-route`,
+// `locale:check-locale` and `record:fill-keys` are resolved upfront by the
+// shared resolveSchemaSourceFixes — they never reach this registry, so they're
+// excluded from the key set.
 const currentFixHandlers = {
   "image:check-metadata": handleFileMetadata,
   "image:add-metadata": handleFileMetadata,

package/dist/valbuild-server.cjs.prod.js

@@ -1748,6 +1748,7 @@ async function createService(projectRoot, host = {
   return new Service(projectRoot, sourceFileHandler, extracted);
 }
 class Service {
+  projectRoot;
   constructor(projectRoot, sourceFileHandler, extracted) {
     this.sourceFileHandler = sourceFileHandler;
     this.extracted = extracted;
@@ -2387,17 +2388,18 @@ function findNestedJsonValuesModuleErrors(schemas) {
 // #region ValOps
 class ValOps {
   /** Sources from val modules, immutable (without patches or anything)  */
-
+  sources;
   /** The sha256 / hash of all sources + all schemas + config */
-
+  baseSha;
   /** The sha256 / hash of all sources */
-
+  sourcesSha;
   /** The sha256 / hash of config */
-
+  configSha;
   /** Schema from val modules, immutable  */
-
+  schemas;
   /** The sha256 / hash of schema + config - if this changes users needs to reload */
-
+  schemaSha;
+  modulesErrors;
   /**
    * What the SHAs above are a fold over, so they can be recomputed.
    *
@@ -2405,7 +2407,7 @@ class ValOps {
    * without re-evaluating the modules is a save, and it has to be able to move
    * the SHAs with them.
    */
-
+  shaEntries;
   /**
    * The extraction's OWN module errors, which are what the fold was given.
    *
@@ -2413,7 +2415,7 @@ class ValOps {
    * `.jsonValues()` errors concatenated on, and those were never part of the
    * hash. Re-folding with the wrong list changes the base SHA for no reason.
    */
-
+  shaModuleErrors;
   /**
    * What a save has told us each `.jsonValues()` entry now holds.
    *
@@ -3173,7 +3175,8 @@ class ValOps {
     // (must include all modules, not just those being validated, since conflicts can come from any module)
     const galleryDirectoryToModules = new Map();
     // Build a schema/source snapshot so the shared resolver can cross-reference
-    // keyof:check-keys and router:check-route against every module's data.
+    // the marker fixes — a keyOf's key, a route, a locale tag, a record's
+    // declared keys — against every module's data. See `SCHEMA_SOURCE_FIXES`.
     const snapshot = {
       schemas: {},
       sources: {}
@@ -3253,7 +3256,7 @@ class ValOps {
         };
         if (validationErrors) {
           for (const validationError of validationErrors) {
-            var _validationError$fixe, _validationError$fixe2, _validationError$fixe3, _validationError$fixe4, _validationError$fixe5, _validationError$fixe6, _validationError$fixe7, _validationError$fixe8;
+            var _validationError$fixe, _validationError$fixe2, _validationError$fixe3, _validationError$fixe4, _validationError$fixe5, _validationError$fixe6;
             if (isOnlyFileCheckValidationError(validationError)) {
               if (files[sourcePath]) {
                 addError({
@@ -3267,13 +3270,13 @@ class ValOps {
               }
             } else if ((_validationError$fixe = validationError.fixes) !== null && _validationError$fixe !== void 0 && _validationError$fixe.includes("image:check-remote") || (_validationError$fixe2 = validationError.fixes) !== null && _validationError$fixe2 !== void 0 && _validationError$fixe2.includes("file:check-remote")) {
               remoteFiles[sourcePath] = validationError.value;
-            } else if ((_validationError$fixe3 = validationError.fixes) !== null && _validationError$fixe3 !== void 0 && _validationError$fixe3.includes("keyof:check-keys") || (_validationError$fixe4 = validationError.fixes) !== null && _validationError$fixe4 !== void 0 && _validationError$fixe4.includes("router:check-route")) {
+            } else if (internal.isSchemaSourceFixError(validationError)) {
               const resolved = internal.resolveSchemaSourceFixForError(validationError, snapshot);
               if (resolved && resolved.status === "remaining") {
                 addError(resolved.error);
               }
               // resolved.status === "resolved" → drop silently
-            } else if ((_validationError$fixe5 = validationError.fixes) !== null && _validationError$fixe5 !== void 0 && _validationError$fixe5.includes("images:check-unique-folder") || (_validationError$fixe6 = validationError.fixes) !== null && _validationError$fixe6 !== void 0 && _validationError$fixe6.includes("files:check-unique-folder")) {
+            } else if ((_validationError$fixe3 = validationError.fixes) !== null && _validationError$fixe3 !== void 0 && _validationError$fixe3.includes("images:check-unique-folder") || (_validationError$fixe4 = validationError.fixes) !== null && _validationError$fixe4 !== void 0 && _validationError$fixe4.includes("files:check-unique-folder")) {
               const TYPE_ERROR_MESSAGE = `This is most likely a Val version mismatch or Val bug.`;
               if (!validationError.value || typeof validationError.value !== "object") {
                 addError({
@@ -3298,7 +3301,7 @@ class ValOps {
                   // If conflictingModules is empty, directory is unique — silently drop the error.
                 }
               }
-            } else if ((_validationError$fixe7 = validationError.fixes) !== null && _validationError$fixe7 !== void 0 && _validationError$fixe7.includes("images:check-all-files") || (_validationError$fixe8 = validationError.fixes) !== null && _validationError$fixe8 !== void 0 && _validationError$fixe8.includes("files:check-all-files")) ; else {
+            } else if ((_validationError$fixe5 = validationError.fixes) !== null && _validationError$fixe5 !== void 0 && _validationError$fixe5.includes("images:check-all-files") || (_validationError$fixe6 = validationError.fixes) !== null && _validationError$fixe6 !== void 0 && _validationError$fixe6.includes("files:check-all-files")) ; else {
               addError(validationError);
             }
           }
@@ -4158,8 +4161,8 @@ class ValOps {
   // #endregion history
 }
 function isOnlyFileCheckValidationError(validationError) {
-  var _validationError$fixe9;
-  if ((_validationError$fixe9 = validationError.fixes) !== null && _validationError$fixe9 !== void 0 && _validationError$fixe9.every(f => f === "file:check-metadata" || f === "image:check-metadata")) {
+  var _validationError$fixe7;
+  if ((_validationError$fixe7 = validationError.fixes) !== null && _validationError$fixe7 !== void 0 && _validationError$fixe7.every(f => f === "file:check-metadata" || f === "image:check-metadata")) {
     return true;
   }
   return false;
@@ -5680,6 +5683,7 @@ function serializeSchemaSafely(schema) {
 }
 class ValOpsFS extends ValOps {
   static VAL_DIR = ".val";
+  host;
   constructor(contentUrl, rootDir, valModules, options) {
     super(valModules, options);
     this.contentUrl = contentUrl;
@@ -5692,6 +5696,7 @@ class ValOpsFS extends ValOps {
    * Change detection for `.jsonValues()` entry files, which no sha can see (their
    * content lives behind a thunk that `JSON.stringify` drops).
    */
+  jsonEntryFilesFingerprint;
 
   /**
    * Unpublished changes repair threw away, waiting to be told to somebody.
@@ -7221,6 +7226,8 @@ const NonceResponse = z.z.object({
  */
 const PATCH_GROUPS_CACHE_MS = 1000;
 class ValOpsHttp extends ValOps {
+  authHeaders;
+  root;
   constructor(contentUrl, project, commitSha,
   // TODO: CommitSha
   branch,
@@ -13576,6 +13583,8 @@ const MAX_CACHE_SIZE = 100 * 1024 * 1024; // 100 mb
 const MAX_OBJECT_KEY_SIZE = 2 ** 27; // https://stackoverflow.com/questions/13367391/is-there-a-limit-on-length-of-the-key-string-in-js-object
 
 class ValModuleLoader {
+  cache;
+  cacheSize;
   constructor(projectRoot, compilerOptions,
   // TODO: remove this?
   sourceFileHandler, host = {
@@ -15255,9 +15264,10 @@ async function handleExternalUpload() {
   };
 }
 
-// Fix handler registry. `keyof:check-keys` and `router:check-route` are
-// resolved upfront by the shared resolveSchemaSourceFixes — they never reach
-// this registry, so they're excluded from the key set.
+// Fix handler registry. `keyof:check-keys`, `router:check-route`,
+// `locale:check-locale` and `record:fill-keys` are resolved upfront by the
+// shared resolveSchemaSourceFixes — they never reach this registry, so they're
+// excluded from the key set.
 const currentFixHandlers = {
   "image:check-metadata": handleFileMetadata,
   "image:add-metadata": handleFileMetadata,

package/dist/valbuild-server.esm.js

@@ -8,7 +8,7 @@ import path__default from 'path';
 import fs, { promises } from 'fs';
 import vm from 'node:vm';
 import { Module } from 'node:module';
-import { resolveSchemaSourceFixForError, Patch, getErrorMessageFromUnknownJson, JSONValue, PatchGroup, newestCommitSha, SerializedSchema, VAL_ENABLE_COOKIE_NAME, VAL_STATE_COOKIE, VAL_SESSION_COOKIE, Api } from '@valbuild/shared/internal';
+import { isSchemaSourceFixError, resolveSchemaSourceFixForError, Patch, getErrorMessageFromUnknownJson, JSONValue, PatchGroup, newestCommitSha, SerializedSchema, VAL_ENABLE_COOKIE_NAME, VAL_STATE_COOKIE, VAL_SESSION_COOKIE, Api } from '@valbuild/shared/internal';
 import { createUIRequestHandler } from '@valbuild/ui/server';
 import crypto$1 from 'crypto';
 import z$1, { z } from 'zod';
@@ -1714,6 +1714,7 @@ async function createService(projectRoot, host = {
   return new Service(projectRoot, sourceFileHandler, extracted);
 }
 class Service {
+  projectRoot;
   constructor(projectRoot, sourceFileHandler, extracted) {
     this.sourceFileHandler = sourceFileHandler;
     this.extracted = extracted;
@@ -2353,17 +2354,18 @@ function findNestedJsonValuesModuleErrors(schemas) {
 // #region ValOps
 class ValOps {
   /** Sources from val modules, immutable (without patches or anything)  */
-
+  sources;
   /** The sha256 / hash of all sources + all schemas + config */
-
+  baseSha;
   /** The sha256 / hash of all sources */
-
+  sourcesSha;
   /** The sha256 / hash of config */
-
+  configSha;
   /** Schema from val modules, immutable  */
-
+  schemas;
   /** The sha256 / hash of schema + config - if this changes users needs to reload */
-
+  schemaSha;
+  modulesErrors;
   /**
    * What the SHAs above are a fold over, so they can be recomputed.
    *
@@ -2371,7 +2373,7 @@ class ValOps {
    * without re-evaluating the modules is a save, and it has to be able to move
    * the SHAs with them.
    */
-
+  shaEntries;
   /**
    * The extraction's OWN module errors, which are what the fold was given.
    *
@@ -2379,7 +2381,7 @@ class ValOps {
    * `.jsonValues()` errors concatenated on, and those were never part of the
    * hash. Re-folding with the wrong list changes the base SHA for no reason.
    */
-
+  shaModuleErrors;
   /**
    * What a save has told us each `.jsonValues()` entry now holds.
    *
@@ -3139,7 +3141,8 @@ class ValOps {
     // (must include all modules, not just those being validated, since conflicts can come from any module)
     const galleryDirectoryToModules = new Map();
     // Build a schema/source snapshot so the shared resolver can cross-reference
-    // keyof:check-keys and router:check-route against every module's data.
+    // the marker fixes — a keyOf's key, a route, a locale tag, a record's
+    // declared keys — against every module's data. See `SCHEMA_SOURCE_FIXES`.
     const snapshot = {
       schemas: {},
       sources: {}
@@ -3219,7 +3222,7 @@ class ValOps {
         };
         if (validationErrors) {
           for (const validationError of validationErrors) {
-            var _validationError$fixe, _validationError$fixe2, _validationError$fixe3, _validationError$fixe4, _validationError$fixe5, _validationError$fixe6, _validationError$fixe7, _validationError$fixe8;
+            var _validationError$fixe, _validationError$fixe2, _validationError$fixe3, _validationError$fixe4, _validationError$fixe5, _validationError$fixe6;
             if (isOnlyFileCheckValidationError(validationError)) {
               if (files[sourcePath]) {
                 addError({
@@ -3233,13 +3236,13 @@ class ValOps {
               }
             } else if ((_validationError$fixe = validationError.fixes) !== null && _validationError$fixe !== void 0 && _validationError$fixe.includes("image:check-remote") || (_validationError$fixe2 = validationError.fixes) !== null && _validationError$fixe2 !== void 0 && _validationError$fixe2.includes("file:check-remote")) {
               remoteFiles[sourcePath] = validationError.value;
-            } else if ((_validationError$fixe3 = validationError.fixes) !== null && _validationError$fixe3 !== void 0 && _validationError$fixe3.includes("keyof:check-keys") || (_validationError$fixe4 = validationError.fixes) !== null && _validationError$fixe4 !== void 0 && _validationError$fixe4.includes("router:check-route")) {
+            } else if (isSchemaSourceFixError(validationError)) {
               const resolved = resolveSchemaSourceFixForError(validationError, snapshot);
               if (resolved && resolved.status === "remaining") {
                 addError(resolved.error);
               }
               // resolved.status === "resolved" → drop silently
-            } else if ((_validationError$fixe5 = validationError.fixes) !== null && _validationError$fixe5 !== void 0 && _validationError$fixe5.includes("images:check-unique-folder") || (_validationError$fixe6 = validationError.fixes) !== null && _validationError$fixe6 !== void 0 && _validationError$fixe6.includes("files:check-unique-folder")) {
+            } else if ((_validationError$fixe3 = validationError.fixes) !== null && _validationError$fixe3 !== void 0 && _validationError$fixe3.includes("images:check-unique-folder") || (_validationError$fixe4 = validationError.fixes) !== null && _validationError$fixe4 !== void 0 && _validationError$fixe4.includes("files:check-unique-folder")) {
               const TYPE_ERROR_MESSAGE = `This is most likely a Val version mismatch or Val bug.`;
               if (!validationError.value || typeof validationError.value !== "object") {
                 addError({
@@ -3264,7 +3267,7 @@ class ValOps {
                   // If conflictingModules is empty, directory is unique — silently drop the error.
                 }
               }
-            } else if ((_validationError$fixe7 = validationError.fixes) !== null && _validationError$fixe7 !== void 0 && _validationError$fixe7.includes("images:check-all-files") || (_validationError$fixe8 = validationError.fixes) !== null && _validationError$fixe8 !== void 0 && _validationError$fixe8.includes("files:check-all-files")) ; else {
+            } else if ((_validationError$fixe5 = validationError.fixes) !== null && _validationError$fixe5 !== void 0 && _validationError$fixe5.includes("images:check-all-files") || (_validationError$fixe6 = validationError.fixes) !== null && _validationError$fixe6 !== void 0 && _validationError$fixe6.includes("files:check-all-files")) ; else {
               addError(validationError);
             }
           }
@@ -4124,8 +4127,8 @@ class ValOps {
   // #endregion history
 }
 function isOnlyFileCheckValidationError(validationError) {
-  var _validationError$fixe9;
-  if ((_validationError$fixe9 = validationError.fixes) !== null && _validationError$fixe9 !== void 0 && _validationError$fixe9.every(f => f === "file:check-metadata" || f === "image:check-metadata")) {
+  var _validationError$fixe7;
+  if ((_validationError$fixe7 = validationError.fixes) !== null && _validationError$fixe7 !== void 0 && _validationError$fixe7.every(f => f === "file:check-metadata" || f === "image:check-metadata")) {
     return true;
   }
   return false;
@@ -5646,6 +5649,7 @@ function serializeSchemaSafely(schema) {
 }
 class ValOpsFS extends ValOps {
   static VAL_DIR = ".val";
+  host;
   constructor(contentUrl, rootDir, valModules, options) {
     super(valModules, options);
     this.contentUrl = contentUrl;
@@ -5658,6 +5662,7 @@ class ValOpsFS extends ValOps {
    * Change detection for `.jsonValues()` entry files, which no sha can see (their
    * content lives behind a thunk that `JSON.stringify` drops).
    */
+  jsonEntryFilesFingerprint;
 
   /**
    * Unpublished changes repair threw away, waiting to be told to somebody.
@@ -7187,6 +7192,8 @@ const NonceResponse = z.object({
  */
 const PATCH_GROUPS_CACHE_MS = 1000;
 class ValOpsHttp extends ValOps {
+  authHeaders;
+  root;
   constructor(contentUrl, project, commitSha,
   // TODO: CommitSha
   branch,
@@ -13542,6 +13549,8 @@ const MAX_CACHE_SIZE = 100 * 1024 * 1024; // 100 mb
 const MAX_OBJECT_KEY_SIZE = 2 ** 27; // https://stackoverflow.com/questions/13367391/is-there-a-limit-on-length-of-the-key-string-in-js-object
 
 class ValModuleLoader {
+  cache;
+  cacheSize;
   constructor(projectRoot, compilerOptions,
   // TODO: remove this?
   sourceFileHandler, host = {
@@ -15221,9 +15230,10 @@ async function handleExternalUpload() {
   };
 }
 
-// Fix handler registry. `keyof:check-keys` and `router:check-route` are
-// resolved upfront by the shared resolveSchemaSourceFixes — they never reach
-// this registry, so they're excluded from the key set.
+// Fix handler registry. `keyof:check-keys`, `router:check-route`,
+// `locale:check-locale` and `record:fill-keys` are resolved upfront by the
+// shared resolveSchemaSourceFixes — they never reach this registry, so they're
+// excluded from the key set.
 const currentFixHandlers = {
   "image:check-metadata": handleFileMetadata,
   "image:add-metadata": handleFileMetadata,

package/package.json

@@ -16,7 +16,7 @@
     "./package.json": "./package.json"
   },
   "types": "dist/valbuild-server.cjs.d.ts",
-  "version": "0.126.0",
+  "version": "0.127.0",
   "devDependencies": {
     "@prettier/sync": "^0.6.1",
     "@types/jest": "^30.0.0"
@@ -29,9 +29,9 @@
     "typescript": "^6.0.3",
     "zod": "^4.4.3",
     "zod-validation-error": "^5.0.0",
-    "@valbuild/core": "0.126.0",
-    "@valbuild/shared": "0.126.0",
-    "@valbuild/ui": "0.126.0"
+    "@valbuild/shared": "0.127.0",
+    "@valbuild/ui": "0.127.0",
+    "@valbuild/core": "0.127.0"
   },
   "engines": {
     "node": "^20.19.0 || >=22"