@benjavicente/router-generator 1.166.24

package/dist/esm/config.d.ts

@@ -0,0 +1,254 @@
+import { z } from 'zod';
+import { GeneratorPlugin } from './plugin/types.js';
+declare const tokenJsonRegexSchema: z.ZodObject<{
+    regex: z.ZodString;
+    flags: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    regex: string;
+    flags?: string | undefined;
+}, {
+    regex: string;
+    flags?: string | undefined;
+}>;
+declare const tokenMatcherSchema: z.ZodUnion<[z.ZodString, z.ZodType<RegExp, z.ZodTypeDef, RegExp>, z.ZodObject<{
+    regex: z.ZodString;
+    flags: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    regex: string;
+    flags?: string | undefined;
+}, {
+    regex: string;
+    flags?: string | undefined;
+}>]>;
+export type TokenMatcherJson = string | z.infer<typeof tokenJsonRegexSchema>;
+export type TokenMatcher = z.infer<typeof tokenMatcherSchema>;
+export declare const baseConfigSchema: z.ZodObject<{
+    target: z.ZodDefault<z.ZodOptional<z.ZodEnum<["react", "solid", "vue", "angular"]>>>;
+    virtualRouteConfig: z.ZodOptional<z.ZodUnion<[z.ZodType<import('@benjavicente/virtual-file-routes').VirtualRootRoute, z.ZodTypeDef, import('@benjavicente/virtual-file-routes').VirtualRootRoute>, z.ZodString]>>;
+    routeFilePrefix: z.ZodOptional<z.ZodString>;
+    routeFileIgnorePrefix: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    routeFileIgnorePattern: z.ZodOptional<z.ZodString>;
+    routesDirectory: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    quoteStyle: z.ZodDefault<z.ZodOptional<z.ZodEnum<["single", "double"]>>>;
+    semicolons: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    disableLogging: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    routeTreeFileHeader: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+    indexToken: z.ZodDefault<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodType<RegExp, z.ZodTypeDef, RegExp>, z.ZodObject<{
+        regex: z.ZodString;
+        flags: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        regex: string;
+        flags?: string | undefined;
+    }, {
+        regex: string;
+        flags?: string | undefined;
+    }>]>>>;
+    routeToken: z.ZodDefault<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodType<RegExp, z.ZodTypeDef, RegExp>, z.ZodObject<{
+        regex: z.ZodString;
+        flags: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        regex: string;
+        flags?: string | undefined;
+    }, {
+        regex: string;
+        flags?: string | undefined;
+    }>]>>>;
+    pathParamsAllowedCharacters: z.ZodOptional<z.ZodArray<z.ZodEnum<[";", ":", "@", "&", "=", "+", "$", ","]>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    target: "angular" | "vue" | "react" | "solid";
+    routeFileIgnorePrefix: string;
+    routesDirectory: string;
+    quoteStyle: "single" | "double";
+    semicolons: boolean;
+    disableLogging: boolean;
+    routeTreeFileHeader: string[];
+    indexToken: string | RegExp | {
+        regex: string;
+        flags?: string | undefined;
+    };
+    routeToken: string | RegExp | {
+        regex: string;
+        flags?: string | undefined;
+    };
+    virtualRouteConfig?: string | import('@benjavicente/virtual-file-routes').VirtualRootRoute | undefined;
+    routeFilePrefix?: string | undefined;
+    routeFileIgnorePattern?: string | undefined;
+    pathParamsAllowedCharacters?: (":" | "$" | ";" | "@" | "&" | "=" | "+" | ",")[] | undefined;
+}, {
+    target?: "angular" | "vue" | "react" | "solid" | undefined;
+    virtualRouteConfig?: string | import('@benjavicente/virtual-file-routes').VirtualRootRoute | undefined;
+    routeFilePrefix?: string | undefined;
+    routeFileIgnorePrefix?: string | undefined;
+    routeFileIgnorePattern?: string | undefined;
+    routesDirectory?: string | undefined;
+    quoteStyle?: "single" | "double" | undefined;
+    semicolons?: boolean | undefined;
+    disableLogging?: boolean | undefined;
+    routeTreeFileHeader?: string[] | undefined;
+    indexToken?: string | RegExp | {
+        regex: string;
+        flags?: string | undefined;
+    } | undefined;
+    routeToken?: string | RegExp | {
+        regex: string;
+        flags?: string | undefined;
+    } | undefined;
+    pathParamsAllowedCharacters?: (":" | "$" | ";" | "@" | "&" | "=" | "+" | ",")[] | undefined;
+}>;
+export type BaseConfig = z.infer<typeof baseConfigSchema>;
+export declare const configSchema: z.ZodObject<{
+    target: z.ZodDefault<z.ZodOptional<z.ZodEnum<["react", "solid", "vue", "angular"]>>>;
+    virtualRouteConfig: z.ZodOptional<z.ZodUnion<[z.ZodType<import('@benjavicente/virtual-file-routes').VirtualRootRoute, z.ZodTypeDef, import('@benjavicente/virtual-file-routes').VirtualRootRoute>, z.ZodString]>>;
+    routeFilePrefix: z.ZodOptional<z.ZodString>;
+    routeFileIgnorePrefix: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    routeFileIgnorePattern: z.ZodOptional<z.ZodString>;
+    routesDirectory: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    quoteStyle: z.ZodDefault<z.ZodOptional<z.ZodEnum<["single", "double"]>>>;
+    semicolons: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    disableLogging: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    routeTreeFileHeader: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+    indexToken: z.ZodDefault<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodType<RegExp, z.ZodTypeDef, RegExp>, z.ZodObject<{
+        regex: z.ZodString;
+        flags: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        regex: string;
+        flags?: string | undefined;
+    }, {
+        regex: string;
+        flags?: string | undefined;
+    }>]>>>;
+    routeToken: z.ZodDefault<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodType<RegExp, z.ZodTypeDef, RegExp>, z.ZodObject<{
+        regex: z.ZodString;
+        flags: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        regex: string;
+        flags?: string | undefined;
+    }, {
+        regex: string;
+        flags?: string | undefined;
+    }>]>>>;
+    pathParamsAllowedCharacters: z.ZodOptional<z.ZodArray<z.ZodEnum<[";", ":", "@", "&", "=", "+", "$", ","]>, "many">>;
+} & {
+    generatedRouteTree: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    disableTypes: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    verboseFileRoutes: z.ZodOptional<z.ZodBoolean>;
+    addExtensions: z.ZodEffects<z.ZodDefault<z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodString]>>>, string | boolean, string | boolean | undefined>;
+    enableRouteTreeFormatting: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    routeTreeFileFooter: z.ZodOptional<z.ZodUnion<[z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>, z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodArray<z.ZodString, "many">>]>>;
+    autoCodeSplitting: z.ZodOptional<z.ZodBoolean>;
+    customScaffolding: z.ZodOptional<z.ZodObject<{
+        routeTemplate: z.ZodOptional<z.ZodString>;
+        lazyRouteTemplate: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        routeTemplate?: string | undefined;
+        lazyRouteTemplate?: string | undefined;
+    }, {
+        routeTemplate?: string | undefined;
+        lazyRouteTemplate?: string | undefined;
+    }>>;
+    experimental: z.ZodOptional<z.ZodObject<{
+        enableCodeSplitting: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        enableCodeSplitting?: boolean | undefined;
+    }, {
+        enableCodeSplitting?: boolean | undefined;
+    }>>;
+    plugins: z.ZodOptional<z.ZodArray<z.ZodType<GeneratorPlugin, z.ZodTypeDef, GeneratorPlugin>, "many">>;
+    /**
+     * When `target` is `angular`, use this package in generated route imports and
+     * `FileRoutesByPath` augmentation (default `@benjavicente/angular-router-experimental`).
+     */
+    angularRouterPackage: z.ZodOptional<z.ZodString>;
+    /**
+     * When `target` is `angular`, use this package in the Start `declare module` block
+     * appended to the route tree (default `@benjavicente/angular-start-experimental`).
+     */
+    angularStartPackage: z.ZodOptional<z.ZodString>;
+    tmpDir: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    importRoutesUsingAbsolutePaths: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    target: "angular" | "vue" | "react" | "solid";
+    routeFileIgnorePrefix: string;
+    routesDirectory: string;
+    quoteStyle: "single" | "double";
+    semicolons: boolean;
+    disableLogging: boolean;
+    routeTreeFileHeader: string[];
+    indexToken: string | RegExp | {
+        regex: string;
+        flags?: string | undefined;
+    };
+    routeToken: string | RegExp | {
+        regex: string;
+        flags?: string | undefined;
+    };
+    generatedRouteTree: string;
+    disableTypes: boolean;
+    addExtensions: string | boolean;
+    enableRouteTreeFormatting: boolean;
+    tmpDir: string;
+    importRoutesUsingAbsolutePaths: boolean;
+    plugins?: GeneratorPlugin[] | undefined;
+    virtualRouteConfig?: string | import('@benjavicente/virtual-file-routes').VirtualRootRoute | undefined;
+    routeFilePrefix?: string | undefined;
+    routeFileIgnorePattern?: string | undefined;
+    pathParamsAllowedCharacters?: (":" | "$" | ";" | "@" | "&" | "=" | "+" | ",")[] | undefined;
+    verboseFileRoutes?: boolean | undefined;
+    routeTreeFileFooter?: string[] | ((...args: unknown[]) => string[]) | undefined;
+    autoCodeSplitting?: boolean | undefined;
+    customScaffolding?: {
+        routeTemplate?: string | undefined;
+        lazyRouteTemplate?: string | undefined;
+    } | undefined;
+    experimental?: {
+        enableCodeSplitting?: boolean | undefined;
+    } | undefined;
+    angularRouterPackage?: string | undefined;
+    angularStartPackage?: string | undefined;
+}, {
+    plugins?: GeneratorPlugin[] | undefined;
+    target?: "angular" | "vue" | "react" | "solid" | undefined;
+    virtualRouteConfig?: string | import('@benjavicente/virtual-file-routes').VirtualRootRoute | undefined;
+    routeFilePrefix?: string | undefined;
+    routeFileIgnorePrefix?: string | undefined;
+    routeFileIgnorePattern?: string | undefined;
+    routesDirectory?: string | undefined;
+    quoteStyle?: "single" | "double" | undefined;
+    semicolons?: boolean | undefined;
+    disableLogging?: boolean | undefined;
+    routeTreeFileHeader?: string[] | undefined;
+    indexToken?: string | RegExp | {
+        regex: string;
+        flags?: string | undefined;
+    } | undefined;
+    routeToken?: string | RegExp | {
+        regex: string;
+        flags?: string | undefined;
+    } | undefined;
+    pathParamsAllowedCharacters?: (":" | "$" | ";" | "@" | "&" | "=" | "+" | ",")[] | undefined;
+    generatedRouteTree?: string | undefined;
+    disableTypes?: boolean | undefined;
+    verboseFileRoutes?: boolean | undefined;
+    addExtensions?: string | boolean | undefined;
+    enableRouteTreeFormatting?: boolean | undefined;
+    routeTreeFileFooter?: string[] | ((...args: unknown[]) => string[]) | undefined;
+    autoCodeSplitting?: boolean | undefined;
+    customScaffolding?: {
+        routeTemplate?: string | undefined;
+        lazyRouteTemplate?: string | undefined;
+    } | undefined;
+    experimental?: {
+        enableCodeSplitting?: boolean | undefined;
+    } | undefined;
+    angularRouterPackage?: string | undefined;
+    angularStartPackage?: string | undefined;
+    tmpDir?: string | undefined;
+    importRoutesUsingAbsolutePaths?: boolean | undefined;
+}>;
+export type Config = z.infer<typeof configSchema>;
+type ResolveParams = {
+    configDirectory: string;
+};
+export declare function resolveConfigPath({ configDirectory }: ResolveParams): string;
+export declare function getConfig(inlineConfig?: Partial<Config>, configDirectory?: string): Config;
+export {};

