react-fs-router 1.0.13 → 2.0.1

package/dist/adapters/custom.d.ts

@@ -0,0 +1,9 @@
+import { type ReactNode } from "react";
+import type { ResolvedRoute, RouteAdapter } from "../render.js";
+export type CustomRender = (routes: ResolvedRoute[]) => ReactNode;
+/**
+ * Build an adapter for any custom routing solution. The provided render
+ * function receives the resolved route tree and returns router-specific output.
+ */
+export declare function createCustomAdapter(render: CustomRender): RouteAdapter;
+//# sourceMappingURL=custom.d.ts.map

package/dist/adapters/custom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom.d.ts","sourceRoot":"","sources":["../../src/adapters/custom.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEhE,MAAM,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,SAAS,CAAC;AAElE;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAItE"}

package/dist/adapters/custom.js

@@ -0,0 +1,11 @@
+import { Fragment, createElement } from "react";
+/**
+ * Build an adapter for any custom routing solution. The provided render
+ * function receives the resolved route tree and returns router-specific output.
+ */
+export function createCustomAdapter(render) {
+    return function CustomAdapter({ routes }) {
+        return createElement(Fragment, null, render(routes));
+    };
+}
+//# sourceMappingURL=custom.js.map

package/dist/adapters/custom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom.js","sourceRoot":"","sources":["../../src/adapters/custom.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAkB,MAAM,OAAO,CAAC;AAKhE;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAoB;IACtD,OAAO,SAAS,aAAa,CAAC,EAAE,MAAM,EAAE;QACtC,OAAO,aAAa,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IACvD,CAAC,CAAC;AACJ,CAAC"}

package/dist/adapters/index.d.ts

@@ -0,0 +1,8 @@
+import type { RouteAdapter } from "../render.js";
+/** Register a user-defined routing adapter by id. */
+export declare function defineAdapter(id: string, adapter: RouteAdapter): void;
+/** Look up a registered adapter by id. */
+export declare function getAdapter(id: string): RouteAdapter | undefined;
+/** Whether an adapter with the given id has been registered. */
+export declare function hasAdapter(id: string): boolean;
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAIjD,qDAAqD;AACrD,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI,CAErE;AAED,0CAA0C;AAC1C,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAE/D;AAED,gEAAgE;AAChE,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAE9C"}

package/dist/adapters/index.js

@@ -0,0 +1,14 @@
+const registry = new Map();
+/** Register a user-defined routing adapter by id. */
+export function defineAdapter(id, adapter) {
+    registry.set(id, adapter);
+}
+/** Look up a registered adapter by id. */
+export function getAdapter(id) {
+    return registry.get(id);
+}
+/** Whether an adapter with the given id has been registered. */
+export function hasAdapter(id) {
+    return registry.has(id);
+}
+//# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAEA,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAwB,CAAC;AAEjD,qDAAqD;AACrD,MAAM,UAAU,aAAa,CAAC,EAAU,EAAE,OAAqB;IAC7D,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;AAC5B,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,UAAU,CAAC,EAAU;IACnC,OAAO,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAC1B,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,UAAU,CAAC,EAAU;IACnC,OAAO,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAC1B,CAAC"}

package/dist/adapters/react-router.d.ts

@@ -0,0 +1,18 @@
+import type { RouteObject } from "react-router";
+import type { ResolvedRoute, RouteAdapter } from "../render.js";
+/** Convert resolved routes into react-router `useRoutes` route objects. */
+export declare function toRouteObjects(routes: ResolvedRoute[]): RouteObject[];
+/**
+ * Convert resolved routes into route objects ready for a data router
+ * (`createBrowserRouter`). Ensures a root route exists when needed.
+ */
+export declare function toDataRouterObjects(routes: ResolvedRoute[]): RouteObject[];
+/** React Router adapter: renders the route tree via `useRoutes` (declarative). */
+export declare const reactRouterAdapter: RouteAdapter;
+/**
+ * React Router data adapter: renders via `createBrowserRouter` + `RouterProvider`,
+ * so route `loader`/`action` data functions are executed and exposed via
+ * `useLoaderData()`/`useActionData()`.
+ */
+export declare const reactRouterDataAdapter: RouteAdapter;
+//# sourceMappingURL=react-router.d.ts.map

