Add custom executable support for Prettier

Co-authored-by: ntotten <282782+ntotten@users.noreply.github.com>

Author: Copilot

package.json

@@ -132,6 +132,7 @@
         "prettier.resolveGlobalModules",
         "prettier.ignorePath",
         "prettier.prettierPath",
+        "prettier.customExecutable",
         "prettier.configPath",
         "prettier.useEditorConfig",
         "prettier.resolveGlobalModules",
@@ -214,6 +215,11 @@
           "markdownDescription": "%ext.config.prettierPath%",
           "scope": "resource"
         },
+        "prettier.customExecutable": {
+          "type": "string",
+          "markdownDescription": "%ext.config.customExecutable%",
+          "scope": "resource"
+        },
         "prettier.configPath": {
           "type": "string",
           "markdownDescription": "%ext.config.configPath%",

package.nls.json

@@ -21,6 +21,7 @@
   "ext.config.parser": "Override the parser. You shouldn't have to change this setting.",
   "ext.config.parserDeprecationMessage": "This setting is no longer supported. Use a prettier configuration file instead.",
   "ext.config.prettierPath": "Path to the `prettier` module, eg: `./node_modules/prettier`.",
+  "ext.config.customExecutable": "Use a custom executable to run Prettier. Specify the full command including arguments, with `${prettier}` as a placeholder for the Prettier path and `${file}` for the file to format. Example: `docker compose exec -T app node_modules/.bin/prettier`. When specified, takes precedence over `prettier.prettierPath`.",
   "ext.config.printWidth": "Fit code within this line limit.",
   "ext.config.proseWrap": "(Markdown) wrap prose over multiple lines.",
   "ext.config.quoteProps": "Change when properties in objects are quoted.\nValid options:\n- `\"as-needed\"` - Only add quotes around object properties where required.\n- `\"consistent\"` - If at least one property in an object requires quotes, quote all properties.\n- `\"preserve\"` - Respect the input use of quotes in object properties.",

src/ModuleResolverNode.ts

@@ -31,6 +31,7 @@ import {
   getWorkspaceRelativePath,
 } from "./utils/workspace.js";
 import { PrettierDynamicInstance } from "./PrettierDynamicInstance.js";
+import { PrettierExecutableInstance } from "./PrettierExecutableInstance.js";
 
 const minPrettierVersion = "1.13.0";
 
@@ -100,9 +101,17 @@ export class ModuleResolver implements ModuleResolverInterface {
       return getBundledPrettier();
     }
 
-    const { prettierPath, resolveGlobalModules } = getWorkspaceConfig(
-      Uri.file(fileName),
-    );
+    const { prettierPath, customExecutable, resolveGlobalModules } =
+      getWorkspaceConfig(Uri.file(fileName));
+
+    // If custom executable is specified, use it with highest priority
+    if (customExecutable) {
+      return this.getCustomExecutableInstance(
+        fileName,
+        customExecutable,
+        prettierPath,
+      );
+    }
 
     // Look for local module
     let modulePath: string | undefined;
@@ -160,6 +169,67 @@ export class ModuleResolver implements ModuleResolverInterface {
     return prettierInstance;
   }
 
+  private async getCustomExecutableInstance(
+    fileName: string,
+    customExecutable: string,
+    prettierPath: string | undefined,
+  ): Promise<PrettierInstance | undefined> {
+    // Determine the prettier path for the custom executable
+    let resolvedPrettierPath: string;
+
+    if (prettierPath) {
+      // Use the explicitly provided prettierPath
+      const absolutePath = path.isAbsolute(prettierPath)
+        ? prettierPath
+        : path.join(
+            workspace.getWorkspaceFolder(Uri.file(fileName))?.uri.fsPath ?? "",
+            prettierPath,
+          );
+      resolvedPrettierPath = absolutePath;
+    } else {
+      // Try to find prettier module automatically
+      const foundPath = await this.findPrettierModule(fileName);
+      if (foundPath) {
+        resolvedPrettierPath = foundPath;
+      } else {
+        // Fall back to just "prettier" and let the custom executable resolve it
+        resolvedPrettierPath = "prettier";
+      }
+    }
+
+    const cacheKey = `custom:${customExecutable}:${resolvedPrettierPath}`;
+
+    // Check cache
+    let prettierInstance = this.path2Module.get(cacheKey);
+    if (prettierInstance) {
+      return prettierInstance;
+    }
+
+    // Create new instance using PrettierExecutableInstance
+    prettierInstance = new PrettierExecutableInstance(
+      customExecutable,
+      resolvedPrettierPath,
+    );
+
+    // Import/validate the executable
+    try {
+      await prettierInstance.import();
+      this.loggingService.logInfo(
+        `Using custom executable: ${customExecutable} with prettier at ${resolvedPrettierPath}`,
+      );
+    } catch (error) {
+      this.loggingService.logError(
+        `Failed to initialize custom executable: ${customExecutable}`,
+        error,
+      );
+      return undefined;
+    }
+
+    this.path2Module.set(cacheKey, prettierInstance);
+
+    return prettierInstance;
+  }
+
   private async getModuleFromPrettierPath(
     fileName: string,
     prettierPath: string,