@chuckcchen/vite-plugin 1.0.15 → 1.0.17

package/dist/route/regex.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Route Regex - Convert dynamic routes to regular expressions
+ *
+ * This module provides utilities to convert dynamic route paths from various
+ * framework syntaxes into regular expression patterns for route matching.
+ */
+import type { RouteInfo, MetaRouteInfo } from "../types.js";
+/**
+ * Route parameter syntax types
+ *
+ * - "colon": :param style (React Router, Remix, Express, Vue Router)
+ * - "dollar": $param style (TanStack Start)
+ * - "bracket": [param] style (Next.js, Nuxt, SvelteKit)
+ * - "auto": Auto-detect based on route path
+ */
+export type RouteSyntax = "colon" | "dollar" | "bracket" | "auto";
+/**
+ * Options for converting route path to regex
+ */
+export interface RouteToRegexOptions {
+    /** Route parameter syntax to use for parsing. Default: "auto" (auto-detect) */
+    syntax?: RouteSyntax;
+    /** Whether to make the trailing slash optional. Default: true */
+    trailingSlashOptional?: boolean;
+    /** Whether to anchor the regex at start and end. Default: true */
+    anchored?: boolean;
+}
+/**
+ * Check if a route path contains dynamic segments
+ *
+ * Detects patterns from multiple syntaxes:
+ * - Colon syntax: :param, :param?, * (React Router, Remix, Express)
+ * - Dollar syntax: $param, $ (TanStack Start)
+ * - Bracket syntax: [param], [[param]], [...param] (Next.js, Nuxt, SvelteKit)
+ */
+export declare function isDynamicRoute(routePath: string): boolean;
+/**
+ * Convert a route path to a regular expression pattern
+ *
+ * Supports multiple route parameter syntaxes:
+ *
+ * **Colon syntax** (React Router, Remix, Express, Vue Router):
+ * - `:slug` → `([^/]+)` - Required dynamic parameter
+ * - `:slug?` → `([^/]+)?` - Optional dynamic parameter
+ * - `*` → `(.*)` - Wildcard/splat (catches everything)
+ *
+ * **Dollar syntax** (TanStack Start):
+ * - `$slug` → `([^/]+)` - Required dynamic parameter
+ * - `$` (at end) → `(.*)` - Wildcard/splat
+ *
+ * **Bracket syntax** (Next.js, Nuxt, SvelteKit):
+ * - `[slug]` → `([^/]+)` - Required dynamic parameter
+ * - `[[slug]]` → `([^/]+)?` - Optional dynamic parameter
+ * - `[...slug]` → `(.*)` - Catch-all
+ * - `[[...slug]]` → `(.*)?` - Optional catch-all
+ *
+ * @example
+ * // Colon syntax
+ * routeToRegex("/blog/:slug") // "^/blog/([^/]+)/?$"
+ * routeToRegex("/files/*") // "^/files(?:/(.*))?$"
+ *
+ * // Dollar syntax
+ * routeToRegex("/blog/$slug") // "^/blog/([^/]+)/?$"
+ * routeToRegex("/files/$") // "^/files(?:/(.*))?$"
+ *
+ * // Bracket syntax
+ * routeToRegex("/blog/[slug]") // "^/blog/([^/]+)/?$"
+ * routeToRegex("/files/[...path]") // "^/files(?:/(.*))?$"
+ */
+export declare function routeToRegex(routePath: string, options?: RouteToRegexOptions): string;
+/**
+ * Add regex patterns to routes that contain dynamic segments
+ *
+ * This function processes an array of RouteInfo and adds the `regex` field
+ * to routes that contain dynamic parameters.
+ *
+ * @param routes - Array of route info objects
+ * @param options - Options for regex conversion
+ * @returns Routes with regex patterns added where applicable
+ */
+export declare function addRegexToRoutes(routes: RouteInfo[], options?: RouteToRegexOptions): RouteInfo[];
+/**
+ * Convert routes to simplified meta.json format
+ *
+ * This function converts RouteInfo array to MetaRouteInfo array,
+ * keeping only `regexPath` and `isStatic` fields for EdgeOne runtime.
+ *
+ * - Dynamic routes (with parameters like :id, $id, [id]) are converted to regex patterns
+ * - Static routes keep their original path without conversion
+ *
+ * @param routes - Array of route info objects
+ * @param options - Options for regex conversion
+ * @returns Simplified routes for meta.json
+ */
+export declare function convertRoutesToMetaFormat(routes: RouteInfo[], options?: RouteToRegexOptions): MetaRouteInfo[];
+//# sourceMappingURL=regex.d.ts.map