package/dist/adapters/react-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-router.d.ts","sourceRoot":"","sources":["../../src/adapters/react-router.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAchE,2EAA2E;AAC3E,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,WAAW,EAAE,CAsBrE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,WAAW,EAAE,CAI1E;AAED,kFAAkF;AAClF,eAAO,MAAM,kBAAkB,EAAE,YAEhC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,YAGpC,CAAC"}

package/dist/adapters/react-router.js

@@ -0,0 +1,58 @@
+import { createElement, useState } from "react";
+import { Outlet, RouterProvider, createBrowserRouter, useRoutes } from "react-router";
+/**
+ * React Router v7 matches splats with a bare "*" segment (read back via
+ * `params["*"]`); named forms like "*slug" no longer compile. Normalize any
+ * adapter-formatted "*slug" segment (e.g. `/docs/*slug`) to "/*".
+ */
+function toReactRouterPath(path) {
+    return path
+        .split("/")
+        .map((segment) => (segment.startsWith("*") && segment !== "*" ? "*" : segment))
+        .join("/");
+}
+/** Convert resolved routes into react-router `useRoutes` route objects. */
+export function toRouteObjects(routes) {
+    return routes.map((route) => {
+        const outlet = createElement(Outlet);
+        const base = route.element ?? (route.children.length > 0 ? outlet : null);
+        const element = route.layout ? createElement(route.layout, null, outlet) : base;
+        const children = route.children.length > 0 ? toRouteObjects(route.children) : undefined;
+        const loader = route.loaders.loader;
+        const action = route.loaders.action;
+        if (route.index) {
+            return { index: true, element: element ?? undefined, loader, action };
+        }
+        return {
+            path: route.path ? toReactRouterPath(route.path) : undefined,
+            element: element ?? undefined,
+            children,
+            loader,
+            action,
+        };
+    });
+}
+/**
+ * Convert resolved routes into route objects ready for a data router
+ * (`createBrowserRouter`). Ensures a root route exists when needed.
+ */
+export function toDataRouterObjects(routes) {
+    const objects = toRouteObjects(routes);
+    if (objects.some((route) => route.path === "/"))
+        return objects;
+    return [{ path: "/", element: createElement(Outlet), children: objects }];
+}
+/** React Router adapter: renders the route tree via `useRoutes` (declarative). */
+export const reactRouterAdapter = function ReactRouterAdapter({ routes }) {
+    return useRoutes(toRouteObjects(routes));
+};
+/**
+ * React Router data adapter: renders via `createBrowserRouter` + `RouterProvider`,
+ * so route `loader`/`action` data functions are executed and exposed via
+ * `useLoaderData()`/`useActionData()`.
+ */
+export const reactRouterDataAdapter = function ReactRouterDataAdapter({ routes }) {
+    const [router] = useState(() => createBrowserRouter(toDataRouterObjects(routes)));
+    return createElement(RouterProvider, { router });
+};
+//# sourceMappingURL=react-router.js.map

package/dist/adapters/react-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-router.js","sourceRoot":"","sources":["../../src/adapters/react-router.ts"],"names":[],"mappings":"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"}

package/dist/adapters/tanstack.d.ts

@@ -0,0 +1,16 @@
+import type { ResolvedRoute, RouteAdapter } from "../render.js";
+export type TanstackRouteTree = any;
+/**
+ * Convert resolved routes into a real TanStack Router route tree. The root
+ * route is created from the resolved "/" entry (applying its layout); every
+ * other resolved route is stitched into the tree with its parent via
+ * `getParentRoute`/`addChildren`.
+ */
+export declare function toTanstackRouteTree(routes: ResolvedRoute[]): TanstackRouteTree;
+/**
+ * TanStack Router adapter: builds a router from the resolved routes and renders
+ * it via `<RouterProvider>`, so the generated default component works without
+ * manual route-tree wiring.
+ */
+export declare const tanstackRouterAdapter: RouteAdapter;
+//# sourceMappingURL=tanstack.d.ts.map

package/dist/adapters/tanstack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tanstack.d.ts","sourceRoot":"","sources":["../../src/adapters/tanstack.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAA0B,MAAM,cAAc,CAAC;AAMxF,MAAM,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAgDpC;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,iBAAiB,CAiB9E;AAED;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,YAGnC,CAAC"}

package/dist/adapters/tanstack.js

@@ -0,0 +1,75 @@
+import { createElement, useState } from "react";
+import { Outlet, RouterProvider, createRootRoute, createRoute, createRouter, } from "@tanstack/react-router";
+function LayoutOutlet({ layout }) {
+    return createElement(layout, null, createElement(Outlet));
+}
+/** The component a resolved route should render, or undefined for the default outlet. */
+function routeComponent(node) {
+    if (node.element != null)
+        return () => node.element;
+    if (node.layout) {
+        return () => createElement(LayoutOutlet, { layout: node.layout });
+    }
+    return undefined;
+}
+/** Compute a route's path relative to its parent (TanStack normalizes slashes). */
+function relativePath(childPath, parentPath) {
+    if (!parentPath || parentPath === "/")
+        return childPath.replace(/^\//, "");
+    const prefix = parentPath.endsWith("/") ? parentPath : `${parentPath}/`;
+    if (childPath.startsWith(prefix))
+        return childPath.slice(prefix.length);
+    return childPath.replace(/^\//, "");
+}
+/** Convert adapter-formatted splat segments (`*slug`) into TanStack's `$`. */
+function toTanstackPath(path) {
+    if (!path)
+        return path;
+    return path
+        .split("/")
+        .map((segment) => (segment.startsWith("*") ? "$" : segment))
+        .join("/");
+}
+function buildRoute(parent, parentPath, node) {
+    const route = createRoute({
+        getParentRoute: () => parent,
+        // Index routes use "/"; every other route gets its parent-relative path.
+        path: node.index ? "/" : toTanstackPath(relativePath(node.path, parentPath)),
+        component: routeComponent(node),
+    });
+    const ownPath = node.index ? parentPath : node.path;
+    const children = node.children
+        .filter((child) => !(child.index && child.element == null))
+        .map((child) => buildRoute(route, ownPath, child));
+    return children.length > 0 ? route.addChildren(children) : route;
+}
+/**
+ * Convert resolved routes into a real TanStack Router route tree. The root
+ * route is created from the resolved "/" entry (applying its layout); every
+ * other resolved route is stitched into the tree with its parent via
+ * `getParentRoute`/`addChildren`.
+ */
+export function toTanstackRouteTree(routes) {
+    const rootEntry = routes.find((route) => !route.index && route.path === "/");
+    const rootLayout = rootEntry?.layout ?? null;
+    const rootRoute = rootLayout
+        ? createRootRoute({
+            component: () => createElement(LayoutOutlet, { layout: rootLayout }),
+        })
+        : createRootRoute();
+    const topLevel = rootEntry
+        ? [...rootEntry.children, ...routes.filter((route) => route !== rootEntry)]
+        : routes;
+    const children = topLevel.map((node) => buildRoute(rootRoute, "/", node));
+    return rootRoute.addChildren(children);
+}
+/**
+ * TanStack Router adapter: builds a router from the resolved routes and renders
+ * it via `<RouterProvider>`, so the generated default component works without
+ * manual route-tree wiring.
+ */
+export const tanstackRouterAdapter = function TanStackRouterAdapter({ routes }) {
+    const [router] = useState(() => createRouter({ routeTree: toTanstackRouteTree(routes) }));
+    return createElement(RouterProvider, { router });
+};
+//# sourceMappingURL=tanstack.js.map

package/dist/adapters/tanstack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tanstack.js","sourceRoot":"","sources":["../../src/adapters/tanstack.ts"],"names":[],"mappings":"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"}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export declare function main(argv?: string[]): Promise<void>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAcA,wBAAsB,IAAI,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiDvE"}

package/dist/cli.js

@@ -0,0 +1,59 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { watch } from "chokidar";
+import { existsSync } from "node:fs";
+import { createRequire } from "node:module";
+import { resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+import { loadConfig, resolveConfig } from "./config.js";
+import { writeRoutes } from "./generator.js";
+const require = createRequire(import.meta.url);
+const pkg = require("../package.json");
+export async function main(argv = process.argv) {
+    const program = new Command();
+    program
+        .name("rfr")
+        .version(pkg.version, "-v, --version", "Output the current version")
+        .option("-i, --input <directory>", "Path to the pages directory (overrides config)")
+        .option("-c, --config <file>", "Path to the config file", "rfr.config.ts")
+        .option("-o, --output <directory>", "Output directory (overrides config)")
+        .option("-a, --adapter <name>", "Routing adapter to use")
+        .option("-w, --watch", "Watch for changes and regenerate")
+        .option("-b, --build", "Generate once and exit (default)")
+        .parse(argv);
+    const opts = program.opts();
+    const userConfig = existsSync(opts.config)
+        ? await loadConfig(opts.config)
+        : {};
+    const merged = {
+        ...userConfig,
+        pages: opts.input ?? userConfig.pages,
+        outDir: opts.output ?? userConfig.outDir,
+        adapter: opts.adapter ?? userConfig.adapter,
+    };
+    const config = resolveConfig(merged, process.cwd());
+    writeRoutes(config);
+    console.log(`[react-fs-router] Generated ${config.outFile}`);
+    if (opts.watch) {
+        const watcher = watch(config.pages, { ignored: /(^|[\/\\])\../ });
+        const regenerate = () => {
+            try {
+                writeRoutes(config);
+                console.log(`[react-fs-router] Regenerated ${config.outFile}`);
+            }
+            catch (err) {
+                console.error("[react-fs-router]", err);
+            }
+        };
+        watcher.on("add", regenerate).on("change", regenerate).on("unlink", regenerate);
+    }
+}
+const isDirectRun = process.argv[1] !== undefined &&
+    import.meta.url === pathToFileURL(resolve(process.argv[1])).href;
+if (isDirectRun) {
+    main().catch((err) => {
+        console.error("[react-fs-router]", err);
+        process.exitCode = 1;
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -0,0 +1,24 @@
+import type { FileToFunction, PathFormatter, ResolvedConfig, UserConfig } from "./types.js";
+export declare const DEFAULT_FUNCTIONS: Record<string, string>;
+/** Default data-function file names (attached to the route rather than rendered). */
+export declare const DEFAULT_LOADERS: Record<string, string>;
+export declare const DEFAULT_EXTENSIONS: string[];
+export declare const BUILTIN_ADAPTERS: readonly ["react-router", "custom", "tanstack-router"];
+/** Default dynamic-segment formatting per adapter. */
+export declare const DEFAULT_PATH_FORMATTERS: Record<string, PathFormatter>;
+/** Typed identity helper for config files (provides intellisense without changing values). */
+export declare function defineConfig(config: UserConfig): UserConfig;
+/** Resolve a possibly-relative path against a base directory. */
+export declare function toAbsolute(path: string, base: string): string;
+/** Normalize a user "functions" mapping into a callable file-name -> function-name mapper. */
+export declare function resolveFunctionMapper(functions: Record<string, string> | FileToFunction | undefined): FileToFunction;
+/** Normalize a user "loaders" mapping into a callable file-name -> data-function-name mapper. */
+export declare function resolveLoaderMapper(loaders: Record<string, string> | FileToFunction | undefined): FileToFunction;
+/** Merge user config with defaults and resolve all paths to absolute. */
+export declare function resolveConfig(user?: UserConfig, cwd?: string): ResolvedConfig;
+/**
+ * Load a config module (.ts or .js). Supports `export default {...}` or a
+ * named `export const config`. Requires Node >= 20.6 for native .ts loading.
+ */
+export declare function loadConfig(configPath: string): Promise<UserConfig>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE5F,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAIpD,CAAC;AAEF,qFAAqF;AACrF,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAGlD,CAAC;AAEF,eAAO,MAAM,kBAAkB,UAAiC,CAAC;AAEjE,eAAO,MAAM,gBAAgB,wDAAyD,CAAC;AAEvF,sDAAsD;AACtD,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAIjE,CAAC;AAEF,8FAA8F;AAC9F,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAE3D;AAED,iEAAiE;AACjE,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,8FAA8F;AAC9F,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,cAAc,GAAG,SAAS,GAC7D,cAAc,CAIhB;AAED,iGAAiG;AACjG,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,cAAc,GAAG,SAAS,GAC3D,cAAc,CAIhB;AAED,yEAAyE;AACzE,wBAAgB,aAAa,CAAC,IAAI,GAAE,UAAe,EAAE,GAAG,GAAE,MAAsB,GAAG,cAAc,CAyBhG;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CASxE"}

package/dist/config.js

@@ -0,0 +1,81 @@
+import { isAbsolute, resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+export const DEFAULT_FUNCTIONS = {
+    layout: "layout",
+    loading: "loading",
+    error: "error",
+};
+/** Default data-function file names (attached to the route rather than rendered). */
+export const DEFAULT_LOADERS = {
+    loader: "loader",
+    action: "action",
+};
+export const DEFAULT_EXTENSIONS = [".js", ".jsx", ".ts", ".tsx"];
+export const BUILTIN_ADAPTERS = ["react-router", "custom", "tanstack-router"];
+/** Default dynamic-segment formatting per adapter. */
+export const DEFAULT_PATH_FORMATTERS = {
+    "react-router": { dynamic: (name) => `:${name}`, catchAll: (name) => `*${name}` },
+    "tanstack-router": { dynamic: (name) => `$${name}`, catchAll: (name) => `*${name}` },
+    custom: { dynamic: (name) => `:${name}`, catchAll: (name) => `*${name}` },
+};
+/** Typed identity helper for config files (provides intellisense without changing values). */
+export function defineConfig(config) {
+    return config;
+}
+/** Resolve a possibly-relative path against a base directory. */
+export function toAbsolute(path, base) {
+    return isAbsolute(path) ? path : resolve(base, path);
+}
+/** Normalize a user "functions" mapping into a callable file-name -> function-name mapper. */
+export function resolveFunctionMapper(functions) {
+    if (typeof functions === "function")
+        return functions;
+    const map = functions ?? DEFAULT_FUNCTIONS;
+    return (name) => map[name] ?? null;
+}
+/** Normalize a user "loaders" mapping into a callable file-name -> data-function-name mapper. */
+export function resolveLoaderMapper(loaders) {
+    if (typeof loaders === "function")
+        return loaders;
+    const map = loaders ?? DEFAULT_LOADERS;
+    return (name) => map[name] ?? null;
+}
+/** Merge user config with defaults and resolve all paths to absolute. */
+export function resolveConfig(user = {}, cwd = process.cwd()) {
+    const pages = toAbsolute(user.pages ?? "src/pages", cwd);
+    const outDir = toAbsolute(user.outDir ?? pages, cwd);
+    const adapter = user.adapter ?? "react-router";
+    const defaultFormatter = DEFAULT_PATH_FORMATTERS[adapter] ?? DEFAULT_PATH_FORMATTERS["react-router"];
+    return {
+        pages,
+        outDir,
+        outFile: toAbsolute(user.outFileName ?? "routes.tsx", outDir),
+        adapter,
+        fileToFunction: resolveFunctionMapper(user.functions),
+        fileToLoader: resolveLoaderMapper(user.loaders),
+        extensions: user.extensions ?? DEFAULT_EXTENSIONS,
+        ignore: user.ignore ?? [],
+        ignorePrefix: user.ignorePrefix ?? "_",
+        ignoreDotFiles: user.ignoreDotFiles ?? true,
+        inheritLayout: user.inheritLayout ?? true,
+        legacyBrowserRouter: user.legacyBrowserRouter ?? false,
+        pathFormatter: {
+            dynamic: user.formatDynamicSegment ?? defaultFormatter.dynamic,
+            catchAll: user.formatCatchAllSegment ?? defaultFormatter.catchAll,
+        },
+        importPrefix: user.importPrefix ?? null,
+    };
+}
+/**
+ * Load a config module (.ts or .js). Supports `export default {...}` or a
+ * named `export const config`. Requires Node >= 20.6 for native .ts loading.
+ */
+export async function loadConfig(configPath) {
+    const mod = await import(pathToFileURL(resolve(configPath)).href);
+    const namespace = mod;
+    const raw = namespace.default ?? namespace.config ?? mod;
+    if (raw && typeof raw === "object")
+        return raw;
+    throw new Error(`Config file "${configPath}" must export a config object (default export or named "config").`);
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/generator.d.ts

@@ -0,0 +1,48 @@
+import type { ResolvedConfig, RouteNode } from "./types.js";
+interface FileRegistry {
+    fileToId: Map<string, string>;
+}
+/** Convert a file base name into a valid JS identifier. */
+export declare function toIdentifier(file: string): string;
+/** Assign a unique, readable import identifier to every referenced file. */
+export declare function buildFileRegistry(tree: RouteNode[]): FileRegistry;
+/** Compute the import specifier for a file, relative to the generated file (or aliased). */
+export declare function importSpecifier(file: string, config: ResolvedConfig): string;
+export type RouteSegmentKind = "literal" | "param" | "catch";
+/** A parsed segment of a formatted route path (e.g. "/users/:id/edit"). */
+export interface RouteSegment {
+    kind: RouteSegmentKind;
+    /** Literal text, param name, or catch-all name. */
+    name: string;
+}
+/**
+ * Split a formatted route path into segments. Dynamic segments start with
+ * ":" (react-router/custom) or "$" (tanstack); catch-all segments start with "*".
+ */
+export declare function parseRouteSegments(path: string): RouteSegment[];
+/** Turn a segment into an uppercase object-key token ("about" -> "ABOUT"). */
+export declare function segmentToken(segment: RouteSegment): string;
+/** Build an object key from path segments; the root index route is "HOME". */
+export declare function routeKeyForSegments(segments: RouteSegment[]): string;
+/** An addressable route's entry in the generated `ROUTES` navigation map. */
+export interface RouteMapEntry {
+    key: string;
+    path: string;
+    segments: RouteSegment[];
+    /** Param/catch-all names in path order (the function's arguments). */
+    params: string[];
+    hasCatch: boolean;
+}
+/**
+ * Collect every addressable route (files and directories that have an index
+ * page) into `ROUTES` entries, skipping duplicate keys.
+ */
+export declare function routeMapEntries(tree: RouteNode[]): RouteMapEntry[];
+/** Render the body of `export const ROUTES = { ... }` for the given entries. */
+export declare function routeMapSource(entries: RouteMapEntry[]): string;
+/** Generate the routes module source for the resolved config. */
+export declare function generateRoutesModule(config: ResolvedConfig): string;
+/** Generate the routes module and write it to disk. Returns the output file path. */
+export declare function writeRoutes(config: ResolvedConfig): string;
+export {};
+//# sourceMappingURL=generator.d.ts.map

package/dist/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../src/generator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAa,SAAS,EAAE,MAAM,YAAY,CAAC;AAGvE,UAAU,YAAY;IACpB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED,2DAA2D;AAC3D,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIjD;AAED,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,YAAY,CA0BjE;AAED,4FAA4F;AAC5F,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,MAAM,CAU5E;AAkBD,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;AAE7D,2EAA2E;AAC3E,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,gBAAgB,CAAC;IACvB,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,EAAE,CAa/D;AAED,8EAA8E;AAC9E,wBAAgB,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAG1D;AAED,8EAA8E;AAC9E,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,MAAM,CAGpE;AAED,6EAA6E;AAC7E,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,sEAAsE;IACtE,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,aAAa,EAAE,CA4BlE;AAkCD,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,MAAM,CAI/D;AAsBD,iEAAiE;AACjE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAuGnE;AAED,qFAAqF;AACrF,wBAAgB,WAAW,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAK1D"}