@valbuild/tanstack 0.133.0 → 0.134.1

package/CHANGELOG.md

@@ -1,5 +1,118 @@
 # @valbuild/tanstack
 
+## 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
+
+- [#708](https://github.com/valbuild/val/pull/708) [`be78a9b`](https://github.com/valbuild/val/commit/be78a9b51678439f7ecb1c7f3887f9e8e1261a13) Thanks [@freekh](https://github.com/freekh)! - Fix `gitCommit` and `gitBranch` in `val.config.ts` never reaching the server,
+  and make them the one way to say it.
+
+  `val.config.ts` has had `gitCommit` and `gitBranch` for as long as it has had
+  anything, and a deployed app that set them resolved to no repository at all.
+  Nothing failed and nothing was logged: the commit was simply never sent, and
+  every patch the project saved recorded none.
+
+  ```ts
+  // val.config.ts — the normal Vercel shape, and it did nothing
+  initVal({
+    project: "org/project",
+    gitCommit: process.env.VERCEL_GIT_COMMIT_SHA,
+    gitBranch: process.env.VERCEL_GIT_COMMIT_REF,
+  });
+  ```
+
+  The two halves never met. The server wanted a nested
+  `git: { commit, branch }`, `val.config.ts` offered two flat keys, and nothing
+  mapped one onto the other — so the only thing that worked was
+  `VAL_GIT_COMMIT` / `VAL_GIT_BRANCH` in the environment.
+
+  Rather than teach the server to read both, the nested option is gone:
+  `ValApiOptions` and TanStack's `ValHttpMode` now take `gitCommit` and
+  `gitBranch`, the same two names `ValConfig` uses. There is one name for this
+  now, wherever it is set. The framework bindings already hand the server
+  `{ versions, ...config }`, so a project's config keys arrive with nothing to
+  map, and a host passing them directly is saying the same thing in the same
+  words.
+
+  Flat because of where these values come from. A platform supplies them as
+  `process.env.VERCEL_GIT_COMMIT_SHA` and friends, typed `string | undefined`,
+  and two optional strings take that as it comes — a nested object makes every
+  caller write the ternary that turns two maybe-strings into one maybe-object.
+
+  **Breaking for a host that passed `git` itself**, which is the nested option on
+  `ValApiOptions` and on TanStack's `http` mode. An app that only configures
+  `val.config.ts` or the environment is unaffected.
+
+  ```ts
+  // before
+  initValServer(valModules, config, {
+    http: { apiKey, valSecret, git: { commit, branch } },
+  });
+
+  // after
+  initValServer(valModules, config, {
+    http: { apiKey, valSecret, gitCommit: commit, gitBranch: branch },
+  });
+  ```
+
+  **What a commit is for**, and why its absence is worth a release rather than a
+  shrug: publishing turns pending patches into new `.val.ts` text, and to patch a
+  file you must first read it — at a commit. A project with none is a project
+  whose publishes read whatever the content service last had, rather than the
+  revision the deployed code was built from.
+
+  **One more behaviour change.** A commit and a branch have always been taken
+  together or not at all, and that check now sees config-supplied values too. A
+  project that sets exactly one of `gitCommit` and `gitBranch` used to have both
+  quietly ignored and will now be refused at startup, naming the missing half.
+  That is the configuration that would otherwise fail later, at a publish.
+
+- 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
 
 ### Minor Changes

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

@@ -16,6 +16,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 () {
@@ -141,8 +143,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();
@@ -159,7 +159,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") {
@@ -169,11 +172,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)
   });
 }
 
@@ -224,22 +227,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;
@@ -251,27 +257,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-tanstack-client.cjs.prod.js

@@ -16,6 +16,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 () {
@@ -141,8 +143,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();
@@ -159,7 +159,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") {
@@ -169,11 +172,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)
   });
 }
 
@@ -224,22 +227,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;
@@ -251,27 +257,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-tanstack-client.esm.js

@@ -8,6 +8,8 @@ import '@valbuild/shared/client';
 import '@valbuild/core/patch';
 import 'react/jsx-runtime';
 
+/** What `useVal` gives back — see `ResolvedVal` in `@valbuild/react/stega`. */
+
 function useValStega(selector) {
   var valOverlayContext = useValOverlayContext();
   var moduleIds = React.useMemo(function () {
@@ -133,8 +135,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();
@@ -151,7 +151,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") {
@@ -161,11 +164,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)
   });
 }
 
@@ -216,22 +219,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;
@@ -243,27 +249,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/server/initValContent.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 { ValServer, type ValPatchStore } from "@valbuild/server";
 import { type ValDraftMode } from "./valDraftMode.js";
 import type { ValHttpMode } from "./initValServer.js";
