feat: Add extension and settings support for vscode

Author: kevinwang5658

completions-cron/src/__generated__/completions-index.ts

@@ -3,21 +3,37 @@ title: vscode
 description: A reference page for the vscode resource
 ---
 
-The vscode resource reference. This resource installs `vscode` to your system. Vscode is a popular
-lightweight code editor developed by Microsoft. Vscode supports many coding languages via plugins.
+The vscode resource reference. This resource installs `vscode` to your system and manages extensions
+and editor settings. Vscode is a popular lightweight code editor developed by Microsoft.
 For more information on Vscode [see here](https://code.visualstudio.com)
 
 ## Parameters:
 
-- **directory**: *(string)* A custom directory to install the vscode application into. The default is
-`$HOME/Applications/`.
+- **directory**: *(string)* A custom directory to install the vscode application into. Defaults to
+`/Applications` on macOS and `$HOME/.local/bin` on Linux.
+
+- **extensions**: *(string[])* A list of VS Code extension IDs to install (e.g. `"ms-python.python"`).
+Extensions are managed statefully — Codify will install missing extensions and uninstall ones removed
+from the list.
+
+- **settings**: *(object)* Key-value pairs to merge into `settings.json`. On apply, the declared keys
+are written to the user settings file. On destroy, only the declared keys are removed.
 
 ## Example usage:
 
 ```json title="codify.jsonc"
 [
   {
-    "type":  "vscode"
+    "type": "vscode",
+    "extensions": [
+      "ms-python.python",
+      "ms-python.vscode-pylance",
+      "eamodio.gitlens"
+    ],
+    "settings": {
+      "editor.fontSize": 14,
+      "editor.formatOnSave": true
+    }
   }
 ]
 ```

docs/resources/(resources)/vscode.mdx

@@ -0,0 +1,24 @@
+export default async function loadVscodeExtensions(): Promise<string[]> {
+  const body = {
+    filters: [{
+      criteria: [{ filterType: 8, value: 'Microsoft.VisualStudio.Code' }],
+      pageSize: 200,
+      sortBy: 4,
+    }],
+    flags: 914,
+  };
+
+  const response = await fetch('https://marketplace.visualstudio.com/_apis/public/gallery/extensionquery', {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json',
+      'Accept': 'application/json;api-version=7.2-preview.1',
+    },
+    body: JSON.stringify(body),
+  });
+
+  const data = await response.json() as any;
+  return data.results[0].extensions.map(
+    (e: any) => `${e.publisher.publisherName}.${e.extensionName}` as string
+  );
+}

src/resources/vscode/completions/vscode.extensions.ts

@@ -0,0 +1,44 @@
+import { ArrayParameterSetting, SpawnStatus, StatefulParameter, getPty } from '@codifycli/plugin-core';
+
+import { VscodeConfig } from './vscode.js';
+
+export class ExtensionsParameter extends StatefulParameter<VscodeConfig, string[]> {
+  getSettings(): ArrayParameterSetting {
+    return {
+      type: 'array',
+      isElementEqual(desired, current) {
+        return desired.toLowerCase() === current.toLowerCase();
+      },
+    };
+  }
+
+  override async refresh(): Promise<string[] | null> {
+    const $ = getPty();
+    const result = await $.spawnSafe('code --list-extensions');
+    if (result.status !== SpawnStatus.SUCCESS || result.data == null) {
+      return null;
+    }
+    return result.data.split('\n').filter(Boolean);
+  }
+
+  async add(toAdd: string[]): Promise<void> {
+    const $ = getPty();
+    for (const ext of toAdd) {
+      await $.spawn(`code --install-extension ${ext} --force`, { interactive: true });
+    }
+  }
+
+  async modify(newValue: string[], previousValue: string[]): Promise<void> {
+    const toAdd = newValue.filter((n) => !previousValue.some((p) => p.toLowerCase() === n.toLowerCase()));
+    const toRemove = previousValue.filter((p) => !newValue.some((n) => n.toLowerCase() === p.toLowerCase()));
+    await this.remove(toRemove);
+    await this.add(toAdd);
+  }
+
+  async remove(toRemove: string[]): Promise<void> {
+    const $ = getPty();
+    for (const ext of toRemove) {
+      await $.spawnSafe(`code --uninstall-extension ${ext}`);
+    }
+  }
+}