@zphhpzzph/vue-route-gen 1.1.0 → 2.0.0

package/dist/extract-meta.js

@@ -1,48 +1,137 @@
 import fs from 'node:fs';
 import { parse } from '@vue/compiler-sfc';
 /**
- * Parse Vue SFC and extract metadata from <route> custom block
+ * Parse Vue SFC and extract complete route configuration
+ * Supports both <route> custom block and defineRoute() macro
+ *
+ * @param filePath - Path to the Vue SFC file
+ * @returns Route configuration override, or undefined if no custom config
+ * @throws Error if both <route> block and defineRoute() are present
  */
-export function extractRouteMeta(filePath) {
+export function extractRouteConfig(filePath) {
     try {
         const content = fs.readFileSync(filePath, 'utf-8');
         const { descriptor } = parse(content);
-        // Find the <route> custom block
-        const routeBlock = descriptor.customBlocks.find((block) => block.type === 'route');
-        if (!routeBlock) {
-            return {};
+        // Detect conflict between <route> block and defineRoute()
+        const hasRouteBlock = descriptor.customBlocks.some((b) => b.type === 'route');
+        const hasDefineRoute = descriptor.scriptSetup?.content.includes('defineRoute');
+        if (hasRouteBlock && hasDefineRoute) {
+            throw new Error(`[vue-route-gen] Error in ${filePath}:\n` +
+                'Cannot use both <route> custom block and defineRoute() macro.\n' +
+                'Please choose one method:\n' +
+                '  - Use <route> block in template section\n' +
+                '  - Use defineRoute() in <script setup>\n\n' +
+                'Example:\n' +
+                '  <route>{ "path": "/custom" }</route>\n' +
+                '  OR\n' +
+                '  <script setup>\n' +
+                '    defineRoute({ path: "/custom" })\n' +
+                '  </script>');
+        }
+        // Extract from <route> block
+        if (hasRouteBlock) {
+            const routeBlock = descriptor.customBlocks.find((b) => b.type === 'route');
+            return parseRouteConfig(routeBlock.content);
         }
-        // Parse the content of the <route> block
-        return parseRouteBlockContent(routeBlock.content);
+        // Extract from defineRoute() call
+        if (hasDefineRoute) {
+            const defineRouteCall = extractDefineRouteCall(descriptor.scriptSetup.content);
+            if (defineRouteCall) {
+                return evaluateDefineRouteCall(defineRouteCall, descriptor.scriptSetup.content);
+            }
+        }
+        return undefined;
+    }
+    catch (error) {
+        // Re-throw conflict errors as they are user errors
+        if (error instanceof Error && error.message.includes('Cannot use both')) {
+            throw error;
+        }
+        // Warn about other errors but don't fail the build
+        console.warn(`[vue-route-gen] Failed to extract route config from ${filePath}:`, error);
+        return undefined;
+    }
+}
+/**
+ * Parse Vue SFC and extract metadata from <route> custom block
+ * @deprecated Use extractRouteConfig() instead for full configuration support
+ */
+export function extractRouteMeta(filePath) {
+    try {
+        const config = extractRouteConfig(filePath);
+        return config?.meta ?? {};
     }
     catch (error) {
-        // If parsing fails, return empty meta
+        // If config extraction fails (e.g., conflict), return empty meta
         console.warn(`Failed to extract meta from ${filePath}:`, error);
         return {};
     }
 }
 /**
- * Parse the content of <route> custom block
- * The content should be valid JSON or JavaScript object literal
+ * Extract defineRoute() call content from script setup
  */
-function parseRouteBlockContent(content) {
+function extractDefineRouteCall(scriptContent) {
+    // Match: const xxx = defineRoute(...) or defineRoute(...)
+    // Support both variable assignment and direct call
+    const patterns = [
+        // const/let/var xxx = defineRoute(...)
+        /(?:const|let|var)\s+\w+\s*=\s*defineRoute\s*\(([\s\S]*?)\)\s*(?:;|$)/,
+        // Direct defineRoute(...) call
+        /defineRoute\s*\(([\s\S]*?)\)\s*(?:;|$)/,
+    ];
+    for (const pattern of patterns) {
+        const match = scriptContent.match(pattern);
+        if (match) {
+            return match[1];
+        }
+    }
+    return null;
+}
+/**
+ * Evaluate defineRoute() call content with constant replacement
+ * Phase 1 MVP: Simple evaluation without complex constant resolution
+ */
+function evaluateDefineRouteCall(callContent, scriptContent) {
+    try {
+        // Phase 1 MVP: Direct evaluation without constant replacement
+        // Future enhancement: Parse imports and replace constants
+        return parseRouteConfig(callContent);
+    }
+    catch (error) {
+        console.warn('[vue-route-gen] Failed to evaluate defineRoute() call:', error);
+        return undefined;
+    }
+}
+/**
+ * Parse route configuration from content
+ * Supports both JSON and JavaScript object literal syntax
+ */
+function parseRouteConfig(content) {
     const trimmed = content.trim();
     try {
         // Try parsing as JSON first
-        return JSON.parse(trimmed);
+        const parsed = JSON.parse(trimmed);
+        return parsed;
     }
     catch {
         // If JSON parsing fails, try evaluating as JavaScript object literal
         try {
             // Use Function constructor for safe evaluation
-            // This handles things like unquoted keys, trailing commas, etc.
             const fn = new Function(`return (${trimmed});`);
             return fn();
         }
         catch (error) {
-            console.warn('Failed to parse route block content:', error);
-            return {};
+            console.warn('[vue-route-gen] Failed to parse route config:', error);
+            return undefined;
         }
     }
 }
+/**
+ * Parse the content of <route> custom block
+ * The content should be valid JSON or JavaScript object literal
+ * @deprecated Use parseRouteConfig() instead
+ */
+function parseRouteBlockContent(content) {
+    return parseRouteConfig(content) ?? {};
+}
 //# sourceMappingURL=extract-meta.js.map

package/dist/extract-meta.js.map

@@ -1 +1 @@
-{"version":3,"file":"extract-meta.js","sourceRoot":"","sources":["../src/extract-meta.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAY1C;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACnD,MAAM,EAAE,UAAU,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;QAEtC,gCAAgC;QAChC,MAAM,UAAU,GAAG,UAAU,CAAC,YAAY,CAAC,IAAI,CAC7C,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,OAAO,CAClC,CAAC;QAEF,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,yCAAyC;QACzC,OAAO,sBAAsB,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IACpD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,sCAAsC;QACtC,OAAO,CAAC,IAAI,CAAC,+BAA+B,QAAQ,GAAG,EAAE,KAAK,CAAC,CAAC;QAChE,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,sBAAsB,CAAC,OAAe;IAC7C,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAE/B,IAAI,CAAC;QACH,4BAA4B;QAC5B,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,qEAAqE;QACrE,IAAI,CAAC;YACH,+CAA+C;YAC/C,gEAAgE;YAChE,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,WAAW,OAAO,IAAI,CAAC,CAAC;YAChD,OAAO,EAAE,EAAE,CAAC;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,sCAAsC,EAAE,KAAK,CAAC,CAAC;YAC5D,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;AACH,CAAC"}
+{"version":3,"file":"extract-meta.js","sourceRoot":"","sources":["../src/extract-meta.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAsB1C;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACnD,MAAM,EAAE,UAAU,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;QAEtC,0DAA0D;QAC1D,MAAM,aAAa,GAAG,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;QAC9E,MAAM,cAAc,GAAG,UAAU,CAAC,WAAW,EAAE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;QAE/E,IAAI,aAAa,IAAI,cAAc,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CACb,4BAA4B,QAAQ,KAAK;gBACvC,iEAAiE;gBACjE,6BAA6B;gBAC7B,6CAA6C;gBAC7C,6CAA6C;gBAC7C,YAAY;gBACZ,0CAA0C;gBAC1C,QAAQ;gBACR,oBAAoB;gBACpB,wCAAwC;gBACxC,aAAa,CAChB,CAAC;QACJ,CAAC;QAED,6BAA6B;QAC7B,IAAI,aAAa,EAAE,CAAC;YAClB,MAAM,UAAU,GAAG,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;YAC3E,OAAO,gBAAgB,CAAC,UAAW,CAAC,OAAO,CAAC,CAAC;QAC/C,CAAC;QAED,kCAAkC;QAClC,IAAI,cAAc,EAAE,CAAC;YACnB,MAAM,eAAe,GAAG,sBAAsB,CAAC,UAAU,CAAC,WAAY,CAAC,OAAO,CAAC,CAAC;YAChF,IAAI,eAAe,EAAE,CAAC;gBACpB,OAAO,uBAAuB,CAAC,eAAe,EAAE,UAAU,CAAC,WAAY,CAAC,OAAO,CAAC,CAAC;YACnF,CAAC;QACH,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,mDAAmD;QACnD,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC;YACxE,MAAM,KAAK,CAAC;QACd,CAAC;QACD,mDAAmD;QACnD,OAAO,CAAC,IAAI,CAAC,uDAAuD,QAAQ,GAAG,EAAE,KAAK,CAAC,CAAC;QACxF,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;QAC5C,OAAO,MAAM,EAAE,IAAI,IAAI,EAAE,CAAC;IAC5B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,iEAAiE;QACjE,OAAO,CAAC,IAAI,CAAC,+BAA+B,QAAQ,GAAG,EAAE,KAAK,CAAC,CAAC;QAChE,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,sBAAsB,CAAC,aAAqB;IACnD,0DAA0D;IAC1D,mDAAmD;IACnD,MAAM,QAAQ,GAAG;QACf,uCAAuC;QACvC,sEAAsE;QACtE,+BAA+B;QAC/B,wCAAwC;KACzC,CAAC;IAEF,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC3C,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,SAAS,uBAAuB,CAAC,WAAmB,EAAE,aAAqB;IACzE,IAAI,CAAC;QACH,8DAA8D;QAC9D,0DAA0D;QAC1D,OAAO,gBAAgB,CAAC,WAAW,CAAC,CAAC;IACvC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,wDAAwD,EAAE,KAAK,CAAC,CAAC;QAC9E,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,gBAAgB,CAAC,OAAe;IACvC,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAE/B,IAAI,CAAC;QACH,4BAA4B;QAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACnC,OAAO,MAA6B,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,qEAAqE;QACrE,IAAI,CAAC;YACH,+CAA+C;YAC/C,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,WAAW,OAAO,IAAI,CAAC,CAAC;YAChD,OAAO,EAAE,EAAyB,CAAC;QACrC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,+CAA+C,EAAE,KAAK,CAAC,CAAC;YACrE,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,sBAAsB,CAAC,OAAe;IAC7C,OAAO,gBAAgB,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;AACzC,CAAC"}

package/dist/index.d.ts

@@ -1,5 +1,4 @@
-import { type RouteMeta } from './extract-meta.js';
-export type { RouteMeta } from './extract-meta.js';
+import { type RouteConfigOverride } from './extract-meta.js';
 export interface GenerateRoutesOptions {
     pagesDir?: string;
     outFile?: string;
@@ -10,7 +9,8 @@ export interface RouteEntry {
     importPath: string;
     children: RouteEntry[];
     params?: string[];
-    meta?: RouteMeta;
+    meta?: Record<string, any>;
+    configOverride?: RouteConfigOverride;
 }
 export interface RouteData {
     routes: RouteEntry[];
@@ -18,6 +18,11 @@ export interface RouteData {
     routePathList: readonly string[];
     routePathByName: [string, string][];
     routeParamsByName: [string, string[]][];
+    routeKeyData: Array<{
+        name: string;
+        path: string;
+        defaultName: string;
+    }>;
 }
 export declare function generateRoutes({ pagesDir, outFile, }?: GenerateRoutesOptions): boolean;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAoB,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAErE,YAAY,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAKnD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,eAAe,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;IACpC,iBAAiB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;CACzC;AAmhBD,wBAAgB,cAAc,CAAC,EAC7B,QAAmD,EACnD,OAAgE,GACjE,GAAE,qBAA0B,GAAG,OAAO,CAiCtC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAwC,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAyDnG,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3B,cAAc,CAAC,EAAE,mBAAmB,CAAC;CACtC;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,eAAe,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;IACpC,iBAAiB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IACxC,YAAY,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC1E;AAgrBD,wBAAgB,cAAc,CAAC,EAC7B,QAAmD,EACnD,OAAgE,GACjE,GAAE,qBAA0B,GAAG,OAAO,CAiCtC"}

package/dist/index.js

@@ -1,8 +1,54 @@
 import fs from 'node:fs';
 import path from 'node:path';
-import { extractRouteMeta } from './extract-meta.js';
+import { extractRouteMeta, extractRouteConfig } from './extract-meta.js';
 const EXCLUDED_DIRS = new Set(['components', 'hooks', 'services', 'types', 'constants', 'utils']);
 const CACHE_FILE = path.resolve(process.cwd(), 'node_modules/.cache/route-gen.json');
+/**
+ * Convert a value to its TypeScript literal type representation
+ * Generates precise literal types instead of wide types like string/boolean
+ */
+function valueToLiteralType(value) {
+    if (value === null) {
+        return 'null';
+    }
+    if (value === undefined) {
+        return 'undefined';
+    }
+    const valueType = typeof value;
+    // Handle primitive types with literal values
+    if (valueType === 'string') {
+        return JSON.stringify(value); // Returns "value" with quotes
+    }
+    if (valueType === 'boolean') {
+        return value ? 'true' : 'false';
+    }
+    if (valueType === 'number') {
+        return value.toString();
+    }
+    // Handle arrays
+    if (Array.isArray(value)) {
+        if (value.length === 0) {
+            return '[]';
+        }
+        const elementType = value.map(v => valueToLiteralType(v)).join(' | ');
+        return `[${elementType}]`;
+    }
+    // Handle objects
+    if (valueType === 'object') {
+        const entries = Object.entries(value);
+        if (entries.length === 0) {
+            return '{}';
+        }
+        const fields = entries
+            .map(([key, val]) => {
+            const literalType = valueToLiteralType(val);
+            return `    ${key}: ${literalType}`;
+        })
+            .join(';\n');
+        return `{\n${fields}\n  }`;
+    }
+    return 'any';
+}
 function normalizePath(p) {
     return p.split(path.sep).join('/');
 }
@@ -97,6 +143,32 @@ function segmentsToPath(segments, leadingSlash) {
     }
     return cleaned;
 }
+/**
+ * Apply route configuration override to default route entry
+ * Merges user-provided config with auto-generated defaults
+ */
+function applyConfigOverride(route) {
+    if (!route.configOverride) {
+        return route;
+    }
+    const override = route.configOverride;
+    const merged = {
+        ...route,
+        // User config takes precedence
+        path: override.path ?? route.path,
+        name: override.name ?? route.name,
+        // component is always auto-generated from the file
+        importPath: route.importPath,
+    };
+    // Merge meta: user config overrides defaults
+    if (override.meta || route.meta) {
+        merged.meta = {
+            ...route.meta,
+            ...override.meta,
+        };
+    }
+    return merged;
+}
 function joinPaths(parent, child) {
     if (!child) {
         return parent || '/';
@@ -106,23 +178,82 @@ function joinPaths(parent, child) {
     }
     return `${parent.replace(/\/$/, '')}/${child}`.replace(/\/+/g, '/');
 }
+function renderMetaAsConst(meta, indent) {
+    const lines = [];
+    const nextIndent = `${indent}  `;
+    lines.push(`${indent}{`);
+    for (const [key, value] of Object.entries(meta)) {
+        if (typeof value === 'string') {
+            lines.push(`${nextIndent}${JSON.stringify(key)}: ${JSON.stringify(value)},`);
+        }
+        else if (typeof value === 'boolean') {
+            lines.push(`${nextIndent}${JSON.stringify(key)}: ${value},`);
+        }
+        else if (typeof value === 'number') {
+            lines.push(`${nextIndent}${JSON.stringify(key)}: ${value},`);
+        }
+        else if (Array.isArray(value)) {
+            const arrayStr = value.map(v => JSON.stringify(v)).join(', ');
+            lines.push(`${nextIndent}${JSON.stringify(key)}: [${arrayStr}],`);
+        }
+        else if (typeof value === 'object' && value !== null) {
+            lines.push(`${nextIndent}${JSON.stringify(key)}: ${JSON.stringify(value)},`);
+        }
+        else {
+            lines.push(`${nextIndent}${JSON.stringify(key)}: ${JSON.stringify(value)},`);
+        }
+    }
+    lines.push(`${indent}} as const`);
+    return lines.join('\n');
+}
 function renderRoute(route, indent = '  ') {
     const nextIndent = `${indent}  `;
     const lines = [];
+    // Apply configuration override
+    const finalRoute = applyConfigOverride(route);
+    const override = route.configOverride;
     lines.push(`${indent}{`);
-    lines.push(`${nextIndent}path: ${JSON.stringify(route.path)},`);
-    lines.push(`${nextIndent}name: ${JSON.stringify(route.name)},`);
-    lines.push(`${nextIndent}component: () => import(${JSON.stringify(route.importPath)}),`);
-    // Add meta if present
-    if (route.meta && Object.keys(route.meta).length > 0) {
-        lines.push(`${nextIndent}meta: ${JSON.stringify(route.meta)},`);
-    }
-    if (route.children.length === 0) {
+    lines.push(`${nextIndent}path: ${JSON.stringify(finalRoute.path)},`);
+    lines.push(`${nextIndent}name: ${JSON.stringify(finalRoute.name)},`);
+    lines.push(`${nextIndent}component: () => import(${JSON.stringify(finalRoute.importPath)}),`);
+    // Render additional RouteRecordRaw fields from override
+    if (override) {
+        if (override.alias !== undefined) {
+            if (Array.isArray(override.alias)) {
+                lines.push(`${nextIndent}alias: [${override.alias.map(a => JSON.stringify(a)).join(', ')}],`);
+            }
+            else {
+                lines.push(`${nextIndent}alias: ${JSON.stringify(override.alias)},`);
+            }
+        }
+        if (override.redirect !== undefined) {
+            lines.push(`${nextIndent}redirect: ${JSON.stringify(override.redirect)},`);
+        }
+        if (override.props !== undefined) {
+            if (typeof override.props === 'boolean') {
+                lines.push(`${nextIndent}props: ${override.props},`);
+            }
+            else if (typeof override.props === 'object') {
+                lines.push(`${nextIndent}props: ${JSON.stringify(override.props)},`);
+            }
+            else {
+                lines.push(`${nextIndent}props: ${override.props},`);
+            }
+        }
+        if (override.beforeEnter !== undefined) {
+            lines.push(`${nextIndent}beforeEnter: ${override.beforeEnter},`);
+        }
+    }
+    // Add meta if present (rendered as const for type inference)
+    if (finalRoute.meta && Object.keys(finalRoute.meta).length > 0) {
+        lines.push(`${nextIndent}meta: ${renderMetaAsConst(finalRoute.meta, nextIndent)},`);
+    }
+    if (finalRoute.children.length === 0) {
         lines.push(`${nextIndent}children: [],`);
     }
     else {
         lines.push(`${nextIndent}children: [`);
-        lines.push(route.children
+        lines.push(finalRoute.children
             .map((child) => renderRoute(child, `${nextIndent}  `))
             .join(',\n'));
         lines.push(`${nextIndent}],`);
@@ -205,22 +336,27 @@ function buildRoutes({ pagesDir, outFile }) {
     }
     const routeEntries = [];
     const standaloneRoutes = standalonePages.map((page) => {
-        const name = page.segments.join('-');
+        const defaultName = page.segments.join('-');
         const routePath = segmentsToPath(page.segments, true);
         const params = page.segments
             .map((s) => extractParamName(s))
             .filter((p) => p !== null);
-        routeEntries.push({ name, path: routePath, params });
-        // Extract meta from page component
+        // Extract config and meta from page component
         const fullPath = path.resolve(pagesDir, page.importPath.replace(/^\.\//, ''));
+        const configOverride = extractRouteConfig(fullPath);
         const meta = extractRouteMeta(fullPath);
+        // Apply config override to get the final name and path
+        const finalName = configOverride?.name ?? defaultName;
+        const finalPath = configOverride?.path ?? routePath;
+        routeEntries.push({ name: finalName, path: finalPath, params, defaultName });
         return {
             path: routePath,
-            name,
+            name: finalName, // Use overridden name
             importPath: page.importPath,
             children: [],
             params,
             meta,
+            configOverride,
         };
     });
     const layoutRoutes = Array.from(layoutGroups.entries())
@@ -234,26 +370,31 @@ function buildRoutes({ pagesDir, outFile }) {
         const layoutParams = layout.segments
             .map((s) => extractParamName(s))
             .filter((p) => p !== null);
-        routeEntries.push({ name: layoutName, path: layoutPath, params: layoutParams });
+        routeEntries.push({ name: layoutName, path: layoutPath, params: layoutParams, defaultName: layoutName });
         const children = sortedPages.map((page) => {
-            const name = page.segments.join('-');
+            const defaultName = page.segments.join('-');
             const relativeSegments = page.segments.slice(layout.segments.length);
             const childPath = segmentsToPath(relativeSegments, false);
             const fullPath = joinPaths(layoutPath, childPath);
             const params = relativeSegments
                 .map((s) => extractParamName(s))
                 .filter((p) => p !== null);
-            routeEntries.push({ name, path: fullPath, params });
-            // Extract meta from page component
+            // Extract config and meta from page component
             const pageFilePath = path.resolve(pagesDir, page.importPath.replace(/^\.\//, ''));
+            const configOverride = extractRouteConfig(pageFilePath);
             const meta = extractRouteMeta(pageFilePath);
+            // Apply config override to get the final name and path
+            const finalName = configOverride?.name ?? defaultName;
+            const finalPath = configOverride?.path ?? fullPath;
+            routeEntries.push({ name: finalName, path: finalPath, params, defaultName });
             return {
                 path: childPath,
-                name,
+                name: finalName, // Use overridden name
                 importPath: page.importPath,
                 children: [],
                 params,
                 meta,
+                configOverride,
             };
         });
         return {
@@ -283,16 +424,25 @@ function buildRoutes({ pagesDir, outFile }) {
         routePathList: uniquePaths,
         routePathByName,
         routeParamsByName: Array.from(paramsByName.entries()),
+        routeKeyData: routeEntries,
     };
 }
-function renderRoutesFile({ routes, routeNameList, routePathList, routePathByName, routeParamsByName }) {
+function renderRoutesFile({ routes, routeNameList, routePathList, routePathByName, routeParamsByName, routeKeyData }) {
     const lines = [];
     const pathByName = new Map(routePathByName);
     const paramsByName = new Map(routeParamsByName);
     const routeKeyEntries = [];
     const usedKeys = new Set();
+    // Build map of route entries by name for quick lookup
+    const entryMap = new Map();
+    for (const entry of routeKeyData) {
+        entryMap.set(entry.name, { name: entry.name, path: entry.path, defaultName: entry.defaultName });
+    }
     for (const name of routeNameList) {
-        const baseKey = toConstKey(name) || 'ROUTE';
+        const entry = entryMap.get(name);
+        if (!entry)
+            continue;
+        const baseKey = toConstKey(entry.defaultName) || 'ROUTE';
         let key = baseKey;
         let suffix = 1;
         while (usedKeys.has(key)) {
@@ -302,8 +452,9 @@ function renderRoutesFile({ routes, routeNameList, routePathList, routePathByNam
         usedKeys.add(key);
         routeKeyEntries.push({
             key,
-            name,
-            path: pathByName.get(name),
+            name: entry.name,
+            path: entry.path,
+            defaultName: entry.defaultName,
         });
     }
     lines.push('// This file is auto-generated by @zphhpzzph/vue-route-gen.');
@@ -366,6 +517,43 @@ function renderRoutesFile({ routes, routeNameList, routePathList, routePathByNam
     lines.push('');
     lines.push('export type RouteParamsByName<T extends RouteName> = RouteParams[T];');
     lines.push('');
+    // Collect all unique meta keys across all routes
+    const allMetaKeys = new Set();
+    for (const route of routes) {
+        if (route.meta) {
+            Object.keys(route.meta).forEach(key => allMetaKeys.add(key));
+        }
+    }
+    const sortedMetaKeys = Array.from(allMetaKeys).sort();
+    // Generate route meta types with literal types
+    lines.push('// Route metadata types (extracted from <route> blocks)');
+    lines.push('// Uses literal types for precise type inference');
+    lines.push('// Missing fields are typed as undefined to ensure consistent shape');
+    lines.push('export interface RouteMetaMap {');
+    for (const route of routes) {
+        const routeName = route.name;
+        const meta = route.meta || {};
+        // Generate type definition with all possible fields
+        // Missing fields are typed as undefined
+        const metaFields = sortedMetaKeys
+            .map((key) => {
+            if (key in meta) {
+                const literalType = valueToLiteralType(meta[key]);
+                return `    ${key}: ${literalType};`;
+            }
+            else {
+                return `    ${key}: undefined;`;
+            }
+        })
+            .join('\n');
+        lines.push(`  '${routeName}': {`);
+        lines.push(metaFields);
+        lines.push(`  };`);
+    }
+    lines.push('}');
+    lines.push('');
+    lines.push('export type RouteMetaByName<T extends RouteName> = RouteMetaMap[T];');
+    lines.push('');
     lines.push('export const routes = [');
     lines.push(routes.map((route) => renderRoute(route)).join(',\n'));
     lines.push('] satisfies RouteRecordRaw[];');
@@ -379,19 +567,21 @@ function renderRoutesFile({ routes, routeNameList, routePathList, routePathByNam
     // Generate useRoute with proper types
     lines.push('/**');
     lines.push(' * Type-safe useRoute hook');
-    lines.push(' * Route params are typed based on the current route name');
+    lines.push(' * Route params and meta are typed based on the current route name');
     lines.push(' *');
     lines.push(' * @example');
     lines.push(' * ```ts');
     lines.push(' * const route = useRoute();');
     lines.push(' * // route.params.id is typed as string if route has :id param');
+    lines.push(' * // route.meta.title is typed based on the route\'s <route> block');
     lines.push(' * ```');
     lines.push(' */');
     lines.push('export function useRoute<TName extends RouteName = RouteName>(');
     lines.push('  name?: TName');
-    lines.push('): Omit<RouteLocationNormalizedLoaded, \'params\' | \'name\'> & {');
+    lines.push('): Omit<RouteLocationNormalizedLoaded, \'params\' | \'name\' | \'meta\'> & {');
     lines.push('  name: TName;');
     lines.push('  params: TName extends keyof RouteParams ? RouteParams[TName] : RouteParams[RouteName];');
+    lines.push('  meta: TName extends keyof RouteMetaMap ? RouteMetaMap[TName] : RouteMetaMap[RouteName];');
     lines.push('} {');
     lines.push('  return vueUseRoute() as any;');
     lines.push('}');