@x-all-in-one/coding-helper 0.0.0

package/dist/locales/en_US.json

@@ -0,0 +1,201 @@
+{
+  "cli": {
+    "title": "Coding Tool Helper (chelper)",
+    "usage": "Usage: chelper <command> [options]",
+    "commands": "Commands:",
+    "examples": "Examples:",
+    "error_unknown": "Unknown command: {{command}}",
+    "error_general": "Error:"
+  },
+  "commands": {
+    "help": "Show help information",
+    "version": "Show version information",
+    "init": "Run interactive initialization wizard",
+    "lang": "Language management",
+    "auth": "API key management",
+    "doctor": "Health check",
+    "enter": "Configuration management",
+    "tool": "Tool management"
+  },
+  "lang": {
+    "current": "Current language",
+    "show_usage": "chelper lang show - Show current language",
+    "set_usage": "chelper lang set <zh_CN|en_US> - Set language",
+    "changed": "Language changed from {{from}} to {{to}}",
+    "invalid": "Unsupported language: {{lang}}",
+    "available": "Available languages"
+  },
+  "auth": {
+    "set_usage": "chelper auth <service> <token> - Set API key",
+    "service_prompt": "Select service type",
+    "token_prompt": "Enter API key",
+    "token_required": "API key cannot be empty",
+    "saved": "API key saved",
+    "revoke_confirm": "Are you sure you want to revoke the API key?",
+    "revoked": "API key revoked",
+    "not_revoked": "Revoke operation cancelled",
+    "get_api_key_hint": "To obtain API Key, please visit: {{url}}",
+    "reload_usage": "chelper auth reload <tool> - Reload configuration to the tool",
+    "reloading": "Reloading configuration to {{tool}}...",
+    "reloaded": "Configuration reloaded to {{tool}} successfully",
+    "reload_failed": "Failed to reload configuration",
+    "reload_missing_config": "Missing API key configuration. Please run 'chelper auth' first.",
+    "reload_tool_not_supported": "Tool '{{tool}}' is not supported for reload"
+  },
+  "wizard": {
+    "banner_subtitle": "Manage Your Claude Code and Other Coding Tools",
+    "welcome": "Welcome to Coding Tool Helper!",
+    "privacy_note": "We value your privacy. All configurations are stored locally only.",
+    "select_language": "Select interface language",
+    "input_api_key": "Enter API key",
+    "input_your_api_key": "Please input your API key here, Enter to confirm:",
+    "update_api_key": "Update API key",
+    "api_key_required": "API key cannot be empty",
+    "select_tool": "Select coding tool to configure",
+    "tool_not_installed": "{{tool}} is not installed",
+    "install_tool_confirm": "Install now?",
+    "installing_tool": "Installing tool...",
+    "tool_installed": "Tool installed successfully",
+    "install_failed": "Installation failed",
+    "install_skipped": "Installation skipped. You can install manually later.",
+    "menu_title": "Management Menu",
+    "select_action": "Select action",
+    "action_load_config": "Apply Configuration - (Apply your configuration to {{tool}})",
+    "action_unload_config": "Unload Configuration - (Remove configuration from {{tool}})",
+    "action_view_config": "Current Configuration",
+    "action_back": "Back",
+    "action_exit": "Exit",
+    "goodbye": "Goodbye!",
+    "loading_config": "Loading configuration...",
+    "config_loaded": "Configuration loaded successfully, you can now use {{tool}} for coding.",
+    "config_load_failed": "Failed to load configuration",
+    "confirm_unload_config": "Are you sure you want to unload configuration from {{tool}}?",
+    "unloading_config": "Unloading configuration...",
+    "config_unloaded": "Configuration unloaded successfully",
+    "config_unload_failed": "Failed to unload configuration",
+    "tool_not_supported": "This operation is not supported for this tool",
+    "missing_config": "Missing required configuration (API key or models)",
+    "installed": "Installed",
+    "not_installed": "Not installed",
+    "action_install": "Install",
+    "action_uninstall": "Uninstall",
+    "current_config": "Current Configuration",
+    "config_language": "Interface Language",
+    "config_api_key": "API Key",
+    "config_title": "Configuration",
+    "not_set": "Not set",
+    "press_enter": "Press Enter to continue",
+    "main_menu_title": "Main Menu",
+    "current_config_status": "Current Configuration Status:",
+    "api_key_set": "Set",
+    "api_key_get_hint": "To obtain API Key, please visit: {{url}}",
+    "menu_config_language": "Interface language",
+    "menu_config_api_key": "Configure API Key",
+    "menu_config_models": "Configure Models",
+    "menu_config_tool": "Configure Coding Tool",
+    "menu_exit": "Exit",
+    "select_operation": "Select operation:",
+    "goodbye_message": "Goodbye!",
+    "nav_return": "Return",
+    "nav_exit": "Exit",
+    "current_active": "Current",
+    "operation_hint": "Operation Hint",
+    "hint_navigate": "↑↓ Navigate",
+    "hint_confirm": "Enter Confirm",
+    "detected_config_title": "Claude Code Current Configuration",
+    "chelper_config_title": "Chelper Configuration",
+    "claude_code_config_title": "Claude Code Current Global Configuration",
+    "config_synced": "Configuration synchronized",
+    "config_out_of_sync": "Configuration out of sync, refresh recommended",
+    "config_not_loaded": "Claude Code configuration not loaded yet",
+    "action_refresh_config": "Configuration Refresh - (Update {{tool}}'s configuration)",
+    "global_config_warning": "⚠️  Warning: You are modifying the {{tool}} global configuration. Changes will affect all workspaces",
+    "global_label": "GLOBAL",
+    "set_success": "Set successfully",
+    "start_tool": "Start {{tool}} - (Recommendation: open a new terminal in your workspace and run {{shell}} to start it)",
+    "starting_tool": "Starting...",
+    "validating_api_key": "Validating API Key...",
+    "api_key_valid": "API Key is valid",
+    "api_key_invalid": "API Key is invalid or expired",
+    "api_key_network_error": "Network error, please check your connection",
+    "select_models": "Select Models",
+    "configure_models": "Configure Model Selection",
+    "select_haiku_model": "Select Haiku Model (Fast/Small)",
+    "select_sonnet_model": "Select Sonnet Model (Default)",
+    "select_opus_model": "Select Opus Model (Large/Powerful)",
+    "current_haiku_model": "Haiku Model",
+    "current_sonnet_model": "Sonnet Model",
+    "current_opus_model": "Opus Model",
+    "fetching_models": "Fetching available models...",
+    "fetch_models_failed": "Failed to fetch models, using defaults",
+    "saving_model_config": "Saving model configuration...",
+    "model_config_saved": "Model configuration saved successfully",
+    "model_config_failed": "Failed to save model configuration",
+    "no_models_available": "No models available. Please configure API Key first.",
+    "models_config_title": "Models Configuration"
+  },
+  "doctor": {
+    "checking": "Running health check...",
+    "check_path": "Checking PATH environment variable",
+    "check_api_key_network": "Checking API Key & Network",
+    "check_api_key": "Checking API key",
+    "check_tools": "Checking installed tools",
+    "check_config": "Checking configuration",
+    "all_good": "All checks passed!",
+    "tool_installed": "Installed",
+    "tool_not_found": "Tool not found: {{tool}}",
+    "network_error": "Network connection failed",
+    "api_key_invalid": "API Key is invalid or expired",
+    "api_key_network_ok": "API Key & Network verified",
+    "api_key_missing": "API key not configured",
+    "claude_code_installed": "Claude Code is installed",
+    "claude_code_not_installed": "Claude Code is not installed. Please install it from https://claude.ai/download",
+    "config_configured": "Configuration complete",
+    "config_not_configured": "Configuration incomplete. Run 'chelper init' to configure.",
+    "suggestions": "Suggestions",
+    "check_git_env": "Check Git environment",
+    "git_not_installed": "Git is not installed. Please install Git from https://git-scm.com/downloads"
+  },
+  "messages": {
+    "initializing": "Initializing...",
+    "args": "Args:",
+    "first_run": "First run detected. Starting initialization wizard...",
+    "config_saved": "Configuration saved"
+  },
+  "install": {
+    "permission_detected": "Permission issue detected, attempting to resolve...",
+    "trying_solution": "Trying solution {{num}}: {{desc}}...",
+    "permission_fixed": "Permission issue resolved!",
+    "auto_fix_failed": "Auto-fix failed.",
+    "windows_solutions": "Windows users, please try one of the following solutions:",
+    "windows_solution_1_title": "Solution 1 (Recommended): Run as Administrator",
+    "windows_solution_1_step1": "1. Right-click Command Prompt or PowerShell",
+    "windows_solution_1_step2": "2. Select \"Run as administrator\"",
+    "windows_solution_1_step3": "3. Re-run the installation command",
+    "windows_solution_2_title": "Solution 2: Use user-level installation (no admin required)",
+    "windows_solution_2_command": "Run in command line:",
+    "unix_solutions": "Please manually try one of the following solutions:",
+    "unix_solution_1_title": "Solution 1: Install with sudo",
+    "unix_solution_1_desc": "Run the following command in terminal (requires admin password):",
+    "unix_solution_2_title": "Solution 2 (Recommended): Use nvm to manage Node.js",
+    "unix_solution_2_desc": "Using nvm avoids permission issues and is recommended by npm official",
+    "path_warning": "Please add the following path to your PATH environment variable:",
+    "path_add_method": "How to add:",
+    "all_solutions_failed": "All auto-fix solutions failed.",
+    "using_sudo": "Installing with sudo privileges",
+    "using_user_install": "Using user-level installation (no sudo required)",
+    "using_force": "Retrying with --force flag",
+    "npm_docs_link": "npm Official Documentation",
+    "what_next": "What would you like to do next?",
+    "installed_continue": "✅ I've completed the installation, continue",
+    "cancel_install": "❌ Cancel installation",
+    "user_cancelled": "User cancelled the installation",
+    "still_not_installed": "{{tool}} still does not appear to be installed",
+    "install_failed_detail": "Installation failed with error:",
+    "skip_install_confirm": "Skip the installation and install manually?",
+    "skip_install_yes": "Skip, I will install manually",
+    "skip_install_no": "Go back",
+    "retry_check": "Would you like to check the installation status again?",
+    "verified_success": "{{tool}} installation verified successfully!"
+  }
+}

