@kikkimo/claude-launcher 3.0.0 → 3.1.0

package/lib/ui/i18n-labels.js

@@ -0,0 +1,16 @@
+/**
+ * Shared i18n label resolver for config field display names.
+ */
+const i18n = require('../i18n');
+
+/**
+ * Resolve a config label via i18n first, fall back to constant map.
+ */
+function i18nLabel(section, key, fallbackMap) {
+    const i18nKey = 'config_labels.' + section + '.' + key;
+    const val = i18n.tSync(i18nKey);
+    if (val !== i18nKey) return val;
+    return fallbackMap[key] || key;
+}
+
+module.exports = { i18nLabel };

package/lib/ui/menu.js

@@ -61,8 +61,11 @@ class Menu {
      * Display menu with current selection
      * @param {string} versionInfo - Optional version info to display between banner and navigation
      * @param {Function|null} hintCallback - Optional sync callback(selectedIndex) returning hint string or null
+     * @param {string} navigationKey - i18n key for navigation hint (default: 'navigation.use_arrows')
      */
-    displayMenu(versionInfo = null, hintCallback = null) {
+    displayMenu(versionInfo = null, hintCallback = null, navigationKey = 'navigation.use_arrows') {
+        this._navigationKey = navigationKey;
+        const isTTY = process.stdin.isTTY;
         const lines = [];
         lines.push('');
         lines.push(colors.orange + '  ┌──────────────────────────────────────────────────────┐' + colors.reset);
@@ -75,16 +78,18 @@ class Menu {
             lines.push('');
         }
 
-        lines.push(colors.gray + '  ' + i18n.tSync('navigation.use_arrows') + colors.reset);
+        lines.push(colors.gray + '  ' + i18n.tSync(navigationKey) + colors.reset);
         lines.push('');
 
         this.menuOptions.forEach((option, index) => {
+            const prefix = isTTY ? '' : (index + 1) + '. ';
             if (index === this.selectedIndex) {
-                const displayWidth = getStringWidth(option);
-                const paddedOption = padStringToWidth(option, Math.max(40, displayWidth + 2));
+                const prefixedOption = prefix + option;
+                const displayWidth = getStringWidth(prefixedOption);
+                const paddedOption = padStringToWidth(prefixedOption, Math.max(40, displayWidth + 2));
                 lines.push(colors.orange + '  → ' + colors.black + colors.bgAmber + paddedOption + colors.reset);
             } else {
-                lines.push(colors.gray + '    ' + option + colors.reset);
+                lines.push(colors.gray + '    ' + prefix + option + colors.reset);
             }
         });
 
@@ -127,8 +132,9 @@ class Menu {
      * Handle keyboard navigation
      * @param {string} versionInfo - Optional version info to display
      * @param {Function|null} hintCallback - Optional sync callback(selectedIndex) returning hint string or null
+     * @param {string} navigationKey - i18n key for navigation hint (default: 'navigation.use_arrows')
      */
-    async navigate(versionInfo = null, hintCallback = null) {
+    async navigate(versionInfo = null, hintCallback = null, navigationKey = 'navigation.use_arrows') {
         // Guard against empty menu to prevent NaN from modulo operations
         if (!this.menuOptions || this.menuOptions.length === 0) {
             screen.write(colors.yellow + '  Warning: No menu options available' + colors.reset + '\n');
@@ -139,7 +145,7 @@ class Menu {
         this.hintCallback = hintCallback; // Store for redrawing
 
         return new Promise((resolve, reject) => {
-            this.displayMenu(versionInfo, hintCallback);
+            this.displayMenu(versionInfo, hintCallback, navigationKey);
 
             if (process.stdin.isTTY) {
                 const scope = stdinManager.acquire('raw', {
@@ -192,12 +198,12 @@ class Menu {
                         switch (key) {
                             case '\u001b[A': // Up arrow
                                 this.selectedIndex = (this.selectedIndex - 1 + this.menuOptions.length) % this.menuOptions.length;
-                                this.displayMenu(this.versionInfo, this.hintCallback);
+                                this.displayMenu(this.versionInfo, this.hintCallback, this._navigationKey);
                                 break;
 
                             case '\u001b[B': // Down arrow
                                 this.selectedIndex = (this.selectedIndex + 1) % this.menuOptions.length;
-                                this.displayMenu(this.versionInfo, this.hintCallback);
+                                this.displayMenu(this.versionInfo, this.hintCallback, this._navigationKey);
                                 break;
 
                             case '\r': // Enter
@@ -242,7 +248,7 @@ class Menu {
                         lineScope.release();
                         resolve(-1);
                     } else {
-                        screen.write(colors.red + '  Invalid selection. Please enter 1-' + this.menuOptions.length + '.' + colors.reset + '\n');
+                        screen.write(colors.red + '  ' + i18n.tSync('navigation.invalid_selection', this.menuOptions.length) + colors.reset + '\n');
                     }
                 });
             }
@@ -265,7 +271,7 @@ class Menu {
             lines.push('');
             lines.push(colors.bright + colors.orange + `[*] ${title}` + colors.reset);
             lines.push('');
-            lines.push(colors.gray + '  Use ↑↓ arrow keys to navigate, Enter to select, Esc to cancel' + colors.reset);
+            lines.push(colors.gray + '  ' + i18n.tSync('navigation.use_arrows_esc', i18n.tSync('navigation.action.select')) + colors.reset);
             lines.push('');
 
             items.forEach((item, index) => {
@@ -381,7 +387,7 @@ class Menu {
 
                 const rl = lineScope.createReadline();
 
-                screen.write(colors.yellow + '  Arrow keys not available. Enter item number (1-' + items.length + ') or q to cancel:' + colors.reset + '\n');
+                screen.write(colors.yellow + '  ' + i18n.tSync('navigation.arrow_keys_not_available', items.length) + colors.reset + '\n');
 
                 rl.on('line', (input) => {
                     const choice = parseInt(input.trim());
@@ -394,7 +400,7 @@ class Menu {
                         lineScope.release();
                         resolve(null);
                     } else {
-                        screen.write(colors.red + '  Invalid selection. Please enter 1-' + items.length + '.' + colors.reset + '\n');
+                        screen.write(colors.red + '  ' + i18n.tSync('navigation.invalid_selection', items.length) + colors.reset + '\n');
                     }
                 });
             }

package/lib/ui/screen.js

@@ -1,125 +1,125 @@
-/**
- * Screen Singleton - ANSI terminal rendering layer
- *
- * All UI output goes through this module. Eliminates position drift
- * by using absolute cursor positioning (cursorHome + clearScreen)
- * and alternate screen buffer for isolation.
- */
-
-const ANSI = {
-    enterAltScreen: '\x1b[?1049h',
-    exitAltScreen: '\x1b[?1049l',
-    cursorHome: '\x1b[H',
-    clearScreen: '\x1b[2J',
-    cursorHide: '\x1b[?25l',
-    cursorShow: '\x1b[?25h',
-    reset: '\x1b[0m',
-};
-
-class Screen {
-    constructor() {
-        this.inAltScreen = false;
-        this.isTTY = process.stdout.isTTY || false;
-        this.noAlt = process.env.SCREEN_NO_ALT === '1';
-        this.testMode = process.env.SCREEN_TEST === '1';
-        this.readlineActive = false;
-        this.currentTag = null;
-        this._log = [];
-    }
-
-    enter() {
-        if (!this.isTTY) return;
-        if (this.inAltScreen) return;
-        if (!this.noAlt) {
-            this._rawWrite(ANSI.enterAltScreen);
-        }
-        this._rawWrite(ANSI.cursorHide);
-        this.inAltScreen = true;
-    }
-
-    exit() {
-        if (!this.inAltScreen) return;
-        this._rawWrite(ANSI.cursorShow);
-        if (!this.noAlt) {
-            this._rawWrite(ANSI.exitAltScreen);
-        }
-        this.inAltScreen = false;
-    }
-
-    exitForHandoff() {
-        if (!this.inAltScreen) return;
-        this._rawWrite(ANSI.cursorShow);
-        this._rawWrite(ANSI.reset);
-        if (!this.noAlt) {
-            this._rawWrite(ANSI.exitAltScreen);
-        }
-        if (this.isTTY && process.stdin.isTTY) {
-            try { process.stdin.setRawMode(false); } catch (_) {}
-        }
-        this.inAltScreen = false;
-    }
-
-    render(lines) {
-        this.currentTag = 'render';
-        if (this.isTTY) {
-            this._rawWrite(ANSI.cursorHome + ANSI.clearScreen);
-        }
-        for (const line of lines) {
-            this._rawWrite(line + '\n');
-        }
-        this.currentTag = null;
-    }
-
-    write(text) {
-        this.currentTag = 'write';
-        this._rawWrite(text);
-        this.currentTag = null;
-    }
-
-    showCursor() {
-        if (this.isTTY) {
-            this._rawWrite(ANSI.cursorShow);
-        }
-    }
-
-    hideCursor() {
-        if (this.isTTY) {
-            this._rawWrite(ANSI.cursorHide);
-        }
-    }
-
-    isActive() {
-        return this.inAltScreen;
-    }
-
-    debug(message) {
-        if (this.inAltScreen) return; // Suppress during alt-screen
-        this._rawStderr(message + '\n');
-    }
-
-    setReadlineActive(active) {
-        this.readlineActive = active;
-        this.currentTag = active ? 'readline' : null;
-    }
-
-    getLog() {
-        return this._log;
-    }
-
-    _rawWrite(data) {
-        if (this.testMode) {
-            const tag = this.readlineActive ? 'readline' : (this.currentTag || 'untagged');
-            this._log.push({ channel: 'stdout', tag, data: data.substring(0, 80), time: Date.now() });
-        }
-        process.stdout.write(data);
-    }
-
-    _rawStderr(data) {
-        if (this.testMode) {
-            this._log.push({ channel: 'stderr', tag: 'debug', data: data.substring(0, 80), time: Date.now() });
-        }
-        process.stderr.write(data);
-    }
-}
-
-module.exports = new Screen();
+/**
+ * Screen Singleton - ANSI terminal rendering layer
+ *
+ * All UI output goes through this module. Eliminates position drift
+ * by using absolute cursor positioning (cursorHome + clearScreen)
+ * and alternate screen buffer for isolation.
+ */
+
+const ANSI = {
+    enterAltScreen: '\x1b[?1049h',
+    exitAltScreen: '\x1b[?1049l',
+    cursorHome: '\x1b[H',
+    clearScreen: '\x1b[2J',
+    cursorHide: '\x1b[?25l',
+    cursorShow: '\x1b[?25h',
+    reset: '\x1b[0m',
+};
+
+class Screen {
+    constructor() {
+        this.inAltScreen = false;
+        this.isTTY = process.stdout.isTTY || false;
+        this.noAlt = process.env.SCREEN_NO_ALT === '1';
+        this.testMode = process.env.SCREEN_TEST === '1';
+        this.readlineActive = false;
+        this.currentTag = null;
+        this._log = [];
+    }
+
+    enter() {
+        if (!this.isTTY) return;
+        if (this.inAltScreen) return;
+        if (!this.noAlt) {
+            this._rawWrite(ANSI.enterAltScreen);
+        }
+        this._rawWrite(ANSI.cursorHide);
+        this.inAltScreen = true;
+    }
+
+    exit() {
+        if (!this.inAltScreen) return;
+        this._rawWrite(ANSI.cursorShow);
+        if (!this.noAlt) {
+            this._rawWrite(ANSI.exitAltScreen);
+        }
+        this.inAltScreen = false;
+    }
+
+    exitForHandoff() {
+        if (!this.inAltScreen) return;
+        this._rawWrite(ANSI.cursorShow);
+        this._rawWrite(ANSI.reset);
+        if (!this.noAlt) {
+            this._rawWrite(ANSI.exitAltScreen);
+        }
+        if (this.isTTY && process.stdin.isTTY) {
+            try { process.stdin.setRawMode(false); } catch (_) {}
+        }
+        this.inAltScreen = false;
+    }
+
+    render(lines) {
+        this.currentTag = 'render';
+        if (this.isTTY) {
+            this._rawWrite(ANSI.cursorHome + ANSI.clearScreen);
+        }
+        for (const line of lines) {
+            this._rawWrite(line + '\n');
+        }
+        this.currentTag = null;
+    }
+
+    write(text) {
+        this.currentTag = 'write';
+        this._rawWrite(text);
+        this.currentTag = null;
+    }
+
+    showCursor() {
+        if (this.isTTY) {
+            this._rawWrite(ANSI.cursorShow);
+        }
+    }
+
+    hideCursor() {
+        if (this.isTTY) {
+            this._rawWrite(ANSI.cursorHide);
+        }
+    }
+
+    isActive() {
+        return this.inAltScreen;
+    }
+
+    debug(message) {
+        if (this.inAltScreen) return; // Suppress during alt-screen
+        this._rawStderr(message + '\n');
+    }
+
+    setReadlineActive(active) {
+        this.readlineActive = active;
+        this.currentTag = active ? 'readline' : null;
+    }
+
+    getLog() {
+        return this._log;
+    }
+
+    _rawWrite(data) {
+        if (this.testMode) {
+            const tag = this.readlineActive ? 'readline' : (this.currentTag || 'untagged');
+            this._log.push({ channel: 'stdout', tag, data: data.substring(0, 80), time: Date.now() });
+        }
+        process.stdout.write(data);
+    }
+
+    _rawStderr(data) {
+        if (this.testMode) {
+            this._log.push({ channel: 'stderr', tag: 'debug', data: data.substring(0, 80), time: Date.now() });
+        }
+        process.stderr.write(data);
+    }
+}
+
+module.exports = new Screen();

package/lib/utils/version-checker.js

@@ -30,11 +30,10 @@ async function loadConfig() {
         if (config.disableTelemetry === undefined) config.disableTelemetry = true;
         if (config.showModelUpgradeNotification === undefined) config.showModelUpgradeNotification = true;
         if (config.apiLaunchMode === undefined) config.apiLaunchMode = 'direct';
+        if (config.noFlicker === undefined) config.noFlicker = true;
 
         return config;
     } catch (error) {
-        // Return default config if file doesn't exist
-        // Default language must be 'en' to match LanguageManager default
         const defaultConfig = {
             language: 'en',
             lastVersionCheck: 0,
@@ -43,7 +42,8 @@ async function loadConfig() {
             lastModelUpgradeCheck: 0,
             disableTelemetry: true,
             showModelUpgradeNotification: true,
-            apiLaunchMode: 'direct'
+            apiLaunchMode: 'direct',
+            noFlicker: false,
         };
 
         // Write default config on first run so subsequent reads are consistent
@@ -281,10 +281,10 @@ function loadConfigSync() {
         if (config.disableTelemetry === undefined) config.disableTelemetry = true;
         if (config.showModelUpgradeNotification === undefined) config.showModelUpgradeNotification = true;
         if (config.apiLaunchMode === undefined) config.apiLaunchMode = 'direct';
+        if (config.noFlicker === undefined) config.noFlicker = true;
 
         return config;
     } catch (_) {
-        // Default language must be 'en' to match LanguageManager default
         const defaultConfig = {
             language: 'en',
             lastVersionCheck: 0,
@@ -293,7 +293,8 @@ function loadConfigSync() {
             lastModelUpgradeCheck: 0,
             disableTelemetry: true,
             showModelUpgradeNotification: true,
-            apiLaunchMode: 'direct'
+            apiLaunchMode: 'direct',
+            noFlicker: false,
         };
 
         // Write default config on first run so subsequent reads are consistent

package/lib/validators.js

@@ -120,11 +120,112 @@ function maskApiToken(token) {
     }
 }
 
+// ============================================================
+// Environment variable constants & validators
+// ============================================================
+
+const RESERVED_ENV_KEYS = [
+    'ANTHROPIC_BASE_URL',
+    'ANTHROPIC_AUTH_TOKEN',
+    'ANTHROPIC_API_KEY',
+    'ANTHROPIC_MODEL',
+    'ANTHROPIC_SMALL_FAST_MODEL',
+    'CLAUDE_CODE_OAUTH_TOKEN',
+    'DISABLE_TELEMETRY',
+    'CLAUDE_CODE_NO_FLICKER',
+];
+
+const PREDEFINED_RUNTIME_KEYS = [
+    'API_TIMEOUT_MS',
+    'CLAUDE_CODE_ATTRIBUTION_HEADER',
+    'CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC',
+    'CLAUDE_CODE_EFFORT_LEVEL',
+    'CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS',
+    'CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK',
+];
+
+const PREDEFINED_MODEL_ENV_KEYS = [
+    'ANTHROPIC_CUSTOM_MODEL_OPTION',
+    'ANTHROPIC_CUSTOM_MODEL_OPTION_NAME',
+    'ANTHROPIC_DEFAULT_SONNET_MODEL',
+    'ANTHROPIC_DEFAULT_OPUS_MODEL',
+    'ANTHROPIC_DEFAULT_HAIKU_MODEL',
+    'CLAUDE_CODE_SUBAGENT_MODEL',
+];
+
+const TYPE_A_FIELDS = [
+    'CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC',
+    'CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS',
+    'CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK',
+];
+
+const TYPE_B_FIELDS = [
+    'CLAUDE_CODE_ATTRIBUTION_HEADER',
+];
+
+const ALL_PREDEFINED_KEYS = new Set([
+    ...RESERVED_ENV_KEYS,
+    ...PREDEFINED_RUNTIME_KEYS,
+    ...PREDEFINED_MODEL_ENV_KEYS,
+]);
+
+function validateEnvKey(key) {
+    if (typeof key !== 'string' || key.trim() === '') {
+        return { valid: false, error: 'custom_env_key_empty' };
+    }
+    if (ALL_PREDEFINED_KEYS.has(key.trim())) {
+        return { valid: false, error: 'custom_env_key_reserved' };
+    }
+    return { valid: true, value: key.trim() };
+}
+
+function validateTypeATriState(value) {
+    if (value === '' || value === '1' || value === 'off') {
+        return { valid: true, value };
+    }
+    return { valid: false, error: 'tri_state_type_a_invalid' };
+}
+
+function validateTypeBTriState(value) {
+    if (value === '' || value === '1' || value === '0') {
+        return { valid: true, value };
+    }
+    return { valid: false, error: 'tri_state_type_b_invalid' };
+}
+
+function validateRuntimeEnvValue(key, value) {
+    if (typeof value !== 'string') {
+        return { valid: false, error: 'env_value_not_string' };
+    }
+    if (TYPE_A_FIELDS.includes(key)) return validateTypeATriState(value);
+    if (TYPE_B_FIELDS.includes(key)) return validateTypeBTriState(value);
+    if (key === 'API_TIMEOUT_MS') {
+        if (value === '') return { valid: true, value };
+        if (/^\d+$/.test(value) && parseInt(value, 10) > 0) return { valid: true, value };
+        return { valid: false, error: 'env_value_timeout_invalid' };
+    }
+    if (key === 'CLAUDE_CODE_EFFORT_LEVEL') {
+        if (value === '') return { valid: true, value };
+        if (['low','medium','high','xhigh','max','auto'].includes(value)) return { valid: true, value };
+        return { valid: false, error: 'env_value_effort_invalid' };
+    }
+    return { valid: true, value };
+}
+
 module.exports = {
     validateBaseUrl,
     validateAuthToken,
     validateModel,
     validateApiName,
     maskSensitiveData,
-    maskApiToken
+    maskApiToken,
+    RESERVED_ENV_KEYS,
+    PREDEFINED_RUNTIME_KEYS,
+    PREDEFINED_MODEL_ENV_KEYS,
+    TYPE_A_FIELDS,
+    TYPE_B_FIELDS,
+    validateEnvKey,
+    validateTypeATriState,
+    validateTypeBTriState,
+    validateRuntimeEnvValue,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kikkimo/claude-launcher",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "description": "Interactive launcher for Claude Code with beautiful Claude-style interface",
   "main": "claude-launcher",
   "bin": {
@@ -8,7 +8,7 @@
   },
   "scripts": {
     "start": "node claude-launcher",
-    "test": "node test/providers.test.js && node test/menu-hints.test.js && node test/version-checker.test.js && node test/api-manager.test.js && node test/launcher.test.js && node test/config-management.test.js && node test/api-select.test.js",
+    "test": "node test/providers.test.js && node test/menu-hints.test.js && node test/version-checker.test.js && node test/api-manager.test.js && node test/launcher.test.js && node test/config-management.test.js && node test/api-select.test.js && node test/env-vars-validators.test.js && node test/env-vars-providers.test.js && node test/env-vars-config.test.js && node test/env-vars-migration.test.js && node test/env-vars-add-api.test.js && node test/env-vars-write-interfaces.test.js && node test/env-vars-import-export.test.js && node test/env-vars-ui.test.js",
     "prepublishOnly": "echo \"Publishing claude-launcher...\"",
     "postinstall": "echo \"Claude Launcher installed successfully! Run 'claude-launcher' to start.\"",
     "publish:public": "npm publish --access public"