@valbuild/core 0.103.0 → 0.105.1

package/dist/{index-267a8e9c.esm.js → index-005f51a5.esm.js}

@@ -581,10 +581,10 @@ var StringSchema = /*#__PURE__*/function (_Schema) {
   }, {
     key: "executeSerialize",
     value: function executeSerialize() {
-      var _this$options4, _this$options5, _this$options6, _this$customValidateF, _this$customValidateF2;
+      var _this$renderInput, _this$options4, _this$options5, _this$options6, _this$customValidateF, _this$customValidateF2;
       return {
         type: "string",
-        render: this.renderInput ? true : undefined,
+        render: (_this$renderInput = this.renderInput) !== null && _this$renderInput !== void 0 ? _this$renderInput : undefined,
         options: {
           maxLength: (_this$options4 = this.options) === null || _this$options4 === void 0 ? void 0 : _this$options4.maxLength,
           minLength: (_this$options5 = this.options) === null || _this$options5 === void 0 ? void 0 : _this$options5.minLength,
@@ -603,36 +603,28 @@ var StringSchema = /*#__PURE__*/function (_Schema) {
         description: this.description
       };
     }
+
+    /**
+     * How this field is laid out in the editor: a textarea, or a code editor for
+     * the given language.
+     *
+     * Static configuration, not a callback — see `render.ts`. What a CONTAINER
+     * shows for its items is a `preview`, which is a different thing entirely.
+     */
   }, {
     key: "render",
     value: function render(input) {
       return new StringSchema(this.options, this.opt, this.isRaw, this.customValidateFunctions, input, this.isReadonly, this.isHidden, this.description);
     }
+
+    /**
+     * Nothing: a string has no items, so there is nothing to preview. Its layout
+     * is a `render`, which travels in the serialized schema instead of through
+     * this pipeline.
+     */
   }, {
-    key: "executeRender",
-    value: function executeRender(sourcePath, src,
-    // Accepted and unused: a string's render is a static layout hint
-    // (`{as:"textarea"}` / `{as:"code",language}`) with no closure behind it, so
-    // there is nothing a scope could prune. Declared so the signature is uniform
-    // across every schema rather than something a reader has to check.
-    _scope) {
-      if (this.renderInput) {
-        if (this.renderInput.as === "code") {
-          return _defineProperty({}, sourcePath, {
-            status: "success",
-            data: {
-              layout: this.renderInput.as,
-              language: this.renderInput.language
-            }
-          });
-        }
-        return _defineProperty({}, sourcePath, {
-          status: "success",
-          data: {
-            layout: this.renderInput.as
-          }
-        });
-      }
+    key: "executePreview",
+    value: function executePreview() {
       return {};
     }
   }]);
@@ -827,8 +819,8 @@ var ObjectSchema = /*#__PURE__*/function (_Schema) {
       };
     }
   }, {
-    key: "executeRender",
-    value: function executeRender(sourcePath, src, scope) {
+    key: "executePreview",
+    value: function executePreview(sourcePath, src, scope) {
       var res = {};
       if (src === null) {
         return res;
@@ -839,13 +831,13 @@ var ObjectSchema = /*#__PURE__*/function (_Schema) {
           continue;
         }
         var subPath = unsafeCreateSourcePath(sourcePath, _key3);
-        // An object produces no render of its own, so it is pure recursion — and
+        // An object produces no preview of its own, so it is pure recursion — and
         // pruning it is the whole contribution: a field deep in one branch stops
-        // paying for every sibling branch's renders.
+        // paying for every sibling branch's previews.
         if (scope !== undefined && !scope.wantsUnder(subPath)) {
           continue;
         }
-        var itemResult = this.items[_key3]["executeRender"](subPath, itemSrc, scope);
+        var itemResult = this.items[_key3]["executePreview"](subPath, itemSrc, scope);
         for (var keyS in itemResult) {
           var _key4 = keyS;
           res[_key4] = itemResult[_key4];
@@ -872,7 +864,7 @@ var ArraySchema = /*#__PURE__*/function (_Schema) {
     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 > 6 && arguments[6] !== undefined ? arguments[6] : null;
     _classCallCheck(this, ArraySchema);
     _this = _callSuper(this, ArraySchema);
     _this.item = item;
@@ -881,19 +873,19 @@ var ArraySchema = /*#__PURE__*/function (_Schema) {
     _this.isReadonly = isReadonly;
     _this.isHidden = isHidden;
     _this.description = description;
-    _this.renderInput = renderInput;
+    _this.previewInput = previewInput;
     return _this;
   }
   _inherits(ArraySchema, _Schema);
   return _createClass(ArraySchema, [{
     key: "describe",
     value: function describe(description) {
-      return new ArraySchema(this.item, this.opt, this.customValidateFunctions, this.isReadonly, this.isHidden, description !== null && description !== void 0 ? description : undefined, this.renderInput);
+      return new ArraySchema(this.item, this.opt, this.customValidateFunctions, this.isReadonly, this.isHidden, description !== null && description !== void 0 ? description : undefined, this.previewInput);
     }
   }, {
     key: "validate",
     value: function validate(validationFunction) {
-      return new ArraySchema(this.item, this.opt, [].concat(_toConsumableArray(this.customValidateFunctions), [validationFunction]), this.isReadonly, this.isHidden, this.description, this.renderInput);
+      return new ArraySchema(this.item, this.opt, [].concat(_toConsumableArray(this.customValidateFunctions), [validationFunction]), this.isReadonly, this.isHidden, this.description, this.previewInput);
     }
   }, {
     key: "executeValidate",
@@ -960,17 +952,17 @@ var ArraySchema = /*#__PURE__*/function (_Schema) {
   }, {
     key: "nullable",
     value: function nullable() {
-      return new ArraySchema(this.item, true, [], this.isReadonly, this.isHidden, this.description, this.renderInput);
+      return new ArraySchema(this.item, true, [], this.isReadonly, this.isHidden, this.description, this.previewInput);
     }
   }, {
     key: "readonly",
     value: function readonly() {
-      return new ArraySchema(this.item, this.opt, this.customValidateFunctions, true, this.isHidden, this.description, this.renderInput);
+      return new ArraySchema(this.item, this.opt, this.customValidateFunctions, true, this.isHidden, this.description, this.previewInput);
     }
   }, {
     key: "hidden",
     value: function hidden() {
-      return new ArraySchema(this.item, this.opt, this.customValidateFunctions, this.isReadonly, true, this.description, this.renderInput);
+      return new ArraySchema(this.item, this.opt, this.customValidateFunctions, this.isReadonly, true, this.description, this.previewInput);
     }
   }, {
     key: "executeCustomValidateAt",
@@ -987,7 +979,7 @@ var ArraySchema = /*#__PURE__*/function (_Schema) {
         type: "array",
         item: this.item["executeSerialize"](),
         opt: this.opt,
-        render: this.renderInput ? true : undefined,
+        preview: this.previewInput ? true : undefined,
         customValidate: this.customValidateFunctions && ((_this$customValidateF = this.customValidateFunctions) === null || _this$customValidateF === void 0 ? void 0 : _this$customValidateF.length) > 0,
         readonly: this.isReadonly,
         hidden: this.isHidden,
@@ -995,8 +987,8 @@ var ArraySchema = /*#__PURE__*/function (_Schema) {
       };
     }
   }, {
-    key: "executeRender",
-    value: function executeRender(sourcePath, src, scope) {
+    key: "executePreview",
+    value: function executePreview(sourcePath, src, scope) {
       var res = {};
       if (src === null) {
         return res;
@@ -1011,26 +1003,18 @@ var ArraySchema = /*#__PURE__*/function (_Schema) {
         if (scope !== undefined && !scope.wantsUnder(subPath)) {
           continue;
         }
-        var itemResult = this.item["executeRender"](subPath, itemSrc, scope);
+        var itemResult = this.item["executePreview"](subPath, itemSrc, scope);
         for (var keyS in itemResult) {
           var _key = keyS;
           res[_key] = itemResult[_key];
         }
       }
-      if (this.renderInput) {
-        var _this$renderInput = this.renderInput,
-          select = _this$renderInput.select,
-          layout = _this$renderInput.as;
-        if (layout !== "list") {
-          res[sourcePath] = {
-            status: "error",
-            message: "Unknown layout type: " + layout
-          };
-        }
+      if (this.previewInput) {
+        var select = this.previewInput;
         // The whole list when the LIST is what is being shown; only the wanted
-        // rows when it is not. `select` is the user's closure and the real expense
-        // — a list view asks for the container and gets every row, a single field
-        // asks for its own path and costs one call.
+        // rows when it is not. The user's closure is the real expense — a list
+        // view asks for the container and gets every row, a single field asks for
+        // its own path and costs one call.
         // Non-null once, as a value, rather than a boolean the compiler cannot
         // tie back to `scope`: no scope and a scope that wants this exact path
         // both mean the whole list, and anything else is a window.
@@ -1040,10 +1024,10 @@ var ArraySchema = /*#__PURE__*/function (_Schema) {
           if (window !== null && !window.wantsUnder(unsafeCreateSourcePath(sourcePath, index))) {
             continue;
           }
-          // Per ITEM, not per list, matching what `record` already does: `select`
-          // is user code, and one row whose data trips it up must not take out the
-          // whole list. Before scoping, one throwing row produced an error at the
-          // container and no items at all.
+          // Per ITEM, not per list, matching what `record` already does: the
+          // closure is user code, and one row whose data trips it up must not take
+          // out the whole list. Before scoping, one throwing row produced an error
+          // at the container and no items at all.
           try {
             // NB NB: display is actually defined by the user
             var _select = select({
@@ -1067,7 +1051,6 @@ var ArraySchema = /*#__PURE__*/function (_Schema) {
         res[sourcePath] = {
           status: "success",
           data: {
-            layout: "list",
             parent: "array",
             items: items
           }
@@ -1075,10 +1058,18 @@ var ArraySchema = /*#__PURE__*/function (_Schema) {
       }
       return res;
     }
+
+    /**
+     * What the editor shows for each ITEM of this array: a title, and optionally a
+     * subtitle and an image.
+     *
+     * `select` is your own code over the item's source, so it is run on demand for
+     * the rows that are actually being looked at — see `PreviewScope`.
+     */
   }, {
-    key: "render",
-    value: function render(input) {
-      return new ArraySchema(this.item, this.opt, this.customValidateFunctions, this.isReadonly, this.isHidden, this.description, input);
+    key: "preview",
+    value: function preview(select) {
+      return new ArraySchema(this.item, this.opt, this.customValidateFunctions, this.isReadonly, this.isHidden, this.description, select);
     }
   }]);
 }(Schema);
@@ -1210,8 +1201,8 @@ var LiteralSchema = /*#__PURE__*/function (_Schema) {
       };
     }
   }, {
-    key: "executeRender",
-    value: function executeRender() {
+    key: "executePreview",
+    value: function executePreview() {
       return {};
     }
   }]);
@@ -1644,8 +1635,8 @@ var UnionSchema = /*#__PURE__*/function (_Schema) {
       };
     }
   }, {
-    key: "executeRender",
-    value: function executeRender(sourcePath, src, scope) {
+    key: "executePreview",
+    value: function executePreview(sourcePath, src, scope) {
       var res = {};
       if (src === null) {
         return res;
@@ -1667,7 +1658,7 @@ var UnionSchema = /*#__PURE__*/function (_Schema) {
           return false;
         });
         if (thisSchema) {
-          var itemResult = thisSchema["executeRender"](sourcePath, src, scope);
+          var itemResult = thisSchema["executePreview"](sourcePath, src, scope);
           for (var keyS in itemResult) {
             var _key3 = keyS;
             res[_key3] = itemResult[_key3];
@@ -2130,8 +2121,8 @@ var ImageSchema = /*#__PURE__*/function (_Schema) {
       };
     }
   }, {
-    key: "executeRender",
-    value: function executeRender() {
+    key: "executePreview",
+    value: function executePreview() {
       return {};
     }
   }]);
@@ -2327,8 +2318,8 @@ var RouteSchema = /*#__PURE__*/function (_Schema) {
       };
     }
   }, {
-    key: "executeRender",
-    value: function executeRender() {
+    key: "executePreview",
+    value: function executePreview() {
       return {};
     }
   }]);
@@ -2886,8 +2877,8 @@ var RichTextSchema = /*#__PURE__*/function (_Schema) {
       };
     }
   }, {
-    key: "executeRender",
-    value: function executeRender() {
+    key: "executePreview",
+    value: function executePreview() {
       return {};
     }
   }]);
@@ -3220,7 +3211,7 @@ var RecordSchema = /*#__PURE__*/function (_Schema) {
     var isHidden = arguments.length > 7 && arguments[7] !== undefined ? arguments[7] : false;
     var description = arguments.length > 8 ? arguments[8] : undefined;
     var isJsonValues = arguments.length > 9 && arguments[9] !== undefined ? arguments[9] : false;
-    var renderInput = arguments.length > 10 && arguments[10] !== undefined ? arguments[10] : null;
+    var previewInput = arguments.length > 10 && arguments[10] !== undefined ? arguments[10] : null;
     _classCallCheck(this, RecordSchema);
     _this = _callSuper(this, RecordSchema);
     _this.item = item;
@@ -3233,19 +3224,19 @@ var RecordSchema = /*#__PURE__*/function (_Schema) {
     _this.isHidden = isHidden;
     _this.description = description;
     _this.isJsonValues = isJsonValues;
-    _this.renderInput = renderInput;
+    _this.previewInput = previewInput;
     return _this;
   }
   _inherits(RecordSchema, _Schema);
   return _createClass(RecordSchema, [{
     key: "describe",
     value: function describe(description) {
-      return new RecordSchema(this.item, this.opt, this.customValidateFunctions, this.currentRouter, this.keySchema, this.mediaOptions, this.isReadonly, this.isHidden, description !== null && description !== void 0 ? description : undefined, this.isJsonValues, this.renderInput);
+      return new RecordSchema(this.item, this.opt, this.customValidateFunctions, this.currentRouter, this.keySchema, this.mediaOptions, this.isReadonly, this.isHidden, description !== null && description !== void 0 ? description : undefined, this.isJsonValues, this.previewInput);
     }
   }, {
     key: "validate",
     value: function validate(validationFunction) {
-      return new RecordSchema(this.item, this.opt, [].concat(_toConsumableArray(this.customValidateFunctions), [validationFunction]), this.currentRouter, this.keySchema, this.mediaOptions, this.isReadonly, this.isHidden, this.description, this.isJsonValues, this.renderInput);
+      return new RecordSchema(this.item, this.opt, [].concat(_toConsumableArray(this.customValidateFunctions), [validationFunction]), this.currentRouter, this.keySchema, this.mediaOptions, this.isReadonly, this.isHidden, this.description, this.isJsonValues, this.previewInput);
     }
   }, {
     key: "executeValidate",
@@ -3604,29 +3595,29 @@ var RecordSchema = /*#__PURE__*/function (_Schema) {
   }, {
     key: "nullable",
     value: function nullable() {
-      return new RecordSchema(this.item, true, this.customValidateFunctions, this.currentRouter, this.keySchema, this.mediaOptions, this.isReadonly, this.isHidden, this.description, this.isJsonValues, this.renderInput);
+      return new RecordSchema(this.item, true, this.customValidateFunctions, this.currentRouter, this.keySchema, this.mediaOptions, this.isReadonly, this.isHidden, this.description, this.isJsonValues, this.previewInput);
     }
   }, {
     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.renderInput);
+      return new RecordSchema(this.item, this.opt, this.customValidateFunctions, this.currentRouter, this.keySchema, this.mediaOptions, true, this.isHidden, this.description, this.isJsonValues, this.previewInput);
     }
   }, {
     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.renderInput);
+      return new RecordSchema(this.item, this.opt, this.customValidateFunctions, this.currentRouter, this.keySchema, this.mediaOptions, this.isReadonly, true, this.description, this.isJsonValues, this.previewInput);
     }
   }, {
     key: "router",
     value: function router(_router) {
-      return new RecordSchema(this.item, this.opt, this.customValidateFunctions, _router, this.keySchema, this.mediaOptions, this.isReadonly, this.isHidden, this.description, this.isJsonValues, this.renderInput);
+      return new RecordSchema(this.item, this.opt, this.customValidateFunctions, _router, this.keySchema, this.mediaOptions, this.isReadonly, this.isHidden, this.description, this.isJsonValues, this.previewInput);
     }
   }, {
     key: "remote",
     value: function remote() {
       return new RecordSchema(this.item, this.opt, this.customValidateFunctions, this.currentRouter, this.keySchema, this.mediaOptions ? _objectSpread2(_objectSpread2({}, this.mediaOptions), {}, {
         remote: true
-      }) : undefined, this.isReadonly, this.isHidden, this.description, this.isJsonValues, this.renderInput);
+      }) : undefined, this.isReadonly, this.isHidden, this.description, this.isJsonValues, this.previewInput);
     }
 
     /**
@@ -3658,7 +3649,7 @@ var RecordSchema = /*#__PURE__*/function (_Schema) {
       }
       return new RecordSchema(this.item, this.opt,
       // Empty by construction: the guard above rejects any that were registered.
-      [], this.currentRouter, this.keySchema, this.mediaOptions, this.isReadonly, this.isHidden, this.description, true, this.renderInput);
+      [], this.currentRouter, this.keySchema, this.mediaOptions, this.isReadonly, this.isHidden, this.description, true, this.previewInput);
     }
   }, {
     key: "getRouterValidations",
@@ -3718,7 +3709,7 @@ var RecordSchema = /*#__PURE__*/function (_Schema) {
         item: this.item["executeSerialize"](),
         key: (_this$keySchema = this.keySchema) === null || _this$keySchema === void 0 ? void 0 : _this$keySchema["executeSerialize"](),
         opt: this.opt,
-        render: this.renderInput ? true : undefined,
+        preview: this.previewInput ? true : undefined,
         router: (_this$currentRouter = this.currentRouter) === null || _this$currentRouter === void 0 ? void 0 : _this$currentRouter.getRouterId(),
         customValidate: this.customValidateFunctions && ((_this$customValidateF = this.customValidateFunctions) === null || _this$customValidateF === void 0 ? void 0 : _this$customValidateF.length) > 0,
         jsonValues: this.isJsonValues ? true : undefined,
@@ -3750,8 +3741,8 @@ var RecordSchema = /*#__PURE__*/function (_Schema) {
       return this.item["executeValidate"](path, content);
     }
   }, {
-    key: "executeRender",
-    value: function executeRender(sourcePath, src, scope) {
+    key: "executePreview",
+    value: function executePreview(sourcePath, src, scope) {
       var res = {};
       if (src === null) {
         return res;
@@ -3763,31 +3754,23 @@ var RecordSchema = /*#__PURE__*/function (_Schema) {
         }
         if (isJson(itemSrc)) {
           // An un-loaded `.jsonValues()` entry: an opaque marker, not the item this
-          // schema describes. Skipping it is what makes rendering a partially
+          // schema describes. Skipping it is what makes previewing a partially
           // loaded record work — the result comes out covering exactly the loaded
-          // keys, and the caller renders a placeholder for the rest.
+          // keys, and the caller shows a placeholder for the rest.
           continue;
         }
         var subPath = unsafeCreateSourcePath(sourcePath, _key);
         if (scope !== undefined && !scope.wantsUnder(subPath)) {
           continue;
         }
-        var itemResult = this.item["executeRender"](subPath, itemSrc, scope);
+        var itemResult = this.item["executePreview"](subPath, itemSrc, scope);
         for (var keyS in itemResult) {
           var _key2 = keyS;
           res[_key2] = itemResult[_key2];
         }
       }
-      if (this.renderInput) {
-        var _this$renderInput = this.renderInput,
-          prepare = _this$renderInput.select,
-          layout = _this$renderInput.layout;
-        if (layout !== "list") {
-          res[sourcePath] = {
-            status: "error",
-            message: "Unknown layout type: " + layout
-          };
-        }
+      if (this.previewInput) {
+        var prepare = this.previewInput;
         // See the same block in `array`: the whole record when the record is what
         // is being shown, only the wanted entries when it is not.
         var window = scope !== undefined && !scope.wants(sourcePath) ? scope : null;
@@ -3802,7 +3785,7 @@ var RecordSchema = /*#__PURE__*/function (_Schema) {
           if (window !== null && !window.wantsUnder(unsafeCreateSourcePath(sourcePath, _key3))) {
             continue;
           }
-          // Per KEY, not per record: `select` is user code, and one entry whose
+          // Per KEY, not per record: the closure is user code, and one entry whose
           // data trips it up must not take out the whole list.
           try {
             // NB NB: display is actually defined by the user
@@ -3828,7 +3811,6 @@ var RecordSchema = /*#__PURE__*/function (_Schema) {
         res[sourcePath] = {
           status: "success",
           data: {
-            layout: "list",
             parent: "record",
             items: items
           }
@@ -3836,13 +3818,19 @@ var RecordSchema = /*#__PURE__*/function (_Schema) {
       }
       return res;
     }
+
+    /**
+     * What the editor shows for each ENTRY of this record: a title, and optionally
+     * a subtitle and an image.
+     *
+     * `select` is your own code over the entry's key and source, so it is run on
+     * demand for the entries that are actually being looked at — see
+     * `PreviewScope`.
+     */
   }, {
-    key: "render",
-    value: function render(input) {
-      return new RecordSchema(this.item, this.opt, this.customValidateFunctions, this.currentRouter, this.keySchema, this.mediaOptions, this.isReadonly, this.isHidden, this.description, this.isJsonValues, {
-        layout: input.as,
-        select: input.select
-      });
+    key: "preview",
+    value: function preview(select) {
+      return new RecordSchema(this.item, this.opt, this.customValidateFunctions, this.currentRouter, this.keySchema, this.mediaOptions, this.isReadonly, this.isHidden, this.description, this.isJsonValues, select);
     }
   }]);
 }(Schema);
@@ -4535,8 +4523,8 @@ var NumberSchema = /*#__PURE__*/function (_Schema) {
       };
     }
   }, {
-    key: "executeRender",
-    value: function executeRender() {
+    key: "executePreview",
+    value: function executePreview() {
       return {};
     }
   }]);
@@ -4655,8 +4643,8 @@ var BooleanSchema = /*#__PURE__*/function (_Schema) {
       };
     }
   }, {
-    key: "executeRender",
-    value: function executeRender() {
+    key: "executePreview",
+    value: function executePreview() {
       return {};
     }
   }]);
@@ -4879,8 +4867,8 @@ var KeyOfSchema = /*#__PURE__*/function (_Schema) {
       };
     }
   }, {
-    key: "executeRender",
-    value: function executeRender() {
+    key: "executePreview",
+    value: function executePreview() {
       return {};
     }
   }]);
