@valbuild/next 0.133.0 → 0.134.1

package/CHANGELOG.md

@@ -1,5 +1,55 @@
 # @valbuild/next
 
+## 0.134.1
+
+### Patch Changes
+
+- Updated dependencies [[`821e789`](https://github.com/valbuild/val/commit/821e789c1af47510af5d23eb96384ff78ddd7646)]:
+  - @valbuild/shared@0.134.1
+  - @valbuild/language-server@0.134.1
+  - @valbuild/mcp@0.134.1
+  - @valbuild/react@0.134.1
+  - @valbuild/server@0.134.1
+  - @valbuild/ui@0.134.0
+
+## 0.134.0
+
+### Minor Changes
+
+- [#690](https://github.com/valbuild/val/pull/690) [`16c49ea`](https://github.com/valbuild/val/commit/16c49ea6dd97c7a96bbfdf211af9bab5884579e2) Thanks [@freekh](https://github.com/freekh)! - Read a view with `useVal` / `fetchVal`.
+
+  A `s.view()` field reads as a pointer with no properties on it. It can now be handed to a reader, which resolves it to the module it names:
+
+  ```tsx
+  const page = useVal(pageVal);
+  const header = useVal(page.header); // the header module's content, typed
+  ```
+
+  The point is single source of truth rather than a new capability: the page declares which module it shows, and a component follows that declaration instead of importing the target a second time. Change `s.view(headerVal)` to `s.view(navVal)` and the reader follows; an import would have kept reading the header.
+
+  The readers that take a MODULE rather than a value follow the same rule — `useValKey`, `useValRoute`, `useValRouteUrl` and the `fetchVal*` counterparts, in both the Next and TanStack packages:
+
+  ```tsx
+  const page = useVal(pageVal);
+  const note = useValRoute(page.notes, params); // the router module the view names
+  ```
+
+  Works in draft mode, including when the page itself has a pending edit. Two things to know:
+
+  - **Resolve a handle in the component that read the module containing it.** A handle carries the module it points at, and that cannot survive serialization — so one passed from a server component to a client component as a prop arrives empty. It throws with an explanation rather than handing back the pointer. This is why it throws rather than returning nothing: every one of the route and key readers already uses `null` / `undefined` to mean "no such entry", so a quiet answer would be indistinguishable from a 404.
+  - **`ValView<Source>` is now a member of `SelectorSource`**, since a reader accepts one.
+
+### Patch Changes
+
+- Updated dependencies [[`be78a9b`](https://github.com/valbuild/val/commit/be78a9b51678439f7ecb1c7f3887f9e8e1261a13), [`1c31dcc`](https://github.com/valbuild/val/commit/1c31dcca7f1bb0199350567fd579de29f48bb26d), [`688b9e3`](https://github.com/valbuild/val/commit/688b9e36b821323cda6870cdff03dd36ec3e782f), [`16c49ea`](https://github.com/valbuild/val/commit/16c49ea6dd97c7a96bbfdf211af9bab5884579e2), [`eaa265e`](https://github.com/valbuild/val/commit/eaa265e78d9f6d2a1b685c38901612b8a3704eed)]:
+  - @valbuild/server@0.134.0
+  - @valbuild/ui@0.134.0
+  - @valbuild/core@0.134.0
+  - @valbuild/react@0.134.0
+  - @valbuild/shared@0.134.0
+  - @valbuild/language-server@0.134.0
+  - @valbuild/mcp@0.134.0
+
 ## 0.133.0
 
 ### Patch Changes

package/client/dist/valbuild-next-client.cjs.dev.js

@@ -19,6 +19,8 @@ function _interopDefault (e) { return e && e.__esModule ? e : { 'default': e };
 
 var React__default = /*#__PURE__*/_interopDefault(React);
 
+/** What `useVal` gives back — see `ResolvedVal` in `@valbuild/react/stega`. */
+
 function useValStega(selector) {
   var valOverlayContext = ValOverlayContext.useValOverlayContext();
   var moduleIds = React__default["default"].useMemo(function () {
@@ -144,8 +146,6 @@ function draftJsonEntry(draftSource, key) {
   };
 }
 
-// The (loosened) content type a single `.jsonValues()` entry resolves to.
-
 // Module-level cache of in-flight/resolved entry loads, so `React.use` gets a
 // stable promise across renders (keyed by module path + entry key).
 var jsonEntryPromiseCache = new Map();
@@ -162,7 +162,10 @@ var jsonEntryPromiseCache = new Map();
  */
 function useValKeyStega(selector, key) {
   var valOverlayContext = ValOverlayContext.useValOverlayContext();
-  var moduleFilePath = selector && core.Internal.getValPath(selector);
+  // A view is a pointer: everything below reads a path, a schema and a source
+  // off this, and a pointer has none of them. See `resolveViewedModule`.
+  var valModule = core.Internal.resolveViewedModule(selector);
+  var moduleFilePath = valModule && core.Internal.getValPath(valModule);
   var draftSource = useDraftModuleSource(moduleFilePath || undefined);
   var draft = draftJsonEntry(draftSource, key);
   if (draft.status === "absent") {
@@ -172,11 +175,11 @@ function useValKeyStega(selector, key) {
   }
   var content = draft.status === "content" ? draft.content : undefined;
   if (content === undefined) {
-    content = readCommittedJsonEntry(selector, key);
+    content = readCommittedJsonEntry(valModule, key);
   }
   return stega.stegaEncode(content, {
     disabled: !valOverlayContext.draftMode,
-    root: routeFromVal.getJsonEntryStegaRoot(selector, key)
+    root: routeFromVal.getJsonEntryStegaRoot(valModule, key)
   });
 }
 
@@ -227,22 +230,25 @@ function resolveParams(params) {
 }
 function useValRouteStega(selector, params) {
   var valOverlayContext = ValOverlayContext.useValOverlayContext();
+  // A view is a pointer: everything below reads a path, a schema and a source
+  // off this, and a pointer has none of them. See `resolveViewedModule`.
+  var valModule = core.Internal.resolveViewedModule(selector);
   // Both called unconditionally to keep hook order stable. For a `.jsonValues()`
   // router `val` is unused (we resolve a single entry below instead); for any
   // other router `draftSource` is.
-  var val = useValStega(selector);
-  var draftSource = useDraftModuleSource(selector && core.Internal.getValPath(selector) || undefined);
+  var val = useValStega(valModule);
+  var draftSource = useDraftModuleSource(valModule && core.Internal.getValPath(valModule) || undefined);
   var resolvedParams = resolveParams(params);
   // Careful: null means there was an error - undefined means no params
   if (resolvedParams === null) {
     return null;
   }
-  var path = selector && core.Internal.getValPath(selector);
-  var schema = selector && core.Internal.getSchema(selector);
+  var path = valModule && core.Internal.getValPath(valModule);
+  var schema = valModule && core.Internal.getSchema(valModule);
   // `.jsonValues()` router: map params → the entry key and load ONLY that
   // entry's backing `*.val.json` (one dynamic import), like `useValKey`.
   if (routeFromVal.isJsonValuesRecordSchema(schema)) {
-    var source = selector && core.Internal.getSource(selector);
+    var source = valModule && core.Internal.getSource(valModule);
     var url = routeFromVal.getValRouteUrlFromVal(resolvedParams || {}, "useValRoute", path, schema, source);
     if (!url) {
       return null;
@@ -254,27 +260,30 @@ function useValRouteStega(selector, params) {
     }
     var content = draft.status === "content" ? draft.content : undefined;
     if (content === undefined) {
-      content = readCommittedJsonEntry(selector, url);
+      content = readCommittedJsonEntry(valModule, url);
     }
     if (content === undefined) {
       return null;
     }
     return stega.stegaEncode(content, {
       disabled: !valOverlayContext.draftMode,
-      root: routeFromVal.getJsonEntryStegaRoot(selector, url)
+      root: routeFromVal.getJsonEntryStegaRoot(valModule, url)
     });
   }
   var route = routeFromVal.initValRouteFromVal(resolvedParams || {}, "useValRoute", path, schema, val);
   return route;
 }
 function useValRouteUrl(selector, params) {
-  var val = useValStega(selector);
+  // A view is a pointer: everything below reads a path, a schema and a source
+  // off this, and a pointer has none of them. See `resolveViewedModule`.
+  var valModule = core.Internal.resolveViewedModule(selector);
+  var val = useValStega(valModule);
   var resolvedParams = params === undefined ? undefined : resolveParams(params);
   // Careful: null means there was an error - undefined means no params
   if (resolvedParams === null) {
     return null;
   }
-  var route = routeFromVal.getValRouteUrlFromVal(resolvedParams || {}, "useValRouteUrl", selector && core.Internal.getValPath(selector), selector && core.Internal.getSchema(selector), val);
+  var route = routeFromVal.getValRouteUrlFromVal(resolvedParams || {}, "useValRouteUrl", valModule && core.Internal.getValPath(valModule), valModule && core.Internal.getSchema(valModule), val);
   return route;
 }
 

package/client/dist/valbuild-next-client.cjs.prod.js

@@ -19,6 +19,8 @@ function _interopDefault (e) { return e && e.__esModule ? e : { 'default': e };
 
 var React__default = /*#__PURE__*/_interopDefault(React);
 
+/** What `useVal` gives back — see `ResolvedVal` in `@valbuild/react/stega`. */
+
 function useValStega(selector) {
   var valOverlayContext = ValOverlayContext.useValOverlayContext();
   var moduleIds = React__default["default"].useMemo(function () {
@@ -144,8 +146,6 @@ function draftJsonEntry(draftSource, key) {
   };
 }
 
-// The (loosened) content type a single `.jsonValues()` entry resolves to.
-
 // Module-level cache of in-flight/resolved entry loads, so `React.use` gets a
 // stable promise across renders (keyed by module path + entry key).
 var jsonEntryPromiseCache = new Map();
@@ -162,7 +162,10 @@ var jsonEntryPromiseCache = new Map();
  */
 function useValKeyStega(selector, key) {
   var valOverlayContext = ValOverlayContext.useValOverlayContext();
-  var moduleFilePath = selector && core.Internal.getValPath(selector);
+  // A view is a pointer: everything below reads a path, a schema and a source
+  // off this, and a pointer has none of them. See `resolveViewedModule`.
+  var valModule = core.Internal.resolveViewedModule(selector);
+  var moduleFilePath = valModule && core.Internal.getValPath(valModule);
   var draftSource = useDraftModuleSource(moduleFilePath || undefined);
   var draft = draftJsonEntry(draftSource, key);
   if (draft.status === "absent") {
@@ -172,11 +175,11 @@ function useValKeyStega(selector, key) {
   }
   var content = draft.status === "content" ? draft.content : undefined;
   if (content === undefined) {
-    content = readCommittedJsonEntry(selector, key);
+    content = readCommittedJsonEntry(valModule, key);
   }
   return stega.stegaEncode(content, {
     disabled: !valOverlayContext.draftMode,
-    root: routeFromVal.getJsonEntryStegaRoot(selector, key)
+    root: routeFromVal.getJsonEntryStegaRoot(valModule, key)
   });
 }
 
@@ -227,22 +230,25 @@ function resolveParams(params) {
 }
 function useValRouteStega(selector, params) {
   var valOverlayContext = ValOverlayContext.useValOverlayContext();
+  // A view is a pointer: everything below reads a path, a schema and a source
+  // off this, and a pointer has none of them. See `resolveViewedModule`.
+  var valModule = core.Internal.resolveViewedModule(selector);
   // Both called unconditionally to keep hook order stable. For a `.jsonValues()`
   // router `val` is unused (we resolve a single entry below instead); for any
   // other router `draftSource` is.
-  var val = useValStega(selector);
-  var draftSource = useDraftModuleSource(selector && core.Internal.getValPath(selector) || undefined);
+  var val = useValStega(valModule);
+  var draftSource = useDraftModuleSource(valModule && core.Internal.getValPath(valModule) || undefined);
   var resolvedParams = resolveParams(params);
   // Careful: null means there was an error - undefined means no params
   if (resolvedParams === null) {
     return null;
   }
-  var path = selector && core.Internal.getValPath(selector);
-  var schema = selector && core.Internal.getSchema(selector);
+  var path = valModule && core.Internal.getValPath(valModule);
+  var schema = valModule && core.Internal.getSchema(valModule);
   // `.jsonValues()` router: map params → the entry key and load ONLY that
   // entry's backing `*.val.json` (one dynamic import), like `useValKey`.
   if (routeFromVal.isJsonValuesRecordSchema(schema)) {
-    var source = selector && core.Internal.getSource(selector);
+    var source = valModule && core.Internal.getSource(valModule);
     var url = routeFromVal.getValRouteUrlFromVal(resolvedParams || {}, "useValRoute", path, schema, source);
     if (!url) {
       return null;
@@ -254,27 +260,30 @@ function useValRouteStega(selector, params) {
     }
     var content = draft.status === "content" ? draft.content : undefined;
     if (content === undefined) {
-      content = readCommittedJsonEntry(selector, url);
+      content = readCommittedJsonEntry(valModule, url);
     }
     if (content === undefined) {
       return null;
     }
     return stega.stegaEncode(content, {
       disabled: !valOverlayContext.draftMode,
-      root: routeFromVal.getJsonEntryStegaRoot(selector, url)
+      root: routeFromVal.getJsonEntryStegaRoot(valModule, url)
     });
   }
   var route = routeFromVal.initValRouteFromVal(resolvedParams || {}, "useValRoute", path, schema, val);
   return route;
 }
 function useValRouteUrl(selector, params) {
-  var val = useValStega(selector);
+  // A view is a pointer: everything below reads a path, a schema and a source
+  // off this, and a pointer has none of them. See `resolveViewedModule`.
+  var valModule = core.Internal.resolveViewedModule(selector);
+  var val = useValStega(valModule);
   var resolvedParams = params === undefined ? undefined : resolveParams(params);
   // Careful: null means there was an error - undefined means no params
   if (resolvedParams === null) {
     return null;
   }
-  var route = routeFromVal.getValRouteUrlFromVal(resolvedParams || {}, "useValRouteUrl", selector && core.Internal.getValPath(selector), selector && core.Internal.getSchema(selector), val);
+  var route = routeFromVal.getValRouteUrlFromVal(resolvedParams || {}, "useValRouteUrl", valModule && core.Internal.getValPath(valModule), valModule && core.Internal.getSchema(valModule), val);
   return route;
 }
 

package/client/dist/valbuild-next-client.esm.js

@@ -11,6 +11,8 @@ import '../../dist/defineProperty-cca5affa.esm.js';
 import '../../dist/slicedToArray-aa291011.esm.js';
 import '@valbuild/shared/client';
 
+/** What `useVal` gives back — see `ResolvedVal` in `@valbuild/react/stega`. */
+
 function useValStega(selector) {
   var valOverlayContext = useValOverlayContext();
   var moduleIds = React.useMemo(function () {
@@ -136,8 +138,6 @@ function draftJsonEntry(draftSource, key) {
   };
 }
 
-// The (loosened) content type a single `.jsonValues()` entry resolves to.
-
 // Module-level cache of in-flight/resolved entry loads, so `React.use` gets a
 // stable promise across renders (keyed by module path + entry key).
 var jsonEntryPromiseCache = new Map();
@@ -154,7 +154,10 @@ var jsonEntryPromiseCache = new Map();
  */
 function useValKeyStega(selector, key) {
   var valOverlayContext = useValOverlayContext();
-  var moduleFilePath = selector && Internal.getValPath(selector);
+  // A view is a pointer: everything below reads a path, a schema and a source
+  // off this, and a pointer has none of them. See `resolveViewedModule`.
+  var valModule = Internal.resolveViewedModule(selector);
+  var moduleFilePath = valModule && Internal.getValPath(valModule);
   var draftSource = useDraftModuleSource(moduleFilePath || undefined);
   var draft = draftJsonEntry(draftSource, key);
   if (draft.status === "absent") {
@@ -164,11 +167,11 @@ function useValKeyStega(selector, key) {
   }
   var content = draft.status === "content" ? draft.content : undefined;
   if (content === undefined) {
-    content = readCommittedJsonEntry(selector, key);
+    content = readCommittedJsonEntry(valModule, key);
   }
   return stegaEncode(content, {
     disabled: !valOverlayContext.draftMode,
-    root: getJsonEntryStegaRoot(selector, key)
+    root: getJsonEntryStegaRoot(valModule, key)
   });
 }
 
@@ -219,22 +222,25 @@ function resolveParams(params) {
 }
 function useValRouteStega(selector, params) {
   var valOverlayContext = useValOverlayContext();
+  // A view is a pointer: everything below reads a path, a schema and a source
+  // off this, and a pointer has none of them. See `resolveViewedModule`.
+  var valModule = Internal.resolveViewedModule(selector);
   // Both called unconditionally to keep hook order stable. For a `.jsonValues()`
   // router `val` is unused (we resolve a single entry below instead); for any
   // other router `draftSource` is.
-  var val = useValStega(selector);
-  var draftSource = useDraftModuleSource(selector && Internal.getValPath(selector) || undefined);
+  var val = useValStega(valModule);
+  var draftSource = useDraftModuleSource(valModule && Internal.getValPath(valModule) || undefined);
   var resolvedParams = resolveParams(params);
   // Careful: null means there was an error - undefined means no params
   if (resolvedParams === null) {
     return null;
   }
-  var path = selector && Internal.getValPath(selector);
-  var schema = selector && Internal.getSchema(selector);
+  var path = valModule && Internal.getValPath(valModule);
+  var schema = valModule && Internal.getSchema(valModule);
   // `.jsonValues()` router: map params → the entry key and load ONLY that
   // entry's backing `*.val.json` (one dynamic import), like `useValKey`.
   if (isJsonValuesRecordSchema(schema)) {
-    var source = selector && Internal.getSource(selector);
+    var source = valModule && Internal.getSource(valModule);
     var url = getValRouteUrlFromVal(resolvedParams || {}, "useValRoute", path, schema, source);
     if (!url) {
       return null;
@@ -246,27 +252,30 @@ function useValRouteStega(selector, params) {
     }
     var content = draft.status === "content" ? draft.content : undefined;
     if (content === undefined) {
-      content = readCommittedJsonEntry(selector, url);
+      content = readCommittedJsonEntry(valModule, url);
     }
     if (content === undefined) {
       return null;
     }
     return stegaEncode(content, {
       disabled: !valOverlayContext.draftMode,
-      root: getJsonEntryStegaRoot(selector, url)
+      root: getJsonEntryStegaRoot(valModule, url)
     });
   }
   var route = initValRouteFromVal(resolvedParams || {}, "useValRoute", path, schema, val);
   return route;
 }
 function useValRouteUrl(selector, params) {
-  var val = useValStega(selector);
+  // A view is a pointer: everything below reads a path, a schema and a source
+  // off this, and a pointer has none of them. See `resolveViewedModule`.
+  var valModule = Internal.resolveViewedModule(selector);
+  var val = useValStega(valModule);
   var resolvedParams = params === undefined ? undefined : resolveParams(params);
   // Careful: null means there was an error - undefined means no params
   if (resolvedParams === null) {
     return null;
   }
-  var route = getValRouteUrlFromVal(resolvedParams || {}, "useValRouteUrl", selector && Internal.getValPath(selector), selector && Internal.getSchema(selector), val);
+  var route = getValRouteUrlFromVal(resolvedParams || {}, "useValRouteUrl", valModule && Internal.getValPath(valModule), valModule && Internal.getSchema(valModule), val);
   return route;
 }
 

package/dist/declarations/src/client/initValClient.d.ts

@@ -1,9 +1,9 @@
-import { GenericSelector, JsonSource, SelectorOf, SelectorSource, SourceObject, ValModule } from "@valbuild/core";
-import { StegaOfSource } from "@valbuild/react/stega";
+import { type ResolvableModule, SelectorSource } from "@valbuild/core";
+import { type JsonEntryContentOf, type Resolvable, type ResolvedVal, type RouteValueOf } from "@valbuild/react/stega";
 import { ValConfig } from "@valbuild/core";
-export type UseValType<T extends SelectorSource> = SelectorOf<T> extends GenericSelector<infer S> ? StegaOfSource<S> : never;
-declare function useValStega<T extends SelectorSource>(selector: T): UseValType<T>;
-type JsonEntryContentOf<T extends ValModule<GenericSelector<SourceObject>>> = T extends ValModule<infer S> ? S extends Record<string, infer V> ? V extends JsonSource<infer C> ? C : never : never : never;
+/** What `useVal` gives back — see `ResolvedVal` in `@valbuild/react/stega`. */
+export type UseValType<T extends SelectorSource> = ResolvedVal<T>;
+declare function useValStega<T extends Resolvable>(selector: T): UseValType<T>;
 /**
  * Client counterpart to `fetchValKey`: resolves a SINGLE `.jsonValues()` entry
  * by key, loading only that entry's backing `*.val.json` (one dynamic import).
@@ -14,10 +14,9 @@ type JsonEntryContentOf<T extends ValModule<GenericSelector<SourceObject>>> = T
  * overlay; in production — and whenever there is no draft view — it resolves the
  * entry's lazy import thunk from the local module.
  */
-declare function useValKeyStega<T extends ValModule<GenericSelector<SourceObject>>>(selector: T, key: string): JsonEntryContentOf<T> | undefined;
-type UseValRouteReturnType<T extends ValModule<GenericSelector<SourceObject>>> = T extends ValModule<infer S> ? S extends SourceObject ? NonNullable<S>[string] extends JsonSource<infer C> ? C | null : StegaOfSource<NonNullable<S>[string]> | null : never : never;
-declare function useValRouteStega<T extends ValModule<GenericSelector<SourceObject>>>(selector: T, params: Record<string, string | string[]> | Promise<Record<string, string | string[]>>): UseValRouteReturnType<T>;
-declare function useValRouteUrl<T extends ValModule<GenericSelector<SourceObject>>>(selector: T, params?: Record<string, string | string[]> | Promise<Record<string, string | string[]>>): string | null;
+declare function useValKeyStega<T extends ResolvableModule>(selector: T, key: string): JsonEntryContentOf<T> | undefined;
+declare function useValRouteStega<T extends ResolvableModule>(selector: T, params: Record<string, string | string[]> | Promise<Record<string, string | string[]>>): RouteValueOf<T>;
+declare function useValRouteUrl<T extends ResolvableModule>(selector: T, params?: Record<string, string | string[]> | Promise<Record<string, string | string[]>>): string | null;
 export declare function initValClient(config: ValConfig): {
     useValStega: typeof useValStega;
     useValKeyStega: typeof useValKeyStega;

package/dist/declarations/src/rsc/initValRsc.d.ts

@@ -1,5 +1,5 @@
-import { type StegaOfSource } from "@valbuild/react/stega";
-import { SelectorSource, SelectorOf, GenericSelector, ValConfig, ValModules, ValModule, SourceObject, JsonSource } from "@valbuild/core";
+import { type JsonEntryContentOf, type Resolvable, type ResolvedVal, type RouteValueOf } from "@valbuild/react/stega";
+import { ValConfig, ValModules, type ResolvableModule } from "@valbuild/core";
 import { cookies, draftMode, headers } from "next/headers";
 import { ValServer } from "@valbuild/server";
 declare const initFetchValStega: (config: ValConfig, valApiEndpoints: string, valServerPromise: Promise<ValServer>, isEnabled: () => Promise<boolean>, getHeaders: () => Promise<{
@@ -9,8 +9,7 @@ declare const initFetchValStega: (config: ValConfig, valApiEndpoints: string, va
         name: string;
         value: string;
     } | undefined;
-}>) => <T extends SelectorSource>(selector: T) => Promise<SelectorOf<T> extends GenericSelector<infer S> ? StegaOfSource<S> : never>;
-type FetchValRouteReturnType<T extends ValModule<GenericSelector<SourceObject>>> = T extends ValModule<infer S> ? S extends SourceObject ? NonNullable<S>[string] extends JsonSource<infer C> ? C | null : StegaOfSource<NonNullable<S>[string]> | null : never : never;
+}>) => <T extends Resolvable>(selector: T) => Promise<ResolvedVal<T>>;
 declare const initFetchValRouteStega: (config: ValConfig, valApiEndpoints: string, valServerPromise: Promise<ValServer>, isEnabled: () => Promise<boolean>, getHeaders: () => Promise<{
     get(name: string): string | null;
 }>, getCookies: () => Promise<{
@@ -18,7 +17,7 @@ declare const initFetchValRouteStega: (config: ValConfig, valApiEndpoints: strin
         name: string;
         value: string;
     } | undefined;
-}>) => <T extends ValModule<GenericSelector<SourceObject>>>(selector: T, params: Promise<Record<string, string | string[]>> | Record<string, string | string[]> | unknown) => Promise<FetchValRouteReturnType<T>>;
+}>) => <T extends ResolvableModule>(selector: T, params: Promise<Record<string, string | string[]>> | Record<string, string | string[]> | unknown) => Promise<RouteValueOf<T>>;
 /**
  * Loads a single `.jsonValues()` entry's DRAFT content via the in-process
  * `/json` endpoint (which replays pending patches). Returns `undefined` when the
@@ -59,7 +58,6 @@ export type DraftJsonEntry = {
  * a null/undefined result.
  */
 export declare function resolveDraftOrCommittedEntry(draft: DraftJsonEntry, loadCommitted: () => Promise<unknown | undefined>): Promise<unknown | undefined>;
-type JsonEntryContentOf<T extends ValModule<GenericSelector<SourceObject>>> = T extends ValModule<infer S> ? S extends Record<string, infer V> ? V extends JsonSource<infer C> ? C : never : never : never;
 /**
  * Resolves ONE `.jsonValues()` entry by key, loading only that entry instead of
  * the whole record — the runtime-scaling counterpart to the eager `fetchVal`.
@@ -76,7 +74,7 @@ export declare const initFetchValKeyStega: (valServerPromise: Promise<JsonEntryV
         name: string;
         value: string;
     } | undefined;
-}>) => <T extends ValModule<GenericSelector<SourceObject>>>(selector: T, key: string) => Promise<JsonEntryContentOf<T> | undefined>;
+}>) => <T extends ResolvableModule>(selector: T, key: string) => Promise<JsonEntryContentOf<T> | undefined>;
 declare const initFetchValRouteUrl: (config: ValConfig, valApiEndpoints: string, valServerPromise: Promise<ValServer>, isEnabled: () => Promise<boolean>, getHeaders: () => Promise<{
     get(name: string): string | null;
 }>, getCookies: () => Promise<{
@@ -84,7 +82,7 @@ declare const initFetchValRouteUrl: (config: ValConfig, valApiEndpoints: string,
         name: string;
         value: string;
     } | undefined;
-}>) => <T extends ValModule<GenericSelector<SourceObject>>>(selector: T, params?: Promise<Record<string, string | string[]>> | Record<string, string | string[]> | unknown) => Promise<string | null>;
+}>) => <T extends ResolvableModule>(selector: T, params?: Promise<Record<string, string | string[]>> | Record<string, string | string[]> | unknown) => Promise<string | null>;
 type ValNextRscConfig = {
     draftMode: typeof draftMode;
     headers: typeof headers;

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

@@ -12,7 +12,7 @@ var NextImage = require('next/image');
 var jsxRuntime = require('react/jsx-runtime');
 var ValApp = require('./ValApp-294e5b53.cjs.dev.js');
 var ValModulesClient = require('./ValModulesClient-4ecabf99.cjs.dev.js');
-var version = require('./version-3721f88f.cjs.dev.js');
+var version = require('./version-ddff5d6a.cjs.dev.js');
 var createForOfIteratorHelper = require('./createForOfIteratorHelper-0445603c.cjs.dev.js');
 require('./defineProperty-f90345d7.cjs.dev.js');
 require('./unsupportedIterableToArray-c8ab77c9.cjs.dev.js');

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

@@ -12,7 +12,7 @@ var NextImage = require('next/image');
 var jsxRuntime = require('react/jsx-runtime');
 var ValApp = require('./ValApp-ab8a96fd.cjs.prod.js');
 var ValModulesClient = require('./ValModulesClient-10c0721c.cjs.prod.js');
-var version = require('./version-bf666fd9.cjs.prod.js');
+var version = require('./version-a3e5a2df.cjs.prod.js');
 var createForOfIteratorHelper = require('./createForOfIteratorHelper-d4afcad8.cjs.prod.js');
 require('./defineProperty-8951f469.cjs.prod.js');
 require('./unsupportedIterableToArray-0d2087a2.cjs.prod.js');

package/dist/valbuild-next.esm.js

@@ -11,7 +11,7 @@ import NextImage from 'next/image';
 import { jsx } from 'react/jsx-runtime';
 export { ValApp } from './ValApp-3a70afe1.esm.js';
 export { ValModulesClient, useRegisterValModules } from './ValModulesClient-0dd601a1.esm.js';
-import { V as VERSION } from './version-b027675f.esm.js';
+import { V as VERSION } from './version-28baa77f.esm.js';
 import { _ as _createForOfIteratorHelper } from './createForOfIteratorHelper-5758a730.esm.js';
 import './defineProperty-cca5affa.esm.js';
 import './unsupportedIterableToArray-5baabfdc.esm.js';

package/dist/{version-b027675f.esm.js → version-28baa77f.esm.js}

@@ -12,7 +12,7 @@ var packageJson = {
 		"next",
 		"react"
 	],
-	version: "0.133.0",
+	version: "0.134.1",
 	scripts: {
 		typecheck: "tsc --noEmit",
 		test: "jest"

package/dist/{version-3721f88f.cjs.dev.js → version-a3e5a2df.cjs.prod.js}

@@ -14,7 +14,7 @@ var packageJson = {
 		"next",
 		"react"
 	],
-	version: "0.133.0",
+	version: "0.134.1",
 	scripts: {
 		typecheck: "tsc --noEmit",
 		test: "jest"

package/dist/{version-bf666fd9.cjs.prod.js → version-ddff5d6a.cjs.dev.js}

@@ -14,7 +14,7 @@ var packageJson = {
 		"next",
 		"react"
 	],
-	version: "0.133.0",
+	version: "0.134.1",
 	scripts: {
 		typecheck: "tsc --noEmit",
 		test: "jest"

package/package.json

@@ -12,7 +12,7 @@
     "next",
     "react"
   ],
-  "version": "0.133.0",
+  "version": "0.134.1",
   "main": "dist/valbuild-next.cjs.js",
   "module": "dist/valbuild-next.esm.js",
   "exports": {
@@ -47,13 +47,13 @@
   "dependencies": {
     "client-only": "^0.0.1",
     "server-only": "^0.0.1",
-    "@valbuild/core": "0.130.0",
-    "@valbuild/language-server": "0.133.0",
-    "@valbuild/mcp": "0.133.0",
-    "@valbuild/react": "0.133.0",
-    "@valbuild/server": "0.133.0",
-    "@valbuild/shared": "0.133.0",
-    "@valbuild/ui": "0.133.0"
+    "@valbuild/core": "0.134.0",
+    "@valbuild/language-server": "0.134.1",
+    "@valbuild/mcp": "0.134.1",
+    "@valbuild/server": "0.134.1",
+    "@valbuild/react": "0.134.1",
+    "@valbuild/shared": "0.134.1",
+    "@valbuild/ui": "0.134.0"
   },
   "devDependencies": {
     "@testing-library/react": "^16.3.3",

package/rsc/dist/valbuild-next-rsc.cjs.dev.js

@@ -11,7 +11,7 @@ var stega = require('@valbuild/react/stega');
 var core = require('@valbuild/core');
 var internal = require('@valbuild/shared/internal');
 var server = require('@valbuild/server');
-var version = require('../../dist/version-3721f88f.cjs.dev.js');
+var version = require('../../dist/version-ddff5d6a.cjs.dev.js');
 require('../../dist/createForOfIteratorHelper-0445603c.cjs.dev.js');
 require('../../dist/unsupportedIterableToArray-c8ab77c9.cjs.dev.js');
 require('../../dist/slicedToArray-44036a76.cjs.dev.js');
@@ -199,7 +199,7 @@ function getHost(headers) {
 var initFetchValRouteStega = function initFetchValRouteStega(config, valApiEndpoints, valServerPromise, isEnabled, getHeaders, getCookies) {
   return /*#__PURE__*/function () {
     var _ref2 = asyncToGenerator._asyncToGenerator(/*#__PURE__*/asyncToGenerator._regenerator().m(function _callee2(selector, params) {
-      var resolvedParams, path, schema, source, url, enabled, draft, content, fetchVal, val, route, _t5;
+      var resolvedParams, valModule, path, schema, source, url, enabled, draft, content, fetchVal, val, route, _t5;
       return asyncToGenerator._regenerator().w(function (_context2) {
         while (1) switch (_context2.p = _context2.n) {
           case 0:
@@ -207,15 +207,18 @@ var initFetchValRouteStega = function initFetchValRouteStega(config, valApiEndpo
             return Promise.resolve(params);
           case 1:
             resolvedParams = _context2.v;
-            path = selector && core.Internal.getValPath(selector);
-            schema = selector && core.Internal.getSchema(selector); // `.jsonValues()` router: map params → the entry key and load ONLY that
+            // A view is a pointer: everything below reads a path, a schema and a source
+            // off this, and a pointer has none of them. See `resolveViewedModule`.
+            valModule = core.Internal.resolveViewedModule(selector);
+            path = valModule && core.Internal.getValPath(valModule);
+            schema = valModule && core.Internal.getSchema(valModule); // `.jsonValues()` router: map params → the entry key and load ONLY that
             // entry's backing `*.val.json`, instead of eagerly resolving the whole
             // record via `fetchVal`.
             if (!routeFromVal.isJsonValuesRecordSchema(schema)) {
               _context2.n = 11;
               break;
             }
-            source = selector && core.Internal.getSource(selector);
+            source = valModule && core.Internal.getSource(valModule);
             url = routeFromVal.getValRouteUrlFromVal(resolvedParams, "fetchValRoute", path, schema, source);
             if (url) {
               _context2.n = 2;
@@ -262,17 +265,17 @@ var initFetchValRouteStega = function initFetchValRouteStega(config, valApiEndpo
           case 10:
             return _context2.a(2, stega.stegaEncode(content, {
               disabled: !enabled,
-              root: routeFromVal.getJsonEntryStegaRoot(selector, url)
+              root: routeFromVal.getJsonEntryStegaRoot(valModule, url)
             }));
           case 11:
             fetchVal = initFetchValStega(config, valApiEndpoints, valServerPromise, isEnabled, getHeaders, getCookies);
-            _t5 = selector;
+            _t5 = valModule;
             if (!_t5) {
               _context2.n = 13;
               break;
             }
             _context2.n = 12;
-            return fetchVal(selector);
+            return fetchVal(valModule);
           case 12:
             _t5 = _context2.v;
           case 13:
@@ -389,7 +392,18 @@ function _resolveDraftOrCommittedEntry() {
 }
 function loadDraftJsonEntry(_x7, _x8, _x9, _x0) {
   return _loadDraftJsonEntry.apply(this, arguments);
-} // The (loosened) content type a single `.jsonValues()` entry resolves to.
+}
+/**
+ * Resolves ONE `.jsonValues()` entry by key, loading only that entry instead of
+ * the whole record — the runtime-scaling counterpart to the eager `fetchVal`.
+ *
+ * Production (Val disabled): resolves the entry's lazy import thunk from the
+ * locally-bundled module. One dynamic import, no server round-trip.
+ *
+ * Enabled (draft mode): reads the entry through `/json`, which replays pending
+ * patches, so uncommitted Studio edits show up. Falls back to the local thunk if
+ * the draft read yields nothing.
+ */
 function _loadDraftJsonEntry() {
   _loadDraftJsonEntry = asyncToGenerator._asyncToGenerator(/*#__PURE__*/asyncToGenerator._regenerator().m(function _callee19(valServerPromise, getCookies, moduleFilePath, key) {
     var _cookies3;
@@ -474,21 +488,10 @@ function _loadDraftJsonEntry() {
   }));
   return _loadDraftJsonEntry.apply(this, arguments);
 }
-/**
- * Resolves ONE `.jsonValues()` entry by key, loading only that entry instead of
- * the whole record — the runtime-scaling counterpart to the eager `fetchVal`.
- *
- * Production (Val disabled): resolves the entry's lazy import thunk from the
- * locally-bundled module. One dynamic import, no server round-trip.
- *
- * Enabled (draft mode): reads the entry through `/json`, which replays pending
- * patches, so uncommitted Studio edits show up. Falls back to the local thunk if
- * the draft read yields nothing.
- */
 var initFetchValKeyStega = function initFetchValKeyStega(valServerPromise, isEnabled, getCookies) {
   return /*#__PURE__*/function () {
     var _ref3 = asyncToGenerator._asyncToGenerator(/*#__PURE__*/asyncToGenerator._regenerator().m(function _callee3(selector, key) {
-      var enabled, source, moduleFilePath, draft, content;
+      var enabled, valModule, source, moduleFilePath, draft, content;
       return asyncToGenerator._regenerator().w(function (_context3) {
         while (1) switch (_context3.p = _context3.n) {
           case 0:
@@ -504,8 +507,11 @@ var initFetchValKeyStega = function initFetchValKeyStega(valServerPromise, isEna
             _context3.p = 3;
             _context3.v;
           case 4:
-            source = selector && core.Internal.getSource(selector);
-            moduleFilePath = selector && core.Internal.getValPath(selector);
+            // A view is a pointer: everything below reads a path and a source off this,
+            // and a pointer has neither. See `resolveViewedModule`.
+            valModule = core.Internal.resolveViewedModule(selector);
+            source = valModule && core.Internal.getSource(valModule);
+            moduleFilePath = valModule && core.Internal.getValPath(valModule);
             draft = {
               status: "unavailable"
             };
@@ -533,7 +539,7 @@ var initFetchValKeyStega = function initFetchValKeyStega(valServerPromise, isEna
           case 8:
             return _context3.a(2, stega.stegaEncode(content, {
               disabled: !enabled,
-              root: routeFromVal.getJsonEntryStegaRoot(selector, key)
+              root: routeFromVal.getJsonEntryStegaRoot(valModule, key)
             }));
         }
       }, _callee3, null, [[1, 3]]);
@@ -546,7 +552,7 @@ var initFetchValKeyStega = function initFetchValKeyStega(valServerPromise, isEna
 var initFetchValRouteUrl = function initFetchValRouteUrl(config, valApiEndpoints, valServerPromise, isEnabled, getHeaders, getCookies) {
   return /*#__PURE__*/function () {
     var _ref4 = asyncToGenerator._asyncToGenerator(/*#__PURE__*/asyncToGenerator._regenerator().m(function _callee4(selector, params) {
-      var fetchVal, resolvedParams, path, schema, val, route, _t7, _t8;
+      var fetchVal, resolvedParams, valModule, path, schema, val, route, _t7, _t8;
       return asyncToGenerator._regenerator().w(function (_context4) {
         while (1) switch (_context4.n) {
           case 0:
@@ -565,15 +571,18 @@ var initFetchValRouteUrl = function initFetchValRouteUrl(config, valApiEndpoints
             _t7 = _context4.v;
           case 3:
             resolvedParams = _t7;
-            path = selector && core.Internal.getValPath(selector);
-            schema = selector && core.Internal.getSchema(selector);
-            _t8 = selector;
+            // A view is a pointer: everything below reads a path, a schema and a source
+            // off this, and a pointer has none of them. See `resolveViewedModule`.
+            valModule = core.Internal.resolveViewedModule(selector);
+            path = valModule && core.Internal.getValPath(valModule);
+            schema = valModule && core.Internal.getSchema(valModule);
+            _t8 = valModule;
             if (!_t8) {
               _context4.n = 5;
               break;
             }
             _context4.n = 4;
-            return fetchVal(selector);
+            return fetchVal(valModule);
           case 4:
             _t8 = _context4.v;
           case 5:

package/rsc/dist/valbuild-next-rsc.cjs.prod.js

@@ -11,7 +11,7 @@ var stega = require('@valbuild/react/stega');
 var core = require('@valbuild/core');
 var internal = require('@valbuild/shared/internal');
 var server = require('@valbuild/server');
-var version = require('../../dist/version-bf666fd9.cjs.prod.js');
+var version = require('../../dist/version-a3e5a2df.cjs.prod.js');
 require('../../dist/createForOfIteratorHelper-d4afcad8.cjs.prod.js');
 require('../../dist/unsupportedIterableToArray-0d2087a2.cjs.prod.js');
 require('../../dist/slicedToArray-ce613de6.cjs.prod.js');
@@ -199,7 +199,7 @@ function getHost(headers) {
 var initFetchValRouteStega = function initFetchValRouteStega(config, valApiEndpoints, valServerPromise, isEnabled, getHeaders, getCookies) {
   return /*#__PURE__*/function () {
     var _ref2 = asyncToGenerator._asyncToGenerator(/*#__PURE__*/asyncToGenerator._regenerator().m(function _callee2(selector, params) {
-      var resolvedParams, path, schema, source, url, enabled, draft, content, fetchVal, val, route, _t5;
+      var resolvedParams, valModule, path, schema, source, url, enabled, draft, content, fetchVal, val, route, _t5;
       return asyncToGenerator._regenerator().w(function (_context2) {
         while (1) switch (_context2.p = _context2.n) {
           case 0:
@@ -207,15 +207,18 @@ var initFetchValRouteStega = function initFetchValRouteStega(config, valApiEndpo
             return Promise.resolve(params);
           case 1:
             resolvedParams = _context2.v;
-            path = selector && core.Internal.getValPath(selector);
-            schema = selector && core.Internal.getSchema(selector); // `.jsonValues()` router: map params → the entry key and load ONLY that
+            // A view is a pointer: everything below reads a path, a schema and a source
+            // off this, and a pointer has none of them. See `resolveViewedModule`.
+            valModule = core.Internal.resolveViewedModule(selector);
+            path = valModule && core.Internal.getValPath(valModule);
+            schema = valModule && core.Internal.getSchema(valModule); // `.jsonValues()` router: map params → the entry key and load ONLY that
             // entry's backing `*.val.json`, instead of eagerly resolving the whole
             // record via `fetchVal`.
             if (!routeFromVal.isJsonValuesRecordSchema(schema)) {
               _context2.n = 11;
               break;
             }
-            source = selector && core.Internal.getSource(selector);
+            source = valModule && core.Internal.getSource(valModule);
             url = routeFromVal.getValRouteUrlFromVal(resolvedParams, "fetchValRoute", path, schema, source);
             if (url) {
               _context2.n = 2;
@@ -262,17 +265,17 @@ var initFetchValRouteStega = function initFetchValRouteStega(config, valApiEndpo
           case 10:
             return _context2.a(2, stega.stegaEncode(content, {
               disabled: !enabled,
-              root: routeFromVal.getJsonEntryStegaRoot(selector, url)
+              root: routeFromVal.getJsonEntryStegaRoot(valModule, url)
             }));
           case 11:
             fetchVal = initFetchValStega(config, valApiEndpoints, valServerPromise, isEnabled, getHeaders, getCookies);
-            _t5 = selector;
+            _t5 = valModule;
             if (!_t5) {
               _context2.n = 13;
               break;
             }
             _context2.n = 12;
-            return fetchVal(selector);
+            return fetchVal(valModule);
           case 12:
             _t5 = _context2.v;
           case 13:
@@ -389,7 +392,18 @@ function _resolveDraftOrCommittedEntry() {
 }
 function loadDraftJsonEntry(_x7, _x8, _x9, _x0) {
   return _loadDraftJsonEntry.apply(this, arguments);
-} // The (loosened) content type a single `.jsonValues()` entry resolves to.
+}
+/**
+ * Resolves ONE `.jsonValues()` entry by key, loading only that entry instead of
+ * the whole record — the runtime-scaling counterpart to the eager `fetchVal`.
+ *
+ * Production (Val disabled): resolves the entry's lazy import thunk from the
+ * locally-bundled module. One dynamic import, no server round-trip.
+ *
+ * Enabled (draft mode): reads the entry through `/json`, which replays pending
+ * patches, so uncommitted Studio edits show up. Falls back to the local thunk if
+ * the draft read yields nothing.
+ */
 function _loadDraftJsonEntry() {
   _loadDraftJsonEntry = asyncToGenerator._asyncToGenerator(/*#__PURE__*/asyncToGenerator._regenerator().m(function _callee19(valServerPromise, getCookies, moduleFilePath, key) {
     var _cookies3;
@@ -474,21 +488,10 @@ function _loadDraftJsonEntry() {
   }));
   return _loadDraftJsonEntry.apply(this, arguments);
 }
-/**
- * Resolves ONE `.jsonValues()` entry by key, loading only that entry instead of
- * the whole record — the runtime-scaling counterpart to the eager `fetchVal`.
- *
- * Production (Val disabled): resolves the entry's lazy import thunk from the
- * locally-bundled module. One dynamic import, no server round-trip.
- *
- * Enabled (draft mode): reads the entry through `/json`, which replays pending
- * patches, so uncommitted Studio edits show up. Falls back to the local thunk if
- * the draft read yields nothing.
- */
 var initFetchValKeyStega = function initFetchValKeyStega(valServerPromise, isEnabled, getCookies) {
   return /*#__PURE__*/function () {
     var _ref3 = asyncToGenerator._asyncToGenerator(/*#__PURE__*/asyncToGenerator._regenerator().m(function _callee3(selector, key) {
-      var enabled, source, moduleFilePath, draft, content;
+      var enabled, valModule, source, moduleFilePath, draft, content;
       return asyncToGenerator._regenerator().w(function (_context3) {
         while (1) switch (_context3.p = _context3.n) {
           case 0:
@@ -504,8 +507,11 @@ var initFetchValKeyStega = function initFetchValKeyStega(valServerPromise, isEna
             _context3.p = 3;
             _context3.v;
           case 4:
-            source = selector && core.Internal.getSource(selector);
-            moduleFilePath = selector && core.Internal.getValPath(selector);
+            // A view is a pointer: everything below reads a path and a source off this,
+            // and a pointer has neither. See `resolveViewedModule`.
+            valModule = core.Internal.resolveViewedModule(selector);
+            source = valModule && core.Internal.getSource(valModule);
+            moduleFilePath = valModule && core.Internal.getValPath(valModule);
             draft = {
               status: "unavailable"
             };
@@ -533,7 +539,7 @@ var initFetchValKeyStega = function initFetchValKeyStega(valServerPromise, isEna
           case 8:
             return _context3.a(2, stega.stegaEncode(content, {
               disabled: !enabled,
-              root: routeFromVal.getJsonEntryStegaRoot(selector, key)
+              root: routeFromVal.getJsonEntryStegaRoot(valModule, key)
             }));
         }
       }, _callee3, null, [[1, 3]]);
@@ -546,7 +552,7 @@ var initFetchValKeyStega = function initFetchValKeyStega(valServerPromise, isEna
 var initFetchValRouteUrl = function initFetchValRouteUrl(config, valApiEndpoints, valServerPromise, isEnabled, getHeaders, getCookies) {
   return /*#__PURE__*/function () {
     var _ref4 = asyncToGenerator._asyncToGenerator(/*#__PURE__*/asyncToGenerator._regenerator().m(function _callee4(selector, params) {
-      var fetchVal, resolvedParams, path, schema, val, route, _t7, _t8;
+      var fetchVal, resolvedParams, valModule, path, schema, val, route, _t7, _t8;
       return asyncToGenerator._regenerator().w(function (_context4) {
         while (1) switch (_context4.n) {
           case 0:
@@ -565,15 +571,18 @@ var initFetchValRouteUrl = function initFetchValRouteUrl(config, valApiEndpoints
             _t7 = _context4.v;
           case 3:
             resolvedParams = _t7;
-            path = selector && core.Internal.getValPath(selector);
-            schema = selector && core.Internal.getSchema(selector);
-            _t8 = selector;
+            // A view is a pointer: everything below reads a path, a schema and a source
+            // off this, and a pointer has none of them. See `resolveViewedModule`.
+            valModule = core.Internal.resolveViewedModule(selector);
+            path = valModule && core.Internal.getValPath(valModule);
+            schema = valModule && core.Internal.getSchema(valModule);
+            _t8 = valModule;
             if (!_t8) {
               _context4.n = 5;
               break;
             }
             _context4.n = 4;
-            return fetchVal(selector);
+            return fetchVal(valModule);
           case 4:
             _t8 = _context4.v;
           case 5:

package/rsc/dist/valbuild-next-rsc.esm.js

@@ -7,7 +7,7 @@ import { SET_RSC, stegaEncode, SET_AUTO_TAG_JSX_ENABLED } from '@valbuild/react/
 import { Internal } from '@valbuild/core';
 import { VAL_SESSION_COOKIE } from '@valbuild/shared/internal';
 import { createValServer } from '@valbuild/server';
-import { V as VERSION } from '../../dist/version-b027675f.esm.js';
+import { V as VERSION } from '../../dist/version-28baa77f.esm.js';
 import '../../dist/createForOfIteratorHelper-5758a730.esm.js';
 import '../../dist/unsupportedIterableToArray-5baabfdc.esm.js';
 import '../../dist/slicedToArray-aa291011.esm.js';
@@ -195,7 +195,7 @@ function getHost(headers) {
 var initFetchValRouteStega = function initFetchValRouteStega(config, valApiEndpoints, valServerPromise, isEnabled, getHeaders, getCookies) {
   return /*#__PURE__*/function () {
     var _ref2 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee2(selector, params) {
-      var resolvedParams, path, schema, source, url, enabled, draft, content, fetchVal, val, route, _t5;
+      var resolvedParams, valModule, path, schema, source, url, enabled, draft, content, fetchVal, val, route, _t5;
       return _regenerator().w(function (_context2) {
         while (1) switch (_context2.p = _context2.n) {
           case 0:
@@ -203,15 +203,18 @@ var initFetchValRouteStega = function initFetchValRouteStega(config, valApiEndpo
             return Promise.resolve(params);
           case 1:
             resolvedParams = _context2.v;
-            path = selector && Internal.getValPath(selector);
-            schema = selector && Internal.getSchema(selector); // `.jsonValues()` router: map params → the entry key and load ONLY that
+            // A view is a pointer: everything below reads a path, a schema and a source
+            // off this, and a pointer has none of them. See `resolveViewedModule`.
+            valModule = Internal.resolveViewedModule(selector);
+            path = valModule && Internal.getValPath(valModule);
+            schema = valModule && Internal.getSchema(valModule); // `.jsonValues()` router: map params → the entry key and load ONLY that
             // entry's backing `*.val.json`, instead of eagerly resolving the whole
             // record via `fetchVal`.
             if (!isJsonValuesRecordSchema(schema)) {
               _context2.n = 11;
               break;
             }
-            source = selector && Internal.getSource(selector);
+            source = valModule && Internal.getSource(valModule);
             url = getValRouteUrlFromVal(resolvedParams, "fetchValRoute", path, schema, source);
             if (url) {
               _context2.n = 2;
@@ -258,17 +261,17 @@ var initFetchValRouteStega = function initFetchValRouteStega(config, valApiEndpo
           case 10:
             return _context2.a(2, stegaEncode(content, {
               disabled: !enabled,
-              root: getJsonEntryStegaRoot(selector, url)
+              root: getJsonEntryStegaRoot(valModule, url)
             }));
           case 11:
             fetchVal = initFetchValStega(config, valApiEndpoints, valServerPromise, isEnabled, getHeaders, getCookies);
-            _t5 = selector;
+            _t5 = valModule;
             if (!_t5) {
               _context2.n = 13;
               break;
             }
             _context2.n = 12;
-            return fetchVal(selector);
+            return fetchVal(valModule);
           case 12:
             _t5 = _context2.v;
           case 13:
@@ -385,7 +388,18 @@ function _resolveDraftOrCommittedEntry() {
 }
 function loadDraftJsonEntry(_x7, _x8, _x9, _x0) {
   return _loadDraftJsonEntry.apply(this, arguments);
-} // The (loosened) content type a single `.jsonValues()` entry resolves to.
+}
+/**
+ * Resolves ONE `.jsonValues()` entry by key, loading only that entry instead of
+ * the whole record — the runtime-scaling counterpart to the eager `fetchVal`.
+ *
+ * Production (Val disabled): resolves the entry's lazy import thunk from the
+ * locally-bundled module. One dynamic import, no server round-trip.
+ *
+ * Enabled (draft mode): reads the entry through `/json`, which replays pending
+ * patches, so uncommitted Studio edits show up. Falls back to the local thunk if
+ * the draft read yields nothing.
+ */
 function _loadDraftJsonEntry() {
   _loadDraftJsonEntry = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee19(valServerPromise, getCookies, moduleFilePath, key) {
     var _cookies3;
@@ -470,21 +484,10 @@ function _loadDraftJsonEntry() {
   }));
   return _loadDraftJsonEntry.apply(this, arguments);
 }
-/**
- * Resolves ONE `.jsonValues()` entry by key, loading only that entry instead of
- * the whole record — the runtime-scaling counterpart to the eager `fetchVal`.
- *
- * Production (Val disabled): resolves the entry's lazy import thunk from the
- * locally-bundled module. One dynamic import, no server round-trip.
- *
- * Enabled (draft mode): reads the entry through `/json`, which replays pending
- * patches, so uncommitted Studio edits show up. Falls back to the local thunk if
- * the draft read yields nothing.
- */
 var initFetchValKeyStega = function initFetchValKeyStega(valServerPromise, isEnabled, getCookies) {
   return /*#__PURE__*/function () {
     var _ref3 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee3(selector, key) {
-      var enabled, source, moduleFilePath, draft, content;
+      var enabled, valModule, source, moduleFilePath, draft, content;
       return _regenerator().w(function (_context3) {
         while (1) switch (_context3.p = _context3.n) {
           case 0:
@@ -500,8 +503,11 @@ var initFetchValKeyStega = function initFetchValKeyStega(valServerPromise, isEna
             _context3.p = 3;
             _context3.v;
           case 4:
-            source = selector && Internal.getSource(selector);
-            moduleFilePath = selector && Internal.getValPath(selector);
+            // A view is a pointer: everything below reads a path and a source off this,
+            // and a pointer has neither. See `resolveViewedModule`.
+            valModule = Internal.resolveViewedModule(selector);
+            source = valModule && Internal.getSource(valModule);
+            moduleFilePath = valModule && Internal.getValPath(valModule);
             draft = {
               status: "unavailable"
             };
@@ -529,7 +535,7 @@ var initFetchValKeyStega = function initFetchValKeyStega(valServerPromise, isEna
           case 8:
             return _context3.a(2, stegaEncode(content, {
               disabled: !enabled,
-              root: getJsonEntryStegaRoot(selector, key)
+              root: getJsonEntryStegaRoot(valModule, key)
             }));
         }
       }, _callee3, null, [[1, 3]]);
@@ -542,7 +548,7 @@ var initFetchValKeyStega = function initFetchValKeyStega(valServerPromise, isEna
 var initFetchValRouteUrl = function initFetchValRouteUrl(config, valApiEndpoints, valServerPromise, isEnabled, getHeaders, getCookies) {
   return /*#__PURE__*/function () {
     var _ref4 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee4(selector, params) {
-      var fetchVal, resolvedParams, path, schema, val, route, _t7, _t8;
+      var fetchVal, resolvedParams, valModule, path, schema, val, route, _t7, _t8;
       return _regenerator().w(function (_context4) {
         while (1) switch (_context4.n) {
           case 0:
@@ -561,15 +567,18 @@ var initFetchValRouteUrl = function initFetchValRouteUrl(config, valApiEndpoints
             _t7 = _context4.v;
           case 3:
             resolvedParams = _t7;
-            path = selector && Internal.getValPath(selector);
-            schema = selector && Internal.getSchema(selector);
-            _t8 = selector;
+            // A view is a pointer: everything below reads a path, a schema and a source
+            // off this, and a pointer has none of them. See `resolveViewedModule`.
+            valModule = Internal.resolveViewedModule(selector);
+            path = valModule && Internal.getValPath(valModule);
+            schema = valModule && Internal.getSchema(valModule);
+            _t8 = valModule;
             if (!_t8) {
               _context4.n = 5;
               break;
             }
             _context4.n = 4;
-            return fetchVal(selector);
+            return fetchVal(valModule);
           case 4:
             _t8 = _context4.v;
           case 5:

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

@@ -9,7 +9,7 @@ var objectSpread2 = require('../../dist/objectSpread2-58024783.cjs.dev.js');
 var core = require('@valbuild/core');
 var server = require('@valbuild/server');
 var server$1 = require('next/server');
-var version = require('../../dist/version-3721f88f.cjs.dev.js');
+var version = require('../../dist/version-ddff5d6a.cjs.dev.js');
 var mcp = require('@valbuild/mcp');
 require('../../dist/unsupportedIterableToArray-c8ab77c9.cjs.dev.js');
 require('../../dist/defineProperty-f90345d7.cjs.dev.js');

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

@@ -9,7 +9,7 @@ var objectSpread2 = require('../../dist/objectSpread2-13f847a9.cjs.prod.js');
 var core = require('@valbuild/core');
 var server = require('@valbuild/server');
 var server$1 = require('next/server');
-var version = require('../../dist/version-bf666fd9.cjs.prod.js');
+var version = require('../../dist/version-a3e5a2df.cjs.prod.js');
 var mcp = require('@valbuild/mcp');
 require('../../dist/unsupportedIterableToArray-0d2087a2.cjs.prod.js');
 require('../../dist/defineProperty-8951f469.cjs.prod.js');

package/server/dist/valbuild-next-server.esm.js

@@ -5,7 +5,7 @@ import { _ as _objectSpread2 } from '../../dist/objectSpread2-60d1bd93.esm.js';
 import { Internal } from '@valbuild/core';
 import { createValApiRouter, createValServer } from '@valbuild/server';
 import { NextResponse } from 'next/server';
-import { V as VERSION } from '../../dist/version-b027675f.esm.js';
+import { V as VERSION } from '../../dist/version-28baa77f.esm.js';
 import { initValMcp as initValMcp$1 } from '@valbuild/mcp';
 import '../../dist/unsupportedIterableToArray-5baabfdc.esm.js';
 import '../../dist/defineProperty-cca5affa.esm.js';