@4399ywkf/core 4.0.84 → 5.0.0

package/dist/plugin/index.d.ts

@@ -0,0 +1,110 @@
+import { e as YwkfPlugin, b as PluginHooks, Y as YwkfConfig, c as PluginConfig, k as RouteItem } from '../schema-BuqmN_ra.js';
+export { B as BuildHooks, C as CodeInjection, n as DefinePlugin, j as GeneratedFile, G as GeneratorContext, i as GeneratorHooks, m as PluginAPI, f as PluginContext, l as PluginLogger, g as RouterHooks, h as RuntimeHooks } from '../schema-BuqmN_ra.js';
+import { Configuration } from '@rspack/core';
+import { A as AppConfig, P as ProviderConfig } from '../types-BZV_2QtD.js';
+import 'react';
+import 'react-router';
+
+/**
+ * 定义插件的辅助函数
+ *
+ * @example
+ * ```ts
+ * export default definePlugin({
+ *   name: "my-plugin",
+ *   setup(context) {
+ *     return {
+ *       modifyRspackConfig(config) {
+ *         // 修改配置
+ *         return config;
+ *       },
+ *     };
+ *   },
+ * });
+ * ```
+ */
+declare function definePlugin(plugin: YwkfPlugin): YwkfPlugin;
+/**
+ * 创建带配置的插件工厂
+ *
+ * @example
+ * ```ts
+ * export default createPlugin<{ apiUrl: string }>((options) => ({
+ *   name: "api-plugin",
+ *   setup(context) {
+ *     console.log("API URL:", options?.apiUrl);
+ *     return {};
+ *   },
+ * }));
+ * ```
+ */
+declare function createPlugin<T = Record<string, unknown>>(factory: (options?: T) => YwkfPlugin): (options?: T) => YwkfPlugin;
+/**
+ * 组合多个插件钩子
+ */
+declare function composeHooks(...hooksList: PluginHooks[]): PluginHooks;
+
+/**
+ * 插件管理器
+ */
+declare class PluginManager {
+    private plugins;
+    private context;
+    constructor(config: Required<YwkfConfig>, cwd: string, isDev: boolean);
+    /**
+     * 加载并初始化所有插件
+     */
+    loadPlugins(pluginConfigs: PluginConfig[]): Promise<void>;
+    /**
+     * 执行 modifyRspackConfig 钩子
+     */
+    applyRspackConfigHooks(config: Configuration): Promise<Configuration>;
+    /**
+     * 执行 modifyRoutes 钩子
+     */
+    applyRoutesHooks(routes: RouteItem[]): Promise<RouteItem[]>;
+    /**
+     * 执行 modifyAppConfig 钩子
+     */
+    applyAppConfigHooks(appConfig: AppConfig): AppConfig;
+    /**
+     * 收集所有插件的 Provider
+     */
+    collectProviders(): ProviderConfig[];
+    /**
+     * 执行 beforeBuild 钩子
+     */
+    runBeforeBuild(): Promise<void>;
+    /**
+     * 执行 afterBuild 钩子
+     */
+    runAfterBuild(stats: {
+        success: boolean;
+        errors?: string[];
+    }): Promise<void>;
+    /**
+     * 执行 beforeDevServer 钩子
+     */
+    runBeforeDevServer(): Promise<void>;
+    /**
+     * 执行 afterDevServer 钩子
+     */
+    runAfterDevServer(server: {
+        port: number;
+        host: string;
+    }): Promise<void>;
+    /**
+     * 获取所有已加载的插件名称
+     */
+    getPluginNames(): string[];
+    /**
+     * 获取所有已加载的插件
+     */
+    getPlugins(): YwkfPlugin[];
+    /**
+     * 获取所有已加载的插件钩子
+     */
+    getPluginHooks(): PluginHooks[];
+}
+
+export { PluginConfig, PluginHooks, PluginManager, YwkfPlugin, composeHooks, createPlugin, definePlugin };

