@kimesh/kit 0.2.7 → 0.2.8-nightly.20260124084153

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 import { Hookable } from "hookable";
 import { Ignore } from "ignore";
-import * as vite0 from "vite";
+import * as vite3 from "vite";
 import { Plugin, Plugin as VitePlugin, PluginOption, PluginOption as VitePluginOption, ResolvedConfig, UserConfig, ViteDevServer } from "vite";
 import { KimeshLayerConfig, LayerAutoImportConfig, LayerComponentConfig, LayerComposableConfig, LayerRouteConfig, ResolvedLayer, ResolvedLayer as ResolvedLayer$1, generateLayerAliases, mergeLayerConfigs, prepareLayers, resolveLayers } from "@kimesh/layers";
 import { AutoImportConfig, ImportPreset, LayerAutoImportSource as ImportSource, buildImportRegistry, generateDts, kimeshAutoImport, scanExports } from "@kimesh/auto-import";
@@ -138,7 +138,7 @@ interface KimeshHooks {
   /** Called to extend Vite config before it's resolved */
   "vite:extend": (ctx: {
     kimesh: Kimesh;
-    config: vite0.UserConfig;
+    config: vite3.UserConfig;
   }) => HookResult;
   /** Called after Vite config is resolved */
   "vite:configResolved": (config: ResolvedConfig, kimesh: Kimesh) => HookResult;
@@ -414,10 +414,10 @@ interface KimeshModuleDefinition<TOptions = Record<string, unknown>> {
   /** Shorthand hook registration */
   hooks?: Partial<KimeshHooks>;
   /**
-       * Setup function called after layers are resolved
-       * @param options - Merged options (defaults + user config)
-       * @param kimesh - Kimesh context
-       */
+   * Setup function called after layers are resolved
+   * @param options - Merged options (defaults + user config)
+   * @param kimesh - Kimesh context
+   */
   setup?: (options: TOptions, kimesh: Kimesh) => void | Promise<void>;
 }
 /**
@@ -445,10 +445,10 @@ interface KimeshPluginDefinition {
   /** Plugin name */
   name: string;
   /**
-       * Setup function that returns Vite plugin(s)
-       * @param kimesh - Kimesh context
-       */
-  setup: (kimesh: Kimesh) => vite0.PluginOption | vite0.PluginOption[];
+   * Setup function that returns Vite plugin(s)
+   * @param kimesh - Kimesh context
+   */
+  setup: (kimesh: Kimesh) => vite3.PluginOption | vite3.PluginOption[];
 }
 interface KimeshPlugin {
   /** Plugin definition */
@@ -456,7 +456,7 @@ interface KimeshPlugin {
   /** Plugin name */
   name: string;
   /** Get Vite plugins */
-  getPlugins: (kimesh: Kimesh) => vite0.PluginOption[];
+  getPlugins: (kimesh: Kimesh) => vite3.PluginOption[];
 }
 //#endregion
 //#region src/types/config.d.ts
@@ -529,9 +529,9 @@ interface ComponentsConfig {
  */
 interface KimeshViteConfig extends Omit<UserConfig, "root" | "configFile"> {
   /**
-       * Additional Vite plugins.
-       * These are merged AFTER Kimesh's internal plugins.
-       */
+   * Additional Vite plugins.
+   * These are merged AFTER Kimesh's internal plugins.
+   */
   plugins?: PluginOption[];
 }
 /**
@@ -545,39 +545,39 @@ declare const DEFAULT_ALIASES: Record<string, string>;
  */
 interface DebugConfig {
   /**
-       * Log hook execution with timing information
-       * @default false
-       */
+   * Log hook execution with timing information
+   * @default false
+   */
   hooks?: boolean;
   /**
-       * Log module loading and setup
-       * @default false
-       */
+   * Log module loading and setup
+   * @default false
+   */
   modules?: boolean;
   /**
-       * Log layer resolution
-       * @default false
-       */
+   * Log layer resolution
+   * @default false
+   */
   layers?: boolean;
   /**
-       * Log configuration loading and merging
-       * @default false
-       */
+   * Log configuration loading and merging
+   * @default false
+   */
   config?: boolean;
   /**
-       * Log Vite plugin operations
-       * @default false
-       */
+   * Log Vite plugin operations
+   * @default false
+   */
   vite?: boolean;
   /**
-       * Log route generation
-       * @default false
-       */
+   * Log route generation
+   * @default false
+   */
   routes?: boolean;
   /**
-       * Log auto-import resolution
-       * @default false
-       */
+   * Log auto-import resolution
+   * @default false
+   */
   imports?: boolean;
 }
 /**
@@ -589,9 +589,9 @@ declare const DEFAULT_IGNORE_PATTERNS: string[];
  */
 interface IgnoreOptions {
   /**
-       * Whether matching is case-insensitive
-       * @default false
-       */
+   * Whether matching is case-insensitive
+   * @default false
+   */
   ignorecase?: boolean;
 }
 /**
@@ -615,42 +615,42 @@ interface IgnoreOptions {
  */
 interface RouteRule {
   /**
-       * Redirect to another path
-       * Can be a string path or an object with statusCode
-       */
+   * Redirect to another path
+   * Can be a string path or an object with statusCode
+   */
   redirect?: string | {
     to: string;
     statusCode?: 301 | 302 | 307 | 308;
   };
   /**
-       * Pre-render this route at build time (for static generation)
-       * @default false
-       */
+   * Pre-render this route at build time (for static generation)
+   * @default false
+   */
   prerender?: boolean;
   /**
-       * Cache configuration for this route
-       */
+   * Cache configuration for this route
+   */
   cache?: boolean | {
     /**
-             * Cache max age in seconds
-             */
+     * Cache max age in seconds
+     */
     maxAge?: number;
     /**
-             * Stale-while-revalidate in seconds
-             */
+     * Stale-while-revalidate in seconds
+     */
     swr?: number;
     /**
-             * Cache key modifiers
-             */
+     * Cache key modifiers
+     */
     varies?: string[];
   };
   /**
-       * Custom headers to set for this route
-       */
+   * Custom headers to set for this route
+   */
   headers?: Record<string, string>;
   /**
-       * CORS configuration for this route
-       */
+   * CORS configuration for this route
+   */
   cors?: boolean | {
     origin?: string | string[];
     methods?: string[];
@@ -658,8 +658,8 @@ interface RouteRule {
     credentials?: boolean;
   };
   /**
-       * Custom meta data for the route
-       */
+   * Custom meta data for the route
+   */
   meta?: Record<string, unknown>;
 }
 /**
@@ -668,24 +668,24 @@ interface RouteRule {
  */
 interface DirectoryConfig {
   /**
-       * Directory for static assets
-       * @default 'assets'
-       */
+   * Directory for static assets
+   * @default 'assets'
+   */
   assets?: string;
   /**
-       * Directory for runtime plugins
-       * @default 'plugins'
-       */
+   * Directory for runtime plugins
+   * @default 'plugins'
+   */
   plugins?: string;
   /**
-       * Directory for public static files
-       * @default 'public'
-       */
+   * Directory for public static files
+   * @default 'public'
+   */
   public?: string;
   /**
-       * Directory for shared code across the app
-       * @default 'shared'
-       */
+   * Directory for shared code across the app
+   * @default 'shared'
+   */
   shared?: string;
 }
 /**
@@ -693,19 +693,19 @@ interface DirectoryConfig {
  */
 interface AnalyzeConfig {
   /**
-       * Enable the bundle analyzer
-       * @default false
-       */
+   * Enable the bundle analyzer
+   * @default false
+   */
   enabled?: boolean;
   /**
-       * Automatically open analyzer report in browser
-       * @default false
-       */
+   * Automatically open analyzer report in browser
+   * @default false
+   */
   openAnalyzer?: boolean;
   /**
-       * Custom filename for the report
-       * @default 'report.html'
-       */
+   * Custom filename for the report
+   * @default 'report.html'
+   */
   reportFilename?: string;
 }
 /**
@@ -714,48 +714,48 @@ interface AnalyzeConfig {
  */
 interface BuildConfig {
   /**
-       * Enable bundle analysis. Shows a visualization of bundle contents.
-       *
-       * @example
-       * ```ts
-       * build: {
-       *   analyze: true,
-       *   // or with options:
-       *   analyze: {
-       *     enabled: true,
-       *     openAnalyzer: false,
-       *     reportFilename: 'stats.html',
-       *   },
-       * }
-       * ```
-       */
+   * Enable bundle analysis. Shows a visualization of bundle contents.
+   *
+   * @example
+   * ```ts
+   * build: {
+   *   analyze: true,
+   *   // or with options:
+   *   analyze: {
+   *     enabled: true,
+   *     openAnalyzer: false,
+   *     reportFilename: 'stats.html',
+   *   },
+   * }
+   * ```
+   */
   analyze?: boolean | AnalyzeConfig;
   /**
-       * Generate source maps for production builds.
-       * - `true`: Generate separate source map files
-       * - `'hidden'`: Generate source maps but don't reference them in bundles
-       * - `'inline'`: Inline source maps into bundles
-       * - `false`: No source maps
-       *
-       * @default false
-       */
+   * Generate source maps for production builds.
+   * - `true`: Generate separate source map files
+   * - `'hidden'`: Generate source maps but don't reference them in bundles
+   * - `'inline'`: Inline source maps into bundles
+   * - `false`: No source maps
+   *
+   * @default false
+   */
   sourcemap?: boolean | "hidden" | "inline";
   /**
-       * Build target for esbuild/terser.
-       * Specifies the JS language version to target.
-       *
-       * @default 'esnext'
-       */
+   * Build target for esbuild/terser.
+   * Specifies the JS language version to target.
+   *
+   * @default 'esnext'
+   */
   target?: string;
   /**
-       * Minification strategy for production builds.
-       * - `true`: Use default minifier (esbuild)
-       * - `'esbuild'`: Fast minification with esbuild
-       * - `'terser'`: More aggressive minification with terser
-       * - `false`: No minification
-       *
-       * @default 'esbuild'
-       */
+   * Minification strategy for production builds.
+   * - `true`: Use default minifier (esbuild)
+   * - `'esbuild'`: Fast minification with esbuild
+   * - `'terser'`: More aggressive minification with terser
+   * - `false`: No minification
+   *
+   * @default 'esbuild'
+   */
   minify?: boolean | "esbuild" | "terser";
 }
 /**
@@ -763,12 +763,12 @@ interface BuildConfig {
  */
 interface HttpsConfig {
   /**
-       * Path to SSL key file
-       */
+   * Path to SSL key file
+   */
   key?: string;
   /**
-       * Path to SSL certificate file
-       */
+   * Path to SSL certificate file
+   */
   cert?: string;
 }
 /**
@@ -776,30 +776,30 @@ interface HttpsConfig {
  */
 interface ProxyOptions {
   /**
-       * Target URL to proxy to
-       */
+   * Target URL to proxy to
+   */
   target: string;
   /**
-       * Change the origin header to match target
-       * @default true
-       */
+   * Change the origin header to match target
+   * @default true
+   */
   changeOrigin?: boolean;
   /**
-       * Rewrite the URL path
-       */
+   * Rewrite the URL path
+   */
   rewrite?: (path: string) => string;
   /**
-       * Whether to proxy WebSocket connections
-       * @default false
-       */
+   * Whether to proxy WebSocket connections
+   * @default false
+   */
   ws?: boolean;
   /**
-       * SSL verification options
-       */
+   * SSL verification options
+   */
   secure?: boolean;
   /**
-       * Custom headers to send with the proxy request
-       */
+   * Custom headers to send with the proxy request
+   */
   headers?: Record<string, string>;
 }
 /**
@@ -807,32 +807,32 @@ interface ProxyOptions {
  */
 interface CorsOptions {
   /**
-       * Allowed origins
-       * @default '*'
-       */
+   * Allowed origins
+   * @default '*'
+   */
   origin?: string | string[] | boolean;
   /**
-       * Allowed HTTP methods
-       * @default ['GET', 'HEAD', 'PUT', 'PATCH', 'POST', 'DELETE']
-       */
+   * Allowed HTTP methods
+   * @default ['GET', 'HEAD', 'PUT', 'PATCH', 'POST', 'DELETE']
+   */
   methods?: string[];
   /**
-       * Allowed headers
-       */
+   * Allowed headers
+   */
   allowedHeaders?: string[];
   /**
-       * Headers exposed to the client
-       */
+   * Headers exposed to the client
+   */
   exposedHeaders?: string[];
   /**
-       * Allow credentials (cookies, authorization headers)
-       * @default false
-       */
+   * Allow credentials (cookies, authorization headers)
+   * @default false
+   */
   credentials?: boolean;
   /**
-       * Max age for preflight request caching (seconds)
-       * @default 86400
-       */
+   * Max age for preflight request caching (seconds)
+   * @default 86400
+   */
   maxAge?: number;
 }
 /**
@@ -840,70 +840,70 @@ interface CorsOptions {
  */
 interface DevServerConfig {
   /**
-       * Port to listen on
-       * @default 3000
-       */
+   * Port to listen on
+   * @default 3000
+   */
   port?: number;
   /**
-       * Host to bind to.
-       * - `'localhost'`: Only accessible from this machine
-       * - `true` or `'0.0.0.0'`: Accessible from network
-       *
-       * @default 'localhost'
-       */
+   * Host to bind to.
+   * - `'localhost'`: Only accessible from this machine
+   * - `true` or `'0.0.0.0'`: Accessible from network
+   *
+   * @default 'localhost'
+   */
   host?: string | boolean;
   /**
-       * Automatically open browser when server starts
-       * @default false
-       */
+   * Automatically open browser when server starts
+   * @default false
+   */
   open?: boolean;
   /**
-       * Enable HTTPS for dev server.
-       * Set to `true` to use auto-generated certificates,
-       * or provide custom key/cert paths.
-       *
-       * @example
-       * ```ts
-       * dev: {
-       *   https: true, // Auto-generate certificates
-       *   // or with custom certs:
-       *   https: {
-       *     key: './certs/localhost.key',
-       *     cert: './certs/localhost.crt',
-       *   },
-       * }
-       * ```
-       */
+   * Enable HTTPS for dev server.
+   * Set to `true` to use auto-generated certificates,
+   * or provide custom key/cert paths.
+   *
+   * @example
+   * ```ts
+   * dev: {
+   *   https: true, // Auto-generate certificates
+   *   // or with custom certs:
+   *   https: {
+   *     key: './certs/localhost.key',
+   *     cert: './certs/localhost.crt',
+   *   },
+   * }
+   * ```
+   */
   https?: boolean | HttpsConfig;
   /**
-       * Configure proxy rules for dev server.
-       * Useful for API proxying during development.
-       *
-       * @example
-       * ```ts
-       * dev: {
-       *   proxy: {
-       *     '/api': 'http://localhost:8080',
-       *     '/socket': {
-       *       target: 'ws://localhost:8081',
-       *       ws: true,
-       *     },
-       *   },
-       * }
-       * ```
-       */
+   * Configure proxy rules for dev server.
+   * Useful for API proxying during development.
+   *
+   * @example
+   * ```ts
+   * dev: {
+   *   proxy: {
+   *     '/api': 'http://localhost:8080',
+   *     '/socket': {
+   *       target: 'ws://localhost:8081',
+   *       ws: true,
+   *     },
+   *   },
+   * }
+   * ```
+   */
   proxy?: Record<string, string | ProxyOptions>;
   /**
-       * Configure CORS for dev server.
-       * Set to `true` to enable default CORS settings.
-       *
-       * @default false
-       */
+   * Configure CORS for dev server.
+   * Set to `true` to enable default CORS settings.
+   *
+   * @default false
+   */
   cors?: boolean | CorsOptions;
   /**
-       * Exit if the specified port is already in use
-       * @default false
-       */
+   * Exit if the specified port is already in use
+   * @default false
+   */
   strictPort?: boolean;
 }
 /**
@@ -911,37 +911,37 @@ interface DevServerConfig {
  */
 interface TypeScriptConfig {
   /**
-       * Enable strict TypeScript mode.
-       * When true, adds strict compiler options to generated tsconfig.
-       *
-       * @default true
-       */
+   * Enable strict TypeScript mode.
+   * When true, adds strict compiler options to generated tsconfig.
+   *
+   * @default true
+   */
   strict?: boolean;
   /**
-       * Enable type checking during development and/or build.
-       * - `true`: Enable type checking during both dev and build
-       * - `'build'`: Only type check during build
-       * - `false`: Disable type checking
-       *
-       * @default false
-       */
+   * Enable type checking during development and/or build.
+   * - `true`: Enable type checking during both dev and build
+   * - `'build'`: Only type check during build
+   * - `false`: Disable type checking
+   *
+   * @default false
+   */
   typeCheck?: boolean | "build";
   /**
-       * Additional tsconfig compiler options to merge with generated config.
-       * These options will extend the auto-generated `.kimesh/tsconfig.json`.
-       *
-       * @example
-       * ```ts
-       * typescript: {
-       *   tsConfig: {
-       *     compilerOptions: {
-       *       experimentalDecorators: true,
-       *       emitDecoratorMetadata: true,
-       *     },
-       *   },
-       * }
-       * ```
-       */
+   * Additional tsconfig compiler options to merge with generated config.
+   * These options will extend the auto-generated `.kimesh/tsconfig.json`.
+   *
+   * @example
+   * ```ts
+   * typescript: {
+   *   tsConfig: {
+   *     compilerOptions: {
+   *       experimentalDecorators: true,
+   *       emitDecoratorMetadata: true,
+   *     },
+   *   },
+   * }
+   * ```
+   */
   tsConfig?: {
     compilerOptions?: Record<string, unknown>;
     include?: string[];
@@ -957,46 +957,46 @@ interface TypeScriptConfig {
  */
 interface ChokidarOptions {
   /**
-       * Indicates whether the process should continue as long as files are being watched
-       * @default true
-       */
+   * Indicates whether the process should continue as long as files are being watched
+   * @default true
+   */
   persistent?: boolean;
   /**
-       * Patterns to ignore
-       */
+   * Patterns to ignore
+   */
   ignored?: string | RegExp | string[] | ((path: string) => boolean);
   /**
-       * Use polling instead of native events
-       * @default false
-       */
+   * Use polling instead of native events
+   * @default false
+   */
   usePolling?: boolean;
   /**
-       * Polling interval in milliseconds (if usePolling is true)
-       * @default 100
-       */
+   * Polling interval in milliseconds (if usePolling is true)
+   * @default 100
+   */
   interval?: number;
   /**
-       * Polling interval for binary files (if usePolling is true)
-       * @default 300
-       */
+   * Polling interval for binary files (if usePolling is true)
+   * @default 300
+   */
   binaryInterval?: number;
   /**
-       * Delay in milliseconds for stabilized 'add' events
-       * @default 2000
-       */
+   * Delay in milliseconds for stabilized 'add' events
+   * @default 2000
+   */
   awaitWriteFinish?: boolean | {
     stabilityThreshold?: number;
     pollInterval?: number;
   };
   /**
-       * Use file descriptor watching instead of stat polling
-       * @default false
-       */
+   * Use file descriptor watching instead of stat polling
+   * @default false
+   */
   atomic?: boolean | number;
   /**
-       * Watch depth limit (how many levels to traverse)
-       * @default undefined (no limit)
-       */
+   * Watch depth limit (how many levels to traverse)
+   * @default undefined (no limit)
+   */
   depth?: number;
 }
 /**
@@ -1004,12 +1004,12 @@ interface ChokidarOptions {
  */
 interface WatchersConfig {
   /**
-       * Chokidar options for file watching
-       */
+   * Chokidar options for file watching
+   */
   chokidar?: ChokidarOptions;
   /**
-       * Webpack watch options (for future use if needed)
-       */
+   * Webpack watch options (for future use if needed)
+   */
   webpack?: {
     aggregateTimeout?: number;
     poll?: boolean | number;
@@ -1040,9 +1040,9 @@ interface KimeshModuleOptions {
  */
 interface AppConfig {
   /**
-       * Global head configuration for the app
-       * Automatically enables @kimesh/head plugin when configured
-       */
+   * Global head configuration for the app
+   * Automatically enables @kimesh/head plugin when configured
+   */
   head?: {
     /** Page title */title?: string; /** Title template (e.g., '%s | My App') */
     titleTemplate?: string | ((title: string) => string); /** Meta tags */
@@ -1066,279 +1066,279 @@ interface KimeshConfig extends KimeshModuleOptions {
   /** Base path for routes (for layers) */
   basePath?: string;
   /**
-       * Define additional aliases to access custom directories within your JavaScript and CSS.
-       *
-       * Aliases are automatically added to the generated TypeScript configurations
-       * for full type support and path auto-complete.
-       *
-       * @default { "~": "/<srcDir>", "@": "/<srcDir>", "~~": "/<rootDir>", "@@": "/<rootDir>", "#build": "/<rootDir>/.kimesh" }
-       *
-       * @example
-       * ```ts
-       * import { fileURLToPath } from 'node:url'
-       *
-       * export default defineKmConfig({
-       *   alias: {
-       *     'images': fileURLToPath(new URL('./assets/images', import.meta.url)),
-       *     'style': fileURLToPath(new URL('./assets/style', import.meta.url)),
-       *   },
-       * })
-       * ```
-       */
+   * Define additional aliases to access custom directories within your JavaScript and CSS.
+   *
+   * Aliases are automatically added to the generated TypeScript configurations
+   * for full type support and path auto-complete.
+   *
+   * @default { "~": "/<srcDir>", "@": "/<srcDir>", "~~": "/<rootDir>", "@@": "/<rootDir>", "#build": "/<rootDir>/.kimesh" }
+   *
+   * @example
+   * ```ts
+   * import { fileURLToPath } from 'node:url'
+   *
+   * export default defineKmConfig({
+   *   alias: {
+   *     'images': fileURLToPath(new URL('./assets/images', import.meta.url)),
+   *     'style': fileURLToPath(new URL('./assets/style', import.meta.url)),
+   *   },
+   * })
+   * ```
+   */
   alias?: Record<string, string>;
   /**
-       * Set to `true` to enable debug mode.
-       *
-       * Prints out hook names and timings, logs hook arguments,
-       * and provides detailed information about module loading and layer resolution.
-       *
-       * @default false
-       *
-       * @example
-       * ```ts
-       * export default defineKmConfig({
-       *   debug: true,
-       *   // or with specific options:
-       *   debug: {
-       *     hooks: true,
-       *     modules: true,
-       *     layers: true,
-       *   },
-       * })
-       * ```
-       */
+   * Set to `true` to enable debug mode.
+   *
+   * Prints out hook names and timings, logs hook arguments,
+   * and provides detailed information about module loading and layer resolution.
+   *
+   * @default false
+   *
+   * @example
+   * ```ts
+   * export default defineKmConfig({
+   *   debug: true,
+   *   // or with specific options:
+   *   debug: {
+   *     hooks: true,
+   *     modules: true,
+   *     layers: true,
+   *   },
+   * })
+   * ```
+   */
   debug?: boolean | DebugConfig;
   /**
-       * Hooks are listeners to Kimesh events that are typically used in modules,
-       * but are also available in `kimesh.config.ts`.
-       *
-       * Internally, hooks follow a naming pattern using colons (e.g., build:done).
-       * For ease of configuration, you can structure them as an hierarchical object.
-       *
-       * @example
-       * ```ts
-       * export default defineKmConfig({
-       *   hooks: {
-       *     'ready': (kimesh) => {
-       *       console.log('Kimesh is ready!')
-       *     },
-       *     'build:done': (kimesh) => {
-       *       console.log('Build completed!')
-       *     },
-       *   },
-       * })
-       * ```
-       */
+   * Hooks are listeners to Kimesh events that are typically used in modules,
+   * but are also available in `kimesh.config.ts`.
+   *
+   * Internally, hooks follow a naming pattern using colons (e.g., build:done).
+   * For ease of configuration, you can structure them as an hierarchical object.
+   *
+   * @example
+   * ```ts
+   * export default defineKmConfig({
+   *   hooks: {
+   *     'ready': (kimesh) => {
+   *       console.log('Kimesh is ready!')
+   *     },
+   *     'build:done': (kimesh) => {
+   *       console.log('Build completed!')
+   *     },
+   *   },
+   * })
+   * ```
+   */
   hooks?: Partial<KimeshHooks>;
   /**
-       * Files matching glob patterns specified inside the `ignore` array
-       * will be ignored in building.
-       *
-       * More customizable than `ignorePrefix`: allows complex patterns.
-       *
-       * @default ["**\/*.stories.{js,cts,mts,ts,jsx,tsx}", "**\/*.{spec,test}.{js,cts,mts,ts,jsx,tsx}", "**\/*.d.{cts,mts,ts}", ".kimesh"]
-       *
-       * @example
-       * ```ts
-       * export default defineKmConfig({
-       *   ignore: [
-       *     '**\/__tests__/**',
-       *     '**\/*.mock.ts',
-       *     'legacy/**',
-       *   ],
-       * })
-       * ```
-       */
+   * Files matching glob patterns specified inside the `ignore` array
+   * will be ignored in building.
+   *
+   * More customizable than `ignorePrefix`: allows complex patterns.
+   *
+   * @default ["**\/*.stories.{js,cts,mts,ts,jsx,tsx}", "**\/*.{spec,test}.{js,cts,mts,ts,jsx,tsx}", "**\/*.d.{cts,mts,ts}", ".kimesh"]
+   *
+   * @example
+   * ```ts
+   * export default defineKmConfig({
+   *   ignore: [
+   *     '**\/__tests__/**',
+   *     '**\/*.mock.ts',
+   *     'legacy/**',
+   *   ],
+   * })
+   * ```
+   */
   ignore?: string[];
   /**
-       * Any file in routes, layouts, middleware directories will be ignored
-       * during the build process if its filename starts with the prefix specified.
-       *
-       * @default "-"
-       *
-       * @example
-       * ```ts
-       * export default defineKmConfig({
-       *   ignorePrefix: '_', // Ignore files starting with underscore
-       * })
-       * ```
-       */
+   * Any file in routes, layouts, middleware directories will be ignored
+   * during the build process if its filename starts with the prefix specified.
+   *
+   * @default "-"
+   *
+   * @example
+   * ```ts
+   * export default defineKmConfig({
+   *   ignorePrefix: '_', // Ignore files starting with underscore
+   * })
+   * ```
+   */
   ignorePrefix?: string;
   /**
-       * Pass options directly to `node-ignore` (which is used by Kimesh to ignore files).
-       *
-       * @see https://github.com/kaelzhang/node-ignore
-       *
-       * @example
-       * ```ts
-       * export default defineKmConfig({
-       *   ignoreOptions: {
-       *     ignorecase: false, // Case-sensitive matching
-       *   },
-       * })
-       * ```
-       */
+   * Pass options directly to `node-ignore` (which is used by Kimesh to ignore files).
+   *
+   * @see https://github.com/kaelzhang/node-ignore
+   *
+   * @example
+   * ```ts
+   * export default defineKmConfig({
+   *   ignoreOptions: {
+   *     ignorecase: false, // Case-sensitive matching
+   *   },
+   * })
+   * ```
+   */
   ignoreOptions?: IgnoreOptions;
   /**
-       * Global route rules applied to matching routes.
-       *
-       * Keys are route patterns (supports wildcards with **).
-       * Useful for redirects, caching, and per-route configuration.
-       *
-       * @experimental This feature's API may change in the future.
-       *
-       * @example
-       * ```ts
-       * export default defineKmConfig({
-       *   routeRules: {
-       *     '/admin/**': {
-       *       redirect: '/login',
-       *     },
-       *     '/api/**': {
-       *       headers: { 'Cache-Control': 'no-store' },
-       *       cors: true,
-       *     },
-       *     '/blog/**': {
-       *       prerender: true,
-       *     },
-       *   },
-       * })
-       * ```
-       */
+   * Global route rules applied to matching routes.
+   *
+   * Keys are route patterns (supports wildcards with **).
+   * Useful for redirects, caching, and per-route configuration.
+   *
+   * @experimental This feature's API may change in the future.
+   *
+   * @example
+   * ```ts
+   * export default defineKmConfig({
+   *   routeRules: {
+   *     '/admin/**': {
+   *       redirect: '/login',
+   *     },
+   *     '/api/**': {
+   *       headers: { 'Cache-Control': 'no-store' },
+   *       cors: true,
+   *     },
+   *     '/blog/**': {
+   *       prerender: true,
+   *     },
+   *   },
+   * })
+   * ```
+   */
   routeRules?: Record<string, RouteRule>;
   /**
-       * Source directory for your application code.
-       * All relative paths are resolved from this directory.
-       *
-       * @default 'src'
-       *
-       * @example
-       * ```ts
-       * export default defineKmConfig({
-       *   srcDir: 'app', // Use 'app' instead of 'src'
-       * })
-       * ```
-       */
+   * Source directory for your application code.
+   * All relative paths are resolved from this directory.
+   *
+   * @default 'src'
+   *
+   * @example
+   * ```ts
+   * export default defineKmConfig({
+   *   srcDir: 'app', // Use 'app' instead of 'src'
+   * })
+   * ```
+   */
   srcDir?: string;
   /**
-       * Build output directory for Kimesh's generated files.
-       * Contains TypeScript configs, generated routes, and other build artifacts.
-       *
-       * @default '.kimesh'
-       *
-       * @example
-       * ```ts
-       * export default defineKmConfig({
-       *   buildDir: '.output', // Use '.output' instead of '.kimesh'
-       * })
-       * ```
-       */
+   * Build output directory for Kimesh's generated files.
+   * Contains TypeScript configs, generated routes, and other build artifacts.
+   *
+   * @default '.kimesh'
+   *
+   * @example
+   * ```ts
+   * export default defineKmConfig({
+   *   buildDir: '.output', // Use '.output' instead of '.kimesh'
+   * })
+   * ```
+   */
   buildDir?: string;
   /**
-       * Directory configuration for customizing the project structure.
-       *
-       * @example
-       * ```ts
-       * export default defineKmConfig({
-       *   dir: {
-       *     assets: 'static/assets',
-       *     plugins: 'app/plugins',
-       *     public: 'public',
-       *     shared: 'lib/shared',
-       *   },
-       * })
-       * ```
-       */
+   * Directory configuration for customizing the project structure.
+   *
+   * @example
+   * ```ts
+   * export default defineKmConfig({
+   *   dir: {
+   *     assets: 'static/assets',
+   *     plugins: 'app/plugins',
+   *     public: 'public',
+   *     shared: 'lib/shared',
+   *   },
+   * })
+   * ```
+   */
   dir?: DirectoryConfig;
   /**
-       * Build configuration for production builds.
-       *
-       * @example
-       * ```ts
-       * export default defineKmConfig({
-       *   build: {
-       *     analyze: true,
-       *     sourcemap: 'hidden',
-       *     target: 'es2022',
-       *     minify: 'esbuild',
-       *   },
-       * })
-       * ```
-       */
+   * Build configuration for production builds.
+   *
+   * @example
+   * ```ts
+   * export default defineKmConfig({
+   *   build: {
+   *     analyze: true,
+   *     sourcemap: 'hidden',
+   *     target: 'es2022',
+   *     minify: 'esbuild',
+   *   },
+   * })
+   * ```
+   */
   build?: BuildConfig;
   /**
-       * Enhanced development server configuration.
-       * Supports HTTPS, proxy, CORS, and more.
-       *
-       * @example
-       * ```ts
-       * export default defineKmConfig({
-       *   dev: {
-       *     port: 3000,
-       *     host: 'localhost',
-       *     open: true,
-       *     https: true,
-       *     proxy: {
-       *       '/api': 'http://localhost:8080',
-       *     },
-       *     cors: true,
-       *     strictPort: false,
-       *   },
-       * })
-       * ```
-       */
+   * Enhanced development server configuration.
+   * Supports HTTPS, proxy, CORS, and more.
+   *
+   * @example
+   * ```ts
+   * export default defineKmConfig({
+   *   dev: {
+   *     port: 3000,
+   *     host: 'localhost',
+   *     open: true,
+   *     https: true,
+   *     proxy: {
+   *       '/api': 'http://localhost:8080',
+   *     },
+   *     cors: true,
+   *     strictPort: false,
+   *   },
+   * })
+   * ```
+   */
   dev?: DevServerConfig;
   /**
-       * TypeScript configuration options.
-       *
-       * @example
-       * ```ts
-       * export default defineKmConfig({
-       *   typescript: {
-       *     strict: true,
-       *     typeCheck: 'build',
-       *     tsConfig: {
-       *       compilerOptions: {
-       *         experimentalDecorators: true,
-       *       },
-       *     },
-       *   },
-       * })
-       * ```
-       */
+   * TypeScript configuration options.
+   *
+   * @example
+   * ```ts
+   * export default defineKmConfig({
+   *   typescript: {
+   *     strict: true,
+   *     typeCheck: 'build',
+   *     tsConfig: {
+   *       compilerOptions: {
+   *         experimentalDecorators: true,
+   *       },
+   *     },
+   *   },
+   * })
+   * ```
+   */
   typescript?: TypeScriptConfig;
   /**
-       * Additional file patterns to watch during development.
-       * Uses glob patterns relative to the project root.
-       *
-       * @example
-       * ```ts
-       * export default defineKmConfig({
-       *   watch: [
-       *     './custom-dir/**\/*',
-       *     './config/**\/*.json',
-       *   ],
-       * })
-       * ```
-       */
+   * Additional file patterns to watch during development.
+   * Uses glob patterns relative to the project root.
+   *
+   * @example
+   * ```ts
+   * export default defineKmConfig({
+   *   watch: [
+   *     './custom-dir/**\/*',
+   *     './config/**\/*.json',
+   *   ],
+   * })
+   * ```
+   */
   watch?: string[];
   /**
-       * Advanced watcher configuration.
-       * Customize chokidar options for file watching.
-       *
-       * @example
-       * ```ts
-       * export default defineKmConfig({
-       *   watchers: {
-       *     chokidar: {
-       *       usePolling: true,
-       *       interval: 1000,
-       *       ignored: ['**\/.git/**'],
-       *     },
-       *   },
-       * })
-       * ```
-       */
+   * Advanced watcher configuration.
+   * Customize chokidar options for file watching.
+   *
+   * @example
+   * ```ts
+   * export default defineKmConfig({
+   *   watchers: {
+   *     chokidar: {
+   *       usePolling: true,
+   *       interval: 1000,
+   *       ignored: ['**\/.git/**'],
+   *     },
+   *   },
+   * })
+   * ```
+   */
   watchers?: WatchersConfig;
   /** Router configuration */
   router?: {
@@ -1353,13 +1353,13 @@ interface KimeshConfig extends KimeshModuleOptions {
   /** Layers configuration */
   layers?: LayersConfig;
   /**
-       * Kimesh modules to load
-       */
+   * Kimesh modules to load
+   */
   modules?: KimeshModuleInput[];
   /**
-       * App-level configuration
-       * Includes head management and other app-wide settings
-       */
+   * App-level configuration
+   * Includes head management and other app-wide settings
+   */
   app?: AppConfig;
   /** Routes configuration (for layers) */
   routes?: {
@@ -1377,26 +1377,26 @@ interface KimeshConfig extends KimeshModuleOptions {
   /** CSS files to include */
   css?: string[];
   /**
-       * Vite configuration options.
-       */
+   * Vite configuration options.
+   */
   vite?: KimeshViteConfig;
   /**
-       * Runtime configuration with environment variable override support.
-       *
-       * In Phase 1, all config is client-side (build-time injection).
-       * Use KIMESH_* environment variables to override values.
-       *
-       * @example
-       * ```ts
-       * runtimeConfig: {
-       *   apiBase: '/api', // KIMESH_API_BASE
-       *   debug: false, // KIMESH_DEBUG=true
-       *   features: {
-       *     darkMode: true, // KIMESH_FEATURES_DARK_MODE
-       *   }
-       * }
-       * ```
-       */
+   * Runtime configuration with environment variable override support.
+   *
+   * In Phase 1, all config is client-side (build-time injection).
+   * Use KIMESH_* environment variables to override values.
+   *
+   * @example
+   * ```ts
+   * runtimeConfig: {
+   *   apiBase: '/api', // KIMESH_API_BASE
+   *   debug: false, // KIMESH_DEBUG=true
+   *   features: {
+   *     darkMode: true, // KIMESH_FEATURES_DARK_MODE
+   *   }
+   * }
+   * ```
+   */
   runtimeConfig?: RuntimeConfig;
 }
 /**
@@ -1784,6 +1784,60 @@ declare function generatePluginsTemplate(options: GeneratePluginsTemplateOptions
  */
 declare function addPluginsTemplate(kimesh: Kimesh, discoveredPlugins: DiscoveredPlugin[]): void;
 //#endregion
+//#region src/kit/internal-alias-template.d.ts
+/**
+ * Configuration for an internal alias
+ */
+interface InternalAliasConfig {
+  /** Alias specifier, e.g., '#kimesh/head/plugin' */
+  alias: string;
+  /** Package specifier to resolve, e.g., '@kimesh/head/plugin' */
+  packageSpecifier: string;
+  /** Generated template filename, e.g., 'head-plugin.mjs' */
+  filename: string;
+}
+/**
+ * Internal aliases that should be resolved via generated templates.
+ *
+ * Each entry maps an internal alias (#kimesh/...) to the actual internal
+ * package subpath export (@kimesh/...) that should be resolved and re-exported.
+ */
+declare const INTERNAL_ALIASES: InternalAliasConfig[];
+/**
+ * Generate the content for an internal alias template file.
+ *
+ * The generated file re-exports everything from the **resolved absolute path**,
+ * not from a package specifier. This ensures the import works correctly even
+ * when the package is a transitive dependency that can't be directly resolved
+ * from the host app.
+ *
+ * @param config - The internal alias configuration
+ * @param resolvedPath - The resolved absolute path to the module
+ * @returns Generated template content
+ */
+declare function generateInternalAliasTemplate(config: InternalAliasConfig, resolvedPath: string): string;
+/**
+ * Register internal alias templates with the Kimesh context.
+ *
+ * This function resolves the actual paths to @kimesh/* packages at build time
+ * and generates templates that use those absolute paths. This ensures the
+ * imports work correctly across all environments including PR preview packages.
+ *
+ * @param kimesh - The Kimesh context
+ */
+declare function addInternalAliasTemplates(kimesh: Kimesh): void;
+/**
+ * Build a map of internal alias to generated template file path.
+ *
+ * This is used to configure Vite's resolve.alias so that imports
+ * like '#kimesh/head/plugin' are resolved to the generated template
+ * file in .kimesh/.
+ *
+ * @param buildDir - The .kimesh build directory path
+ * @returns Record mapping alias to generated file path
+ */
+declare function buildInternalAliasMap(buildDir: string): Record<string, string>;
+//#endregion
 //#region src/kit/alias-utils.d.ts
 /**
  * Resolve an alias path template to an actual path
@@ -1955,40 +2009,40 @@ declare function isDebug(category?: keyof DebugConfig): boolean;
  */
 declare const debug: {
   /**
-       * Log debug message for hooks
-       */
+   * Log debug message for hooks
+   */
   hook(hookName: string, ...args: unknown[]): void;
   /**
-       * Log debug message for modules
-       */
+   * Log debug message for modules
+   */
   module(moduleName: string, message: string, ...args: unknown[]): void;
   /**
-       * Log debug message for layers
-       */
+   * Log debug message for layers
+   */
   layer(layerName: string, message: string, ...args: unknown[]): void;
   /**
-       * Log debug message for config
-       */
+   * Log debug message for config
+   */
   config(message: string, ...args: unknown[]): void;
   /**
-       * Log debug message for Vite
-       */
+   * Log debug message for Vite
+   */
   vite(message: string, ...args: unknown[]): void;
   /**
-       * Log debug message for routes
-       */
+   * Log debug message for routes
+   */
   route(routePath: string, message: string, ...args: unknown[]): void;
   /**
-       * Log debug message for imports
-       */
+   * Log debug message for imports
+   */
   import(name: string, message: string, ...args: unknown[]): void;
   /**
-       * Log timing information
-       */
+   * Log timing information
+   */
   timing(label: string, startTime: number): void;
   /**
-       * Create a timing tracker
-       */
+   * Create a timing tracker
+   */
   startTiming(label: string): () => void;
 };
 /**
@@ -2248,9 +2302,9 @@ interface KimeshPluginOptions {
   /** Enable debug logging */
   debug?: boolean;
   /**
-       * Additional Vite plugins added programmatically.
-       */
-  additionalPlugins?: vite0.PluginOption[];
+   * Additional Vite plugins added programmatically.
+   */
+  additionalPlugins?: vite3.PluginOption[];
 }
 //#endregion
-export { type AddRuntimePluginOptions, type AutoImportConfig, type AutoImportOptions, type ComponentsConfig, DEFAULT_ALIASES, DEFAULT_IGNORE_PATTERNS, type DebugConfig, type DiscoveredPlugin, type EnvOptions, type ErrorContext, type FormattedError, type GeneratePluginsTemplateOptions, type HMRContext, type HMRWatcherOptions, type HookResult, type IgnoreOptions, type ImportPreset, type ImportSource, type Kimesh, type KimeshAlias, type KimeshAppContext, type KimeshComponent, type KimeshComponentsDir, type KimeshConfig, type KimeshHooks, type KimeshImport, type KimeshImportPreset, type KimeshImportsDir, type KimeshLayerConfig, type KimeshModule, type KimeshModuleDefaults, type KimeshModuleDefinition, type KimeshModuleInput, type KimeshModuleMeta, type KimeshModuleOptions, type KimeshOptions, type KimeshPlugin, type KimeshPluginDefinition, KimeshPluginOptions, type KimeshRegistries, type KimeshResolver, type KimeshRoute, type KimeshRouteMiddleware, type KimeshRuntimeHooks, type KimeshRuntimePlugin, type KimeshRuntimePluginDefinition, type KimeshRuntimePluginEntry, type KimeshRuntimePluginMeta, type KimeshRuntimePluginResult, type KimeshTemplate, type KimeshTypeTemplate, type KimeshViteConfig, type KimeshVitePluginEntry, type LayerAutoImportConfig, type LayerComponentConfig, type LayerComposableConfig, type LayerRouteConfig, type LayersConfig, type LoadConfigOptions, type PrepareOptions, type PrepareResult, type ResolvedLayer, type ResolvedTemplate, type RouteRule, type RuntimeConfig, type RuntimeConfigPublic, type ScanPluginsOptions, type VitePlugin, type VitePluginOption, addAlias, addBuildPlugin, addComponent, addComponentResolver, addComponentsDir, addImports, addImportsDir, addImportsPreset, addPluginsTemplate, addRuntimePlugin, addTemplate, addTypeTemplate, addVitePlugin, applyEnv, buildAliases, buildImportRegistry, createDebugLogger, createDefaultRuntimeConfig, createHMRWatcher, createIgnoreFilter, createIgnoreMatcher, createKimesh, createResolver, createTimer, debug, debugTable, defineKimeshModule, defineKimeshPlugin, defineKmConfig, envToKey, executeModule, executeModules, filterIgnored, findMatchingRules, formatConflictWarning, formatError, formatTiming, formatWarning, generateDts, generateLayerAliases, generatePluginsTemplate, generateRouteRulesManifest, getIgnorePatterns, getRedirectInfo, getRouteRule, getRuntimePlugins, hasPlugins, hasRuntimePlugin, isDebug, isDebugEnabled, keyToEnv, kimeshAutoImport, kimeshPlugin, loadConfig, matchRoutePattern, mergeLayerConfigs, mergeRouteRules, normalizeDebugConfig, normalizeModuleInput, prepare, prepareLayers, removeRuntimePlugin, resolveAlias, resolveAliasPath, resolveLayers, resolvePathFromBuild, resolvePathFromRoot, scanExports, scanPluginsDir, setDebugConfig, shouldIgnore, toTsConfigPaths, toViteAliases, tryUseKimesh, updateTemplates, useKimesh, writeTemplates };
+export { type AddRuntimePluginOptions, type AutoImportConfig, type AutoImportOptions, type ComponentsConfig, DEFAULT_ALIASES, DEFAULT_IGNORE_PATTERNS, type DebugConfig, type DiscoveredPlugin, type EnvOptions, type ErrorContext, type FormattedError, type GeneratePluginsTemplateOptions, type HMRContext, type HMRWatcherOptions, type HookResult, INTERNAL_ALIASES, type IgnoreOptions, type ImportPreset, type ImportSource, type InternalAliasConfig, type Kimesh, type KimeshAlias, type KimeshAppContext, type KimeshComponent, type KimeshComponentsDir, type KimeshConfig, type KimeshHooks, type KimeshImport, type KimeshImportPreset, type KimeshImportsDir, type KimeshLayerConfig, type KimeshModule, type KimeshModuleDefaults, type KimeshModuleDefinition, type KimeshModuleInput, type KimeshModuleMeta, type KimeshModuleOptions, type KimeshOptions, type KimeshPlugin, type KimeshPluginDefinition, KimeshPluginOptions, type KimeshRegistries, type KimeshResolver, type KimeshRoute, type KimeshRouteMiddleware, type KimeshRuntimeHooks, type KimeshRuntimePlugin, type KimeshRuntimePluginDefinition, type KimeshRuntimePluginEntry, type KimeshRuntimePluginMeta, type KimeshRuntimePluginResult, type KimeshTemplate, type KimeshTypeTemplate, type KimeshViteConfig, type KimeshVitePluginEntry, type LayerAutoImportConfig, type LayerComponentConfig, type LayerComposableConfig, type LayerRouteConfig, type LayersConfig, type LoadConfigOptions, type PrepareOptions, type PrepareResult, type ResolvedLayer, type ResolvedTemplate, type RouteRule, type RuntimeConfig, type RuntimeConfigPublic, type ScanPluginsOptions, type VitePlugin, type VitePluginOption, addAlias, addBuildPlugin, addComponent, addComponentResolver, addComponentsDir, addImports, addImportsDir, addImportsPreset, addInternalAliasTemplates, addPluginsTemplate, addRuntimePlugin, addTemplate, addTypeTemplate, addVitePlugin, applyEnv, buildAliases, buildImportRegistry, buildInternalAliasMap, createDebugLogger, createDefaultRuntimeConfig, createHMRWatcher, createIgnoreFilter, createIgnoreMatcher, createKimesh, createResolver, createTimer, debug, debugTable, defineKimeshModule, defineKimeshPlugin, defineKmConfig, envToKey, executeModule, executeModules, filterIgnored, findMatchingRules, formatConflictWarning, formatError, formatTiming, formatWarning, generateDts, generateInternalAliasTemplate, generateLayerAliases, generatePluginsTemplate, generateRouteRulesManifest, getIgnorePatterns, getRedirectInfo, getRouteRule, getRuntimePlugins, hasPlugins, hasRuntimePlugin, isDebug, isDebugEnabled, keyToEnv, kimeshAutoImport, kimeshPlugin, loadConfig, matchRoutePattern, mergeLayerConfigs, mergeRouteRules, normalizeDebugConfig, normalizeModuleInput, prepare, prepareLayers, removeRuntimePlugin, resolveAlias, resolveAliasPath, resolveLayers, resolvePathFromBuild, resolvePathFromRoot, scanExports, scanPluginsDir, setDebugConfig, shouldIgnore, toTsConfigPaths, toViteAliases, tryUseKimesh, updateTemplates, useKimesh, writeTemplates };