package/dist/route/regex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"regex.d.ts","sourceRoot":"","sources":["../../src/route/regex.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAM5D;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;AAElE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,+EAA+E;IAC/E,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,iEAAiE;IACjE,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,kEAAkE;IAClE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAMD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAUzD;AAsBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,mBAAwB,GAChC,MAAM,CA2CR;AAoFD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,SAAS,EAAE,EACnB,OAAO,GAAE,mBAAwB,GAChC,SAAS,EAAE,CAeb;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,SAAS,EAAE,EACnB,OAAO,GAAE,mBAAwB,GAChC,aAAa,EAAE,CAmBjB"}

package/dist/route/regex.js

@@ -0,0 +1,244 @@
+/**
+ * Route Regex - Convert dynamic routes to regular expressions
+ *
+ * This module provides utilities to convert dynamic route paths from various
+ * framework syntaxes into regular expression patterns for route matching.
+ */
+// ============================================================================
+// Dynamic Route Detection
+// ============================================================================
+/**
+ * Check if a route path contains dynamic segments
+ *
+ * Detects patterns from multiple syntaxes:
+ * - Colon syntax: :param, :param?, * (React Router, Remix, Express)
+ * - Dollar syntax: $param, $ (TanStack Start)
+ * - Bracket syntax: [param], [[param]], [...param] (Next.js, Nuxt, SvelteKit)
+ */
+export function isDynamicRoute(routePath) {
+    // Colon syntax: :param or :param?
+    if (/:[\w]+\??/.test(routePath))
+        return true;
+    // Dollar syntax: $param or lone $
+    if (/\$[\w]*/.test(routePath))
+        return true;
+    // Bracket syntax: [param], [[param]], [...param]
+    if (/\[{1,2}\.{0,3}[\w]+\]{1,2}/.test(routePath))
+        return true;
+    // Wildcard: *
+    if (/\*/.test(routePath))
+        return true;
+    return false;
+}
+/**
+ * Detect route syntax from route path
+ */
+function detectRouteSyntax(routePath) {
+    // Dollar syntax: $param style
+    if (/\$[\w]+/.test(routePath) || /\/\$$/.test(routePath)) {
+        return "dollar";
+    }
+    // Bracket syntax: [param] style
+    if (/\[{1,2}\.{0,3}[\w]+\]{1,2}/.test(routePath)) {
+        return "bracket";
+    }
+    // Colon syntax: :param style (default)
+    return "colon";
+}
+// ============================================================================
+// Route to Regex Conversion
+// ============================================================================
+/**
+ * Convert a route path to a regular expression pattern
+ *
+ * Supports multiple route parameter syntaxes:
+ *
+ * **Colon syntax** (React Router, Remix, Express, Vue Router):
+ * - `:slug` → `([^/]+)` - Required dynamic parameter
+ * - `:slug?` → `([^/]+)?` - Optional dynamic parameter
+ * - `*` → `(.*)` - Wildcard/splat (catches everything)
+ *
+ * **Dollar syntax** (TanStack Start):
+ * - `$slug` → `([^/]+)` - Required dynamic parameter
+ * - `$` (at end) → `(.*)` - Wildcard/splat
+ *
+ * **Bracket syntax** (Next.js, Nuxt, SvelteKit):
+ * - `[slug]` → `([^/]+)` - Required dynamic parameter
+ * - `[[slug]]` → `([^/]+)?` - Optional dynamic parameter
+ * - `[...slug]` → `(.*)` - Catch-all
+ * - `[[...slug]]` → `(.*)?` - Optional catch-all
+ *
+ * @example
+ * // Colon syntax
+ * routeToRegex("/blog/:slug") // "^/blog/([^/]+)/?$"
+ * routeToRegex("/files/*") // "^/files(?:/(.*))?$"
+ *
+ * // Dollar syntax
+ * routeToRegex("/blog/$slug") // "^/blog/([^/]+)/?$"
+ * routeToRegex("/files/$") // "^/files(?:/(.*))?$"
+ *
+ * // Bracket syntax
+ * routeToRegex("/blog/[slug]") // "^/blog/([^/]+)/?$"
+ * routeToRegex("/files/[...path]") // "^/files(?:/(.*))?$"
+ */
+export function routeToRegex(routePath, options = {}) {
+    const { syntax = "auto", trailingSlashOptional = true, anchored = true, } = options;
+    // Determine which syntax to use
+    const effectiveSyntax = syntax === "auto" ? detectRouteSyntax(routePath) : syntax;
+    // Escape special regex characters (except those we'll handle)
+    let pattern = routePath.replace(/[.+^${}()|[\]\\]/g, "\\$&");
+    // Handle syntax-specific patterns
+    switch (effectiveSyntax) {
+        case "dollar":
+            pattern = convertDollarSyntax(pattern);
+            break;
+        case "bracket":
+            pattern = convertBracketSyntax(pattern);
+            break;
+        case "colon":
+        default:
+            pattern = convertColonSyntax(pattern);
+            break;
+    }
+    // Add trailing slash handling
+    if (trailingSlashOptional && !pattern.endsWith(")?$") && !pattern.endsWith(")?")) {
+        pattern = pattern + "/?";
+    }
+    // Add anchors
+    if (anchored) {
+        if (!pattern.startsWith("^")) {
+            pattern = "^" + pattern;
+        }
+        if (!pattern.endsWith("$")) {
+            pattern = pattern + "$";
+        }
+    }
+    return pattern;
+}
+// ============================================================================
+// Syntax Converters
+// ============================================================================
+/**
+ * Convert colon syntax patterns (:param)
+ * Used by: React Router, Remix, Express, Vue Router
+ * - :param → ([^/]+)
+ * - :param? → ([^/]+)?
+ * - * → (.*)
+ */
+function convertColonSyntax(pattern) {
+    // Handle wildcard * at the end (splat route)
+    // /files/* → /files(?:/(.*))?
+    // Note: * is NOT escaped by the caller, so we match literal *
+    if (/\/\*$/.test(pattern) || pattern === "*") {
+        pattern = pattern.replace(/\/?\*$/, "(?:/(.*))?");
+    }
+    else if (/\*/.test(pattern)) {
+        // Handle inline * (rare but possible)
+        pattern = pattern.replace(/\*/g, "(.*)");
+    }
+    // Handle optional parameters :param?
+    pattern = pattern.replace(/:(\w+)\?/g, "([^/]+)?");
+    // Handle required parameters :param
+    pattern = pattern.replace(/:(\w+)/g, "([^/]+)");
+    return pattern;
+}
+/**
+ * Convert dollar syntax patterns ($param)
+ * Used by: TanStack Start
+ * - $param → ([^/]+)
+ * - $ (at end, lone) → (.*)
+ */
+function convertDollarSyntax(pattern) {
+    // Handle splat $ at the end: /files/$ → /files(?:/(.*))?
+    // Match /$ at end or lone $
+    if (pattern.endsWith("/\\$") || pattern === "\\$") {
+        pattern = pattern.replace(/\/?\\\$$/, "(?:/(.*))?");
+    }
+    else if (pattern.endsWith("\\$")) {
+        // Handle $ at end without leading slash
+        pattern = pattern.replace(/\\\$$/, "(?:/(.*))?");
+    }
+    // Handle named parameters $param (not lone $)
+    // Must be careful not to match already-converted patterns
+    pattern = pattern.replace(/\\\$(\w+)/g, "([^/]+)");
+    return pattern;
+}
+/**
+ * Convert bracket syntax patterns ([param])
+ * Used by: Next.js, Nuxt, SvelteKit
+ * - [param] → ([^/]+)
+ * - [[param]] → ([^/]+)?
+ * - [...param] → (.*)
+ * - [[...param]] → (.*)?
+ */
+function convertBracketSyntax(pattern) {
+    // Handle optional catch-all [[...param]]
+    pattern = pattern.replace(/\\\[\\\[\\\.\\\.\\\.(\w+)\\\]\\\]/g, "(.*)?");
+    // Handle catch-all [...param]
+    pattern = pattern.replace(/\\\[\\\.\\\.\\\.(\w+)\\\]/g, "(?:/(.*))?");
+    // Handle optional dynamic [[param]]
+    pattern = pattern.replace(/\\\[\\\[(\w+)\\\]\\\]/g, "([^/]+)?");
+    // Handle required dynamic [param]
+    pattern = pattern.replace(/\\\[(\w+)\\\]/g, "([^/]+)");
+    return pattern;
+}
+// ============================================================================
+// Route Array Utilities
+// ============================================================================
+/**
+ * Add regex patterns to routes that contain dynamic segments
+ *
+ * This function processes an array of RouteInfo and adds the `regex` field
+ * to routes that contain dynamic parameters.
+ *
+ * @param routes - Array of route info objects
+ * @param options - Options for regex conversion
+ * @returns Routes with regex patterns added where applicable
+ */
+export function addRegexToRoutes(routes, options = {}) {
+    return routes.map(route => {
+        // Use srcRoute if available, otherwise use path
+        const routePath = route.srcRoute || route.path;
+        // Only add regex for dynamic routes
+        if (isDynamicRoute(routePath)) {
+            return {
+                ...route,
+                regex: routeToRegex(routePath, options),
+            };
+        }
+        return route;
+    });
+}
+/**
+ * Convert routes to simplified meta.json format
+ *
+ * This function converts RouteInfo array to MetaRouteInfo array,
+ * keeping only `regexPath` and `isStatic` fields for EdgeOne runtime.
+ *
+ * - Dynamic routes (with parameters like :id, $id, [id]) are converted to regex patterns
+ * - Static routes keep their original path without conversion
+ *
+ * @param routes - Array of route info objects
+ * @param options - Options for regex conversion
+ * @returns Simplified routes for meta.json
+ */
+export function convertRoutesToMetaFormat(routes, options = {}) {
+    return routes.map(route => {
+        // Use srcRoute if available, otherwise use path
+        const routePath = route.srcRoute || route.path;
+        let regexPath;
+        if (isDynamicRoute(routePath)) {
+            // Dynamic route: convert to regex pattern
+            regexPath = routeToRegex(routePath, options);
+        }
+        else {
+            // Static route: keep original path, no conversion needed
+            regexPath = routePath;
+        }
+        return {
+            regexPath,
+            isStatic: route.isStatic,
+        };
+    });
+}
+//# sourceMappingURL=regex.js.map