package/dist/esm/config.js

@@ -0,0 +1,129 @@
+import { virtualRootRouteSchema } from "./filesystem/virtual/config.js";
+import path from "node:path";
+import { existsSync, readFileSync } from "node:fs";
+import { z } from "zod";
+//#region src/config.ts
+var tokenJsonRegexSchema = z.object({
+	regex: z.string(),
+	flags: z.string().optional()
+});
+var tokenMatcherSchema = z.union([
+	z.string(),
+	z.instanceof(RegExp),
+	tokenJsonRegexSchema
+]);
+var baseConfigSchema = z.object({
+	target: z.enum([
+		"react",
+		"solid",
+		"vue",
+		"angular"
+	]).optional().default("react"),
+	virtualRouteConfig: virtualRootRouteSchema.or(z.string()).optional(),
+	routeFilePrefix: z.string().optional(),
+	routeFileIgnorePrefix: z.string().optional().default("-"),
+	routeFileIgnorePattern: z.string().optional(),
+	routesDirectory: z.string().optional().default("./src/routes"),
+	quoteStyle: z.enum(["single", "double"]).optional().default("single"),
+	semicolons: z.boolean().optional().default(false),
+	disableLogging: z.boolean().optional().default(false),
+	routeTreeFileHeader: z.array(z.string()).optional().default([
+		"/* eslint-disable */",
+		"// @ts-nocheck",
+		"// noinspection JSUnusedGlobalSymbols"
+	]),
+	indexToken: tokenMatcherSchema.optional().default("index"),
+	routeToken: tokenMatcherSchema.optional().default("route"),
+	pathParamsAllowedCharacters: z.array(z.enum([
+		";",
+		":",
+		"@",
+		"&",
+		"=",
+		"+",
+		"$",
+		","
+	])).optional()
+});
+var configSchema = baseConfigSchema.extend({
+	generatedRouteTree: z.string().optional().default("./src/routeTree.gen.ts"),
+	disableTypes: z.boolean().optional().default(false),
+	verboseFileRoutes: z.boolean().optional(),
+	addExtensions: z.union([z.boolean(), z.string()]).optional().default(false).transform((v) => typeof v === "string" ? v.startsWith(".") ? v : `.${v}` : v),
+	enableRouteTreeFormatting: z.boolean().optional().default(true),
+	routeTreeFileFooter: z.union([z.array(z.string()).optional().default([]), z.function().returns(z.array(z.string()))]).optional(),
+	autoCodeSplitting: z.boolean().optional(),
+	customScaffolding: z.object({
+		routeTemplate: z.string().optional(),
+		lazyRouteTemplate: z.string().optional()
+	}).optional(),
+	experimental: z.object({ enableCodeSplitting: z.boolean().optional() }).optional(),
+	plugins: z.array(z.custom()).optional(),
+	angularRouterPackage: z.string().optional(),
+	angularStartPackage: z.string().optional(),
+	tmpDir: z.string().optional().default(""),
+	importRoutesUsingAbsolutePaths: z.boolean().optional().default(false)
+});
+function resolveConfigPath({ configDirectory }) {
+	return path.resolve(configDirectory, "tsr.config.json");
+}
+function getConfig(inlineConfig = {}, configDirectory) {
+	if (configDirectory === void 0) configDirectory = process.cwd();
+	const configFilePathJson = resolveConfigPath({ configDirectory });
+	const exists = existsSync(configFilePathJson);
+	let config;
+	if (exists) {
+		const merged = {
+			...JSON.parse(readFileSync(configFilePathJson, "utf-8")),
+			...inlineConfig
+		};
+		config = configSchema.parse(merged);
+	} else config = configSchema.parse(inlineConfig);
+	if (config.disableTypes) config.generatedRouteTree = config.generatedRouteTree.replace(/\.(ts|tsx)$/, ".js");
+	if (configDirectory) if (path.isAbsolute(configDirectory)) {
+		config.routesDirectory = path.resolve(configDirectory, config.routesDirectory);
+		config.generatedRouteTree = path.resolve(configDirectory, config.generatedRouteTree);
+	} else {
+		config.routesDirectory = path.resolve(process.cwd(), configDirectory, config.routesDirectory);
+		config.generatedRouteTree = path.resolve(process.cwd(), configDirectory, config.generatedRouteTree);
+	}
+	const resolveTmpDir = (dir) => {
+		if (Array.isArray(dir)) dir = path.join(...dir);
+		if (!path.isAbsolute(dir)) dir = path.resolve(process.cwd(), dir);
+		return dir;
+	};
+	if (config.tmpDir) config.tmpDir = resolveTmpDir(config.tmpDir);
+	else if (process.env.TSR_TMP_DIR) config.tmpDir = resolveTmpDir(process.env.TSR_TMP_DIR);
+	else config.tmpDir = resolveTmpDir([".tanstack", "tmp"]);
+	validateConfig(config);
+	return config;
+}
+function validateConfig(config) {
+	if (typeof config.experimental?.enableCodeSplitting !== "undefined") {
+		const message = `
+------
+⚠️ ⚠️ ⚠️
+ERROR: The "experimental.enableCodeSplitting" flag has been made stable and is now "autoCodeSplitting". Please update your configuration file to use "autoCodeSplitting" instead of "experimental.enableCodeSplitting".
+------
+`;
+		console.error(message);
+		throw new Error(message);
+	}
+	if (areTokensEqual(config.indexToken, config.routeToken)) throw new Error(`The "indexToken" and "routeToken" options must be different.`);
+	if (config.routeFileIgnorePrefix && config.routeFileIgnorePrefix.trim() === "_") throw new Error(`The "routeFileIgnorePrefix" cannot be an underscore ("_"). This is a reserved character used to denote a pathless route. Please use a different prefix.`);
+	return config;
+}
+/**
+* Compares two token matchers for equality.
+* Handles strings, RegExp instances, and JSON regex objects.
+*/
+function areTokensEqual(a, b) {
+	if (typeof a === "string" && typeof b === "string") return a === b;
+	if (a instanceof RegExp && b instanceof RegExp) return a.source === b.source && a.flags === b.flags;
+	if (typeof a === "object" && "regex" in a && typeof b === "object" && "regex" in b) return a.regex === b.regex && (a.flags ?? "") === (b.flags ?? "");
+	return false;
+}
+//#endregion
+export { baseConfigSchema, configSchema, getConfig, resolveConfigPath };
+
+//# sourceMappingURL=config.js.map

