@tanstack/virtual-file-routes 1.161.5 → 1.161.7

package/bin/intent.js

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+// Auto-generated by @tanstack/intent setup
+// Exposes the intent end-user CLI for consumers of this library.
+// Commit this file, then add to your package.json:
+//   "bin": { "intent": "./bin/intent.js" }
+try {
+  await import('@tanstack/intent/intent-library')
+} catch (e) {
+  const isModuleNotFound =
+    e?.code === 'ERR_MODULE_NOT_FOUND' || e?.code === 'MODULE_NOT_FOUND'
+  const missingIntentLibrary =
+    typeof e?.message === 'string' && e.message.includes('@tanstack/intent')
+
+  if (isModuleNotFound && missingIntentLibrary) {
+    console.error('@tanstack/intent is not installed.')
+    console.error('')
+    console.error('Install it as a dev dependency:')
+    console.error('  npm add -D @tanstack/intent')
+    console.error('')
+    console.error('Or run directly:')
+    console.error('  npx @tanstack/intent@latest list')
+    process.exit(1)
+  }
+  throw e
+}

package/dist/cjs/api.cjs

@@ -1,66 +1,60 @@
-"use strict";
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/api.ts
 function rootRoute(file, children) {
-  return {
-    type: "root",
-    file,
-    children
-  };
+	return {
+		type: "root",
+		file,
+		children
+	};
 }
 function index(file) {
-  return {
-    type: "index",
-    file
-  };
+	return {
+		type: "index",
+		file
+	};
 }
 function layout(idOrFile, fileOrChildren, children) {
-  if (Array.isArray(fileOrChildren)) {
-    return {
-      type: "layout",
-      file: idOrFile,
-      children: fileOrChildren
-    };
-  } else {
-    return {
-      type: "layout",
-      id: idOrFile,
-      file: fileOrChildren,
-      children
-    };
-  }
+	if (Array.isArray(fileOrChildren)) return {
+		type: "layout",
+		file: idOrFile,
+		children: fileOrChildren
+	};
+	else return {
+		type: "layout",
+		id: idOrFile,
+		file: fileOrChildren,
+		children
+	};
 }
 function route(path, fileOrChildren, children) {
-  if (typeof fileOrChildren === "string") {
-    return {
-      type: "route",
-      file: fileOrChildren,
-      path,
-      children
-    };
-  }
-  return {
-    type: "route",
-    path,
-    children: fileOrChildren
-  };
+	if (typeof fileOrChildren === "string") return {
+		type: "route",
+		file: fileOrChildren,
+		path,
+		children
+	};
+	return {
+		type: "route",
+		path,
+		children: fileOrChildren
+	};
 }
 function physical(pathPrefixOrDirectory, directory) {
-  if (directory === void 0) {
-    return {
-      type: "physical",
-      directory: pathPrefixOrDirectory,
-      pathPrefix: ""
-    };
-  }
-  return {
-    type: "physical",
-    directory,
-    pathPrefix: pathPrefixOrDirectory
-  };
+	if (directory === void 0) return {
+		type: "physical",
+		directory: pathPrefixOrDirectory,
+		pathPrefix: ""
+	};
+	return {
+		type: "physical",
+		directory,
+		pathPrefix: pathPrefixOrDirectory
+	};
 }
+//#endregion
 exports.index = index;
 exports.layout = layout;
 exports.physical = physical;
 exports.rootRoute = rootRoute;
 exports.route = route;
-//# sourceMappingURL=api.cjs.map
+
+//# sourceMappingURL=api.cjs.map