package/dist/route/regex.js.map

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

package/dist/route/types.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Route Types - Type definitions for route parsing
+ */
+import type { RouteInfo } from "../types.js";
+/**
+ * Generic route node structure
+ */
+export interface RouteNode {
+    id: string;
+    path?: string;
+    index?: boolean;
+    parentId?: string;
+    children?: RouteNode[];
+    hasLoader?: boolean;
+    hasAction?: boolean;
+    hasClientLoader?: boolean;
+    hasClientAction?: boolean;
+    [key: string]: unknown;
+}
+/**
+ * Internal route info with additional properties for parsing
+ * This extends RouteInfo with optional properties used during route parsing
+ */
+export interface InternalRouteInfo extends RouteInfo {
+    /** Route identifier */
+    id?: string;
+    /** Full path including parent paths */
+    fullPath?: string;
+    /** Source file path */
+    filePath?: string;
+}
+/**
+ * Route parser configuration
+ */
+export interface RouteParserConfig {
+    /** Convert file path patterns to route paths (e.g., $id -> :id) */
+    paramPattern?: RegExp;
+    /** Replacement for param pattern */
+    paramReplacement?: string;
+    /** Index route file names */
+    indexFiles?: string[];
+    /** Layout/root route file names to skip */
+    layoutFiles?: string[];
+    /** File extensions to include */
+    extensions?: string[];
+}
+/**
+ * Route tree parser options
+ */
+export interface RouteTreeParserOptions {
+    /** Path pattern regex to extract routes */
+    pathPattern?: RegExp;
+    /** Full path pattern regex */
+    fullPathPattern?: RegExp;
+}
+/**
+ * Server build route source configuration
+ */
+export interface ServerBuildRouteSource {
+    type: "serverBuild";
+    /** Server entry path */
+    serverEntry: string;
+    /** Property path to routes object (e.g., "routes") */
+    routesProperty?: string;
+    /** Transform function for route nodes */
+    transform?: (routes: Record<string, RouteNode>) => RouteInfo[];
+}
+/**
+ * Route tree file source configuration
+ */
+export interface RouteTreeFileSource {
+    type: "routeTree";
+    /** Candidate paths for route tree file */
+    paths: string[];
+    /** Parser options */
+    parserOptions?: RouteTreeParserOptions;
+}
+/**
+ * Directory scan source configuration
+ */
+export interface DirectoryScanSource {
+    type: "directory";
+    /** Candidate directories to scan */
+    paths: string[];
+    /** Parser configuration */
+    config?: RouteParserConfig;
+}
+/**
+ * Route source configuration union type
+ */
+export type RouteSource = ServerBuildRouteSource | RouteTreeFileSource | DirectoryScanSource;
+/**
+ * Options for flattenRouteTree function
+ */
+export interface FlattenRouteTreeOptions {
+    /** Parent path prefix */
+    parentPath?: string;
+    /** Whether SSR mode is enabled */
+    isSSR?: boolean;
+    /** Whether SPA mode is enabled */
+    isSpaMode?: boolean;
+    /** Root route ID to skip (default: "root") */
+    skipRootId?: string;
+    /**
+     * Custom callback to generate additional routes for each route node.
+     * This allows framework-specific route generation (e.g., .data routes for React Router).
+     * Return an array of additional RouteInfo to add, or empty array for none.
+     */
+    onRouteProcessed?: (route: RouteNode, routePath: string, isStatic: boolean) => RouteInfo[];
+    /**
+     * Custom callback to determine if a route should be static.
+     * If not provided, uses default logic based on isSSR, isSpaMode, and client loaders.
+     */
+    isStaticRoute?: (route: RouteNode, isSSR: boolean, isSpaMode: boolean) => boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/route/types.d.ts.map

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

package/dist/route/types.js

@@ -0,0 +1,5 @@
+/**
+ * Route Types - Type definitions for route parsing
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/route/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/route/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/route-parser.d.ts

@@ -1,163 +1,8 @@
 /**
- * Route Parser - Common route parsing utilities for framework adapters
+ * Route Parser - Re-exports from route module
  *
- * This module provides reusable route parsing tools that can be used by
- * different framework adapters to extract and process route information.
+ * @deprecated Import from "./route/index.js" instead
+ * This file is kept for backward compatibility.
  */
-import type { RouteInfo, Logger } from "./types.js";
-/**
- * Generic route node structure
- */
-export interface RouteNode {
-    id: string;
-    path?: string;
-    index?: boolean;
-    parentId?: string;
-    children?: RouteNode[];
-    hasLoader?: boolean;
-    hasAction?: boolean;
-    hasClientLoader?: boolean;
-    hasClientAction?: boolean;
-    [key: string]: unknown;
-}
-/**
- * Route parser configuration
- */
-export interface RouteParserConfig {
-    /** Convert file path patterns to route paths (e.g., $id -> :id) */
-    paramPattern?: RegExp;
-    /** Replacement for param pattern */
-    paramReplacement?: string;
-    /** Index route file names */
-    indexFiles?: string[];
-    /** Layout/root route file names to skip */
-    layoutFiles?: string[];
-    /** File extensions to include */
-    extensions?: string[];
-}
-/**
- * Route tree parser options
- */
-export interface RouteTreeParserOptions {
-    /** Path pattern regex to extract routes */
-    pathPattern?: RegExp;
-    /** Full path pattern regex */
-    fullPathPattern?: RegExp;
-}
-/**
- * Server build route source configuration
- */
-export interface ServerBuildRouteSource {
-    type: "serverBuild";
-    /** Server entry path */
-    serverEntry: string;
-    /** Property path to routes object (e.g., "routes") */
-    routesProperty?: string;
-    /** Transform function for route nodes */
-    transform?: (routes: Record<string, RouteNode>) => RouteInfo[];
-}
-/**
- * Route tree file source configuration
- */
-export interface RouteTreeFileSource {
-    type: "routeTree";
-    /** Candidate paths for route tree file */
-    paths: string[];
-    /** Parser options */
-    parserOptions?: RouteTreeParserOptions;
-}
-/**
- * Directory scan source configuration
- */
-export interface DirectoryScanSource {
-    type: "directory";
-    /** Candidate directories to scan */
-    paths: string[];
-    /** Parser configuration */
-    config?: RouteParserConfig;
-}
-/**
- * Route source configuration union type
- */
-export type RouteSource = ServerBuildRouteSource | RouteTreeFileSource | DirectoryScanSource;
-/**
- * Parse routes from route tree file content
- */
-export declare function parseRouteTreeContent(content: string, options?: RouteTreeParserOptions): InternalRouteInfo[];
-/**
- * Load and parse route tree from file
- */
-export declare function parseRouteTreeFile(projectRoot: string, candidatePaths: string[], options?: RouteTreeParserOptions, logger?: Logger): Promise<InternalRouteInfo[]>;
-/**
- * Scan directory for route files
- */
-export declare function scanRoutesDirectory(dir: string, basePath?: string, config?: RouteParserConfig): Promise<InternalRouteInfo[]>;
-/**
- * Scan multiple candidate directories for routes
- */
-export declare function scanRoutesFromDirectories(projectRoot: string, candidateDirs: string[], config?: RouteParserConfig, logger?: Logger): Promise<InternalRouteInfo[]>;
-/**
- * Load server build module and extract routes
- */
-export declare function loadServerBuildRoutes<T = unknown>(serverEntryPath: string, logger?: Logger): Promise<T | null>;
-/**
- * Options for flattenRouteTree function
- */
-export interface FlattenRouteTreeOptions {
-    /** Parent path prefix */
-    parentPath?: string;
-    /** Whether SSR mode is enabled */
-    isSSR?: boolean;
-    /** Whether SPA mode is enabled */
-    isSpaMode?: boolean;
-    /** Root route ID to skip (default: "root") */
-    skipRootId?: string;
-    /**
-     * Custom callback to generate additional routes for each route node.
-     * This allows framework-specific route generation (e.g., .data routes for React Router).
-     * Return an array of additional RouteInfo to add, or empty array for none.
-     */
-    onRouteProcessed?: (route: RouteNode, routePath: string, isStatic: boolean) => RouteInfo[];
-    /**
-     * Custom callback to determine if a route should be static.
-     * If not provided, uses default logic based on isSSR, isSpaMode, and client loaders.
-     */
-    isStaticRoute?: (route: RouteNode, isSSR: boolean, isSpaMode: boolean) => boolean;
-}
-/**
- * Flatten nested route tree to flat route list
- *
- * This is a generic utility that works with any route tree structure.
- * Framework-specific behavior (like generating .data routes) should be
- * implemented via the onRouteProcessed callback.
- */
-export declare function flattenRouteTree(routes: Record<string, RouteNode>, options?: FlattenRouteTreeOptions): RouteInfo[];
-/**
- * Parse routes from multiple sources with fallback
- */
-export declare function parseRoutesFromSources(projectRoot: string, sources: RouteSource[], options?: {
-    isSSR?: boolean;
-    logger?: Logger;
-}): Promise<RouteInfo[]>;
-/**
- * Internal route info with additional properties for parsing
- * This extends RouteInfo with optional properties used during route parsing
- */
-export interface InternalRouteInfo extends RouteInfo {
-    /** Route identifier */
-    id?: string;
-    /** Full path including parent paths */
-    fullPath?: string;
-    /** Source file path */
-    filePath?: string;
-}
-/**
- * Convert internal route info to standard RouteInfo
- * Strips internal-only properties
- */
-export declare function toRouteInfo(internal: InternalRouteInfo): RouteInfo;
-/**
- * Convert array of internal route info to standard RouteInfo array
- */
-export declare function toRouteInfoArray(internals: InternalRouteInfo[]): RouteInfo[];
+export * from "./route/index.js";
 //# sourceMappingURL=route-parser.d.ts.map

package/dist/route-parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"route-parser.d.ts","sourceRoot":"","sources":["../src/route-parser.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"route-parser.d.ts","sourceRoot":"","sources":["../src/route-parser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,kBAAkB,CAAC"}