@valbuild/tanstack 0.124.0

package/dist/routeFromVal-6693e037.cjs.prod.js

@@ -0,0 +1,218 @@
+'use strict';
+
+var createForOfIteratorHelper = require('./createForOfIteratorHelper-0324e063.cjs.prod.js');
+var core = require('@valbuild/core');
+var client = require('@valbuild/shared/client');
+
+function _typeof(o) {
+  "@babel/helpers - typeof";
+
+  return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) {
+    return typeof o;
+  } : function (o) {
+    return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o;
+  }, _typeof(o);
+}
+
+/**
+ * True when the module's schema is a `.jsonValues()` record/router — i.e. each
+ * entry value is a lazily-loaded `c.json(() => import(...))` marker. Used by the
+ * route helpers to load ONLY the matched entry instead of the whole record.
+ */
+function isJsonValuesRecordSchema(schema) {
+  return schema instanceof core.RecordSchema && schema["executeSerialize"]().jsonValues === true;
+}
+
+/**
+ * Builds the `stegaEncode` `root` seed for a single `.jsonValues()` entry, so its
+ * strings get edit tags. Without a seed, `stegaEncode` on raw entry content is an
+ * identity transform (the content carries no selector path/schema).
+ *
+ * Yields e.g. `/src/routes/support.$slug.val.ts?p="/support/faq"`, so a `title`
+ * field is tagged `…?p="/support/faq"."title"` — the shape the Studio's
+ * `findUnloadedJsonEntryKey` walks, so click-to-edit + lazy load line up.
+ */
+function getJsonEntryStegaRoot(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+selector, key
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+) {
+  var modulePath = selector && core.Internal.getValPath(selector);
+  if (!modulePath) {
+    return undefined;
+  }
+  var schema = selector && core.Internal.getSchema(selector);
+  if (!(schema instanceof core.RecordSchema)) {
+    return undefined;
+  }
+  var path = core.Internal.createValPathOfItem(modulePath, key);
+  if (!path) {
+    return undefined;
+  }
+  return {
+    path: path,
+    schema: schema["executeSerialize"]().item
+  };
+}
+function getValRouteUrlFromVal(resolvedParams, methodName,
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+path,
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+schema,
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+val) {
+  if (!path) {
+    console.error("Val: ".concat(methodName, " can only be used with a Val module (details: no Val path found)."));
+    return null;
+  }
+  if (val === null) {
+    return null;
+  }
+  if (_typeof(val) !== "object") {
+    console.error("Val: ".concat(methodName, " must be used with a Val Module that is a s.record().router(...) (details: expected type object, found ").concat(_typeof(val), " instead)."));
+    return null;
+  }
+  if (Array.isArray(val)) {
+    console.error("Val: ".concat(methodName, " must be used with a Val Module that is a s.record().router(...) (details: expected type object, found array instead)."));
+    return null;
+  }
+  if (!schema) {
+    console.error("Val: ".concat(methodName, " must be used with a Val Module that is a s.record().router(...) (details: no schema found)."));
+    return null;
+  }
+  if (!(schema instanceof core.RecordSchema)) {
+    console.error("Val: ".concat(methodName, " must be used with a Val Module that is a s.record().router(...) (details: schema is not a record)."));
+  } else if (!schema["currentRouter"]) {
+    console.error("Val: ".concat(methodName, " must be used with a Val Module that is a s.record().router(...) (details: router is not set)."));
+  } else if (schema["currentRouter"].getRouterId() !== core.Internal.tanstackRouter.getRouterId() && schema["currentRouter"].getRouterId() !== core.Internal.externalPageRouter.getRouterId()) {
+    console.error("Val: ".concat(methodName, " must be used with a Val Module that is a s.record().router(...) (details: router is not the TanStack Router or External URL Page Router)."));
+    return null;
+  }
+  if (_typeof(resolvedParams) !== "object") {
+    console.error("Val: ".concat(methodName, " must be used with a Val Module that is a s.record().router(...) (details: params is not an object)."));
+    return null;
+  }
+  var _Internal$splitModule = core.Internal.splitModuleFilePathAndModulePath(path),
+    _Internal$splitModule2 = createForOfIteratorHelper._slicedToArray(_Internal$splitModule, 1),
+    moduleFilePath = _Internal$splitModule2[0];
+  /*
+   * A route module is named after the route file it sits beside.
+   *
+   * There is no `page.val.ts` here, because TanStack Router has no `page.tsx`:
+   * the route file IS the name of the route, so `routes/posts.$postId.tsx` is
+   * served by `routes/posts.$postId.val.ts` and the file name is the whole of
+   * what says which route this is. Being under `routes/` is therefore the only
+   * thing to check.
+   */
+  var srcFolder = client.getTanStackRouterSourceFolder(moduleFilePath);
+  if (!srcFolder) {
+    console.error("Val: ".concat(methodName, " was used with a Val module that is not in the /routes or /src/routes folder. Name the module after the route file it belongs to, e.g. /src/routes/posts.$postId.val.ts next to /src/routes/posts.$postId.tsx."));
+    return null;
+  }
+  var pattern = client.getPatternFromModuleFilePath(moduleFilePath, srcFolder);
+  var parsedPattern = client.parseRoutePattern(pattern);
+  var missingPatterns = [];
+  var fullPathParts = [];
+  var missingParamKeys = _typeof(resolvedParams) === "object" && resolvedParams !== null && !Array.isArray(resolvedParams) ? createForOfIteratorHelper._objectSpread2({}, resolvedParams) : {};
+  /*
+   * TanStack names a splat twice, and only one of the names is Val's.
+   *
+   * `useParams()` on a `$` route returns BOTH `_splat` and `*`, set to the same
+   * value — see `interpolatePath` in `@tanstack/router-core`. Val's pattern has
+   * one param for it, so the other name was left over at the end of the loop
+   * below and reported as a parameter that is not in the path: a console error
+   * on every render of a working splat route. Dropping it here rather than
+   * special-casing the report keeps "what was left over" meaning what it says.
+   */
+  if ("*" in missingParamKeys && "_splat" in missingParamKeys) {
+    delete missingParamKeys["*"];
+  }
+  var _iterator = createForOfIteratorHelper._createForOfIteratorHelper(parsedPattern !== null && parsedPattern !== void 0 ? parsedPattern : []),
+    _step;
+  try {
+    for (_iterator.s(); !(_step = _iterator.n()).done;) {
+      var part = _step.value;
+      if (part.type === "literal") {
+        fullPathParts.push(part.name);
+      } else if (part.type === "array-param" || part.type === "string-param") {
+        var key = part.paramName;
+        var value = resolvedParams === null || resolvedParams === void 0 ? void 0 : resolvedParams[key];
+        if (typeof value !== "string" && !Array.isArray(value)) {
+          missingPatterns.push(part);
+        } else if (Array.isArray(value)) {
+          if (missingParamKeys !== null && missingParamKeys !== void 0 && missingParamKeys[key]) {
+            delete missingParamKeys[key];
+          }
+          fullPathParts.push(value.join("/"));
+        } else {
+          if (missingParamKeys !== null && missingParamKeys !== void 0 && missingParamKeys[key]) {
+            delete missingParamKeys[key];
+          }
+          fullPathParts.push(value);
+        }
+      }
+    }
+  } catch (err) {
+    _iterator.e(err);
+  } finally {
+    _iterator.f();
+  }
+  var lastPattern = missingPatterns === null || missingPatterns === void 0 ? void 0 : missingPatterns[missingPatterns.length - 1];
+  var isLastOptional = lastPattern && lastPattern.type === "array-param" && lastPattern.optional;
+  if (isLastOptional) {
+    // We **think** that if the last pattern is optional we might still want to match
+    // An example: /some-path/[[...test]]
+    // Or even: /[[...path]]
+    // We believe there's no other legal ways to have optional patterns? Right?
+    missingPatterns.pop();
+  }
+  if (missingPatterns.length > 0) {
+    var errorMessageParams = missingPatterns.map(function (part) {
+      if (part.type === "literal") {
+        return part.name;
+      } else if (part.type === "string-param") {
+        if (part.optional) {
+          return "[[".concat(part.paramName, "]]");
+        }
+        return "[".concat(part.paramName, "]");
+      } else if (part.type === "array-param") {
+        if (part.optional) {
+          return "[[...".concat(part.paramName, "]]");
+        }
+        return "[...".concat(part.paramName, "]");
+      }
+    });
+    console.error("Val: ".concat(methodName, " could not find route since parameters: ").concat(errorMessageParams.join(", "), " where not provided. Make sure the Val module is named after the route file it belongs to, e.g. /src/routes/posts.$postId.val.ts next to /src/routes/posts.$postId.tsx."));
+    return null;
+  }
+  if (Object.keys(missingParamKeys).length > 0) {
+    console.error("Val: ".concat(methodName, " could not find route since parameters: ").concat(Object.keys(missingParamKeys).join(", "), " where not found in the path of: ").concat(moduleFilePath, ". Make sure ").concat(moduleFilePath, " is named after the route file it belongs to."));
+    // We do not return null here since we found a route that matches the path
+    // though chances are that there's something wrong in the way ${methodName} is used
+  }
+  var fullPath = fullPathParts.join("/");
+  return "/".concat(fullPath);
+}
+function initValRouteFromVal(resolvedParams, methodName,
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+path,
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+schema,
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+val) {
+  var url = getValRouteUrlFromVal(resolvedParams, methodName, path, schema, val);
+  if (!url) {
+    return null;
+  }
+  var actualRoute = val[url];
+  if (!actualRoute) {
+    return null;
+  }
+  return actualRoute;
+}
+
+exports._typeof = _typeof;
+exports.getJsonEntryStegaRoot = getJsonEntryStegaRoot;
+exports.getValRouteUrlFromVal = getValRouteUrlFromVal;
+exports.initValRouteFromVal = initValRouteFromVal;
+exports.isJsonValuesRecordSchema = isJsonValuesRecordSchema;