package/dist/locales/zh_CN.json

@@ -0,0 +1,201 @@
+{
+  "cli": {
+    "title": "Coding Tool Helper (chelper)",
+    "usage": "用法: chelper <命令> [选项]",
+    "commands": "命令:",
+    "examples": "示例:",
+    "error_unknown": "未知命令: {{command}}",
+    "error_general": "错误:"
+  },
+  "commands": {
+    "help": "显示帮助信息",
+    "version": "显示版本信息",
+    "init": "运行交互式初始化向导",
+    "lang": "语言管理",
+    "auth": "密钥管理",
+    "doctor": "健康检查",
+    "enter": "配置管理",
+    "tool": "工具管理"
+  },
+  "lang": {
+    "current": "当前语言",
+    "show_usage": "chelper lang show - 显示当前语言",
+    "set_usage": "chelper lang set <zh_CN|en_US> - 设置语言",
+    "changed": "语言已从 {{from}} 更改为 {{to}}",
+    "invalid": "不支持的语言: {{lang}}",
+    "available": "可用语言"
+  },
+  "auth": {
+    "set_usage": "chelper auth <service> <token> - 设置API密钥",
+    "service_prompt": "请选择服务类型",
+    "token_prompt": "请输入API密钥",
+    "token_required": "API密钥不能为空",
+    "saved": "API密钥已保存",
+    "revoke_confirm": "确认要删除已保存的API密钥吗?",
+    "revoked": "API密钥已删除",
+    "not_revoked": "取消删除操作",
+    "get_api_key_hint": "如需获取 API Key，请访问: {{url}}",
+    "reload_usage": "chelper auth reload <tool> - 重新加载配置到工具",
+    "reloading": "正在重新加载配置到 {{tool}}...",
+    "reloaded": "配置已成功重新加载到 {{tool}}",
+    "reload_failed": "重新加载配置失败",
+    "reload_missing_config": "缺少 API Key 配置，请先运行 'chelper auth' 进行配置",
+    "reload_tool_not_supported": "工具 '{{tool}}' 不支持 reload 操作"
+  },
+  "wizard": {
+    "banner_subtitle": "统一管理您的 Claude Code 等编码工具",
+    "welcome": "欢迎使用编码工具助手!",
+    "privacy_note": "我们重视您的隐私,所有配置信息仅保存在本地.",
+    "select_language": "请选择界面语言",
+    "input_api_key": "输入 API Key",
+    "input_your_api_key": "请在这里输入您的 API key, 回车键确认:",
+    "update_api_key": "更新 API Key",
+    "api_key_required": "API密钥不能为空",
+    "select_tool": "请选择要配置的编码工具",
+    "tool_not_installed": "{{tool}} 尚未安装",
+    "install_tool_confirm": "是否现在安装?",
+    "installing_tool": "正在安装工具...",
+    "tool_installed": "工具安装成功",
+    "install_failed": "安装失败",
+    "install_skipped": "已跳过安装,您可以稍后手动安装",
+    "menu_title": "管理菜单",
+    "select_action": "请选择操作",
+    "action_load_config": "配置装载 - (将您的配置应用到 {{tool}})",
+    "action_unload_config": "配置卸载 - (从 {{tool}} 中移除配置)",
+    "action_view_config": "当前配置",
+    "action_back": "返回",
+    "action_exit": "退出",
+    "goodbye": "再见!",
+    "loading_config": "正在装载配置...",
+    "config_loaded": "配置已成功装载，您现在可以使用 {{tool}} 进行编码了。",
+    "config_load_failed": "配置装载失败",
+    "confirm_unload_config": "确认要从 {{tool}} 中卸载配置吗？",
+    "unloading_config": "正在卸载配置...",
+    "config_unloaded": "配置已成功卸载",
+    "config_unload_failed": "配置卸载失败",
+    "tool_not_supported": "该工具不支持此操作",
+    "missing_config": "缺少必要配置(API密钥或模型)",
+    "installed": "已安装",
+    "not_installed": "未安装",
+    "action_install": "安装",
+    "action_uninstall": "卸载",
+    "current_config": "当前配置",
+    "config_language": "界面语言",
+    "config_api_key": "API Key",
+    "config_title": "配置",
+    "not_set": "未设置",
+    "press_enter": "按回车继续",
+    "main_menu_title": "主菜单",
+    "current_config_status": "当前配置状态:",
+    "api_key_set": "已设置",
+    "api_key_get_hint": "如需获取 API Key，请访问: {{url}}",
+    "menu_config_language": "界面语言",
+    "menu_config_api_key": "配置 API Key",
+    "menu_config_models": "配置模型",
+    "menu_config_tool": "配置编码工具",
+    "menu_exit": "退出",
+    "select_operation": "请选择操作:",
+    "goodbye_message": "再见!",
+    "nav_return": "返回",
+    "nav_exit": "退出",
+    "current_active": "当前",
+    "operation_hint": "操作提示",
+    "hint_navigate": "↑↓ 选择",
+    "hint_confirm": "Enter 确认",
+    "detected_config_title": "Claude Code 当前配置",
+    "chelper_config_title": "Chelper 配置",
+    "claude_code_config_title": "Claude Code 当前全局配置",
+    "config_synced": "配置已同步",
+    "config_out_of_sync": "配置不一致，建议刷新",
+    "config_not_loaded": "Claude Code 尚未装载配置",
+    "action_refresh_config": "配置刷新 - (更新 {{tool}} 的配置)",
+    "global_config_warning": "⚠️  注意：您正在修改 {{tool}} 全局配置，更改将影响所有工作区",
+    "global_label": "全局",
+    "set_success": "设置成功",
+    "start_tool": "启动 {{tool}} - (建议在您的工作空间新开终端，执行 {{shell}} 启动)",
+    "starting_tool": "启动中...",
+    "validating_api_key": "正在验证 API Key...",
+    "api_key_valid": "API Key 验证通过",
+    "api_key_invalid": "API Key 无效或已过期",
+    "api_key_network_error": "网络错误，请检查网络连接",
+    "select_models": "选择模型",
+    "configure_models": "配置模型选择",
+    "select_haiku_model": "选择 Haiku 模型 (快速/小型)",
+    "select_sonnet_model": "选择 Sonnet 模型 (默认)",
+    "select_opus_model": "选择 Opus 模型 (大型/强大)",
+    "current_haiku_model": "Haiku 模型",
+    "current_sonnet_model": "Sonnet 模型",
+    "current_opus_model": "Opus 模型",
+    "fetching_models": "正在获取可用模型列表...",
+    "fetch_models_failed": "获取模型列表失败，使用默认值",
+    "saving_model_config": "正在保存模型配置...",
+    "model_config_saved": "模型配置保存成功",
+    "model_config_failed": "模型配置保存失败",
+    "no_models_available": "没有可用的模型，请先配置 API Key。",
+    "models_config_title": "模型配置"
+  },
+  "doctor": {
+    "checking": "正在进行健康检查...",
+    "check_path": "检查PATH环境变量",
+    "check_api_key_network": "检查 API Key 和网络连接",
+    "check_api_key": "检查API密钥",
+    "check_tools": "检查已安装的工具",
+    "check_config": "检查配置",
+    "all_good": "所有检查通过!",
+    "tool_installed": "已安装",
+    "tool_not_found": "工具未找到: {{tool}}",
+    "network_error": "网络连接失败",
+    "api_key_invalid": "API Key 无效或已过期",
+    "api_key_network_ok": "API Key 和网络验证通过",
+    "api_key_missing": "API密钥未配置",
+    "claude_code_installed": "Claude Code 已安装",
+    "claude_code_not_installed": "Claude Code 未安装。请从 https://claude.ai/download 下载安装",
+    "config_configured": "配置完成",
+    "config_not_configured": "配置未完成。请运行 'chelper init' 进行配置",
+    "suggestions": "建议",
+    "check_git_env": "检查 Git 环境",
+    "git_not_installed": "Git 未安装。请从 https://git-scm.com/downloads 下载安装"
+  },
+  "messages": {
+    "initializing": "正在初始化...",
+    "args": "参数:",
+    "first_run": "检测到首次运行,启动初始化向导...",
+    "config_saved": "配置已保存"
+  },
+  "install": {
+    "permission_detected": "检测到权限问题，正在尝试解决...",
+    "trying_solution": "尝试方案 {{num}}: {{desc}}...",
+    "permission_fixed": "权限问题已解决！",
+    "auto_fix_failed": "自动修复失败。",
+    "windows_solutions": "Windows 用户请尝试以下方案之一：",
+    "windows_solution_1_title": "方案 1（推荐）: 以管理员身份运行",
+    "windows_solution_1_step1": "1. 右键点击命令提示符或 PowerShell",
+    "windows_solution_1_step2": "2. 选择 \"以管理员身份运行\"",
+    "windows_solution_1_step3": "3. 重新运行安装命令",
+    "windows_solution_2_title": "方案 2: 使用用户级安装（无需管理员权限）",
+    "windows_solution_2_command": "在命令行中运行：",
+    "unix_solutions": "请手动尝试以下方案之一：",
+    "unix_solution_1_title": "方案 1: 使用 sudo 安装",
+    "unix_solution_1_desc": "在终端中运行以下命令（需要输入管理员密码）：",
+    "unix_solution_2_title": "方案 2（推荐）: 使用 nvm 管理 Node.js",
+    "unix_solution_2_desc": "使用 nvm 可以避免权限问题，这是 npm 官方推荐的方案",
+    "path_warning": "请将以下路径添加到您的 PATH 环境变量中：",
+    "path_add_method": "添加方法：",
+    "all_solutions_failed": "所有自动修复方案均失败。",
+    "using_sudo": "使用 sudo 权限安装",
+    "using_user_install": "使用用户级安装（无需 sudo）",
+    "using_force": "使用 --force 参数重试",
+    "npm_docs_link": "npm 官方文档",
+    "what_next": "请选择下一步操作",
+    "installed_continue": "✅ 我已完成安装，继续",
+    "cancel_install": "❌ 取消安装",
+    "user_cancelled": "用户取消了安装",
+    "still_not_installed": "{{tool}} 似乎仍未安装成功",
+    "install_failed_detail": "安装失败，错误信息:",
+    "skip_install_confirm": "是否跳过安装过程，自行安装后继续？",
+    "skip_install_yes": "跳过，我将自行安装",
+    "skip_install_no": "返回",
+    "retry_check": "是否重新检查安装状态？",
+    "verified_success": "{{tool}} 安装验证成功！"
+  }
+}

