@cplieger/deadset-ts 4.0.1 → 5.1.0

package/README.md

@@ -4,7 +4,7 @@
 
 deadset-ts finds dead code in TypeScript projects, down to class members, type members and dead stores inside functions, and writes a report your CI can fail on.
 
-It reads your `tsconfig.json` projects, `allowJs` JavaScript included, with the type information of TypeScript 7.1.0-dev.20261003.1, its one dependency. Your project keeps its own TypeScript version and must also compile under that version. deadset-ts reports and never edits your code. It is pre-release, tested only on Linux, needs Node.js 24 or later and is licensed under GPL-3.0-or-later.
+It reads your `tsconfig.json` projects, `allowJs` JavaScript and Vue, Svelte and Astro scripts included, with the type information of TypeScript 7.1.0-dev.20261003.1, its one dependency. Your project keeps its own TypeScript version. A type error under that version skips the function or statement that holds it. deadset-ts reports and never edits your code. It is pre-release, tested only on Linux, needs Node.js 24 or later and is licensed under GPL-3.0-or-later.
 
 ## Why use it
 
@@ -17,7 +17,7 @@ deadset-ts is built for a CI gate on dead code. Each finding names code to delet
 - The same tree gives the same report, and a baseline keyed on code and symbol survives moved lines.
 - It writes text, JSON, GitHub annotations, SARIF 2.1.0 or a custom template.
 
-Consider [Knip](https://knip.dev) if you want issues fixed with `--fix`, plugins for over 100 tools, or Astro, MDX, Svelte and Vue files checked.
+Consider [Knip](https://knip.dev) if you want issues fixed with `--fix`, plugins for over 100 tools, or MDX files checked.
 
 ## Install
 
@@ -90,7 +90,7 @@ A TypeScript caller that imports the source sets `allowImportingTsExtensions`, b
 
 ## Related projects
 
-deadset-ts implements the [deadset Contract](https://github.com/cplieger/deadset-spec), which fixes the issue codes, the report schema and the exit codes. It passes the Contract's conformance corpus except one reflective-lookup fixture, the gap [`conformance.json`](conformance.json) declares.
+deadset-ts implements the [deadset Contract](https://github.com/cplieger/deadset-spec), which fixes the issue codes, the report schema and the exit codes. It passes every fixture of the Contract's conformance corpus except one reflective-lookup fixture, the gap [`conformance.json`](conformance.json) declares.
 
 - [deadset-go](https://github.com/cplieger/deadset-go) is the same analysis for Go modules.
 - [deadset](https://github.com/cplieger/deadset) runs both analyzers as one command and merges their reports, resolving the edges between Go and TypeScript code.
@@ -105,7 +105,7 @@ deadset-ts implements the [deadset Contract](https://github.com/cplieger/deadset
 
 ## Contributing
 
-See [CONTRIBUTING.md](https://github.com/cplieger/.github/blob/main/CONTRIBUTING.md).
+See [CONTRIBUTING.md](CONTRIBUTING.md).
 
 ## Disclaimer
 

package/dist/bin/component-mapper.js

@@ -0,0 +1,5 @@
+import { mapperConnection } from "./mapper-connection.js";
+const connection = mapperConnection((bytes) => process.stdout.write(bytes));
+process.stdin.on("data", (chunk) => {
+    connection.receive(chunk);
+});

package/dist/bin/mapper-connection.js

@@ -0,0 +1,101 @@
+/**
+ * The content mapper the compiler runs for component files: JSON-RPC 2.0 messages, each
+ * framed by a `Content-Length` header, over the process's standard streams. It answers
+ * `transform` with {@link componentModule} and keeps no state between requests.
+ * The protocol is the compiler's own:
+ * https://github.com/microsoft/TypeScript/blob/f9f8d01292562242b6e7c7142e46ed7e470926f9/tsc/internal/contentmapper/hostimpl.go
+ */
+import { componentModule } from "../src/component-files.js";
+/** The JSON-RPC code of a method this mapper does not serve. */
+const METHOD_NOT_FOUND = -32601;
+/** The JSON-RPC code of a request whose parameters are not the protocol's. */
+const INVALID_PARAMS = -32602;
+const HEADER_END = new Uint8Array([0x0d, 0x0a, 0x0d, 0x0a]);
+/** The offset of `needle` in `bytes` at or after `from`, or -1. */
+function indexOf(bytes, needle, from) {
+    outer: for (let at = from; at + needle.length <= bytes.length; at += 1) {
+        for (let index = 0; index < needle.length; index += 1) {
+            if (bytes[at + index] !== needle[index]) {
+                continue outer;
+            }
+        }
+        return at;
+    }
+    return -1;
+}
+/** The answer to one message, or undefined for a notification, which takes none. */
+function answer(message) {
+    if (message.id === undefined) {
+        return undefined;
+    }
+    const reply = (result) => ({ jsonrpc: "2.0", id: message.id, result });
+    const fail = (code, text) => ({
+        jsonrpc: "2.0",
+        id: message.id,
+        error: { code, message: text },
+    });
+    switch (message.method) {
+        case "initialize":
+            return reply({ positionEncoding: "utf-16", diagnosticSource: "deadset-ts" });
+        case "openProject":
+            return reply({});
+        case "closeProject":
+            return reply(null);
+        case "transform": {
+            const content = typeof message.params === "object" && message.params !== null
+                ? message.params.content
+                : undefined;
+            if (typeof content !== "string") {
+                return fail(INVALID_PARAMS, "transform: params.content is not a string");
+            }
+            const module = componentModule(content);
+            return reply({ text: module.text, extension: module.extension, mappings: module.mappings });
+        }
+        default:
+            return fail(METHOD_NOT_FOUND, `no method ${JSON.stringify(message.method)}`);
+    }
+}
+/**
+ * A connection over one byte stream. A message whose body is not JSON is answered with
+ * nothing, because it carries no id to answer to.
+ */
+export function mapperConnection(write) {
+    const encoder = new TextEncoder();
+    const decoder = new TextDecoder();
+    let pending = new Uint8Array(0);
+    return {
+        receive(chunk) {
+            const joined = new Uint8Array(pending.length + chunk.length);
+            joined.set(pending);
+            joined.set(chunk, pending.length);
+            pending = joined;
+            for (;;) {
+                const headerEnd = indexOf(pending, HEADER_END, 0);
+                if (headerEnd < 0) {
+                    return;
+                }
+                const header = decoder.decode(pending.subarray(0, headerEnd));
+                const length = Number(/content-length:\s*(\d+)/iu.exec(header)?.[1] ?? "0");
+                const bodyStart = headerEnd + HEADER_END.length;
+                if (pending.length < bodyStart + length) {
+                    return;
+                }
+                const body = decoder.decode(pending.subarray(bodyStart, bodyStart + length));
+                pending = pending.slice(bodyStart + length);
+                let message;
+                try {
+                    message = JSON.parse(body);
+                }
+                catch {
+                    continue;
+                }
+                const reply = answer(message);
+                if (reply !== undefined) {
+                    const bytes = encoder.encode(JSON.stringify(reply));
+                    write(encoder.encode(`Content-Length: ${String(bytes.length)}\r\n\r\n`));
+                    write(bytes);
+                }
+            }
+        },
+    };
+}

package/dist/bin/node-host.js

@@ -1,6 +1,7 @@
 import { randomBytes } from "node:crypto";
-import { closeSync, fchmodSync, fsyncSync, openSync, readdirSync, readFileSync, renameSync, rmSync, statSync, writeSync, } from "node:fs";
-import { basename, dirname, join } from "node:path";
+import { closeSync, fchmodSync, fsyncSync, mkdtempSync, openSync, readdirSync, readFileSync, realpathSync, renameSync, rmSync, statSync, writeSync, } from "node:fs";
+import { tmpdir } from "node:os";
+import { basename, dirname, extname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 /** The name the manifest of this package declares. */
 const PACKAGE_NAME = "@cplieger/deadset-ts";
@@ -75,6 +76,24 @@ function writeAtomically(path, pieces) {
         throw error;
     }
 }
+/** A new directory under the platform's temporary directory. */
+function temporaryDirectory() {
+    const path = mkdtempSync(join(tmpdir(), "deadset-ts-mapper-"));
+    return {
+        path,
+        remove: () => {
+            rmSync(path, { recursive: true, force: true });
+        },
+    };
+}
+/**
+ * The mapper beside this file, in the same form: the emitted tree runs the emitted
+ * mapper and a checkout runs the source through the runtime's own type stripping.
+ */
+function componentMapperCommand() {
+    const here = fileURLToPath(import.meta.url);
+    return [process.execPath, join(dirname(here), `component-mapper${extname(here)}`)];
+}
 /**
  * The filesystem of the platform the command runs on, and the version of the
  * package it was installed from.
@@ -98,10 +117,13 @@ export function nodeHost() {
             }
             return stat.isDirectory() ? "directory" : "file";
         },
+        realPath: (path) => realpathSync(path),
         analyzerVersion: () => {
             found ??= readVersion();
             return found;
         },
         writeDocument: writeAtomically,
+        temporaryDirectory,
+        componentMapperCommand,
     };
 }