@tanstack/virtual-file-routes 1.54.0 → 1.64.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021-present Tanner Linsley
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/cjs/api.cjs

@@ -29,12 +29,19 @@ function layout(idOrFile, fileOrChildren, children) {
     };
   }
 }
-function route(path, file, children) {
+function route(path, fileOrChildren, children) {
+  if (typeof fileOrChildren === "string") {
+    return {
+      type: "route",
+      file: fileOrChildren,
+      path,
+      children
+    };
+  }
   return {
     type: "route",
-    file,
     path,
-    children
+    children: fileOrChildren
   };
 }
 function physical(pathPrefix, directory) {

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(\n  path: string,\n  file: string,\n  children?: Array<VirtualRouteNode>,\n): Route {\n  return {\n    type: 'route',\n    file,\n    path,\n    children,\n  }\n}\n\nexport function physical(\n  pathPrefix: string,\n  directory: string,\n): PhysicalSubtree {\n  return {\n    type: 'physical',\n    directory,\n    pathPrefix,\n  }\n}\n"],"names":[],"mappings":";;AASgB,SAAA,UACd,MACA,UACkB;AACX,SAAA;AAAA,IACL,MAAM;AAAA,IACN;AAAA,IACA;AAAA,EAAA;AAEJ;AAEO,SAAS,MAAM,MAA0B;AACvC,SAAA;AAAA,IACL,MAAM;AAAA,IACN;AAAA,EAAA;AAEJ;AAYgB,SAAA,OACd,UACA,gBACA,UACa;AACT,MAAA,MAAM,QAAQ,cAAc,GAAG;AAC1B,WAAA;AAAA,MACL,MAAM;AAAA,MACN,MAAM;AAAA,MACN,UAAU;AAAA,IAAA;AAAA,EACZ,OACK;AACE,WAAA;AAAA,MACL,MAAM;AAAA,MACN,IAAI;AAAA,MACJ,MAAM;AAAA,MACN;AAAA,IAAA;AAAA,EAEJ;AACF;AAEgB,SAAA,MACd,MACA,MACA,UACO;AACA,SAAA;AAAA,IACL,MAAM;AAAA,IACN;AAAA,IACA;AAAA,IACA;AAAA,EAAA;AAEJ;AAEgB,SAAA,SACd,YACA,WACiB;AACV,SAAA;AAAA,IACL,MAAM;AAAA,IACN;AAAA,IACA;AAAA,EAAA;AAEJ;;;;;;"}
+{"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\nexport function physical(\n  pathPrefix: string,\n  directory: string,\n): PhysicalSubtree {\n  return {\n    type: 'physical',\n    directory,\n    pathPrefix,\n  }\n}\n"],"names":[],"mappings":";;AASgB,SAAA,UACd,MACA,UACkB;AACX,SAAA;AAAA,IACL,MAAM;AAAA,IACN;AAAA,IACA;AAAA,EAAA;AAEJ;AAEO,SAAS,MAAM,MAA0B;AACvC,SAAA;AAAA,IACL,MAAM;AAAA,IACN;AAAA,EAAA;AAEJ;AAYgB,SAAA,OACd,UACA,gBACA,UACa;AACT,MAAA,MAAM,QAAQ,cAAc,GAAG;AAC1B,WAAA;AAAA,MACL,MAAM;AAAA,MACN,MAAM;AAAA,MACN,UAAU;AAAA,IAAA;AAAA,EACZ,OACK;AACE,WAAA;AAAA,MACL,MAAM;AAAA,MACN,IAAI;AAAA,MACJ,MAAM;AAAA,MACN;AAAA,IAAA;AAAA,EAEJ;AACF;AASgB,SAAA,MACd,MACA,gBACA,UACO;AACH,MAAA,OAAO,mBAAmB,UAAU;AAC/B,WAAA;AAAA,MACL,MAAM;AAAA,MACN,MAAM;AAAA,MACN;AAAA,MACA;AAAA,IAAA;AAAA,EAEJ;AACO,SAAA;AAAA,IACL,MAAM;AAAA,IACN;AAAA,IACA,UAAU;AAAA,EAAA;AAEd;AAEgB,SAAA,SACd,YACA,WACiB;AACV,SAAA;AAAA,IACL,MAAM;AAAA,IACN;AAAA,IACA;AAAA,EAAA;AAEJ;;;;;;"}

package/dist/cjs/api.d.cts

@@ -3,5 +3,7 @@ export declare function rootRoute(file: string, children?: Array<VirtualRouteNod
 export declare function index(file: string): IndexRoute;
 export declare function layout(file: string, children: Array<VirtualRouteNode>): LayoutRoute;
 export declare function layout(id: string, file: string, children: Array<VirtualRouteNode>): LayoutRoute;
-export declare function route(path: string, file: string, children?: Array<VirtualRouteNode>): Route;
+export declare function route(path: string, children: Array<VirtualRouteNode>): Route;
+export declare function route(path: string, file: string): Route;
+export declare function route(path: string, file: string, children: Array<VirtualRouteNode>): Route;
 export declare function physical(pathPrefix: string, directory: string): PhysicalSubtree;

package/dist/cjs/defineConfig.cjs

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

package/dist/cjs/defineConfig.cjs.map

@@ -0,0 +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;AAClC,SAAA;AACT;;"}

package/dist/cjs/defineConfig.d.cts

@@ -0,0 +1,14 @@
+import { VirtualRouteNode } from './types.cjs';
+export type ConfigFnObject<TConfig> = () => TConfig;
+export type ConfigFnPromise<TConfig> = () => Promise<TConfig>;
+export type ConfigFn<TConfig> = () => TConfig | Promise<TConfig>;
+export type ConfigExport<TConfig> = TConfig | Promise<TConfig> | ConfigFnObject<TConfig> | ConfigFnPromise<TConfig> | ConfigFn<TConfig>;
+export type VirtualRouteSubtreeConfig = Array<VirtualRouteNode>;
+/**
+ * Type helper to make it easier to use __virtual.ts
+ * accepts a direct {@link VirtualRouteSubtreeConfig} object, or a function that returns it.
+ */
+export declare function defineVirtualSubtreeConfig(config: VirtualRouteSubtreeConfig): VirtualRouteSubtreeConfig;
+export declare function defineVirtualSubtreeConfig(config: Promise<VirtualRouteSubtreeConfig>): Promise<VirtualRouteSubtreeConfig>;
+export declare function defineVirtualSubtreeConfig(config: ConfigFnObject<VirtualRouteSubtreeConfig>): ConfigFnObject<VirtualRouteSubtreeConfig>;
+export declare function defineVirtualSubtreeConfig(config: ConfigExport<VirtualRouteSubtreeConfig>): ConfigExport<VirtualRouteSubtreeConfig>;

package/dist/cjs/index.cjs

@@ -1,9 +1,11 @@
 "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

package/dist/cjs/index.cjs.map

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

package/dist/cjs/index.d.cts

@@ -1,2 +1,4 @@
 export { rootRoute, index, route, layout, physical } from './api.cjs';
 export type { LayoutRoute, Route, IndexRoute, PhysicalSubtree, VirtualRootRoute, VirtualRouteNode, } from './types.cjs';
+export { defineVirtualSubtreeConfig } from './defineConfig.cjs';
+export type { ConfigExport, ConfigFn, ConfigFnObject, ConfigFnPromise, VirtualRouteSubtreeConfig, } from './defineConfig.cjs';

package/dist/cjs/types.d.cts

@@ -15,7 +15,7 @@ export type PhysicalSubtree = {
 };
 export type Route = {
     type: 'route';
-    file: string;
+    file?: string;
     path: string;
     children?: Array<VirtualRouteNode>;
 };

package/dist/esm/api.d.ts

@@ -3,5 +3,7 @@ export declare function rootRoute(file: string, children?: Array<VirtualRouteNod
 export declare function index(file: string): IndexRoute;
 export declare function layout(file: string, children: Array<VirtualRouteNode>): LayoutRoute;
 export declare function layout(id: string, file: string, children: Array<VirtualRouteNode>): LayoutRoute;
-export declare function route(path: string, file: string, children?: Array<VirtualRouteNode>): Route;
+export declare function route(path: string, children: Array<VirtualRouteNode>): Route;
+export declare function route(path: string, file: string): Route;
+export declare function route(path: string, file: string, children: Array<VirtualRouteNode>): Route;
 export declare function physical(pathPrefix: string, directory: string): PhysicalSubtree;

package/dist/esm/api.js

@@ -27,12 +27,19 @@ function layout(idOrFile, fileOrChildren, children) {
     };
   }
 }
-function route(path, file, children) {
+function route(path, fileOrChildren, children) {
+  if (typeof fileOrChildren === "string") {
+    return {
+      type: "route",
+      file: fileOrChildren,
+      path,
+      children
+    };
+  }
   return {
     type: "route",
-    file,
     path,
-    children
+    children: fileOrChildren
   };
 }
 function physical(pathPrefix, directory) {

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(\n  path: string,\n  file: string,\n  children?: Array<VirtualRouteNode>,\n): Route {\n  return {\n    type: 'route',\n    file,\n    path,\n    children,\n  }\n}\n\nexport function physical(\n  pathPrefix: string,\n  directory: string,\n): PhysicalSubtree {\n  return {\n    type: 'physical',\n    directory,\n    pathPrefix,\n  }\n}\n"],"names":[],"mappings":"AASgB,SAAA,UACd,MACA,UACkB;AACX,SAAA;AAAA,IACL,MAAM;AAAA,IACN;AAAA,IACA;AAAA,EAAA;AAEJ;AAEO,SAAS,MAAM,MAA0B;AACvC,SAAA;AAAA,IACL,MAAM;AAAA,IACN;AAAA,EAAA;AAEJ;AAYgB,SAAA,OACd,UACA,gBACA,UACa;AACT,MAAA,MAAM,QAAQ,cAAc,GAAG;AAC1B,WAAA;AAAA,MACL,MAAM;AAAA,MACN,MAAM;AAAA,MACN,UAAU;AAAA,IAAA;AAAA,EACZ,OACK;AACE,WAAA;AAAA,MACL,MAAM;AAAA,MACN,IAAI;AAAA,MACJ,MAAM;AAAA,MACN;AAAA,IAAA;AAAA,EAEJ;AACF;AAEgB,SAAA,MACd,MACA,MACA,UACO;AACA,SAAA;AAAA,IACL,MAAM;AAAA,IACN;AAAA,IACA;AAAA,IACA;AAAA,EAAA;AAEJ;AAEgB,SAAA,SACd,YACA,WACiB;AACV,SAAA;AAAA,IACL,MAAM;AAAA,IACN;AAAA,IACA;AAAA,EAAA;AAEJ;"}
+{"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\nexport function physical(\n  pathPrefix: string,\n  directory: string,\n): PhysicalSubtree {\n  return {\n    type: 'physical',\n    directory,\n    pathPrefix,\n  }\n}\n"],"names":[],"mappings":"AASgB,SAAA,UACd,MACA,UACkB;AACX,SAAA;AAAA,IACL,MAAM;AAAA,IACN;AAAA,IACA;AAAA,EAAA;AAEJ;AAEO,SAAS,MAAM,MAA0B;AACvC,SAAA;AAAA,IACL,MAAM;AAAA,IACN;AAAA,EAAA;AAEJ;AAYgB,SAAA,OACd,UACA,gBACA,UACa;AACT,MAAA,MAAM,QAAQ,cAAc,GAAG;AAC1B,WAAA;AAAA,MACL,MAAM;AAAA,MACN,MAAM;AAAA,MACN,UAAU;AAAA,IAAA;AAAA,EACZ,OACK;AACE,WAAA;AAAA,MACL,MAAM;AAAA,MACN,IAAI;AAAA,MACJ,MAAM;AAAA,MACN;AAAA,IAAA;AAAA,EAEJ;AACF;AASgB,SAAA,MACd,MACA,gBACA,UACO;AACH,MAAA,OAAO,mBAAmB,UAAU;AAC/B,WAAA;AAAA,MACL,MAAM;AAAA,MACN,MAAM;AAAA,MACN;AAAA,MACA;AAAA,IAAA;AAAA,EAEJ;AACO,SAAA;AAAA,IACL,MAAM;AAAA,IACN;AAAA,IACA,UAAU;AAAA,EAAA;AAEd;AAEgB,SAAA,SACd,YACA,WACiB;AACV,SAAA;AAAA,IACL,MAAM;AAAA,IACN;AAAA,IACA;AAAA,EAAA;AAEJ;"}

package/dist/esm/defineConfig.d.ts

@@ -0,0 +1,14 @@
+import { VirtualRouteNode } from './types.js';
+export type ConfigFnObject<TConfig> = () => TConfig;
+export type ConfigFnPromise<TConfig> = () => Promise<TConfig>;
+export type ConfigFn<TConfig> = () => TConfig | Promise<TConfig>;
+export type ConfigExport<TConfig> = TConfig | Promise<TConfig> | ConfigFnObject<TConfig> | ConfigFnPromise<TConfig> | ConfigFn<TConfig>;
+export type VirtualRouteSubtreeConfig = Array<VirtualRouteNode>;
+/**
+ * Type helper to make it easier to use __virtual.ts
+ * accepts a direct {@link VirtualRouteSubtreeConfig} object, or a function that returns it.
+ */
+export declare function defineVirtualSubtreeConfig(config: VirtualRouteSubtreeConfig): VirtualRouteSubtreeConfig;
+export declare function defineVirtualSubtreeConfig(config: Promise<VirtualRouteSubtreeConfig>): Promise<VirtualRouteSubtreeConfig>;
+export declare function defineVirtualSubtreeConfig(config: ConfigFnObject<VirtualRouteSubtreeConfig>): ConfigFnObject<VirtualRouteSubtreeConfig>;
+export declare function defineVirtualSubtreeConfig(config: ConfigExport<VirtualRouteSubtreeConfig>): ConfigExport<VirtualRouteSubtreeConfig>;

package/dist/esm/defineConfig.js

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

package/dist/esm/defineConfig.js.map

@@ -0,0 +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;AAClC,SAAA;AACT;"}

package/dist/esm/index.d.ts

@@ -1,2 +1,4 @@
 export { rootRoute, index, route, layout, physical } from './api.js';
 export type { LayoutRoute, Route, IndexRoute, PhysicalSubtree, VirtualRootRoute, VirtualRouteNode, } from './types.js';
+export { defineVirtualSubtreeConfig } from './defineConfig.js';
+export type { ConfigExport, ConfigFn, ConfigFnObject, ConfigFnPromise, VirtualRouteSubtreeConfig, } from './defineConfig.js';

package/dist/esm/index.js

@@ -1,5 +1,7 @@
 import { index, layout, physical, rootRoute, route } from "./api.js";
+import { defineVirtualSubtreeConfig } from "./defineConfig.js";
 export {
+  defineVirtualSubtreeConfig,
   index,
   layout,
   physical,

package/dist/esm/index.js.map

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

package/dist/esm/types.d.ts

@@ -15,7 +15,7 @@ export type PhysicalSubtree = {
 };
 export type Route = {
     type: 'route';
-    file: string;
+    file?: string;
     path: string;
     children?: Array<VirtualRouteNode>;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/virtual-file-routes",
-  "version": "1.54.0",
+  "version": "1.64.0",
   "description": "Modern and scalable routing for React applications",
   "author": "Tanner Linsley",
   "license": "MIT",
@@ -23,12 +23,6 @@
     "async router",
     "typescript"
   ],
-  "scripts": {
-    "clean": "rimraf ./dist && rimraf ./coverage",
-    "test:eslint": "eslint ./src",
-    "test:build": "publint --strict && attw --ignore-rules no-resolution --pack .",
-    "build": "vite build"
-  },
   "type": "module",
   "types": "dist/esm/index.d.ts",
   "main": "dist/cjs/index.cjs",
@@ -53,5 +47,6 @@
   ],
   "engines": {
     "node": ">=12"
-  }
-}
+  },
+  "scripts": {}
+}

