Implement UICulture configuration and command palette support

Co-authored-by: HeyItsGilbert <615265+HeyItsGilbert@users.noreply.github.com>

Author: Copilot

CHANGELOG.md

@@ -9,6 +9,16 @@ to structure this file.
 ## [Unreleased]
 
 ### Added
+- UICulture configuration support for PowerShell localization
+  - New `powershellLocalization.uiCulture` setting to specify default UI culture (e.g., 'en-US', 'fr-FR')
+  - Setting validates culture format using pattern `^[a-z]{2}(-[A-Z]{2})?$`
+- Command palette commands for UICulture switching
+  - `PowerShell Localization: Switch UI Culture` - Interactive input box for custom culture
+  - `PowerShell Localization: Set UI Culture to English (en-US)` - Quick switch to English
+  - `PowerShell Localization: Set UI Culture to French (fr-FR)` - Quick switch to French
+- Automatic cache clearing when UICulture changes
+  - Decorations refresh automatically when culture is changed via settings or commands
+  - Ensures localization values are immediately updated to reflect new culture
 - Windows PowerShell fallback support for better compatibility
   - Extension now automatically detects and uses available PowerShell executable
   - Tries PowerShell 7+ (`pwsh`) first, then falls back to Windows PowerShell 5.1 (`powershell`)

package.json

@@ -78,9 +78,32 @@
           ],
           "default": "info",
           "description": "Set the logging level for the PowerShell Localization extension. Debug logs are only shown when set to 'debug'."
+        },
+        "powershellLocalization.uiCulture": {
+          "type": "string",
+          "default": "en-US",
+          "pattern": "^[a-z]{2}(-[A-Z]{2})?$",
+          "description": "Specify the UI culture for PowerShell localization data. Use format like 'en-US', 'fr-FR', 'de-DE', etc."
         }
       }
-    }
+    },
+    "commands": [
+      {
+        "command": "powershellLocalization.switchUICulture",
+        "title": "Switch UI Culture",
+        "category": "PowerShell Localization"
+      },
+      {
+        "command": "powershellLocalization.setUICultureToEnUs",
+        "title": "Set UI Culture to English (en-US)",
+        "category": "PowerShell Localization"
+      },
+      {
+        "command": "powershellLocalization.setUICultureToFrFr",
+        "title": "Set UI Culture to French (fr-FR)",
+        "category": "PowerShell Localization"
+      }
+    ]
   },
   "scripts": {
     "bootstrap": "pwsh -NoLogo -NoProfile -ExecutionPolicy Bypass -File ./build.ps1 -Bootstrap",

src/configuration.ts

@@ -21,7 +21,8 @@ export class ConfigurationManager {
         '**/dist/**',
         '**/.git/**'
       ]),
-      logLevel: config.get<LogLevel>('logLevel', 'info')
+      logLevel: config.get<LogLevel>('logLevel', 'info'),
+      uiCulture: config.get<string>('uiCulture', 'en-US')
     };
   }
 
@@ -53,6 +54,21 @@ export class ConfigurationManager {
     return this.getConfiguration().logLevel;
   }
 
+  /**
+   * Gets the current UI culture
+   */
+  public static getUICulture(): string {
+    return this.getConfiguration().uiCulture;
+  }
+
+  /**
+   * Sets the UI culture
+   */
+  public static async setUICulture(culture: string): Promise<void> {
+    const config = vscode.workspace.getConfiguration(CONFIGURATION_BASENAME);
+    await config.update('uiCulture', culture, vscode.ConfigurationTarget.Global);
+  }
+
   /**
    * Registers configuration change listener
    */

src/decorationProvider.ts

@@ -205,7 +205,7 @@ export class LocalizationDecorationProvider {
         return null;
       }
 
-      const localizationData = await this.powershellExecutor.parseLocalizationData(modulePath);
+      const localizationData = await this.powershellExecutor.parseLocalizationData(modulePath, ConfigurationManager.getUICulture());
 
       // Cache the result
       this.localizationCache.set(cacheKey, localizationData);

src/extensionManager.ts

@@ -57,6 +57,9 @@ export class ExtensionManager {
       // Set up file system watchers
       this.setupFileSystemWatchers();
 
+      // Register command palette commands
+      this.registerCommands();
+
       this.logger.info('PowerShell Localization extension activated successfully');
 
     } catch (error) {
@@ -130,6 +133,40 @@ export class ExtensionManager {
     this.context.subscriptions.push(psm1Watcher, psd1Watcher);
   }
 
+  /**
+   * Registers command palette commands
+   */
+  private registerCommands(): void {
+    // Register switch UI culture command
+    const switchCommand = vscode.commands.registerCommand(
+      'powershellLocalization.switchUICulture',
+      async () => {
+        await this.handleSwitchUICulture();
+      }
+    );
+
+    // Register set to en-US command
+    const setEnUsCommand = vscode.commands.registerCommand(
+      'powershellLocalization.setUICultureToEnUs',
+      async () => {
+        await this.handleSetUICulture('en-US');
+      }
+    );
+
+    // Register set to fr-FR command
+    const setFrFrCommand = vscode.commands.registerCommand(
+      'powershellLocalization.setUICultureToFrFr',
+      async () => {
+        await this.handleSetUICulture('fr-FR');
+      }
+    );
+
+    this.disposables.push(switchCommand, setEnUsCommand, setFrFrCommand);
+    this.context.subscriptions.push(switchCommand, setEnUsCommand, setFrFrCommand);
+
+    this.logger.info('Command palette commands registered');
+  }
+
   /**
    * Handles configuration changes
    */
@@ -163,6 +200,57 @@ export class ExtensionManager {
     }
   }
 
+  /**
+   * Handles switching UI culture via input box
+   */
+  private async handleSwitchUICulture(): Promise<void> {
+    try {
+      const currentCulture = ConfigurationManager.getUICulture();
+      const inputCulture = await vscode.window.showInputBox({
+        prompt: 'Enter UI Culture (e.g., en-US, fr-FR, de-DE)',
+        value: currentCulture,
+        validateInput: (value) => {
+          const culturePattern = /^[a-z]{2}(-[A-Z]{2})?$/;
+          if (!culturePattern.test(value)) {
+            return 'Invalid culture format. Use format like "en-US", "fr-FR", "de-DE"';
+          }
+          return null;
+        }
+      });
+
+      if (inputCulture && inputCulture !== currentCulture) {
+        await this.handleSetUICulture(inputCulture);
+      }
+    } catch (error) {
+      this.logger.error('Failed to switch UI culture', error as Error);
+      vscode.window.showErrorMessage(`Failed to switch UI culture: ${(error as Error).message}`);
+    }
+  }
+
+  /**
+   * Handles setting UI culture to a specific value
+   */
+  private async handleSetUICulture(culture: string): Promise<void> {
+    try {
+      const currentCulture = ConfigurationManager.getUICulture();
+      if (culture === currentCulture) {
+        vscode.window.showInformationMessage(`UI Culture is already set to ${culture}`);
+        return;
+      }
+
+      await ConfigurationManager.setUICulture(culture);
+      
+      // Clear the cache since culture has changed
+      this.decorationProvider.clearCache();
+      
+      vscode.window.showInformationMessage(`UI Culture changed to ${culture}`);
+      this.logger.info(`UI Culture changed from ${currentCulture} to ${culture}`);
+    } catch (error) {
+      this.logger.error(`Failed to set UI culture to ${culture}`, error as Error);
+      vscode.window.showErrorMessage(`Failed to set UI culture: ${(error as Error).message}`);
+    }
+  }
+
   /**
    * Disposes of all resources
    */

src/powershellExecutor.ts

@@ -17,14 +17,18 @@ export class PowerShellExecutor {
   /**
    * Executes the LocalizationParser.ps1 script for a given module
    */
-  public async parseLocalizationData(modulePath: string): Promise<LocalizationData> {
-    this.logger.debug(`Parsing localization data for module: ${modulePath}`);
+  public async parseLocalizationData(modulePath: string, uiCulture?: string): Promise<LocalizationData> {
+    this.logger.debug(`Parsing localization data for module: ${modulePath} with culture: ${uiCulture || 'default'}`);
 
     try {
       const scriptPath = path.join(__dirname, '..', 'resources', 'LocalizationParser.ps1');
 
-      // TODO: Add support for loading a specific UICulture
       const args = ['-ModuleFile', modulePath];
+      
+      // Add UICulture parameter if provided
+      if (uiCulture) {
+        args.push('-UICulture', uiCulture);
+      }
 
       const output = await this.executeScript(scriptPath, args);
 
@@ -138,6 +142,7 @@ export class PowerShellExecutor {
       '-Command',
       '-File',
       '-ModuleFile',
+      '-UICulture',
       '-Path',
       '-Name',
       '-Filter',

src/types.ts

@@ -18,6 +18,7 @@ export interface ExtensionConfig {
   enableDecorations: boolean;
   searchExclude: string[];
   logLevel: LogLevel;
+  uiCulture: string;
 }
 
 export type LogLevel = 'error' | 'warn' | 'info' | 'debug';