package/dist/utils/logger.d.ts

@@ -0,0 +1,17 @@
+export declare enum LogLevel {
+    DEBUG = 0,
+    INFO = 1,
+    WARN = 2,
+    ERROR = 3
+}
+export declare class Logger {
+    private static instance;
+    private logLevel;
+    private constructor();
+    static getInstance(): Logger;
+    setLogLevel(level: LogLevel): void;
+    debug(message: string, ...args: any[]): void;
+    info(message: string, ...args: any[]): void;
+    warn(message: string, ...args: any[]): void;
+    error(message: string, ...args: any[]): void;
+}

package/dist/utils/logger.js

@@ -0,0 +1,41 @@
+export var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["DEBUG"] = 0] = "DEBUG";
+    LogLevel[LogLevel["INFO"] = 1] = "INFO";
+    LogLevel[LogLevel["WARN"] = 2] = "WARN";
+    LogLevel[LogLevel["ERROR"] = 3] = "ERROR";
+})(LogLevel || (LogLevel = {}));
+export class Logger {
+    static instance;
+    logLevel = LogLevel.INFO;
+    constructor() { }
+    static getInstance() {
+        if (!Logger.instance) {
+            Logger.instance = new Logger();
+        }
+        return Logger.instance;
+    }
+    setLogLevel(level) {
+        this.logLevel = level;
+    }
+    debug(message, ...args) {
+        if (this.logLevel <= LogLevel.DEBUG) {
+            console.debug(`[DEBUG] ${message}`, ...args);
+        }
+    }
+    info(message, ...args) {
+        if (this.logLevel <= LogLevel.INFO) {
+            console.info(`[INFO] ${message}`, ...args);
+        }
+    }
+    warn(message, ...args) {
+        if (this.logLevel <= LogLevel.WARN) {
+            console.warn(`[WARN] ${message}`, ...args);
+        }
+    }
+    error(message, ...args) {
+        if (this.logLevel <= LogLevel.ERROR) {
+            console.error(`[ERROR] ${message}`, ...args);
+        }
+    }
+}