package/src/api.ts

@@ -56,16 +56,30 @@ export function layout(
   }
 }
 
+export function route(path: string, children: Array<VirtualRouteNode>): Route
+export function route(path: string, file: string): Route
 export function route(
   path: string,
   file: string,
+  children: Array<VirtualRouteNode>,
+): Route
+export function route(
+  path: string,
+  fileOrChildren: string | Array<VirtualRouteNode>,
   children?: Array<VirtualRouteNode>,
 ): Route {
+  if (typeof fileOrChildren === 'string') {
+    return {
+      type: 'route',
+      file: fileOrChildren,
+      path,
+      children,
+    }
+  }
   return {
     type: 'route',
-    file,
     path,
-    children,
+    children: fileOrChildren,
   }
 }
 

package/src/defineConfig.ts

@@ -0,0 +1,38 @@
+import type { VirtualRouteNode } from './types'
+
+// this is adapted from vite/src/node/config.ts
+
+export type ConfigFnObject<TConfig> = () => TConfig
+export type ConfigFnPromise<TConfig> = () => Promise<TConfig>
+export type ConfigFn<TConfig> = () => TConfig | Promise<TConfig>
+
+export type ConfigExport<TConfig> =
+  | TConfig
+  | Promise<TConfig>
+  | ConfigFnObject<TConfig>
+  | ConfigFnPromise<TConfig>
+  | ConfigFn<TConfig>
+
+export type VirtualRouteSubtreeConfig = Array<VirtualRouteNode>
+
+/**
+ * Type helper to make it easier to use __virtual.ts
+ * accepts a direct {@link VirtualRouteSubtreeConfig} object, or a function that returns it.
+ */
+export function defineVirtualSubtreeConfig(
+  config: VirtualRouteSubtreeConfig,
+): VirtualRouteSubtreeConfig
+export function defineVirtualSubtreeConfig(
+  config: Promise<VirtualRouteSubtreeConfig>,
+): Promise<VirtualRouteSubtreeConfig>
+export function defineVirtualSubtreeConfig(
+  config: ConfigFnObject<VirtualRouteSubtreeConfig>,
+): ConfigFnObject<VirtualRouteSubtreeConfig>
+export function defineVirtualSubtreeConfig(
+  config: ConfigExport<VirtualRouteSubtreeConfig>,
+): ConfigExport<VirtualRouteSubtreeConfig>
+export function defineVirtualSubtreeConfig(
+  config: ConfigExport<VirtualRouteSubtreeConfig>,
+): ConfigExport<VirtualRouteSubtreeConfig> {
+  return config
+}

package/src/index.ts

@@ -7,3 +7,12 @@ export type {
   VirtualRootRoute,
   VirtualRouteNode,
 } from './types'
+
+export { defineVirtualSubtreeConfig } from './defineConfig'
+export type {
+  ConfigExport,
+  ConfigFn,
+  ConfigFnObject,
+  ConfigFnPromise,
+  VirtualRouteSubtreeConfig,
+} from './defineConfig'

package/src/types.ts

@@ -18,7 +18,7 @@ export type PhysicalSubtree = {
 
 export type Route = {
   type: 'route'
-  file: string
+  file?: string
   path: string
   children?: Array<VirtualRouteNode>
 }