colyn-cli 3.1.4

package/dist/core/tmux-config.legacy.d.ts

@@ -0,0 +1,243 @@
+/**
+ * Tmux Pane 命令配置模块
+ *
+ * 提供 tmux pane 命令的配置加载和自动检测功能
+ *
+ * 配置文件层级（优先级从低到高）：
+ * 1. 内置默认值
+ * 2. 用户级配置：~/.config/colyn/settings.json
+ * 3. 项目级配置：{projectRoot}/.colyn/settings.json
+ */
+/**
+ * 内置命令常量
+ */
+export declare const BUILTIN_COMMANDS: {
+    /** 启动 dev server */
+    readonly AUTO_DEV_SERVER: "start dev server";
+    /** 继续 Claude 会话 */
+    readonly AUTO_CLAUDE: "continue claude session";
+};
+/**
+ * 支持的布局类型
+ */
+export type LayoutType = 'single-pane' | 'two-pane-horizontal' | 'two-pane-vertical' | 'three-pane' | 'four-pane';
+/**
+ * 窗格名称映射表
+ * 定义每种布局支持的窗格名称
+ */
+export declare const LAYOUT_PANES: Record<LayoutType, string[]>;
+/**
+ * Pane 命令配置值
+ * - 内置命令：使用预定义的自动检测逻辑
+ * - string: 自定义命令
+ * - null: 不执行任何命令
+ */
+export type PaneCommand = typeof BUILTIN_COMMANDS.AUTO_DEV_SERVER | typeof BUILTIN_COMMANDS.AUTO_CLAUDE | string | null;
+/**
+ * 单个 Pane 的配置
+ */
+export interface PaneConfig {
+    /** 要执行的命令 */
+    command?: PaneCommand;
+    /** Pane 大小（百分比，如 "50%"） */
+    size?: string;
+}
+/**
+ * Tmux 配置接口
+ */
+export interface TmuxConfig {
+    /** 是否自动运行命令，false 禁用所有自动运行 */
+    autoRun?: boolean;
+    /** 布局类型 */
+    layout?: LayoutType;
+    /** 窗格配置 - 根据 layout 类型使用不同的窗格 */
+    leftPane?: PaneConfig;
+    rightPane?: PaneConfig;
+    topPane?: PaneConfig;
+    bottomPane?: PaneConfig;
+    topRightPane?: PaneConfig;
+    bottomRightPane?: PaneConfig;
+    topLeftPane?: PaneConfig;
+    bottomLeftPane?: PaneConfig;
+    /** 四窗格布局的分割配置 */
+    horizontalSplit?: string;
+    verticalSplit?: string;
+}
+/**
+ * 解析后的 Pane 命令
+ */
+export interface ResolvedPaneCommands {
+    /** Pane 0 命令 */
+    pane0?: string;
+    /** Pane 1 命令 */
+    pane1?: string;
+    /** Pane 2 命令 */
+    pane2?: string;
+    /** Pane 3 命令（四窗格布局） */
+    pane3?: string;
+}
+/**
+ * 解析后的 Pane 布局
+ */
+export interface ResolvedPaneLayout {
+    /** 布局类型 */
+    layout: LayoutType;
+    /** two-pane-horizontal: 左侧大小 */
+    leftSize?: number;
+    /** two-pane-vertical: 上方大小 */
+    topSize?: number;
+    /** three-pane: 左侧大小和右上大小 */
+    rightTopSize?: number;
+    /** four-pane: 水平分割位置（上方占总高度的百分比） */
+    horizontalSplit?: number;
+    /** four-pane: 垂直分割位置（左侧占总宽度的百分比） */
+    verticalSplit?: number;
+    /** four-pane: 各窗格大小（当未同时配置两个 split 时使用） */
+    topLeftSize?: number;
+    topRightSize?: number;
+    bottomLeftSize?: number;
+    bottomRightSize?: number;
+}
+/**
+ * 系统命令配置
+ */
+export interface SystemCommands {
+    /** 包管理器命令（默认为 'npm'） */
+    npm?: string;
+    /** Claude 命令（默认为 'claude'） */
+    claude?: string;
+}
+/**
+ * 统一设置文件结构
+ */
+export interface Settings {
+    /** 配置文件版本号 */
+    version?: number;
+    /** 界面语言 */
+    lang?: string;
+    /** 系统命令配置 */
+    systemCommands?: SystemCommands;
+    /** tmux 相关配置 */
+    tmux?: TmuxConfig;
+    /** 分支特定配置覆盖 */
+    branchOverrides?: Record<string, Settings>;
+}
+/**
+ * 当前配置文件版本号
+ */
+export declare const CURRENT_CONFIG_VERSION = 3;
+/**
+ * 获取用户级配置目录
+ * 遵循 XDG Base Directory 规范
+ */
+export declare function getUserConfigDir(): string;
+/**
+ * 获取用户级设置文件路径
+ */
+export declare function getUserConfigPath(): string;
+/**
+ * 获取项目级设置文件路径
+ * @param projectRoot 项目根目录
+ */
+export declare function getProjectConfigPath(projectRoot: string): string;
+/**
+ * 从设置文件加载完整设置（用于 config 命令显示）
+ * 自动执行必要的 migration 并保存更新后的配置
+ * @param configPath 设置文件路径
+ * @returns 完整设置对象，如果文件不存在或无法解析则返回 null
+ */
+export declare function loadSettingsFromFile(configPath: string): Promise<Settings | null>;
+/**
+ * 加载 tmux 配置（两层配置机制）
+ *
+ * 配置加载顺序（优先级从低到高）：
+ * 1. 内置默认值
+ * 2. 用户级配置：~/.config/colyn/settings.json 中的 tmux 字段
+ * 3. 项目级配置：{projectRoot}/.colyn/settings.json 中的 tmux 字段
+ *
+ * @param projectRoot 项目根目录
+ * @returns 合并后的配置对象
+ */
+export declare function loadTmuxConfig(projectRoot: string): Promise<TmuxConfig>;
+/**
+ * 检查 worktree 是否存在 Claude session
+ * 通过检查 ~/.claude/projects/{encodedPath} 下是否存在会话文件来判断
+ * @param worktreePath worktree 路径
+ */
+export declare function hasClaudeSession(worktreePath: string): Promise<boolean>;
+/**
+ * 解析所有 pane 命令
+ * @param config tmux 配置
+ * @param worktreePath worktree 路径
+ * @param projectRoot 项目根目录（可选，用于读取 claudeCommand 配置）
+ * @param branchName 分支名称（可选，用于读取分支特定的 claudeCommand 配置）
+ */
+export declare function resolvePaneCommands(config: TmuxConfig, worktreePath: string, projectRoot?: string, branchName?: string): Promise<ResolvedPaneCommands>;
+/**
+ * 解析 Pane 布局配置
+ * @param config tmux 配置
+ */
+export declare function resolvePaneLayout(config: TmuxConfig): ResolvedPaneLayout;
+/**
+ * 配置验证结果
+ */
+export interface ValidationResult {
+    /** 是否有错误 */
+    hasError: boolean;
+    /** 错误消息列表 */
+    errors: string[];
+    /** 警告消息列表 */
+    warnings: string[];
+}
+/**
+ * 检测布局类型
+ * 根据配置的窗格自动检测布局类型（向后兼容）
+ * @param config tmux 配置
+ * @returns 检测到的布局类型
+ */
+export declare function detectLayoutType(config: TmuxConfig): LayoutType;
+/**
+ * 验证 tmux 配置
+ * @param config tmux 配置
+ * @returns 验证结果
+ */
+export declare function validateTmuxConfig(config: TmuxConfig): ValidationResult;
+/**
+ * 从设置中加载特定分支的配置
+ * @param settings 完整设置对象
+ * @param branchName 分支名称
+ * @returns 合并后的设置
+ */
+export declare function loadBranchSettings(settings: Settings, branchName: string): Settings;
+/**
+ * 加载特定分支的完整设置
+ *
+ * 配置优先级（从低到高）：
+ * 1. User default（用户级全局配置）
+ * 2. Project default（项目级全局配置）
+ * 3. User override（用户级分支覆盖）
+ * 4. Project override（项目级分支覆盖）
+ *
+ * @param projectRoot 项目根目录
+ * @param branchName 分支名称
+ * @returns 合并后的完整设置
+ */
+export declare function loadSettingsForBranch(projectRoot: string, branchName: string): Promise<Settings>;
+/**
+ * 加载特定分支的 tmux 配置
+ *
+ * 配置优先级（从低到高）：
+ * 1. System builtin（系统内置默认，如 main 分支默认单窗格）
+ * 2. User default（用户级全局配置，~/.config/colyn/settings.json 的 tmux）
+ * 3. Project default（项目级全局配置，.colyn/settings.json 的 tmux）
+ * 4. User override（用户级分支覆盖，~/.config/colyn/settings.json 的 branchOverrides[branch].tmux）
+ * 5. Project override（项目级分支覆盖，.colyn/settings.json 的 branchOverrides[branch].tmux）
+ *
+ * 全部按照字段级覆盖（field-level override）
+ *
+ * @param projectRoot 项目根目录
+ * @param branchName 分支名称
+ * @returns 合并后的 tmux 配置
+ */
+export declare function loadTmuxConfigForBranch(projectRoot: string, branchName: string): Promise<TmuxConfig>;
+//# sourceMappingURL=tmux-config.legacy.d.ts.map

package/dist/core/tmux-config.legacy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tmux-config.legacy.d.ts","sourceRoot":"","sources":["../../src/core/tmux-config.legacy.ts"],"names":[],"mappings":"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"}