package/dist/cjs/api.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"api.cjs","sources":["../../src/api.ts"],"sourcesContent":["import type {\n  IndexRoute,\n  LayoutRoute,\n  PhysicalSubtree,\n  Route,\n  VirtualRootRoute,\n  VirtualRouteNode,\n} from './types'\n\nexport function rootRoute(\n  file: string,\n  children?: Array<VirtualRouteNode>,\n): VirtualRootRoute {\n  return {\n    type: 'root',\n    file,\n    children,\n  }\n}\n\nexport function index(file: string): IndexRoute {\n  return {\n    type: 'index',\n    file,\n  }\n}\n\nexport function layout(\n  file: string,\n  children: Array<VirtualRouteNode>,\n): LayoutRoute\nexport function layout(\n  id: string,\n  file: string,\n  children: Array<VirtualRouteNode>,\n): LayoutRoute\n\nexport function layout(\n  idOrFile: string,\n  fileOrChildren: string | Array<VirtualRouteNode>,\n  children?: Array<VirtualRouteNode>,\n): LayoutRoute {\n  if (Array.isArray(fileOrChildren)) {\n    return {\n      type: 'layout',\n      file: idOrFile,\n      children: fileOrChildren,\n    }\n  } else {\n    return {\n      type: 'layout',\n      id: idOrFile,\n      file: fileOrChildren,\n      children,\n    }\n  }\n}\n\nexport function route(path: string, children: Array<VirtualRouteNode>): Route\nexport function route(path: string, file: string): Route\nexport function route(\n  path: string,\n  file: string,\n  children: Array<VirtualRouteNode>,\n): Route\nexport function route(\n  path: string,\n  fileOrChildren: string | Array<VirtualRouteNode>,\n  children?: Array<VirtualRouteNode>,\n): Route {\n  if (typeof fileOrChildren === 'string') {\n    return {\n      type: 'route',\n      file: fileOrChildren,\n      path,\n      children,\n    }\n  }\n  return {\n    type: 'route',\n    path,\n    children: fileOrChildren,\n  }\n}\n\n/**\n * Mount a physical directory of route files at a given path prefix.\n *\n * @param pathPrefix - The path prefix to mount the directory at. Use empty string '' to merge routes at the current level.\n * @param directory - The directory containing the route files, relative to the routes directory.\n */\nexport function physical(pathPrefix: string, directory: string): PhysicalSubtree\n/**\n * Mount a physical directory of route files at the current level (empty path prefix).\n * This is equivalent to `physical('', directory)`.\n *\n * @param directory - The directory containing the route files, relative to the routes directory.\n */\nexport function physical(directory: string): PhysicalSubtree\nexport function physical(\n  pathPrefixOrDirectory: string,\n  directory?: string,\n): PhysicalSubtree {\n  if (directory === undefined) {\n    // Single argument: directory only, use empty path prefix\n    return {\n      type: 'physical',\n      directory: pathPrefixOrDirectory,\n      pathPrefix: '',\n    }\n  }\n  // Two arguments: pathPrefix and directory\n  return {\n    type: 'physical',\n    directory,\n    pathPrefix: pathPrefixOrDirectory,\n  }\n}\n"],"names":[],"mappings":";;AASO,SAAS,UACd,MACA,UACkB;AAClB,SAAO;AAAA,IACL,MAAM;AAAA,IACN;AAAA,IACA;AAAA,EAAA;AAEJ;AAEO,SAAS,MAAM,MAA0B;AAC9C,SAAO;AAAA,IACL,MAAM;AAAA,IACN;AAAA,EAAA;AAEJ;AAYO,SAAS,OACd,UACA,gBACA,UACa;AACb,MAAI,MAAM,QAAQ,cAAc,GAAG;AACjC,WAAO;AAAA,MACL,MAAM;AAAA,MACN,MAAM;AAAA,MACN,UAAU;AAAA,IAAA;AAAA,EAEd,OAAO;AACL,WAAO;AAAA,MACL,MAAM;AAAA,MACN,IAAI;AAAA,MACJ,MAAM;AAAA,MACN;AAAA,IAAA;AAAA,EAEJ;AACF;AASO,SAAS,MACd,MACA,gBACA,UACO;AACP,MAAI,OAAO,mBAAmB,UAAU;AACtC,WAAO;AAAA,MACL,MAAM;AAAA,MACN,MAAM;AAAA,MACN;AAAA,MACA;AAAA,IAAA;AAAA,EAEJ;AACA,SAAO;AAAA,IACL,MAAM;AAAA,IACN;AAAA,IACA,UAAU;AAAA,EAAA;AAEd;AAgBO,SAAS,SACd,uBACA,WACiB;AACjB,MAAI,cAAc,QAAW;AAE3B,WAAO;AAAA,MACL,MAAM;AAAA,MACN,WAAW;AAAA,MACX,YAAY;AAAA,IAAA;AAAA,EAEhB;AAEA,SAAO;AAAA,IACL,MAAM;AAAA,IACN;AAAA,IACA,YAAY;AAAA,EAAA;AAEhB;;;;;;"}
+{"version":3,"file":"api.cjs","names":[],"sources":["../../src/api.ts"],"sourcesContent":["import type {\n  IndexRoute,\n  LayoutRoute,\n  PhysicalSubtree,\n  Route,\n  VirtualRootRoute,\n  VirtualRouteNode,\n} from './types'\n\nexport function rootRoute(\n  file: string,\n  children?: Array<VirtualRouteNode>,\n): VirtualRootRoute {\n  return {\n    type: 'root',\n    file,\n    children,\n  }\n}\n\nexport function index(file: string): IndexRoute {\n  return {\n    type: 'index',\n    file,\n  }\n}\n\nexport function layout(\n  file: string,\n  children: Array<VirtualRouteNode>,\n): LayoutRoute\nexport function layout(\n  id: string,\n  file: string,\n  children: Array<VirtualRouteNode>,\n): LayoutRoute\n\nexport function layout(\n  idOrFile: string,\n  fileOrChildren: string | Array<VirtualRouteNode>,\n  children?: Array<VirtualRouteNode>,\n): LayoutRoute {\n  if (Array.isArray(fileOrChildren)) {\n    return {\n      type: 'layout',\n      file: idOrFile,\n      children: fileOrChildren,\n    }\n  } else {\n    return {\n      type: 'layout',\n      id: idOrFile,\n      file: fileOrChildren,\n      children,\n    }\n  }\n}\n\nexport function route(path: string, children: Array<VirtualRouteNode>): Route\nexport function route(path: string, file: string): Route\nexport function route(\n  path: string,\n  file: string,\n  children: Array<VirtualRouteNode>,\n): Route\nexport function route(\n  path: string,\n  fileOrChildren: string | Array<VirtualRouteNode>,\n  children?: Array<VirtualRouteNode>,\n): Route {\n  if (typeof fileOrChildren === 'string') {\n    return {\n      type: 'route',\n      file: fileOrChildren,\n      path,\n      children,\n    }\n  }\n  return {\n    type: 'route',\n    path,\n    children: fileOrChildren,\n  }\n}\n\n/**\n * Mount a physical directory of route files at a given path prefix.\n *\n * @param pathPrefix - The path prefix to mount the directory at. Use empty string '' to merge routes at the current level.\n * @param directory - The directory containing the route files, relative to the routes directory.\n */\nexport function physical(pathPrefix: string, directory: string): PhysicalSubtree\n/**\n * Mount a physical directory of route files at the current level (empty path prefix).\n * This is equivalent to `physical('', directory)`.\n *\n * @param directory - The directory containing the route files, relative to the routes directory.\n */\nexport function physical(directory: string): PhysicalSubtree\nexport function physical(\n  pathPrefixOrDirectory: string,\n  directory?: string,\n): PhysicalSubtree {\n  if (directory === undefined) {\n    // Single argument: directory only, use empty path prefix\n    return {\n      type: 'physical',\n      directory: pathPrefixOrDirectory,\n      pathPrefix: '',\n    }\n  }\n  // Two arguments: pathPrefix and directory\n  return {\n    type: 'physical',\n    directory,\n    pathPrefix: pathPrefixOrDirectory,\n  }\n}\n"],"mappings":";AASA,SAAgB,UACd,MACA,UACkB;AAClB,QAAO;EACL,MAAM;EACN;EACA;EACD;;AAGH,SAAgB,MAAM,MAA0B;AAC9C,QAAO;EACL,MAAM;EACN;EACD;;AAaH,SAAgB,OACd,UACA,gBACA,UACa;AACb,KAAI,MAAM,QAAQ,eAAe,CAC/B,QAAO;EACL,MAAM;EACN,MAAM;EACN,UAAU;EACX;KAED,QAAO;EACL,MAAM;EACN,IAAI;EACJ,MAAM;EACN;EACD;;AAWL,SAAgB,MACd,MACA,gBACA,UACO;AACP,KAAI,OAAO,mBAAmB,SAC5B,QAAO;EACL,MAAM;EACN,MAAM;EACN;EACA;EACD;AAEH,QAAO;EACL,MAAM;EACN;EACA,UAAU;EACX;;AAiBH,SAAgB,SACd,uBACA,WACiB;AACjB,KAAI,cAAc,KAAA,EAEhB,QAAO;EACL,MAAM;EACN,WAAW;EACX,YAAY;EACb;AAGH,QAAO;EACL,MAAM;EACN;EACA,YAAY;EACb"}

