statusbar-quick-actions 0.0.11 → 0.0.13

package/CHANGELOG.md

@@ -0,0 +1,99 @@
+# Changelog
+
+```
+ Generated on: 2025-12-28T04:11:29.918Z
+```
+
+---
+
+## 9a7592e improved perfomance
+
+README.md
+package-lock.json
+package.json
+src/config-cli.ts
+src/extension.ts
+171f982 scripts
+package.json
+8062493 scripts
+package.json
+4c58024 feat(extension): add config CLI and performance optimizations
+bun.lock
+docs/PERFORMANCE_OPTIMIZATIONS.md
+docs/PRESET_AND_DYNAMIC_LABELS.md
+docs/SAMPLE-CONFIGURATIONS.md
+package-lock.json
+package.json
+src/config-cli.ts
+src/extension.ts
+tsconfig.dev.json
+tsconfig.json
+0ba010a feat(extension): add preset system and dynamic labels for enhanced button management
+.github/FUNDING.yml
+PRESET_AND_DYNAMIC_LABELS.md
+README.md
+package-lock.json
+package.json
+src/configuration.ts
+src/dynamic-label.ts
+src/extension.ts
+src/preset-manager.ts
+src/types.ts
+ad18cce chore(config): add funding configuration
+.github/FUNDING.yml
+2702d5a feat(extension): add icon, metadata, and update dependencies
+.gitignore
+.vscodeignore
+assets/icon.png
+bun.lock
+package.json
+e9a340b feat(deps): replace minimatch with rimraf for better dependency management
+bun.lock
+package.json
+src/configuration.ts
+src/extension.ts
+src/visibility.ts
+ed94206 feat(config): implement command object validation and error handling
+package.json
+src/configuration.ts
+src/extension.ts
+src/output-panel.ts
+a22c1f2 chore(deps): update dependencies and build configuration
+bun.lock
+package.json
+f780131 v0.0.5
+package.json
+421c02b feat(extension): add streaming output support with output panel management
+package.json
+src/executor.ts
+src/extension.ts
+src/material-icons.ts
+src/output-panel.ts
+src/types.ts
+src/utils/debounce.ts
+src/visibility.ts
+736a327 v0.0.2
+package.json
+e0d7c7f feat(deps): add @involvex/rmdir-cli dependency and update clean script
+bun.lock
+package.json
+0e4ddf9 feat: initial implementation of StatusBar Quick Actions extension
+.gitignore
+.vscodeignore
+CLAUDE.md
+LICENSE
+README.md
+SAMPLE-CONFIGURATIONS.md
+bun.lock
+eslint.config.mjs
+package-lock.json
+package.json
+src/configuration.ts
+src/executor.ts
+src/extension.ts
+src/history.ts
+src/notifications.ts
+src/theme.ts
+src/types.ts
+src/visibility.ts
+tsconfig.json

package/README.md

@@ -93,6 +93,213 @@ The extension includes comprehensive sample configurations for various project t
 
 See `SAMPLE-CONFIGURATIONS.md` for detailed examples.
 
+## Configuration CLI
+
+The extension includes a powerful command-line interface for managing configurations without opening VSCode settings.
+
+### Running the CLI
+
+```bash
+# Using bun (recommended)
+bun run dev:cli
+
+# Or directly
+bun src/config-cli.ts
+```
+
+### CLI Features
+
+The CLI provides an interactive menu with the following options:
+
+#### 1. View Current Configuration
+
+Display all configured buttons with their properties:
+
+- Button ID, text, and command type
+- Enabled/disabled status
+- Current debug mode setting
+
+#### 2. Apply Preset
+
+Apply pre-built button configurations:
+
+- **Node.js Development**: npm start, test, build
+- **Bun Development**: bun dev, test, build
+- **Git Workflow**: git status, pull, push
+
+Merge modes:
+
+- Replace all (removes existing buttons)
+- Append (adds to existing buttons)
+- Merge (replaces buttons with same ID)
+
+#### 3. Add Button
+
+Interactive wizard to create new buttons:
+
+- Supports all command types (npm, yarn, pnpm, bun, shell, vscode, task, detect)
+- Auto-generates unique IDs
+- Configures text, tooltip, and command
+
+#### 4. Remove Button
+
+Delete buttons from configuration with confirmation.
+
+#### 5. Toggle Debug Mode
+
+Enable or disable debug logging for the extension.
+
+#### 6. Export Configuration
+
+Save current configuration to a JSON file for backup or sharing.
+
+#### 7. Import Configuration
+
+Load configuration from a JSON file with merge or replace options.
+
+#### 8. Apply Label Preset
+
+Add dynamic labels to buttons for real-time information:
+
+**Git Presets**:
+
+- **Git Branch**: Show current branch (`$(git-branch) main`)
+- **Git Status**: Show repository status (`$(git-commit) Clean`)
+- **Git Remote URL**: Show remote origin URL
+
+**Package Presets**:
+
+- **NPM Package Version**: Monitor package versions from npm registry
+  - Prompts for package name (e.g., `vscode`, `react`)
+  - Updates every 5 minutes
+  - Shows version like `$(package) v1.2.3`
+
+**System Presets**:
+
+- **Current Time**: Display real-time clock
+- **Environment Variable**: Show any environment variable value
+
+Example workflow:
+
+```bash
+# 1. Select "Apply Label Preset"
+# 2. Choose settings location (user/workspace)
+# 3. Select button to modify
+# 4. Choose preset (e.g., "Git Branch")
+# 5. Label updates automatically in VSCode
+```
+
+#### 9. Configure Performance
+
+Optimize extension performance with these settings:
+
+**Visibility Debounce** (0-5000ms):
+
+- Delay before checking button visibility conditions
+- Lower = more responsive, higher = better performance
+- Recommended: 300ms (balanced)
+
+**Virtualization**:
+
+- Enable for large button lists (10+ buttons)
+- Improves rendering performance
+- Slight delay on initial load
+
+**Result Caching**:
+
+- Cache visibility check results
+- Reduces redundant computations
+- Recommended: enabled
+
+**Performance Presets**:
+
+1. **Balanced** (300ms debounce, caching on)
+   - Best for most users
+   - Good balance of responsiveness and performance
+
+2. **Fast** (100ms debounce, caching on, virtualization on)
+   - For users with many buttons
+   - Maximum responsiveness
+   - Slightly higher CPU usage
+
+3. **Minimal** (0ms debounce, caching off)
+   - For debugging or testing
+   - Instant updates but higher resource usage
+
+#### 10. Reset to Defaults
+
+Remove all buttons and reset settings to defaults (requires confirmation).
+
+#### 11. Help
+
+Display comprehensive help and usage information.
+
+### Settings Locations
+
+The CLI allows managing two types of settings:
+
+**User Settings (Global)**:
+
+- Location: `%APPDATA%\Code\User\settings.json` (Windows)
+- Location: `~/Library/Application Support/Code/User/settings.json` (macOS)
+- Location: `~/.config/Code/User/settings.json` (Linux)
+- Applies to all VSCode workspaces
+
+**Workspace Settings (Project-specific)**:
+
+- Location: `<workspace>/.vscode/settings.json`
+- Only applies to current project
+- Overrides user settings
+
+### CLI Examples
+
+**Example 1: Quick Setup with Preset**
+
+```bash
+$ bun run dev:cli
+# Choose option 2 (Apply Preset)
+# Select location: 1 (User settings)
+# Select preset: 1 (Node.js Development)
+# Select merge mode: 1 (Replace all)
+✅ Preset "Node.js Development" applied to user settings
+```
+
+**Example 2: Add Dynamic Git Branch Label**
+
+```bash
+$ bun run dev:cli
+# Choose option 8 (Apply Label Preset)
+# Select location: 2 (Workspace settings)
+# Select button: 1 (Your existing button)
+# Select preset: 1 (Git Branch)
+✅ Label preset "Git Branch" applied to button "My Button"
+# Button now shows: $(git-branch) main (updates automatically)
+```
+
+**Example 3: Optimize Performance**
+
+```bash
+$ bun run dev:cli
+# Choose option 9 (Configure Performance)
+# Select location: 1 (User settings)
+# Choose option 4 (Apply Performance Preset)
+# Select preset: 2 (Fast)
+✅ Performance settings updated
+# Debounce: 100ms, Caching: Enabled, Virtualization: Enabled
+```
+
+**Example 4: Add NPM Version Monitor**
+
+```bash
+$ bun run dev:cli
+# Choose option 8 (Apply Label Preset)
+# Select button to modify
+# Select preset: 4 (NPM Package Version)
+# Enter package name: react
+✅ Label preset "NPM Package Version" applied
+# Button shows: $(package) v18.2.0 (updates every 5 minutes)
+```
+
 ## Configuration Options
 
 ### Button Configuration

package/out/config-cli.js

@@ -143,6 +143,73 @@ const BUILTIN_PRESETS = {
         },
     },
 };
+const LABEL_PRESETS = {
+    "git-branch": {
+        name: "Git Branch",
+        description: "Show current git branch",
+        config: {
+            type: "git",
+            gitInfo: "branch",
+            template: "$(git-branch) ${value}",
+            fallback: "$(git-branch) No Git",
+            refreshInterval: 5000,
+        },
+    },
+    "git-status": {
+        name: "Git Status",
+        description: "Show git repository status",
+        config: {
+            type: "git",
+            gitInfo: "status",
+            template: "$(git-commit) ${value}",
+            fallback: "$(git-commit) Clean",
+            refreshInterval: 5000,
+        },
+    },
+    "git-remote": {
+        name: "Git Remote URL",
+        description: "Show git remote origin URL",
+        config: {
+            type: "git",
+            gitInfo: "remote",
+            template: "$(globe) ${value}",
+            fallback: "$(globe) No Remote",
+            refreshInterval: 30000,
+        },
+    },
+    "npm-version": {
+        name: "NPM Package Version",
+        description: "Show latest package version from npm registry",
+        config: {
+            type: "url",
+            url: "https://registry.npmjs.org/${packageName}/latest",
+            template: "$(package) v${value.version}",
+            fallback: "$(package) Unknown",
+            refreshInterval: 300000,
+        },
+    },
+    "current-time": {
+        name: "Current Time",
+        description: "Show current time",
+        config: {
+            type: "time",
+            format: "HH:mm:ss",
+            template: "$(clock) ${value}",
+            refreshInterval: 1000,
+        },
+    },
+    "env-variable": {
+        name: "Environment Variable",
+        description: "Show an environment variable value",
+        config: {
+            type: "env",
+            envVar: "NODE_ENV",
+            template: "$(symbol-property) ${value}",
+            fallback: "$(symbol-property) Not Set",
+            refreshInterval: 0,
+        },
+    },
+};
 const MENU_OPTIONS = [
     {
         key: "1",
@@ -195,13 +262,27 @@ const MENU_OPTIONS = [
     },
     {
         key: "8",
+        label: "Apply Label Preset",
+        description: "Apply dynamic label preset to a button",
+        action: applyLabelPreset,
+        requiresConfirmation: false,
+    },
+    {
+        key: "9",
+        label: "Configure Performance",
+        description: "Adjust performance settings (caching, debounce)",
+        action: configurePerformance,
+        requiresConfirmation: false,
+    },
+    {
+        key: "10",
         label: "Reset to Defaults",
         description: "Reset all settings to default values",
         action: resetToDefaults,
         requiresConfirmation: true,
     },
     {
-        key: "9",
+        key: "11",
         label: "Help",
         description: "Show help and usage information",
         action: showHelp,
@@ -372,6 +453,20 @@ class SettingsManager {
         settings["statusbarQuickActions.settings.debug"] = enabled;
         this.writeSettings(location, settings);
     }
+    static getPerformanceSettings(location) {
+        const settings = this.readSettings(location);
+        const performance = settings["statusbarQuickActions.settings.performance"];
+        return {
+            visibilityDebounceMs: performance?.visibilityDebounceMs ?? 300,
+            enableVirtualization: performance?.enableVirtualization ?? false,
+            cacheResults: performance?.cacheResults ?? true,
+        };
+    }
+    static setPerformanceSettings(location, performance) {
+        const settings = this.readSettings(location);
+        settings["statusbarQuickActions.settings.performance"] = performance;
+        this.writeSettings(location, settings);
+    }
 }
 class InputValidator {
     static validateChoice(input) {
@@ -753,6 +848,174 @@ async function resetToDefaults() {
     SettingsManager.setDebugMode(location, false);
     ConsoleUI.printSuccess(`${location} settings reset to defaults`);
 }
+async function applyLabelPreset() {
+    ConsoleUI.clear();
+    ConsoleUI.printBanner();
+    const location = await InputHandler.promptLocation();
+    const buttons = SettingsManager.getButtons(location);
+    if (buttons.length === 0) {
+        ConsoleUI.printWarning("No buttons available. Add a button first.");
+        return;
+    }
+    console.log("Select button to apply label preset:\n");
+    buttons.forEach((btn, idx) => {
+        console.log(`  ${idx + 1}. ${btn.text} (${btn.id})`);
+    });
+    console.log(`\nChoice (1-${buttons.length}): `);
+    const buttonInput = await InputHandler.getInput(10000);
+    if (!buttonInput) {
+        ConsoleUI.printWarning("Operation cancelled");
+        return;
+    }
+    const buttonIndex = parseInt(buttonInput, 10) - 1;
+    if (buttonIndex < 0 || buttonIndex >= buttons.length) {
+        ConsoleUI.printError("Invalid button selection");
+        return;
+    }
+    console.log("\nAvailable Label Presets:\n");
+    const presetKeys = Object.keys(LABEL_PRESETS);
+    presetKeys.forEach((key, idx) => {
+        const preset = LABEL_PRESETS[key];
+        console.log(`  ${idx + 1}. ${preset.name}`);
+        console.log(`     ${CONFIG.colors.dim}${preset.description}${CONFIG.colors.reset}`);
+        console.log(`     ${CONFIG.colors.dim}Refresh: ${preset.config.refreshInterval || 0}ms${CONFIG.colors.reset}`);
+        console.log();
+    });
+    console.log(`Select preset (1-${presetKeys.length}): `);
+    const presetInput = await InputHandler.getInput(10000);
+    if (!presetInput) {
+        ConsoleUI.printWarning("Operation cancelled");
+        return;
+    }
+    const presetIndex = parseInt(presetInput, 10) - 1;
+    if (presetIndex < 0 || presetIndex >= presetKeys.length) {
+        ConsoleUI.printError("Invalid preset selection");
+        return;
+    }
+    const presetKey = presetKeys[presetIndex];
+    const preset = LABEL_PRESETS[presetKey];
+    const button = buttons[buttonIndex];
+    if (presetKey === "npm-version") {
+        console.log("\nPackage name to monitor: ");
+        const packageName = await InputHandler.getInput(10000);
+        if (!packageName) {
+            ConsoleUI.printWarning("Operation cancelled");
+            return;
+        }
+        preset.config.url = preset.config.url?.replace("${packageName}", packageName);
+    }
+    if (presetKey === "env-variable") {
+        console.log("\nEnvironment variable name: ");
+        const envVar = await InputHandler.getInput(10000);
+        if (!envVar) {
+            ConsoleUI.printWarning("Operation cancelled");
+            return;
+        }
+        preset.config.envVar = envVar;
+    }
+    button.dynamicLabel = preset.config;
+    buttons[buttonIndex] = button;
+    SettingsManager.setButtons(location, buttons);
+    ConsoleUI.printSuccess(`Label preset "${preset.name}" applied to button "${button.text}"`);
+}
+async function configurePerformance() {
+    ConsoleUI.clear();
+    ConsoleUI.printBanner();
+    const location = await InputHandler.promptLocation();
+    const currentSettings = SettingsManager.getPerformanceSettings(location);
+    ConsoleUI.printDivider();
+    console.log("Current Performance Settings");
+    ConsoleUI.printDivider();
+    console.log();
+    console.log(`Visibility Debounce: ${currentSettings.visibilityDebounceMs}ms`);
+    console.log(`Virtualization: ${currentSettings.enableVirtualization ? "✅ Enabled" : "❌ Disabled"}`);
+    console.log(`Result Caching: ${currentSettings.cacheResults ? "✅ Enabled" : "❌ Disabled"}`);
+    console.log();
+    ConsoleUI.printDivider();
+    console.log("What would you like to configure?\n");
+    console.log("  1. Visibility Debounce (delay before checking visibility)");
+    console.log("  2. Enable/Disable Virtualization (for large button lists)");
+    console.log("  3. Enable/Disable Result Caching");
+    console.log("  4. Apply Performance Preset");
+    console.log("  5. Cancel");
+    console.log("\nChoice (1-5): ");
+    const choice = await InputHandler.getInput(10000);
+    if (!choice || choice === "5") {
+        ConsoleUI.printWarning("Operation cancelled");
+        return;
+    }
+    const newSettings = { ...currentSettings };
+    switch (choice) {
+        case "1": {
+            console.log("\nVisibility Debounce in milliseconds (current: ");
+            console.log(`${currentSettings.visibilityDebounceMs}ms): `);
+            const input = await InputHandler.getInput(10000);
+            if (input) {
+                const debounce = parseInt(input, 10);
+                if (!isNaN(debounce) && debounce >= 0 && debounce <= 5000) {
+                    newSettings.visibilityDebounceMs = debounce;
+                }
+                else {
+                    ConsoleUI.printError("Invalid debounce value (0-5000ms)");
+                    return;
+                }
+            }
+            break;
+        }
+        case "2": {
+            newSettings.enableVirtualization = !currentSettings.enableVirtualization;
+            ConsoleUI.printInfo(`Virtualization ${newSettings.enableVirtualization ? "enabled" : "disabled"}`);
+            break;
+        }
+        case "3": {
+            newSettings.cacheResults = !currentSettings.cacheResults;
+            ConsoleUI.printInfo(`Result caching ${newSettings.cacheResults ? "enabled" : "disabled"}`);
+            break;
+        }
+        case "4": {
+            console.log("\nPerformance Presets:\n");
+            console.log("  1. Balanced (300ms debounce, caching on)");
+            console.log("  2. Fast (100ms debounce, caching on, virtualization on)");
+            console.log("  3. Minimal (0ms debounce, caching off)");
+            console.log("\nChoice (1-3): ");
+            const presetChoice = await InputHandler.getInput(10000);
+            switch (presetChoice) {
+                case "1":
+                    newSettings.visibilityDebounceMs = 300;
+                    newSettings.cacheResults = true;
+                    newSettings.enableVirtualization = false;
+                    break;
+                case "2":
+                    newSettings.visibilityDebounceMs = 100;
+                    newSettings.cacheResults = true;
+                    newSettings.enableVirtualization = true;
+                    break;
+                case "3":
+                    newSettings.visibilityDebounceMs = 0;
+                    newSettings.cacheResults = false;
+                    newSettings.enableVirtualization = false;
+                    break;
+                default:
+                    ConsoleUI.printError("Invalid preset choice");
+                    return;
+            }
+            break;
+        }
+        default:
+            ConsoleUI.printError("Invalid choice");
+            return;
+    }
+    SettingsManager.setPerformanceSettings(location, newSettings);
+    ConsoleUI.printSuccess("Performance settings updated");
+    console.log();
+    ConsoleUI.printDivider();
+    console.log("New Settings:");
+    ConsoleUI.printDivider();
+    console.log(`Visibility Debounce: ${newSettings.visibilityDebounceMs}ms`);
+    console.log(`Virtualization: ${newSettings.enableVirtualization ? "✅ Enabled" : "❌ Disabled"}`);
+    console.log(`Result Caching: ${newSettings.cacheResults ? "✅ Enabled" : "❌ Disabled"}`);
+    console.log();
+}
 async function showHelp() {
     ConsoleUI.clear();
     ConsoleUI.printBanner();