@valbuild/server 0.103.2 → 0.105.0

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

@@ -3,7 +3,7 @@ import { result } from "@valbuild/core/fp";
 import { JSONValue, ParentRef, Patch, PatchError } from "@valbuild/core/patch";
 import { ValSyntaxError, ValSyntaxErrorTree } from "./patch/ts/syntax.js";
 import { ParentPatchId } from "@valbuild/core";
-import type { ReifiedRender } from "@valbuild/core";
+import type { ReifiedPreview } from "@valbuild/core";
 import { ValCommit, ValDeployment } from "@valbuild/shared/internal";
 export type BaseSha = string & {
     readonly _tag: unique symbol;
@@ -198,16 +198,19 @@ export declare abstract class ValOps {
     getSchemaSha(): Promise<SchemaSha>;
     analyzePatches(sortedPatches: OrderedPatches["patches"], commits?: ValCommit[], currentCommitSha?: CommitSha): PatchAnalysis;
     /**
-     * Reifies each module's render from its schema INSTANCE.
+     * Reifies each module's previews from its schema INSTANCE.
      *
-     * Kept even though the Studio also computes renders client-side: `select` is a
-     * user function that lives on the instance and is not part of the serialized
+     * Kept even though the Studio also computes previews client-side: a preview is
+     * a user function that lives on the instance and is not part of the serialized
      * schema, so a host app that does not render `<ValModulesClient>` has no
-     * instances in the browser and would otherwise get no renders at all. See
+     * instances in the browser and would otherwise get no previews at all. See
      * #470.
+     *
+     * A string's `render` needs none of this — it is static config that travels
+     * with the serialized schema.
      */
-    getRenders(schemas: Schemas, sources: Sources): Promise<{
-        renders: Record<ModuleFilePath, ReifiedRender | null>;
+    getPreviews(schemas: Schemas, sources: Sources): Promise<{
+        previews: Record<ModuleFilePath, ReifiedPreview | null>;
     }>;
     getSources(analysis?: PatchAnalysis & OrderedPatches): Promise<{
         sources: Sources;

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

@@ -5,4 +5,4 @@ import { ValidationError } from "@valbuild/core";
  * There is no schema in hand here — a `ValidationError` carries only the value
  * it flagged — so the shape is all there is to go on.
  */
-export declare function getValidationErrorFileRef(validationError: ValidationError): string | null;
+export declare function getValidationErrorFileRef(validationError: ValidationError): any;

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

@@ -1,4 +1,4 @@
-import { ModuleFilePath, PatchId } from "@valbuild/core";
+import { PatchId } from "@valbuild/core";
 import { z } from "zod";
 import type { AuthorId, BaseSha } from "./ValOps.js";
 import { PatchLogEntry, PatchLogProblem } from "./patchLog.js";
@@ -32,14 +32,14 @@ export declare const FSPatch: z.ZodObject<{
     patch: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
         op: z.ZodLiteral<"add">;
         path: z.ZodArray<z.ZodString>;
-        value: z.ZodType<import("@valbuild/core/patch").JSONValue, unknown, z.core.$ZodTypeInternals<import("@valbuild/core/patch").JSONValue, unknown>>;
+        value: z.ZodType<JSONValueT, unknown, z.core.$ZodTypeInternals<JSONValueT, unknown>>;
     }, z.core.$strict>, z.ZodObject<{
         op: z.ZodLiteral<"remove">;
         path: z.ZodTuple<[z.ZodString], z.ZodString>;
     }, z.core.$strict>, z.ZodObject<{
         op: z.ZodLiteral<"replace">;
         path: z.ZodArray<z.ZodString>;
-        value: z.ZodType<import("@valbuild/core/patch").JSONValue, unknown, z.core.$ZodTypeInternals<import("@valbuild/core/patch").JSONValue, unknown>>;
+        value: z.ZodType<JSONValueT, unknown, z.core.$ZodTypeInternals<JSONValueT, unknown>>;
     }, z.core.$strict>, z.ZodObject<{
         op: z.ZodLiteral<"move">;
         from: z.ZodTuple<[z.ZodString], z.ZodString>;
@@ -51,15 +51,15 @@ export declare const FSPatch: z.ZodObject<{
     }, z.core.$strict>, z.ZodObject<{
         op: z.ZodLiteral<"test">;
         path: z.ZodArray<z.ZodString>;
-        value: z.ZodType<import("@valbuild/core/patch").JSONValue, unknown, z.core.$ZodTypeInternals<import("@valbuild/core/patch").JSONValue, unknown>>;
+        value: z.ZodType<JSONValueT, unknown, z.core.$ZodTypeInternals<JSONValueT, unknown>>;
     }, z.core.$strict>, z.ZodObject<{
         op: z.ZodLiteral<"file">;
         path: z.ZodArray<z.ZodString>;
         filePath: z.ZodString;
-        value: z.ZodType<import("@valbuild/core/patch").JSONValue, unknown, z.core.$ZodTypeInternals<import("@valbuild/core/patch").JSONValue, unknown>>;
+        value: z.ZodType<JSONValueT, unknown, z.core.$ZodTypeInternals<JSONValueT, unknown>>;
         remote: z.ZodBoolean;
         nestedFilePath: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        metadata: z.ZodOptional<z.ZodType<import("@valbuild/core/patch").JSONValue, unknown, z.core.$ZodTypeInternals<import("@valbuild/core/patch").JSONValue, unknown>>>;
+        metadata: z.ZodOptional<z.ZodType<JSONValueT, unknown, z.core.$ZodTypeInternals<JSONValueT, unknown>>>;
     }, z.core.$strict>], "op">>;
     patchId: z.ZodString;
     baseSha: z.ZodString & z.ZodType<BaseSha, string, z.core.$ZodTypeInternals<BaseSha, string>>;

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

@@ -2045,24 +2045,27 @@ class ValOps {
     };
   }
 
-  // #region getRenders
+  // #region getPreviews
   /**
-   * Reifies each module's render from its schema INSTANCE.
+   * Reifies each module's previews from its schema INSTANCE.
    *
-   * Kept even though the Studio also computes renders client-side: `select` is a
-   * user function that lives on the instance and is not part of the serialized
+   * Kept even though the Studio also computes previews client-side: a preview is
+   * a user function that lives on the instance and is not part of the serialized
    * schema, so a host app that does not render `<ValModulesClient>` has no
-   * instances in the browser and would otherwise get no renders at all. See
+   * instances in the browser and would otherwise get no previews at all. See
    * #470.
+   *
+   * A string's `render` needs none of this — it is static config that travels
+   * with the serialized schema.
    */
-  async getRenders(schemas, sources) {
-    const renders = {};
+  async getPreviews(schemas, sources) {
+    const previews = {};
     for (const [pathS, schema] of Object.entries(schemas)) {
       const path = pathS;
-      renders[path] = schema["executeRender"](path, sources[path]);
+      previews[path] = schema["executePreview"](path, sources[path]);
     }
     return {
-      renders
+      previews
     };
   }
 
@@ -7976,11 +7979,11 @@ const ValServer = (valModules, options, callbacks) => {
         // The studio client always passes false: it owns patch application
         // and validation, and treats /sources/~ as a pure un-patched read.
         const applyPatches = query.apply_patches !== false;
-        // NOTE: renders are computed here even when the client applies patches
-        // itself: the render select functions live on the Schema instances and
-        // are not part of the serialized schema, so the client cannot derive
-        // them. They are computed on the patched sources, so that previews
-        // (list titles / subtitles / images) reflect the patches that apply.
+        // NOTE: previews are computed here even when the client applies patches
+        // itself: the preview functions live on the Schema instances and are not
+        // part of the serialized schema, so the client cannot derive them. They
+        // are computed on the patched sources, so that previews (list titles /
+        // subtitles / images) reflect the patches that apply.
         let patchedSources = sourcesRes.sources;
         if ((((_patchOps$patches = patchOps.patches) === null || _patchOps$patches === void 0 ? void 0 : _patchOps$patches.length) ?? 0) > 0) {
           const onlyPatchedTreeModules = await serverOps.getSources({
@@ -8001,7 +8004,7 @@ const ValServer = (valModules, options, callbacks) => {
             };
           }
         }
-        const renderRes = await serverOps.getRenders(schemasRes, patchedSources);
+        const previewRes = await serverOps.getPreviews(schemasRes, patchedSources);
         let sourcesValidation = {
           errors: {},
           files: {},
@@ -8052,7 +8055,7 @@ const ValServer = (valModules, options, callbacks) => {
               // baseSource is only meaningful when the server applied patches:
               // with apply_patches=false, `source` is already un-patched.
               baseSource: applyPatches && hasPatches ? unpatchedSources[moduleFilePath] : undefined,
-              render: renderRes.renders[moduleFilePath] || null,
+              preview: previewRes.previews[moduleFilePath] || null,
               patches: appliedPatches.length > 0 || skippedPatches.length > 0 || Object.keys(patchErrors).length > 0 ? {
                 applied: appliedPatches,
                 skipped: skippedPatches.length > 0 ? skippedPatches : undefined,

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

@@ -2045,24 +2045,27 @@ class ValOps {
     };
   }
 
-  // #region getRenders
+  // #region getPreviews
   /**
-   * Reifies each module's render from its schema INSTANCE.
+   * Reifies each module's previews from its schema INSTANCE.
    *
-   * Kept even though the Studio also computes renders client-side: `select` is a
-   * user function that lives on the instance and is not part of the serialized
+   * Kept even though the Studio also computes previews client-side: a preview is
+   * a user function that lives on the instance and is not part of the serialized
    * schema, so a host app that does not render `<ValModulesClient>` has no
-   * instances in the browser and would otherwise get no renders at all. See
+   * instances in the browser and would otherwise get no previews at all. See
    * #470.
+   *
+   * A string's `render` needs none of this — it is static config that travels
+   * with the serialized schema.
    */
-  async getRenders(schemas, sources) {
-    const renders = {};
+  async getPreviews(schemas, sources) {
+    const previews = {};
     for (const [pathS, schema] of Object.entries(schemas)) {
       const path = pathS;
-      renders[path] = schema["executeRender"](path, sources[path]);
+      previews[path] = schema["executePreview"](path, sources[path]);
     }
     return {
-      renders
+      previews
     };
   }
 
@@ -7976,11 +7979,11 @@ const ValServer = (valModules, options, callbacks) => {
         // The studio client always passes false: it owns patch application
         // and validation, and treats /sources/~ as a pure un-patched read.
         const applyPatches = query.apply_patches !== false;
-        // NOTE: renders are computed here even when the client applies patches
-        // itself: the render select functions live on the Schema instances and
-        // are not part of the serialized schema, so the client cannot derive
-        // them. They are computed on the patched sources, so that previews
-        // (list titles / subtitles / images) reflect the patches that apply.
+        // NOTE: previews are computed here even when the client applies patches
+        // itself: the preview functions live on the Schema instances and are not
+        // part of the serialized schema, so the client cannot derive them. They
+        // are computed on the patched sources, so that previews (list titles /
+        // subtitles / images) reflect the patches that apply.
         let patchedSources = sourcesRes.sources;
         if ((((_patchOps$patches = patchOps.patches) === null || _patchOps$patches === void 0 ? void 0 : _patchOps$patches.length) ?? 0) > 0) {
           const onlyPatchedTreeModules = await serverOps.getSources({
@@ -8001,7 +8004,7 @@ const ValServer = (valModules, options, callbacks) => {
             };
           }
         }
-        const renderRes = await serverOps.getRenders(schemasRes, patchedSources);
+        const previewRes = await serverOps.getPreviews(schemasRes, patchedSources);
         let sourcesValidation = {
           errors: {},
           files: {},
@@ -8052,7 +8055,7 @@ const ValServer = (valModules, options, callbacks) => {
               // baseSource is only meaningful when the server applied patches:
               // with apply_patches=false, `source` is already un-patched.
               baseSource: applyPatches && hasPatches ? unpatchedSources[moduleFilePath] : undefined,
-              render: renderRes.renders[moduleFilePath] || null,
+              preview: previewRes.previews[moduleFilePath] || null,
               patches: appliedPatches.length > 0 || skippedPatches.length > 0 || Object.keys(patchErrors).length > 0 ? {
                 applied: appliedPatches,
                 skipped: skippedPatches.length > 0 ? skippedPatches : undefined,

package/dist/valbuild-server.esm.js

@@ -2011,24 +2011,27 @@ class ValOps {
     };
   }
 
-  // #region getRenders
+  // #region getPreviews
   /**
-   * Reifies each module's render from its schema INSTANCE.
+   * Reifies each module's previews from its schema INSTANCE.
    *
-   * Kept even though the Studio also computes renders client-side: `select` is a
-   * user function that lives on the instance and is not part of the serialized
+   * Kept even though the Studio also computes previews client-side: a preview is
+   * a user function that lives on the instance and is not part of the serialized
    * schema, so a host app that does not render `<ValModulesClient>` has no
-   * instances in the browser and would otherwise get no renders at all. See
+   * instances in the browser and would otherwise get no previews at all. See
    * #470.
+   *
+   * A string's `render` needs none of this — it is static config that travels
+   * with the serialized schema.
    */
-  async getRenders(schemas, sources) {
-    const renders = {};
+  async getPreviews(schemas, sources) {
+    const previews = {};
     for (const [pathS, schema] of Object.entries(schemas)) {
       const path = pathS;
-      renders[path] = schema["executeRender"](path, sources[path]);
+      previews[path] = schema["executePreview"](path, sources[path]);
     }
     return {
-      renders
+      previews
     };
   }
 
@@ -7942,11 +7945,11 @@ const ValServer = (valModules, options, callbacks) => {
         // The studio client always passes false: it owns patch application
         // and validation, and treats /sources/~ as a pure un-patched read.
         const applyPatches = query.apply_patches !== false;
-        // NOTE: renders are computed here even when the client applies patches
-        // itself: the render select functions live on the Schema instances and
-        // are not part of the serialized schema, so the client cannot derive
-        // them. They are computed on the patched sources, so that previews
-        // (list titles / subtitles / images) reflect the patches that apply.
+        // NOTE: previews are computed here even when the client applies patches
+        // itself: the preview functions live on the Schema instances and are not
+        // part of the serialized schema, so the client cannot derive them. They
+        // are computed on the patched sources, so that previews (list titles /
+        // subtitles / images) reflect the patches that apply.
         let patchedSources = sourcesRes.sources;
         if ((((_patchOps$patches = patchOps.patches) === null || _patchOps$patches === void 0 ? void 0 : _patchOps$patches.length) ?? 0) > 0) {
           const onlyPatchedTreeModules = await serverOps.getSources({
@@ -7967,7 +7970,7 @@ const ValServer = (valModules, options, callbacks) => {
             };
           }
         }
-        const renderRes = await serverOps.getRenders(schemasRes, patchedSources);
+        const previewRes = await serverOps.getPreviews(schemasRes, patchedSources);
         let sourcesValidation = {
           errors: {},
           files: {},
@@ -8018,7 +8021,7 @@ const ValServer = (valModules, options, callbacks) => {
               // baseSource is only meaningful when the server applied patches:
               // with apply_patches=false, `source` is already un-patched.
               baseSource: applyPatches && hasPatches ? unpatchedSources[moduleFilePath] : undefined,
-              render: renderRes.renders[moduleFilePath] || null,
+              preview: previewRes.previews[moduleFilePath] || null,
               patches: appliedPatches.length > 0 || skippedPatches.length > 0 || Object.keys(patchErrors).length > 0 ? {
                 applied: appliedPatches,
                 skipped: skippedPatches.length > 0 ? skippedPatches : undefined,

package/package.json

@@ -16,7 +16,7 @@
     "./package.json": "./package.json"
   },
   "types": "dist/valbuild-server.cjs.d.ts",
-  "version": "0.103.2",
+  "version": "0.105.0",
   "devDependencies": {
     "@prettier/sync": "^0.6.1",
     "@types/jest": "^30.0.0"
@@ -29,9 +29,9 @@
     "typescript": "^5.9.3",
     "zod": "^4.3.5",
     "zod-validation-error": "^5.0.0",
-    "@valbuild/core": "0.103.0",
-    "@valbuild/shared": "0.103.0",
-    "@valbuild/ui": "0.103.2"
+    "@valbuild/core": "0.105.0",
+    "@valbuild/shared": "0.105.0",
+    "@valbuild/ui": "0.105.0"
   },
   "engines": {
     "node": ">=18.17.0"