package/dist/routeFromVal-728295a0.esm.js

@@ -0,0 +1,212 @@
+import { a as _slicedToArray, _ as _objectSpread2, b as _createForOfIteratorHelper } from './createForOfIteratorHelper-485c2ce1.esm.js';
+import { RecordSchema, Internal } from '@valbuild/core';
+import { getTanStackRouterSourceFolder, getPatternFromModuleFilePath, parseRoutePattern } from '@valbuild/shared/client';
+
+function _typeof(o) {
+  "@babel/helpers - typeof";
+
+  return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) {
+    return typeof o;
+  } : function (o) {
+    return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o;
+  }, _typeof(o);
+}
+
+/**
+ * True when the module's schema is a `.jsonValues()` record/router — i.e. each
+ * entry value is a lazily-loaded `c.json(() => import(...))` marker. Used by the
+ * route helpers to load ONLY the matched entry instead of the whole record.
+ */
+function isJsonValuesRecordSchema(schema) {
+  return schema instanceof RecordSchema && schema["executeSerialize"]().jsonValues === true;
+}
+
+/**
+ * Builds the `stegaEncode` `root` seed for a single `.jsonValues()` entry, so its
+ * strings get edit tags. Without a seed, `stegaEncode` on raw entry content is an
+ * identity transform (the content carries no selector path/schema).
+ *
+ * Yields e.g. `/src/routes/support.$slug.val.ts?p="/support/faq"`, so a `title`
+ * field is tagged `…?p="/support/faq"."title"` — the shape the Studio's
+ * `findUnloadedJsonEntryKey` walks, so click-to-edit + lazy load line up.
+ */
+function getJsonEntryStegaRoot(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+selector, key
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+) {
+  var modulePath = selector && Internal.getValPath(selector);
+  if (!modulePath) {
+    return undefined;
+  }
+  var schema = selector && Internal.getSchema(selector);
+  if (!(schema instanceof RecordSchema)) {
+    return undefined;
+  }
+  var path = Internal.createValPathOfItem(modulePath, key);
+  if (!path) {
+    return undefined;
+  }
+  return {
+    path: path,
+    schema: schema["executeSerialize"]().item
+  };
+}
+function getValRouteUrlFromVal(resolvedParams, methodName,
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+path,
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+schema,
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+val) {
+  if (!path) {
+    console.error("Val: ".concat(methodName, " can only be used with a Val module (details: no Val path found)."));
+    return null;
+  }
+  if (val === null) {
+    return null;
+  }
+  if (_typeof(val) !== "object") {
+    console.error("Val: ".concat(methodName, " must be used with a Val Module that is a s.record().router(...) (details: expected type object, found ").concat(_typeof(val), " instead)."));
+    return null;
+  }
+  if (Array.isArray(val)) {
+    console.error("Val: ".concat(methodName, " must be used with a Val Module that is a s.record().router(...) (details: expected type object, found array instead)."));
+    return null;
+  }
+  if (!schema) {
+    console.error("Val: ".concat(methodName, " must be used with a Val Module that is a s.record().router(...) (details: no schema found)."));
+    return null;
+  }
+  if (!(schema instanceof RecordSchema)) {
+    console.error("Val: ".concat(methodName, " must be used with a Val Module that is a s.record().router(...) (details: schema is not a record)."));
+  } else if (!schema["currentRouter"]) {
+    console.error("Val: ".concat(methodName, " must be used with a Val Module that is a s.record().router(...) (details: router is not set)."));
+  } else if (schema["currentRouter"].getRouterId() !== Internal.tanstackRouter.getRouterId() && schema["currentRouter"].getRouterId() !== Internal.externalPageRouter.getRouterId()) {
+    console.error("Val: ".concat(methodName, " must be used with a Val Module that is a s.record().router(...) (details: router is not the TanStack Router or External URL Page Router)."));
+    return null;
+  }
+  if (_typeof(resolvedParams) !== "object") {
+    console.error("Val: ".concat(methodName, " must be used with a Val Module that is a s.record().router(...) (details: params is not an object)."));
+    return null;
+  }
+  var _Internal$splitModule = Internal.splitModuleFilePathAndModulePath(path),
+    _Internal$splitModule2 = _slicedToArray(_Internal$splitModule, 1),
+    moduleFilePath = _Internal$splitModule2[0];
+  /*
+   * A route module is named after the route file it sits beside.
+   *
+   * There is no `page.val.ts` here, because TanStack Router has no `page.tsx`:
+   * the route file IS the name of the route, so `routes/posts.$postId.tsx` is
+   * served by `routes/posts.$postId.val.ts` and the file name is the whole of
+   * what says which route this is. Being under `routes/` is therefore the only
+   * thing to check.
+   */
+  var srcFolder = getTanStackRouterSourceFolder(moduleFilePath);
+  if (!srcFolder) {
+    console.error("Val: ".concat(methodName, " was used with a Val module that is not in the /routes or /src/routes folder. Name the module after the route file it belongs to, e.g. /src/routes/posts.$postId.val.ts next to /src/routes/posts.$postId.tsx."));
+    return null;
+  }
+  var pattern = getPatternFromModuleFilePath(moduleFilePath, srcFolder);
+  var parsedPattern = parseRoutePattern(pattern);
+  var missingPatterns = [];
+  var fullPathParts = [];
+  var missingParamKeys = _typeof(resolvedParams) === "object" && resolvedParams !== null && !Array.isArray(resolvedParams) ? _objectSpread2({}, resolvedParams) : {};
+  /*
+   * TanStack names a splat twice, and only one of the names is Val's.
+   *
+   * `useParams()` on a `$` route returns BOTH `_splat` and `*`, set to the same
+   * value — see `interpolatePath` in `@tanstack/router-core`. Val's pattern has
+   * one param for it, so the other name was left over at the end of the loop
+   * below and reported as a parameter that is not in the path: a console error
+   * on every render of a working splat route. Dropping it here rather than
+   * special-casing the report keeps "what was left over" meaning what it says.
+   */
+  if ("*" in missingParamKeys && "_splat" in missingParamKeys) {
+    delete missingParamKeys["*"];
+  }
+  var _iterator = _createForOfIteratorHelper(parsedPattern !== null && parsedPattern !== void 0 ? parsedPattern : []),
+    _step;
+  try {
+    for (_iterator.s(); !(_step = _iterator.n()).done;) {
+      var part = _step.value;
+      if (part.type === "literal") {
+        fullPathParts.push(part.name);
+      } else if (part.type === "array-param" || part.type === "string-param") {
+        var key = part.paramName;
+        var value = resolvedParams === null || resolvedParams === void 0 ? void 0 : resolvedParams[key];
+        if (typeof value !== "string" && !Array.isArray(value)) {
+          missingPatterns.push(part);
+        } else if (Array.isArray(value)) {
+          if (missingParamKeys !== null && missingParamKeys !== void 0 && missingParamKeys[key]) {
+            delete missingParamKeys[key];
+          }
+          fullPathParts.push(value.join("/"));
+        } else {
+          if (missingParamKeys !== null && missingParamKeys !== void 0 && missingParamKeys[key]) {
+            delete missingParamKeys[key];
+          }
+          fullPathParts.push(value);
+        }
+      }
+    }
+  } catch (err) {
+    _iterator.e(err);
+  } finally {
+    _iterator.f();
+  }
+  var lastPattern = missingPatterns === null || missingPatterns === void 0 ? void 0 : missingPatterns[missingPatterns.length - 1];
+  var isLastOptional = lastPattern && lastPattern.type === "array-param" && lastPattern.optional;
+  if (isLastOptional) {
+    // We **think** that if the last pattern is optional we might still want to match
+    // An example: /some-path/[[...test]]
+    // Or even: /[[...path]]
+    // We believe there's no other legal ways to have optional patterns? Right?
+    missingPatterns.pop();
+  }
+  if (missingPatterns.length > 0) {
+    var errorMessageParams = missingPatterns.map(function (part) {
+      if (part.type === "literal") {
+        return part.name;
+      } else if (part.type === "string-param") {
+        if (part.optional) {
+          return "[[".concat(part.paramName, "]]");
+        }
+        return "[".concat(part.paramName, "]");
+      } else if (part.type === "array-param") {
+        if (part.optional) {
+          return "[[...".concat(part.paramName, "]]");
+        }
+        return "[...".concat(part.paramName, "]");
+      }
+    });
+    console.error("Val: ".concat(methodName, " could not find route since parameters: ").concat(errorMessageParams.join(", "), " where not provided. Make sure the Val module is named after the route file it belongs to, e.g. /src/routes/posts.$postId.val.ts next to /src/routes/posts.$postId.tsx."));
+    return null;
+  }
+  if (Object.keys(missingParamKeys).length > 0) {
+    console.error("Val: ".concat(methodName, " could not find route since parameters: ").concat(Object.keys(missingParamKeys).join(", "), " where not found in the path of: ").concat(moduleFilePath, ". Make sure ").concat(moduleFilePath, " is named after the route file it belongs to."));
+    // We do not return null here since we found a route that matches the path
+    // though chances are that there's something wrong in the way ${methodName} is used
+  }
+  var fullPath = fullPathParts.join("/");
+  return "/".concat(fullPath);
+}
+function initValRouteFromVal(resolvedParams, methodName,
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+path,
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+schema,
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+val) {
+  var url = getValRouteUrlFromVal(resolvedParams, methodName, path, schema, val);
+  if (!url) {
+    return null;
+  }
+  var actualRoute = val[url];
+  if (!actualRoute) {
+    return null;
+  }
+  return actualRoute;
+}
+
+export { _typeof as _, getValRouteUrlFromVal as a, initValRouteFromVal as b, getJsonEntryStegaRoot as g, isJsonValuesRecordSchema as i };

