superun-ai-cli 0.1.19 → 0.1.22

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

@@ -0,0 +1,105 @@
+/**
+ * 路由解析工具
+ * @author xiuyu.yi
+ * 移植自 Glow client/src/pages/project/utils/route-parser.ts，保持同源分组和排序规则。
+ *
+ * 从 App.tsx / routes.tsx 内容中解析路由信息，支持：
+ * - 多端路由分端：JSX 取 handle={{ side }}（结构化优先）/ `// @side:` 注释兜底；data-mode 取 RouteObject 的 handle.side
+ * - JSX <Route>（App.tsx）与 RouteObject[]（routes.tsx，data-mode/SSR）两种路由源
+ * - 嵌套路由 / 扁平路由 / 单组件应用
+ */
+export type Route = {
+    path: string;
+    name: string;
+    codePath?: string;
+    side?: string;
+};
+export type RouteGroup = {
+    side: string;
+    label: string;
+    basePath: string;
+    routes: Route[];
+};
+/** 路由配置文件查找顺序：独立 routes.tsx 优先于 App.tsx */
+export declare const ROUTE_CONFIG_FILENAMES: readonly ["src/routes.tsx", "src/App.tsx"];
+export type RouteConfigAttachmentCandidate = {
+    name: string;
+    content?: string;
+};
+export declare function matchesRouteConfigFilename(name: string, filename: (typeof ROUTE_CONFIG_FILENAMES)[number]): boolean;
+/**
+ * 从 attachments 中查找带 content 的路由配置文件（routes.tsx 优先，其次 App.tsx）
+ * 原实现作者：lidewen
+ */
+export declare function findRouteConfigAttachment<T extends RouteConfigAttachmentCandidate>(attachments: readonly T[]): T | undefined;
+/**
+ * 规范化 import 路径
+ * 将 @/ 或 ./ 转换为 src/，并添加文件扩展名
+ */
+export declare const normalizeImportPath: (importPath: string) => string;
+/**
+ * 判断路由是否为动态路由（包含 :param 动态参数或 * 通配符）
+ * 例如：/users/:id -> true, /products/:category/:slug -> true, /about -> false
+ */
+export declare const isDynamicRoute: (path: string) => boolean;
+/**
+ * 将组件名转换为友好的显示名称
+ * 例如：UserProfile -> User Profile
+ */
+export declare const toFriendlyName: (componentName: string) => string;
+/**
+ * 解析 import 语句，建立组件名到文件路径的映射
+ */
+export declare const parseImportMap: (content: string) => Record<string, string>;
+/**
+ * 从 `const xxxRoutes = ( ... )` 的路由块推断该端 basePath（对应最外层 Route 的 path）。
+ * 只在「第一个 `<Route` 到第二个 `<Route` 之前」的片段里找 path，避免把子路由的 path 误当成父级 base。
+ * 若父级为无 path 的 layout（仅 element），则视为挂载在根 `/`。
+ * 原实现作者：lidewen
+ */
+export declare function inferGroupBasePathFromRouteBlock(routeBlock: string): string;
+/**
+ * 从路由块抽出顶层 <Route> 的 handle={{ side: "X" }} 的 X。
+ * 这是结构化的分端标记，比 `// @side:` 注释更抗格式化/重生成；约定里每端顶层 <Route> 带 handle、
+ * 子路由继承不重复，故取首个匹配即该组的 side。读不到（无 handle）→ undefined，由调用方回退注释/变量名。
+ */
+export declare function extractHandleSideFromRouteBlock(routeBlock: string): string | undefined;
+/**
+ * 从嵌套路由块中解析路由
+ */
+export declare const parseNestedRoutes: (routeBlock: string, parentPath: string, side: string, importMap: Record<string, string>) => Route[];
+/**
+ * 从变量名推断 side 名称
+ * 例如：adminRoutes -> Admin, userRoutes -> User, workspaceGroup -> Workspace
+ */
+export declare const inferSideFromVarName: (varName: string) => string;
+/**
+ * 解析扁平路由（兼容旧格式，无 @side 注释）
+ */
+export declare const parseFlatRoutes: (content: string, importMap: Record<string, string>) => Route[];
+/**
+ * 从 App.tsx 内容中解析路由分组
+ *
+ * 解析优先级：
+ * 1. 带 @side 注释的路由组
+ * 2. 缺少注释的 xxxRoutes 变量
+ * 3. 扁平路由
+ * 4. 默认路由
+ */
+export declare const parseRouteGroupsFromAppTsx: (content: string, onFallback?: () => void) => RouteGroup[];
+/**
+ * 从 routes.tsx 的 RouteObject[] 解析路由分组（data-mode / SSR 项目）。
+ * 解析不出（非 RouteObject、无 routes 数组、异常）→ 返回 []，交回上层兜底。
+ */
+export declare const parseRouteGroupsFromRouteObjects: (content: string) => RouteGroup[];
+/**
+ * 路由分组统一入口（自动分发）：
+ * - 含 JSX `<Route>` → 走 parseRouteGroupsFromAppTsx（CSR / 原型项目）
+ * - 否则尝试 RouteObject[] 解析（data-mode / SSR 的 routes.tsx）
+ * - 都解析不出 → 回到 parseRouteGroupsFromAppTsx 的兜底（默认单条 /）
+ */
+export declare const parseRouteGroups: (content: string, onFallback?: () => void) => RouteGroup[];
+/**
+ * 创建默认路由分组
+ */
+export declare const createDefaultRouteGroups: () => RouteGroup[];