package/dist/utils/string-width.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Calculate the visual display width of a string
+ * Handles emoji, CJK characters, and ANSI escape codes
+ */
+/**
+ * Strip ANSI escape codes from a string
+ */
+export declare function stripAnsi(str: string): string;
+/**
+ * Calculate the visual display width of a string
+ * Strips ANSI codes and counts visual width of each character
+ */
+export declare function stringWidth(str: string): number;
+/**
+ * Pad a string to a specific visual width
+ * @param str - The string to pad
+ * @param targetWidth - The target visual width
+ * @param char - The character to use for padding (default: space)
+ * @param align - Alignment: 'left', 'right', or 'center' (default: 'left')
+ */
+export declare function padString(str: string, targetWidth: number, char?: string, align?: 'left' | 'right' | 'center'): string;
+/**
+ * Create a box border line
+ * @param leftChar - Left border character
+ * @param rightChar - Right border character
+ * @param fillChar - Fill character
+ * @param width - Total width including borders
+ */
+export declare function createBorderLine(leftChar: string, rightChar: string, fillChar: string, width: number): string;
+/**
+ * Create a box content line with borders
+ * @param content - The content to display
+ * @param leftChar - Left border character
+ * @param rightChar - Right border character
+ * @param width - Total width including borders
+ * @param align - Content alignment
+ */
+export declare function createContentLine(content: string, leftChar: string, rightChar: string, width: number, align?: 'left' | 'right' | 'center'): string;

