feat: add "useArray" option to customBinaryExtensions (#214)

* feat: add asArray functionality

* change example to ty

Author: Attempt3035

docs/src/content/docs/guides/custom-extensions.mdx

@@ -10,7 +10,7 @@ You can configure any VS Code extension to use mise tools via settings:
 - **`mise.customBinaryExtensions`**: Configure extensions that need a binary path
 - **`mise.customFolderExtensions`**: Configure extensions that need a folder path (e.g., JDK home)
 
-Example for binary mode:
+Example for binary mode (string value):
 
 ```json
 {
@@ -24,6 +24,20 @@ Example for binary mode:
 }
 ```
 
+Some extensions expect an array of paths instead of a single string. Use `vscodeSetting.asArray`:
+
+```json
+{
+  "mise.customBinaryExtensions": [
+    {
+      "extensionId": "astral-sh.ty",
+      "toolSources": ["ty"],
+      "vscodeSetting": { "key": "ty.path", "asArray": true }
+    }
+  ]
+}
+```
+
 Example for folder mode:
 
 ```json

docs/src/content/docs/reference/Settings.md

@@ -295,6 +295,7 @@ Each entry requires:
 Optional:
 - `binName`: Binary name (defaults to first tool name)
 - `vscodeSetting.subdirs`: Subdirectories to append to the path
+- `vscodeSetting.asArray`: Whether to wrap the setting value in an array (default: false)
 - `supportsShims`: Whether extension supports shims (default: true)
 - `supportsSymlinks`: Whether extension supports symlinks (default: true)
 

package.json

@@ -391,7 +391,7 @@
           "order": 19,
           "type": "array",
           "default": [],
-          "markdownDescription": "Custom binary extensions to automatically configure VSCode extensions with mise tool binaries.\n\nEach entry requires:\n- `extensionId`: VSCode extension ID\n- `toolSources`: Array of mise tool registry sources to match\n- `vscodeSetting.key`: VSCode setting key to write\n\nOptional:\n- `binName`: Binary name (defaults to first tool name)\n- `vscodeSetting.subdirs`: Subdirectories to append to the path\n- `supportsShims`: Whether extension supports shims (default: true)\n- `supportsSymlinks`: Whether extension supports symlinks (default: true)",
+          "markdownDescription": "Custom binary extensions to automatically configure VSCode extensions with mise tool binaries.\n\nEach entry requires:\n- `extensionId`: VSCode extension ID\n- `toolSources`: Array of mise tool registry sources to match\n- `vscodeSetting.key`: VSCode setting key to write\n\nOptional:\n- `binName`: Binary name (defaults to first tool name)\n- `vscodeSetting.subdirs`: Subdirectories to append to the path\n- `vscodeSetting.asArray`: Whether to wrap the setting value in an array (default: false)\n- `supportsShims`: Whether extension supports shims (default: true)\n- `supportsSymlinks`: Whether extension supports symlinks (default: true)",
           "items": {
             "type": "object",
             "required": [
@@ -427,6 +427,11 @@
                       "type": "string"
                     },
                     "description": "Subdirectories to append to the tool path (e.g., ['bin'] to point to bin folder)"
+                  },
+                  "asArray": {
+                    "type": "boolean",
+                    "default": false,
+                    "description": "Whether to wrap the setting value in an array (e.g., ['/path/to/bin'] instead of '/path/to/bin')"
                   }
                 }
               },

src/configuration.ts

@@ -209,6 +209,7 @@ export const isTaskSymbolProviderEnabled = () => {
 type VSCodeSettingSubdirs = {
 	key: string;
 	subdirs?: string[];
+	asArray?: boolean;
 };
 
 type CustomBinaryExtensionConfig = {

src/utils/supportedExtensions.ts

@@ -616,7 +616,7 @@ function appendSubdirs(basePath: string, subdirs?: string[]): string {
 export function createCustomBinaryExtensionConfig(customConfig: {
 	extensionId: string;
 	toolSources: string[];
-	vscodeSetting: { key: string; subdirs?: string[] };
+	vscodeSetting: { key: string; subdirs?: string[]; asArray?: boolean };
 	binName?: string;
 	supportsShims?: boolean;
 	supportsSymlinks?: boolean;
@@ -659,6 +659,13 @@ export function createCustomBinaryExtensionConfig(customConfig: {
 				}
 			}
 
+			if (customConfig.vscodeSetting.asArray) {
+				const value = result[customConfig.vscodeSetting.key];
+				if (typeof value === "string") {
+					result[customConfig.vscodeSetting.key] = [value];
+				}
+			}
+
 			return result;
 		},
 	};