package/dist/plugin/index.js

@@ -0,0 +1,277 @@
+// src/plugin/define.ts
+function definePlugin(plugin) {
+  return plugin;
+}
+function createPlugin(factory) {
+  return factory;
+}
+function composeHooks(...hooksList) {
+  const composed = {};
+  for (const hooks of hooksList) {
+    for (const [key, value] of Object.entries(hooks)) {
+      if (value) {
+        const existing = composed[key];
+        if (existing) {
+          composed[key] = async (...args) => {
+            await existing(...args);
+            return value(...args);
+          };
+        } else {
+          composed[key] = value;
+        }
+      }
+    }
+  }
+  return composed;
+}
+
+// src/plugin/manager.ts
+function createLogger(pluginName) {
+  const prefix = `[${pluginName}]`;
+  return {
+    info: (msg) => console.log(`${prefix} ${msg}`),
+    warn: (msg) => console.warn(`${prefix} ${msg}`),
+    error: (msg) => console.error(`${prefix} ${msg}`),
+    debug: (msg) => {
+      if (process.env.DEBUG) {
+        console.debug(`${prefix} ${msg}`);
+      }
+    }
+  };
+}
+async function resolvePlugin(pluginConfig, cwd) {
+  let plugin;
+  let options = {};
+  if (typeof pluginConfig === "string") {
+    const module = await import(pluginConfig);
+    plugin = module.default || module;
+  } else if (Array.isArray(pluginConfig)) {
+    const [pluginOrName, pluginOptions] = pluginConfig;
+    options = pluginOptions;
+    if (typeof pluginOrName === "string") {
+      const module = await import(pluginOrName);
+      plugin = module.default || module;
+    } else {
+      plugin = pluginOrName;
+    }
+  } else {
+    plugin = pluginConfig;
+  }
+  if (typeof plugin === "function") {
+    plugin = plugin(options);
+  }
+  return { plugin, options };
+}
+var PluginManager = class {
+  plugins = /* @__PURE__ */ new Map();
+  context;
+  constructor(config, cwd, isDev) {
+    this.context = {
+      cwd,
+      isDev,
+      isProd: !isDev,
+      config,
+      logger: createLogger("PluginManager")
+    };
+  }
+  /**
+   * 加载并初始化所有插件
+   */
+  async loadPlugins(pluginConfigs) {
+    for (const pluginConfig of pluginConfigs) {
+      try {
+        const { plugin } = await resolvePlugin(pluginConfig, this.context.cwd);
+        if (this.plugins.has(plugin.name)) {
+          this.context.logger.warn(`\u63D2\u4EF6 ${plugin.name} \u5DF2\u52A0\u8F7D\uFF0C\u8DF3\u8FC7\u91CD\u590D\u52A0\u8F7D`);
+          continue;
+        }
+        const pluginContext = {
+          ...this.context,
+          logger: createLogger(plugin.name)
+        };
+        const hooks = await plugin.setup(pluginContext);
+        this.plugins.set(plugin.name, { plugin, hooks });
+        this.context.logger.info(`\u5DF2\u52A0\u8F7D\u63D2\u4EF6: ${plugin.name}`);
+      } catch (error) {
+        this.context.logger.error(
+          `\u52A0\u8F7D\u63D2\u4EF6\u5931\u8D25: ${String(pluginConfig)} - ${error}`
+        );
+      }
+    }
+  }
+  /**
+   * 执行 modifyRspackConfig 钩子
+   */
+  async applyRspackConfigHooks(config) {
+    let result = config;
+    for (const [name, { hooks }] of this.plugins) {
+      if (hooks.modifyRspackConfig) {
+        try {
+          const modified = await hooks.modifyRspackConfig(result, this.context);
+          if (modified) {
+            result = modified;
+          }
+        } catch (error) {
+          this.context.logger.error(
+            `\u63D2\u4EF6 ${name} modifyRspackConfig \u6267\u884C\u5931\u8D25: ${error}`
+          );
+        }
+      }
+    }
+    return result;
+  }
+  /**
+   * 执行 modifyRoutes 钩子
+   */
+  async applyRoutesHooks(routes) {
+    let result = routes;
+    for (const [name, { hooks }] of this.plugins) {
+      if (hooks.modifyRoutes) {
+        try {
+          const modified = await hooks.modifyRoutes(result, this.context);
+          if (modified) {
+            result = modified;
+          }
+        } catch (error) {
+          this.context.logger.error(
+            `\u63D2\u4EF6 ${name} modifyRoutes \u6267\u884C\u5931\u8D25: ${error}`
+          );
+        }
+      }
+    }
+    return result;
+  }
+  /**
+   * 执行 modifyAppConfig 钩子
+   */
+  applyAppConfigHooks(appConfig) {
+    let result = appConfig;
+    for (const [name, { hooks }] of this.plugins) {
+      if (hooks.modifyAppConfig) {
+        try {
+          const modified = hooks.modifyAppConfig(result, this.context);
+          if (modified) {
+            result = modified;
+          }
+        } catch (error) {
+          this.context.logger.error(
+            `\u63D2\u4EF6 ${name} modifyAppConfig \u6267\u884C\u5931\u8D25: ${error}`
+          );
+        }
+      }
+    }
+    return result;
+  }
+  /**
+   * 收集所有插件的 Provider
+   */
+  collectProviders() {
+    const providers = [];
+    for (const [name, { hooks }] of this.plugins) {
+      if (hooks.addProvider) {
+        try {
+          const result = hooks.addProvider(this.context);
+          if (Array.isArray(result)) {
+            providers.push(...result);
+          } else if (result) {
+            providers.push(result);
+          }
+        } catch (error) {
+          this.context.logger.error(
+            `\u63D2\u4EF6 ${name} addProvider \u6267\u884C\u5931\u8D25: ${error}`
+          );
+        }
+      }
+    }
+    return providers;
+  }
+  /**
+   * 执行 beforeBuild 钩子
+   */
+  async runBeforeBuild() {
+    for (const [name, { hooks }] of this.plugins) {
+      if (hooks.beforeBuild) {
+        try {
+          await hooks.beforeBuild(this.context);
+        } catch (error) {
+          this.context.logger.error(
+            `\u63D2\u4EF6 ${name} beforeBuild \u6267\u884C\u5931\u8D25: ${error}`
+          );
+        }
+      }
+    }
+  }
+  /**
+   * 执行 afterBuild 钩子
+   */
+  async runAfterBuild(stats) {
+    for (const [name, { hooks }] of this.plugins) {
+      if (hooks.afterBuild) {
+        try {
+          await hooks.afterBuild(this.context, stats);
+        } catch (error) {
+          this.context.logger.error(
+            `\u63D2\u4EF6 ${name} afterBuild \u6267\u884C\u5931\u8D25: ${error}`
+          );
+        }
+      }
+    }
+  }
+  /**
+   * 执行 beforeDevServer 钩子
+   */
+  async runBeforeDevServer() {
+    for (const [name, { hooks }] of this.plugins) {
+      if (hooks.beforeDevServer) {
+        try {
+          await hooks.beforeDevServer(this.context);
+        } catch (error) {
+          this.context.logger.error(
+            `\u63D2\u4EF6 ${name} beforeDevServer \u6267\u884C\u5931\u8D25: ${error}`
+          );
+        }
+      }
+    }
+  }
+  /**
+   * 执行 afterDevServer 钩子
+   */
+  async runAfterDevServer(server) {
+    for (const [name, { hooks }] of this.plugins) {
+      if (hooks.afterDevServer) {
+        try {
+          await hooks.afterDevServer(this.context, server);
+        } catch (error) {
+          this.context.logger.error(
+            `\u63D2\u4EF6 ${name} afterDevServer \u6267\u884C\u5931\u8D25: ${error}`
+          );
+        }
+      }
+    }
+  }
+  /**
+   * 获取所有已加载的插件名称
+   */
+  getPluginNames() {
+    return Array.from(this.plugins.keys());
+  }
+  /**
+   * 获取所有已加载的插件
+   */
+  getPlugins() {
+    return Array.from(this.plugins.values()).map((p) => p.plugin);
+  }
+  /**
+   * 获取所有已加载的插件钩子
+   */
+  getPluginHooks() {
+    return Array.from(this.plugins.values()).map((p) => p.hooks);
+  }
+};
+export {
+  PluginManager,
+  composeHooks,
+  createPlugin,
+  definePlugin
+};
+//# sourceMappingURL=index.js.map