@@ -10,8 +10,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<{
@@ -19,7 +18,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
@@ -60,7 +59,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`.
@@ -77,7 +75,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<{
@@ -85,7 +83,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>;
 /**
  * Val's content readers for the server side of a TanStack Start app.
  *

package/dist/declarations/src/server/initValServer.d.ts

@@ -20,13 +20,19 @@ export type ValHttpMode = {
      * service is the store of record: it mints its own commit shas and knows the
      * project's branch, so there is nothing to bake into the build.
      *
-     * Where there is one: `commit` is the commit the running code was built
+     * Where there is one: `gitCommit` is the commit the running code was built
      * from, and it is load bearing. See the note at the use.
+     *
+     * The same two names `val.config.ts` and `ValApiOptions` use, and flat for
+     * the same reason: a platform hands these over as
+     * `process.env.VERCEL_GIT_COMMIT_SHA` and friends, typed
+     * `string | undefined`, and two optional strings take that as it comes
+     * rather than making every caller write a ternary to build an object.
+     *
+     * Taken together or not at all -- one without the other is refused.
      */
-    git?: {
-        commit: string;
-        branch: string;
-    };
+    gitCommit?: string;
+    gitBranch?: string;
     /**
      * Val's content service, when it is not the real one.
      *

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

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var version = require('./version-8deeac5f.cjs.dev.js');
+var version = require('./version-dbd88542.cjs.dev.js');
 var createForOfIteratorHelper = require('./createForOfIteratorHelper-e75681d7.cjs.dev.js');
 var core = require('@valbuild/core');
 var stega = require('@valbuild/react/stega');

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

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var version = require('./version-7d59b1f2.cjs.prod.js');
+var version = require('./version-9bae6ba4.cjs.prod.js');
 var createForOfIteratorHelper = require('./createForOfIteratorHelper-0324e063.cjs.prod.js');
 var core = require('@valbuild/core');
 var stega = require('@valbuild/react/stega');

package/dist/valbuild-tanstack.esm.js

@@ -1,4 +1,4 @@
-import { _ as _asyncToGenerator, a as _regenerator, r as readValEnableCookie, V as VERSION$1 } from './version-ed8bd465.esm.js';
+import { _ as _asyncToGenerator, a as _regenerator, r as readValEnableCookie, V as VERSION$1 } from './version-74f8b5ce.esm.js';
 import { _ as _objectSpread2, a as _slicedToArray, b as _createForOfIteratorHelper } from './createForOfIteratorHelper-485c2ce1.esm.js';
 import { Internal as Internal$1, initVal as initVal$1, DEFAULT_CONTENT_HOST } from '@valbuild/core';
 import * as core from '@valbuild/core';

package/dist/{version-ed8bd465.esm.js → version-74f8b5ce.esm.js}

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

package/dist/{version-7d59b1f2.cjs.prod.js → version-9bae6ba4.cjs.prod.js}

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

package/dist/{version-8deeac5f.cjs.dev.js → version-dbd88542.cjs.dev.js}

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

package/package.json

@@ -14,7 +14,7 @@
     "tanstack-router",
     "react"
   ],
-  "version": "0.133.0",
+  "version": "0.134.1",
   "main": "dist/valbuild-tanstack.cjs.js",
   "module": "dist/valbuild-tanstack.esm.js",
   "exports": {
@@ -42,13 +42,13 @@
     "exports": true
   },
   "dependencies": {
-    "@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/mcp": "0.134.1",
+    "@valbuild/react": "0.134.1",
+    "@valbuild/server": "0.134.1",
+    "@valbuild/language-server": "0.134.1",
+    "@valbuild/shared": "0.134.1",
+    "@valbuild/ui": "0.134.0"
   },
   "devDependencies": {
     "@tanstack/react-router": "^1.170.33",

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

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var version = require('../../dist/version-8deeac5f.cjs.dev.js');
+var version = require('../../dist/version-dbd88542.cjs.dev.js');
 var core = require('@valbuild/core');
 var createForOfIteratorHelper = require('../../dist/createForOfIteratorHelper-e75681d7.cjs.dev.js');
 var server = require('@valbuild/server');
@@ -506,7 +506,7 @@ function getHost(headers) {
 var initFetchValRouteStega = function initFetchValRouteStega(config, valApiEndpoints, valServerPromise, isEnabled, getHeaders, getCookies) {
   return /*#__PURE__*/function () {
     var _ref2 = version._asyncToGenerator(/*#__PURE__*/version._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 version._regenerator().w(function (_context2) {
         while (1) switch (_context2.p = _context2.n) {
           case 0:
@@ -514,15 +514,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;
@@ -569,17 +572,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:
@@ -696,7 +699,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 = version._asyncToGenerator(/*#__PURE__*/version._regenerator().m(function _callee7(valServerPromise, getCookies, moduleFilePath, key) {
     var _cookies3;
@@ -781,21 +795,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 = version._asyncToGenerator(/*#__PURE__*/version._regenerator().m(function _callee3(selector, key) {
-      var enabled, source, moduleFilePath, draft, content;
+      var enabled, valModule, source, moduleFilePath, draft, content;
       return version._regenerator().w(function (_context3) {
         while (1) switch (_context3.p = _context3.n) {
           case 0:
@@ -811,8 +814,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"
             };
@@ -840,7 +846,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]]);
@@ -853,7 +859,7 @@ var initFetchValKeyStega = function initFetchValKeyStega(valServerPromise, isEna
 var initFetchValRouteUrl = function initFetchValRouteUrl(config, valApiEndpoints, valServerPromise, isEnabled, getHeaders, getCookies) {
   return /*#__PURE__*/function () {
     var _ref4 = version._asyncToGenerator(/*#__PURE__*/version._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 version._regenerator().w(function (_context4) {
         while (1) switch (_context4.n) {
           case 0:
@@ -872,15 +878,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/server/dist/valbuild-tanstack-server.cjs.prod.js

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var version = require('../../dist/version-7d59b1f2.cjs.prod.js');
+var version = require('../../dist/version-9bae6ba4.cjs.prod.js');
 var core = require('@valbuild/core');
 var createForOfIteratorHelper = require('../../dist/createForOfIteratorHelper-0324e063.cjs.prod.js');
 var server = require('@valbuild/server');
@@ -506,7 +506,7 @@ function getHost(headers) {
 var initFetchValRouteStega = function initFetchValRouteStega(config, valApiEndpoints, valServerPromise, isEnabled, getHeaders, getCookies) {
   return /*#__PURE__*/function () {
     var _ref2 = version._asyncToGenerator(/*#__PURE__*/version._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 version._regenerator().w(function (_context2) {
         while (1) switch (_context2.p = _context2.n) {
           case 0:
@@ -514,15 +514,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;
@@ -569,17 +572,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:
@@ -696,7 +699,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 = version._asyncToGenerator(/*#__PURE__*/version._regenerator().m(function _callee7(valServerPromise, getCookies, moduleFilePath, key) {
     var _cookies3;
@@ -781,21 +795,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 = version._asyncToGenerator(/*#__PURE__*/version._regenerator().m(function _callee3(selector, key) {
-      var enabled, source, moduleFilePath, draft, content;
+      var enabled, valModule, source, moduleFilePath, draft, content;
       return version._regenerator().w(function (_context3) {
         while (1) switch (_context3.p = _context3.n) {
           case 0:
@@ -811,8 +814,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"
             };
@@ -840,7 +846,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]]);
@@ -853,7 +859,7 @@ var initFetchValKeyStega = function initFetchValKeyStega(valServerPromise, isEna
 var initFetchValRouteUrl = function initFetchValRouteUrl(config, valApiEndpoints, valServerPromise, isEnabled, getHeaders, getCookies) {
   return /*#__PURE__*/function () {
     var _ref4 = version._asyncToGenerator(/*#__PURE__*/version._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 version._regenerator().w(function (_context4) {
         while (1) switch (_context4.n) {
           case 0:
@@ -872,15 +878,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/server/dist/valbuild-tanstack-server.esm.js

@@ -1,4 +1,4 @@
-import { _ as _asyncToGenerator, a as _regenerator, V as VERSION, s as setValEnableCookieReader } from '../../dist/version-ed8bd465.esm.js';
+import { _ as _asyncToGenerator, a as _regenerator, V as VERSION, s as setValEnableCookieReader } from '../../dist/version-74f8b5ce.esm.js';
 import { Internal } from '@valbuild/core';
 import { _ as _objectSpread2, a as _slicedToArray, d as _defineProperty } from '../../dist/createForOfIteratorHelper-485c2ce1.esm.js';
 import { createValApiRouter, createValServer } from '@valbuild/server';
@@ -485,7 +485,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:
@@ -493,15 +493,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;
@@ -548,17 +551,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:
@@ -675,7 +678,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 _callee7(valServerPromise, getCookies, moduleFilePath, key) {
     var _cookies3;
@@ -760,21 +774,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:
@@ -790,8 +793,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"
             };
@@ -819,7 +825,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]]);
@@ -832,7 +838,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:
@@ -851,15 +857,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: