react-fs-router 1.0.13 → 2.0.1

package/dist/generator.js

@@ -0,0 +1,272 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { basename, dirname, extname, normalize, relative } from "node:path";
+import { scanDirectory } from "./tree.js";
+/** Convert a file base name into a valid JS identifier. */
+export function toIdentifier(file) {
+    const base = basename(file, extname(file));
+    const cleaned = base.replace(/[^A-Za-z0-9_$]/g, "_");
+    return /^[A-Za-z_$]/.test(cleaned) ? cleaned : "_" + cleaned;
+}
+/** Assign a unique, readable import identifier to every referenced file. */
+export function buildFileRegistry(tree) {
+    const fileToId = new Map();
+    const used = new Set();
+    const register = (file) => {
+        if (fileToId.has(file))
+            return;
+        const base = toIdentifier(file);
+        let id = base;
+        let i = 1;
+        while (used.has(id))
+            id = `${base}${i++}`;
+        used.add(id);
+        fileToId.set(file, id);
+    };
+    const visit = (nodes) => {
+        for (const node of nodes) {
+            if (node.component)
+                register(node.component);
+            if (node.layout)
+                register(node.layout);
+            for (const fn of Object.values(node.functions))
+                register(fn);
+            for (const fn of Object.values(node.loaders))
+                register(fn);
+            visit(node.children);
+        }
+    };
+    visit(tree);
+    return { fileToId };
+}
+/** Compute the import specifier for a file, relative to the generated file (or aliased). */
+export function importSpecifier(file, config) {
+    const noExt = file.replace(/\.[^.]+$/, "");
+    if (config.importPrefix) {
+        const rel = normalize(relative(config.pages, noExt)).replace(/[\\/]/g, "/");
+        return `${config.importPrefix}/${rel}`.replace(/\/{2,}/g, "/");
+    }
+    const rel = normalize(relative(dirname(config.outFile), noExt)).replace(/[\\/]/g, "/");
+    return rel.startsWith(".") ? rel : `./${rel}`;
+}
+function toRouteMeta(node, config) {
+    return {
+        type: node.type,
+        path: node.path,
+        component: node.component ? importSpecifier(node.component, config) : null,
+        layout: node.layout ? importSpecifier(node.layout, config) : null,
+        functions: Object.fromEntries(Object.entries(node.functions).map(([name, file]) => [name, importSpecifier(file, config)])),
+        loaders: Object.fromEntries(Object.entries(node.loaders).map(([name, file]) => [name, importSpecifier(file, config)])),
+        children: node.children.map((child) => toRouteMeta(child, config)),
+    };
+}
+/**
+ * Split a formatted route path into segments. Dynamic segments start with
+ * ":" (react-router/custom) or "$" (tanstack); catch-all segments start with "*".
+ */
+export function parseRouteSegments(path) {
+    return path
+        .split("/")
+        .filter(Boolean)
+        .map((segment) => {
+        if (segment.startsWith(":") || segment.startsWith("$")) {
+            return { kind: "param", name: segment.slice(1) };
+        }
+        if (segment.startsWith("*")) {
+            return { kind: "catch", name: segment.slice(1) };
+        }
+        return { kind: "literal", name: segment };
+    });
+}
+/** Turn a segment into an uppercase object-key token ("about" -> "ABOUT"). */
+export function segmentToken(segment) {
+    const raw = segment.name.toUpperCase().replace(/[^A-Z0-9]+/g, "_");
+    return raw.replace(/^_+|_+$/g, "");
+}
+/** Build an object key from path segments; the root index route is "HOME". */
+export function routeKeyForSegments(segments) {
+    const key = segments.map(segmentToken).filter(Boolean).join("_");
+    return key || "HOME";
+}
+/**
+ * Collect every addressable route (files and directories that have an index
+ * page) into `ROUTES` entries, skipping duplicate keys.
+ */
+export function routeMapEntries(tree) {
+    const entries = [];
+    const seen = new Set();
+    const visit = (nodes) => {
+        for (const node of nodes) {
+            const addressable = node.type === "file" || (node.type === "directory" && node.component !== null);
+            if (addressable) {
+                const segments = parseRouteSegments(node.path);
+                const key = routeKeyForSegments(segments);
+                if (!seen.has(key)) {
+                    seen.add(key);
+                    entries.push({
+                        key,
+                        path: node.path,
+                        segments,
+                        params: segments.filter((s) => s.kind !== "literal").map((s) => s.name),
+                        hasCatch: segments.some((s) => s.kind === "catch"),
+                    });
+                }
+            }
+            visit(node.children);
+        }
+    };
+    visit(tree);
+    return entries;
+}
+function routeMapValueSource(entry) {
+    if (entry.params.length === 0)
+        return JSON.stringify(entry.path);
+    const used = new Set();
+    const uniqueJsName = (name) => {
+        let id = name.replace(/[^A-Za-z0-9_$]/g, "_");
+        if (!/^[A-Za-z_$]/.test(id))
+            id = "_" + id;
+        while (used.has(id))
+            id += "_";
+        used.add(id);
+        return id;
+    };
+    let template = "/";
+    const args = [];
+    for (const segment of entry.segments) {
+        if (segment.kind === "literal") {
+            template += segment.name + "/";
+        }
+        else if (segment.kind === "param") {
+            const id = uniqueJsName(segment.name);
+            args.push(id);
+            template += "${" + id + "}/";
+        }
+        else {
+            const id = uniqueJsName(segment.name);
+            args.push(`...${id}`);
+            template += "${" + id + ".join('/')}";
+        }
+    }
+    if (template.endsWith("/"))
+        template = template.slice(0, -1);
+    return `(${args.join(", ")}) => \`${template}\``;
+}
+/** Render the body of `export const ROUTES = { ... }` for the given entries. */
+export function routeMapSource(entries) {
+    return entries
+        .map((entry) => `${JSON.stringify(entry.key)}: ${routeMapValueSource(entry)}`)
+        .join(",\n");
+}
+function routeEntrySource(node, registry) {
+    const component = node.component ? (registry.fileToId.get(node.component) ?? "null") : "null";
+    const layout = node.layout ? (registry.fileToId.get(node.layout) ?? "null") : "null";
+    const functions = Object.entries(node.functions)
+        .map(([name, file]) => `${JSON.stringify(name)}: ${registry.fileToId.get(file) ?? "null"}`)
+        .join(", ");
+    const loaders = Object.entries(node.loaders)
+        .map(([name, file]) => `${JSON.stringify(name)}: ${registry.fileToId.get(file) ?? "null"}`)
+        .join(", ");
+    const children = node.children.map((child) => routeEntrySource(child, registry)).join(", ");
+    return `{ type: ${JSON.stringify(node.type)}, path: ${JSON.stringify(node.path)}, component: ${component}, layout: ${layout}, functions: { ${functions} }, loaders: { ${loaders} }, children: [${children}] }`;
+}
+function importsSource(registry, config) {
+    return [...registry.fileToId.entries()]
+        .map(([file, id]) => `import ${id} from ${JSON.stringify(importSpecifier(file, config))};`)
+        .join("\n");
+}
+/** Generate the routes module source for the resolved config. */
+export function generateRoutesModule(config) {
+    const tree = scanDirectory(config.pages, config);
+    const registry = buildFileRegistry(tree);
+    const routeEntries = tree.map((node) => routeEntrySource(node, registry)).join(",\n");
+    const routesMeta = JSON.stringify(tree.map((node) => toRouteMeta(node, config)), null, 2);
+    const imports = importsSource(registry, config);
+    const isReactRouter = config.adapter === "react-router";
+    const isTanstack = config.adapter === "tanstack-router";
+    // Data router (route objects) is the default; opt into the legacy declarative
+    // `<BrowserRouter>` component with `legacyBrowserRouter: true`.
+    const legacyBrowserRouter = config.legacyBrowserRouter;
+    const reactRouterImports = legacyBrowserRouter
+        ? [
+            'import { FileSystemRouter, resolveRoutes } from "react-fs-router/render";',
+            'import { reactRouterAdapter, toRouteObjects } from "react-fs-router/adapters/react-router";',
+            'import type { RouteEntry } from "react-fs-router/render";',
+        ]
+        : [
+            'import { FileSystemRouter, resolveRoutes } from "react-fs-router/render";',
+            'import { reactRouterDataAdapter, toDataRouterObjects } from "react-fs-router/adapters/react-router";',
+            'import type { RouteEntry } from "react-fs-router/render";',
+        ];
+    const tanstackImports = [
+        'import { FileSystemRouter, resolveRoutes } from "react-fs-router/render";',
+        'import { tanstackRouterAdapter, toTanstackRouteTree } from "react-fs-router/adapters/tanstack";',
+        'import type { RouteEntry } from "react-fs-router/render";',
+    ].join("\n");
+    const customImports = [
+        'import { FileSystemRouter } from "react-fs-router/render";',
+        'import type { RouteEntry, ResolvedRoute } from "react-fs-router/render";',
+        'import type { ReactNode } from "react";',
+    ].join("\n");
+    const libImports = isReactRouter
+        ? reactRouterImports.join("\n")
+        : isTanstack
+            ? tanstackImports
+            : customImports;
+    const routesBlock = `const routes: RouteEntry[] = [\n${routeEntries}\n];`;
+    const routesMetaBlock = `export const routesMeta = ${routesMeta};`;
+    const routingMetaBlock = `export const routingMeta = ${JSON.stringify({
+        adapter: config.adapter,
+        ignorePrefix: config.ignorePrefix,
+        ignoreDotFiles: config.ignoreDotFiles,
+        ignore: config.ignore,
+        inheritLayout: config.inheritLayout,
+        legacyBrowserRouter: config.legacyBrowserRouter,
+    }, null, 2)};`;
+    // Standalone identifier so consumers can read the resolved ignore prefix
+    // (the leading character that marks a file as ignored) without parsing
+    // routingMeta.
+    const ignoreIdentifierBlock = `export const ignoreIdentifier = ${JSON.stringify(config.ignorePrefix)};`;
+    // Navigation map: static paths are constants, dynamic paths are functions
+    // that build the URL from their arguments (e.g. ROUTES.USERS_ID(14)).
+    const routesObjectBlock = `export const ROUTES = {\n${routeMapSource(routeMapEntries(tree))}\n} as const;`;
+    const inheritLayout = JSON.stringify(config.inheritLayout);
+    const reactRouterAdapterName = legacyBrowserRouter ? "reactRouterAdapter" : "reactRouterDataAdapter";
+    const defaultExport = isReactRouter
+        ? `export default function Router() {\n  return <FileSystemRouter routes={routes} inheritLayout={${inheritLayout}} adapter={${reactRouterAdapterName}} />;\n}`
+        : isTanstack
+            ? `export default function Router() {\n  return <FileSystemRouter routes={routes} inheritLayout={${inheritLayout}} adapter={tanstackRouterAdapter} />;\n}`
+            : `export default function Router({ renderRoutes }: { renderRoutes?: (routes: ResolvedRoute[]) => ReactNode }) {\n  return <FileSystemRouter routes={routes} inheritLayout={${inheritLayout}} renderRoutes={renderRoutes} />;\n}`;
+    const routeObjectsConverter = legacyBrowserRouter ? "toRouteObjects" : "toDataRouterObjects";
+    const routeObjectsBlock = isReactRouter
+        ? `export const routeObjects = ${routeObjectsConverter}(resolveRoutes(routes, ${inheritLayout}));`
+        : "";
+    const routeTreeBlock = isTanstack
+        ? `export const routeTree = toTanstackRouteTree(resolveRoutes(routes, ${inheritLayout}));`
+        : "";
+    return [
+        "// Generated by react-fs-router. Do not edit.",
+        libImports,
+        imports,
+        "",
+        routesBlock,
+        "",
+        routesMetaBlock,
+        "",
+        routingMetaBlock,
+        ignoreIdentifierBlock,
+        routesObjectBlock,
+        routeObjectsBlock,
+        routeTreeBlock,
+        "",
+        defaultExport,
+        "",
+    ].join("\n");
+}
+/** Generate the routes module and write it to disk. Returns the output file path. */
+export function writeRoutes(config) {
+    const source = generateRoutesModule(config);
+    mkdirSync(dirname(config.outFile), { recursive: true });
+    writeFileSync(config.outFile, source, "utf8");
+    return config.outFile;
+}
+//# sourceMappingURL=generator.js.map

package/dist/generator.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export * from "./types.js";
+export * from "./scanner.js";
+export * from "./tree.js";
+export * from "./config.js";
+export * from "./generator.js";
+export { FileSystemRouter, resolveRoute, resolveRoutes, wrapWithFunctions, } from "./render.js";
+export type { RouteEntry, ResolvedRoute, RouteAdapter, RouteFunctionComponent, RouteDataFunction, } from "./render.js";
+export { defineAdapter, getAdapter, hasAdapter } from "./adapters/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,iBAAiB,GAClB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,UAAU,EACV,aAAa,EACb,YAAY,EACZ,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export * from "./types.js";
+export * from "./scanner.js";
+export * from "./tree.js";
+export * from "./config.js";
+export * from "./generator.js";
+export { FileSystemRouter, resolveRoute, resolveRoutes, wrapWithFunctions, } from "./render.js";
+export { defineAdapter, getAdapter, hasAdapter } from "./adapters/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAQrB,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/render.d.ts

@@ -0,0 +1,53 @@
+import { type ComponentType, type ReactNode } from "react";
+/** A route function component wraps a page (and optionally its children). */
+export type RouteFunctionComponent = ComponentType<{
+    children?: ReactNode;
+}>;
+/** A route data function (loader, action, ...) attached to a route. */
+export type RouteDataFunction = (...args: any[]) => any;
+/** Runtime route descriptor with concrete component references. */
+export interface RouteEntry {
+    type: "file" | "directory";
+    path: string;
+    component: ComponentType | null;
+    layout: RouteFunctionComponent | null;
+    functions: Record<string, RouteFunctionComponent>;
+    loaders: Record<string, RouteDataFunction>;
+    children: RouteEntry[];
+}
+/** Router-agnostic composed route, ready for an adapter to render. */
+export interface ResolvedRoute {
+    path: string;
+    index: boolean;
+    /** The page element (already wrapped with functions), or null for a pure group route. */
+    element: ReactNode | null;
+    /** Layout wrapper component, applied by the adapter around child routes. */
+    layout: RouteFunctionComponent | null;
+    /** Data functions (loader, action, ...) attached to this route. */
+    loaders: Record<string, RouteDataFunction>;
+    children: ResolvedRoute[];
+}
+/** An adapter renders a resolved route tree into router-specific output. */
+export type RouteAdapter = ComponentType<{
+    routes: ResolvedRoute[];
+}>;
+/** Wrap an element with the given route functions (in insertion order). */
+export declare function wrapWithFunctions(functions: Record<string, RouteFunctionComponent>, element: ReactNode | null): ReactNode | null;
+/** Compose a single route entry into a router-agnostic resolved route. */
+export declare function resolveRoute(entry: RouteEntry, inheritLayout?: boolean): ResolvedRoute;
+/** Compose a list of route entries into resolved routes. */
+export declare function resolveRoutes(entries: RouteEntry[], inheritLayout?: boolean): ResolvedRoute[];
+export interface FileSystemRouterProps {
+    routes: RouteEntry[];
+    adapter?: RouteAdapter;
+    renderRoutes?: (routes: ResolvedRoute[]) => ReactNode;
+    /** Whether parent layouts cascade to layout-less descendants. Default: true. */
+    inheritLayout?: boolean;
+}
+/**
+ * The single component users drop into their routing solution. It resolves the
+ * route tree and hands it to the configured adapter (or a custom `renderRoutes`
+ * callback for any other toolchain).
+ */
+export declare function FileSystemRouter({ routes, adapter: Adapter, renderRoutes, inheritLayout, }: FileSystemRouterProps): ReactNode;
+//# sourceMappingURL=render.d.ts.map

package/dist/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../src/render.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA2B,KAAK,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAEpF,6EAA6E;AAC7E,MAAM,MAAM,sBAAsB,GAAG,aAAa,CAAC;IAAE,QAAQ,CAAC,EAAE,SAAS,CAAA;CAAE,CAAC,CAAC;AAE7E,uEAAuE;AACvE,MAAM,MAAM,iBAAiB,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;AAExD,mEAAmE;AACnE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,aAAa,GAAG,IAAI,CAAC;IAChC,MAAM,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACtC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;IAClD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAC3C,QAAQ,EAAE,UAAU,EAAE,CAAC;CACxB;AAED,sEAAsE;AACtE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,yFAAyF;IACzF,OAAO,EAAE,SAAS,GAAG,IAAI,CAAC;IAC1B,4EAA4E;IAC5E,MAAM,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACtC,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAC3C,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED,4EAA4E;AAC5E,MAAM,MAAM,YAAY,GAAG,aAAa,CAAC;IAAE,MAAM,EAAE,aAAa,EAAE,CAAA;CAAE,CAAC,CAAC;AAEtE,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,EACjD,OAAO,EAAE,SAAS,GAAG,IAAI,GACxB,SAAS,GAAG,IAAI,CAMlB;AA2FD,0EAA0E;AAC1E,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,aAAa,UAAO,GAAG,aAAa,CAEnF;AAED,4DAA4D;AAC5D,wBAAgB,aAAa,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,aAAa,UAAO,GAAG,aAAa,EAAE,CAO1F;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,SAAS,CAAC;IACtD,gFAAgF;IAChF,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,MAAM,EACN,OAAO,EAAE,OAAO,EAChB,YAAY,EACZ,aAAoB,GACrB,EAAE,qBAAqB,GAAG,SAAS,CASnC"}

package/dist/render.js

@@ -0,0 +1,100 @@
+import { Fragment, createElement } from "react";
+/** Wrap an element with the given route functions (in insertion order). */
+export function wrapWithFunctions(functions, element) {
+    if (element === null || element === undefined)
+        return null;
+    return Object.entries(functions).reduce((acc, [name, Component]) => createElement(Component, { key: name }, acc), element);
+}
+/** Wrap an element in a layout component, if one is provided. */
+function wrapWithLayout(layout, element) {
+    if (element === null || element === undefined)
+        return null;
+    return layout ? createElement(layout, null, element) : element;
+}
+function resolveEntry(entry, inheritLayout, inheritedLayout) {
+    if (entry.type === "file") {
+        return {
+            route: {
+                path: entry.path,
+                index: false,
+                element: wrapWithFunctions(entry.functions, entry.component ? createElement(entry.component) : null),
+                layout: entry.layout,
+                loaders: entry.loaders,
+                children: [],
+            },
+            hoisted: [],
+        };
+    }
+    const ownLayout = entry.layout;
+    // The layout that wraps this directory's own page (and, when inheritance is
+    // enabled, its non-overriding descendants).
+    const effectiveLayout = ownLayout ?? (inheritLayout ? inheritedLayout : null);
+    const nested = [];
+    const hoisted = [];
+    for (const child of entry.children) {
+        const result = resolveEntry(child, inheritLayout, effectiveLayout);
+        // A descendant directory that defines its own layout overrides the current
+        // directory's layout, so it escapes the layout wrapper by becoming a sibling.
+        if (inheritLayout && result.route.layout !== null && effectiveLayout !== null) {
+            hoisted.push(result.route, ...result.hoisted);
+        }
+        else {
+            nested.push(result.route);
+            hoisted.push(...result.hoisted);
+        }
+    }
+    const indexElement = entry.component
+        ? wrapWithFunctions(entry.functions, createElement(entry.component))
+        : null;
+    // When inheritance is enabled this directory's layout wraps its children via
+    // an outlet; otherwise the layout only wraps its own index page.
+    const wrapsChildren = inheritLayout && ownLayout !== null;
+    const indexChild = indexElement
+        ? {
+            path: "",
+            index: true,
+            element: wrapsChildren ? indexElement : wrapWithLayout(ownLayout, indexElement),
+            layout: null,
+            loaders: entry.loaders,
+            children: [],
+        }
+        : null;
+    return {
+        route: {
+            path: entry.path,
+            index: false,
+            element: null,
+            layout: wrapsChildren ? ownLayout : null,
+            loaders: indexChild ? {} : entry.loaders,
+            children: indexChild ? [indexChild, ...nested] : nested,
+        },
+        hoisted,
+    };
+}
+/** Compose a single route entry into a router-agnostic resolved route. */
+export function resolveRoute(entry, inheritLayout = true) {
+    return resolveEntry(entry, inheritLayout, null).route;
+}
+/** Compose a list of route entries into resolved routes. */
+export function resolveRoutes(entries, inheritLayout = true) {
+    const resolved = [];
+    for (const entry of entries) {
+        const result = resolveEntry(entry, inheritLayout, null);
+        resolved.push(result.route, ...result.hoisted);
+    }
+    return resolved;
+}
+/**
+ * The single component users drop into their routing solution. It resolves the
+ * route tree and hands it to the configured adapter (or a custom `renderRoutes`
+ * callback for any other toolchain).
+ */
+export function FileSystemRouter({ routes, adapter: Adapter, renderRoutes, inheritLayout = true, }) {
+    const resolved = resolveRoutes(routes, inheritLayout);
+    if (renderRoutes)
+        return createElement(Fragment, null, renderRoutes(resolved));
+    if (Adapter)
+        return createElement(Adapter, { routes: resolved });
+    throw new Error("[react-fs-router] FileSystemRouter requires an `adapter` or a `renderRoutes` prop.");
+}
+//# sourceMappingURL=render.js.map

package/dist/render.js.map

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

package/dist/scanner.d.ts

@@ -0,0 +1,27 @@
+import type { PathFormatter } from "./types.js";
+export interface ParsedFileName {
+    /** Base name without extension, e.g. "index" or "[id]". */
+    name: string;
+    /** Extension including the leading dot, e.g. ".tsx" or "". */
+    ext: string;
+}
+export interface IgnoreOptions {
+    ignorePrefix: string;
+    ignoreDotFiles: boolean;
+    ignore: string[];
+}
+/** Split a file name into its base name and extension. */
+export declare function parseFileName(fileName: string): ParsedFileName;
+/** Whether a file base name represents an index route. */
+export declare function isIndexName(name: string): boolean;
+/**
+ * Convert a raw file/directory name into a route segment using the given
+ * formatter. "[id]" -> formatter.dynamic("id"), "[...rest]" ->
+ * formatter.catchAll("rest"), and anything else is passed through.
+ */
+export declare function toRouteSegment(name: string, formatter: PathFormatter): string;
+/** Whether a file/directory name should be skipped based on the ignore options. */
+export declare function isIgnoredName(fileName: string, options: IgnoreOptions): boolean;
+/** Whether a file has one of the supported extensions. */
+export declare function isSupportedFile(fileName: string, extensions: string[]): boolean;
+//# sourceMappingURL=scanner.d.ts.map

package/dist/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../src/scanner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,cAAc;IAC7B,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;IACxB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,0DAA0D;AAC1D,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAI9D;AAED,0DAA0D;AAC1D,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,GAAG,MAAM,CAO7E;AAED,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAI/E;AAED,0DAA0D;AAC1D,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAE/E"}

package/dist/scanner.js

@@ -0,0 +1,38 @@
+/** Split a file name into its base name and extension. */
+export function parseFileName(fileName) {
+    const dot = fileName.lastIndexOf(".");
+    if (dot <= 0)
+        return { name: fileName, ext: "" };
+    return { name: fileName.slice(0, dot), ext: fileName.slice(dot) };
+}
+/** Whether a file base name represents an index route. */
+export function isIndexName(name) {
+    return name === "index";
+}
+/**
+ * Convert a raw file/directory name into a route segment using the given
+ * formatter. "[id]" -> formatter.dynamic("id"), "[...rest]" ->
+ * formatter.catchAll("rest"), and anything else is passed through.
+ */
+export function toRouteSegment(name, formatter) {
+    if (name.startsWith("[") && name.endsWith("]")) {
+        const inner = name.slice(1, -1);
+        if (inner.startsWith("..."))
+            return formatter.catchAll(inner.slice(3));
+        return formatter.dynamic(inner);
+    }
+    return name;
+}
+/** Whether a file/directory name should be skipped based on the ignore options. */
+export function isIgnoredName(fileName, options) {
+    if (options.ignorePrefix && fileName.startsWith(options.ignorePrefix))
+        return true;
+    if (options.ignoreDotFiles && fileName.startsWith("."))
+        return true;
+    return options.ignore.includes(fileName);
+}
+/** Whether a file has one of the supported extensions. */
+export function isSupportedFile(fileName, extensions) {
+    return extensions.includes(parseFileName(fileName).ext);
+}
+//# sourceMappingURL=scanner.js.map

package/dist/scanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.js","sourceRoot":"","sources":["../src/scanner.ts"],"names":[],"mappings":"AAeA,0DAA0D;AAC1D,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC5C,MAAM,GAAG,GAAG,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACtC,IAAI,GAAG,IAAI,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC;IACjD,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;AACpE,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,IAAI,KAAK,OAAO,CAAC;AAC1B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,SAAwB;IACnE,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAChC,IAAI,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACvE,OAAO,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,aAAa,CAAC,QAAgB,EAAE,OAAsB;IACpE,IAAI,OAAO,CAAC,YAAY,IAAI,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,YAAY,CAAC;QAAE,OAAO,IAAI,CAAC;IACnF,IAAI,OAAO,CAAC,cAAc,IAAI,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACpE,OAAO,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAC3C,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,UAAoB;IACpE,OAAO,UAAU,CAAC,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC;AAC1D,CAAC"}

package/dist/tree.d.ts

@@ -0,0 +1,11 @@
+import type { ResolvedConfig, RouteNode } from "./types.js";
+/** Join a base route path with a segment, normalizing the leading slash. */
+export declare function joinPath(base: string, segment: string): string;
+/**
+ * Recursively scan a pages directory and build the route tree.
+ * Directories define hierarchy, index files define the directory's page,
+ * layout (and other mapped functions) are attached as add-ons, and other
+ * files become leaf routes.
+ */
+export declare function scanDirectory(pages: string, config: ResolvedConfig): RouteNode[];
+//# sourceMappingURL=tree.d.ts.map

package/dist/tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["../src/tree.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAS5D,4EAA4E;AAC5E,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAG9D;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,SAAS,EAAE,CAEhF"}