package/dist/esm/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","names":[],"sources":["../../src/config.ts"],"sourcesContent":["import path from 'node:path'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { z } from 'zod'\nimport { virtualRootRouteSchema } from './filesystem/virtual/config'\nimport type { GeneratorPlugin } from './plugin/types'\n\nconst tokenJsonRegexSchema = z.object({\n  regex: z.string(),\n  flags: z.string().optional(),\n})\n\nconst tokenMatcherSchema = z.union([\n  z.string(),\n  z.instanceof(RegExp),\n  tokenJsonRegexSchema,\n])\n\nexport type TokenMatcherJson = string | z.infer<typeof tokenJsonRegexSchema>\n\nexport type TokenMatcher = z.infer<typeof tokenMatcherSchema>\n\nexport const baseConfigSchema = z.object({\n  target: z.enum(['react', 'solid', 'vue', 'angular']).optional().default('react'),\n  virtualRouteConfig: virtualRootRouteSchema.or(z.string()).optional(),\n  routeFilePrefix: z.string().optional(),\n  routeFileIgnorePrefix: z.string().optional().default('-'),\n  routeFileIgnorePattern: z.string().optional(),\n  routesDirectory: z.string().optional().default('./src/routes'),\n  quoteStyle: z.enum(['single', 'double']).optional().default('single'),\n  semicolons: z.boolean().optional().default(false),\n  disableLogging: z.boolean().optional().default(false),\n  routeTreeFileHeader: z\n    .array(z.string())\n    .optional()\n    .default([\n      '/* eslint-disable */',\n      '// @ts-nocheck',\n      '// noinspection JSUnusedGlobalSymbols',\n    ]),\n  indexToken: tokenMatcherSchema.optional().default('index'),\n  routeToken: tokenMatcherSchema.optional().default('route'),\n  pathParamsAllowedCharacters: z\n    .array(z.enum([';', ':', '@', '&', '=', '+', '$', ',']))\n    .optional(),\n})\n\nexport type BaseConfig = z.infer<typeof baseConfigSchema>\n\nexport const configSchema = baseConfigSchema.extend({\n  generatedRouteTree: z.string().optional().default('./src/routeTree.gen.ts'),\n  disableTypes: z.boolean().optional().default(false),\n  verboseFileRoutes: z.boolean().optional(),\n  addExtensions: z\n    .union([z.boolean(), z.string()])\n    .optional()\n    .default(false)\n    .transform((v) =>\n      typeof v === 'string' ? (v.startsWith('.') ? v : `.${v}`) : v,\n    ),\n  enableRouteTreeFormatting: z.boolean().optional().default(true),\n  routeTreeFileFooter: z\n    .union([\n      z.array(z.string()).optional().default([]),\n      z.function().returns(z.array(z.string())),\n    ])\n    .optional(),\n  autoCodeSplitting: z.boolean().optional(),\n  customScaffolding: z\n    .object({\n      routeTemplate: z.string().optional(),\n      lazyRouteTemplate: z.string().optional(),\n    })\n    .optional(),\n  experimental: z\n    .object({\n      // TODO: This has been made stable and is now \"autoCodeSplitting\". Remove in next major version.\n      enableCodeSplitting: z.boolean().optional(),\n    })\n    .optional(),\n  plugins: z.array(z.custom<GeneratorPlugin>()).optional(),\n  /**\n   * When `target` is `angular`, use this package in generated route imports and\n   * `FileRoutesByPath` augmentation (default `@benjavicente/angular-router-experimental`).\n   */\n  angularRouterPackage: z.string().optional(),\n  /**\n   * When `target` is `angular`, use this package in the Start `declare module` block\n   * appended to the route tree (default `@benjavicente/angular-start-experimental`).\n   */\n  angularStartPackage: z.string().optional(),\n  tmpDir: z.string().optional().default(''),\n  importRoutesUsingAbsolutePaths: z.boolean().optional().default(false),\n})\n\nexport type Config = z.infer<typeof configSchema>\n\ntype ResolveParams = {\n  configDirectory: string\n}\n\nexport function resolveConfigPath({ configDirectory }: ResolveParams) {\n  return path.resolve(configDirectory, 'tsr.config.json')\n}\n\nexport function getConfig(\n  inlineConfig: Partial<Config> = {},\n  configDirectory?: string,\n): Config {\n  if (configDirectory === undefined) {\n    configDirectory = process.cwd()\n  }\n  const configFilePathJson = resolveConfigPath({ configDirectory })\n  const exists = existsSync(configFilePathJson)\n\n  let config: Config\n\n  if (exists) {\n    // Parse file config (allows JSON regex-object form)\n    const fileConfigRaw = JSON.parse(readFileSync(configFilePathJson, 'utf-8'))\n\n    // Merge raw configs (inline overrides file), then parse once to apply defaults\n    // This ensures file config values aren't overwritten by inline defaults\n    const merged = {\n      ...fileConfigRaw,\n      ...inlineConfig,\n    }\n    config = configSchema.parse(merged)\n  } else {\n    config = configSchema.parse(inlineConfig)\n  }\n\n  // If typescript is disabled, make sure the generated route tree is a .js file\n  if (config.disableTypes) {\n    config.generatedRouteTree = config.generatedRouteTree.replace(\n      /\\.(ts|tsx)$/,\n      '.js',\n    )\n  }\n\n  // if a configDirectory is used, paths should be relative to that directory\n  if (configDirectory) {\n    // if absolute configDirectory is provided, use it as the root\n    if (path.isAbsolute(configDirectory)) {\n      config.routesDirectory = path.resolve(\n        configDirectory,\n        config.routesDirectory,\n      )\n      config.generatedRouteTree = path.resolve(\n        configDirectory,\n        config.generatedRouteTree,\n      )\n    } else {\n      config.routesDirectory = path.resolve(\n        process.cwd(),\n        configDirectory,\n        config.routesDirectory,\n      )\n      config.generatedRouteTree = path.resolve(\n        process.cwd(),\n        configDirectory,\n        config.generatedRouteTree,\n      )\n    }\n  }\n\n  const resolveTmpDir = (dir: string | Array<string>) => {\n    if (Array.isArray(dir)) {\n      dir = path.join(...dir)\n    }\n    if (!path.isAbsolute(dir)) {\n      dir = path.resolve(process.cwd(), dir)\n    }\n    return dir\n  }\n\n  if (config.tmpDir) {\n    config.tmpDir = resolveTmpDir(config.tmpDir)\n  } else if (process.env.TSR_TMP_DIR) {\n    config.tmpDir = resolveTmpDir(process.env.TSR_TMP_DIR)\n  } else {\n    config.tmpDir = resolveTmpDir(['.tanstack', 'tmp'])\n  }\n\n  validateConfig(config)\n  return config\n}\n\nfunction validateConfig(config: Config) {\n  if (typeof config.experimental?.enableCodeSplitting !== 'undefined') {\n    const message = `\n------\n⚠️ ⚠️ ⚠️\nERROR: The \"experimental.enableCodeSplitting\" flag has been made stable and is now \"autoCodeSplitting\". Please update your configuration file to use \"autoCodeSplitting\" instead of \"experimental.enableCodeSplitting\".\n------\n`\n    console.error(message)\n    throw new Error(message)\n  }\n\n  // Check that indexToken and routeToken are not identical\n  // Works for strings, RegExp, and JSON regex objects\n  if (areTokensEqual(config.indexToken, config.routeToken)) {\n    throw new Error(\n      `The \"indexToken\" and \"routeToken\" options must be different.`,\n    )\n  }\n\n  if (\n    config.routeFileIgnorePrefix &&\n    config.routeFileIgnorePrefix.trim() === '_'\n  ) {\n    throw new Error(\n      `The \"routeFileIgnorePrefix\" cannot be an underscore (\"_\"). This is a reserved character used to denote a pathless route. Please use a different prefix.`,\n    )\n  }\n\n  return config\n}\n\n/**\n * Compares two token matchers for equality.\n * Handles strings, RegExp instances, and JSON regex objects.\n */\nfunction areTokensEqual(a: TokenMatcher, b: TokenMatcher): boolean {\n  // Both strings\n  if (typeof a === 'string' && typeof b === 'string') {\n    return a === b\n  }\n\n  // Both RegExp instances\n  if (a instanceof RegExp && b instanceof RegExp) {\n    return a.source === b.source && a.flags === b.flags\n  }\n\n  // Both JSON regex objects\n  if (\n    typeof a === 'object' &&\n    'regex' in a &&\n    typeof b === 'object' &&\n    'regex' in b\n  ) {\n    return a.regex === b.regex && (a.flags ?? '') === (b.flags ?? '')\n  }\n\n  // Mixed types - not equal\n  return false\n}\n"],"mappings":";;;;;AAMA,IAAM,uBAAuB,EAAE,OAAO;CACpC,OAAO,EAAE,QAAQ;CACjB,OAAO,EAAE,QAAQ,CAAC,UAAU;CAC7B,CAAC;AAEF,IAAM,qBAAqB,EAAE,MAAM;CACjC,EAAE,QAAQ;CACV,EAAE,WAAW,OAAO;CACpB;CACD,CAAC;AAMF,IAAa,mBAAmB,EAAE,OAAO;CACvC,QAAQ,EAAE,KAAK;EAAC;EAAS;EAAS;EAAO;EAAU,CAAC,CAAC,UAAU,CAAC,QAAQ,QAAQ;CAChF,oBAAoB,uBAAuB,GAAG,EAAE,QAAQ,CAAC,CAAC,UAAU;CACpE,iBAAiB,EAAE,QAAQ,CAAC,UAAU;CACtC,uBAAuB,EAAE,QAAQ,CAAC,UAAU,CAAC,QAAQ,IAAI;CACzD,wBAAwB,EAAE,QAAQ,CAAC,UAAU;CAC7C,iBAAiB,EAAE,QAAQ,CAAC,UAAU,CAAC,QAAQ,eAAe;CAC9D,YAAY,EAAE,KAAK,CAAC,UAAU,SAAS,CAAC,CAAC,UAAU,CAAC,QAAQ,SAAS;CACrE,YAAY,EAAE,SAAS,CAAC,UAAU,CAAC,QAAQ,MAAM;CACjD,gBAAgB,EAAE,SAAS,CAAC,UAAU,CAAC,QAAQ,MAAM;CACrD,qBAAqB,EAClB,MAAM,EAAE,QAAQ,CAAC,CACjB,UAAU,CACV,QAAQ;EACP;EACA;EACA;EACD,CAAC;CACJ,YAAY,mBAAmB,UAAU,CAAC,QAAQ,QAAQ;CAC1D,YAAY,mBAAmB,UAAU,CAAC,QAAQ,QAAQ;CAC1D,6BAA6B,EAC1B,MAAM,EAAE,KAAK;EAAC;EAAK;EAAK;EAAK;EAAK;EAAK;EAAK;EAAK;EAAI,CAAC,CAAC,CACvD,UAAU;CACd,CAAC;AAIF,IAAa,eAAe,iBAAiB,OAAO;CAClD,oBAAoB,EAAE,QAAQ,CAAC,UAAU,CAAC,QAAQ,yBAAyB;CAC3E,cAAc,EAAE,SAAS,CAAC,UAAU,CAAC,QAAQ,MAAM;CACnD,mBAAmB,EAAE,SAAS,CAAC,UAAU;CACzC,eAAe,EACZ,MAAM,CAAC,EAAE,SAAS,EAAE,EAAE,QAAQ,CAAC,CAAC,CAChC,UAAU,CACV,QAAQ,MAAM,CACd,WAAW,MACV,OAAO,MAAM,WAAY,EAAE,WAAW,IAAI,GAAG,IAAI,IAAI,MAAO,EAC7D;CACH,2BAA2B,EAAE,SAAS,CAAC,UAAU,CAAC,QAAQ,KAAK;CAC/D,qBAAqB,EAClB,MAAM,CACL,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,EAC1C,EAAE,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAC1C,CAAC,CACD,UAAU;CACb,mBAAmB,EAAE,SAAS,CAAC,UAAU;CACzC,mBAAmB,EAChB,OAAO;EACN,eAAe,EAAE,QAAQ,CAAC,UAAU;EACpC,mBAAmB,EAAE,QAAQ,CAAC,UAAU;EACzC,CAAC,CACD,UAAU;CACb,cAAc,EACX,OAAO,EAEN,qBAAqB,EAAE,SAAS,CAAC,UAAU,EAC5C,CAAC,CACD,UAAU;CACb,SAAS,EAAE,MAAM,EAAE,QAAyB,CAAC,CAAC,UAAU;CAKxD,sBAAsB,EAAE,QAAQ,CAAC,UAAU;CAK3C,qBAAqB,EAAE,QAAQ,CAAC,UAAU;CAC1C,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,QAAQ,GAAG;CACzC,gCAAgC,EAAE,SAAS,CAAC,UAAU,CAAC,QAAQ,MAAM;CACtE,CAAC;AAQF,SAAgB,kBAAkB,EAAE,mBAAkC;AACpE,QAAO,KAAK,QAAQ,iBAAiB,kBAAkB;;AAGzD,SAAgB,UACd,eAAgC,EAAE,EAClC,iBACQ;AACR,KAAI,oBAAoB,KAAA,EACtB,mBAAkB,QAAQ,KAAK;CAEjC,MAAM,qBAAqB,kBAAkB,EAAE,iBAAiB,CAAC;CACjE,MAAM,SAAS,WAAW,mBAAmB;CAE7C,IAAI;AAEJ,KAAI,QAAQ;EAMV,MAAM,SAAS;GACb,GALoB,KAAK,MAAM,aAAa,oBAAoB,QAAQ,CAAC;GAMzE,GAAG;GACJ;AACD,WAAS,aAAa,MAAM,OAAO;OAEnC,UAAS,aAAa,MAAM,aAAa;AAI3C,KAAI,OAAO,aACT,QAAO,qBAAqB,OAAO,mBAAmB,QACpD,eACA,MACD;AAIH,KAAI,gBAEF,KAAI,KAAK,WAAW,gBAAgB,EAAE;AACpC,SAAO,kBAAkB,KAAK,QAC5B,iBACA,OAAO,gBACR;AACD,SAAO,qBAAqB,KAAK,QAC/B,iBACA,OAAO,mBACR;QACI;AACL,SAAO,kBAAkB,KAAK,QAC5B,QAAQ,KAAK,EACb,iBACA,OAAO,gBACR;AACD,SAAO,qBAAqB,KAAK,QAC/B,QAAQ,KAAK,EACb,iBACA,OAAO,mBACR;;CAIL,MAAM,iBAAiB,QAAgC;AACrD,MAAI,MAAM,QAAQ,IAAI,CACpB,OAAM,KAAK,KAAK,GAAG,IAAI;AAEzB,MAAI,CAAC,KAAK,WAAW,IAAI,CACvB,OAAM,KAAK,QAAQ,QAAQ,KAAK,EAAE,IAAI;AAExC,SAAO;;AAGT,KAAI,OAAO,OACT,QAAO,SAAS,cAAc,OAAO,OAAO;UACnC,QAAQ,IAAI,YACrB,QAAO,SAAS,cAAc,QAAQ,IAAI,YAAY;KAEtD,QAAO,SAAS,cAAc,CAAC,aAAa,MAAM,CAAC;AAGrD,gBAAe,OAAO;AACtB,QAAO;;AAGT,SAAS,eAAe,QAAgB;AACtC,KAAI,OAAO,OAAO,cAAc,wBAAwB,aAAa;EACnE,MAAM,UAAU;;;;;;AAMhB,UAAQ,MAAM,QAAQ;AACtB,QAAM,IAAI,MAAM,QAAQ;;AAK1B,KAAI,eAAe,OAAO,YAAY,OAAO,WAAW,CACtD,OAAM,IAAI,MACR,+DACD;AAGH,KACE,OAAO,yBACP,OAAO,sBAAsB,MAAM,KAAK,IAExC,OAAM,IAAI,MACR,0JACD;AAGH,QAAO;;;;;;AAOT,SAAS,eAAe,GAAiB,GAA0B;AAEjE,KAAI,OAAO,MAAM,YAAY,OAAO,MAAM,SACxC,QAAO,MAAM;AAIf,KAAI,aAAa,UAAU,aAAa,OACtC,QAAO,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE;AAIhD,KACE,OAAO,MAAM,YACb,WAAW,KACX,OAAO,MAAM,YACb,WAAW,EAEX,QAAO,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,SAAS,EAAE,SAAS;AAIhE,QAAO"}

package/dist/esm/filesystem/physical/getRouteNodes.d.ts

@@ -0,0 +1,25 @@
+import { FsRouteType, GetRouteNodesResult } from '../../types.js';
+import { Config } from '../../config.js';
+/**
+ * Pre-compiled segment regexes for matching token patterns against route segments.
+ * These are created once (in Generator constructor) and passed through to avoid
+ * repeated regex compilation during route crawling.
+ */
+export interface TokenRegexBundle {
+    indexTokenSegmentRegex: RegExp;
+    routeTokenSegmentRegex: RegExp;
+}
+export declare function isVirtualConfigFile(fileName: string): boolean;
+export declare function getRouteNodes(config: Pick<Config, 'routesDirectory' | 'routeFilePrefix' | 'routeFileIgnorePrefix' | 'routeFileIgnorePattern' | 'disableLogging' | 'routeToken' | 'indexToken'>, root: string, tokenRegexes: TokenRegexBundle): Promise<GetRouteNodesResult>;
+/**
+ * Determines the metadata for a given route path based on the provided configuration.
+ *
+ * @param routePath - The determined initial routePath (with brackets removed).
+ * @param originalRoutePath - The original route path (may contain brackets for escaped content).
+ * @param tokenRegexes - Pre-compiled token regexes for matching.
+ * @returns An object containing the type of the route and the variable name derived from the route path.
+ */
+export declare function getRouteMeta(routePath: string, originalRoutePath: string, tokenRegexes: TokenRegexBundle): {
+    fsRouteType: Extract<FsRouteType, 'static' | 'layout' | 'api' | 'lazy' | 'loader' | 'component' | 'pendingComponent' | 'errorComponent' | 'notFoundComponent'>;
+    variableName: string;
+};