@ttsc/vscode 0.13.1 → 0.14.0-dev.20260528.1

package/README.md

@@ -4,18 +4,21 @@
 
 MIT licensed · [npm](https://www.npmjs.com/package/@ttsc/vscode) · [docs](https://ttsc.dev/docs) · [Discord](https://discord.gg/E94XhzrUCZ)
 
-VSCode extension for [`ttsc`](https://ttsc.dev) projects.
+VS Code extension for [`ttsc`](https://ttsc.dev) projects.
 
-Lint diagnostics, format hints, and plugin code actions appear in your editor live — the same diagnostics `ttsc` would emit at build time, shown as you type.
+It starts the `ttscserver` language-server launcher from your project's own
+`ttsc` dependency, so VS Code uses the same TypeScript-Go version your project
+pins.
 
 ## Requirements
 
 - **VS Code** 1.94 or later
 - **Node.js** 18 or later
-- **`ttsc` installed in your project** — the extension uses the language server that ships with your project's `ttsc` package
+- **`ttsc` installed in your project** — the extension uses the language server
+  that ships with your project's `ttsc` package
 
 ```bash
-npm install -D ttsc @ttsc/lint @typescript/native-preview
+npm install -D ttsc @typescript/native-preview
 ```
 
 ## Install
@@ -41,14 +44,32 @@ Marketplace release is tracked for v1; once it lands, the `npx` step goes away.
 
 ## What it adds
 
-The extension activates on any TypeScript, JavaScript, TSX, or JSX file inside a project that has `ttsc` installed.
-
-- **Live lint underlines.** Violations from `@ttsc/lint` (and any third-party rule plugins you've installed) appear in the same gutter as TypeScript type errors — same `error TSxxxxx` shape.
-- **Quick fixes** for autofixable rules under the lightbulb menu.
-- **Command palette entries:**
-  - `ttsc: Apply lint fixes to current file`
-  - `ttsc: Format current document`
-  - `ttsc: Restart language server`
+The extension activates on TypeScript, JavaScript, TSX, and JSX files, then
+starts a server only when it can resolve a project-local `ttscserver`.
+
+- **Project-local language server.** The extension resolves `ttscserver` from
+  the active file's package/workspace, then starts the project-selected
+  `tsgo --lsp --stdio` process behind it.
+- **TypeScript-Go diagnostics and editor features.** Hover, navigation,
+  completions, and TypeScript-Go diagnostics come from the upstream `tsgo` LSP
+  process.
+- **ttsc plugin diagnostics and actions.** LSP-capable plugins are discovered
+  from the same project config and merged into the editor stream. `@ttsc/lint`
+  currently contributes lint diagnostics, fix-all actions, and document format
+  edits. Plugin diagnostics, code actions, and command computation use the
+  saved project state today; commands return VS Code `WorkspaceEdit`s and the
+  editor applies them only while the touched documents are still clean.
+- **Monorepo-aware server roots.** Multi-root workspaces start server contexts
+  from the active file and workspace folders, resolved from the nearest
+  `tsconfig*.json` / `jsconfig*.json`. Add packages as VS Code workspace
+  folders when you want each package to keep its own active server context.
+- **Command palette entries:** `ttsc: Restart language server`,
+  `ttsc: Fix all lint issues`, and `ttsc: Format document`. The lint and
+  format commands require an LSP-capable plugin that owns those command ids,
+  such as `@ttsc/lint`. The VS Code extension registers wrapper commands for
+  those built-in lint/format flows; other plugin command ids are advertised
+  through the language client and their returned `changes`-map `WorkspaceEdit`s
+  are applied with the same clean-document guard.
 
 The extension's identifier inside VS Code is `samchon.ttsc`.
 
@@ -56,18 +77,19 @@ The extension's identifier inside VS Code is `samchon.ttsc`.
 
 Open VS Code's settings (`Ctrl+,` / `Cmd+,`) and search for `ttsc`, or edit `settings.json` directly:
 
-| Setting | Default | Effect |
-| --- | --- | --- |
-| `ttsc.serverPath` | `""` | Absolute path to a language-server binary. Empty means use the one bundled with the project's `ttsc` install — almost always what you want. |
-| `ttsc.trace.server` | `"off"` | Set to `"messages"` or `"verbose"` to log LSP traffic. The log goes to **View → Output → ttsc**. Useful when diagnostics don't show up. |
+| Setting             | Default | Effect                                                                                                                                                                                                                                 |
+| ------------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `ttsc.serverPath`   | `""`    | Absolute path to a `ttscserver` launcher or native binary. Empty uses the project's `ttsc` launcher, which builds `TTSC_LSP_PLUGINS_JSON` for plugin diagnostics/actions. Direct native paths need that manifest supplied out of band. |
+| `ttsc.trace.server` | `"off"` | Set to `"messages"` or `"verbose"` to log LSP traffic. The trace goes to **View → Output → ttsc (trace)**; server logs stay under **ttsc**. Useful when diagnostics don't show up.                                                     |
 
 ## Troubleshooting
 
-If lint underlines don't appear after install:
+If TypeScript-Go or ttsc plugin diagnostics don't appear after install:
 
-1. **Check the project has `ttsc`:** `npx ttsc --version`. If this errors, install `ttsc @ttsc/lint @typescript/native-preview` in the project first.
-2. **Read the server log:** open **View → Output**, pick **ttsc** from the dropdown.
-3. **Restart the server:** command palette → `ttsc: Restart language server`.
-4. **Verbose tracing:** set `ttsc.trace.server` to `"verbose"`, repeat step 2.
+1. **Check the project has `ttsc`:** `npx ttsc --version`. If this errors, install `ttsc @typescript/native-preview` in the project first.
+2. **Check the same config in the CLI:** run `npx ttsc --noEmit -p <selected tsconfig>` from the project root and confirm the plugin diagnostics appear there.
+3. **Read the server log:** open **View → Output**, pick **ttsc** from the dropdown.
+4. **Restart the server:** command palette → `ttsc: Restart language server`.
+5. **Verbose tracing:** set `ttsc.trace.server` to `"verbose"`, then read **View → Output → ttsc (trace)**.
 
 If `npx ttsc-vscode` errors with `\`code\` CLI not found on PATH`: open VS Code → command palette → **Shell Command: Install 'code' command in PATH**, then retry the install.

package/bin/install.js

@@ -6,39 +6,97 @@ const path = require("node:path");
 const pkgRoot = path.resolve(__dirname, "..");
 const distDir = path.join(pkgRoot, "dist");
 const extensionId = "samchon.ttsc";
-
-const sub = process.argv[2] ?? "install";
+const version = require(path.join(pkgRoot, "package.json")).version;
 
 function findVsix() {
   if (!fs.existsSync(distDir)) return null;
-  const hits = fs.readdirSync(distDir).filter((f) => f.endsWith(".vsix"));
-  return hits.length ? path.join(distDir, hits[0]) : null;
+  const expected = path.join(distDir, `ttsc-vscode-${version}.vsix`);
+  return fs.existsSync(expected) ? expected : null;
+}
+
+function createCodeCommand(
+  args,
+  platform = process.platform,
+  env = process.env,
+) {
+  if (platform === "win32") {
+    return {
+      command: env.ComSpec || "cmd.exe",
+      args: ["/d", "/s", "/c", quoteWindowsCommand(["code", ...args])],
+    };
+  }
+  return { command: "code", args };
+}
+
+function quoteWindowsCommand(args) {
+  return `"${args.map(quoteWindowsArg).join(" ")}"`;
+}
+
+function quoteWindowsArg(arg) {
+  return `"${String(arg).replace(/"/g, '\\"').replace(/%/g, "%%")}"`;
 }
 
 function runCode(args, vsixForFallback) {
-  const r = cp.spawnSync("code", args, { stdio: "inherit" });
+  const command = createCodeCommand(args);
+  const r = cp.spawnSync(command.command, command.args, { stdio: "inherit" });
   if (r.error && r.error.code === "ENOENT") {
-    console.error("`code` CLI not found on PATH.");
-    console.error("Either:");
-    console.error("  - Open VSCode, then run \"Shell Command: Install 'code' command in PATH\" from the command palette.");
-    if (vsixForFallback) {
-      console.error(`  - Or install manually: VSCode > Extensions > \"...\" menu > Install from VSIX > ${vsixForFallback}`);
-    }
+    printCodeNotFound(vsixForFallback);
     process.exit(1);
   }
+  if (process.platform === "win32" && (r.status ?? 1) !== 0) {
+    printCodeFailed(r.status ?? 1, vsixForFallback);
+  }
   process.exit(r.status ?? 1);
 }
 
-if (sub === "install") {
-  const vsix = findVsix();
-  if (!vsix) {
-    console.error(`No .vsix bundled in ${distDir}. Reinstall @ttsc/vscode or report a packaging bug.`);
+function printCodeNotFound(vsixForFallback) {
+  console.error("`code` CLI not found on PATH.");
+  console.error("Either:");
+  console.error(
+    "  - Open VS Code, then run \"Shell Command: Install 'code' command in PATH\" from the command palette.",
+  );
+  if (vsixForFallback) {
+    console.error(
+      `  - Or install manually: VS Code > Extensions > \"...\" menu > Install from VSIX > ${vsixForFallback}`,
+    );
+  }
+}
+
+function printCodeFailed(status, vsixForFallback) {
+  console.error(`VS Code CLI exited with status ${status}.`);
+  if (vsixForFallback) {
+    console.error(
+      `Install manually: VS Code > Extensions > "..." menu > Install from VSIX > ${vsixForFallback}`,
+    );
+  }
+}
+
+function main(argv = process.argv.slice(2)) {
+  const sub = argv[0] ?? "install";
+  if (sub === "install") {
+    const vsix = findVsix();
+    if (!vsix) {
+      console.error(
+        `No .vsix bundled in ${distDir}. Reinstall @ttsc/vscode or report a packaging bug.`,
+      );
+      process.exit(1);
+    }
+    runCode(["--install-extension", vsix, "--force"], vsix);
+  } else if (sub === "uninstall") {
+    runCode(["--uninstall-extension", extensionId]);
+  } else {
+    console.error(`Usage: ttsc-vscode <install|uninstall>`);
     process.exit(1);
   }
-  runCode(["--install-extension", vsix, "--force"], vsix);
-} else if (sub === "uninstall") {
-  runCode(["--uninstall-extension", extensionId]);
-} else {
-  console.error(`Usage: ttsc-vscode <install|uninstall>`);
-  process.exit(1);
 }
+
+if (require.main === module) {
+  main();
+}
+
+module.exports = {
+  createCodeCommand,
+  findVsix,
+  main,
+  quoteWindowsCommand,
+};