@@ -5163,8 +5151,8 @@ var FileSchema = /*#__PURE__*/function (_Schema) {
       };
     }
   }, {
-    key: "executeRender",
-    value: function executeRender() {
+    key: "executePreview",
+    value: function executePreview() {
       return {};
     }
   }]);
@@ -5394,8 +5382,8 @@ var DateSchema = /*#__PURE__*/function (_Schema) {
       };
     }
   }, {
-    key: "executeRender",
-    value: function executeRender() {
+    key: "executePreview",
+    value: function executePreview() {
       return {};
     }
   }]);
@@ -5598,8 +5586,8 @@ var DateTimeSchema = /*#__PURE__*/function (_Schema) {
       };
     }
   }, {
-    key: "executeRender",
-    value: function executeRender() {
+    key: "executePreview",
+    value: function executePreview() {
       return {};
     }
   }]);
@@ -6239,8 +6227,8 @@ var ColorSchema = /*#__PURE__*/function (_Schema) {
       };
     }
   }, {
-    key: "executeRender",
-    value: function executeRender() {
+    key: "executePreview",
+    value: function executePreview() {
       return {};
     }
   }]);
@@ -6820,6 +6808,84 @@ function collectObjectRecursive(item, collector) {
   }
 }
 
+/**
+ * One module's contribution to the SHAs, in fold order.
+ *
+ * The SHAs are a FOLD, not a hash of a set: each module is mixed into the
+ * running value in `val.modules` order, so reproducing one means replaying the
+ * same modules with the same inputs in the same order. That is what this type
+ * is for — see {@link computeValModuleShas}.
+ */
+
+/**
+ * The SHAs, from the entries they are a fold over.
+ *
+ * Split out from {@link extractValModules} because there are two ways to arrive
+ * at a set of sources. Extraction evaluates the modules; the server also
+ * PROMOTES the sources it has just written to disk, because re-evaluating gets
+ * it nothing — a module `def` is the app's own `import()`, which resolves from
+ * the module registry rather than from the file that was just rewritten. Both
+ * have to produce SHAs the other side can compare, so the fold has one
+ * implementation and both call it.
+ *
+ * Feeding back the entries a previous fold used, unchanged, reproduces its SHAs
+ * exactly. That is the property the promotion relies on: only the modules whose
+ * source actually moved change anything.
+ */
+function computeValModuleShas(config, entries, moduleErrors) {
+  var configSha = hash(JSON.stringify(config));
+  var sourcesSha = "";
+  var baseSha = configSha;
+  // NOTE: schemaSha is deliberately NOT seeded with configSha. It is compared
+  // across bundles (the server extracts from the Node bundle, the editor SPA
+  // from the browser bundle) to detect that a new version has been deployed.
+  // The config contains values that are not part of the schema and that differ
+  // between those two bundles - most notably the documented
+  // `gitCommit: process.env.VERCEL_GIT_COMMIT_SHA` / `gitBranch`, which are
+  // server-only env vars and therefore `undefined` in the browser. Seeding with
+  // them made the two sides disagree on every production load.
+  var schemaSha = "";
+  var _iterator = _createForOfIteratorHelper(entries),
+    _step;
+  try {
+    for (_iterator.s(); !(_step = _iterator.n()).done;) {
+      var entry = _step.value;
+      var path = entry.path,
+        source = entry.source,
+        serializedSchema = entry.serializedSchema;
+      sourcesSha = hash(sourcesSha + JSON.stringify({
+        path: path,
+        source: source
+      }));
+      baseSha = hash(baseSha + JSON.stringify({
+        path: path,
+        schema: serializedSchema,
+        source: source,
+        modulesErrors: moduleErrors.slice(0, entry.moduleErrorsAt)
+      }));
+      // The PATH is part of the schema set, not just the schema: renaming a
+      // module while leaving its schema byte-identical still changes which paths
+      // exist, and an open client keyed its schema cache by the old path. Hashing
+      // the schema alone left this SHA unchanged, so with no commitSha to fall
+      // back on the client never refetched /schema.
+      schemaSha = hash(schemaSha + JSON.stringify({
+        path: path,
+        schema: serializedSchema
+      }));
+    }
+  } catch (err) {
+    _iterator.e(err);
+  } finally {
+    _iterator.f();
+  }
+  return {
+    baseSha: baseSha,
+    schemaSha: schemaSha,
+    sourcesSha: sourcesSha,
+    configSha: configSha
+  };
+}
+
 /**
  * Extracts schemas and sources from a ValModules registry and computes the
  * deterministic SHAs that the server and client both use to detect changes.
@@ -6832,7 +6898,7 @@ function extractValModules(_x) {
 }
 function _extractValModules() {
   _extractValModules = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee(valModules) {
-    var moduleErrors, addModuleError, sources, schemas, serializedSchemas, configSha, sourcesSha, baseSha, schemaSha, 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, _t, _t2;
     return _regenerator().w(function (_context) {
       while (1) switch (_context.p = _context.n) {
         case 0:
@@ -6847,17 +6913,15 @@ function _extractValModules() {
           sources = {};
           schemas = {};
           serializedSchemas = {};
-          configSha = hash(JSON.stringify(valModules.config));
-          sourcesSha = "";
-          baseSha = configSha; // NOTE: schemaSha is deliberately NOT seeded with configSha. It is compared
-          // across bundles (the server extracts from the Node bundle, the editor SPA
-          // from the browser bundle) to detect that a new version has been deployed.
-          // The config contains values that are not part of the schema and that differ
-          // between those two bundles - most notably the documented
-          // `gitCommit: process.env.VERCEL_GIT_COMMIT_SHA` / `gitBranch`, which are
-          // server-only env vars and therefore `undefined` in the browser. Seeding with
-          // them made the two sides disagree on every production load.
-          schemaSha = "";
+          /**
+           * What the fold below runs over, collected here rather than hashed inline.
+           *
+           * The hashing itself moved to `computeValModuleShas`, so the server can
+           * recompute these SHAs for sources it did not get by evaluating the modules.
+           * Collected in loop order, which is `val.modules` order, which is the order
+           * the fold is defined by.
+           */
+          shaEntries = [];
           moduleIdx = 0;
         case 1:
           if (!(moduleIdx < valModules.modules.length)) {
@@ -6960,40 +7024,27 @@ function _extractValModules() {
           sources[pathM] = source;
           schemas[pathM] = schema;
           serializedSchemas[pathM] = serializedSchema;
-          sourcesSha = hash(sourcesSha + JSON.stringify({
-            path: path,
-            source: source
-          }));
-          baseSha = hash(baseSha + JSON.stringify({
-            path: path,
-            schema: serializedSchema,
+          shaEntries.push({
+            path: pathM,
             source: source,
-            modulesErrors: moduleErrors
-          }));
-          // The PATH is part of the schema set, not just the schema: renaming a
-          // module while leaving its schema byte-identical still changes which paths
-          // exist, and an open client keyed its schema cache by the old path. Hashing
-          // the schema alone left this SHA unchanged, so with no commitSha to fall
-          // back on the client never refetched /schema.
-          schemaSha = hash(schemaSha + JSON.stringify({
-            path: path,
-            schema: serializedSchema
-          }));
+            serializedSchema: serializedSchema,
+            // The errors so far, which is what the base SHA used to mix in by hashing
+            // the live array at this point in the loop. See `moduleErrorsAt`.
+            moduleErrorsAt: moduleErrors.length
+          });
         case 17:
           moduleIdx++;
           _context.n = 1;
           break;
         case 18:
-          return _context.a(2, {
+          return _context.a(2, _objectSpread2(_objectSpread2({
             sources: sources,
             schemas: schemas,
-            serializedSchemas: serializedSchemas,
-            baseSha: baseSha,
-            schemaSha: schemaSha,
-            sourcesSha: sourcesSha,
-            configSha: configSha,
-            moduleErrors: moduleErrors
-          });
+            serializedSchemas: serializedSchemas
+          }, computeValModuleShas(valModules.config, shaEntries, moduleErrors)), {}, {
+            moduleErrors: moduleErrors,
+            shaEntries: shaEntries
+          }));
       }
     }, _callee, null, [[14, 15], [4, 6]]);
   }));
@@ -8019,13 +8070,16 @@ function deserializeSchema(serialized) {
   return schema;
 }
 function deserializeSchemaImpl(serialized) {
-  var _serialized$options, _serialized$options2, _serialized$accept, _serialized$directory, _serialized$remote, _serialized$jsonValue;
+  var _serialized$options, _serialized$options2, _serialized$render, _serialized$accept, _serialized$directory, _serialized$remote, _serialized$jsonValue;
   switch (serialized.type) {
     case "string":
       return new StringSchema(_objectSpread2(_objectSpread2({}, serialized.options), {}, {
         regexp: ((_serialized$options = serialized.options) === null || _serialized$options === void 0 ? void 0 : _serialized$options.regexp) && new RegExp(serialized.options.regexp.source, serialized.options.regexp.flags),
         regExpMessage: (_serialized$options2 = serialized.options) === null || _serialized$options2 === void 0 || (_serialized$options2 = _serialized$options2.regexp) === null || _serialized$options2 === void 0 ? void 0 : _serialized$options2.message
-      }), serialized.opt, serialized.raw, [], null, false, false, serialized.description);
+      }), 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);
     case "literal":
       return new LiteralSchema(serialized.value, serialized.opt, [], false, false, serialized.description);
     case "boolean":
@@ -8102,31 +8156,46 @@ function deserializeSchemaImpl(serialized) {
   }
 }
 
-// TODO: we want to change layout -> as to be more consistent across the board
-
-// Main render type:
+/**
+ * What a container shows for ONE of its items: the user's `preview` callback
+ * returns this, and the Studio draws a row from it.
+ *
+ * NB: {@link ArrayPreview} / {@link RecordPreview} name the DATA a container
+ * previews with. The Studio also has React components called `ArrayPreview` /
+ * `RecordPreview` (the fallback rendering of an array / record field, part of
+ * the `<Type>Preview` convention in `components/Preview.tsx`). They do not
+ * collide today because no file needs both - if one ever does, alias this type
+ * at the import rather than renaming that convention.
+ */
 
-//
+/**
+ * Main preview type.
+ *
+ * Deliberately not exported: `parent` is the discriminant, and every consumer
+ * narrows on it rather than on the union as a whole. There is no `layout` here
+ * on purpose - how a preview is laid out is the editor's business, not the
+ * schema's.
+ */
 
 /**
- * Which paths a render is being computed FOR.
+ * Which paths a preview is being computed FOR.
  *
- * `executeRender` takes a whole module, so one request has always walked every
- * node in it and run every `select` closure — for `handboka`, with `select` at
+ * `executePreview` takes a whole module, so one request has always walked every
+ * node in it and run every `preview` closure - for `handboka`, with `preview` at
  * two nested array levels, that is every chapter and every section to serve one
  * visible row. A scope is what makes the walk proportional to what is being
  * looked at instead of to the project.
  *
  * Two questions, because a container and its items need different answers:
  *
- * - {@link RenderScope.wants} — is a render AT this exact path wanted? A
+ * - {@link PreviewScope.wants} - is a preview AT this exact path wanted? A
  *   container answers `true` here when the whole of it is being shown, and its
- *   list render is then computed in full.
- * - {@link RenderScope.wantsUnder} — could anything at or below this path be
+ *   preview is then computed in full.
+ * - {@link PreviewScope.wantsUnder} - could anything at or below this path be
  *   wanted? Recursion is pruned where this is `false`, and a container whose own
- *   path is not wanted but which has wanted descendants renders a WINDOW: only
+ *   path is not wanted but which has wanted descendants previews a WINDOW: only
  *   the items that were asked for. That is the case a single visible row is, and
- *   it is why {@link ListArrayRender} carries indices.
+ *   it is why {@link ArrayPreview} carries indices.
  *
  * Absent scope means the whole module, which is what every existing caller
  * passes and what every existing caller got.
@@ -8138,10 +8207,10 @@ function deserializeSchemaImpl(serialized) {
  * Compares SEGMENTS rather than string prefixes. A source path's module path is
  * a quoted, dot-joined encoding (`?p="a".1."b"`), so `startsWith` gets the
  * ancestor test wrong wherever a key is a prefix of a sibling key or contains a
- * dot or a quote — `"title"` against `"titles"` being the cheapest example.
+ * dot or a quote - `"title"` against `"titles"` being the cheapest example.
  * Segments are parsed once here, not per comparison.
  */
-function renderScope(paths) {
+function previewScope(paths) {
   var wanted = paths.map(function (path) {
     var _splitModuleFilePathA = splitModuleFilePathAndModulePath(path),
       _splitModuleFilePathA2 = _slicedToArray(_splitModuleFilePathA, 2),
@@ -8190,6 +8259,37 @@ function renderScope(paths) {
 
 // TODO: improve this so that we do not get RawString and string, only string. Are there other things?
 
+/**
+ * A RENDER is how one field is laid out in the editor: `s.string().render({ as:
+ * "textarea" })`, `.render({ as: "code", language })`.
+ *
+ * It is static configuration - plain data, with no closure behind it and no
+ * dependency on source - which is why it lives in the SERIALIZED schema
+ * (`SerializedStringSchema.render`) and is read straight off it where the field
+ * is drawn. There is no render pipeline, no store and no host round-trip.
+ *
+ * That "static" is an ASSUMPTION we are taking deliberately, for simplicity,
+ * not a law. A future render could plausibly want to depend on source - a
+ * layout that varies with the value, a callback of its own. If that day comes,
+ * the shape it needs back is `executePreview`'s, and the honest move is to give
+ * `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 dynamic, source-dependent, demand-scoped thing - what a container shows
+ * for its items - is a PREVIEW. See `preview.ts`.
+ */
+/**
+ * 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"];
+
+/**
+ * What `s.string().render(...)` takes, and what the serialized schema carries
+ * verbatim.
+ */
+
 var externalPageRouter = {
   getRouterId: function getRouterId() {
     return "external-url-router";
@@ -8553,4 +8653,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, DEFAULT_VAL_REMOTE_HOST as g, hasRemoteFileSchema as h, initVal as i, derefPatch as j, StringSchema as k, ImageSchema as l, modules as m, FileSchema as n, DateSchema as o, COLOR_FORMATS as p, DEFAULT_COLOR_FORMAT as q, DateTimeSchema as r, splitModuleFilePathAndModulePath as s, RouteSchema as t, RichTextSchema as u, deserializeSchema as v, renderScope as w, getSourcePathFromRoute as x };
+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 };