@valbuild/core 0.120.0 → 0.121.0

package/dist/{index-2f65e194.esm.js → index-5fe6fb98.esm.js}

@@ -589,12 +589,14 @@ var StringSchema = /*#__PURE__*/function (_Schema) {
   }, {
     key: "readonly",
     value: function readonly() {
-      return new StringSchema(this.options, this.opt, this.isRaw, this.customValidateFunctions, this.renderInput, true, this.isHidden, this.description, this.previewInput, this.isMultiline);
+      var isReadonly = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : true;
+      return new StringSchema(this.options, this.opt, this.isRaw, this.customValidateFunctions, this.renderInput, isReadonly, this.isHidden, this.description, this.previewInput, this.isMultiline);
     }
   }, {
     key: "hidden",
     value: function hidden() {
-      return new StringSchema(this.options, this.opt, this.isRaw, this.customValidateFunctions, this.renderInput, this.isReadonly, true, this.description, this.previewInput, this.isMultiline);
+      var isHidden = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : true;
+      return new StringSchema(this.options, this.opt, this.isRaw, this.customValidateFunctions, this.renderInput, this.isReadonly, isHidden, this.description, this.previewInput, this.isMultiline);
     }
   }, {
     key: "raw",
@@ -867,12 +869,14 @@ var ObjectSchema = /*#__PURE__*/function (_Schema) {
   }, {
     key: "readonly",
     value: function readonly() {
-      return new ObjectSchema(this.items, this.opt, this.customValidateFunctions, true, this.isHidden, this.description, this.renderInput, this.previewInput);
+      var isReadonly = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : true;
+      return new ObjectSchema(this.items, this.opt, this.customValidateFunctions, isReadonly, this.isHidden, this.description, this.renderInput, this.previewInput);
     }
   }, {
     key: "hidden",
     value: function hidden() {
-      return new ObjectSchema(this.items, this.opt, this.customValidateFunctions, this.isReadonly, true, this.description, this.renderInput, this.previewInput);
+      var isHidden = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : true;
+      return new ObjectSchema(this.items, this.opt, this.customValidateFunctions, this.isReadonly, isHidden, this.description, this.renderInput, this.previewInput);
     }
   }, {
     key: "executeCustomValidateAt",
@@ -1083,12 +1087,14 @@ var ArraySchema = /*#__PURE__*/function (_Schema) {
   }, {
     key: "readonly",
     value: function readonly() {
-      return new ArraySchema(this.item, this.opt, this.customValidateFunctions, true, this.isHidden, this.description, this.previewInput, this.renderInput);
+      var isReadonly = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : true;
+      return new ArraySchema(this.item, this.opt, this.customValidateFunctions, isReadonly, this.isHidden, this.description, this.previewInput, this.renderInput);
     }
   }, {
     key: "hidden",
     value: function hidden() {
-      return new ArraySchema(this.item, this.opt, this.customValidateFunctions, this.isReadonly, true, this.description, this.previewInput, this.renderInput);
+      var isHidden = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : true;
+      return new ArraySchema(this.item, this.opt, this.customValidateFunctions, this.isReadonly, isHidden, this.description, this.previewInput, this.renderInput);
     }
   }, {
     key: "executeCustomValidateAt",
@@ -1336,12 +1342,14 @@ var LiteralSchema = /*#__PURE__*/function (_Schema) {
   }, {
     key: "readonly",
     value: function readonly() {
-      return new LiteralSchema(this.value, this.opt, this.customValidateFunctions, true, this.isHidden, this.description, this.renderInput, this.previewInput);
+      var isReadonly = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : true;
+      return new LiteralSchema(this.value, this.opt, this.customValidateFunctions, isReadonly, this.isHidden, this.description, this.renderInput, this.previewInput);
     }
   }, {
     key: "hidden",
     value: function hidden() {
-      return new LiteralSchema(this.value, this.opt, this.customValidateFunctions, this.isReadonly, true, this.description, this.renderInput, this.previewInput);
+      var isHidden = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : true;
+      return new LiteralSchema(this.value, this.opt, this.customValidateFunctions, this.isReadonly, isHidden, this.description, this.renderInput, this.previewInput);
     }
   }, {
     key: "executeCustomValidateAt",
@@ -1747,12 +1755,14 @@ var UnionSchema = /*#__PURE__*/function (_Schema) {
   }, {
     key: "readonly",
     value: function readonly() {
-      return new UnionSchema(this.key, this.items, this.opt, this.customValidateFunctions, true, this.isHidden, this.description, this.renderInput, this.previewInput);
+      var isReadonly = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : true;
+      return new UnionSchema(this.key, this.items, this.opt, this.customValidateFunctions, isReadonly, this.isHidden, this.description, this.renderInput, this.previewInput);
     }
   }, {
     key: "hidden",
     value: function hidden() {
-      return new UnionSchema(this.key, this.items, this.opt, this.customValidateFunctions, this.isReadonly, true, this.description, this.renderInput, this.previewInput);
+      var isHidden = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : true;
+      return new UnionSchema(this.key, this.items, this.opt, this.customValidateFunctions, this.isReadonly, isHidden, this.description, this.renderInput, this.previewInput);
     }
   }, {
     key: "executeCustomValidateAt",
@@ -3125,12 +3135,14 @@ var ImageSchema = /*#__PURE__*/function (_Schema) {
   }, {
     key: "readonly",
     value: function readonly() {
-      return new ImageSchema(this.options, this.opt, this.isRemote, this.customValidateFunctions, this.moduleMetadata, true, this.isHidden, this.description, this.renderInput, this.previewInput);
+      var isReadonly = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : true;
+      return new ImageSchema(this.options, this.opt, this.isRemote, this.customValidateFunctions, this.moduleMetadata, isReadonly, this.isHidden, this.description, this.renderInput, this.previewInput);
     }
   }, {
     key: "hidden",
     value: function hidden() {
-      return new ImageSchema(this.options, this.opt, this.isRemote, this.customValidateFunctions, this.moduleMetadata, this.isReadonly, true, this.description, this.renderInput, this.previewInput);
+      var isHidden = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : true;
+      return new ImageSchema(this.options, this.opt, this.isRemote, this.customValidateFunctions, this.moduleMetadata, this.isReadonly, isHidden, this.description, this.renderInput, this.previewInput);
     }
   }, {
     key: "executeCustomValidateAt",
@@ -3362,12 +3374,14 @@ var RouteSchema = /*#__PURE__*/function (_Schema) {
   }, {
     key: "readonly",
     value: function readonly() {
-      return new RouteSchema(this.options, this.opt, this.customValidateFunctions, true, this.isHidden, this.description, this.renderInput, this.previewInput);
+      var isReadonly = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : true;
+      return new RouteSchema(this.options, this.opt, this.customValidateFunctions, isReadonly, this.isHidden, this.description, this.renderInput, this.previewInput);
     }
   }, {
     key: "hidden",
     value: function hidden() {
-      return new RouteSchema(this.options, this.opt, this.customValidateFunctions, this.isReadonly, true, this.description, this.renderInput, this.previewInput);
+      var isHidden = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : true;
+      return new RouteSchema(this.options, this.opt, this.customValidateFunctions, this.isReadonly, isHidden, this.description, this.renderInput, this.previewInput);
     }
   }, {
     key: "executeCustomValidateAt",
@@ -3946,12 +3960,14 @@ var RichTextSchema = /*#__PURE__*/function (_Schema) {
   }, {
     key: "readonly",
     value: function readonly() {
-      return new RichTextSchema(this.options, this.opt, this.customValidateFunctions, true, this.isHidden, this.description, this.renderInput, this.previewInput);
+      var isReadonly = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : true;
+      return new RichTextSchema(this.options, this.opt, this.customValidateFunctions, isReadonly, this.isHidden, this.description, this.renderInput, this.previewInput);
     }
   }, {
     key: "hidden",
     value: function hidden() {
-      return new RichTextSchema(this.options, this.opt, this.customValidateFunctions, this.isReadonly, true, this.description, this.renderInput, this.previewInput);
+      var isHidden = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : true;
+      return new RichTextSchema(this.options, this.opt, this.customValidateFunctions, this.isReadonly, isHidden, this.description, this.renderInput, this.previewInput);
     }
   }, {
     key: "executeCustomValidateAt",
@@ -4753,12 +4769,14 @@ var RecordSchema = /*#__PURE__*/function (_Schema) {
   }, {
     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.isJsonValues, this.previewInput, this.renderInput);
+      var isReadonly = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : true;
+      return new RecordSchema(this.item, this.opt, this.customValidateFunctions, this.currentRouter, this.keySchema, this.mediaOptions, isReadonly, this.isHidden, this.description, this.isJsonValues, this.previewInput, 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.isJsonValues, this.previewInput, this.renderInput);
+      var isHidden = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : true;
+      return new RecordSchema(this.item, this.opt, this.customValidateFunctions, this.currentRouter, this.keySchema, this.mediaOptions, this.isReadonly, isHidden, this.description, this.isJsonValues, this.previewInput, this.renderInput);
     }
   }, {
     key: "router",
@@ -5047,6 +5065,487 @@ function record(keyOrSchema, schema) {
   }
 }
 
+/**
+ * The source of the project's settings module — `s.settings()`.
+ *
+ * **Every key is optional, at every level, and that is the whole point.** A
+ * settings module is written as
+ *
+ * ```typescript
+ * export default c.define("/settings.val.ts", s.settings(), {});
+ * ```
+ *
+ * and `{}` has to keep validating as sections are added to it. A project that
+ * never touched the assistant's settings should not have to edit its settings
+ * file the day `locales` or `permissions` land.
+ *
+ * That is why settings is not sugar over `s.object()`: an object schema errors
+ * with `Expected key 'assistant' not found in object` for any absent key (see
+ * `ObjectSchema.executeAssert`), and `.nullable()` permits `null`, not absence.
+ * `SettingsSchema` gives absent keys the meaning "unset" instead.
+ *
+ * `null` means unset too, so the editor can clear a field it has already
+ * written without removing the key.
+ */
+
+/**
+ * The assistant: whether editors have one, and what it is told about the
+ * project on every message.
+ *
+ * `context` and `tone` are prose the model reads, not instructions Val
+ * interprets, and both are capped (see {@link ASSISTANT_SETTINGS_MAX_LENGTH}):
+ * they are prepended to every request the chat makes, so an unbounded field
+ * here is an unbounded cost on every turn.
+ */
+
+/**
+ * The cap on each of the assistant's prose fields, in characters.
+ *
+ * Roughly a thousand tokens each. Generous enough for a paragraph of
+ * background and a house style, small enough that the two of them together do
+ * not dominate the system prompt they are appended to.
+ */
+var ASSISTANT_SETTINGS_MAX_LENGTH = 4000;
+
+/**
+ * Whether a project has an assistant — and the answer is not a boolean.
+ *
+ * - `"on"`: use it.
+ * - `"off"`: every trace of it goes. No button in the top bar, no row in the
+ *   quick actions, no panel, nothing sent. A project that says `false` has
+ *   decided, and the Studio does not keep offering.
+ * - `"unconfigured"`: nobody has said. The affordances are SHOWN, and asking to
+ *   use the assistant asks to turn it on first. That is the difference between
+ *   this and `"off"`, and the reason `enabled` is a tri-state: hiding an
+ *   unconfigured assistant means nobody discovers it, and quietly enabling one
+ *   means a project starts sending its content to a model because it did not
+ *   know to say no.
+ *
+ * A project with NO settings module is `"on"`. There is nowhere to record a
+ * decision, so there is nothing to prompt for and nothing to prompt INTO — the
+ * prompt writes to a settings module, and that project has none.
+ *
+ * This is the only answer to "does this project have an assistant":
+ * `config.ai.chat` is gone, and with it the chat's title, description and
+ * suggestions, which nothing replaces. The AI commit-message summariser is
+ * deliberately not part of this — `config.ai.commitMessages` stays where it is,
+ * and gets settings of its own later.
+ */
+
+function assistantAvailability(/** The settings module's source, or `undefined` where the project has none. */
+settings) {
+  var _settings$assistant;
+  if (settings === undefined) {
+    return "on";
+  }
+  var enabled = (_settings$assistant = settings.assistant) === null || _settings$assistant === void 0 ? void 0 : _settings$assistant.enabled;
+  if (enabled === true) {
+    return "on";
+  }
+  if (enabled === false) {
+    return "off";
+  }
+  return "unconfigured";
+}
+
+var BooleanSchema = /*#__PURE__*/function (_Schema) {
+  function BooleanSchema() {
+    var _this;
+    var opt = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : false;
+    var customValidateFunctions = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : [];
+    var isReadonly = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : false;
+    var isHidden = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : false;
+    var description = arguments.length > 4 ? arguments[4] : undefined;
+    var renderInput = arguments.length > 5 && arguments[5] !== undefined ? arguments[5] : null;
+    var previewInput = arguments.length > 6 && arguments[6] !== undefined ? arguments[6] : null;
+    _classCallCheck(this, BooleanSchema);
+    _this = _callSuper(this, BooleanSchema);
+    _this.opt = opt;
+    _this.customValidateFunctions = customValidateFunctions;
+    _this.isReadonly = isReadonly;
+    _this.isHidden = isHidden;
+    _this.description = description;
+    _this.renderInput = renderInput;
+    _this.previewInput = previewInput;
+    return _this;
+  }
+  _inherits(BooleanSchema, _Schema);
+  return _createClass(BooleanSchema, [{
+    key: "describe",
+    value: function describe(description) {
+      return new BooleanSchema(this.opt, this.customValidateFunctions, this.isReadonly, this.isHidden, description !== null && description !== void 0 ? description : undefined, this.renderInput, this.previewInput);
+    }
+  }, {
+    key: "validate",
+    value: function validate(validationFunction) {
+      return new BooleanSchema(this.opt, [].concat(_toConsumableArray(this.customValidateFunctions), [validationFunction]), this.isReadonly, this.isHidden, this.description, this.renderInput, this.previewInput);
+    }
+  }, {
+    key: "executeValidate",
+    value: function executeValidate(path, src) {
+      if (this.opt && (src === null || src === undefined)) {
+        return false;
+      }
+      if (typeof src !== "boolean") {
+        return _defineProperty({}, path, [{
+          message: "Expected 'boolean', got '".concat(_typeof(src), "'"),
+          value: src
+        }]);
+      }
+      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 'boolean', got 'null'",
+            typeError: true
+          }])
+        };
+      }
+      if (typeof src !== "boolean") {
+        return {
+          success: false,
+          errors: _defineProperty({}, path, [{
+            message: "Expected 'boolean', got '".concat(_typeof(src), "'"),
+            typeError: true
+          }])
+        };
+      }
+      return {
+        success: true,
+        data: src
+      };
+    }
+  }, {
+    key: "nullable",
+    value: function nullable() {
+      return new BooleanSchema(true, [], this.isReadonly, this.isHidden, this.description, this.renderInput, this.previewInput);
+    }
+  }, {
+    key: "readonly",
+    value: function readonly() {
+      var isReadonly = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : true;
+      return new BooleanSchema(this.opt, this.customValidateFunctions, isReadonly, this.isHidden, this.description, this.renderInput, this.previewInput);
+    }
+  }, {
+    key: "hidden",
+    value: function hidden() {
+      var isHidden = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : true;
+      return new BooleanSchema(this.opt, this.customValidateFunctions, this.isReadonly, isHidden, this.description, this.renderInput, this.previewInput);
+    }
+  }, {
+    key: "executeCustomValidateAt",
+    value: function executeCustomValidateAt(path, src) {
+      return this.executeCustomValidateFunctions(src, this.customValidateFunctions, {
+        path: path
+      });
+    }
+
+    /**
+     * How this field is laid out in the editor when it is the item of an array
+     * or record: `{ as: "inline" }` renders the field itself inside each row,
+     * instead of a preview row that navigates to it.
+     *
+     * Static configuration, not a callback — see `render.ts`.
+     */
+  }, {
+    key: "render",
+    value: function render(input) {
+      return new BooleanSchema(this.opt, this.customValidateFunctions, this.isReadonly, this.isHidden, this.description, input, this.previewInput);
+    }
+
+    /**
+     * How this VALUE is shown where a preview of it is needed — a row in a
+     * sortable list, a reference dropdown, a search hit. Never how the field
+     * itself is edited (that is `render`). See `preview.ts`.
+     */
+  }, {
+    key: "preview",
+    value: function preview(select) {
+      return new BooleanSchema(this.opt, this.customValidateFunctions, this.isReadonly, this.isHidden, this.description, this.renderInput, select);
+    }
+  }, {
+    key: "executePreviewItem",
+    value: function executePreviewItem(src) {
+      if (this.previewInput === null) {
+        return null;
+      }
+      return this.previewInput({
+        val: src
+      });
+    }
+  }, {
+    key: "declaresItemPreview",
+    value: function declaresItemPreview() {
+      return this.previewInput !== null;
+    }
+  }, {
+    key: "executeSerialize",
+    value: function executeSerialize() {
+      var _this$renderInput, _this$customValidateF;
+      return {
+        type: "boolean",
+        render: (_this$renderInput = this.renderInput) !== null && _this$renderInput !== void 0 ? _this$renderInput : undefined,
+        preview: this.previewInput ? true : undefined,
+        opt: this.opt,
+        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: "executePreview",
+    value: function executePreview() {
+      return {};
+    }
+  }]);
+}(Schema);
+var _boolean = function _boolean() {
+  return new BooleanSchema();
+};
+
+/**
+ * An object whose keys are all optional: absent means unset.
+ *
+ * Both the settings module itself and each of its sections are this. See
+ * {@link SettingsSource} for why settings cannot be an object schema, and
+ * {@link settings} for what a settings module holds.
+ *
+ * There is no `describe`, `validate`, `render` or `preview` on purpose: the
+ * shape is Val's, not the schema author's — `s.settings()` takes no arguments —
+ * and the Studio renders each section with a UI built for it.
+ */
+var SettingsSchema = /*#__PURE__*/function (_Schema) {
+  function SettingsSchema(items) {
+    var _this;
+    var opt = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : false;
+    var isReadonly = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : false;
+    var isHidden = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : false;
+    var description = arguments.length > 4 ? arguments[4] : undefined;
+    _classCallCheck(this, SettingsSchema);
+    _this = _callSuper(this, SettingsSchema);
+    _this.items = items;
+    _this.opt = opt;
+    _this.isReadonly = isReadonly;
+    _this.isHidden = isHidden;
+    _this.description = description;
+    return _this;
+  }
+  _inherits(SettingsSchema, _Schema);
+  return _createClass(SettingsSchema, [{
+    key: "executeValidate",
+    value: function executeValidate(path, src) {
+      var error = false;
+      if (src === null || src === undefined) {
+        if (this.opt) {
+          return false;
+        }
+        return _defineProperty({}, path, [{
+          message: "Expected 'object', got '".concat(src, "'")
+        }]);
+      }
+      if (_typeof(src) !== "object") {
+        return _defineProperty({}, path, [{
+          message: "Expected 'object', got '".concat(_typeof(src), "'")
+        }]);
+      }
+      if (Array.isArray(src)) {
+        return _defineProperty({}, path, [{
+          message: "Expected 'object', got 'array'"
+        }]);
+      }
+      for (var _i = 0, _Object$entries = Object.entries(this.items); _i < _Object$entries.length; _i++) {
+        var _Object$entries$_i = _slicedToArray(_Object$entries[_i], 2),
+          _key = _Object$entries$_i[0],
+          schema = _Object$entries$_i[1];
+        // Absent is the unset value, so there is nothing to validate. A key that
+        // is present as `undefined` is the same statement written differently.
+        if (src[_key] === undefined) {
+          continue;
+        }
+        var subPath = createValPathOfItem(path, _key);
+        if (!subPath) {
+          error = this.appendValidationError(error, path, "Internal error: could not create path at ".concat(!path && typeof path === "string" ? "<empty string>" : path, " at key ").concat(_key),
+          // Should! never happen
+          src);
+        } else {
+          var subError = schema["executeValidate"](subPath, src[_key]);
+          error = this.mergeValidationErrors(error, subError);
+        }
+      }
+      // An unknown key is reported rather than ignored (which is what an object
+      // schema does with extra keys): the shape is closed and Val-defined, so the
+      // realistic cause is a typo — `toneOfVoice` for `tone` — and silence there
+      // means a setting that never takes effect and never says why.
+      for (var _i2 = 0, _Object$keys = Object.keys(src); _i2 < _Object$keys.length; _i2++) {
+        var _key2 = _Object$keys[_i2];
+        if (!(_key2 in this.items)) {
+          error = this.appendValidationError(error, path, "Unknown settings key: '".concat(_key2, "'. Expected one of: ").concat(Object.keys(this.items).map(function (key) {
+            return "'".concat(key, "'");
+          }).join(", ")), src, true);
+        }
+      }
+      return error;
+    }
+  }, {
+    key: "executeAssert",
+    value: function executeAssert(path, src) {
+      if (this.opt && src === null) {
+        return {
+          success: true,
+          data: src
+        };
+      }
+      var typeError = function typeError(got) {
+        return {
+          message: "Expected 'object', got '".concat(got, "'"),
+          typeError: true
+        };
+      };
+      if (src === null) {
+        return {
+          success: false,
+          errors: _defineProperty({}, path, [typeError("null")])
+        };
+      }
+      if (_typeof(src) !== "object") {
+        return {
+          success: false,
+          errors: _defineProperty({}, path, [typeError(_typeof(src))])
+        };
+      }
+      if (Array.isArray(src)) {
+        return {
+          success: false,
+          errors: _defineProperty({}, path, [typeError("array")])
+        };
+      }
+      // No per-key check, unlike an object schema: every key is optional, so an
+      // object is all this can assert.
+      return {
+        success: true,
+        data: src
+      };
+    }
+  }, {
+    key: "nullable",
+    value: function nullable() {
+      return new SettingsSchema(this.items, true, this.isReadonly, this.isHidden, this.description);
+    }
+  }, {
+    key: "readonly",
+    value: function readonly() {
+      return new SettingsSchema(this.items, this.opt, true, this.isHidden, this.description);
+    }
+  }, {
+    key: "hidden",
+    value: function hidden() {
+      return new SettingsSchema(this.items, this.opt, this.isReadonly, true, this.description);
+    }
+  }, {
+    key: "executeCustomValidateAt",
+    value: function executeCustomValidateAt() {
+      // Settings declares no `validate`, so there are no custom validators to
+      // run. Implemented rather than inherited because the base class makes this
+      // abstract on purpose — see `Schema.executeCustomValidateAt`.
+      return [];
+    }
+  }, {
+    key: "executeSerialize",
+    value: function executeSerialize() {
+      return {
+        type: "settings",
+        items: Object.fromEntries(Object.entries(this.items).map(function (_ref4) {
+          var _ref5 = _slicedToArray(_ref4, 2),
+            key = _ref5[0],
+            schema = _ref5[1];
+          return [key, schema["executeSerialize"]()];
+        })),
+        opt: this.opt,
+        readonly: this.isReadonly,
+        hidden: this.isHidden,
+        description: this.description
+      };
+    }
+  }, {
+    key: "executePreview",
+    value: function executePreview(sourcePath, src, scope) {
+      var res = {};
+      if (src === null) {
+        return res;
+      }
+      for (var _key3 in this.items) {
+        var itemSrc = src[_key3];
+        if (itemSrc === null || itemSrc === undefined) {
+          continue;
+        }
+        var subPath = unsafeCreateSourcePath(sourcePath, _key3);
+        if (scope !== undefined && !scope.wantsUnder(subPath)) {
+          continue;
+        }
+        var itemResult = this.items[_key3]["executePreview"](subPath, itemSrc, scope);
+        for (var keyS in itemResult) {
+          var _key4 = keyS;
+          res[_key4] = itemResult[_key4];
+        }
+      }
+      return res;
+    }
+  }]);
+}(Schema);
+
+/**
+ * Define the project's settings.
+ *
+ * One settings module per project, at the root of the content tree — a module
+ * file path with no directory segment, `/settings.val.ts` by convention:
+ *
+ * ```typescript
+ * export default c.define("/settings.val.ts", s.settings(), {});
+ * ```
+ *
+ * Every section is optional, so `{}` is a complete settings module and stays
+ * one as sections are added. Fill in what the project needs:
+ *
+ * ```typescript
+ * export default c.define("/settings.val.ts", s.settings(), {
+ *   assistant: {
+ *     enabled: true,
+ *     context: "Val is a CMS for developers. British English, and 'Val' is never 'VAL'.",
+ *     tone: "Plain and direct. No exclamation marks, sentence case in headings.",
+ *   },
+ * });
+ * ```
+ *
+ * The Studio edits it under the cog at the foot of the left rail, and the
+ * assistant is told `assistant.context` and `assistant.tone` on every message.
+ *
+ * `s.settings()` takes no arguments: the shape is Val's, which is what lets the
+ * Studio render a UI built for each field rather than a generic form. A
+ * project's own global content — a site name, social links — belongs in a
+ * module of its own.
+ */
+function settings() {
+  return new SettingsSchema({
+    assistant: new SettingsSchema({
+      enabled: _boolean().nullable().describe("Whether editors have an assistant in this project. Unset means nobody has decided: it is offered, and turned on when someone accepts."),
+      context: string().multiline().maxLength(ASSISTANT_SETTINGS_MAX_LENGTH).nullable().describe("Background the assistant would otherwise have to guess: what this site is, who runs it, names and spellings that matter."),
+      tone: string().multiline().maxLength(ASSISTANT_SETTINGS_MAX_LENGTH).nullable().describe("How the assistant should write when it writes content: formal or playful, British or American, how headings are cased.")
+    })
+  });
+}
+
 function define(id,
 // TODO: `/${string}`
 schema, source) {
@@ -5084,6 +5583,17 @@ function joinModuleFilePathAndModulePath(moduleFilePath, modulePath) {
 function isObjectSchema(schema) {
   return schema instanceof ObjectSchema || _typeof(schema) === "object" && "type" in schema && schema.type === "object";
 }
+
+/**
+ * Settings, which walks like an object but whose keys are all OPTIONAL.
+ *
+ * That difference is the whole reason it is not an object schema: descending
+ * into an unset section must resolve to `undefined`, not fail — see
+ * `SettingsSource`.
+ */
+function isSettingsSchema(schema) {
+  return schema instanceof SettingsSchema || _typeof(schema) === "object" && "type" in schema && schema.type === "settings";
+}
 function isRecordSchema(schema) {
   return schema instanceof RecordSchema || _typeof(schema) === "object" && "type" in schema && schema.type === "record";
 }
@@ -5162,6 +5672,16 @@ function resolvePath(path, valModule, schema) {
         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 (isSettingsSchema(resolvedSchema)) {
+        if (resolvedSource !== null && resolvedSource !== undefined && _typeof(resolvedSource) !== "object") {
+          throw Error("Schema type error: expected source to be type of object, but got ".concat(_typeof(resolvedSource)));
+        }
+        // An absent key is NOT an error here, unlike an object's: every settings
+        // key is optional, so a path into a section the project has not set
+        // resolves to `undefined` — and keeps resolving, one level per part, so a
+        // path two deep into an unset section still lands on the right schema.
+        resolvedSource = resolvedSource === null || resolvedSource === undefined ? resolvedSource : resolvedSource[part];
+        resolvedSchema = resolvedSchema instanceof SettingsSchema ? resolvedSchema["items"][part] : resolvedSchema.items[part];
       } 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)));
@@ -5376,6 +5896,21 @@ function safeResolvePath(path, valModule, schema) {
             }
           };
         }
+      } else if (isSettingsSchema(resolvedSchema)) {
+        if (resolvedSource !== null && resolvedSource !== undefined && _typeof(resolvedSource) !== "object") {
+          return {
+            v: {
+              status: "error",
+              message: "Schema type error: expected source to be type of object, but got ".concat(_typeof(resolvedSource))
+            }
+          };
+        }
+        // Absent is a value here — see the note in `resolvePath`. `undefined` has
+        // to be let through as well as `null`: descending into a section the
+        // project has not set produces one, and the NEXT part then arrives with
+        // an undefined source that is not an error either.
+        resolvedSource = resolvedSource === null || resolvedSource === undefined ? resolvedSource : resolvedSource[part];
+        resolvedSchema = resolvedSchema instanceof SettingsSchema ? resolvedSchema["items"][part] : resolvedSchema.items[part];
       } else if (isObjectSchema(resolvedSchema)) {
         if (resolvedSource === undefined) {
           return {
@@ -5694,12 +6229,14 @@ var NumberSchema = /*#__PURE__*/function (_Schema) {
   }, {
     key: "readonly",
     value: function readonly() {
-      return new NumberSchema(this.options, this.opt, this.customValidateFunctions, true, this.isHidden, this.description, this.renderInput, this.previewInput);
+      var isReadonly = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : true;
+      return new NumberSchema(this.options, this.opt, this.customValidateFunctions, isReadonly, this.isHidden, this.description, this.renderInput, this.previewInput);
     }
   }, {
     key: "hidden",
     value: function hidden() {
-      return new NumberSchema(this.options, this.opt, this.customValidateFunctions, this.isReadonly, true, this.description, this.renderInput, this.previewInput);
+      var isHidden = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : true;
+      return new NumberSchema(this.options, this.opt, this.customValidateFunctions, this.isReadonly, isHidden, this.description, this.renderInput, this.previewInput);
     }
   }, {
     key: "max",
@@ -5788,171 +6325,6 @@ var number = function number(options) {
   return new NumberSchema(options);
 };
 
-var BooleanSchema = /*#__PURE__*/function (_Schema) {
-  function BooleanSchema() {
-    var _this;
-    var opt = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : false;
-    var customValidateFunctions = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : [];
-    var isReadonly = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : false;
-    var isHidden = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : false;
-    var description = arguments.length > 4 ? arguments[4] : undefined;
-    var renderInput = arguments.length > 5 && arguments[5] !== undefined ? arguments[5] : null;
-    var previewInput = arguments.length > 6 && arguments[6] !== undefined ? arguments[6] : null;
-    _classCallCheck(this, BooleanSchema);
-    _this = _callSuper(this, BooleanSchema);
-    _this.opt = opt;
-    _this.customValidateFunctions = customValidateFunctions;
-    _this.isReadonly = isReadonly;
-    _this.isHidden = isHidden;
-    _this.description = description;
-    _this.renderInput = renderInput;
-    _this.previewInput = previewInput;
-    return _this;
-  }
-  _inherits(BooleanSchema, _Schema);
-  return _createClass(BooleanSchema, [{
-    key: "describe",
-    value: function describe(description) {
-      return new BooleanSchema(this.opt, this.customValidateFunctions, this.isReadonly, this.isHidden, description !== null && description !== void 0 ? description : undefined, this.renderInput, this.previewInput);
-    }
-  }, {
-    key: "validate",
-    value: function validate(validationFunction) {
-      return new BooleanSchema(this.opt, [].concat(_toConsumableArray(this.customValidateFunctions), [validationFunction]), this.isReadonly, this.isHidden, this.description, this.renderInput, this.previewInput);
-    }
-  }, {
-    key: "executeValidate",
-    value: function executeValidate(path, src) {
-      if (this.opt && (src === null || src === undefined)) {
-        return false;
-      }
-      if (typeof src !== "boolean") {
-        return _defineProperty({}, path, [{
-          message: "Expected 'boolean', got '".concat(_typeof(src), "'"),
-          value: src
-        }]);
-      }
-      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 'boolean', got 'null'",
-            typeError: true
-          }])
-        };
-      }
-      if (typeof src !== "boolean") {
-        return {
-          success: false,
-          errors: _defineProperty({}, path, [{
-            message: "Expected 'boolean', got '".concat(_typeof(src), "'"),
-            typeError: true
-          }])
-        };
-      }
-      return {
-        success: true,
-        data: src
-      };
-    }
-  }, {
-    key: "nullable",
-    value: function nullable() {
-      return new BooleanSchema(true, [], this.isReadonly, this.isHidden, this.description, this.renderInput, this.previewInput);
-    }
-  }, {
-    key: "readonly",
-    value: function readonly() {
-      return new BooleanSchema(this.opt, this.customValidateFunctions, true, this.isHidden, this.description, this.renderInput, this.previewInput);
-    }
-  }, {
-    key: "hidden",
-    value: function hidden() {
-      return new BooleanSchema(this.opt, this.customValidateFunctions, this.isReadonly, true, this.description, this.renderInput, this.previewInput);
-    }
-  }, {
-    key: "executeCustomValidateAt",
-    value: function executeCustomValidateAt(path, src) {
-      return this.executeCustomValidateFunctions(src, this.customValidateFunctions, {
-        path: path
-      });
-    }
-
-    /**
-     * How this field is laid out in the editor when it is the item of an array
-     * or record: `{ as: "inline" }` renders the field itself inside each row,
-     * instead of a preview row that navigates to it.
-     *
-     * Static configuration, not a callback — see `render.ts`.
-     */
-  }, {
-    key: "render",
-    value: function render(input) {
-      return new BooleanSchema(this.opt, this.customValidateFunctions, this.isReadonly, this.isHidden, this.description, input, this.previewInput);
-    }
-
-    /**
-     * How this VALUE is shown where a preview of it is needed — a row in a
-     * sortable list, a reference dropdown, a search hit. Never how the field
-     * itself is edited (that is `render`). See `preview.ts`.
-     */
-  }, {
-    key: "preview",
-    value: function preview(select) {
-      return new BooleanSchema(this.opt, this.customValidateFunctions, this.isReadonly, this.isHidden, this.description, this.renderInput, select);
-    }
-  }, {
-    key: "executePreviewItem",
-    value: function executePreviewItem(src) {
-      if (this.previewInput === null) {
-        return null;
-      }
-      return this.previewInput({
-        val: src
-      });
-    }
-  }, {
-    key: "declaresItemPreview",
-    value: function declaresItemPreview() {
-      return this.previewInput !== null;
-    }
-  }, {
-    key: "executeSerialize",
-    value: function executeSerialize() {
-      var _this$renderInput, _this$customValidateF;
-      return {
-        type: "boolean",
-        render: (_this$renderInput = this.renderInput) !== null && _this$renderInput !== void 0 ? _this$renderInput : undefined,
-        preview: this.previewInput ? true : undefined,
-        opt: this.opt,
-        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: "executePreview",
-    value: function executePreview() {
-      return {};
-    }
-  }]);
-}(Schema);
-var _boolean = function _boolean() {
-  return new BooleanSchema();
-};
-
 var KeyOfSchema = /*#__PURE__*/function (_Schema) {
   function KeyOfSchema(schema, sourcePath) {
     var _this;
@@ -6120,12 +6492,14 @@ var KeyOfSchema = /*#__PURE__*/function (_Schema) {
   }, {
     key: "readonly",
     value: function readonly() {
-      return new KeyOfSchema(this.schema, this.sourcePath, this.opt, this.customValidateFunctions, true, this.isHidden, this.description, this.renderInput, this.previewInput);
+      var isReadonly = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : true;
+      return new KeyOfSchema(this.schema, this.sourcePath, this.opt, this.customValidateFunctions, isReadonly, this.isHidden, this.description, this.renderInput, this.previewInput);
     }
   }, {
     key: "hidden",
     value: function hidden() {
-      return new KeyOfSchema(this.schema, this.sourcePath, this.opt, this.customValidateFunctions, this.isReadonly, true, this.description, this.renderInput, this.previewInput);
+      var isHidden = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : true;
+      return new KeyOfSchema(this.schema, this.sourcePath, this.opt, this.customValidateFunctions, this.isReadonly, isHidden, this.description, this.renderInput, this.previewInput);
     }
   }, {
     key: "executeCustomValidateAt",
@@ -6462,12 +6836,14 @@ var FileSchema = /*#__PURE__*/function (_Schema) {
   }, {
     key: "readonly",
     value: function readonly() {
-      return new FileSchema(this.options, this.opt, this.isRemote, this.customValidateFunctions, this.moduleMetadata, true, this.isHidden, this.description, this.renderInput, this.previewInput);
+      var isReadonly = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : true;
+      return new FileSchema(this.options, this.opt, this.isRemote, this.customValidateFunctions, this.moduleMetadata, isReadonly, this.isHidden, this.description, this.renderInput, this.previewInput);
     }
   }, {
     key: "hidden",
     value: function hidden() {
-      return new FileSchema(this.options, this.opt, this.isRemote, this.customValidateFunctions, this.moduleMetadata, this.isReadonly, true, this.description, this.renderInput, this.previewInput);
+      var isHidden = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : true;
+      return new FileSchema(this.options, this.opt, this.isRemote, this.customValidateFunctions, this.moduleMetadata, this.isReadonly, isHidden, this.description, this.renderInput, this.previewInput);
     }
   }, {
     key: "executeCustomValidateAt",
@@ -6741,12 +7117,14 @@ var DateSchema = /*#__PURE__*/function (_Schema) {
   }, {
     key: "readonly",
     value: function readonly() {
-      return new DateSchema(this.options, this.opt, this.customValidateFunctions, true, this.isHidden, this.description, this.renderInput, this.previewInput);
+      var isReadonly = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : true;
+      return new DateSchema(this.options, this.opt, this.customValidateFunctions, isReadonly, this.isHidden, this.description, this.renderInput, this.previewInput);
     }
   }, {
     key: "hidden",
     value: function hidden() {
-      return new DateSchema(this.options, this.opt, this.customValidateFunctions, this.isReadonly, true, this.description, this.renderInput, this.previewInput);
+      var isHidden = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : true;
+      return new DateSchema(this.options, this.opt, this.customValidateFunctions, this.isReadonly, isHidden, this.description, this.renderInput, this.previewInput);
     }
   }, {
     key: "executeCustomValidateAt",
@@ -6990,12 +7368,14 @@ var DateTimeSchema = /*#__PURE__*/function (_Schema) {
   }, {
     key: "readonly",
     value: function readonly() {
-      return new DateTimeSchema(this.options, this.opt, this.customValidateFunctions, true, this.isHidden, this.description, this.renderInput, this.previewInput);
+      var isReadonly = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : true;
+      return new DateTimeSchema(this.options, this.opt, this.customValidateFunctions, isReadonly, this.isHidden, this.description, this.renderInput, this.previewInput);
     }
   }, {
     key: "hidden",
     value: function hidden() {
-      return new DateTimeSchema(this.options, this.opt, this.customValidateFunctions, this.isReadonly, true, this.description, this.renderInput, this.previewInput);
+      var isHidden = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : true;
+      return new DateTimeSchema(this.options, this.opt, this.customValidateFunctions, this.isReadonly, isHidden, this.description, this.renderInput, this.previewInput);
     }
   }, {
     key: "executeCustomValidateAt",
@@ -7175,12 +7555,14 @@ var CodeSchema = /*#__PURE__*/function (_Schema) {
   }, {
     key: "readonly",
     value: function readonly() {
-      return new CodeSchema(this.options, this.opt, this.customValidateFunctions, true, this.isHidden, this.description, this.renderInput, this.previewInput);
+      var isReadonly = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : true;
+      return new CodeSchema(this.options, this.opt, this.customValidateFunctions, isReadonly, this.isHidden, this.description, this.renderInput, this.previewInput);
     }
   }, {
     key: "hidden",
     value: function hidden() {
-      return new CodeSchema(this.options, this.opt, this.customValidateFunctions, this.isReadonly, true, this.description, this.renderInput, this.previewInput);
+      var isHidden = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : true;
+      return new CodeSchema(this.options, this.opt, this.customValidateFunctions, this.isReadonly, isHidden, this.description, this.renderInput, this.previewInput);
     }
 
     /**
@@ -7861,12 +8243,14 @@ var ColorSchema = /*#__PURE__*/function (_Schema) {
   }, {
     key: "readonly",
     value: function readonly() {
-      return new ColorSchema(this.options, this.opt, this.customValidateFunctions, true, this.isHidden, this.description, this.renderInput, this.previewInput);
+      var isReadonly = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : true;
+      return new ColorSchema(this.options, this.opt, this.customValidateFunctions, isReadonly, this.isHidden, this.description, this.renderInput, this.previewInput);
     }
   }, {
     key: "hidden",
     value: function hidden() {
-      return new ColorSchema(this.options, this.opt, this.customValidateFunctions, this.isReadonly, true, this.description, this.renderInput, this.previewInput);
+      var isHidden = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : true;
+      return new ColorSchema(this.options, this.opt, this.customValidateFunctions, this.isReadonly, isHidden, this.description, this.renderInput, this.previewInput);
     }
 
     /**
@@ -8029,7 +8413,8 @@ function initSchema() {
     code: code,
     route: route,
     router: router,
-    images: images
+    images: images,
+    settings: settings
     // i18n: i18n(locales),
   };
 }
@@ -8430,6 +8815,98 @@ var getSHA256Hash = function getSHA256Hash(bits) {
   return createHash().update(bits).digest("hex");
 };
 
+/**
+ * Where a settings module goes unless a project has a reason not to.
+ *
+ * A convention, not a rule: any module file path at the root of the content
+ * tree may hold `s.settings()` — see {@link resolveSettingsModule}.
+ */
+var SETTINGS_MODULE_CONVENTION = "/settings.val.ts";
+
+/**
+ * Whether a module file path is at the root of the content tree.
+ *
+ * `/settings.val.ts` is; `/content/settings.val.ts` is not. The settings module
+ * is the project's, not a folder's, and a project-wide setting found three
+ * directories down reads as one section's — so the position is part of what it
+ * means.
+ */
+function isRootModuleFilePath(moduleFilePath) {
+  return moduleFilePath.startsWith("/") && !moduleFilePath.slice(1).includes("/");
+}
+
+/**
+ * Structurally an `ExtractedModuleError`, declared here rather than imported to
+ * keep `extractValModules` -> `settingsModule` a one-way dependency.
+ */
+
+/**
+ * Find the project's settings module among all its schemas.
+ *
+ * One per project, at the root: a settings module in a subdirectory is an
+ * error, and so is a second one. Both are reported rather than resolved by
+ * picking a winner — a project with two settings modules has a question to
+ * answer, and answering it by sort order means the answer changes when a file
+ * is renamed.
+ */
+function resolveSettingsModule(schemas) {
+  var rootModules = [];
+  var nestedModules = [];
+  var _iterator = _createForOfIteratorHelper(Object.keys(schemas).sort()),
+    _step;
+  try {
+    for (_iterator.s(); !(_step = _iterator.n()).done;) {
+      var _schemas$_moduleFileP;
+      var moduleFilePathS = _step.value;
+      var _moduleFilePath2 = moduleFilePathS;
+      if (((_schemas$_moduleFileP = schemas[_moduleFilePath2]) === null || _schemas$_moduleFileP === void 0 ? void 0 : _schemas$_moduleFileP.type) !== "settings") {
+        continue;
+      }
+      if (isRootModuleFilePath(_moduleFilePath2)) {
+        rootModules.push(_moduleFilePath2);
+      } else {
+        nestedModules.push(_moduleFilePath2);
+      }
+    }
+  } catch (err) {
+    _iterator.e(err);
+  } finally {
+    _iterator.f();
+  }
+  var errors = [];
+  for (var _i = 0, _nestedModules = nestedModules; _i < _nestedModules.length; _i++) {
+    var moduleFilePath = _nestedModules[_i];
+    errors.push({
+      path: moduleFilePath,
+      message: "Settings must be defined at the root of the content tree, but s.settings() was found in '".concat(moduleFilePath, "'. Move it to a module file path with no directory in it, e.g. '").concat(SETTINGS_MODULE_CONVENTION, "'.")
+    });
+  }
+  if (rootModules.length > 1) {
+    var listed = rootModules.map(function (moduleFilePath) {
+      return "'".concat(moduleFilePath, "'");
+    }).join(" and ");
+    var _iterator2 = _createForOfIteratorHelper(rootModules),
+      _step2;
+    try {
+      for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+        var _moduleFilePath = _step2.value;
+        errors.push({
+          path: _moduleFilePath,
+          message: "A project can only define settings once, but s.settings() was found in ".concat(listed, ". Keep one of them.")
+        });
+      }
+    } catch (err) {
+      _iterator2.e(err);
+    } finally {
+      _iterator2.f();
+    }
+  }
+  return {
+    moduleFilePath: errors.length === 0 && rootModules.length === 1 ? rootModules[0] : null,
+    errors: errors
+  };
+}
+
 // Lazily constructed: this module is also evaluated inside the `vm` sandbox
 // used by loadValModules (when user val modules import @valbuild/core), and
 // that sandbox has no `TextEncoder` global. `hash()` is never called from
@@ -8597,7 +9074,7 @@ function extractValModules(_x) {
 }
 function _extractValModules() {
   _extractValModules = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee(valModules) {
-    var moduleErrors, addModuleError, sources, schemas, serializedSchemas, shaEntries, moduleIdx, module, at, value, path, schema, source, serializedSchema, pathM, _t, _t2;
+    var moduleErrors, addModuleError, sources, schemas, serializedSchemas, shaEntries, moduleIdx, module, at, value, path, schema, source, serializedSchema, pathM, _iterator2, _step2, error, _t, _t2;
     return _regenerator().w(function (_context) {
       while (1) switch (_context.p = _context.n) {
         case 0:
@@ -8736,6 +9213,25 @@ function _extractValModules() {
           _context.n = 1;
           break;
         case 18:
+          // Settings is the one rule that cannot be checked while looking at a single
+          // module: "one per project, at the root" is a statement about the whole set.
+          // Reported here so that every consumer of extraction gets it — the dev
+          // server, `val validate` and the Studio all read `moduleErrors`.
+          //
+          // Appended AFTER the loop on purpose: each entry's `moduleErrorsAt` is the
+          // error count at the time it was folded in, so the SHAs stay a function of
+          // the modules themselves.
+          _iterator2 = _createForOfIteratorHelper(resolveSettingsModule(serializedSchemas).errors);
+          try {
+            for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+              error = _step2.value;
+              moduleErrors.push(error);
+            }
+          } catch (err) {
+            _iterator2.e(err);
+          } finally {
+            _iterator2.f();
+          }
           return _context.a(2, _objectSpread2(_objectSpread2({
             sources: sources,
             schemas: schemas,
@@ -8807,7 +9303,10 @@ function hasRemoteFileSchema(schema) {
       return true;
     }
     return hasRemoteFileSchema(schema.item);
-  } else if (schema.type === "object") {
+  } else if (schema.type === "object" || schema.type === "settings") {
+    // Settings holds its sections the way an object holds its keys, so looking
+    // inside is the same walk. Nothing in settings takes a file today, but the
+    // answer should stay right when something does.
     for (var key in schema.items) {
       var hasRemoteFile = hasRemoteFileSchema(schema.items[key]);
       if (hasRemoteFile) {
@@ -9075,6 +9574,13 @@ function deserializeSchemaImpl(serialized) {
           item = _ref2[1];
         return [key, deserializeSchema(item)];
       })), serialized.opt, [], false, false, serialized.description, (_serialized$render5 = serialized.render) !== null && _serialized$render5 !== void 0 ? _serialized$render5 : null);
+    case "settings":
+      return new SettingsSchema(Object.fromEntries(Object.entries(serialized.items).map(function (_ref3) {
+        var _ref4 = _slicedToArray(_ref3, 2),
+          key = _ref4[0],
+          item = _ref4[1];
+        return [key, deserializeSchema(item)];
+      })), serialized.opt, false, false, serialized.description);
     case "array":
       return new ArraySchema(deserializeSchema(serialized.item), serialized.opt, [], false, false, serialized.description,
       // The preview closure cannot survive serialization; the render can.
@@ -9732,4 +10238,4 @@ function tryJsonParse(str) {
   }
 }
 
-export { ArraySchema as A, BooleanSchema as B, ColorSchema as C, DEFAULT_CONTENT_HOST as D, isInlineRender as E, FATAL_ERROR_TYPES as F, GenericSelector as G, getSourcePathFromRoute as H, Internal as I, KeyOfSchema as K, LiteralSchema as L, ModuleFilePathSep as M, NumberSchema as N, ObjectSchema as O, PatchError as P, RecordSchema as R, Schema as S, UnionSchema as U, VAL_EXTENSION as V, _typeof as _, _slicedToArray as a, _createClass as b, _classCallCheck as c, _toConsumableArray as d, DEFAULT_APP_HOST as e, extractValModules as f, computeValModuleShas as g, hasRemoteFileSchema as h, initVal as i, DEFAULT_VAL_REMOTE_HOST as j, derefPatch as k, StringSchema as l, modules as m, ImageSchema as n, FileSchema as o, DateSchema as p, CodeSchema as q, CODE_LANGUAGES as r, splitModuleFilePathAndModulePath as s, COLOR_FORMATS as t, DEFAULT_COLOR_FORMAT as u, DateTimeSchema as v, RouteSchema as w, RichTextSchema as x, deserializeSchema as y, previewScope as z };
+export { ArraySchema as A, BooleanSchema as B, ColorSchema as C, DEFAULT_CONTENT_HOST as D, DEFAULT_COLOR_FORMAT as E, FATAL_ERROR_TYPES as F, GenericSelector as G, DateTimeSchema as H, Internal as I, RouteSchema as J, KeyOfSchema as K, RichTextSchema as L, ModuleFilePathSep as M, NumberSchema as N, ObjectSchema as O, PatchError as P, LiteralSchema as Q, RecordSchema as R, Schema as S, deserializeSchema as T, UnionSchema as U, VAL_EXTENSION as V, previewScope as W, isInlineRender as X, getSourcePathFromRoute as Y, _typeof as _, _slicedToArray as a, _createClass as b, _classCallCheck as c, _toConsumableArray as d, DEFAULT_APP_HOST as e, extractValModules as f, computeValModuleShas as g, hasRemoteFileSchema as h, initVal as i, DEFAULT_VAL_REMOTE_HOST as j, derefPatch as k, StringSchema as l, modules as m, ImageSchema as n, FileSchema as o, DateSchema as p, SettingsSchema as q, ASSISTANT_SETTINGS_MAX_LENGTH as r, splitModuleFilePathAndModulePath as s, assistantAvailability as t, SETTINGS_MODULE_CONVENTION as u, isRootModuleFilePath as v, resolveSettingsModule as w, CodeSchema as x, CODE_LANGUAGES as y, COLOR_FORMATS as z };