package/dist/cjs/defineConfig.cjs

@@ -1,7 +1,8 @@
-"use strict";
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/defineConfig.ts
 function defineVirtualSubtreeConfig(config) {
-  return config;
+	return config;
 }
+//#endregion
 exports.defineVirtualSubtreeConfig = defineVirtualSubtreeConfig;
-//# sourceMappingURL=defineConfig.cjs.map
+
+//# sourceMappingURL=defineConfig.cjs.map

package/dist/cjs/defineConfig.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"defineConfig.cjs","sources":["../../src/defineConfig.ts"],"sourcesContent":["import type { VirtualRouteNode } from './types'\n\n// this is adapted from vite/src/node/config.ts\n\nexport type ConfigFnObject<TConfig> = () => TConfig\nexport type ConfigFnPromise<TConfig> = () => Promise<TConfig>\nexport type ConfigFn<TConfig> = () => TConfig | Promise<TConfig>\n\nexport type ConfigExport<TConfig> =\n  | TConfig\n  | Promise<TConfig>\n  | ConfigFnObject<TConfig>\n  | ConfigFnPromise<TConfig>\n  | ConfigFn<TConfig>\n\nexport type VirtualRouteSubtreeConfig = Array<VirtualRouteNode>\n\n/**\n * Type helper to make it easier to use __virtual.ts\n * accepts a direct {@link VirtualRouteSubtreeConfig} object, or a function that returns it.\n */\nexport function defineVirtualSubtreeConfig(\n  config: VirtualRouteSubtreeConfig,\n): VirtualRouteSubtreeConfig\nexport function defineVirtualSubtreeConfig(\n  config: Promise<VirtualRouteSubtreeConfig>,\n): Promise<VirtualRouteSubtreeConfig>\nexport function defineVirtualSubtreeConfig(\n  config: ConfigFnObject<VirtualRouteSubtreeConfig>,\n): ConfigFnObject<VirtualRouteSubtreeConfig>\nexport function defineVirtualSubtreeConfig(\n  config: ConfigExport<VirtualRouteSubtreeConfig>,\n): ConfigExport<VirtualRouteSubtreeConfig>\nexport function defineVirtualSubtreeConfig(\n  config: ConfigExport<VirtualRouteSubtreeConfig>,\n): ConfigExport<VirtualRouteSubtreeConfig> {\n  return config\n}\n"],"names":[],"mappings":";;AAiCO,SAAS,2BACd,QACyC;AACzC,SAAO;AACT;;"}
+{"version":3,"file":"defineConfig.cjs","names":[],"sources":["../../src/defineConfig.ts"],"sourcesContent":["import type { VirtualRouteNode } from './types'\n\n// this is adapted from vite/src/node/config.ts\n\nexport type ConfigFnObject<TConfig> = () => TConfig\nexport type ConfigFnPromise<TConfig> = () => Promise<TConfig>\nexport type ConfigFn<TConfig> = () => TConfig | Promise<TConfig>\n\nexport type ConfigExport<TConfig> =\n  | TConfig\n  | Promise<TConfig>\n  | ConfigFnObject<TConfig>\n  | ConfigFnPromise<TConfig>\n  | ConfigFn<TConfig>\n\nexport type VirtualRouteSubtreeConfig = Array<VirtualRouteNode>\n\n/**\n * Type helper to make it easier to use __virtual.ts\n * accepts a direct {@link VirtualRouteSubtreeConfig} object, or a function that returns it.\n */\nexport function defineVirtualSubtreeConfig(\n  config: VirtualRouteSubtreeConfig,\n): VirtualRouteSubtreeConfig\nexport function defineVirtualSubtreeConfig(\n  config: Promise<VirtualRouteSubtreeConfig>,\n): Promise<VirtualRouteSubtreeConfig>\nexport function defineVirtualSubtreeConfig(\n  config: ConfigFnObject<VirtualRouteSubtreeConfig>,\n): ConfigFnObject<VirtualRouteSubtreeConfig>\nexport function defineVirtualSubtreeConfig(\n  config: ConfigExport<VirtualRouteSubtreeConfig>,\n): ConfigExport<VirtualRouteSubtreeConfig>\nexport function defineVirtualSubtreeConfig(\n  config: ConfigExport<VirtualRouteSubtreeConfig>,\n): ConfigExport<VirtualRouteSubtreeConfig> {\n  return config\n}\n"],"mappings":";AAiCA,SAAgB,2BACd,QACyC;AACzC,QAAO"}