package/dist/utils/string-width.js

@@ -0,0 +1,130 @@
+/**
+ * Calculate the visual display width of a string
+ * Handles emoji, CJK characters, and ANSI escape codes
+ */
+/**
+ * Strip ANSI escape codes from a string
+ */
+export function stripAnsi(str) {
+    // eslint-disable-next-line no-control-regex
+    return str.replace(/\u001b\[[0-9;]*m/g, '');
+}
+/**
+ * Calculate the visual width of a character
+ * - Emoji and wide characters (CJK): 2
+ * - Regular ASCII: 1
+ * - Zero-width characters: 0
+ */
+function charWidth(char) {
+    const code = char.codePointAt(0);
+    if (!code)
+        return 0;
+    // Zero-width characters
+    if (code === 0x200b || // Zero-width space
+        code === 0x200c || // Zero-width non-joiner
+        code === 0x200d || // Zero-width joiner
+        code === 0xfeff || // Zero-width no-break space
+        (code >= 0xfe00 && code <= 0xfe0f) // Variation Selectors (emoji style selectors)
+    ) {
+        return 0;
+    }
+    // Emoji and symbols (rough approximation)
+    // Most emoji are in these ranges and display as 2 characters wide
+    if ((code >= 0x1f300 && code <= 0x1f9ff) || // Misc Symbols and Pictographs, Emoticons, etc.
+        (code >= 0x2600 && code <= 0x26ff) || // Misc symbols
+        (code >= 0x2700 && code <= 0x27bf) || // Dingbats
+        (code >= 0x1f000 && code <= 0x1f02f) || // Mahjong Tiles, Domino Tiles
+        (code >= 0x1f0a0 && code <= 0x1f0ff) // Playing Cards
+    ) {
+        return 2;
+    }
+    // CJK characters (Chinese, Japanese, Korean)
+    // These are typically displayed as 2 characters wide
+    if ((code >= 0x4e00 && code <= 0x9fff) || // CJK Unified Ideographs
+        (code >= 0x3400 && code <= 0x4dbf) || // CJK Unified Ideographs Extension A
+        (code >= 0x20000 && code <= 0x2a6df) || // CJK Unified Ideographs Extension B
+        (code >= 0x2a700 && code <= 0x2b73f) || // CJK Unified Ideographs Extension C
+        (code >= 0x2b740 && code <= 0x2b81f) || // CJK Unified Ideographs Extension D
+        (code >= 0x2b820 && code <= 0x2ceaf) || // CJK Unified Ideographs Extension E
+        (code >= 0xf900 && code <= 0xfaff) || // CJK Compatibility Ideographs
+        (code >= 0x2f800 && code <= 0x2fa1f) || // CJK Compatibility Ideographs Supplement
+        (code >= 0x3040 && code <= 0x309f) || // Hiragana
+        (code >= 0x30a0 && code <= 0x30ff) || // Katakana
+        (code >= 0xac00 && code <= 0xd7af) || // Hangul Syllables
+        (code >= 0x1100 && code <= 0x11ff) || // Hangul Jamo
+        (code >= 0x3130 && code <= 0x318f) || // Hangul Compatibility Jamo
+        (code >= 0xa960 && code <= 0xa97f) || // Hangul Jamo Extended-A
+        (code >= 0xd7b0 && code <= 0xd7ff) // Hangul Jamo Extended-B
+    ) {
+        return 2;
+    }
+    // Fullwidth characters
+    if (code >= 0xff00 && code <= 0xffef) {
+        return 2;
+    }
+    // Default to 1 for regular ASCII and other characters
+    return 1;
+}
+/**
+ * Calculate the visual display width of a string
+ * Strips ANSI codes and counts visual width of each character
+ */
+export function stringWidth(str) {
+    const cleaned = stripAnsi(str);
+    let width = 0;
+    // Use Array.from to properly handle surrogate pairs
+    for (const char of Array.from(cleaned)) {
+        width += charWidth(char);
+    }
+    return width;
+}
+/**
+ * Pad a string to a specific visual width
+ * @param str - The string to pad
+ * @param targetWidth - The target visual width
+ * @param char - The character to use for padding (default: space)
+ * @param align - Alignment: 'left', 'right', or 'center' (default: 'left')
+ */
+export function padString(str, targetWidth, char = ' ', align = 'left') {
+    const currentWidth = stringWidth(str);
+    const padWidth = Math.max(0, targetWidth - currentWidth);
+    if (padWidth === 0)
+        return str;
+    const padding = char.repeat(padWidth);
+    if (align === 'right') {
+        return padding + str;
+    }
+    else if (align === 'center') {
+        const leftPad = Math.floor(padWidth / 2);
+        const rightPad = padWidth - leftPad;
+        return char.repeat(leftPad) + str + char.repeat(rightPad);
+    }
+    else {
+        return str + padding;
+    }
+}
+/**
+ * Create a box border line
+ * @param leftChar - Left border character
+ * @param rightChar - Right border character
+ * @param fillChar - Fill character
+ * @param width - Total width including borders
+ */
+export function createBorderLine(leftChar, rightChar, fillChar, width) {
+    const innerWidth = width - stringWidth(leftChar) - stringWidth(rightChar);
+    return leftChar + fillChar.repeat(Math.max(0, innerWidth)) + rightChar;
+}
+/**
+ * Create a box content line with borders
+ * @param content - The content to display
+ * @param leftChar - Left border character
+ * @param rightChar - Right border character
+ * @param width - Total width including borders
+ * @param align - Content alignment
+ */
+export function createContentLine(content, leftChar, rightChar, width, align = 'left') {
+    const borderWidth = stringWidth(leftChar) + stringWidth(rightChar);
+    const innerWidth = width - borderWidth;
+    const paddedContent = padString(content, innerWidth, ' ', align);
+    return leftChar + paddedContent + rightChar;
+}