@valbuild/core 0.109.0 → 0.110.0

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

@@ -4,7 +4,7 @@ export { extractValModules, computeValModuleShas, type ExtractedValModules, type
 export type { InitVal, ValConfig, ValConstructor, ContentConstructor, } from "./initVal.js";
 export { Schema, type SerializedSchema, type SelectorOfSchema } from "./schema/index.js";
 export { hasRemoteFileSchema } from "./schema/hasRemoteFileSchema.js";
-export type { ImageMetadata } from "./schema/image.js";
+export type { ImageMetadata, ImageEncodeOption, ImageEncodeOptions, } from "./schema/image.js";
 export type { FileMetadata } from "./schema/file.js";
 export type { ValModule, SerializedModule, InferValModuleType } from "./module.js";
 export type { SourceObject, SourcePrimitive, Source } from "./source/index.js";
@@ -60,7 +60,7 @@ export { type SerializedUnionSchema, UnionSchema, type SerializedStringUnionSche
 export { type SerializedLiteralSchema, LiteralSchema } from "./schema/literal.js";
 export { deserializeSchema } from "./schema/deserialize.js";
 export { type PreviewItem, type ItemPreviewInput, type RecordPreview, type ArrayPreview, type ReifiedPreview, type PreviewScope, previewScope, } from "./preview.js";
-export { type CodeLanguage, type StringRender, type InlineRender, type FieldRender, CODE_LANGUAGES, } from "./render.js";
+export { type CodeLanguage, type StringRender, type InlineRender, type FieldRender, CODE_LANGUAGES, isInlineRender, } from "./render.js";
 export type { ValRouter, RouteValidationError } from "./router.js";
 export { getSourcePathFromRoute } from "./getSourcePathFromRoute.js";
 export declare const FATAL_ERROR_TYPES: readonly ["no-schema", "no-source", "invalid-id", "no-module", "invalid-patch"];

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

@@ -1,3 +1,4 @@
+import type { SerializedSchema } from "./schema/index.js";
 /**
  * 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"
@@ -63,3 +64,28 @@ export type StringRender = {
     as: "code";
     language: CodeLanguage;
 } | InlineRender;
+/**
+ * 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.
+ */
+export declare function isInlineRender(schema: SerializedSchema): boolean;

package/dist/declarations/src/schema/image.d.ts

@@ -6,11 +6,44 @@ import { ValModule } from "../index.js";
 import { ItemPreviewInput, PreviewItem, ReifiedPreview } from "../preview.js";
 import { FieldRender } from "../render.js";
 import { ImagesEntryMetadata } from "./images.js";
+/**
+ * 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.
+ */
+export type ImageEncodeOptions = {
+    type: "webp";
+    /** Passed to `canvas.toBlob`. Between 0 and 1. @default 0.8 */
+    quality?: number;
+    /** @default 2560 */
+    maxWidth?: number;
+    /** @default 2560 */
+    maxHeight?: number;
+};
+/** `false` (or absent) uploads the bytes exactly as the editor picked them. */
+export type ImageEncodeOption = false | ImageEncodeOptions;
+/**
+ * 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.
+ */
+export type GalleryImageOptions = {
+    encode?: ImageEncodeOption;
+};
 export type ImageOptions = {
-    ext?: ["jpg"] | ["webp"];
     directory?: string;
-    prefix?: string;
     accept?: string;
+    encode?: ImageEncodeOption;
 };
 export type SerializedImageSchema = {
     type: "image";
@@ -86,6 +119,6 @@ export declare class ImageSchema<Src extends ImageSource | null> extends Schema<
  * An image picked from a gallery. Its dimensions and mime type live in the
  * gallery, so the field carries only what a person typed.
  */
-export declare function image(galleryModule: ValModule<Record<string, ImagesEntryMetadata>>): ImageSchema<GalleryImageSource>;
+export declare function image(galleryModule: ValModule<Record<string, ImagesEntryMetadata>>, galleryOptions?: GalleryImageOptions): ImageSchema<GalleryImageSource>;
 /** An image of its own, carrying its own dimensions and mime type. */
 export declare function image(options?: ImageOptions): ImageSchema<ImageSource>;

package/dist/declarations/src/schema/images.d.ts

@@ -4,6 +4,7 @@ import { RecordSchema } from "./record.js";
 import { ObjectSchema } from "./object.js";
 import { StringSchema } from "./string.js";
 import { NumberSchema } from "./number.js";
+import type { ImageEncodeOption } from "./image.js";
 /**
  * Alt schema type - can be a string, nullable string, or a record of locale to string
  */
@@ -39,6 +40,13 @@ export type ImagesOptions<Accept extends `image/${string}`> = {
      * @default false
      */
     remote?: boolean;
+    /**
+     * Re-encode uploads in the browser before they are uploaded.
+     *
+     * Off unless set. A field backed by this gallery (`s.image(galleryVal)`)
+     * inherits it, the same way it inherits `accept` and `directory`.
+     */
+    encode?: ImageEncodeOption;
 };
 /**
  * Metadata for an image entry in the images record

package/dist/declarations/src/schema/record.d.ts

@@ -6,12 +6,15 @@ import { SelectorSource } from "../selector/index.js";
 import { JsonOf, JsonSource } from "../source/json.js";
 import { ModuleFilePath, SourcePath } from "../val/index.js";
 import { ValidationError, ValidationErrors } from "./validation/ValidationError.js";
+import type { ImageEncodeOption } from "./image.js";
 type MediaOptions = {
     type: "files" | "images";
     accept: string;
     directory: string;
     remote: boolean;
     altSchema?: Schema<SelectorSource>;
+    /** Images only: how uploads are re-encoded in the browser. See `image.ts`. */
+    encode?: ImageEncodeOption;
 };
 export type SerializedRecordSchema = {
     type: "record";
@@ -32,6 +35,7 @@ export type SerializedRecordSchema = {
     accept?: string;
     directory?: string;
     remote?: boolean;
+    encode?: ImageEncodeOption;
     alt?: SerializedSchema;
     jsonValues?: boolean;
     readonly?: boolean;

package/dist/{index-bce560db.cjs.dev.js → index-409a38c3.cjs.dev.js}

@@ -2096,6 +2096,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 +2451,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 +2463,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 +4144,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"]();
         }
@@ -7051,7 +7080,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
   });
 };
 