package/dist/plugin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/plugin/define.ts","../../src/plugin/manager.ts"],"sourcesContent":["import type { YwkfPlugin, PluginHooks, PluginContext } from \"./types.js\";\n\n/**\n * 定义插件的辅助函数\n * \n * @example\n * ```ts\n * export default definePlugin({\n *   name: \"my-plugin\",\n *   setup(context) {\n *     return {\n *       modifyRspackConfig(config) {\n *         // 修改配置\n *         return config;\n *       },\n *     };\n *   },\n * });\n * ```\n */\nexport function definePlugin(plugin: YwkfPlugin): YwkfPlugin {\n  return plugin;\n}\n\n/**\n * 创建带配置的插件工厂\n * \n * @example\n * ```ts\n * export default createPlugin<{ apiUrl: string }>((options) => ({\n *   name: \"api-plugin\",\n *   setup(context) {\n *     console.log(\"API URL:\", options?.apiUrl);\n *     return {};\n *   },\n * }));\n * ```\n */\nexport function createPlugin<T = Record<string, unknown>>(\n  factory: (options?: T) => YwkfPlugin\n): (options?: T) => YwkfPlugin {\n  return factory;\n}\n\n/**\n * 组合多个插件钩子\n */\nexport function composeHooks(...hooksList: PluginHooks[]): PluginHooks {\n  const composed: Record<string, Function> = {};\n\n  for (const hooks of hooksList) {\n    for (const [key, value] of Object.entries(hooks)) {\n      if (value) {\n        const existing = composed[key];\n        if (existing) {\n          composed[key] = async (...args: unknown[]) => {\n            await existing(...args);\n            return (value as Function)(...args);\n          };\n        } else {\n          composed[key] = value as Function;\n        }\n      }\n    }\n  }\n\n  return composed as PluginHooks;\n}\n","import type { Configuration as RspackConfig } from \"@rspack/core\";\nimport type { YwkfConfig } from \"../config/schema.js\";\nimport type { AppConfig, ProviderConfig } from \"../runtime/types.js\";\nimport type { RouteItem } from \"../router/types.js\";\nimport type {\n  YwkfPlugin,\n  PluginConfig,\n  PluginContext,\n  PluginHooks,\n  PluginLogger,\n} from \"./types.js\";\n\n/**\n * 创建插件日志工具\n */\nfunction createLogger(pluginName: string): PluginLogger {\n  const prefix = `[${pluginName}]`;\n\n  return {\n    info: (msg) => console.log(`${prefix} ${msg}`),\n    warn: (msg) => console.warn(`${prefix} ${msg}`),\n    error: (msg) => console.error(`${prefix} ${msg}`),\n    debug: (msg) => {\n      if (process.env.DEBUG) {\n        console.debug(`${prefix} ${msg}`);\n      }\n    },\n  };\n}\n\n/**\n * 解析插件配置\n */\nasync function resolvePlugin(\n  pluginConfig: PluginConfig,\n  cwd: string\n): Promise<{ plugin: YwkfPlugin; options: Record<string, unknown> }> {\n  let plugin: YwkfPlugin;\n  let options: Record<string, unknown> = {};\n\n  if (typeof pluginConfig === \"string\") {\n    // 字符串：插件包名\n    const module = await import(pluginConfig);\n    plugin = module.default || module;\n  } else if (Array.isArray(pluginConfig)) {\n    // 数组：[插件, 配置]\n    const [pluginOrName, pluginOptions] = pluginConfig;\n    options = pluginOptions;\n\n    if (typeof pluginOrName === \"string\") {\n      const module = await import(pluginOrName);\n      plugin = module.default || module;\n    } else {\n      plugin = pluginOrName;\n    }\n  } else {\n    // 插件对象\n    plugin = pluginConfig;\n  }\n\n  // 如果是工厂函数，调用它\n  if (typeof plugin === \"function\") {\n    plugin = (plugin as (opts?: Record<string, unknown>) => YwkfPlugin)(options);\n  }\n\n  return { plugin, options };\n}\n\n/**\n * 插件管理器\n */\nexport class PluginManager {\n  private plugins: Map<string, { plugin: YwkfPlugin; hooks: PluginHooks }> =\n    new Map();\n  private context: PluginContext;\n\n  constructor(\n    config: Required<YwkfConfig>,\n    cwd: string,\n    isDev: boolean\n  ) {\n    this.context = {\n      cwd,\n      isDev,\n      isProd: !isDev,\n      config,\n      logger: createLogger(\"PluginManager\"),\n    };\n  }\n\n  /**\n   * 加载并初始化所有插件\n   */\n  async loadPlugins(pluginConfigs: PluginConfig[]): Promise<void> {\n    for (const pluginConfig of pluginConfigs) {\n      try {\n        const { plugin } = await resolvePlugin(pluginConfig, this.context.cwd);\n\n        if (this.plugins.has(plugin.name)) {\n          this.context.logger.warn(`插件 ${plugin.name} 已加载，跳过重复加载`);\n          continue;\n        }\n\n        // 创建插件专属 logger\n        const pluginContext: PluginContext = {\n          ...this.context,\n          logger: createLogger(plugin.name),\n        };\n\n        // 调用插件 setup\n        const hooks = await plugin.setup(pluginContext);\n\n        this.plugins.set(plugin.name, { plugin, hooks });\n        this.context.logger.info(`已加载插件: ${plugin.name}`);\n      } catch (error) {\n        this.context.logger.error(\n          `加载插件失败: ${String(pluginConfig)} - ${error}`\n        );\n      }\n    }\n  }\n\n  /**\n   * 执行 modifyRspackConfig 钩子\n   */\n  async applyRspackConfigHooks(config: RspackConfig): Promise<RspackConfig> {\n    let result = config;\n\n    for (const [name, { hooks }] of this.plugins) {\n      if (hooks.modifyRspackConfig) {\n        try {\n          const modified = await hooks.modifyRspackConfig(result, this.context);\n          if (modified) {\n            result = modified;\n          }\n        } catch (error) {\n          this.context.logger.error(\n            `插件 ${name} modifyRspackConfig 执行失败: ${error}`\n          );\n        }\n      }\n    }\n\n    return result;\n  }\n\n  /**\n   * 执行 modifyRoutes 钩子\n   */\n  async applyRoutesHooks(routes: RouteItem[]): Promise<RouteItem[]> {\n    let result = routes;\n\n    for (const [name, { hooks }] of this.plugins) {\n      if (hooks.modifyRoutes) {\n        try {\n          const modified = await hooks.modifyRoutes(result, this.context);\n          if (modified) {\n            result = modified;\n          }\n        } catch (error) {\n          this.context.logger.error(\n            `插件 ${name} modifyRoutes 执行失败: ${error}`\n          );\n        }\n      }\n    }\n\n    return result;\n  }\n\n  /**\n   * 执行 modifyAppConfig 钩子\n   */\n  applyAppConfigHooks(appConfig: AppConfig): AppConfig {\n    let result = appConfig;\n\n    for (const [name, { hooks }] of this.plugins) {\n      if (hooks.modifyAppConfig) {\n        try {\n          const modified = hooks.modifyAppConfig(result, this.context);\n          if (modified) {\n            result = modified;\n          }\n        } catch (error) {\n          this.context.logger.error(\n            `插件 ${name} modifyAppConfig 执行失败: ${error}`\n          );\n        }\n      }\n    }\n\n    return result;\n  }\n\n  /**\n   * 收集所有插件的 Provider\n   */\n  collectProviders(): ProviderConfig[] {\n    const providers: ProviderConfig[] = [];\n\n    for (const [name, { hooks }] of this.plugins) {\n      if (hooks.addProvider) {\n        try {\n          const result = hooks.addProvider(this.context);\n          if (Array.isArray(result)) {\n            providers.push(...result);\n          } else if (result) {\n            providers.push(result);\n          }\n        } catch (error) {\n          this.context.logger.error(\n            `插件 ${name} addProvider 执行失败: ${error}`\n          );\n        }\n      }\n    }\n\n    return providers;\n  }\n\n  /**\n   * 执行 beforeBuild 钩子\n   */\n  async runBeforeBuild(): Promise<void> {\n    for (const [name, { hooks }] of this.plugins) {\n      if (hooks.beforeBuild) {\n        try {\n          await hooks.beforeBuild(this.context);\n        } catch (error) {\n          this.context.logger.error(\n            `插件 ${name} beforeBuild 执行失败: ${error}`\n          );\n        }\n      }\n    }\n  }\n\n  /**\n   * 执行 afterBuild 钩子\n   */\n  async runAfterBuild(stats: {\n    success: boolean;\n    errors?: string[];\n  }): Promise<void> {\n    for (const [name, { hooks }] of this.plugins) {\n      if (hooks.afterBuild) {\n        try {\n          await hooks.afterBuild(this.context, stats);\n        } catch (error) {\n          this.context.logger.error(\n            `插件 ${name} afterBuild 执行失败: ${error}`\n          );\n        }\n      }\n    }\n  }\n\n  /**\n   * 执行 beforeDevServer 钩子\n   */\n  async runBeforeDevServer(): Promise<void> {\n    for (const [name, { hooks }] of this.plugins) {\n      if (hooks.beforeDevServer) {\n        try {\n          await hooks.beforeDevServer(this.context);\n        } catch (error) {\n          this.context.logger.error(\n            `插件 ${name} beforeDevServer 执行失败: ${error}`\n          );\n        }\n      }\n    }\n  }\n\n  /**\n   * 执行 afterDevServer 钩子\n   */\n  async runAfterDevServer(server: {\n    port: number;\n    host: string;\n  }): Promise<void> {\n    for (const [name, { hooks }] of this.plugins) {\n      if (hooks.afterDevServer) {\n        try {\n          await hooks.afterDevServer(this.context, server);\n        } catch (error) {\n          this.context.logger.error(\n            `插件 ${name} afterDevServer 执行失败: ${error}`\n          );\n        }\n      }\n    }\n  }\n\n  /**\n   * 获取所有已加载的插件名称\n   */\n  getPluginNames(): string[] {\n    return Array.from(this.plugins.keys());\n  }\n\n  /**\n   * 获取所有已加载的插件\n   */\n  getPlugins(): YwkfPlugin[] {\n    return Array.from(this.plugins.values()).map((p) => p.plugin);\n  }\n\n  /**\n   * 获取所有已加载的插件钩子\n   */\n  getPluginHooks(): PluginHooks[] {\n    return Array.from(this.plugins.values()).map((p) => p.hooks);\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/router/index.d.ts

@@ -0,0 +1,126 @@
+import { Compiler } from '@rspack/core';
+
+/**
+ * 路由节点配置
+ */
+interface RouteConfig {
+    /** 路由路径 */
+    path: string;
+    /** 页面文件（page.tsx）相对路径 */
+    file?: string;
+    /** 布局文件（layout.tsx）相对路径 */
+    layoutFile?: string;
+    /** 错误边界文件（error.tsx）相对路径 */
+    errorFile?: string;
+    /** 加载状态文件（loading.tsx）相对路径 */
+    loadingFile?: string;
+    /** 通配路由文件（$.tsx）相对路径 */
+    catchAllFile?: string;
+    /** 组件名称 */
+    name: string;
+    /** 子路由 */
+    children?: RouteConfig[];
+    /** 是否为 index 路由 */
+    index?: boolean;
+    /** 是否为布局路由 */
+    isLayout?: boolean;
+    /** 是否为无路径布局（__prefix） */
+    pathless?: boolean;
+}
+interface GeneratorOptions {
+    /** 页面目录 */
+    pagesDir: string;
+    /** 输出目录 */
+    outputDir: string;
+    /** 路由 basename */
+    basename?: string;
+}
+/**
+ * Modern.js 风格约定式路由生成器
+ *
+ * 文件约定：
+ * - page.tsx     — 页面内容（叶子组件）
+ * - layout.tsx   — 布局组件（使用 <Outlet> 渲染子路由）
+ * - error.tsx    — 错误边界组件
+ * - loading.tsx  — 加载状态组件
+ * - $.tsx        — 通配/404 路由
+ *
+ * 目录约定：
+ * - [id]/        — 动态路由 → /:id
+ * - [id$]/       — 可选动态路由 → /:id?
+ * - [...slug]/   — 全匹配路由 → /*
+ * - __auth/      — 无路径布局（不生成 URL 片段）
+ * - user.profile/ — 扁平路由（. 分隔 → /user/profile）
+ */
+declare class ConventionalRouteGenerator {
+    private options;
+    constructor(options: GeneratorOptions);
+    generate(): RouteConfig[];
+    /**
+     * 扫描目录，生成路由树
+     */
+    private scanDirectory;
+    /**
+     * 解析目录名到路由路径
+     *
+     * - [id]       → :id
+     * - [id$]      → :id?
+     * - [...slug]  → *
+     * - user.profile → user/profile
+     */
+    private resolveRoutePath;
+    /**
+     * 生成有效的 JS 标识符名称
+     */
+    private generateRouteName;
+    generateCode(): string;
+    private collectImports;
+    private emitRouteArray;
+    private emitRouteObject;
+    /**
+     * 写入路由文件
+     */
+    write(): void;
+}
+/**
+ * 生成约定式路由
+ */
+declare function generateConventionalRoutes(options: GeneratorOptions): void;
+
+interface ConventionalRoutePluginOptions {
+    /** 页面目录 */
+    pagesDir: string;
+    /** 输出目录 */
+    outputDir: string;
+    /** 路由 basename */
+    basename?: string;
+    /** 是否监听文件变化（开发模式） */
+    watch?: boolean;
+}
+/**
+ * 约定式路由 Rspack 插件
+ *
+ * 在编译开始前扫描 src/pages 目录，生成 .ywkf/routes.tsx
+ */
+declare class ConventionalRoutePlugin {
+    private options;
+    private isWatching;
+    private hasGenerated;
+    private lastGeneratedContent;
+    constructor(options: ConventionalRoutePluginOptions);
+    apply(compiler: Compiler): void;
+    /**
+     * 生成路由文件（带内容比对，避免不必要的重复生成）
+     */
+    private generateRoutes;
+    /**
+     * 标准化内容（去掉时间戳等动态部分）
+     */
+    private normalizeContent;
+    /**
+     * 监听页面目录变化
+     */
+    private watchPages;
+}
+
+export { ConventionalRouteGenerator, ConventionalRoutePlugin, type ConventionalRoutePluginOptions, type GeneratorOptions, type RouteConfig, generateConventionalRoutes };