@valbuild/core 0.99.1 → 0.101.0

package/dist/{index-28d99c34.cjs.prod.js → index-049780fa.cjs.prod.js}

@@ -654,6 +654,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() {
@@ -902,6 +909,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() {
@@ -1118,6 +1132,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() {
@@ -1277,6 +1298,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() {
@@ -1465,6 +1493,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() {
@@ -1823,6 +1858,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 = result._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() {
@@ -2134,6 +2227,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() {
@@ -2309,6 +2409,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() {
@@ -2847,6 +2954,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() {
@@ -2896,6 +3010,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] === "/") {
@@ -2937,6 +3335,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;
@@ -2948,7 +3360,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;
@@ -2960,6 +3373,7 @@ var RecordSchema = /*#__PURE__*/function (_Schema) {
     _this.isReadonly = isReadonly;
     _this.isHidden = isHidden;
     _this.description = description;
+    _this.isJsonValues = isJsonValues;
     _this.renderInput = renderInput;
     return _this;
   }
@@ -2967,12 +3381,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",
@@ -3087,7 +3501,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);
         }
@@ -3328,32 +3745,64 @@ 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: "getRouterValidations",
+    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",
     value: function getRouterValidations(path, src) {
       if (!this.currentRouter) {
         return false;
@@ -3394,6 +3843,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() {
@@ -3405,6 +3861,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
@@ -3420,6 +3877,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) {
@@ -3432,6 +3901,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) {
@@ -3449,45 +3925,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
       });
@@ -3605,6 +4088,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)));
@@ -3809,6 +4299,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 {
@@ -4144,6 +4644,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() {
@@ -4258,6 +4765,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() {
@@ -4452,6 +4966,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() {
@@ -4697,6 +5218,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() {
@@ -4894,6 +5422,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() {
@@ -4919,6 +5454,647 @@ var datetime = function datetime(options) {
   return new DateTimeSchema(options);
 };
 
+/**
+ * Parsing / formatting of the CSS color strings stored by `s.color()`.
+ *
+ * Colors are stored as plain CSS strings so that they can be used directly in
+ * `style` attributes and CSS custom properties. The schema decides which family
+ * (`hex`, `rgb`, `hsl` or `oklch`) the string is written in, this module does
+ * the conversion between them.
+ *
+ * All colors are sRGB: `oklch` is only used as an output notation, so any
+ * `oklch` value that falls outside the sRGB gamut is clipped when converted
+ * back to the other formats.
+ */
+
+var COLOR_FORMATS = ["hex", "rgb", "hsl", "oklch"];
+var DEFAULT_COLOR_FORMAT = "hsl";
+
+/**
+ * A color, normalized to sRGB.
+ *
+ * `r`, `g` and `b` are 0-255 (not rounded), `a` is 0-1.
+ */
+
+/**
+ * Which color notation a string uses, or `null` if it is not a notation we
+ * recognize. This looks at the syntax only: `detectColorFormat` says nothing
+ * about whether the value actually parses (`hsl(nope)` is still `"hsl"`).
+ */
+function detectColorFormat(value) {
+  var trimmed = value.trim().toLowerCase();
+  if (trimmed.startsWith("#")) {
+    return "hex";
+  }
+  if (trimmed.startsWith("rgb(") || trimmed.startsWith("rgba(")) {
+    return "rgb";
+  }
+  if (trimmed.startsWith("hsl(") || trimmed.startsWith("hsla(")) {
+    return "hsl";
+  }
+  if (trimmed.startsWith("oklch(")) {
+    return "oklch";
+  }
+  return null;
+}
+function clamp(value, min, max) {
+  if (Number.isNaN(value)) {
+    return min;
+  }
+  return Math.min(max, Math.max(min, value));
+}
+
+/**
+ * Splits the inside of a CSS color function into components.
+ *
+ * Handles both the legacy comma syntax (`rgb(1, 2, 3, 0.5)`) and the modern
+ * space syntax (`rgb(1 2 3 / 0.5)`), returning the alpha (if any) separately.
+ */
+function splitComponents(args) {
+  var slashParts = args.split("/");
+  if (slashParts.length > 2) {
+    return null;
+  }
+  var alpha = slashParts.length === 2 ? slashParts[1].trim() : null;
+  var head = slashParts[0].trim();
+  if (head === "") {
+    return null;
+  }
+  var components;
+  if (head.includes(",")) {
+    if (alpha !== null) {
+      // Mixing the comma and the slash syntax is not valid CSS
+      return null;
+    }
+    components = head.split(",").map(function (part) {
+      return part.trim();
+    });
+    if (components.length === 4) {
+      alpha = components[3];
+      components = components.slice(0, 3);
+    }
+  } else {
+    components = head.split(/\s+/);
+  }
+  if (components.length !== 3 || components.some(function (part) {
+    return part === "";
+  })) {
+    return null;
+  }
+  if (alpha === "") {
+    return null;
+  }
+  return {
+    components: components,
+    alpha: alpha
+  };
+}
+function parseNumber(value) {
+  if (!/^[+-]?(\d+\.?\d*|\.\d+)$/.test(value)) {
+    return null;
+  }
+  var parsed = Number(value);
+  return Number.isFinite(parsed) ? parsed : null;
+}
+
+/**
+ * A `<number>` or a `<percentage>`, where 100% maps to `percentageBasis`.
+ */
+function parseNumberOrPercentage(value, percentageBasis) {
+  if (value.endsWith("%")) {
+    var percentage = parseNumber(value.slice(0, -1));
+    return percentage === null ? null : percentage / 100 * percentageBasis;
+  }
+  return parseNumber(value);
+}
+function parsePercentage(value) {
+  if (!value.endsWith("%")) {
+    return null;
+  }
+  return parseNumber(value.slice(0, -1));
+}
+function parseAlpha(value) {
+  if (value === null) {
+    return 1;
+  }
+  if (value === "none") {
+    return 0;
+  }
+  var parsed = parseNumberOrPercentage(value, 1);
+  return parsed === null ? null : clamp(parsed, 0, 1);
+}
+function parseHue(value) {
+  var match = /^([+-]?(?:\d+\.?\d*|\.\d+))(deg|grad|rad|turn)?$/.exec(value);
+  if (!match) {
+    return null;
+  }
+  var amount = Number(match[1]);
+  switch (match[2]) {
+    case "grad":
+      return amount / 400 * 360;
+    case "rad":
+      return amount * 180 / Math.PI;
+    case "turn":
+      return amount * 360;
+    default:
+      return amount;
+  }
+}
+function normalizeHue(hue) {
+  var wrapped = hue % 360;
+  return wrapped < 0 ? wrapped + 360 : wrapped;
+}
+function parseHex(value) {
+  var hex = value.slice(1);
+  if (!/^[0-9a-f]+$/i.test(hex)) {
+    return null;
+  }
+  var expand = function expand(_char) {
+    return parseInt(_char + _char, 16);
+  };
+  var pair = function pair(index) {
+    return parseInt(hex.slice(index, index + 2), 16);
+  };
+  if (hex.length === 3 || hex.length === 4) {
+    return {
+      r: expand(hex[0]),
+      g: expand(hex[1]),
+      b: expand(hex[2]),
+      a: hex.length === 4 ? expand(hex[3]) / 255 : 1
+    };
+  }
+  if (hex.length === 6 || hex.length === 8) {
+    return {
+      r: pair(0),
+      g: pair(2),
+      b: pair(4),
+      a: hex.length === 8 ? pair(6) / 255 : 1
+    };
+  }
+  return null;
+}
+function extractFunctionArgs(value, name) {
+  if (!value.startsWith(name + "(") || !value.endsWith(")")) {
+    return null;
+  }
+  return value.slice(name.length + 1, -1);
+}
+function parseRgb(value) {
+  var _extractFunctionArgs;
+  var args = (_extractFunctionArgs = extractFunctionArgs(value, "rgba")) !== null && _extractFunctionArgs !== void 0 ? _extractFunctionArgs : extractFunctionArgs(value, "rgb");
+  if (args === null) {
+    return null;
+  }
+  var split = splitComponents(args);
+  if (!split) {
+    return null;
+  }
+  var channels = split.components.map(function (component) {
+    return component === "none" ? 0 : parseNumberOrPercentage(component, 255);
+  });
+  var alpha = parseAlpha(split.alpha);
+  if (channels.some(function (channel) {
+    return channel === null;
+  }) || alpha === null) {
+    return null;
+  }
+  return {
+    r: clamp(channels[0], 0, 255),
+    g: clamp(channels[1], 0, 255),
+    b: clamp(channels[2], 0, 255),
+    a: alpha
+  };
+}
+function parseHsl(value) {
+  var _extractFunctionArgs2, _parsePercentage, _parsePercentage2;
+  var args = (_extractFunctionArgs2 = extractFunctionArgs(value, "hsla")) !== null && _extractFunctionArgs2 !== void 0 ? _extractFunctionArgs2 : extractFunctionArgs(value, "hsl");
+  if (args === null) {
+    return null;
+  }
+  var split = splitComponents(args);
+  if (!split) {
+    return null;
+  }
+  var _split$components = _slicedToArray(split.components, 3),
+    rawHue = _split$components[0],
+    rawSaturation = _split$components[1],
+    rawLightness = _split$components[2];
+  var hue = rawHue === "none" ? 0 : parseHue(rawHue);
+  // CSS requires percentages for s/l in hsl(), but the modern syntax also
+  // allows bare numbers, so accept both.
+  var saturation = rawSaturation === "none" ? 0 : (_parsePercentage = parsePercentage(rawSaturation)) !== null && _parsePercentage !== void 0 ? _parsePercentage : parseNumber(rawSaturation);
+  var lightness = rawLightness === "none" ? 0 : (_parsePercentage2 = parsePercentage(rawLightness)) !== null && _parsePercentage2 !== void 0 ? _parsePercentage2 : parseNumber(rawLightness);
+  var alpha = parseAlpha(split.alpha);
+  if (hue === null || saturation === null || lightness === null || alpha === null) {
+    return null;
+  }
+  return _objectSpread2(_objectSpread2({}, hslToRgb(normalizeHue(hue), clamp(saturation, 0, 100), clamp(lightness, 0, 100))), {}, {
+    a: alpha
+  });
+}
+function parseOklch(value) {
+  var args = extractFunctionArgs(value, "oklch");
+  if (args === null) {
+    return null;
+  }
+  var split = splitComponents(args);
+  if (!split) {
+    return null;
+  }
+  var _split$components2 = _slicedToArray(split.components, 3),
+    rawLightness = _split$components2[0],
+    rawChroma = _split$components2[1],
+    rawHue = _split$components2[2];
+  // Lightness is a <number> in 0-1 or a <percentage>, chroma is a <number>
+  // where 0.4 is roughly the maximum, or a <percentage> where 100% = 0.4.
+  var lightness = rawLightness === "none" ? 0 : parseNumberOrPercentage(rawLightness, 1);
+  var chroma = rawChroma === "none" ? 0 : parseNumberOrPercentage(rawChroma, 0.4);
+  var hue = rawHue === "none" ? 0 : parseHue(rawHue);
+  var alpha = parseAlpha(split.alpha);
+  if (lightness === null || chroma === null || hue === null || alpha === null) {
+    return null;
+  }
+  return _objectSpread2(_objectSpread2({}, oklchToRgb(clamp(lightness, 0, 1), Math.max(0, chroma), normalizeHue(hue))), {}, {
+    a: alpha
+  });
+}
+
+/**
+ * Parses a CSS color string into sRGB channels.
+ *
+ * Accepts hex (3, 4, 6 and 8 digits), `rgb()` / `rgba()`, `hsl()` / `hsla()`
+ * and `oklch()`, in both the legacy comma and the modern space syntax. Returns
+ * `null` if the value is not a color we can parse - notably: named colors
+ * (`red`), `color()`, `lab()` and `color-mix()` are not supported.
+ */
+function parseColor(value) {
+  var normalized = value.trim().toLowerCase();
+  if (normalized === "") {
+    return null;
+  }
+  switch (detectColorFormat(normalized)) {
+    case "hex":
+      return parseHex(normalized);
+    case "rgb":
+      return parseRgb(normalized);
+    case "hsl":
+      return parseHsl(normalized);
+    case "oklch":
+      return parseOklch(normalized);
+    default:
+      return null;
+  }
+}
+
+/**
+ * Rounds to at most `decimals` decimals, without trailing zeros.
+ */
+function round(value, decimals) {
+  var factor = Math.pow(10, decimals);
+  // `|| 0` normalizes -0 to 0
+  return Math.round(value * factor) / factor || 0;
+}
+function toHexPair(value) {
+  return clamp(Math.round(value), 0, 255).toString(16).padStart(2, "0");
+}
+function rgbToHsl(r, g, b) {
+  var red = r / 255;
+  var green = g / 255;
+  var blue = b / 255;
+  var max = Math.max(red, green, blue);
+  var min = Math.min(red, green, blue);
+  var delta = max - min;
+  var l = (max + min) / 2;
+  if (delta === 0) {
+    return {
+      h: 0,
+      s: 0,
+      l: l * 100
+    };
+  }
+  var s = delta / (1 - Math.abs(2 * l - 1));
+  var h;
+  if (max === red) {
+    h = (green - blue) / delta % 6;
+  } else if (max === green) {
+    h = (blue - red) / delta + 2;
+  } else {
+    h = (red - green) / delta + 4;
+  }
+  return {
+    h: normalizeHue(h * 60),
+    s: s * 100,
+    l: l * 100
+  };
+}
+function hslToRgb(h, s, l) {
+  var saturation = s / 100;
+  var lightness = l / 100;
+  var c = (1 - Math.abs(2 * lightness - 1)) * saturation;
+  var hPrime = normalizeHue(h) / 60;
+  var x = c * (1 - Math.abs(hPrime % 2 - 1));
+  var m = lightness - c / 2;
+  var rgb;
+  if (hPrime < 1) {
+    rgb = [c, x, 0];
+  } else if (hPrime < 2) {
+    rgb = [x, c, 0];
+  } else if (hPrime < 3) {
+    rgb = [0, c, x];
+  } else if (hPrime < 4) {
+    rgb = [0, x, c];
+  } else if (hPrime < 5) {
+    rgb = [x, 0, c];
+  } else {
+    rgb = [c, 0, x];
+  }
+  return {
+    r: (rgb[0] + m) * 255,
+    g: (rgb[1] + m) * 255,
+    b: (rgb[2] + m) * 255
+  };
+}
+function srgbToLinear(channel) {
+  var c = channel / 255;
+  return c <= 0.04045 ? c / 12.92 : Math.pow((c + 0.055) / 1.055, 2.4);
+}
+function linearToSrgb(channel) {
+  var c = channel <= 0.0031308 ? channel * 12.92 : 1.055 * Math.pow(channel, 1 / 2.4) - 0.055;
+  return clamp(c * 255, 0, 255);
+}
+
+/**
+ * sRGB to Oklch, using Björn Ottosson's Oklab matrices.
+ */
+function rgbToOklch(r, g, b) {
+  var lr = srgbToLinear(r);
+  var lg = srgbToLinear(g);
+  var lb = srgbToLinear(b);
+  var _long = Math.cbrt(0.4122214708 * lr + 0.5363325363 * lg + 0.0514459929 * lb);
+  var medium = Math.cbrt(0.2119034982 * lr + 0.6806995451 * lg + 0.1073969566 * lb);
+  var _short = Math.cbrt(0.0883024619 * lr + 0.2817188376 * lg + 0.6299787005 * lb);
+  var lightness = 0.2104542553 * _long + 0.793617785 * medium - 0.0040720468 * _short;
+  var a = 1.9779984951 * _long - 2.428592205 * medium + 0.4505937099 * _short;
+  var bComponent = 0.0259040371 * _long + 0.7827717662 * medium - 0.808675766 * _short;
+  var chroma = Math.sqrt(a * a + bComponent * bComponent);
+  // Achromatic colors have an undefined hue: report 0 rather than the noise
+  // that atan2 of two near-zero numbers produces.
+  var hue = chroma < 1e-6 ? 0 : normalizeHue(Math.atan2(bComponent, a) * 180 / Math.PI);
+  return {
+    l: clamp(lightness, 0, 1),
+    c: chroma,
+    h: hue
+  };
+}
+
+/**
+ * Oklch to sRGB. Out of gamut colors are clipped per channel.
+ */
+function oklchToRgb(l, c, h) {
+  var hueRadians = normalizeHue(h) * Math.PI / 180;
+  var a = c * Math.cos(hueRadians);
+  var bComponent = c * Math.sin(hueRadians);
+  var _long2 = Math.pow(l + 0.3963377774 * a + 0.2158037573 * bComponent, 3);
+  var medium = Math.pow(l - 0.1055613458 * a - 0.0638541728 * bComponent, 3);
+  var _short2 = Math.pow(l - 0.0894841775 * a - 1.291485548 * bComponent, 3);
+  return {
+    r: linearToSrgb(4.0767416621 * _long2 - 3.3077115913 * medium + 0.2309699292 * _short2),
+    g: linearToSrgb(-1.2684380046 * _long2 + 2.6097574011 * medium - 0.3413193965 * _short2),
+    b: linearToSrgb(-0.0041960863 * _long2 - 0.7034186147 * medium + 1.707614701 * _short2)
+  };
+}
+
+/**
+ * Serializes a color to the canonical string of the given format.
+ *
+ * The modern, space separated CSS syntax is used for the color functions
+ * (`rgb(255 0 0 / 0.5)`). Alpha is only included when it is not fully opaque.
+ */
+function formatColor(color, format) {
+  var alpha = clamp(color.a, 0, 1);
+  var alphaSuffix = alpha >= 1 ? "" : " / ".concat(round(alpha, 4));
+  switch (format) {
+    case "hex":
+      {
+        var hex = "#".concat(toHexPair(color.r)).concat(toHexPair(color.g)).concat(toHexPair(color.b));
+        return alpha >= 1 ? hex : "".concat(hex).concat(toHexPair(alpha * 255));
+      }
+    case "rgb":
+      {
+        var r = clamp(Math.round(color.r), 0, 255);
+        var g = clamp(Math.round(color.g), 0, 255);
+        var b = clamp(Math.round(color.b), 0, 255);
+        return "rgb(".concat(r, " ").concat(g, " ").concat(b).concat(alphaSuffix, ")");
+      }
+    case "hsl":
+      {
+        var _rgbToHsl = rgbToHsl(color.r, color.g, color.b),
+          h = _rgbToHsl.h,
+          s = _rgbToHsl.s,
+          l = _rgbToHsl.l;
+        return "hsl(".concat(round(h, 2), " ").concat(round(s, 2), "% ").concat(round(l, 2), "%").concat(alphaSuffix, ")");
+      }
+    case "oklch":
+      {
+        var _rgbToOklch = rgbToOklch(color.r, color.g, color.b),
+          _l = _rgbToOklch.l,
+          c = _rgbToOklch.c,
+          _h = _rgbToOklch.h;
+        return "oklch(".concat(round(_l, 4), " ").concat(round(c, 4), " ").concat(round(_h, 2)).concat(alphaSuffix, ")");
+      }
+  }
+}
+
+/**
+ * Converts a color string to the canonical string of the given format, or
+ * `null` if the input cannot be parsed.
+ */
+function convertColor(value, format) {
+  var parsed = parseColor(value);
+  if (parsed === null) {
+    return null;
+  }
+  return formatColor(parsed, format);
+}
+
+/**
+ * `#rrggbb`, which is what `<input type="color">` uses as its value.
+ */
+function colorToHex(color) {
+  return "#".concat(toHexPair(color.r)).concat(toHexPair(color.g)).concat(toHexPair(color.b));
+}
+
+/**
+ * An example of the canonical output of each format, used in error messages so
+ * that the expected syntax is obvious from the error alone.
+ */
+var FORMAT_EXAMPLES = {
+  hex: "#3b82f6",
+  rgb: "rgb(59 130 246)",
+  hsl: "hsl(217.22 91.22% 59.8%)",
+  oklch: "oklch(0.6231 0.188 259.81)"
+};
+var ColorSchema = /*#__PURE__*/function (_Schema) {
+  function ColorSchema(options) {
+    var _this;
+    var opt = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : false;
+    var customValidateFunctions = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : [];
+    var isReadonly = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : false;
+    var isHidden = arguments.length > 4 && arguments[4] !== undefined ? arguments[4] : false;
+    var description = arguments.length > 5 ? arguments[5] : undefined;
+    _classCallCheck(this, ColorSchema);
+    _this = _callSuper(this, ColorSchema);
+    _this.options = options;
+    _this.opt = opt;
+    _this.customValidateFunctions = customValidateFunctions;
+    _this.isReadonly = isReadonly;
+    _this.isHidden = isHidden;
+    _this.description = description;
+    return _this;
+  }
+  _inherits(ColorSchema, _Schema);
+  return _createClass(ColorSchema, [{
+    key: "describe",
+    value: function describe(description) {
+      return new ColorSchema(this.options, this.opt, this.customValidateFunctions, this.isReadonly, this.isHidden, description !== null && description !== void 0 ? description : undefined);
+    }
+  }, {
+    key: "validate",
+    value: function validate(validationFunction) {
+      return new ColorSchema(this.options, this.opt, [].concat(_toConsumableArray(this.customValidateFunctions), [validationFunction]), this.isReadonly, this.isHidden, this.description);
+    }
+  }, {
+    key: "executeCustomValidateAt",
+    value: function executeCustomValidateAt(path, src) {
+      return this.executeCustomValidateFunctions(src, this.customValidateFunctions, {
+        path: path
+      });
+    }
+  }, {
+    key: "executeValidate",
+    value: function executeValidate(path, src) {
+      var _this$options$format, _this$options;
+      var errors = this.executeCustomValidateFunctions(src, this.customValidateFunctions, {
+        path: path
+      });
+      if (this.opt && (src === null || src === undefined)) {
+        return errors.length > 0 ? _defineProperty({}, path, errors) : false;
+      }
+      if (typeof src !== "string") {
+        errors.push({
+          message: "Expected 'string', got '".concat(_typeof(src), "'"),
+          value: src
+        });
+        return _defineProperty({}, path, errors);
+      }
+      var expectedFormat = (_this$options$format = (_this$options = this.options) === null || _this$options === void 0 ? void 0 : _this$options.format) !== null && _this$options$format !== void 0 ? _this$options$format : DEFAULT_COLOR_FORMAT;
+      var parsed = parseColor(src);
+      if (parsed === null) {
+        errors.push({
+          message: "Invalid color: '".concat(src, "'. Expected a CSS color in the '").concat(expectedFormat, "' format (e.g. '").concat(FORMAT_EXAMPLES[expectedFormat], "')"),
+          value: src
+        });
+      } else {
+        var _this$options3;
+        var actualFormat = detectColorFormat(src);
+        if (actualFormat !== expectedFormat) {
+          var _this$options2;
+          // Drop alpha from the SUGGESTION when alpha is not enabled, the same way
+          // the field's commit does. Keeping it would suggest a value that fails
+          // the alpha check immediately below, so following the advice would not
+          // clear the error.
+          var suggestion = formatColor((_this$options2 = this.options) !== null && _this$options2 !== void 0 && _this$options2.alpha ? parsed : _objectSpread2(_objectSpread2({}, parsed), {}, {
+            a: 1
+          }), expectedFormat);
+          errors.push({
+            message: "Expected a color in the '".concat(expectedFormat, "' format (e.g. '").concat(FORMAT_EXAMPLES[expectedFormat], "'), got '").concat(src, "'. Did you mean '").concat(suggestion, "'?"),
+            value: src
+          });
+        }
+        if (!((_this$options3 = this.options) !== null && _this$options3 !== void 0 && _this$options3.alpha) && parsed.a < 1) {
+          errors.push({
+            message: "Color '".concat(src, "' has an alpha channel, but alpha is not enabled. Use s.color({ alpha: true }) to allow transparency"),
+            value: src
+          });
+        }
+      }
+      if (errors.length > 0) {
+        return _defineProperty({}, path, errors);
+      }
+      return false;
+    }
+  }, {
+    key: "executeAssert",
+    value: function executeAssert(path, src) {
+      if (this.opt && src === null) {
+        return {
+          success: true,
+          data: src
+        };
+      }
+      if (src === null) {
+        return {
+          success: false,
+          errors: _defineProperty({}, path, [{
+            message: "Expected 'string', got 'null'",
+            typeError: true
+          }])
+        };
+      }
+      if (typeof src !== "string") {
+        return {
+          success: false,
+          errors: _defineProperty({}, path, [{
+            message: "Expected 'string', got '".concat(_typeof(src), "'"),
+            typeError: true
+          }])
+        };
+      }
+      return {
+        success: true,
+        data: src
+      };
+    }
+  }, {
+    key: "nullable",
+    value: function nullable() {
+      return new ColorSchema(this.options, true, [], this.isReadonly, this.isHidden, this.description);
+    }
+  }, {
+    key: "readonly",
+    value: function readonly() {
+      return new ColorSchema(this.options, this.opt, this.customValidateFunctions, true, this.isHidden, this.description);
+    }
+  }, {
+    key: "hidden",
+    value: function hidden() {
+      return new ColorSchema(this.options, this.opt, this.customValidateFunctions, this.isReadonly, true, this.description);
+    }
+  }, {
+    key: "executeSerialize",
+    value: function executeSerialize() {
+      var _this$customValidateF;
+      return {
+        type: "color",
+        opt: this.opt,
+        options: this.options,
+        customValidate: this.customValidateFunctions && ((_this$customValidateF = this.customValidateFunctions) === null || _this$customValidateF === void 0 ? void 0 : _this$customValidateF.length) > 0,
+        readonly: this.isReadonly,
+        hidden: this.isHidden,
+        description: this.description
+      };
+    }
+  }, {
+    key: "executeRender",
+    value: function executeRender() {
+      return {};
+    }
+  }]);
+}(Schema);
+var color = function color(options) {
+  return new ColorSchema(options);
+};
+
 function router(router, keyOrItem, maybeItem) {
   if (maybeItem) {
     return new RecordSchema(maybeItem, false, [], router, keyOrItem);
@@ -5008,6 +6184,7 @@ function initSchema() {
     files: files,
     date: date,
     datetime: datetime,
+    color: color,
     route: route,
     router: router,
     images: images
@@ -5135,7 +6312,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
@@ -5162,142 +6340,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
  *
@@ -6797,7 +7839,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), {}, {
@@ -6846,7 +7888,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":
@@ -6865,6 +7907,8 @@ function deserializeSchemaImpl(serialized) {
       return new DateSchema(serialized.options, serialized.opt, [], false, false, serialized.description);
     case "dateTime":
       return new DateTimeSchema(serialized.options, serialized.opt, [], false, false, serialized.description);
+    case "color":
+      return new ColorSchema(serialized.options, serialized.opt, [], false, false, serialized.description);
     default:
       {
         var exhaustiveCheck = serialized;
@@ -7151,6 +8195,13 @@ var Internal = {
   joinModuleFilePathAndModulePath: joinModuleFilePathAndModulePath,
   nextAppRouter: nextAppRouter,
   externalPageRouter: externalPageRouter,
+  color: {
+    parseColor: parseColor,
+    formatColor: formatColor,
+    convertColor: convertColor,
+    detectColorFormat: detectColorFormat,
+    colorToHex: colorToHex
+  },
   remote: {
     createRemoteRef: createRemoteRef,
     getValidationBasis: getValidationBasis,
@@ -7165,6 +8216,9 @@ var Internal = {
   },
   isVal: isVal,
   isFile: isFile,
+  isJson: isJson,
+  getJsonImport: getJsonImport,
+  resolveJsonValues: resolveJsonValues,
   createValPathOfItem: createValPathOfItem,
   getSHA256Hash: getSHA256Hash,
   initSchema: initSchema,
@@ -7230,7 +8284,10 @@ function tryJsonParse(str) {
 
 exports.ArraySchema = ArraySchema;
 exports.BooleanSchema = BooleanSchema;
+exports.COLOR_FORMATS = COLOR_FORMATS;
+exports.ColorSchema = ColorSchema;
 exports.DEFAULT_APP_HOST = DEFAULT_APP_HOST;
+exports.DEFAULT_COLOR_FORMAT = DEFAULT_COLOR_FORMAT;
 exports.DEFAULT_CONTENT_HOST = DEFAULT_CONTENT_HOST;
 exports.DEFAULT_VAL_REMOTE_HOST = DEFAULT_VAL_REMOTE_HOST;
 exports.DateSchema = DateSchema;