package/dist/cjs/index.cjs

@@ -1,11 +1,9 @@
-"use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const api = require("./api.cjs");
-const defineConfig = require("./defineConfig.cjs");
-exports.index = api.index;
-exports.layout = api.layout;
-exports.physical = api.physical;
-exports.rootRoute = api.rootRoute;
-exports.route = api.route;
-exports.defineVirtualSubtreeConfig = defineConfig.defineVirtualSubtreeConfig;
-//# sourceMappingURL=index.cjs.map
+const require_api = require("./api.cjs");
+const require_defineConfig = require("./defineConfig.cjs");
+exports.defineVirtualSubtreeConfig = require_defineConfig.defineVirtualSubtreeConfig;
+exports.index = require_api.index;
+exports.layout = require_api.layout;
+exports.physical = require_api.physical;
+exports.rootRoute = require_api.rootRoute;
+exports.route = require_api.route;

package/dist/esm/api.js

@@ -1,66 +1,56 @@
+//#region src/api.ts
 function rootRoute(file, children) {
-  return {
-    type: "root",
-    file,
-    children
-  };
+	return {
+		type: "root",
+		file,
+		children
+	};
 }
 function index(file) {
-  return {
-    type: "index",
-    file
-  };
+	return {
+		type: "index",
+		file
+	};
 }
 function layout(idOrFile, fileOrChildren, children) {
-  if (Array.isArray(fileOrChildren)) {
-    return {
-      type: "layout",
-      file: idOrFile,
-      children: fileOrChildren
-    };
-  } else {
-    return {
-      type: "layout",
-      id: idOrFile,
-      file: fileOrChildren,
-      children
-    };
-  }
+	if (Array.isArray(fileOrChildren)) return {
+		type: "layout",
+		file: idOrFile,
+		children: fileOrChildren
+	};
+	else return {
+		type: "layout",
+		id: idOrFile,
+		file: fileOrChildren,
+		children
+	};
 }
 function route(path, fileOrChildren, children) {
-  if (typeof fileOrChildren === "string") {
-    return {
-      type: "route",
-      file: fileOrChildren,
-      path,
-      children
-    };
-  }
-  return {
-    type: "route",
-    path,
-    children: fileOrChildren
-  };
+	if (typeof fileOrChildren === "string") return {
+		type: "route",
+		file: fileOrChildren,
+		path,
+		children
+	};
+	return {
+		type: "route",
+		path,
+		children: fileOrChildren
+	};
 }
 function physical(pathPrefixOrDirectory, directory) {
-  if (directory === void 0) {
-    return {
-      type: "physical",
-      directory: pathPrefixOrDirectory,
-      pathPrefix: ""
-    };
-  }
-  return {
-    type: "physical",
-    directory,
-    pathPrefix: pathPrefixOrDirectory
-  };
+	if (directory === void 0) return {
+		type: "physical",
+		directory: pathPrefixOrDirectory,
+		pathPrefix: ""
+	};
+	return {
+		type: "physical",
+		directory,
+		pathPrefix: pathPrefixOrDirectory
+	};
 }
-export {
-  index,
-  layout,
-  physical,
-  rootRoute,
-  route
-};
-//# sourceMappingURL=api.js.map
+//#endregion
+export { index, layout, physical, rootRoute, route };
+
+//# sourceMappingURL=api.js.map

package/dist/esm/api.js.map

