@valbuild/core 0.103.0 → 0.105.1

package/dist/{index-3572060f.cjs.prod.js → index-4013c9f8.cjs.prod.js}

@@ -583,10 +583,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,
@@ -605,36 +605,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 {};
     }
   }]);
@@ -829,8 +821,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;
@@ -841,13 +833,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];
@@ -874,7 +866,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;
@@ -883,19 +875,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",
@@ -962,17 +954,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",
@@ -989,7 +981,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,
@@ -997,8 +989,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;
@@ -1013,26 +1005,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.
@@ -1042,10 +1026,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({
@@ -1069,7 +1053,6 @@ var ArraySchema = /*#__PURE__*/function (_Schema) {
         res[sourcePath] = {
           status: "success",
           data: {
-            layout: "list",
             parent: "array",
             items: items
           }
@@ -1077,10 +1060,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);
@@ -1212,8 +1203,8 @@ var LiteralSchema = /*#__PURE__*/function (_Schema) {
       };
     }
   }, {
-    key: "executeRender",
-    value: function executeRender() {
+    key: "executePreview",
+    value: function executePreview() {
       return {};
     }
   }]);
@@ -1646,8 +1637,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;
@@ -1669,7 +1660,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];
@@ -2132,8 +2123,8 @@ var ImageSchema = /*#__PURE__*/function (_Schema) {
       };
     }
   }, {
-    key: "executeRender",
-    value: function executeRender() {
+    key: "executePreview",
+    value: function executePreview() {
       return {};
     }
   }]);
@@ -2329,8 +2320,8 @@ var RouteSchema = /*#__PURE__*/function (_Schema) {
       };
     }
   }, {
-    key: "executeRender",
-    value: function executeRender() {
+    key: "executePreview",
+    value: function executePreview() {
       return {};
     }
   }]);
@@ -2888,8 +2879,8 @@ var RichTextSchema = /*#__PURE__*/function (_Schema) {
       };
     }
   }, {
-    key: "executeRender",
-    value: function executeRender() {
+    key: "executePreview",
+    value: function executePreview() {
       return {};
     }
   }]);
@@ -3222,7 +3213,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;
@@ -3235,19 +3226,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",
@@ -3606,29 +3597,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);
     }
 
     /**
@@ -3660,7 +3651,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",
@@ -3720,7 +3711,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,
@@ -3752,8 +3743,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;
@@ -3765,31 +3756,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;
@@ -3804,7 +3787,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
@@ -3830,7 +3813,6 @@ var RecordSchema = /*#__PURE__*/function (_Schema) {
         res[sourcePath] = {
           status: "success",
           data: {
-            layout: "list",
             parent: "record",
             items: items
           }
@@ -3838,13 +3820,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);
@@ -4537,8 +4525,8 @@ var NumberSchema = /*#__PURE__*/function (_Schema) {
       };
     }
   }, {
-    key: "executeRender",
-    value: function executeRender() {
+    key: "executePreview",
+    value: function executePreview() {
       return {};
     }
   }]);
@@ -4657,8 +4645,8 @@ var BooleanSchema = /*#__PURE__*/function (_Schema) {
       };
     }
   }, {
-    key: "executeRender",
-    value: function executeRender() {
+    key: "executePreview",
+    value: function executePreview() {
       return {};
     }
   }]);
@@ -4881,8 +4869,8 @@ var KeyOfSchema = /*#__PURE__*/function (_Schema) {
       };
     }
   }, {
-    key: "executeRender",
-    value: function executeRender() {
+    key: "executePreview",
+    value: function executePreview() {
       return {};
     }
   }]);
@@ -5165,8 +5153,8 @@ var FileSchema = /*#__PURE__*/function (_Schema) {
       };
     }
   }, {
-    key: "executeRender",
-    value: function executeRender() {
+    key: "executePreview",
+    value: function executePreview() {
       return {};
     }
   }]);
@@ -5396,8 +5384,8 @@ var DateSchema = /*#__PURE__*/function (_Schema) {
       };
     }
   }, {
-    key: "executeRender",
-    value: function executeRender() {
+    key: "executePreview",
+    value: function executePreview() {
       return {};
     }
   }]);
@@ -5600,8 +5588,8 @@ var DateTimeSchema = /*#__PURE__*/function (_Schema) {
       };
     }
   }, {
-    key: "executeRender",
-    value: function executeRender() {
+    key: "executePreview",
+    value: function executePreview() {
       return {};
     }
   }]);
@@ -6241,8 +6229,8 @@ var ColorSchema = /*#__PURE__*/function (_Schema) {
       };
     }
   }, {
-    key: "executeRender",
-    value: function executeRender() {
+    key: "executePreview",
+    value: function executePreview() {
       return {};
     }
   }]);
@@ -6822,6 +6810,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 = result._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.
@@ -6834,7 +6900,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:
@@ -6849,17 +6915,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)) {
@@ -6962,40 +7026,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]]);
   }));
@@ -8021,13 +8072,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":
@@ -8104,31 +8158,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.
@@ -8140,10 +8209,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),
@@ -8192,6 +8261,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";
@@ -8557,6 +8657,7 @@ function tryJsonParse(str) {
 
 exports.ArraySchema = ArraySchema;
 exports.BooleanSchema = BooleanSchema;
+exports.CODE_LANGUAGES = CODE_LANGUAGES;
 exports.COLOR_FORMATS = COLOR_FORMATS;
 exports.ColorSchema = ColorSchema;
 exports.DEFAULT_APP_HOST = DEFAULT_APP_HOST;
@@ -8588,6 +8689,7 @@ exports._createClass = _createClass;
 exports._slicedToArray = _slicedToArray;
 exports._toConsumableArray = _toConsumableArray;
 exports._typeof = _typeof;
+exports.computeValModuleShas = computeValModuleShas;
 exports.derefPatch = derefPatch;
 exports.deserializeSchema = deserializeSchema;
 exports.extractValModules = extractValModules;
@@ -8595,5 +8697,5 @@ exports.getSourcePathFromRoute = getSourcePathFromRoute;
 exports.hasRemoteFileSchema = hasRemoteFileSchema;
 exports.initVal = initVal;
 exports.modules = modules;
-exports.renderScope = renderScope;
+exports.previewScope = previewScope;
 exports.splitModuleFilePathAndModulePath = splitModuleFilePathAndModulePath;