@ttsc/vscode 0.14.0-dev.20260529.2 → 0.14.1

package/README.md

@@ -1,59 +1,124 @@
-# `@ttsc/vscode`
+# ttsc for VS Code
 
 ![banner of @ttsc/vscode](https://ttsc.dev/og.jpg)
 
 [![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/samchon/ttsc/blob/master/LICENSE) [![NPM Version](https://img.shields.io/npm/v/@ttsc/vscode.svg)](https://www.npmjs.com/package/@ttsc/vscode) [![NPM Downloads](https://img.shields.io/npm/dm/@ttsc/vscode.svg)](https://www.npmjs.com/package/@ttsc/vscode) [![Build Status](https://github.com/samchon/ttsc/workflows/test/badge.svg)](https://github.com/samchon/ttsc/actions?query=workflow%3Atest) [![Guide Documents](https://img.shields.io/badge/Guide-Documents-forestgreen)](https://ttsc.dev/docs) [![Discord Badge](https://img.shields.io/badge/discord-samchon-d91965?style=flat&labelColor=5866f2&logo=discord&logoColor=white&link=https://discord.gg/E94XhzrUCZ)](https://discord.gg/E94XhzrUCZ)
 
-VS Code extension for [`ttsc`](https://ttsc.dev) projects. It shows TypeScript-Go diagnostics and `@ttsc/lint` lint and format inside your editor.
+Bring [`ttsc`](https://ttsc.dev) plugin diagnostics into VS Code.
 
-## Setup
+When `@ttsc/lint` or another LSP-capable `ttsc` plugin like `typia` reports a compile-time diagnostic, this extension shows it in the editor next to normal TypeScript errors.
 
-### Requirements
+Use it when the project already runs `ttsc`. Add `@ttsc/lint` when you also want lint diagnostics, fix-all actions, and formatting in the editor.
 
-- **VS Code** 1.94 or later
-- **Node.js** 18 or later
-- **`ttsc`, `@ttsc/lint`, and `@typescript/native-preview` in your project.** `@typescript/native-preview` is the TypeScript-Go engine `ttsc` runs on; it is a separate package that `ttsc` does not bundle.
+![VS Code showing ttsc lint diagnostics](images/screenshot.png)
+
+## Requirements
+
+- **VS Code** 1.94 or later.
+- **Node.js** 18 or later.
+- A workspace with `tsconfig.json` or `jsconfig.json`.
+- Project-installed `ttsc`, `@typescript/native-preview`, and the `ttsc` plugins you want editor diagnostics from.
+
+Install the common project dependencies:
 
 ```bash
-npm install -D ttsc @ttsc/lint @typescript/native-preview
+npm install -D ttsc @typescript/native-preview @ttsc/lint
 ```
 
-### Install
+`@ttsc/lint` is optional for TypeScript-Go language features, but required for the lint and format commands shown below.
 
-Not on the VS Code Marketplace yet. Install from npm:
+## Install
+
+Install from the VS Code Marketplace by searching `ttsc` and choosing the extension by `samchon`.
+
+From a shell, the short installer is:
 
 ```bash
-npm install -D @ttsc/vscode
 npx @ttsc/vscode
 ```
 
-If the `code` CLI isn't on your `PATH`, run **Shell Command: Install 'code' command in PATH** from VS Code's command palette, then re-run `npx @ttsc/vscode`.
+The direct VS Code CLI form is:
+
+```bash
+code --install-extension samchon.ttsc
+```
+
+To uninstall the npm-installed copy:
+
+```bash
+npx @ttsc/vscode uninstall
+```
+
+Both shell commands use the `code` CLI. If it isn't on your `PATH`, run **Shell Command: Install 'code' command in PATH** from VS Code's command palette.
+
+## Configuration
+
+### `lint.config.ts`
+
+At the project root, this drives both the lint rules and the formatter. Without it the extension still type-checks, but `@ttsc/lint` diagnostics and formatting do nothing:
+
+```ts
+// lint.config.ts
+import type { ITtscLintConfig } from "@ttsc/lint";
+
+export default {
+  rules: {
+    "no-var": "error",
+    "prefer-const": "error",
+    "typescript/no-explicit-any": "warning",
+    "typescript/no-floating-promises": "error",
+  },
+  format: {
+    printWidth: 100,
+    singleQuote: true,
+    trailingComma: "all",
+  },
+} satisfies ITtscLintConfig;
+```
 
-### Format on save
+### `.vscode/settings.json`
 
-Set `samchon.ttsc` as the default formatter and turn on `editor.formatOnSave` in `.vscode/settings.json`:
+Set `samchon.ttsc` as the default formatter and turn on `editor.formatOnSave`:
 
 ```jsonc
-"[typescript][typescriptreact]": {
-  "editor.defaultFormatter": "samchon.ttsc",
-  "editor.formatOnSave": true
+{
+  "[typescript][typescriptreact]": {
+    "editor.defaultFormatter": "samchon.ttsc",
+    "editor.formatOnSave": true
+  }
 }
 ```
 
-Lint **fixes** stay off-save by default because they can change code meaning. Run `ttsc: Fix all lint issues` from the command palette, or opt in with `"editor.codeActionsOnSave": { "source.fixAll.ttsc": "explicit" }`.
+Lint fixes stay off-save by default because they can change code meaning. Run `ttsc: Fix all lint issues` from the command palette, or opt in on manual saves:
 
-The format rules come from your project's `lint.config`, so format-on-save does nothing until that config has a `format` block.
+```jsonc
+{
+  "editor.codeActionsOnSave": {
+    "source.fixAll.ttsc": "explicit"
+  }
+}
+```
 
 ## What it adds
 
 - TypeScript-Go diagnostics, hover, navigation, and completions.
-- `@ttsc/lint` lint diagnostics, plus `ttsc: Fix all lint issues` and `ttsc: Format document` in the command palette.
-- Format on save with `@ttsc/lint`'s rules, shown above.
-- Monorepo-aware: each package uses its own `tsconfig` and `lint.config`.
+- `@ttsc/lint` diagnostics and code actions, including `source.fixAll.ttsc`.
+- Diagnostics reported by other LSP-capable `ttsc` plugins.
+- `ttsc: Fix all lint issues`, `ttsc: Format document`, and `ttsc: Restart language server` in the command palette.
+- Format on save with the `format` block from `lint.config.*`.
+- Multi-root workspace support. Each package can use its own `ttsc`, `@typescript/native-preview`, `tsconfig.json`, and `lint.config.*`.
+
+Save the file before relying on lint diagnostics or running the command-palette lint and format commands. Format-on-save works on the live editor buffer.
 
 ## Troubleshooting
 
-No diagnostics? Confirm `ttsc` runs in the project (`npx ttsc --version`), then check **View → Output → ttsc** for the server log. For LSP tracing, set `ttsc.trace.server` to `"verbose"`.
+No diagnostics? Work through these in order:
+
+1. Confirm the workspace has a `tsconfig.json` or `jsconfig.json`.
+2. Confirm `ttsc` resolves in the project: `npx ttsc --version`.
+3. Confirm the project itself checks: `npx ttsc --noEmit`.
+4. Open **View → Output → ttsc** and read the server log.
+5. For full LSP tracing, set `ttsc.trace.server` to `"verbose"` and reload the window.
 
 ## Sponsors
 

package/bin/install.js

@@ -23,9 +23,16 @@ function createCodeCommand(
     return {
       command: env.ComSpec || "cmd.exe",
       args: ["/d", "/s", "/c", quoteWindowsCommand(["code", ...args])],
+      // The `/c` payload is ALREADY fully quoted. Node's Windows spawn escapes
+      // each arg again unless told not to, turning `""code" …"` into
+      // `"\"\"code\" …\""`, which cmd.exe sees as one un-runnable token (the
+      // CVE-2024-27980 argument-escaping change, Node 18.20.2+/20.12.2+). Pass
+      // the payload verbatim so cmd's `/s` strips the outer quotes and runs
+      // `code …`.
+      options: { windowsVerbatimArguments: true },
     };
   }
-  return { command: "code", args };
+  return { command: "code", args, options: {} };
 }
 
 function quoteWindowsCommand(args) {
@@ -36,17 +43,25 @@ function quoteWindowsArg(arg) {
   return `"${String(arg).replace(/"/g, '\\"').replace(/%/g, "%%")}"`;
 }
 
-function runCode(args, vsixForFallback) {
+function spawnCode(args, vsixForFallback) {
   const command = createCodeCommand(args);
-  const r = cp.spawnSync(command.command, command.args, { stdio: "inherit" });
+  const r = cp.spawnSync(command.command, command.args, {
+    stdio: "inherit",
+    ...command.options,
+  });
   if (r.error && r.error.code === "ENOENT") {
     printCodeNotFound(vsixForFallback);
     process.exit(1);
   }
-  if (process.platform === "win32" && (r.status ?? 1) !== 0) {
-    printCodeFailed(r.status ?? 1, vsixForFallback);
+  return r.status ?? 1;
+}
+
+function runCode(args, vsixForFallback) {
+  const status = spawnCode(args, vsixForFallback);
+  if (process.platform === "win32" && status !== 0) {
+    printCodeFailed(status, vsixForFallback);
   }
-  process.exit(r.status ?? 1);
+  process.exit(status);
 }
 
 function printCodeNotFound(vsixForFallback) {
@@ -81,6 +96,9 @@ function main(argv = process.argv.slice(2)) {
       );
       process.exit(1);
     }
+    // Remove any previously installed version first so versions do not pile up
+    // in VS Code. Ignore its exit status: the extension may not be installed.
+    spawnCode(["--uninstall-extension", extensionId], vsix);
     runCode(["--install-extension", vsix, "--force"], vsix);
   } else if (sub === "uninstall") {
     runCode(["--uninstall-extension", extensionId]);

package/package.json

@@ -1,25 +1,43 @@
 {
   "name": "@ttsc/vscode",
   "displayName": "ttsc",
-  "description": "Run the project-selected ttscserver in VS Code with TypeScript-Go and ttsc plugin LSP features.",
-  "version": "0.14.0-dev.20260529.2",
+  "description": "Show ttsc plugin diagnostics in VS Code, with @ttsc/lint errors, fix-all actions, and formatter support.",
+  "version": "0.14.1",
   "publisher": "samchon",
+  "icon": "images/icon.png",
   "license": "MIT",
   "author": "Jeongho Nam",
   "publishConfig": {
     "access": "public"
   },
+  "homepage": "https://ttsc.dev",
   "repository": {
     "type": "git",
     "url": "https://github.com/samchon/ttsc",
     "directory": "packages/vscode"
   },
+  "bugs": {
+    "url": "https://github.com/samchon/ttsc/issues"
+  },
   "engines": {
     "vscode": "^1.94.0",
     "node": ">=18"
   },
   "categories": [
-    "Programming Languages"
+    "Programming Languages",
+    "Linters",
+    "Formatters"
+  ],
+  "keywords": [
+    "typescript",
+    "typescript-go",
+    "tsgo",
+    "lint",
+    "linter",
+    "formatter",
+    "prettier",
+    "lsp",
+    "ttsc"
   ],
   "extensionKind": [
     "workspace"
@@ -31,6 +49,7 @@
   "files": [
     "bin",
     "dist",
+    "images",
     "lib",
     "LICENSE",
     "README.md"
@@ -81,12 +100,12 @@
   "devDependencies": {
     "@types/node": "^25.3.0",
     "@types/vscode": "^1.94.0",
-    "@typescript/native-preview": "7.0.0-dev.20260527.2",
+    "@typescript/native-preview": "7.0.0-dev.20260519.1",
     "@vscode/vsce": "^3.6.1",
     "esbuild": "^0.25.12",
     "rimraf": "^6.1.2",
     "vscode-languageclient": "^9.0.1",
-    "ttsc": "0.14.0-dev.20260529.2"
+    "ttsc": "0.14.1"
   },
   "scripts": {
     "build": "rimraf lib dist && node build/build.cjs"