@@ -1 +1 @@
-{"version":3,"file":"api.js","sources":["../../src/api.ts"],"sourcesContent":["import type {\n  IndexRoute,\n  LayoutRoute,\n  PhysicalSubtree,\n  Route,\n  VirtualRootRoute,\n  VirtualRouteNode,\n} from './types'\n\nexport function rootRoute(\n  file: string,\n  children?: Array<VirtualRouteNode>,\n): VirtualRootRoute {\n  return {\n    type: 'root',\n    file,\n    children,\n  }\n}\n\nexport function index(file: string): IndexRoute {\n  return {\n    type: 'index',\n    file,\n  }\n}\n\nexport function layout(\n  file: string,\n  children: Array<VirtualRouteNode>,\n): LayoutRoute\nexport function layout(\n  id: string,\n  file: string,\n  children: Array<VirtualRouteNode>,\n): LayoutRoute\n\nexport function layout(\n  idOrFile: string,\n  fileOrChildren: string | Array<VirtualRouteNode>,\n  children?: Array<VirtualRouteNode>,\n): LayoutRoute {\n  if (Array.isArray(fileOrChildren)) {\n    return {\n      type: 'layout',\n      file: idOrFile,\n      children: fileOrChildren,\n    }\n  } else {\n    return {\n      type: 'layout',\n      id: idOrFile,\n      file: fileOrChildren,\n      children,\n    }\n  }\n}\n\nexport function route(path: string, children: Array<VirtualRouteNode>): Route\nexport function route(path: string, file: string): Route\nexport function route(\n  path: string,\n  file: string,\n  children: Array<VirtualRouteNode>,\n): Route\nexport function route(\n  path: string,\n  fileOrChildren: string | Array<VirtualRouteNode>,\n  children?: Array<VirtualRouteNode>,\n): Route {\n  if (typeof fileOrChildren === 'string') {\n    return {\n      type: 'route',\n      file: fileOrChildren,\n      path,\n      children,\n    }\n  }\n  return {\n    type: 'route',\n    path,\n    children: fileOrChildren,\n  }\n}\n\n/**\n * Mount a physical directory of route files at a given path prefix.\n *\n * @param pathPrefix - The path prefix to mount the directory at. Use empty string '' to merge routes at the current level.\n * @param directory - The directory containing the route files, relative to the routes directory.\n */\nexport function physical(pathPrefix: string, directory: string): PhysicalSubtree\n/**\n * Mount a physical directory of route files at the current level (empty path prefix).\n * This is equivalent to `physical('', directory)`.\n *\n * @param directory - The directory containing the route files, relative to the routes directory.\n */\nexport function physical(directory: string): PhysicalSubtree\nexport function physical(\n  pathPrefixOrDirectory: string,\n  directory?: string,\n): PhysicalSubtree {\n  if (directory === undefined) {\n    // Single argument: directory only, use empty path prefix\n    return {\n      type: 'physical',\n      directory: pathPrefixOrDirectory,\n      pathPrefix: '',\n    }\n  }\n  // Two arguments: pathPrefix and directory\n  return {\n    type: 'physical',\n    directory,\n    pathPrefix: pathPrefixOrDirectory,\n  }\n}\n"],"names":[],"mappings":"AASO,SAAS,UACd,MACA,UACkB;AAClB,SAAO;AAAA,IACL,MAAM;AAAA,IACN;AAAA,IACA;AAAA,EAAA;AAEJ;AAEO,SAAS,MAAM,MAA0B;AAC9C,SAAO;AAAA,IACL,MAAM;AAAA,IACN;AAAA,EAAA;AAEJ;AAYO,SAAS,OACd,UACA,gBACA,UACa;AACb,MAAI,MAAM,QAAQ,cAAc,GAAG;AACjC,WAAO;AAAA,MACL,MAAM;AAAA,MACN,MAAM;AAAA,MACN,UAAU;AAAA,IAAA;AAAA,EAEd,OAAO;AACL,WAAO;AAAA,MACL,MAAM;AAAA,MACN,IAAI;AAAA,MACJ,MAAM;AAAA,MACN;AAAA,IAAA;AAAA,EAEJ;AACF;AASO,SAAS,MACd,MACA,gBACA,UACO;AACP,MAAI,OAAO,mBAAmB,UAAU;AACtC,WAAO;AAAA,MACL,MAAM;AAAA,MACN,MAAM;AAAA,MACN;AAAA,MACA;AAAA,IAAA;AAAA,EAEJ;AACA,SAAO;AAAA,IACL,MAAM;AAAA,IACN;AAAA,IACA,UAAU;AAAA,EAAA;AAEd;AAgBO,SAAS,SACd,uBACA,WACiB;AACjB,MAAI,cAAc,QAAW;AAE3B,WAAO;AAAA,MACL,MAAM;AAAA,MACN,WAAW;AAAA,MACX,YAAY;AAAA,IAAA;AAAA,EAEhB;AAEA,SAAO;AAAA,IACL,MAAM;AAAA,IACN;AAAA,IACA,YAAY;AAAA,EAAA;AAEhB;"}
+{"version":3,"file":"api.js","names":[],"sources":["../../src/api.ts"],"sourcesContent":["import type {\n  IndexRoute,\n  LayoutRoute,\n  PhysicalSubtree,\n  Route,\n  VirtualRootRoute,\n  VirtualRouteNode,\n} from './types'\n\nexport function rootRoute(\n  file: string,\n  children?: Array<VirtualRouteNode>,\n): VirtualRootRoute {\n  return {\n    type: 'root',\n    file,\n    children,\n  }\n}\n\nexport function index(file: string): IndexRoute {\n  return {\n    type: 'index',\n    file,\n  }\n}\n\nexport function layout(\n  file: string,\n  children: Array<VirtualRouteNode>,\n): LayoutRoute\nexport function layout(\n  id: string,\n  file: string,\n  children: Array<VirtualRouteNode>,\n): LayoutRoute\n\nexport function layout(\n  idOrFile: string,\n  fileOrChildren: string | Array<VirtualRouteNode>,\n  children?: Array<VirtualRouteNode>,\n): LayoutRoute {\n  if (Array.isArray(fileOrChildren)) {\n    return {\n      type: 'layout',\n      file: idOrFile,\n      children: fileOrChildren,\n    }\n  } else {\n    return {\n      type: 'layout',\n      id: idOrFile,\n      file: fileOrChildren,\n      children,\n    }\n  }\n}\n\nexport function route(path: string, children: Array<VirtualRouteNode>): Route\nexport function route(path: string, file: string): Route\nexport function route(\n  path: string,\n  file: string,\n  children: Array<VirtualRouteNode>,\n): Route\nexport function route(\n  path: string,\n  fileOrChildren: string | Array<VirtualRouteNode>,\n  children?: Array<VirtualRouteNode>,\n): Route {\n  if (typeof fileOrChildren === 'string') {\n    return {\n      type: 'route',\n      file: fileOrChildren,\n      path,\n      children,\n    }\n  }\n  return {\n    type: 'route',\n    path,\n    children: fileOrChildren,\n  }\n}\n\n/**\n * Mount a physical directory of route files at a given path prefix.\n *\n * @param pathPrefix - The path prefix to mount the directory at. Use empty string '' to merge routes at the current level.\n * @param directory - The directory containing the route files, relative to the routes directory.\n */\nexport function physical(pathPrefix: string, directory: string): PhysicalSubtree\n/**\n * Mount a physical directory of route files at the current level (empty path prefix).\n * This is equivalent to `physical('', directory)`.\n *\n * @param directory - The directory containing the route files, relative to the routes directory.\n */\nexport function physical(directory: string): PhysicalSubtree\nexport function physical(\n  pathPrefixOrDirectory: string,\n  directory?: string,\n): PhysicalSubtree {\n  if (directory === undefined) {\n    // Single argument: directory only, use empty path prefix\n    return {\n      type: 'physical',\n      directory: pathPrefixOrDirectory,\n      pathPrefix: '',\n    }\n  }\n  // Two arguments: pathPrefix and directory\n  return {\n    type: 'physical',\n    directory,\n    pathPrefix: pathPrefixOrDirectory,\n  }\n}\n"],"mappings":";AASA,SAAgB,UACd,MACA,UACkB;AAClB,QAAO;EACL,MAAM;EACN;EACA;EACD;;AAGH,SAAgB,MAAM,MAA0B;AAC9C,QAAO;EACL,MAAM;EACN;EACD;;AAaH,SAAgB,OACd,UACA,gBACA,UACa;AACb,KAAI,MAAM,QAAQ,eAAe,CAC/B,QAAO;EACL,MAAM;EACN,MAAM;EACN,UAAU;EACX;KAED,QAAO;EACL,MAAM;EACN,IAAI;EACJ,MAAM;EACN;EACD;;AAWL,SAAgB,MACd,MACA,gBACA,UACO;AACP,KAAI,OAAO,mBAAmB,SAC5B,QAAO;EACL,MAAM;EACN,MAAM;EACN;EACA;EACD;AAEH,QAAO;EACL,MAAM;EACN;EACA,UAAU;EACX;;AAiBH,SAAgB,SACd,uBACA,WACiB;AACjB,KAAI,cAAc,KAAA,EAEhB,QAAO;EACL,MAAM;EACN,WAAW;EACX,YAAY;EACb;AAGH,QAAO;EACL,MAAM;EACN;EACA,YAAY;EACb"}

