@valbuild/core 0.109.0 → 0.111.0

package/dist/{index-77914667.cjs.prod.js → index-f1992b0f.cjs.prod.js}

@@ -449,6 +449,7 @@ var StringSchema = /*#__PURE__*/function (_Schema) {
     var isHidden = arguments.length > 6 && arguments[6] !== undefined ? arguments[6] : false;
     var description = arguments.length > 7 ? arguments[7] : undefined;
     var previewInput = arguments.length > 8 && arguments[8] !== undefined ? arguments[8] : null;
+    var isMultiline = arguments.length > 9 && arguments[9] !== undefined ? arguments[9] : false;
     _classCallCheck(this, StringSchema);
     _this = _callSuper(this, StringSchema);
     _this.options = options;
@@ -460,13 +461,14 @@ var StringSchema = /*#__PURE__*/function (_Schema) {
     _this.isHidden = isHidden;
     _this.description = description;
     _this.previewInput = previewInput;
+    _this.isMultiline = isMultiline;
     return _this;
   }
   _inherits(StringSchema, _Schema);
   return _createClass(StringSchema, [{
     key: "describe",
     value: function describe(description) {
-      return new StringSchema(this.options, this.opt, this.isRaw, this.customValidateFunctions, this.renderInput, this.isReadonly, this.isHidden, description !== null && description !== void 0 ? description : undefined, this.previewInput);
+      return new StringSchema(this.options, this.opt, this.isRaw, this.customValidateFunctions, this.renderInput, this.isReadonly, this.isHidden, description !== null && description !== void 0 ? description : undefined, this.previewInput, this.isMultiline);
     }
 
     /**
@@ -482,7 +484,7 @@ var StringSchema = /*#__PURE__*/function (_Schema) {
     value: function minLength(_minLength) {
       return new StringSchema(_objectSpread2(_objectSpread2({}, this.options), {}, {
         minLength: _minLength
-      }), this.opt, this.isRaw, this.customValidateFunctions, this.renderInput, this.isReadonly, this.isHidden, this.description, this.previewInput);
+      }), this.opt, this.isRaw, this.customValidateFunctions, this.renderInput, this.isReadonly, this.isHidden, this.description, this.previewInput, this.isMultiline);
     }
 
     /**
@@ -498,7 +500,7 @@ var StringSchema = /*#__PURE__*/function (_Schema) {
     value: function maxLength(_maxLength) {
       return new StringSchema(_objectSpread2(_objectSpread2({}, this.options), {}, {
         maxLength: _maxLength
-      }), this.opt, this.isRaw, this.customValidateFunctions, this.renderInput, this.isReadonly, this.isHidden, this.description, this.previewInput);
+      }), this.opt, this.isRaw, this.customValidateFunctions, this.renderInput, this.isReadonly, this.isHidden, this.description, this.previewInput, this.isMultiline);
     }
   }, {
     key: "regexp",
@@ -506,12 +508,12 @@ var StringSchema = /*#__PURE__*/function (_Schema) {
       return new StringSchema(_objectSpread2(_objectSpread2({}, this.options), {}, {
         regexp: _regexp,
         regExpMessage: message
-      }), this.opt, this.isRaw, this.customValidateFunctions, this.renderInput, this.isReadonly, this.isHidden, this.description, this.previewInput);
+      }), this.opt, this.isRaw, this.customValidateFunctions, this.renderInput, this.isReadonly, this.isHidden, this.description, this.previewInput, this.isMultiline);
     }
   }, {
     key: "validate",
     value: function validate(validationFunction) {
-      return new StringSchema(this.options, this.opt, this.isRaw, this.customValidateFunctions.concat(validationFunction), this.renderInput, this.isReadonly, this.isHidden, this.description, this.previewInput);
+      return new StringSchema(this.options, this.opt, this.isRaw, this.customValidateFunctions.concat(validationFunction), this.renderInput, this.isReadonly, this.isHidden, this.description, this.previewInput, this.isMultiline);
     }
   }, {
     key: "executeValidate",
@@ -584,22 +586,22 @@ var StringSchema = /*#__PURE__*/function (_Schema) {
   }, {
     key: "nullable",
     value: function nullable() {
-      return new StringSchema(this.options, true, this.isRaw, this.customValidateFunctions, this.renderInput, this.isReadonly, this.isHidden, this.description, this.previewInput);
+      return new StringSchema(this.options, true, this.isRaw, this.customValidateFunctions, this.renderInput, this.isReadonly, this.isHidden, this.description, this.previewInput, this.isMultiline);
     }
   }, {
     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);
+      return new StringSchema(this.options, this.opt, this.isRaw, this.customValidateFunctions, this.renderInput, true, 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);
+      return new StringSchema(this.options, this.opt, this.isRaw, this.customValidateFunctions, this.renderInput, this.isReadonly, true, this.description, this.previewInput, this.isMultiline);
     }
   }, {
     key: "raw",
     value: function raw() {
-      return new StringSchema(this.options, this.opt, true, this.customValidateFunctions, this.renderInput, this.isReadonly, this.isHidden, this.description, this.previewInput);
+      return new StringSchema(this.options, this.opt, true, this.customValidateFunctions, this.renderInput, this.isReadonly, this.isHidden, this.description, this.previewInput, this.isMultiline);
     }
   }, {
     key: "executeCustomValidateAt",
@@ -615,6 +617,7 @@ var StringSchema = /*#__PURE__*/function (_Schema) {
       return {
         type: "string",
         render: (_this$renderInput = this.renderInput) !== null && _this$renderInput !== void 0 ? _this$renderInput : undefined,
+        multiline: this.isMultiline ? true : undefined,
         preview: this.previewInput ? true : undefined,
         options: {
           maxLength: (_this$options4 = this.options) === null || _this$options4 === void 0 ? void 0 : _this$options4.maxLength,
@@ -636,8 +639,27 @@ var StringSchema = /*#__PURE__*/function (_Schema) {
     }
 
     /**
-     * How this field is laid out in the editor: a textarea, or a code editor for
-     * the given language.
+     * This string holds text that may run to several lines: the editor gives it a
+     * growing text box instead of a single-line input.
+     *
+     * Nothing else changes — the value is still a plain string, and no validation
+     * is added or removed. For code, use `s.code({ language })` instead, which is
+     * its own schema type.
+     *
+     * @example
+     * const schema = s.string().multiline();
+     * export default c.define("/example.val.ts", schema, "Line one\nLine two");
+     */
+  }, {
+    key: "multiline",
+    value: function multiline() {
+      return new StringSchema(this.options, this.opt, this.isRaw, this.customValidateFunctions, this.renderInput, this.isReadonly, this.isHidden, this.description, this.previewInput, true);
+    }
+
+    /**
+     * 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`. What a CONTAINER
      * shows for its items is a `preview`, which is a different thing entirely.
@@ -645,7 +667,7 @@ var StringSchema = /*#__PURE__*/function (_Schema) {
   }, {
     key: "render",
     value: function render(input) {
-      return new StringSchema(this.options, this.opt, this.isRaw, this.customValidateFunctions, input, this.isReadonly, this.isHidden, this.description, this.previewInput);
+      return new StringSchema(this.options, this.opt, this.isRaw, this.customValidateFunctions, input, this.isReadonly, this.isHidden, this.description, this.previewInput, this.isMultiline);
     }
 
     /**
@@ -656,7 +678,7 @@ var StringSchema = /*#__PURE__*/function (_Schema) {
   }, {
     key: "preview",
     value: function preview(select) {
-      return new StringSchema(this.options, this.opt, this.isRaw, this.customValidateFunctions, this.renderInput, this.isReadonly, this.isHidden, this.description, select);
+      return new StringSchema(this.options, this.opt, this.isRaw, this.customValidateFunctions, this.renderInput, this.isReadonly, this.isHidden, this.description, select, this.isMultiline);
     }
   }, {
     key: "executePreviewItem",
@@ -2096,6 +2118,30 @@ function fillFromGallery(src, schema, getModuleSource) {
   } : {});
 }
 
+/**
+ * How an uploaded image is re-encoded in the browser, before it is uploaded.
+ *
+ * Off unless a schema asks for it. When it is on, the image is converted to
+ * `type` and scaled down to fit `maxWidth` x `maxHeight` - unless the result
+ * would be BIGGER than the original and no downscale was needed, in which case
+ * the original bytes are kept. See `architecture/media.md`.
+ *
+ * `type` is required so that adding a format later is additive: a schema
+ * written today keeps saying exactly which format it asked for.
+ */
+
+/** `false` (or absent) uploads the bytes exactly as the editor picked them. */
+
+/**
+ * What a GALLERY-BACKED field may say for itself.
+ *
+ * Not `ImageOptions`: `directory` and `accept` belong to the gallery, and a
+ * field repeating them is how two copies of one fact get to disagree. `encode`
+ * is different — it describes what happens to the bytes on their way IN, so a
+ * field that wants the original where its gallery re-encodes has to be able to
+ * say `encode: false`, and there is nowhere else to say it.
+ */
+
 var ImageSchema = /*#__PURE__*/function (_Schema) {
   function ImageSchema(options) {
     var _this;
@@ -2427,7 +2473,7 @@ var ImageSchema = /*#__PURE__*/function (_Schema) {
 
 /** An image of its own, carrying its own dimensions and mime type. */
 
-function image(options) {
+function image(options, galleryOptions) {
   var isModule = !!options && !!Internal.getValPath(options);
   if (isModule) {
     var allModules = {};
@@ -2439,7 +2485,9 @@ function image(options) {
       }
       allModules[modulePath] = getSource(valModule);
     }
-    return new ImageSchema({}, false, false, [], allModules);
+    return new ImageSchema((galleryOptions === null || galleryOptions === void 0 ? void 0 : galleryOptions.encode) !== undefined ? {
+      encode: galleryOptions.encode
+    } : {}, false, false, [], allModules);
   }
   return new ImageSchema(options);
 }
@@ -4118,6 +4166,9 @@ var RecordSchema = /*#__PURE__*/function (_Schema) {
         result.accept = this.mediaOptions.accept;
         result.directory = this.mediaOptions.directory;
         result.remote = this.mediaOptions.remote;
+        if (this.mediaOptions.encode !== undefined) {
+          result.encode = this.mediaOptions.encode;
+        }
         if (this.mediaOptions.altSchema) {
           result.alt = this.mediaOptions.altSchema["executeSerialize"]();
         }
@@ -6305,6 +6356,184 @@ var datetime = function datetime(options) {
   return new DateTimeSchema(options);
 };
 
+/**
+ * The list is the declaration and {@link CodeLanguage} is derived from it, so
+ * that a validator elsewhere (`shared`'s zod schema) can enumerate the same
+ * languages without a second copy that drifts. Same shape as `COLOR_FORMATS`.
+ */
+var CODE_LANGUAGES = ["typescript", "javascript", "javascriptreact", "typescriptreact", "json", "java", "html", "css", "xml", "markdown", "sql", "python", "rust", "php", "go", "cpp", "sass", "vue", "angular"];
+/**
+ * A string edited in a code editor.
+ *
+ * Its own schema type rather than a layout on `s.string()`: the language is
+ * part of what the content IS, not of how one field happens to be drawn, and
+ * being a type is what lets the value stay out of stega encoding — invisible
+ * characters woven into source code are not something a consumer can render.
+ */
+var CodeSchema = /*#__PURE__*/function (_Schema) {
+  function CodeSchema(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;
+    var renderInput = arguments.length > 6 && arguments[6] !== undefined ? arguments[6] : null;
+    var previewInput = arguments.length > 7 && arguments[7] !== undefined ? arguments[7] : null;
+    _classCallCheck(this, CodeSchema);
+    _this = _callSuper(this, CodeSchema);
+    _this.options = options;
+    _this.opt = opt;
+    _this.customValidateFunctions = customValidateFunctions;
+    _this.isReadonly = isReadonly;
+    _this.isHidden = isHidden;
+    _this.description = description;
+    _this.renderInput = renderInput;
+    _this.previewInput = previewInput;
+    return _this;
+  }
+  _inherits(CodeSchema, _Schema);
+  return _createClass(CodeSchema, [{
+    key: "describe",
+    value: function describe(description) {
+      return new CodeSchema(this.options, 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 CodeSchema(this.options, this.opt, [].concat(_toConsumableArray(this.customValidateFunctions), [validationFunction]), this.isReadonly, this.isHidden, this.description, this.renderInput, this.previewInput);
+    }
+  }, {
+    key: "executeCustomValidateAt",
+    value: function executeCustomValidateAt(path, src) {
+      return this.executeCustomValidateFunctions(src, this.customValidateFunctions, {
+        path: path
+      });
+    }
+  }, {
+    key: "executeValidate",
+    value: function executeValidate(path, src) {
+      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(src === null ? "null" : _typeof(src), "'"),
+          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 (typeof src !== "string") {
+        return {
+          success: false,
+          errors: _defineProperty({}, path, [{
+            message: "Expected 'string', got '".concat(src === null ? "null" : _typeof(src), "'"),
+            typeError: true
+          }])
+        };
+      }
+      return {
+        success: true,
+        data: src
+      };
+    }
+  }, {
+    key: "nullable",
+    value: function nullable() {
+      return new CodeSchema(this.options, true, [], this.isReadonly, this.isHidden, this.description, this.renderInput, this.previewInput);
+    }
+  }, {
+    key: "readonly",
+    value: function readonly() {
+      return new CodeSchema(this.options, this.opt, this.customValidateFunctions, true, 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);
+    }
+
+    /**
+     * 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 CodeSchema(this.options, 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 CodeSchema(this.options, 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: "code",
+        render: (_this$renderInput = this.renderInput) !== null && _this$renderInput !== void 0 ? _this$renderInput : undefined,
+        preview: this.previewInput ? true : undefined,
+        options: this.options,
+        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 code = function code(options) {
+  return new CodeSchema(options);
+};
+
 /**
  * Parsing / formatting of the CSS color strings stored by `s.color()`.
  *
@@ -7051,7 +7280,8 @@ var images = function images(options) {
     accept: (_options$accept = options.accept) !== null && _options$accept !== void 0 ? _options$accept : "image/*",
     directory: directory,
     remote: (_options$remote = options.remote) !== null && _options$remote !== void 0 ? _options$remote : false,
-    altSchema: altSchema
+    altSchema: altSchema,
+    encode: options.encode
   });
 };
 
@@ -7082,6 +7312,7 @@ function initSchema() {
     date: date,
     datetime: datetime,
     color: color,
+    code: code,
     route: route,
     router: router,
     images: images
@@ -7895,7 +8126,7 @@ function hasRemoteFileSchema(schema) {
       }
     }
     return false;
-  } else if (schema.type === "boolean" || schema.type === "number" || schema.type === "string" || schema.type === "literal" || schema.type === "date" || schema.type === "dateTime" || schema.type === "color" || schema.type === "keyOf" || schema.type === "route") {
+  } else if (schema.type === "boolean" || schema.type === "number" || schema.type === "string" || schema.type === "literal" || schema.type === "date" || schema.type === "dateTime" || schema.type === "color" || schema.type === "code" || schema.type === "keyOf" || schema.type === "route") {
     return false;
   } else {
     var exhaustiveCheck = schema;
@@ -8794,10 +9025,16 @@ function createRemoteRef(remoteHost, _ref) {
  */
 function getValidationBasis(coreVersion, schema, fileExt, metadata, fileHash) {
   var metadataValidationBasis = "".concat((metadata === null || metadata === void 0 ? void 0 : metadata.width) || "").concat((metadata === null || metadata === void 0 ? void 0 : metadata.height) || "").concat(metadata === null || metadata === void 0 ? void 0 : metadata.mimeType);
+  var options = _objectSpread2({}, schema.options);
+  // Ignore options that do not affect the validation basis below:
+  // `encode` says how the bytes were PRODUCED in the browser, not whether the
+  // bytes that arrived are valid. Leaving it in would mean that changing a
+  // quality setting re-validates every remote file in the project.
+  delete options.encode;
   var schemaValidationBasis = {
     type: schema.type,
     opt: schema.opt,
-    options: _objectSpread2({}, schema.options)
+    options: options
   };
   return coreVersion + JSON.stringify(schemaValidationBasis) + fileExt + metadataValidationBasis + fileHash;
 }
@@ -8824,7 +9061,7 @@ function deserializeSchema(serialized) {
   return schema;
 }
 function deserializeSchemaImpl(serialized) {
-  var _serialized$options, _serialized$options2, _serialized$render, _serialized$render2, _serialized$render3, _serialized$render4, _serialized$render5, _serialized$render6, _serialized$render7, _serialized$accept, _serialized$directory, _serialized$remote, _serialized$jsonValue, _serialized$render9, _serialized$render0, _serialized$render10, _serialized$render11, _serialized$render12, _serialized$render13, _serialized$render14;
+  var _serialized$options, _serialized$options2, _serialized$render, _serialized$multiline, _serialized$render2, _serialized$render3, _serialized$render4, _serialized$render5, _serialized$render6, _serialized$render7, _serialized$accept, _serialized$directory, _serialized$remote, _serialized$jsonValue, _serialized$render9, _serialized$render0, _serialized$render10, _serialized$render11, _serialized$render12, _serialized$render13, _serialized$render14, _serialized$render15;
   switch (serialized.type) {
     case "string":
       return new StringSchema(_objectSpread2(_objectSpread2({}, serialized.options), {}, {
@@ -8833,7 +9070,7 @@ function deserializeSchemaImpl(serialized) {
       }), serialized.opt, serialized.raw, [], // A render is static data, so it survives serialization and must be
       // carried back: it is the schema's own configuration now, not something
       // recomputed from an instance.
-      (_serialized$render = serialized.render) !== null && _serialized$render !== void 0 ? _serialized$render : null, false, false, serialized.description);
+      (_serialized$render = serialized.render) !== null && _serialized$render !== void 0 ? _serialized$render : null, false, false, serialized.description, null, (_serialized$multiline = serialized.multiline) !== null && _serialized$multiline !== void 0 ? _serialized$multiline : false);
     case "literal":
       return new LiteralSchema(serialized.value, serialized.opt, [], false, false, serialized.description, (_serialized$render2 = serialized.render) !== null && _serialized$render2 !== void 0 ? _serialized$render2 : null);
     case "boolean":
@@ -8902,6 +9139,8 @@ function deserializeSchemaImpl(serialized) {
       return new DateTimeSchema(serialized.options, serialized.opt, [], false, false, serialized.description, (_serialized$render13 = serialized.render) !== null && _serialized$render13 !== void 0 ? _serialized$render13 : null);
     case "color":
       return new ColorSchema(serialized.options, serialized.opt, [], false, false, serialized.description, (_serialized$render14 = serialized.render) !== null && _serialized$render14 !== void 0 ? _serialized$render14 : null);
+    case "code":
+      return new CodeSchema(serialized.options, serialized.opt, [], false, false, serialized.description, (_serialized$render15 = serialized.render) !== null && _serialized$render15 !== void 0 ? _serialized$render15 : null);
     default:
       {
         var exhaustiveCheck = serialized;
@@ -9054,10 +9293,14 @@ function previewScope(paths) {
 
 /**
  * A RENDER is how the FIELD ITSELF is laid out in the editor, and it applies
- * only when you are looking at the field: `s.string().render({ as: "textarea"
- * })`, `.render({ as: "code", language })`, `.render({ as: "inline" })` on an
+ * only when you are looking at the field: `.render({ as: "inline" })` on an
  * array/record item.
  *
+ * It is deliberately the ONE thing a render can say. What a string looks like
+ * when it holds more than a line is the schema's own business — `.multiline()`
+ * for a text box, `s.code({ language })` for a code editor — not a layout
+ * bolted onto `s.string()` from outside.
+ *
  * A PREVIEW (`preview.ts`) is the other thing: how the VALUE is shown wherever
  * a preview of it is needed — a list row, a reference dropdown, a search hit —
  * that is, wherever the value is navigable to rather than open. The two never
@@ -9078,13 +9321,6 @@ function previewScope(paths) {
  * `render` its own execute/store pair again. It is NOT to re-merge the two:
  * conflating them is what this file was split up to undo.
  */
-/**
- * The list is the declaration and {@link CodeLanguage} is derived from it, so
- * that a validator elsewhere (`shared`'s zod schema) can enumerate the same
- * languages without a second copy that drifts. Same shape as `COLOR_FORMATS`.
- */
-var CODE_LANGUAGES = ["typescript", "javascript", "javascriptreact", "typescriptreact", "json", "java", "html", "css", "xml", "markdown", "sql", "python", "rust", "php", "go", "cpp", "sass", "vue", "angular"];
-
 /**
  * `{ as: "inline" }` on a field that is the ITEM of an array or record: the
  * container renders the field itself inside each (sortable) row, instead of a
@@ -9100,15 +9336,47 @@ var CODE_LANGUAGES = ["typescript", "javascript", "javascriptreact", "typescript
  */
 
 /**
- * What `.render(...)` takes on every field except `s.string()`, and what the
- * serialized schema carries verbatim.
+ * What `.render(...)` takes on every field, and what the serialized schema
+ * carries verbatim.
  */
 
 /**
- * What `s.string().render(...)` takes, and what the serialized schema carries
- * verbatim. A string has editor layouts of its own (textarea, code) in
- * addition to the container-facing `inline`.
+ * Is this item schema edited INSIDE its list row, rather than behind a
+ * clickable preview row that navigates to it?
+ *
+ * The one answer, so that the list rows, the nav-stop rule (`getNavPath`) and
+ * the add buttons cannot drift apart — they are three readings of the same
+ * question, and a disagreement between them is a row you can edit in place but
+ * that "add" navigates away from.
+ *
+ * A tagged union counts as inline when the union itself declares it OR when
+ * ANY of its variants does. A page-builder list is `s.array(s.union("type",
+ * block, block, ...))` and the natural place to write the render is on the
+ * blocks, one per block type — the union is a dispatch, not something the
+ * author thinks of as the field. `some` rather than `every` because the row
+ * draws the union's own editor (the tag selector plus the matched variant's
+ * fields), which handles every variant either way: with `every`, adding one
+ * variant and forgetting its `.render` would silently turn the whole list back
+ * into preview rows.
+ *
+ * This is the ONLY place a render is allowed to be read from anywhere but the
+ * schema it was declared on. It stays static (see the top of this file): the
+ * answer is a function of the serialized schema alone, never of the value the
+ * row happens to hold.
  */
+function isInlineRender(schema) {
+  var _schema$render;
+  if (((_schema$render = schema.render) === null || _schema$render === void 0 ? void 0 : _schema$render.as) === "inline") {
+    return true;
+  }
+  if (schema.type === "union") {
+    return schema.items.some(function (item) {
+      var _item$render;
+      return ((_item$render = item.render) === null || _item$render === void 0 ? void 0 : _item$render.as) === "inline";
+    });
+  }
+  return false;
+}
 
 var externalPageRouter = {
   getRouterId: function getRouterId() {
@@ -9478,6 +9746,7 @@ exports.ArraySchema = ArraySchema;
 exports.BooleanSchema = BooleanSchema;
 exports.CODE_LANGUAGES = CODE_LANGUAGES;
 exports.COLOR_FORMATS = COLOR_FORMATS;
+exports.CodeSchema = CodeSchema;
 exports.ColorSchema = ColorSchema;
 exports.DEFAULT_APP_HOST = DEFAULT_APP_HOST;
 exports.DEFAULT_COLOR_FORMAT = DEFAULT_COLOR_FORMAT;
@@ -9515,6 +9784,7 @@ exports.extractValModules = extractValModules;
 exports.getSourcePathFromRoute = getSourcePathFromRoute;
 exports.hasRemoteFileSchema = hasRemoteFileSchema;
 exports.initVal = initVal;
+exports.isInlineRender = isInlineRender;
 exports.modules = modules;
 exports.previewScope = previewScope;
 exports.splitModuleFilePathAndModulePath = splitModuleFilePathAndModulePath;

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

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var dist_valbuildCore = require('./index-bce560db.cjs.dev.js');
+var dist_valbuildCore = require('./index-9f6baa46.cjs.dev.js');
 require('./result-bb1f436e.cjs.dev.js');
 
 
@@ -11,6 +11,7 @@ exports.ArraySchema = dist_valbuildCore.ArraySchema;
 exports.BooleanSchema = dist_valbuildCore.BooleanSchema;
 exports.CODE_LANGUAGES = dist_valbuildCore.CODE_LANGUAGES;
 exports.COLOR_FORMATS = dist_valbuildCore.COLOR_FORMATS;
+exports.CodeSchema = dist_valbuildCore.CodeSchema;
 exports.ColorSchema = dist_valbuildCore.ColorSchema;
 exports.DEFAULT_APP_HOST = dist_valbuildCore.DEFAULT_APP_HOST;
 exports.DEFAULT_COLOR_FORMAT = dist_valbuildCore.DEFAULT_COLOR_FORMAT;
@@ -42,5 +43,6 @@ exports.extractValModules = dist_valbuildCore.extractValModules;
 exports.getSourcePathFromRoute = dist_valbuildCore.getSourcePathFromRoute;
 exports.hasRemoteFileSchema = dist_valbuildCore.hasRemoteFileSchema;
 exports.initVal = dist_valbuildCore.initVal;
+exports.isInlineRender = dist_valbuildCore.isInlineRender;
 exports.modules = dist_valbuildCore.modules;
 exports.previewScope = dist_valbuildCore.previewScope;

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

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var dist_valbuildCore = require('./index-77914667.cjs.prod.js');
+var dist_valbuildCore = require('./index-f1992b0f.cjs.prod.js');
 require('./result-787e35f6.cjs.prod.js');
 
 
@@ -11,6 +11,7 @@ exports.ArraySchema = dist_valbuildCore.ArraySchema;
 exports.BooleanSchema = dist_valbuildCore.BooleanSchema;
 exports.CODE_LANGUAGES = dist_valbuildCore.CODE_LANGUAGES;
 exports.COLOR_FORMATS = dist_valbuildCore.COLOR_FORMATS;
+exports.CodeSchema = dist_valbuildCore.CodeSchema;
 exports.ColorSchema = dist_valbuildCore.ColorSchema;
 exports.DEFAULT_APP_HOST = dist_valbuildCore.DEFAULT_APP_HOST;
 exports.DEFAULT_COLOR_FORMAT = dist_valbuildCore.DEFAULT_COLOR_FORMAT;
@@ -42,5 +43,6 @@ exports.extractValModules = dist_valbuildCore.extractValModules;
 exports.getSourcePathFromRoute = dist_valbuildCore.getSourcePathFromRoute;
 exports.hasRemoteFileSchema = dist_valbuildCore.hasRemoteFileSchema;
 exports.initVal = dist_valbuildCore.initVal;
+exports.isInlineRender = dist_valbuildCore.isInlineRender;
 exports.modules = dist_valbuildCore.modules;
 exports.previewScope = dist_valbuildCore.previewScope;

package/dist/valbuild-core.esm.js

@@ -1,2 +1,2 @@
-export { A as ArraySchema, B as BooleanSchema, y as CODE_LANGUAGES, q as COLOR_FORMATS, C as ColorSchema, e as DEFAULT_APP_HOST, r as DEFAULT_COLOR_FORMAT, D as DEFAULT_CONTENT_HOST, j as DEFAULT_VAL_REMOTE_HOST, p as DateSchema, t as DateTimeSchema, F as FATAL_ERROR_TYPES, o as FileSchema, G as GenericSelector, n as ImageSchema, I as Internal, K as KeyOfSchema, L as LiteralSchema, M as ModuleFilePathSep, N as NumberSchema, O as ObjectSchema, R as RecordSchema, v as RichTextSchema, u as RouteSchema, S as Schema, l as StringSchema, U as UnionSchema, V as VAL_EXTENSION, g as computeValModuleShas, k as derefPatch, w as deserializeSchema, f as extractValModules, z as getSourcePathFromRoute, h as hasRemoteFileSchema, i as initVal, m as modules, x as previewScope } from './index-db33b67c.esm.js';
+export { A as ArraySchema, B as BooleanSchema, r as CODE_LANGUAGES, t as COLOR_FORMATS, q as CodeSchema, C as ColorSchema, e as DEFAULT_APP_HOST, u as DEFAULT_COLOR_FORMAT, D as DEFAULT_CONTENT_HOST, j as DEFAULT_VAL_REMOTE_HOST, p as DateSchema, v as DateTimeSchema, F as FATAL_ERROR_TYPES, o as FileSchema, G as GenericSelector, n as ImageSchema, I as Internal, K as KeyOfSchema, L as LiteralSchema, M as ModuleFilePathSep, N as NumberSchema, O as ObjectSchema, R as RecordSchema, x as RichTextSchema, w as RouteSchema, S as Schema, l as StringSchema, U as UnionSchema, V as VAL_EXTENSION, g as computeValModuleShas, k as derefPatch, y as deserializeSchema, f as extractValModules, H as getSourcePathFromRoute, h as hasRemoteFileSchema, i as initVal, E as isInlineRender, m as modules, z as previewScope } from './index-af98fc7c.esm.js';
 import './result-daff1cae.esm.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@valbuild/core",
-  "version": "0.109.0",
+  "version": "0.111.0",
   "private": false,
   "description": "Val - supercharged hard-coded content",
   "repository": {

package/patch/dist/valbuild-core-patch.cjs.dev.js

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var dist_valbuildCore = require('../../dist/index-bce560db.cjs.dev.js');
+var dist_valbuildCore = require('../../dist/index-9f6baa46.cjs.dev.js');
 var result = require('../../dist/result-bb1f436e.cjs.dev.js');
 var util = require('../../dist/util-b213092b.cjs.dev.js');
 

package/patch/dist/valbuild-core-patch.cjs.prod.js

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var dist_valbuildCore = require('../../dist/index-77914667.cjs.prod.js');
+var dist_valbuildCore = require('../../dist/index-f1992b0f.cjs.prod.js');
 var result = require('../../dist/result-787e35f6.cjs.prod.js');
 var util = require('../../dist/util-030d8a1f.cjs.prod.js');
 

package/patch/dist/valbuild-core-patch.esm.js

@@ -1,5 +1,5 @@
-import { _ as _typeof, a as _slicedToArray, P as PatchError, s as splitModuleFilePathAndModulePath, b as _createClass, c as _classCallCheck, d as _toConsumableArray } from '../../dist/index-db33b67c.esm.js';
-export { P as PatchError } from '../../dist/index-db33b67c.esm.js';
+import { _ as _typeof, a as _slicedToArray, P as PatchError, s as splitModuleFilePathAndModulePath, b as _createClass, c as _classCallCheck, d as _toConsumableArray } from '../../dist/index-af98fc7c.esm.js';
+export { P as PatchError } from '../../dist/index-af98fc7c.esm.js';
 import { f as isNonEmpty, e as err, o as ok, m as map, g as flatMap, i as isErr, h as flatMapReduce, j as filterOrElse, k as mapErr, l as map$1, n as all, p as flatten, q as allT } from '../../dist/result-daff1cae.esm.js';
 import { p as pipe } from '../../dist/util-18613e99.esm.js';