coc-vscode-loader 1.1.8 → 1.2.0

package/converter/src/transforms/class-to-factory.ts

@@ -39,8 +39,7 @@ export const transformClassToFactory: Transform = (ctx) => {
     (match, type) => `${type}.create(`
   )
 
-  // CompletionItem.create(label) doesn't accept kind in coc.
-  // Convert `CompletionItem.create(label, kind)` to `item = CompletionItem.create(label); item.kind = kind`
+  // CompletionItem.create(label, kind) → item = CompletionItem.create(label); item.kind = kind
   text = text.replace(
     /const\s+(\w+)\s*=\s*CompletionItem\.create\(([^,]+),\s*([^)]+)\)/g,
     (_, varName, label, kind) => {

package/converter/src/transforms/enum-offset.ts

@@ -19,23 +19,6 @@ export const transformEnumOffset: Transform = (ctx) => {
   const { file } = ctx
   let content = file.getText()
 
-  // Detect hardcoded numbers used in enum position (e.g., CompletionItemKind.Xxx).
-  // This is hard to detect perfectly, so we log a note when numeric literals
-  // appear near enum-type names.
-  const enumPatterns = [
-    'CompletionItemKind', 'SymbolKind', 'DocumentHighlightKind', 'DiagnosticSeverity',
-    'CompletionTriggerKind', 'InlineCompletionTriggerKind',
-  ]
-
-  for (const enumName of enumPatterns) {
-    // Check if the enum is imported/used with a hardcoded number nearby
-    const enumRefs = content.match(new RegExp(`${enumName}\\.\\w+`, 'g'))
-    if (enumRefs) {
-      // Symbol references are fine - they resolve at runtime
-      // Only note if there are raw numbers being compared
-    }
-  }
-
   // Replace any numeric enum comparisons with comments
   // e.g., `severity === 0` → `severity === 0 /* DiagnosticSeverity.Error = 1 in coc */`
   content = content.replace(

package/converter/src/transforms/provider-register.ts

@@ -1,3 +1,4 @@
+import * as path from 'path'
 import { Transform } from '../types.js'
 
 /**
@@ -32,10 +33,15 @@ export const transformProviderRegister: Transform = (ctx) => {
   }
 
   // 2. registerCompletionItemProvider: insert name + shortcut at beginning
+  // Shortcut derived from source file name (first 2 uppercase letters)
+  const fileName = file.getFilePath() || 'plugin'
+  const baseName = path.basename(fileName, '.ts')
+  const shortcut = baseName.replace(/[^a-zA-Z]/g, '').substring(0, 2).toUpperCase() || 'PL'
   if (content.includes('registerCompletionItemProvider')) {
+    const pluginName = path.basename(path.dirname(path.dirname(fileName))) || 'plugin'
     content = content.replace(
       /registerCompletionItemProvider\(/g,
-      `registerCompletionItemProvider('plugin', 'PL', `
+      `registerCompletionItemProvider('${pluginName}', '${shortcut}', `
     )
     // Wrap the last argument in an array if it's a string (trigger chars)
     content = content.replace(

package/converter/src/transforms/strip-volar.ts

@@ -0,0 +1,29 @@
+import { Transform } from '../types.js'
+
+/**
+ * Remove Volar-specific framework imports that are not compatible with coc.nvim.
+ * The Volar extension uses @volar/vscode and reactive-vscode meta-framework,
+ * which need to be stripped since the bridge step provides alternative setup.
+ */
+export const transformStripVolar: Transform = (ctx) => {
+  const { file } = ctx
+  let content = file.getText()
+  let changed = false
+
+  const patterns = [
+    /import .* from ['"]@volar\/vscode['"];?\n?/g,
+    /import .* from ['"]reactive-vscode['"];?\n?/g,
+    /import \* as lsp from ['"]@volar\/vscode\/node['"];?\n?/g,
+  ]
+
+  for (const re of patterns) {
+    if (re.test(content)) {
+      content = content.replace(re, '')
+      changed = true
+    }
+  }
+
+  if (changed) {
+    file.replaceWithText(content)
+  }
+}

package/converter/src/types.ts

@@ -6,3 +6,120 @@ export interface TransformContext {
 }
 
 export type Transform = (ctx: TransformContext) => void
+
+// ---- Step type definitions ----
+
+export interface ServerModuleConfig {
+  kind: 'module'
+  package: string
+  entry?: 'main' | 'bin'
+}
+
+export interface ServerBinaryConfig {
+  kind: 'binary'
+  package: string
+  binary: {
+    repo: string
+    asset: string
+    binaryPath?: string
+  }
+  args?: string[]
+}
+
+export type ServerConfig = ServerModuleConfig | ServerBinaryConfig
+
+export interface LanguageClientStep {
+  type: 'language-client'
+  id?: string
+  server: ServerConfig
+  transport?: 'ipc' | 'stdio'
+  languages: string[]
+  multiRoot?: boolean
+  /** Enable debug logging in generated code */
+  verbose?: boolean
+}
+
+export interface SourceStep {
+  type: 'source'
+  transforms: string[]
+  entry?: string
+  keepDeps?: string[] | Record<string, string>
+  activationEvents?: string[]
+  /** Enable debug logging in generated/transformed code */
+  verbose?: boolean
+}
+
+export interface BridgeStep {
+  type: 'bridge'
+  preset?: string
+  /** Override preset options (extensions, services, etc.) */
+  options?: {
+    extensions?: string[]
+    services?: string[]
+  }
+  /** Enable debug logging in generated bridge code */
+  verbose?: boolean
+}
+
+export interface MarkUnsupportedStep {
+  type: 'mark-unsupported'
+  features: string[]
+  /** Enable detailed output during conversion */
+  verbose?: boolean
+}
+
+export type ConvertStep = LanguageClientStep | SourceStep | BridgeStep | MarkUnsupportedStep
+
+// ---- Step execution ----
+
+export interface StepResult {
+  generatedFiles: Array<{ path: string; content: string }>
+  entryPoint?: string
+  keepDeps: Record<string, string>
+  activationEvents: string[]
+  serverBinary?: {
+    repo: string
+    asset: string
+    binaryPath?: string
+    args?: string[]
+  }
+  /** Code to inject into previously generated files (target path, code to insert, insertion point) */
+  codeInjections?: Array<{
+    target: string        // file to modify (e.g. 'src/index.ts')
+    importCode?: string   // import line to add at top
+    insertBefore?: string // regex pattern to insert code before
+    insertAfter?: string  // regex pattern to insert code after
+    code: string          // code to insert
+  }>
+}
+
+export interface StepContext {
+  input: string
+  output: string
+  project: Project
+  origPkg: Record<string, any>
+  verbose?: boolean
+  /** Preset definitions from registry (e.g. bridge presets) */
+  presets?: Record<string, any>
+}
+
+export interface StepGenerator {
+  type: string
+  generate(ctx: StepContext, step: ConvertStep): StepResult
+}
+
+export function isLanguageClientStep(s: ConvertStep): s is LanguageClientStep {
+  return s.type === 'language-client'
+}
+
+export function isSourceStep(s: ConvertStep): s is SourceStep {
+  return s.type === 'source'
+}
+
+export function isBridgeStep(s: ConvertStep): s is BridgeStep {
+  return s.type === 'bridge'
+}
+
+export function isMarkUnsupportedStep(s: ConvertStep): s is MarkUnsupportedStep {
+  return s.type === 'mark-unsupported'
+}

package/lib/index.js

@@ -39,7 +39,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "coc-vscode-loader",
-      version: "1.1.8",
+      version: "1.2.0",
       description: "Run VS Code extensions seamlessly in coc.nvim",
       main: "lib/index.js",
       keywords: [
@@ -60,7 +60,8 @@ var require_package = __commonJS({
       homepage: "https://www.npmjs.com/package/coc-vscode-loader",
       files: [
         "lib/",
-        "converter/",
+        "converter/src/",
+        "converter/package.json",
         "assets/"
       ],
       license: "MIT",
@@ -68,7 +69,7 @@ var require_package = __commonJS({
         coc: ">= 0.0.80"
       },
       scripts: {
-        "bundle-converter": "if [ -d ../converter ]; then rm -rf converter && cp -r ../converter ./converter && cd converter && npm install --legacy-peer-deps 2>/dev/null && npm prune --production 2>/dev/null; fi",
+        "bundle-converter": "if [ -d ../converter ]; then rm -rf converter && cp -r ../converter ./converter && cd converter && npm install --legacy-peer-deps 2>/dev/null; fi",
         build: "npm run bundle-converter && node esbuild.mjs",
         prepare: "npm run bundle-converter && node esbuild.mjs"
       },
@@ -158,9 +159,13 @@ async function fetchRegistryJSON(url) {
     (0, import_child_process.execFile)("curl", ["-sL", url], { encoding: "utf-8", maxBuffer: 5 * 1024 * 1024 }, (err, stdout) => {
       if (err) reject(new Error(`curl failed: ${err.message}`));
       else {
-        const data = JSON.parse(stdout);
-        if (!Array.isArray(data)) reject(new Error("Invalid registry format"));
-        else resolve2(data);
+        try {
+          const data = JSON.parse(stdout);
+          if (!Array.isArray(data)) reject(new Error("Invalid registry format"));
+          else resolve2(data);
+        } catch (e) {
+          reject(new Error(`Invalid JSON from registry: ${e.message}`));
+        }
       }
     });
   });
@@ -436,8 +441,10 @@ function pluginDir(name) {
 function converterCliPath() {
   const base = path3.resolve(__dirname, "..");
   const candidates = [
-    path3.join(base, "converter", "src", "cli.ts"),
-    path3.join(base, "..", "converter", "src", "cli.ts")
+    // In dev mode (symlink), the converter is at repo root
+    path3.join(base, "..", "converter", "src", "cli.ts"),
+    // In npm install, the converter is bundled inside the package
+    path3.join(base, "converter", "src", "cli.ts")
   ];
   for (const p of candidates) {
     if (fs3.existsSync(p)) return p;
@@ -449,7 +456,7 @@ function converterCliPath() {
 var CMD_TIMEOUT = 3e5;
 async function run(cmd, args, cwd, onLine) {
   return new Promise((resolve2, reject) => {
-    const child = (0, import_child_process2.spawn)(cmd, args, { cwd, stdio: ["ignore", "pipe", "pipe"], shell: true });
+    const child = (0, import_child_process2.spawn)(cmd, args, { cwd, stdio: ["ignore", "pipe", "pipe"], shell: false });
     const timer = setTimeout(() => {
       child.kill("SIGTERM");
       reject(new Error(`Timed out after ${CMD_TIMEOUT / 1e3}s: ${cmd} ${args.join(" ")}`));
@@ -491,13 +498,33 @@ async function downloadSource(info, name, onProgress) {
   }
   return info.source.subdir ? path3.join(srcDir, info.source.subdir) : srcDir;
 }
-async function convertSource(inputDir, name, onProgress) {
+async function convertSource(inputDir, name, info, onProgress) {
   const build = buildDir(name);
   if (fs3.existsSync(build)) fs3.rmSync(build, { recursive: true });
   const cli = converterCliPath();
+  const converterDir = path3.resolve(path3.dirname(path3.dirname(cli)));
+  if (!fs3.existsSync(path3.join(converterDir, "node_modules", "commander"))) {
+    onProgress(2, 5, "Installing converter dependencies...", "");
+    const log2 = (chunk) => onProgress(2, 5, chunk.trim(), "");
+    await run("npm", ["install", "--legacy-peer-deps", "--production"], converterDir, log2);
+  }
+  if (!info.convert || !Array.isArray(info.convert) || info.convert.length === 0) {
+    throw new Error(`Registry entry "${name}" has no "convert" config. Please update the registry.`);
+  }
+  const convertFile = path3.join(cacheDir(name), "convert-config.json");
+  fs3.mkdirSync(path3.dirname(convertFile), { recursive: true });
+  fs3.writeFileSync(convertFile, JSON.stringify(info.convert));
+  const presetsFile = path3.join(cacheDir(name), "presets-config.json");
+  const registryDir = path3.resolve(__dirname, "..", "..", "coc-vscode-registry");
+  const presetsPath = path3.join(registryDir, "presets.json");
+  if (fs3.existsSync(presetsPath)) {
+    fs3.writeFileSync(presetsFile, fs3.readFileSync(presetsPath));
+  }
+  const args = ["tsx", cli, "convert", inputDir, "-o", build, "--convert-file", convertFile];
+  if (fs3.existsSync(presetsFile)) args.push("--presets-file", presetsFile);
   onProgress(2, 5, "Converting...", `converter convert ${inputDir} -o ${build}`);
   const log = (chunk) => onProgress(2, 5, chunk.trim(), "");
-  await run("npx", ["tsx", cli, "convert", inputDir, "-o", build], cacheDir(name), log);
+  await run("npx", args, cacheDir(name), log);
 }
 async function buildPackage(name, inputDir, info, onProgress) {
   const build = buildDir(name);
@@ -607,56 +634,18 @@ async function buildPackage(name, inputDir, info, onProgress) {
       }
       const indexPath = path3.join(build, "lib", "index.js");
       if (fs3.existsSync(indexPath)) {
-        const binPath = (sb.binaryPath || sb.asset.split(/-?\{\{/)[0]).replace(/\{\{version}}/g, version).replace(/\{\{platform}}/g, platform).replace(/\{\{arch}}/g, arch2).replace(/\{\{raw-arch}}/g, rawArch).replace(/\{\{rust-target}}/g, rustTarget);
         let code = fs3.readFileSync(indexPath, "utf-8");
-        const svrArgs = sb.args?.length ? JSON.stringify(sb.args) : "[]";
-        code = code.replace(
-          /\{ module:\s*serverModule,\s*transport:\s*\w+\.TransportKind\.\w+\s*\}/,
-          `{ command: serverModule, args: ${svrArgs} }`
-        );
-        const serverPath = `require('path').join(__dirname, '..', 'server', '${binPath}')`;
-        code = code.replace(
-          /try\s*\{[^}]*?require\.resolve\([^)]+\)\s*;?\s*\}\s*catch\s*\{\s*\}/g,
-          `try { serverModule = ${serverPath} } catch {}`
-        );
-        code = code.replace(
-          /let\s+serverModule\s*=\s*config\.get\([^)]+\)\s*;?\s*/g,
-          `let serverModule = ${serverPath};`
-        );
+        code = code.replace(/\{\{version}}/g, version);
+        code = code.replace(/\{\{platform}}/g, platform);
+        code = code.replace(/\{\{arch}}/g, arch2);
+        code = code.replace(/\{\{raw-arch}}/g, rawArch);
+        code = code.replace(/\{\{rust-target}}/g, rustTarget);
         fs3.writeFileSync(indexPath, code);
       }
     } catch (e) {
       onProgress(4, 5, `Warning: serverBinary setup failed (${e.message})`, "install server binary manually");
     }
   }
-  const docSelPath = path3.join(build, "lib", "index.js");
-  if (fs3.existsSync(docSelPath)) {
-    let code = fs3.readFileSync(docSelPath, "utf-8");
-    const langSelector = info.languages.map((l) => `{ scheme: "file", language: "${l}" }`).join(", ");
-    code = code.replace(
-      /documentSelector:\s*\[\s*\{[^}]*?language:\s*['"][^'"]*['"][^}]*\}\s*\]/,
-      `documentSelector: [${langSelector}]`
-    );
-    code = code.replace(
-      /client\.start\(\);/g,
-      "client.start().catch(() => {/* init may complete async */});"
-    );
-    fs3.writeFileSync(docSelPath, code);
-  }
-  const pkgPath = path3.join(build, "package.json");
-  if (fs3.existsSync(pkgPath)) {
-    try {
-      const pkg = JSON.parse(fs3.readFileSync(pkgPath, "utf-8"));
-      const events = pkg.activationEvents || [];
-      const langEvents = info.languages.map((l) => `onLanguage:${l}`);
-      const newEvents = events.filter((e) => !e.startsWith("onLanguage:")).concat(langEvents);
-      if (newEvents.length > 0 && JSON.stringify(newEvents) !== JSON.stringify(events)) {
-        pkg.activationEvents = newEvents;
-        fs3.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2));
-      }
-    } catch {
-    }
-  }
 }
 function extensionsPkgPath() {
   return path3.join(os3.homedir(), ".config", "coc", "extensions", "package.json");
@@ -669,7 +658,7 @@ async function installToCoc(name, onProgress) {
   fs3.mkdirSync(path3.dirname(dest), { recursive: true });
   fs3.cpSync(src, dest, { recursive: true });
   const pkgPath = extensionsPkgPath();
-  const pkg = JSON.parse(fs3.readFileSync(pkgPath, "utf-8"));
+  const pkg = fs3.existsSync(pkgPath) ? JSON.parse(fs3.readFileSync(pkgPath, "utf-8")) : { dependencies: {} };
   pkg.dependencies = pkg.dependencies || {};
   const depName = `coc-${name}`;
   if (!pkg.dependencies[depName]) {
@@ -707,7 +696,7 @@ async function installPackage(state, name) {
   state.setPackageStatus(name, "installing", { progress: "Starting..." });
   try {
     const input = await downloadSource(info, name, prog);
-    await convertSource(input, name, prog);
+    await convertSource(input, name, info, prog);
     await buildPackage(name, input, info, prog);
     await installToCoc(name, prog);
     await saveMeta(name);
@@ -779,13 +768,13 @@ async function updatePackage(state, name) {
   state.setPackageStatus(name, "updating", { progress: "Starting..." });
   try {
     const input = await downloadSource(info, name, prog);
-    await convertSource(input, name, prog);
+    await convertSource(input, name, info, prog);
     await buildPackage(name, input, info, prog);
     await installToCoc(name, prog);
     await saveMeta(name);
     state.setDirty();
     state.setPackageStatus(name, "installed");
-    import_coc.window.showInformationMessage(`coc-${name} installed`);
+    import_coc.window.showInformationMessage(`coc-${name} updated`);
     try {
       const meta = JSON.parse(fs3.readFileSync(metaPath(name), "utf-8"));
       if (meta.commit) {
@@ -807,7 +796,7 @@ async function updatePackage(state, name) {
 }
 async function runWithOutput(cmd, args, cwd) {
   return new Promise((resolve2, reject) => {
-    const child = (0, import_child_process2.spawn)(cmd, args, { cwd, stdio: ["ignore", "pipe", "pipe"], shell: true });
+    const child = (0, import_child_process2.spawn)(cmd, args, { cwd, stdio: ["ignore", "pipe", "pipe"], shell: false });
     const timer = setTimeout(() => {
       child.kill("SIGTERM");
       reject(new Error(`Timed out after ${CMD_TIMEOUT / 1e3}s: ${cmd} ${args.join(" ")}`));
@@ -1220,7 +1209,7 @@ var TUI = class {
       return;
     }
     if (id === "X" && entry.status === "installed") {
-      uninstallPackage(this.state, pkgName);
+      await uninstallPackage(this.state, pkgName);
       return;
     }
     if (id === "R" && entry.status === "installed") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "coc-vscode-loader",
-  "version": "1.1.8",
+  "version": "1.2.0",
   "description": "Run VS Code extensions seamlessly in coc.nvim",
   "main": "lib/index.js",
   "keywords": [
@@ -21,7 +21,8 @@
   "homepage": "https://www.npmjs.com/package/coc-vscode-loader",
   "files": [
     "lib/",
-    "converter/",
+    "converter/src/",
+    "converter/package.json",
     "assets/"
   ],
   "license": "MIT",
@@ -29,7 +30,7 @@
     "coc": ">= 0.0.80"
   },
   "scripts": {
-    "bundle-converter": "if [ -d ../converter ]; then rm -rf converter && cp -r ../converter ./converter && cd converter && npm install --legacy-peer-deps 2>/dev/null && npm prune --production 2>/dev/null; fi",
+    "bundle-converter": "if [ -d ../converter ]; then rm -rf converter && cp -r ../converter ./converter && cd converter && npm install --legacy-peer-deps 2>/dev/null; fi",
     "build": "npm run bundle-converter && node esbuild.mjs",
     "prepare": "npm run bundle-converter && node esbuild.mjs"
   },

package/converter/README.md

@@ -1,134 +0,0 @@
-# converter — vscode → coc converter prototype
-
-CLI tool that automatically converts VS Code extensions to coc.nvim plugins.
-
-## Usage
-
-```bash
-# Convert a VS Code extension directory
-npx tsx src/cli.ts convert ./vscode-ext/ -o ./coc-ext/
-
-# Build and install to coc
-cd ./coc-ext && npm install && npm run build
-cd ~/.config/coc/extensions && npm install /path/to/coc-ext
-```
-
-## Verified conversions
-
-| Plugin | Type | Auto-detected | Build | Working | Notes |
-|--------|------|---------------|-------|---------|-------|
-| Volar (Vue) | TS bridge | `@vue/language-server` + `typescript` | ✅ | ✅ | Requires modified coc-tsserver |
-| Prisma | Pure LSP | `@prisma/language-server` | ✅ | ✅ | Auto-detects bin entry |
-| HTML CSS Support | Direct API | — | ✅ | ✅ | Handles API differences |
-
-### Plugin types
-
-| Type | Description | Approach | Example |
-|------|-------------|----------|---------|
-| **TS bridge** | Language plugins depending on TypeScript LSP | Generate `tsserver/request` bridge + `typescriptServerPlugins` | Volar |
-| **Pure LSP** | Standard LSP using LanguageClient | Generate LanguageClient entry + server dependency injection | Prisma |
-| **Direct API** | Direct coc.nvim API calls (no LanguageClient) | Keep original `extension.ts` as entry, no bridge | HTML CSS Support |
-
-TS bridge plugins require a modified coc-tsserver ([PR #493](https://github.com/neoclide/coc-tsserver/pull/493)):
-
-```bash
-cd ~/.config/coc/extensions
-npm install ChuYanLon/coc-tsserver --legacy-peer-deps
-```
-
-## Architecture
-
-```
-Input: VS Code extension directory
-  │
-  ├─ scanner        Analyze API → detect plugin type
-  ├─ transforms/    AST transforms
-  │   ├─ import-mapping      from 'vscode' → from 'coc.nvim'
-  │   ├─ class-to-factory    new Xxx() → Xxx.create()
-  │   ├─ provider-register   Adapt provider registration signatures
-  │   ├─ language-client     Adapt LanguageClient signatures
-  │   └─ enum-offset         Comment on enum value offsets
-  ├─ mark-unsupported  Replace/mark missing APIs (getWordRangeAtPosition, fileName, etc.)
-  ├─ generate src/index.ts   Main entry (bridge / LanguageClient / direct templates)
-  ├─ generate package.json   Dependencies / esbuild external config
-  └─ generate esbuild.mjs    Build config
-```
-
-## Bridge preset system
-
-Bridge logic is preset-driven rather than hardcoded:
-
-```typescript
-// presets.ts - all bridge presets defined here
-const PRESETS = {
-  'ts-bridge': {
-    notification: 'tsserver/request',
-    responseNotification: 'tsserver/response',
-    handler: { type: 'command', command: 'typescript.tsserverRequest' },
-    extraDeps: ['typescript'],
-  },
-  // future: python-bridge, rust-bridge, etc.
-}
-```
-
-`convert.ts` only calls `getActivePresets()` + `generateBridgeCode()`, it never touches bridge logic directly.
-Adding a new bridge type = add a new preset in `presets.ts`, no changes to main flow.
-
-See [coc-vscode-registry/docs/converter-design-v2.md](https://github.com/coc-plugin/coc-vscode-registry/blob/main/docs/converter-design-v2.md).
-
-## File structure
-
-| File | Lines | Description |
-|------|-------|-------------|
-| `src/cli.ts` | 28 | CLI entry |
-| `src/convert.ts` | 484 | Main flow + template generation + API replacement |
-| `src/scanner.ts` | 136 | API scanner + plugin classification |
-| `src/transforms/import-mapping.ts` | 47 | Import replacement |
-| `src/transforms/language-client.ts` | 48 | LanguageClient adaptation |
-| `src/transforms/class-to-factory.ts` | 54 | new Xxx() → Xxx.create() |
-| `src/transforms/provider-register.ts` | 55 | Provider registration signature fixes |
-| `src/transforms/enum-offset.ts` | 49 | Enum value offset annotations |
-| **Total** | **~870** | |
-
-## Handled API differences
-
-| API | VS Code | coc.nvim | Handling |
-|-----|---------|----------|----------|
-| import | `from 'vscode'` | `from 'coc.nvim'` | Direct replace |
-| Position/Range/Location etc. | `new Xxx()` | `Xxx.create()` | AST replace |
-| EventEmitter | `EventEmitter<T>` | `Emitter<T>` | Direct replace |
-| registerCompletionItemProvider | `(sel, p, ...t)` | `(name, shortcut, sel, p, t?)` | Pad arguments |
-| registerCodeActionsProvider | `registerCodeActionsProvider` | `registerCodeActionProvider` | Rename |
-| registerReferenceProvider | `registerReferenceProvider` | `registerReferencesProvider` | Rename |
-| CompletionItem.create | `new CompletionItem(label, kind)` | `CompletionItem.create(label)` + `item.kind = kind` | kind set separately |
-| Trigger characters | `" "` (string) | `[" "]` (array) | Rest param → array |
-| CompletionItemKind enum | `Value = 11`, `Enum = 12` | `Value = 12`, `Enum = 13` | Offset by 1, symbols auto-adapt |
-| documentSelector | `[{ language: 'xxx' }]` | Same | Auto-infer from package.json |
-| getWordRangeAtPosition | `document.getWordRangeAtPosition()` | Not available | Inline word boundary calculation |
-| fileName | `document.fileName` | Not available | Replace with `document.uri` |
-| createTextEditorDecorationType | `window.createTextEditorDecorationType()` | Not available | Mark TODO |
-| createWebviewPanel | `window.createWebviewPanel()` | Not available | Mark TODO |
-
-### Missing API strategy
-
-When a VS Code API has no coc.nvim equivalent, the approach is:
-
-1. Find the [VS Code source](https://github.com/microsoft/vscode) implementation
-2. Evaluate complexity:
-   - **Simple** (e.g. `getWordRangeAtPosition`) → inline polyfill
-   - **Complex** (e.g. decoration, webview) → mark TODO with explanation
-3. Polyfill using existing coc APIs where possible, avoid new dependencies
-
-Known VS Code API source locations:
-- `getWordRangeAtPosition` → `src/vs/editor/common/core/wordHelper.ts`
-- `TextDocument.fileName` → coc uses `document.uri` instead (`DocumentUri = string`)
-- Decoration system → `src/vs/editor/common/viewModel/viewDecorations.ts`
-
-## Key design decisions
-
-- **Zero hardcoding** — server package names auto-detected from source
-- **Bin entry fallback** — auto-detect and prefer `package.json` bin entry
-- **Auto esbuild external injection** — detected server packages marked as external
-- **Auto TS bridge injection** — `typescriptServerPlugins` + `tsserver/request` forwarding
-- **Plugin classification** — auto-detect TS bridge / pure LSP / direct API
-- **Missing API handling** — polyfill where possible, mark TODO otherwise