package/dist/routeFromVal-a9147ceb.cjs.dev.js

@@ -0,0 +1,218 @@
+'use strict';
+
+var createForOfIteratorHelper = require('./createForOfIteratorHelper-e75681d7.cjs.dev.js');
+var core = require('@valbuild/core');
+var client = require('@valbuild/shared/client');
+
+function _typeof(o) {
+  "@babel/helpers - typeof";
+
+  return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) {
+    return typeof o;
+  } : function (o) {
+    return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o;
+  }, _typeof(o);
+}
+
+/**
+ * True when the module's schema is a `.jsonValues()` record/router — i.e. each
+ * entry value is a lazily-loaded `c.json(() => import(...))` marker. Used by the
+ * route helpers to load ONLY the matched entry instead of the whole record.
+ */
+function isJsonValuesRecordSchema(schema) {
+  return schema instanceof core.RecordSchema && schema["executeSerialize"]().jsonValues === true;
+}
+
+/**
+ * Builds the `stegaEncode` `root` seed for a single `.jsonValues()` entry, so its
+ * strings get edit tags. Without a seed, `stegaEncode` on raw entry content is an
+ * identity transform (the content carries no selector path/schema).
+ *
+ * Yields e.g. `/src/routes/support.$slug.val.ts?p="/support/faq"`, so a `title`
+ * field is tagged `…?p="/support/faq"."title"` — the shape the Studio's
+ * `findUnloadedJsonEntryKey` walks, so click-to-edit + lazy load line up.
+ */
+function getJsonEntryStegaRoot(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+selector, key
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+) {
+  var modulePath = selector && core.Internal.getValPath(selector);
+  if (!modulePath) {
+    return undefined;
+  }
+  var schema = selector && core.Internal.getSchema(selector);
+  if (!(schema instanceof core.RecordSchema)) {
+    return undefined;
+  }
+  var path = core.Internal.createValPathOfItem(modulePath, key);
+  if (!path) {
+    return undefined;
+  }
+  return {
+    path: path,
+    schema: schema["executeSerialize"]().item
+  };
+}
+function getValRouteUrlFromVal(resolvedParams, methodName,
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+path,
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+schema,
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+val) {
+  if (!path) {
+    console.error("Val: ".concat(methodName, " can only be used with a Val module (details: no Val path found)."));
+    return null;
+  }
+  if (val === null) {
+    return null;
+  }
+  if (_typeof(val) !== "object") {
+    console.error("Val: ".concat(methodName, " must be used with a Val Module that is a s.record().router(...) (details: expected type object, found ").concat(_typeof(val), " instead)."));
+    return null;
+  }
+  if (Array.isArray(val)) {
+    console.error("Val: ".concat(methodName, " must be used with a Val Module that is a s.record().router(...) (details: expected type object, found array instead)."));
+    return null;
+  }
+  if (!schema) {
+    console.error("Val: ".concat(methodName, " must be used with a Val Module that is a s.record().router(...) (details: no schema found)."));
+    return null;
+  }
+  if (!(schema instanceof core.RecordSchema)) {
+    console.error("Val: ".concat(methodName, " must be used with a Val Module that is a s.record().router(...) (details: schema is not a record)."));
+  } else if (!schema["currentRouter"]) {
+    console.error("Val: ".concat(methodName, " must be used with a Val Module that is a s.record().router(...) (details: router is not set)."));
+  } else if (schema["currentRouter"].getRouterId() !== core.Internal.tanstackRouter.getRouterId() && schema["currentRouter"].getRouterId() !== core.Internal.externalPageRouter.getRouterId()) {
+    console.error("Val: ".concat(methodName, " must be used with a Val Module that is a s.record().router(...) (details: router is not the TanStack Router or External URL Page Router)."));
+    return null;
+  }
+  if (_typeof(resolvedParams) !== "object") {
+    console.error("Val: ".concat(methodName, " must be used with a Val Module that is a s.record().router(...) (details: params is not an object)."));
+    return null;
+  }
+  var _Internal$splitModule = core.Internal.splitModuleFilePathAndModulePath(path),
+    _Internal$splitModule2 = createForOfIteratorHelper._slicedToArray(_Internal$splitModule, 1),
+    moduleFilePath = _Internal$splitModule2[0];
+  /*
+   * A route module is named after the route file it sits beside.
+   *
+   * There is no `page.val.ts` here, because TanStack Router has no `page.tsx`:
+   * the route file IS the name of the route, so `routes/posts.$postId.tsx` is
+   * served by `routes/posts.$postId.val.ts` and the file name is the whole of
+   * what says which route this is. Being under `routes/` is therefore the only
+   * thing to check.
+   */
+  var srcFolder = client.getTanStackRouterSourceFolder(moduleFilePath);
+  if (!srcFolder) {
+    console.error("Val: ".concat(methodName, " was used with a Val module that is not in the /routes or /src/routes folder. Name the module after the route file it belongs to, e.g. /src/routes/posts.$postId.val.ts next to /src/routes/posts.$postId.tsx."));
+    return null;
+  }
+  var pattern = client.getPatternFromModuleFilePath(moduleFilePath, srcFolder);
+  var parsedPattern = client.parseRoutePattern(pattern);
+  var missingPatterns = [];
+  var fullPathParts = [];
+  var missingParamKeys = _typeof(resolvedParams) === "object" && resolvedParams !== null && !Array.isArray(resolvedParams) ? createForOfIteratorHelper._objectSpread2({}, resolvedParams) : {};
+  /*
+   * TanStack names a splat twice, and only one of the names is Val's.
+   *
+   * `useParams()` on a `$` route returns BOTH `_splat` and `*`, set to the same
+   * value — see `interpolatePath` in `@tanstack/router-core`. Val's pattern has
+   * one param for it, so the other name was left over at the end of the loop
+   * below and reported as a parameter that is not in the path: a console error
+   * on every render of a working splat route. Dropping it here rather than
+   * special-casing the report keeps "what was left over" meaning what it says.
+   */
+  if ("*" in missingParamKeys && "_splat" in missingParamKeys) {
+    delete missingParamKeys["*"];
+  }
+  var _iterator = createForOfIteratorHelper._createForOfIteratorHelper(parsedPattern !== null && parsedPattern !== void 0 ? parsedPattern : []),
+    _step;
+  try {
+    for (_iterator.s(); !(_step = _iterator.n()).done;) {
+      var part = _step.value;
+      if (part.type === "literal") {
+        fullPathParts.push(part.name);
+      } else if (part.type === "array-param" || part.type === "string-param") {
+        var key = part.paramName;
+        var value = resolvedParams === null || resolvedParams === void 0 ? void 0 : resolvedParams[key];
+        if (typeof value !== "string" && !Array.isArray(value)) {
+          missingPatterns.push(part);
+        } else if (Array.isArray(value)) {
+          if (missingParamKeys !== null && missingParamKeys !== void 0 && missingParamKeys[key]) {
+            delete missingParamKeys[key];
+          }
+          fullPathParts.push(value.join("/"));
+        } else {
+          if (missingParamKeys !== null && missingParamKeys !== void 0 && missingParamKeys[key]) {
+            delete missingParamKeys[key];
+          }
+          fullPathParts.push(value);
+        }
+      }
+    }
+  } catch (err) {
+    _iterator.e(err);
+  } finally {
+    _iterator.f();
+  }
+  var lastPattern = missingPatterns === null || missingPatterns === void 0 ? void 0 : missingPatterns[missingPatterns.length - 1];
+  var isLastOptional = lastPattern && lastPattern.type === "array-param" && lastPattern.optional;
+  if (isLastOptional) {
+    // We **think** that if the last pattern is optional we might still want to match
+    // An example: /some-path/[[...test]]
+    // Or even: /[[...path]]
+    // We believe there's no other legal ways to have optional patterns? Right?
+    missingPatterns.pop();
+  }
+  if (missingPatterns.length > 0) {
+    var errorMessageParams = missingPatterns.map(function (part) {
+      if (part.type === "literal") {
+        return part.name;
+      } else if (part.type === "string-param") {
+        if (part.optional) {
+          return "[[".concat(part.paramName, "]]");
+        }
+        return "[".concat(part.paramName, "]");
+      } else if (part.type === "array-param") {
+        if (part.optional) {
+          return "[[...".concat(part.paramName, "]]");
+        }
+        return "[...".concat(part.paramName, "]");
+      }
+    });
+    console.error("Val: ".concat(methodName, " could not find route since parameters: ").concat(errorMessageParams.join(", "), " where not provided. Make sure the Val module is named after the route file it belongs to, e.g. /src/routes/posts.$postId.val.ts next to /src/routes/posts.$postId.tsx."));
+    return null;
+  }
+  if (Object.keys(missingParamKeys).length > 0) {
+    console.error("Val: ".concat(methodName, " could not find route since parameters: ").concat(Object.keys(missingParamKeys).join(", "), " where not found in the path of: ").concat(moduleFilePath, ". Make sure ").concat(moduleFilePath, " is named after the route file it belongs to."));
+    // We do not return null here since we found a route that matches the path
+    // though chances are that there's something wrong in the way ${methodName} is used
+  }
+  var fullPath = fullPathParts.join("/");
+  return "/".concat(fullPath);
+}
+function initValRouteFromVal(resolvedParams, methodName,
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+path,
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+schema,
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+val) {
+  var url = getValRouteUrlFromVal(resolvedParams, methodName, path, schema, val);
+  if (!url) {
+    return null;
+  }
+  var actualRoute = val[url];
+  if (!actualRoute) {
+    return null;
+  }
+  return actualRoute;
+}
+
+exports._typeof = _typeof;
+exports.getJsonEntryStegaRoot = getJsonEntryStegaRoot;
+exports.getValRouteUrlFromVal = getValRouteUrlFromVal;
+exports.initValRouteFromVal = initValRouteFromVal;
+exports.isJsonValuesRecordSchema = isJsonValuesRecordSchema;

package/dist/valbuild-tanstack.cjs.d.ts

@@ -0,0 +1,2 @@
+export * from "./declarations/src/index.js";
+//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidmFsYnVpbGQtdGFuc3RhY2suY2pzLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuL2RlY2xhcmF0aW9ucy9zcmMvaW5kZXguZC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSJ9