@ttsc/vscode 0.19.3 → 0.20.0

package/README.md

@@ -4,9 +4,9 @@
 
 [![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)
 
-Bring [`ttsc`](https://ttsc.dev) plugin diagnostics into VS Code.
+Bring TypeScript-Go and supported [`ttsc`](https://ttsc.dev) plugin features into one VS Code session.
 
-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.
+The extension keeps TypeScript-Go completion and diagnostics in one `ttscserver` stream with `@ttsc/lint` diagnostics, suggestions, fix-all actions, formatting, and completion published by lint project rules.
 
 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.
 
@@ -102,7 +102,8 @@ Lint fixes stay off-save by default because they can change code meaning. Run `t
 ## What it adds
 
 - TypeScript-Go diagnostics, hover, navigation, and completions.
-- `@ttsc/lint` diagnostics and code actions, including `source.fixAll.ttsc`.
+- `@ttsc/lint` diagnostics, suggestions, code actions, and `source.fixAll.ttsc`.
+- JSDoc completion from a built-in lint rule and project-indexed completion from contributor rules that publish it.
 - 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.*`.
@@ -110,6 +111,8 @@ Lint fixes stay off-save by default because they can change code meaning. Run `t
 
 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.
 
+Completion uses the live editor buffer. Enable `jsdoc/check-tag-names` to try built-in lint completion inside a `/** ... */` block. The [Lint in VS Code guide](https://ttsc.dev/docs/lint/editor) covers that workflow and contributor project indexes.
+
 ## Troubleshooting
 
 No diagnostics? Work through these in order:
@@ -120,6 +123,8 @@ No diagnostics? Work through these in order:
 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.
 
+If diagnostics work but lint completion does not, press Ctrl+Space after `@` inside a JSDoc block. After changing the lint config or project-indexed inputs, save the file: the completion corpus is rediscovered in the background on save. `ttsc: Restart language server` is still needed for a completion trigger character the session never advertised, which the **ttsc** output channel names when it appears.
+
 ## Sponsors
 
 [![Sponsors](https://raw.githubusercontent.com/samchon/sponsor-images/refs/heads/master/public/circle.png)](https://github.com/sponsors/samchon)

package/bin/install.js

@@ -22,15 +22,19 @@ function createCodeCommand(
 ) {
   if (platform === "win32") {
     const launcher = findWindowsCodeCommand(env, deps);
+    const commandShim = createWindowsCommandShim([launcher, ...args]);
     return {
       command: env.ComSpec || "cmd.exe",
-      args: ["/d", "/s", "/c", quoteWindowsCommand([launcher, ...args])],
+      args: ["/d", "/s", "/c", commandShim.payload],
       // The `/c` payload is already fully quoted. Node's Windows spawn escapes
       // each arg again unless told not to, turning `""code.cmd" ...` into
       // `"\"\"code.cmd\" ...\""`, which cmd.exe sees as one un-runnable token
       // after the CVE-2024-27980 argument-escaping change. Pass the payload
       // verbatim so cmd's `/s` strips the outer quotes and runs `code.cmd ...`.
-      options: { windowsVerbatimArguments: true },
+      options: {
+        env: { ...env, ...commandShim.environment },
+        windowsVerbatimArguments: true,
+      },
     };
   }
   return { command: "code", args, options: {} };
@@ -78,12 +82,24 @@ function findWindowsCodeCommand(env = process.env, deps = {}) {
   return candidates.find((candidate) => existsSync(candidate)) ?? "code.cmd";
 }
 
-function quoteWindowsCommand(args) {
-  return `"${args.map(quoteWindowsArg).join(" ")}"`;
+function createWindowsCommandShim(args) {
+  const prefix = "TTSC_VSCODE_COMMAND_SHIM_ARG_";
+  const environment = Object.fromEntries(
+    args.map((arg, index) => [prefix + index, quoteWindowsArg(arg)]),
+  );
+  return {
+    environment,
+    // cmd expands every placeholder exactly once. The environment values are
+    // already Windows-command-line arguments, so their literal `%` segments do
+    // not expand again and their quotes continue to protect shell metacharacters.
+    payload: `"${args.map((_, index) => `%${prefix}${index}%`).join(" ")}"`,
+  };
 }
 
 function quoteWindowsArg(arg) {
-  return `"${String(arg).replace(/"/g, '\\"').replace(/%/g, "%%")}"`;
+  return `"${String(arg)
+    .replace(/(\\*)"/g, "$1$1\\\"")
+    .replace(/(\\*)$/, "$1$1")}"`;
 }
 
 function spawnCode(args, vsixForFallback) {
@@ -160,5 +176,4 @@ module.exports = {
   findWindowsCodeCommand,
   findVsix,
   main,
-  quoteWindowsCommand,
 };

package/lib/extension.js

@@ -18271,9 +18271,11 @@ function createServerLaunchCommand(launcher, candidate, platform = process.platf
     return { command: process.execPath, args: [launcher, ...args] };
   }
   if (platform === "win32" && isWindowsCommandLauncher(launcher)) {
+    const commandShim = createWindowsCommandShim([launcher, ...args]);
     return {
       command: env.ComSpec || "cmd.exe",
-      args: ["/d", "/s", "/c", quoteWindowsCommand([launcher, ...args])],
+      args: ["/d", "/s", "/c", commandShim.payload],
+      commandShimEnvironment: commandShim.environment,
       windowsVerbatimArguments: true
     };
   }
@@ -18285,12 +18287,13 @@ function createServerExecutable(launcher, candidate, platform = process.platform
   return {
     command: launch.command,
     args: launch.args,
-    options: options && launch.windowsVerbatimArguments ? { ...options, windowsVerbatimArguments: true } : options
+    options: options && launch.windowsVerbatimArguments ? {
+      ...options,
+      env: { ...options.env, ...launch.commandShimEnvironment },
+      windowsVerbatimArguments: true
+    } : options
   };
 }
-function quoteWindowsCommand(args) {
-  return `"${args.map(quoteWindowsArg).join(" ")}"`;
-}
 function createDocumentSelectorPattern(ctor, root) {
   return new ctor(root, "**/*");
 }
@@ -18413,8 +18416,21 @@ function isJavaScriptLauncher(launcher) {
 function isWindowsCommandLauncher(launcher) {
   return [".cmd", ".bat"].includes(import_node_path.default.extname(launcher).toLowerCase());
 }
+function createWindowsCommandShim(args) {
+  const prefix = "TTSC_VSCODE_COMMAND_SHIM_ARG_";
+  const environment = Object.fromEntries(
+    args.map((arg, index) => [prefix + index, quoteWindowsArg(arg)])
+  );
+  return {
+    environment,
+    // cmd expands every placeholder exactly once. The environment values are
+    // already Windows-command-line arguments, so their literal `%` segments do
+    // not expand again and their quotes continue to protect shell metacharacters.
+    payload: `"${args.map((_, index) => `%${prefix}${index}%`).join(" ")}"`
+  };
+}
 function quoteWindowsArg(arg) {
-  return `"${String(arg).replace(/"/g, '\\"').replace(/%/g, "%%")}"`;
+  return `"${String(arg).replace(/(\\*)"/g, '$1$1\\"').replace(/(\\*)$/, "$1$1")}"`;
 }
 function resolveTsgoBinary(base) {
   try {

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@ttsc/vscode",
   "displayName": "ttsc",
-  "description": "Show ttsc plugin diagnostics in VS Code, with @ttsc/lint errors, fix-all actions, and formatter support.",
-  "version": "0.19.3",
+  "description": "TypeScript-Go and ttsc plugin diagnostics, completions, lint actions, and formatting for VS Code.",
+  "version": "0.20.0",
   "publisher": "samchon",
   "icon": "images/icon.png",
   "license": "MIT",
@@ -105,7 +105,7 @@
     "rimraf": "^6.1.2",
     "typescript": "^7.0.2",
     "vscode-languageclient": "^9.0.1",
-    "ttsc": "0.19.3"
+    "ttsc": "0.20.0"
   },
   "scripts": {
     "build": "rimraf lib dist && node build/build.cjs"