@@ -8794,10 +8824,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;
 }
@@ -9110,6 +9146,44 @@ var CODE_LANGUAGES = ["typescript", "javascript", "javascriptreact", "typescript
  * 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() {
     return "external-url-router";
@@ -9515,6 +9589,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/{index-77914667.cjs.prod.js → index-62ef4533.cjs.prod.js}

@@ -2096,6 +2096,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 +2451,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 +2463,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 +4144,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"]();
         }
@@ -7051,7 +7080,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
   });
 };
 
@@ -8794,10 +8824,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;
 }
@@ -9110,6 +9146,44 @@ var CODE_LANGUAGES = ["typescript", "javascript", "javascriptreact", "typescript
  * 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() {
     return "external-url-router";
@@ -9515,6 +9589,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/{index-db33b67c.esm.js → index-6652ab3c.esm.js}

@@ -2094,6 +2094,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;
@@ -2425,7 +2449,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 = {};
@@ -2437,7 +2461,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);
 }
@@ -4116,6 +4142,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"]();
         }
@@ -7049,7 +7078,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
   });
 };
 
@@ -8792,10 +8822,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;
 }
@@ -9108,6 +9144,44 @@ var CODE_LANGUAGES = ["typescript", "javascript", "javascriptreact", "typescript
  * 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() {
     return "external-url-router";
@@ -9472,4 +9546,4 @@ function tryJsonParse(str) {
   }
 }
 
-export { ArraySchema as A, BooleanSchema as B, ColorSchema as C, DEFAULT_CONTENT_HOST as D, FATAL_ERROR_TYPES as F, GenericSelector as G, 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, COLOR_FORMATS as q, DEFAULT_COLOR_FORMAT as r, splitModuleFilePathAndModulePath as s, DateTimeSchema as t, RouteSchema as u, RichTextSchema as v, deserializeSchema as w, previewScope as x, CODE_LANGUAGES as y, getSourcePathFromRoute as z };
+export { ArraySchema as A, BooleanSchema as B, ColorSchema as C, DEFAULT_CONTENT_HOST as D, getSourcePathFromRoute as E, FATAL_ERROR_TYPES as F, GenericSelector as G, 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, COLOR_FORMATS as q, DEFAULT_COLOR_FORMAT as r, splitModuleFilePathAndModulePath as s, DateTimeSchema as t, RouteSchema as u, RichTextSchema as v, deserializeSchema as w, previewScope as x, CODE_LANGUAGES as y, isInlineRender as z };

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-409a38c3.cjs.dev.js');
 require('./result-bb1f436e.cjs.dev.js');
 
 
@@ -42,5 +42,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-62ef4533.cjs.prod.js');
 require('./result-787e35f6.cjs.prod.js');
 
 
@@ -42,5 +42,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, 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, E as getSourcePathFromRoute, h as hasRemoteFileSchema, i as initVal, z as isInlineRender, m as modules, x as previewScope } from './index-6652ab3c.esm.js';
 import './result-daff1cae.esm.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@valbuild/core",
-  "version": "0.109.0",
+  "version": "0.110.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-409a38c3.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-62ef4533.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-6652ab3c.esm.js';
+export { P as PatchError } from '../../dist/index-6652ab3c.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';