@chuckcchen/vite-plugin 1.0.16 → 1.0.17

package/dist/route-parser.d.ts

@@ -1,232 +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";
-/**
- * Framework route syntax types
- */
-export type FrameworkSyntax = "react-router" | "tanstack-start" | "nextjs" | "auto";
-/**
- * Options for converting route path to regex
- */
-export interface RouteToRegexOptions {
-    /** Framework syntax to use for parsing. Default: "auto" (auto-detect) */
-    syntax?: FrameworkSyntax;
-    /** 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 frameworks:
- * - React Router: :param, :param?, *
- * - TanStack Start: $param, $
- * - Next.js: [param], [[param]], [...param]
- */
-export declare function isDynamicRoute(routePath: string): boolean;
-/**
- * Convert a route path to a regular expression pattern
- *
- * Supports multiple framework syntaxes:
- *
- * **React Router:**
- * - `:slug` → `([^/]+)` - Required dynamic parameter
- * - `:slug?` → `([^/]+)?` - Optional dynamic parameter
- * - `*` → `(.*)` - Wildcard/splat (catches everything)
- *
- * **TanStack Start:**
- * - `$slug` → `([^/]+)` - Required dynamic parameter
- * - `$` (at end) → `(.*)` - Wildcard/splat
- *
- * **Next.js:**
- * - `[slug]` → `([^/]+)` - Required dynamic parameter
- * - `[[slug]]` → `([^/]+)?` - Optional dynamic parameter
- * - `[...slug]` → `(.*)` - Catch-all
- * - `[[...slug]]` → `(.*)?` - Optional catch-all
- *
- * @example
- * // React Router
- * routeToRegex("/blog/:slug") // "^/blog/([^/]+)/?$"
- * routeToRegex("/files/*") // "^/files(?:/(.*))?$"
- *
- * // TanStack Start
- * routeToRegex("/blog/$slug") // "^/blog/([^/]+)/?$"
- * routeToRegex("/files/$") // "^/files(?:/(.*))?$"
- *
- * // Next.js
- * 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[];
-/**
- * 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"}