package/dist/esm/defineConfig.js

@@ -1,7 +1,8 @@
+//#region src/defineConfig.ts
 function defineVirtualSubtreeConfig(config) {
-  return config;
+	return config;
 }
-export {
-  defineVirtualSubtreeConfig
-};
-//# sourceMappingURL=defineConfig.js.map
+//#endregion
+export { defineVirtualSubtreeConfig };
+
+//# sourceMappingURL=defineConfig.js.map

package/dist/esm/defineConfig.js.map

@@ -1 +1 @@
-{"version":3,"file":"defineConfig.js","sources":["../../src/defineConfig.ts"],"sourcesContent":["import type { VirtualRouteNode } from './types'\n\n// this is adapted from vite/src/node/config.ts\n\nexport type ConfigFnObject<TConfig> = () => TConfig\nexport type ConfigFnPromise<TConfig> = () => Promise<TConfig>\nexport type ConfigFn<TConfig> = () => TConfig | Promise<TConfig>\n\nexport type ConfigExport<TConfig> =\n  | TConfig\n  | Promise<TConfig>\n  | ConfigFnObject<TConfig>\n  | ConfigFnPromise<TConfig>\n  | ConfigFn<TConfig>\n\nexport type VirtualRouteSubtreeConfig = Array<VirtualRouteNode>\n\n/**\n * Type helper to make it easier to use __virtual.ts\n * accepts a direct {@link VirtualRouteSubtreeConfig} object, or a function that returns it.\n */\nexport function defineVirtualSubtreeConfig(\n  config: VirtualRouteSubtreeConfig,\n): VirtualRouteSubtreeConfig\nexport function defineVirtualSubtreeConfig(\n  config: Promise<VirtualRouteSubtreeConfig>,\n): Promise<VirtualRouteSubtreeConfig>\nexport function defineVirtualSubtreeConfig(\n  config: ConfigFnObject<VirtualRouteSubtreeConfig>,\n): ConfigFnObject<VirtualRouteSubtreeConfig>\nexport function defineVirtualSubtreeConfig(\n  config: ConfigExport<VirtualRouteSubtreeConfig>,\n): ConfigExport<VirtualRouteSubtreeConfig>\nexport function defineVirtualSubtreeConfig(\n  config: ConfigExport<VirtualRouteSubtreeConfig>,\n): ConfigExport<VirtualRouteSubtreeConfig> {\n  return config\n}\n"],"names":[],"mappings":"AAiCO,SAAS,2BACd,QACyC;AACzC,SAAO;AACT;"}
+{"version":3,"file":"defineConfig.js","names":[],"sources":["../../src/defineConfig.ts"],"sourcesContent":["import type { VirtualRouteNode } from './types'\n\n// this is adapted from vite/src/node/config.ts\n\nexport type ConfigFnObject<TConfig> = () => TConfig\nexport type ConfigFnPromise<TConfig> = () => Promise<TConfig>\nexport type ConfigFn<TConfig> = () => TConfig | Promise<TConfig>\n\nexport type ConfigExport<TConfig> =\n  | TConfig\n  | Promise<TConfig>\n  | ConfigFnObject<TConfig>\n  | ConfigFnPromise<TConfig>\n  | ConfigFn<TConfig>\n\nexport type VirtualRouteSubtreeConfig = Array<VirtualRouteNode>\n\n/**\n * Type helper to make it easier to use __virtual.ts\n * accepts a direct {@link VirtualRouteSubtreeConfig} object, or a function that returns it.\n */\nexport function defineVirtualSubtreeConfig(\n  config: VirtualRouteSubtreeConfig,\n): VirtualRouteSubtreeConfig\nexport function defineVirtualSubtreeConfig(\n  config: Promise<VirtualRouteSubtreeConfig>,\n): Promise<VirtualRouteSubtreeConfig>\nexport function defineVirtualSubtreeConfig(\n  config: ConfigFnObject<VirtualRouteSubtreeConfig>,\n): ConfigFnObject<VirtualRouteSubtreeConfig>\nexport function defineVirtualSubtreeConfig(\n  config: ConfigExport<VirtualRouteSubtreeConfig>,\n): ConfigExport<VirtualRouteSubtreeConfig>\nexport function defineVirtualSubtreeConfig(\n  config: ConfigExport<VirtualRouteSubtreeConfig>,\n): ConfigExport<VirtualRouteSubtreeConfig> {\n  return config\n}\n"],"mappings":";AAiCA,SAAgB,2BACd,QACyC;AACzC,QAAO"}

