@valbuild/core 0.99.1 → 0.100.0

package/dist/{index-204b5d78.esm.js → index-c9241d81.esm.js}

@@ -652,6 +652,13 @@ var FileSchema = /*#__PURE__*/function (_Schema) {
     value: function hidden() {
       return new FileSchema(this.options, this.opt, this.isRemote, this.customValidateFunctions, this.moduleMetadata, this.isReadonly, true, this.description);
     }
+  }, {
+    key: "executeCustomValidateAt",
+    value: function executeCustomValidateAt(path, src) {
+      return this.executeCustomValidateFunctions(src, this.customValidateFunctions, {
+        path: path
+      });
+    }
   }, {
     key: "executeSerialize",
     value: function executeSerialize() {
@@ -900,6 +907,13 @@ var StringSchema = /*#__PURE__*/function (_Schema) {
     value: function raw() {
       return new StringSchema(this.options, this.opt, true, this.customValidateFunctions, this.renderInput, this.isReadonly, this.isHidden, this.description);
     }
+  }, {
+    key: "executeCustomValidateAt",
+    value: function executeCustomValidateAt(path, src) {
+      return this.executeCustomValidateFunctions(src, this.customValidateFunctions, {
+        path: path
+      });
+    }
   }, {
     key: "executeSerialize",
     value: function executeSerialize() {
@@ -1116,6 +1130,13 @@ var ObjectSchema = /*#__PURE__*/function (_Schema) {
     value: function hidden() {
       return new ObjectSchema(this.items, this.opt, this.customValidateFunctions, this.isReadonly, true, this.description);
     }
+  }, {
+    key: "executeCustomValidateAt",
+    value: function executeCustomValidateAt(path, src) {
+      return this.executeCustomValidateFunctions(src, this.customValidateFunctions, {
+        path: path
+      });
+    }
   }, {
     key: "executeSerialize",
     value: function executeSerialize() {
@@ -1275,6 +1296,13 @@ var ArraySchema = /*#__PURE__*/function (_Schema) {
     value: function hidden() {
       return new ArraySchema(this.item, this.opt, this.customValidateFunctions, this.isReadonly, true, this.description, this.renderInput);
     }
+  }, {
+    key: "executeCustomValidateAt",
+    value: function executeCustomValidateAt(path, src) {
+      return this.executeCustomValidateFunctions(src, this.customValidateFunctions, {
+        path: path
+      });
+    }
   }, {
     key: "executeSerialize",
     value: function executeSerialize() {
@@ -1463,6 +1491,13 @@ var LiteralSchema = /*#__PURE__*/function (_Schema) {
     value: function hidden() {
       return new LiteralSchema(this.value, this.opt, this.customValidateFunctions, this.isReadonly, true, this.description);
     }
+  }, {
+    key: "executeCustomValidateAt",
+    value: function executeCustomValidateAt(path, src) {
+      return this.executeCustomValidateFunctions(src, this.customValidateFunctions, {
+        path: path
+      });
+    }
   }, {
     key: "executeSerialize",
     value: function executeSerialize() {
@@ -1821,6 +1856,64 @@ var UnionSchema = /*#__PURE__*/function (_Schema) {
     value: function hidden() {
       return new UnionSchema(this.key, this.items, this.opt, this.customValidateFunctions, this.isReadonly, true, this.description);
     }
+  }, {
+    key: "executeCustomValidateAt",
+    value: function executeCustomValidateAt(path, src) {
+      var errors = this.executeCustomValidateFunctions(src, this.customValidateFunctions, {
+        path: path
+      });
+      // A tagged union's variants share the union's path, so `Internal.resolvePath`
+      // stops here and a variant's OWN validator would never be reached. Dispatch
+      // into the variant this value takes — the union is the only node that knows
+      // which one that is.
+      var matched = this.matchedVariant(src);
+      if (matched) {
+        errors.push.apply(errors, _toConsumableArray(matched["executeCustomValidateAt"](path, src)));
+      }
+      return errors;
+    }
+
+    /**
+     * The variant schema a value takes, for a TAGGED union (string `key`). `null`
+     * for a literal union (its variants are leaves with nothing to descend into) or
+     * when the value matches none of them — a structural error `executeValidate`
+     * already reports.
+     */
+  }, {
+    key: "matchedVariant",
+    value: function matchedVariant(src) {
+      var key = this.key;
+      if (typeof key !== "string" || !Array.isArray(this.items)) {
+        return null;
+      }
+      if (src === null || _typeof(src) !== "object" || Array.isArray(src)) {
+        return null;
+      }
+      var tag = src[key];
+      if (typeof tag !== "string") {
+        return null;
+      }
+      var objectSchemas = this.items;
+      var _iterator4 = _createForOfIteratorHelper(objectSchemas),
+        _step4;
+      try {
+        for (_iterator4.s(); !(_step4 = _iterator4.n()).done;) {
+          var item = _step4.value;
+          if (!(item instanceof ObjectSchema)) {
+            continue;
+          }
+          var tagSchema = item["items"][key];
+          if (tagSchema instanceof LiteralSchema && tagSchema["value"] === tag) {
+            return item;
+          }
+        }
+      } catch (err) {
+        _iterator4.e(err);
+      } finally {
+        _iterator4.f();
+      }
+      return null;
+    }
   }, {
     key: "executeSerialize",
     value: function executeSerialize() {
@@ -2132,6 +2225,13 @@ var ImageSchema = /*#__PURE__*/function (_Schema) {
     value: function hidden() {
       return new ImageSchema(this.options, this.opt, this.isRemote, this.customValidateFunctions, this.moduleMetadata, this.isReadonly, true, this.description);
     }
+  }, {
+    key: "executeCustomValidateAt",
+    value: function executeCustomValidateAt(path, src) {
+      return this.executeCustomValidateFunctions(src, this.customValidateFunctions, {
+        path: path
+      });
+    }
   }, {
     key: "executeSerialize",
     value: function executeSerialize() {
@@ -2307,6 +2407,13 @@ var RouteSchema = /*#__PURE__*/function (_Schema) {
     value: function hidden() {
       return new RouteSchema(this.options, this.opt, this.customValidateFunctions, this.isReadonly, true, this.description);
     }
+  }, {
+    key: "executeCustomValidateAt",
+    value: function executeCustomValidateAt(path, src) {
+      return this.executeCustomValidateFunctions(src, this.customValidateFunctions, {
+        path: path
+      });
+    }
   }, {
     key: "executeSerialize",
     value: function executeSerialize() {
@@ -2845,6 +2952,13 @@ var RichTextSchema = /*#__PURE__*/function (_Schema) {
     value: function hidden() {
       return new RichTextSchema(this.options, this.opt, this.customValidateFunctions, this.isReadonly, true, this.description);
     }
+  }, {
+    key: "executeCustomValidateAt",
+    value: function executeCustomValidateAt(path, src) {
+      return this.executeCustomValidateFunctions(src, this.customValidateFunctions, {
+        path: path
+      });
+    }
   }, {
     key: "executeSerialize",
     value: function executeSerialize() {
@@ -2894,6 +3008,290 @@ var richtext = function richtext(options) {
   return new RichTextSchema(options !== null && options !== void 0 ? options : {});
 };
 
+function _regeneratorDefine(e, r, n, t) {
+  var i = Object.defineProperty;
+  try {
+    i({}, "", {});
+  } catch (e) {
+    i = 0;
+  }
+  _regeneratorDefine = function (e, r, n, t) {
+    function o(r, n) {
+      _regeneratorDefine(e, r, function (e) {
+        return this._invoke(r, n, e);
+      });
+    }
+    r ? i ? i(e, r, {
+      value: n,
+      enumerable: !t,
+      configurable: !t,
+      writable: !t
+    }) : e[r] = n : (o("next", 0), o("throw", 1), o("return", 2));
+  }, _regeneratorDefine(e, r, n, t);
+}
+
+function _regenerator() {
+  /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/babel/babel/blob/main/packages/babel-helpers/LICENSE */
+  var e,
+    t,
+    r = "function" == typeof Symbol ? Symbol : {},
+    n = r.iterator || "@@iterator",
+    o = r.toStringTag || "@@toStringTag";
+  function i(r, n, o, i) {
+    var c = n && n.prototype instanceof Generator ? n : Generator,
+      u = Object.create(c.prototype);
+    return _regeneratorDefine(u, "_invoke", function (r, n, o) {
+      var i,
+        c,
+        u,
+        f = 0,
+        p = o || [],
+        y = !1,
+        G = {
+          p: 0,
+          n: 0,
+          v: e,
+          a: d,
+          f: d.bind(e, 4),
+          d: function (t, r) {
+            return i = t, c = 0, u = e, G.n = r, a;
+          }
+        };
+      function d(r, n) {
+        for (c = r, u = n, t = 0; !y && f && !o && t < p.length; t++) {
+          var o,
+            i = p[t],
+            d = G.p,
+            l = i[2];
+          r > 3 ? (o = l === n) && (u = i[(c = i[4]) ? 5 : (c = 3, 3)], i[4] = i[5] = e) : i[0] <= d && ((o = r < 2 && d < i[1]) ? (c = 0, G.v = n, G.n = i[1]) : d < l && (o = r < 3 || i[0] > n || n > l) && (i[4] = r, i[5] = n, G.n = l, c = 0));
+        }
+        if (o || r > 1) return a;
+        throw y = !0, n;
+      }
+      return function (o, p, l) {
+        if (f > 1) throw TypeError("Generator is already running");
+        for (y && 1 === p && d(p, l), c = p, u = l; (t = c < 2 ? e : u) || !y;) {
+          i || (c ? c < 3 ? (c > 1 && (G.n = -1), d(c, u)) : G.n = u : G.v = u);
+          try {
+            if (f = 2, i) {
+              if (c || (o = "next"), t = i[o]) {
+                if (!(t = t.call(i, u))) throw TypeError("iterator result is not an object");
+                if (!t.done) return t;
+                u = t.value, c < 2 && (c = 0);
+              } else 1 === c && (t = i.return) && t.call(i), c < 2 && (u = TypeError("The iterator does not provide a '" + o + "' method"), c = 1);
+              i = e;
+            } else if ((t = (y = G.n < 0) ? u : r.call(n, G)) !== a) break;
+          } catch (t) {
+            i = e, c = 1, u = t;
+          } finally {
+            f = 1;
+          }
+        }
+        return {
+          value: t,
+          done: y
+        };
+      };
+    }(r, o, i), !0), u;
+  }
+  var a = {};
+  function Generator() {}
+  function GeneratorFunction() {}
+  function GeneratorFunctionPrototype() {}
+  t = Object.getPrototypeOf;
+  var c = [][n] ? t(t([][n]())) : (_regeneratorDefine(t = {}, n, function () {
+      return this;
+    }), t),
+    u = GeneratorFunctionPrototype.prototype = Generator.prototype = Object.create(c);
+  function f(e) {
+    return Object.setPrototypeOf ? Object.setPrototypeOf(e, GeneratorFunctionPrototype) : (e.__proto__ = GeneratorFunctionPrototype, _regeneratorDefine(e, o, "GeneratorFunction")), e.prototype = Object.create(u), e;
+  }
+  return GeneratorFunction.prototype = GeneratorFunctionPrototype, _regeneratorDefine(u, "constructor", GeneratorFunctionPrototype), _regeneratorDefine(GeneratorFunctionPrototype, "constructor", GeneratorFunction), GeneratorFunction.displayName = "GeneratorFunction", _regeneratorDefine(GeneratorFunctionPrototype, o, "GeneratorFunction"), _regeneratorDefine(u), _regeneratorDefine(u, o, "Generator"), _regeneratorDefine(u, n, function () {
+    return this;
+  }), _regeneratorDefine(u, "toString", function () {
+    return "[object Generator]";
+  }), (_regenerator = function () {
+    return {
+      w: i,
+      m: f
+    };
+  })();
+}
+
+function asyncGeneratorStep(n, t, e, r, o, a, c) {
+  try {
+    var i = n[a](c),
+      u = i.value;
+  } catch (n) {
+    return void e(n);
+  }
+  i.done ? t(u) : Promise.resolve(u).then(r, o);
+}
+function _asyncToGenerator(n) {
+  return function () {
+    var t = this,
+      e = arguments;
+    return new Promise(function (r, o) {
+      var a = n.apply(t, e);
+      function _next(n) {
+        asyncGeneratorStep(a, r, o, _next, _throw, "next", n);
+      }
+      function _throw(n) {
+        asyncGeneratorStep(a, r, o, _next, _throw, "throw", n);
+      }
+      _next(void 0);
+    });
+  };
+}
+
+/**
+ * The string used as the `_type` discriminator of a {@link JsonSource}.
+ */
+var JSON_VAL_EXTENSION_TAG = "json";
+
+/**
+ * The lazy import thunk a {@link JsonSource} carries at runtime. It is NOT part
+ * of the {@link JsonSource} type because `Source` must stay JSON-serializable
+ * (it is sent over the wire as `Json`); the thunk is a runtime-only detail,
+ * read via {@link getJsonImport}.
+ */
+
+/**
+ * A JSON source represents a record/router entry whose value is stored in a
+ * separate `*.val.json` file and loaded lazily via a dynamic `import()` thunk.
+ *
+ * This is what `c.json(() => import("./entry.val.json"))` returns.
+ *
+ * The *type* is a pure-JSON marker (`{ _type: "json", patch_id? }`) so that
+ * `Source` stays JSON-serializable. At runtime the value additionally carries a
+ * lazy import thunk (read via {@link getJsonImport}); over the wire only the
+ * marker is sent.
+ *
+ * The phantom type parameter `T` is the (loosened, see {@link JsonOf}) type of
+ * the value the JSON file resolves to. It is covariant: a `JsonSource` of a
+ * narrower value type is assignable to a `JsonSource` of a wider one.
+ */
+
+function json(importThunk) {
+  return _defineProperty(_defineProperty({}, VAL_EXTENSION, JSON_VAL_EXTENSION_TAG), "_import", importThunk);
+}
+function isJson(obj) {
+  return _typeof(obj) === "object" && obj !== null && VAL_EXTENSION in obj && obj[VAL_EXTENSION] === JSON_VAL_EXTENSION_TAG;
+}
+
+/**
+ * Reads the runtime-only lazy import thunk from a {@link JsonSource}. Returns
+ * `undefined` for a transport marker (sent over the wire without the thunk).
+ */
+function getJsonImport(source) {
+  var candidate = source._import;
+  return typeof candidate === "function" ? candidate : undefined;
+}
+
+/**
+ * Recursively resolves every {@link JsonSource} marker in a source tree by
+ * invoking its lazy import thunk, returning a fully-inlined source. This backs
+ * the eager `fetchVal`/`useVal` path (load everything).
+ *
+ * Markers without a runtime thunk (transport markers received over the wire)
+ * are left as-is — there is nothing to load from them locally. Other branded
+ * leaf sources (file/image/remote/richtext) are returned untouched.
+ */
+function resolveJsonValues(_x) {
+  return _resolveJsonValues.apply(this, arguments);
+}
+
+/**
+ * Loosens a (strict) schema source type `T` into the type that a
+ * `resolveJsonModule` import of the backing `*.val.json` can actually satisfy.
+ *
+ * Why this is needed: TypeScript widens literals when it infers the type of a
+ * JSON module (e.g. `"a"` becomes `string`, `1` becomes `number`, and a branded
+ * `_type: "file"` becomes `_type: string`). A strict schema type (with literal
+ * unions, `RawString` brands, etc.) would therefore reject a perfectly valid
+ * JSON file. `JsonOf<T>` performs the same widening at the type level so the
+ * JSON content typechecks against the schema as strictly as JSON allows. Runtime
+ * validation enforces the rest.
+ *
+ * The transform distributes over unions and recurses through objects/arrays,
+ * preserving structure while widening every leaf literal. Val object-unions are
+ * always discriminated, so distribute-and-recurse is sufficient (the discriminant
+ * literal widens to its base type, but the per-variant shape stays distinct and a
+ * concrete JSON value still matches exactly one variant).
+ */
+function _resolveJsonValues() {
+  _resolveJsonValues = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee2(source) {
+    var thunk, loaded, entries;
+    return _regenerator().w(function (_context2) {
+      while (1) switch (_context2.n) {
+        case 0:
+          if (!isJson(source)) {
+            _context2.n = 3;
+            break;
+          }
+          thunk = getJsonImport(source);
+          if (thunk) {
+            _context2.n = 1;
+            break;
+          }
+          return _context2.a(2, source);
+        case 1:
+          _context2.n = 2;
+          return thunk();
+        case 2:
+          loaded = _context2.v["default"];
+          return _context2.a(2, resolveJsonValues(loaded));
+        case 3:
+          if (!Array.isArray(source)) {
+            _context2.n = 4;
+            break;
+          }
+          return _context2.a(2, Promise.all(source.map(function (item) {
+            return resolveJsonValues(item);
+          })));
+        case 4:
+          if (!(source !== null && _typeof(source) === "object")) {
+            _context2.n = 7;
+            break;
+          }
+          if (!(VAL_EXTENSION in source)) {
+            _context2.n = 5;
+            break;
+          }
+          return _context2.a(2, source);
+        case 5:
+          _context2.n = 6;
+          return Promise.all(Object.entries(source).map(/*#__PURE__*/function () {
+            var _ref3 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee(_ref2) {
+              var _ref4, key, value, _t, _t2;
+              return _regenerator().w(function (_context) {
+                while (1) switch (_context.n) {
+                  case 0:
+                    _ref4 = _slicedToArray(_ref2, 2), key = _ref4[0], value = _ref4[1];
+                    _t = key;
+                    _context.n = 1;
+                    return resolveJsonValues(value);
+                  case 1:
+                    _t2 = _context.v;
+                    return _context.a(2, [_t, _t2]);
+                }
+              }, _callee);
+            }));
+            return function (_x2) {
+              return _ref3.apply(this, arguments);
+            };
+          }()));
+        case 6:
+          entries = _context2.v;
+          return _context2.a(2, Object.fromEntries(entries));
+        case 7:
+          return _context2.a(2, source);
+      }
+    }, _callee2);
+  }));
+  return _resolveJsonValues.apply(this, arguments);
+}
+
 var RegEx = /^(https?:\/\/[^/]+)\/file\/p\/([^/]+)\/b\/([^/]+)\/v\/([^/]+)\/h\/([^/]+)\/f\/([^/]+)\/p\/(.+)$/;
 function splitRemoteRef(ref) {
   if (ref[0] === "/") {
@@ -2935,6 +3333,20 @@ function splitRemoteRef(ref) {
   };
 }
 
+/**
+ * The source type of a `.jsonValues()` record: every entry value is EITHER a
+ * lazily loaded {@link JsonSource} whose resolved content is the (loosened, see
+ * {@link JsonOf}) item type, OR the item value written inline.
+ *
+ * Inline values are accepted by the TYPE on purpose: hand-authoring an entry
+ * directly in the `.val.ts` (or copying one in from a non-jsonValues record) is
+ * the natural first thing to write, and a type error there is a dead end — the
+ * author cannot see what to write instead. Validation reports the inline entry
+ * (`jsonValues:extract-entry`) and `val validate --fix` moves it into its own
+ * `*.val.json`, so the mistake is caught and repaired instead of blocking
+ * authoring.
+ */
+
 var RecordSchema = /*#__PURE__*/function (_Schema) {
   function RecordSchema(item) {
     var _this;
@@ -2946,7 +3358,8 @@ var RecordSchema = /*#__PURE__*/function (_Schema) {
     var isReadonly = arguments.length > 6 && arguments[6] !== undefined ? arguments[6] : false;
     var isHidden = arguments.length > 7 && arguments[7] !== undefined ? arguments[7] : false;
     var description = arguments.length > 8 ? arguments[8] : undefined;
-    var renderInput = arguments.length > 9 && arguments[9] !== undefined ? arguments[9] : null;
+    var isJsonValues = arguments.length > 9 && arguments[9] !== undefined ? arguments[9] : false;
+    var renderInput = arguments.length > 10 && arguments[10] !== undefined ? arguments[10] : null;
     _classCallCheck(this, RecordSchema);
     _this = _callSuper(this, RecordSchema);
     _this.item = item;
@@ -2958,6 +3371,7 @@ var RecordSchema = /*#__PURE__*/function (_Schema) {
     _this.isReadonly = isReadonly;
     _this.isHidden = isHidden;
     _this.description = description;
+    _this.isJsonValues = isJsonValues;
     _this.renderInput = renderInput;
     return _this;
   }
@@ -2965,12 +3379,12 @@ var RecordSchema = /*#__PURE__*/function (_Schema) {
   return _createClass(RecordSchema, [{
     key: "describe",
     value: function describe(description) {
-      return new RecordSchema(this.item, this.opt, this.customValidateFunctions, this.currentRouter, this.keySchema, this.mediaOptions, this.isReadonly, this.isHidden, description !== null && description !== void 0 ? description : undefined, this.renderInput);
+      return new RecordSchema(this.item, this.opt, this.customValidateFunctions, this.currentRouter, this.keySchema, this.mediaOptions, this.isReadonly, this.isHidden, description !== null && description !== void 0 ? description : undefined, this.isJsonValues, this.renderInput);
     }
   }, {
     key: "validate",
     value: function validate(validationFunction) {
-      return new RecordSchema(this.item, this.opt, [].concat(_toConsumableArray(this.customValidateFunctions), [validationFunction]), this.currentRouter, this.keySchema, this.mediaOptions, this.isReadonly, this.isHidden, this.description, this.renderInput);
+      return new RecordSchema(this.item, this.opt, [].concat(_toConsumableArray(this.customValidateFunctions), [validationFunction]), this.currentRouter, this.keySchema, this.mediaOptions, this.isReadonly, this.isHidden, this.description, this.isJsonValues, this.renderInput);
     }
   }, {
     key: "executeValidate",
@@ -3085,7 +3499,10 @@ var RecordSchema = /*#__PURE__*/function (_Schema) {
             _this2.markKeyErrorsAtPath(entryErr, subPath);
           }
           error = _this2.mergeValidationErrors(error, entryErr);
-        } else {
+        } else if (_this2.isJsonValues && isJson(elem)) ; else {
+          // Falls through for a jsonValues record whose entry content is inlined
+          // (loaded in the UI, or hand-authored): same as a plain record — validate
+          // the value against the item schema.
           var subError = _this2.item["executeValidate"](subPath, elem);
           error = _this2.mergeValidationErrors(error, subError);
         }
@@ -3326,29 +3743,61 @@ var RecordSchema = /*#__PURE__*/function (_Schema) {
   }, {
     key: "nullable",
     value: function nullable() {
-      return new RecordSchema(this.item, true, this.customValidateFunctions, this.currentRouter, this.keySchema, this.mediaOptions, this.isReadonly, this.isHidden, this.description, this.renderInput);
+      return new RecordSchema(this.item, true, this.customValidateFunctions, this.currentRouter, this.keySchema, this.mediaOptions, this.isReadonly, this.isHidden, this.description, this.isJsonValues, this.renderInput);
     }
   }, {
     key: "readonly",
     value: function readonly() {
-      return new RecordSchema(this.item, this.opt, this.customValidateFunctions, this.currentRouter, this.keySchema, this.mediaOptions, true, this.isHidden, this.description, this.renderInput);
+      return new RecordSchema(this.item, this.opt, this.customValidateFunctions, this.currentRouter, this.keySchema, this.mediaOptions, true, this.isHidden, this.description, this.isJsonValues, this.renderInput);
     }
   }, {
     key: "hidden",
     value: function hidden() {
-      return new RecordSchema(this.item, this.opt, this.customValidateFunctions, this.currentRouter, this.keySchema, this.mediaOptions, this.isReadonly, true, this.description, this.renderInput);
+      return new RecordSchema(this.item, this.opt, this.customValidateFunctions, this.currentRouter, this.keySchema, this.mediaOptions, this.isReadonly, true, this.description, this.isJsonValues, this.renderInput);
     }
   }, {
     key: "router",
     value: function router(_router) {
-      return new RecordSchema(this.item, this.opt, this.customValidateFunctions, _router, this.keySchema, this.mediaOptions, this.isReadonly, this.isHidden, this.description, this.renderInput);
+      return new RecordSchema(this.item, this.opt, this.customValidateFunctions, _router, this.keySchema, this.mediaOptions, this.isReadonly, this.isHidden, this.description, this.isJsonValues, this.renderInput);
     }
   }, {
     key: "remote",
     value: function remote() {
       return new RecordSchema(this.item, this.opt, this.customValidateFunctions, this.currentRouter, this.keySchema, this.mediaOptions ? _objectSpread2(_objectSpread2({}, this.mediaOptions), {}, {
         remote: true
-      }) : undefined, this.isReadonly, this.isHidden, this.description, this.renderInput);
+      }) : undefined, this.isReadonly, this.isHidden, this.description, this.isJsonValues, this.renderInput);
+    }
+
+    /**
+     * Store each entry's value in its own lazily-loaded `*.val.json` file instead
+     * of inlining it in the `.val.ts` module. Entry values become
+     * {@link JsonSource} thunks (`c.json(() => import("./entry.val.json"))`),
+     * which lets the runtime, the Studio and validation work one entry at a time
+     * so a record/router can scale to many thousands of entries.
+     *
+     * Not supported on image/file galleries (`s.images()` / `s.files()`).
+     *
+     * Only supported on a module's ROOT record/router — a `.jsonValues()` record
+     * nested inside an object/array/record is rejected at startup with a module
+     * error, because the single-entry fetch endpoint, the Studio's content
+     * substitution and content validation are all root-only.
+     */
+  }, {
+    key: "jsonValues",
+    value: function jsonValues() {
+      if (this.mediaOptions) {
+        throw new Error(".jsonValues() cannot be used with image/file galleries (s.images()/s.files())");
+      }
+      if (this.customValidateFunctions.length > 0) {
+        // `.jsonValues()` changes the source shape to JsonSource entries, so a
+        // validator typed against the previous Src cannot be carried over. Refusing
+        // is the point: silently dropping it left the developer looking at a
+        // `.validate(...)` in their source file that never ran anywhere.
+        throw new Error(".jsonValues() must come BEFORE .validate(): a validator added first is typed against the un-lazy source shape and cannot be carried over. Write s.record(...).jsonValues().validate(...) instead.");
+      }
+      return new RecordSchema(this.item, this.opt,
+      // Empty by construction: the guard above rejects any that were registered.
+      [], this.currentRouter, this.keySchema, this.mediaOptions, this.isReadonly, this.isHidden, this.description, true, this.renderInput);
     }
   }, {
     key: "getRouterValidations",
@@ -3392,6 +3841,13 @@ var RecordSchema = /*#__PURE__*/function (_Schema) {
       }
       return false;
     }
+  }, {
+    key: "executeCustomValidateAt",
+    value: function executeCustomValidateAt(path, src) {
+      return this.executeCustomValidateFunctions(src, this.customValidateFunctions, {
+        path: path
+      });
+    }
   }, {
     key: "executeSerialize",
     value: function executeSerialize() {
@@ -3403,6 +3859,7 @@ var RecordSchema = /*#__PURE__*/function (_Schema) {
         opt: this.opt,
         router: (_this$currentRouter = this.currentRouter) === null || _this$currentRouter === void 0 ? void 0 : _this$currentRouter.getRouterId(),
         customValidate: this.customValidateFunctions && ((_this$customValidateF = this.customValidateFunctions) === null || _this$customValidateF === void 0 ? void 0 : _this$customValidateF.length) > 0,
+        jsonValues: this.isJsonValues ? true : undefined,
         readonly: this.isReadonly,
         hidden: this.isHidden,
         description: this.description
@@ -3418,6 +3875,18 @@ var RecordSchema = /*#__PURE__*/function (_Schema) {
       }
       return result;
     }
+
+    /**
+     * Validate the loaded content of a single `.jsonValues()` entry against the
+     * item schema. The server calls this once it has loaded the backing
+     * `*.val.json` for an entry (the deep validation that `executeValidate`
+     * defers).
+     */
+  }, {
+    key: "validateJsonEntryContent",
+    value: function validateJsonEntryContent(path, content) {
+      return this.item["executeValidate"](path, content);
+    }
   }, {
     key: "executeRender",
     value: function executeRender(sourcePath, src) {
@@ -3430,6 +3899,13 @@ var RecordSchema = /*#__PURE__*/function (_Schema) {
         if (itemSrc === null || itemSrc === undefined) {
           continue;
         }
+        if (isJson(itemSrc)) {
+          // An un-loaded `.jsonValues()` entry: an opaque marker, not the item this
+          // schema describes. Skipping it is what makes rendering a partially
+          // loaded record work — the result comes out covering exactly the loaded
+          // keys, and the caller renders a placeholder for the rest.
+          continue;
+        }
         var subPath = unsafeCreateSourcePath(sourcePath, _key);
         var itemResult = this.item["executeRender"](subPath, itemSrc);
         for (var keyS in itemResult) {
@@ -3447,45 +3923,52 @@ var RecordSchema = /*#__PURE__*/function (_Schema) {
             message: "Unknown layout type: " + layout
           };
         }
-        try {
-          res[sourcePath] = {
-            status: "success",
-            data: {
-              layout: "list",
-              parent: "record",
-              items: Object.entries(src).map(function (_ref14) {
-                var _ref15 = _slicedToArray(_ref14, 2),
-                  key = _ref15[0],
-                  val = _ref15[1];
-                // NB NB: display is actually defined by the user
-                var _prepare = prepare({
-                    key: key,
-                    val: val
-                  }),
-                  title = _prepare.title,
-                  subtitle = _prepare.subtitle,
-                  image = _prepare.image;
-                return [key, {
-                  title: title,
-                  subtitle: subtitle,
-                  image: image
-                }];
-              })
-            }
-          };
-        } catch (e) {
-          res[sourcePath] = {
-            status: "error",
-            message: e instanceof Error ? e.message : "Unknown error"
-          };
+        var items = [];
+        for (var _i = 0, _Object$entries = Object.entries(src); _i < _Object$entries.length; _i++) {
+          var _Object$entries$_i = _slicedToArray(_Object$entries[_i], 2),
+            _key3 = _Object$entries$_i[0],
+            val = _Object$entries$_i[1];
+          if (isJson(val)) {
+            continue; // as above: nothing to select from an un-loaded entry
+          }
+          // Per KEY, not per record: `select` is user code, and one entry whose
+          // data trips it up must not take out the whole list.
+          try {
+            // NB NB: display is actually defined by the user
+            var _prepare = prepare({
+                key: _key3,
+                val: val
+              }),
+              title = _prepare.title,
+              subtitle = _prepare.subtitle,
+              image = _prepare.image;
+            items.push([_key3, {
+              title: title,
+              subtitle: subtitle,
+              image: image
+            }]);
+          } catch (e) {
+            res[unsafeCreateSourcePath(sourcePath, _key3)] = {
+              status: "error",
+              message: e instanceof Error ? e.message : "Unknown error"
+            };
+          }
         }
+        res[sourcePath] = {
+          status: "success",
+          data: {
+            layout: "list",
+            parent: "record",
+            items: items
+          }
+        };
       }
       return res;
     }
   }, {
     key: "render",
     value: function render(input) {
-      return new RecordSchema(this.item, this.opt, this.customValidateFunctions, this.currentRouter, this.keySchema, this.mediaOptions, this.isReadonly, this.isHidden, this.description, {
+      return new RecordSchema(this.item, this.opt, this.customValidateFunctions, this.currentRouter, this.keySchema, this.mediaOptions, this.isReadonly, this.isHidden, this.description, this.isJsonValues, {
         layout: input.as,
         select: input.select
       });
@@ -3603,6 +4086,13 @@ function resolvePath(path, valModule, schema) {
         }
         resolvedSource = resolvedSource[part];
         resolvedSchema = resolvedSchema instanceof RecordSchema ? (_resolvedSchema2 = resolvedSchema) === null || _resolvedSchema2 === void 0 ? void 0 : _resolvedSchema2["item"] : resolvedSchema.item;
+        // A `.jsonValues()` entry value is a lazily-loaded JsonSource marker. We
+        // can resolve the entry itself (schema is now `item`), but we cannot
+        // descend deeper until the backing `*.val.json` content has been loaded
+        // and substituted into the source tree (done by the UI/server layer).
+        if (isJson(resolvedSource) && parts.length > 0) {
+          throw Error("Cannot resolve path into a jsonValues entry until its content is loaded. Path: ".concat(path));
+        }
       } else if (isObjectSchema(resolvedSchema)) {
         if (_typeof(resolvedSource) !== "object") {
           throw Error("Schema type error: expected source to be type of object, but got ".concat(_typeof(resolvedSource)));
@@ -3807,6 +4297,16 @@ function safeResolvePath(path, valModule, schema) {
         }
         resolvedSource = resolvedSource[part];
         resolvedSchema = resolvedSchema instanceof RecordSchema ? (_resolvedSchema4 = resolvedSchema) === null || _resolvedSchema4 === void 0 ? void 0 : _resolvedSchema4["item"] : resolvedSchema.item;
+        // jsonValues entry: cannot descend deeper until the backing `*.val.json`
+        // content is loaded into the source tree.
+        if (isJson(resolvedSource) && parts.length > 0) {
+          return {
+            v: {
+              status: "error",
+              message: "Cannot resolve path into a jsonValues entry until its content is loaded. Path: ".concat(path)
+            }
+          };
+        }
       } else if (isObjectSchema(resolvedSchema)) {
         if (resolvedSource === undefined) {
           return {
@@ -4142,6 +4642,13 @@ var NumberSchema = /*#__PURE__*/function (_Schema) {
         min: _min
       }), this.opt, this.customValidateFunctions, this.isReadonly, this.isHidden, this.description);
     }
+  }, {
+    key: "executeCustomValidateAt",
+    value: function executeCustomValidateAt(path, src) {
+      return this.executeCustomValidateFunctions(src, this.customValidateFunctions, {
+        path: path
+      });
+    }
   }, {
     key: "executeSerialize",
     value: function executeSerialize() {
@@ -4256,6 +4763,13 @@ var BooleanSchema = /*#__PURE__*/function (_Schema) {
     value: function hidden() {
       return new BooleanSchema(this.opt, this.customValidateFunctions, this.isReadonly, true, this.description);
     }
+  }, {
+    key: "executeCustomValidateAt",
+    value: function executeCustomValidateAt(path, src) {
+      return this.executeCustomValidateFunctions(src, this.customValidateFunctions, {
+        path: path
+      });
+    }
   }, {
     key: "executeSerialize",
     value: function executeSerialize() {
@@ -4450,6 +4964,13 @@ var KeyOfSchema = /*#__PURE__*/function (_Schema) {
     value: function hidden() {
       return new KeyOfSchema(this.schema, this.sourcePath, this.opt, this.customValidateFunctions, this.isReadonly, true, this.description);
     }
+  }, {
+    key: "executeCustomValidateAt",
+    value: function executeCustomValidateAt(path, src) {
+      return this.executeCustomValidateFunctions(src, this.customValidateFunctions, {
+        path: path
+      });
+    }
   }, {
     key: "executeSerialize",
     value: function executeSerialize() {
@@ -4695,6 +5216,13 @@ var DateSchema = /*#__PURE__*/function (_Schema) {
     value: function hidden() {
       return new DateSchema(this.options, this.opt, this.customValidateFunctions, this.isReadonly, true, this.description);
     }
+  }, {
+    key: "executeCustomValidateAt",
+    value: function executeCustomValidateAt(path, src) {
+      return this.executeCustomValidateFunctions(src, this.customValidateFunctions, {
+        path: path
+      });
+    }
   }, {
     key: "executeSerialize",
     value: function executeSerialize() {
@@ -4892,6 +5420,13 @@ var DateTimeSchema = /*#__PURE__*/function (_Schema) {
     value: function hidden() {
       return new DateTimeSchema(this.options, this.opt, this.customValidateFunctions, this.isReadonly, true, this.description);
     }
+  }, {
+    key: "executeCustomValidateAt",
+    value: function executeCustomValidateAt(path, src) {
+      return this.executeCustomValidateFunctions(src, this.customValidateFunctions, {
+        path: path
+      });
+    }
   }, {
     key: "executeSerialize",
     value: function executeSerialize() {
@@ -5133,7 +5668,8 @@ var initVal = function initVal(config) {
       define: define,
       remote: initRemote(),
       file: initFile(config),
-      image: initImage(config)
+      image: initImage(config),
+      json: json
     },
     s: s,
     config: config
@@ -5160,142 +5696,6 @@ function modules(config, modules) {
   };
 }
 
-function _regeneratorDefine(e, r, n, t) {
-  var i = Object.defineProperty;
-  try {
-    i({}, "", {});
-  } catch (e) {
-    i = 0;
-  }
-  _regeneratorDefine = function (e, r, n, t) {
-    function o(r, n) {
-      _regeneratorDefine(e, r, function (e) {
-        return this._invoke(r, n, e);
-      });
-    }
-    r ? i ? i(e, r, {
-      value: n,
-      enumerable: !t,
-      configurable: !t,
-      writable: !t
-    }) : e[r] = n : (o("next", 0), o("throw", 1), o("return", 2));
-  }, _regeneratorDefine(e, r, n, t);
-}
-
-function _regenerator() {
-  /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/babel/babel/blob/main/packages/babel-helpers/LICENSE */
-  var e,
-    t,
-    r = "function" == typeof Symbol ? Symbol : {},
-    n = r.iterator || "@@iterator",
-    o = r.toStringTag || "@@toStringTag";
-  function i(r, n, o, i) {
-    var c = n && n.prototype instanceof Generator ? n : Generator,
-      u = Object.create(c.prototype);
-    return _regeneratorDefine(u, "_invoke", function (r, n, o) {
-      var i,
-        c,
-        u,
-        f = 0,
-        p = o || [],
-        y = !1,
-        G = {
-          p: 0,
-          n: 0,
-          v: e,
-          a: d,
-          f: d.bind(e, 4),
-          d: function (t, r) {
-            return i = t, c = 0, u = e, G.n = r, a;
-          }
-        };
-      function d(r, n) {
-        for (c = r, u = n, t = 0; !y && f && !o && t < p.length; t++) {
-          var o,
-            i = p[t],
-            d = G.p,
-            l = i[2];
-          r > 3 ? (o = l === n) && (u = i[(c = i[4]) ? 5 : (c = 3, 3)], i[4] = i[5] = e) : i[0] <= d && ((o = r < 2 && d < i[1]) ? (c = 0, G.v = n, G.n = i[1]) : d < l && (o = r < 3 || i[0] > n || n > l) && (i[4] = r, i[5] = n, G.n = l, c = 0));
-        }
-        if (o || r > 1) return a;
-        throw y = !0, n;
-      }
-      return function (o, p, l) {
-        if (f > 1) throw TypeError("Generator is already running");
-        for (y && 1 === p && d(p, l), c = p, u = l; (t = c < 2 ? e : u) || !y;) {
-          i || (c ? c < 3 ? (c > 1 && (G.n = -1), d(c, u)) : G.n = u : G.v = u);
-          try {
-            if (f = 2, i) {
-              if (c || (o = "next"), t = i[o]) {
-                if (!(t = t.call(i, u))) throw TypeError("iterator result is not an object");
-                if (!t.done) return t;
-                u = t.value, c < 2 && (c = 0);
-              } else 1 === c && (t = i.return) && t.call(i), c < 2 && (u = TypeError("The iterator does not provide a '" + o + "' method"), c = 1);
-              i = e;
-            } else if ((t = (y = G.n < 0) ? u : r.call(n, G)) !== a) break;
-          } catch (t) {
-            i = e, c = 1, u = t;
-          } finally {
-            f = 1;
-          }
-        }
-        return {
-          value: t,
-          done: y
-        };
-      };
-    }(r, o, i), !0), u;
-  }
-  var a = {};
-  function Generator() {}
-  function GeneratorFunction() {}
-  function GeneratorFunctionPrototype() {}
-  t = Object.getPrototypeOf;
-  var c = [][n] ? t(t([][n]())) : (_regeneratorDefine(t = {}, n, function () {
-      return this;
-    }), t),
-    u = GeneratorFunctionPrototype.prototype = Generator.prototype = Object.create(c);
-  function f(e) {
-    return Object.setPrototypeOf ? Object.setPrototypeOf(e, GeneratorFunctionPrototype) : (e.__proto__ = GeneratorFunctionPrototype, _regeneratorDefine(e, o, "GeneratorFunction")), e.prototype = Object.create(u), e;
-  }
-  return GeneratorFunction.prototype = GeneratorFunctionPrototype, _regeneratorDefine(u, "constructor", GeneratorFunctionPrototype), _regeneratorDefine(GeneratorFunctionPrototype, "constructor", GeneratorFunction), GeneratorFunction.displayName = "GeneratorFunction", _regeneratorDefine(GeneratorFunctionPrototype, o, "GeneratorFunction"), _regeneratorDefine(u), _regeneratorDefine(u, o, "Generator"), _regeneratorDefine(u, n, function () {
-    return this;
-  }), _regeneratorDefine(u, "toString", function () {
-    return "[object Generator]";
-  }), (_regenerator = function () {
-    return {
-      w: i,
-      m: f
-    };
-  })();
-}
-
-function asyncGeneratorStep(n, t, e, r, o, a, c) {
-  try {
-    var i = n[a](c),
-      u = i.value;
-  } catch (n) {
-    return void e(n);
-  }
-  i.done ? t(u) : Promise.resolve(u).then(r, o);
-}
-function _asyncToGenerator(n) {
-  return function () {
-    var t = this,
-      e = arguments;
-    return new Promise(function (r, o) {
-      var a = n.apply(t, e);
-      function _next(n) {
-        asyncGeneratorStep(a, r, o, _next, _throw, "next", n);
-      }
-      function _throw(n) {
-        asyncGeneratorStep(a, r, o, _next, _throw, "throw", n);
-      }
-      _next(void 0);
-    });
-  };
-}
-
 /**
  * From: https://github.com/kawanet/sha256-uint8array/commit/a035f83824c319d01ca1e7559fdcf1632c0cd6c4
  *
@@ -6795,7 +7195,7 @@ function deserializeSchema(serialized) {
   return schema;
 }
 function deserializeSchemaImpl(serialized) {
-  var _serialized$options, _serialized$options2, _serialized$accept, _serialized$directory, _serialized$remote;
+  var _serialized$options, _serialized$options2, _serialized$accept, _serialized$directory, _serialized$remote, _serialized$jsonValue;
   switch (serialized.type) {
     case "string":
       return new StringSchema(_objectSpread2(_objectSpread2({}, serialized.options), {}, {
@@ -6844,7 +7244,7 @@ function deserializeSchemaImpl(serialized) {
         directory: (_serialized$directory = serialized.directory) !== null && _serialized$directory !== void 0 ? _serialized$directory : "/public/val",
         remote: (_serialized$remote = serialized.remote) !== null && _serialized$remote !== void 0 ? _serialized$remote : false,
         altSchema: serialized.alt ? deserializeSchema(serialized.alt) : undefined
-      } : undefined, false, false, serialized.description);
+      } : undefined, false, false, serialized.description, (_serialized$jsonValue = serialized.jsonValues) !== null && _serialized$jsonValue !== void 0 ? _serialized$jsonValue : false);
     case "keyOf":
       return new KeyOfSchema(serialized.schema, serialized.path, serialized.opt, [], false, false, serialized.description);
     case "route":
@@ -7163,6 +7563,9 @@ var Internal = {
   },
   isVal: isVal,
   isFile: isFile,
+  isJson: isJson,
+  getJsonImport: getJsonImport,
+  resolveJsonValues: resolveJsonValues,
   createValPathOfItem: createValPathOfItem,
   getSHA256Hash: getSHA256Hash,
   initSchema: initSchema,