package/dist/esm/index.js

@@ -1,11 +1,3 @@
 import { index, layout, physical, rootRoute, route } from "./api.js";
 import { defineVirtualSubtreeConfig } from "./defineConfig.js";
-export {
-  defineVirtualSubtreeConfig,
-  index,
-  layout,
-  physical,
-  rootRoute,
-  route
-};
-//# sourceMappingURL=index.js.map
+export { defineVirtualSubtreeConfig, index, layout, physical, rootRoute, route };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/virtual-file-routes",
-  "version": "1.161.5",
+  "version": "1.161.7",
   "description": "Modern and scalable routing for React applications",
   "author": "Tanner Linsley",
   "license": "MIT",
@@ -43,14 +43,21 @@
   "sideEffects": false,
   "files": [
     "dist",
-    "src"
+    "src",
+    "skills",
+    "bin",
+    "!skills/_artifacts"
   ],
   "engines": {
     "node": ">=20.19"
   },
   "devDependencies": {
+    "@tanstack/intent": "^0.0.14",
     "vite": "*"
   },
+  "bin": {
+    "intent": "./bin/intent.js"
+  },
   "scripts": {
     "clean": "rimraf ./dist && rimraf ./coverage",
     "test:eslint": "eslint ./src",

package/skills/virtual-file-routes/SKILL.md

@@ -0,0 +1,218 @@
+---
+name: virtual-file-routes
+description: >-
+  Programmatic route tree building as an alternative to filesystem
+  conventions: rootRoute, index, route, layout, physical,
+  defineVirtualSubtreeConfig. Use with TanStack Router plugin's
+  virtualRouteConfig option.
+type: core
+library: tanstack-router
+library_version: '1.161.4'
+sources:
+  - TanStack/router:packages/virtual-file-routes/src
+  - TanStack/router:docs/router/routing/virtual-file-routes.md
+---
+
+# Virtual File Routes (`@tanstack/virtual-file-routes`)
+
+Build route trees programmatically instead of relying on filesystem conventions. Useful when you want explicit control over route structure, need to mix virtual and physical routes, or want to define route subtrees within file-based routing directories.
+
+> **CRITICAL**: Types are FULLY INFERRED. Never cast, never annotate inferred values.
+
+## Install
+
+```bash
+npm install @tanstack/virtual-file-routes
+```
+
+## API Reference
+
+### `rootRoute(file, children?)`
+
+Creates the root of a virtual route tree.
+
+```ts
+import { rootRoute, index, route } from '@tanstack/virtual-file-routes'
+
+const routes = rootRoute('root.tsx', [
+  index('index.tsx'),
+  route('/about', 'about.tsx'),
+])
+```
+
+### `index(file)`
+
+Creates an index route — the default rendered when the parent path matches exactly.
+
+```ts
+import { index } from '@tanstack/virtual-file-routes'
+
+index('home.tsx')
+```
+
+### `route(path, ...)`
+
+Creates a route node. Three call signatures:
+
+```ts
+import { route, index } from '@tanstack/virtual-file-routes'
+
+// Leaf route: path + file
+route('/about', 'about.tsx')
+
+// Branch route: path + file + children
+route('/dashboard', 'dashboard.tsx', [
+  index('dashboard-index.tsx'),
+  route('/settings', 'settings.tsx'),
+])
+
+// Path prefix only (no file): groups children under a URL segment
+route('/api', [route('/users', 'users.tsx'), route('/posts', 'posts.tsx')])
+```
+
+### `layout(file, children)` or `layout(id, file, children)`
+
+Creates a pathless layout route — wraps children without adding a URL segment.
+
+```ts
+import { layout, route, index } from '@tanstack/virtual-file-routes'
+
+// ID derived from filename
+layout('authLayout.tsx', [
+  route('/dashboard', 'dashboard.tsx'),
+  route('/settings', 'settings.tsx'),
+])
+
+// Explicit ID
+layout('admin-layout', 'adminLayout.tsx', [route('/admin', 'admin.tsx')])
+```
+
+### `physical(pathPrefix, directory)` or `physical(directory)`
+
+Mounts a directory of file-based routes at a URL prefix. Uses TanStack Router's standard file-based routing conventions within that directory.
+
+```ts
+import { physical } from '@tanstack/virtual-file-routes'
+
+// Mount posts/ directory under /posts
+physical('/posts', 'posts')
+
+// Merge features/ directory at the current level
+physical('features')
+```
+
+### `defineVirtualSubtreeConfig(config)`
+
+Type helper for `__virtual.ts` files inside file-based routing directories. Identity function that provides type inference.
+
+```ts
+// src/routes/admin/__virtual.ts
+import {
+  defineVirtualSubtreeConfig,
+  index,
+  route,
+} from '@tanstack/virtual-file-routes'
+
+export default defineVirtualSubtreeConfig([
+  index('home.tsx'),
+  route('$id', 'details.tsx'),
+])
+```
+
+## Integration with Router Plugin
+
+Pass the virtual route config to the TanStack Router plugin:
+
+```ts
+// vite.config.ts
+import { defineConfig } from 'vite'
+import { tanstackRouter } from '@tanstack/router-plugin/vite'
+import { routes } from './routes'
+
+export default defineConfig({
+  plugins: [
+    tanstackRouter({
+      target: 'react', // or 'solid', 'vue'
+      virtualRouteConfig: routes,
+    }),
+    // Add your framework's Vite plugin here
+  ],
+})
+```
+
+Or reference a file path:
+
+```ts
+tanstackRouter({
+  target: 'react',
+  virtualRouteConfig: './routes.ts',
+})
+```
+
+## Full Example
+
+```ts
+// routes.ts
+import {
+  rootRoute,
+  route,
+  index,
+  layout,
+  physical,
+} from '@tanstack/virtual-file-routes'
+
+export const routes = rootRoute('root.tsx', [
+  index('index.tsx'),
+
+  layout('authLayout.tsx', [
+    route('/dashboard', 'app/dashboard.tsx', [
+      index('app/dashboard-index.tsx'),
+      route('/invoices', 'app/dashboard-invoices.tsx', [
+        index('app/invoices-index.tsx'),
+        route('$id', 'app/invoice-detail.tsx'),
+      ]),
+    ]),
+  ]),
+
+  // Mount file-based routing from posts/ directory
+  physical('/posts', 'posts'),
+])
+```
+
+## Common Mistakes
+
+### 1. HIGH: Forgetting that file paths are relative to routesDirectory
+
+File paths in `rootRoute`, `index`, `route`, and `layout` are relative to the `routesDirectory` configured in the router plugin (default: `./src/routes`). Do not use absolute paths or paths relative to the project root.
+
+```ts
+// WRONG — absolute path
+route('/about', '/src/routes/about.tsx')
+
+// CORRECT — relative to routesDirectory
+route('/about', 'about.tsx')
+```
+
+### 2. MEDIUM: Using physical() without matching directory structure
+
+The directory passed to `physical()` must exist inside `routesDirectory` and follow TanStack Router's file-based routing conventions.
+
+```ts
+// WRONG — directory doesn't exist or wrong location
+physical('/blog', 'src/blog')
+
+// CORRECT — relative to routesDirectory
+physical('/blog', 'blog')
+// Expects: src/routes/blog/ (with route files inside)
+```
+
+### 3. MEDIUM: Confusing layout() with route()
+
+`layout()` creates a pathless wrapper — it does NOT add a URL segment. Use `route()` for URL segments.
+
+```ts
+// This does NOT create a /dashboard URL
+layout('dashboardLayout.tsx', [route('/dashboard', 'dashboard.tsx')])
+
+// The URL is /dashboard, and dashboardLayout.tsx wraps it
+```

package/dist/cjs/index.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;"}

package/dist/esm/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}