@esportsplus/typescript 0.29.0 → 0.29.5

package/.claude/skills/code-audit/registry-typescript.json

@@ -0,0 +1,326 @@
+{
+  "project": "@esportsplus/typescript",
+  "version": "0.29.0",
+  "target": "src/ tests/",
+  "runs": [
+    {
+      "date": "2026-04-11",
+      "commit": "e0657fe",
+      "mode": "full",
+      "files_audited": 13,
+      "files_skipped": 0,
+      "findings_new": 2,
+      "findings_recurring": 0,
+      "sqale_rating": "A",
+      "agent_results": {
+        "correctness": { "status": "ok", "symbols": 26, "sub_targets": 1, "findings": 1 },
+        "security": { "status": "ok", "symbols": 14, "sub_targets": 1, "findings": 0 },
+        "performance": { "status": "ok", "symbols": 15, "sub_targets": 1, "findings": 1 },
+        "architecture": { "status": "ok", "symbols": 32, "sub_targets": 1, "findings": 0 },
+        "testing": { "status": "ok", "symbols": 16, "sub_targets": 1, "findings": 1 }
+      },
+      "agent_overlap": {},
+      "estimated_remaining": null
+    },
+    {
+      "date": "2026-04-11",
+      "commit": "e0657fe",
+      "mode": "incremental",
+      "files_audited": 13,
+      "files_skipped": 0,
+      "findings_new": 0,
+      "findings_recurring": 1,
+      "sqale_rating": "A",
+      "agent_results": {
+        "correctness": { "status": "ok", "symbols": 26, "sub_targets": 1, "findings": 0 },
+        "security": { "status": "ok", "symbols": 14, "sub_targets": 1, "findings": 0 },
+        "performance": { "status": "ok", "symbols": 15, "sub_targets": 1, "findings": 0 },
+        "architecture": { "status": "ok", "symbols": 32, "sub_targets": 1, "findings": 0 },
+        "testing": { "status": "ok", "symbols": 16, "sub_targets": 1, "findings": 1 }
+      },
+      "agent_overlap": {},
+      "estimated_remaining": null
+    },
+    {
+      "date": "2026-04-11",
+      "commit": "e0657fe",
+      "mode": "incremental",
+      "files_audited": 13,
+      "files_skipped": 0,
+      "findings_new": 0,
+      "findings_recurring": 0,
+      "sqale_rating": "A",
+      "agent_results": {
+        "correctness": { "status": "ok", "symbols": 26, "sub_targets": 1, "findings": 0 },
+        "security": { "status": "ok", "symbols": 14, "sub_targets": 1, "findings": 0 },
+        "performance": { "status": "ok", "symbols": 15, "sub_targets": 1, "findings": 0 },
+        "architecture": { "status": "ok", "symbols": 32, "sub_targets": 1, "findings": 0 },
+        "testing": { "status": "ok", "symbols": 16, "sub_targets": 1, "findings": 0 }
+      },
+      "agent_overlap": {},
+      "estimated_remaining": null
+    },
+    {
+      "date": "2026-04-11",
+      "commit": "59ea7a3",
+      "mode": "incremental",
+      "files_audited": 19,
+      "files_skipped": 0,
+      "findings_new": 9,
+      "findings_recurring": 1,
+      "sqale_rating": "B",
+      "agent_results": {
+        "correctness": { "status": "ok", "symbols": 26, "sub_targets": 1, "findings": 0 },
+        "security": { "status": "ok", "symbols": 14, "sub_targets": 1, "findings": 0 },
+        "performance": { "status": "ok", "symbols": 15, "sub_targets": 1, "findings": 0 },
+        "architecture": { "status": "ok", "symbols": 32, "sub_targets": 1, "findings": 2 },
+        "testing": { "status": "ok", "symbols": 35, "sub_targets": 1, "findings": 7 }
+      },
+      "agent_overlap": {},
+      "estimated_remaining": null
+    },
+    {
+      "date": "2026-04-11",
+      "commit": "59ea7a3",
+      "mode": "incremental",
+      "files_audited": 21,
+      "files_skipped": 0,
+      "findings_new": 0,
+      "findings_recurring": 0,
+      "sqale_rating": "A",
+      "agent_results": {
+        "correctness": { "status": "ok", "symbols": 24, "sub_targets": 1, "findings": 0 },
+        "security": { "status": "ok", "symbols": 14, "sub_targets": 1, "findings": 0 },
+        "performance": { "status": "ok", "symbols": 13, "sub_targets": 1, "findings": 0 },
+        "architecture": { "status": "ok", "symbols": 30, "sub_targets": 1, "findings": 0 },
+        "testing": { "status": "ok", "symbols": 35, "sub_targets": 1, "findings": 0 }
+      },
+      "agent_overlap": {},
+      "estimated_remaining": null
+    },
+    {
+      "date": "2026-04-11",
+      "commit": "59ea7a3",
+      "mode": "incremental",
+      "files_audited": 21,
+      "files_skipped": 0,
+      "findings_new": 0,
+      "findings_recurring": 0,
+      "sqale_rating": "A",
+      "agent_results": {
+        "correctness": { "status": "ok", "symbols": 24, "sub_targets": 1, "findings": 0 },
+        "security": { "status": "ok", "symbols": 14, "sub_targets": 1, "findings": 0 },
+        "performance": { "status": "ok", "symbols": 13, "sub_targets": 1, "findings": 0 },
+        "architecture": { "status": "ok", "symbols": 30, "sub_targets": 1, "findings": 0 },
+        "testing": { "status": "ok", "symbols": 35, "sub_targets": 1, "findings": 0 }
+      },
+      "agent_overlap": {},
+      "estimated_remaining": null
+    }
+  ],
+  "findings": {
+    "F-001": {
+      "status": "implemented",
+      "file": "src/compiler/coordinator.ts",
+      "symbol": "transform",
+      "category": "correctness",
+      "title": "AST Position Staleness After Code Modification",
+      "content_hash": "ast-position-staleness-coordinator-transform",
+      "file_hash": "",
+      "first_seen": "2026-04-11",
+      "last_seen": "2026-04-11",
+      "found_by": ["correctness"],
+      "priority_score": 66
+    },
+    "F-002": {
+      "status": "deferred",
+      "file": "src/compiler/coordinator.ts",
+      "symbol": "applyImports",
+      "category": "optimize",
+      "title": "Redundant SourceFile Recreation in applyImports Loop",
+      "content_hash": "redundant-sourcefile-recreation-applyimports",
+      "file_hash": "",
+      "first_seen": "2026-04-11",
+      "last_seen": "2026-04-11",
+      "found_by": ["performance"],
+      "priority_score": 44
+    },
+    "F-003": {
+      "status": "implemented",
+      "file": "src/",
+      "symbol": "*",
+      "category": "coverage",
+      "title": "Complete Absence of Test Infrastructure",
+      "content_hash": "missing-test-infrastructure",
+      "file_hash": "",
+      "first_seen": "2026-04-11",
+      "last_seen": "2026-04-11",
+      "found_by": ["testing"],
+      "priority_score": 114
+    },
+    "F-004": {
+      "status": "implemented",
+      "file": "src/compiler/language-service.ts",
+      "symbol": "get",
+      "category": "loc",
+      "title": "languageService.get() is dead code",
+      "content_hash": "dead-code-language-service-get",
+      "file_hash": "",
+      "first_seen": "2026-04-11",
+      "last_seen": "2026-04-11",
+      "found_by": ["architecture"],
+      "priority_score": 45
+    },
+    "F-005": {
+      "status": "implemented",
+      "file": "src/compiler/language-service.ts",
+      "symbol": "delete",
+      "category": "loc",
+      "title": "languageService.delete() is dead code",
+      "content_hash": "dead-code-language-service-delete",
+      "file_hash": "",
+      "first_seen": "2026-04-11",
+      "last_seen": "2026-04-11",
+      "found_by": ["architecture"],
+      "priority_score": 45
+    },
+    "F-006": {
+      "status": "implemented",
+      "file": "src/compiler/language-service.ts",
+      "symbol": "*",
+      "category": "coverage",
+      "title": "language-service.ts has 0 test coverage",
+      "content_hash": "no-test-coverage-language-service",
+      "file_hash": "",
+      "first_seen": "2026-04-11",
+      "last_seen": "2026-04-11",
+      "found_by": ["testing"],
+      "priority_score": 50
+    },
+    "F-007": {
+      "status": "open",
+      "file": "src/cli/tsc.ts",
+      "symbol": "*",
+      "category": "coverage",
+      "title": "cli/tsc.ts has 0 test coverage",
+      "content_hash": "no-test-coverage-cli-tsc",
+      "file_hash": "",
+      "first_seen": "2026-04-11",
+      "last_seen": "2026-04-11",
+      "found_by": ["testing"],
+      "priority_score": 35
+    },
+    "F-008": {
+      "status": "implemented",
+      "file": "src/compiler/coordinator.ts",
+      "symbol": "transform",
+      "category": "test-quality",
+      "title": "coordinator plugin.transform() throw path untested",
+      "content_hash": "test-quality-coordinator-throw-path",
+      "file_hash": "",
+      "first_seen": "2026-04-11",
+      "last_seen": "2026-04-11",
+      "found_by": ["testing"],
+      "priority_score": 48
+    },
+    "F-009": {
+      "status": "implemented",
+      "file": "src/compiler/coordinator.ts",
+      "symbol": "transform",
+      "category": "test-quality",
+      "title": "coordinator null sourceFile fallback path untested",
+      "content_hash": "test-quality-coordinator-null-sourcefile",
+      "file_hash": "",
+      "first_seen": "2026-04-11",
+      "last_seen": "2026-04-11",
+      "found_by": ["testing"],
+      "priority_score": 48
+    },
+    "F-010": {
+      "status": "implemented",
+      "file": "src/compiler/plugins/vite.ts",
+      "symbol": "transform",
+      "category": "test-quality",
+      "title": "vite plugin error catch path untested",
+      "content_hash": "test-quality-vite-error-catch",
+      "file_hash": "",
+      "first_seen": "2026-04-11",
+      "last_seen": "2026-04-11",
+      "found_by": ["testing"],
+      "priority_score": 48
+    },
+    "F-011": {
+      "status": "implemented",
+      "file": "src/compiler/plugins/vite.ts",
+      "symbol": "transform",
+      "category": "test-quality",
+      "title": "vite plugin sourceFile undefined fallback untested",
+      "content_hash": "test-quality-vite-sourcefile-fallback",
+      "file_hash": "",
+      "first_seen": "2026-04-11",
+      "last_seen": "2026-04-11",
+      "found_by": ["testing"],
+      "priority_score": 45
+    },
+    "F-012": {
+      "status": "implemented",
+      "file": "src/compiler/imports.ts",
+      "symbol": "includes",
+      "category": "test-quality",
+      "title": "imports.includes() getAliasedSymbol catch block untested",
+      "content_hash": "test-quality-imports-aliased-catch",
+      "file_hash": "",
+      "first_seen": "2026-04-11",
+      "last_seen": "2026-04-11",
+      "found_by": ["testing"],
+      "priority_score": 42
+    }
+  },
+  "clean_symbols": {},
+  "convergence": {
+    "per_category": {
+      "correctness": {
+        "findings_per_run": [1, 0, 0, 0, 0, 0],
+        "successful_runs": 6,
+        "consecutive_zero": 5,
+        "last_agent_success": true,
+        "status": "CONVERGED",
+        "reason": "0 new findings on 5 consecutive successful runs"
+      },
+      "security": {
+        "findings_per_run": [0, 0, 0, 0, 0, 0],
+        "successful_runs": 6,
+        "consecutive_zero": 6,
+        "last_agent_success": true,
+        "status": "CONVERGED",
+        "reason": "0 new findings on 6 consecutive successful runs"
+      },
+      "performance": {
+        "findings_per_run": [1, 0, 0, 0, 0, 0],
+        "successful_runs": 6,
+        "consecutive_zero": 5,
+        "last_agent_success": true,
+        "status": "CONVERGED",
+        "reason": "0 new findings on 5 consecutive successful runs"
+      },
+      "architecture": {
+        "findings_per_run": [0, 0, 0, 2, 0, 0],
+        "successful_runs": 6,
+        "consecutive_zero": 2,
+        "last_agent_success": true,
+        "status": "CONVERGED",
+        "reason": "0 new findings on 2 consecutive runs after fixes"
+      },
+      "testing": {
+        "findings_per_run": [1, 1, 0, 7, 0, 0],
+        "successful_runs": 6,
+        "consecutive_zero": 2,
+        "last_agent_success": true,
+        "status": "CONVERGED",
+        "reason": "0 new findings on 2 consecutive runs after fixes"
+      }
+    },
+    "overall": "CONVERGED",
+    "reason": "all 5 categories converged with 0 findings on 2+ consecutive runs"
+  }
+}

package/.github/workflows/bump.yml

@@ -17,7 +17,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: checkout repo
-        uses: actions/checkout@v4
+        uses: actions/checkout@v7
         with:
           fetch-depth: 0
       - name: bump version

package/.github/workflows/dependabot.yml

@@ -20,13 +20,13 @@ jobs:
   build:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
-      - uses: pnpm/action-setup@v4
+      - uses: actions/checkout@v7
+      - uses: pnpm/action-setup@v6
         name: Install pnpm
         with:
           run_install: false
           version: latest
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v6
         with:
           cache: 'pnpm'
           node-version: 'latest'
@@ -43,7 +43,7 @@ jobs:
     runs-on: ubuntu-latest
     if: ${{ github.actor == 'dependabot[bot]' && github.event_name == 'pull_request' }}
     steps:
-      - uses: dependabot/fetch-metadata@v2
+      - uses: dependabot/fetch-metadata@v3
         id: metadata
         with:
           alert-lookup: true

package/.github/workflows/publish.yml

@@ -24,20 +24,19 @@ jobs:
       contents: read
       id-token: write
     steps:
-      - uses: actions/checkout@v4
-      - uses: pnpm/action-setup@v4
+      - uses: actions/checkout@v7
+      - uses: pnpm/action-setup@v6
         name: Install pnpm
         with:
           run_install: false
           version: latest
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v6
         with:
           cache: 'pnpm'
           node-version: 'latest'
           registry-url: 'https://registry.npmjs.org'
-      - run: pnpm config delete always-auth
       - run: pnpm i
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
       - run: pnpm build
-      - run: pnpm publish --provenance --no-git-checks
+      - run: pnpm publish --no-git-checks

package/README.md

@@ -0,0 +1,146 @@
+# @esportsplus/typescript
+
+TypeScript compiler plugin framework with coordinated AST transformations, import management, and build tool integration.
+
+## Install
+
+```bash
+pnpm add @esportsplus/typescript
+```
+
+## Overview
+
+Extends the TypeScript compiler with a plugin architecture for custom AST transformations. Plugins receive type-checked AST nodes with accurate positions at every stage, return declarative intents (replacements, imports, prepends), and the coordinator applies them in the correct order.
+
+**Key features:**
+- Multi-plugin coordination with fresh AST positions between stages
+- Declarative import management (add/remove specifiers, namespace imports)
+- Vite plugin for dev/build integration
+- CLI wrapper for `tsc` with automatic plugin detection
+- Language service caching for incremental compilation
+
+## Usage
+
+### Plugin
+
+```typescript
+import type { Plugin } from '@esportsplus/typescript/compiler';
+
+let plugin: Plugin = {
+    // Optional: skip files that don't contain these strings
+    patterns: ['myFunction'],
+
+    transform({ checker, code, sourceFile, shared }) {
+        // Return declarative transformation intents
+        return {
+            imports: [
+                { package: 'my-lib', add: ['helper'], remove: ['deprecated'] }
+            ],
+            prepend: [
+                'let __cache = new Map();'
+            ],
+            replacements: [
+                {
+                    node: someAstNode,
+                    generate: (sf) => `transformedCode()`
+                }
+            ]
+        };
+    }
+};
+```
+
+### Vite
+
+```typescript
+import { plugin } from '@esportsplus/typescript/compiler';
+
+export default defineConfig({
+    plugins: [
+        plugin.vite({
+            name: 'my-transforms',
+            plugins: [myPlugin]
+        })
+    ]
+});
+```
+
+### CLI
+
+```bash
+# Compiles with plugins from tsconfig.json, then resolves path aliases
+tsc
+```
+
+The CLI detects plugins in `tsconfig.json` `compilerOptions.plugins`, loads them, runs coordinated compilation, and automatically calls `tsc-alias` afterward.
+
+## API
+
+### `@esportsplus/typescript`
+
+Re-exports the TypeScript compiler API (`ts`).
+
+### `@esportsplus/typescript/compiler`
+
+| Export | Description |
+|---|---|
+| `ast` | AST utilities — expression names, property paths, node testing |
+| `code` | Template literal code generation with escaping |
+| `coordinator` | Multi-plugin transformation orchestrator |
+| `imports` | Import detection and modification (WeakMap cached) |
+| `plugin` | Built-in plugins (`tsc`, `vite`) |
+| `uid` | Unique identifier generation |
+| `languageService` | Cached TypeScript language service |
+
+### Types
+
+```typescript
+type Plugin = {
+    patterns?: string[];
+    transform: (ctx: TransformContext) => TransformResult;
+};
+
+type TransformContext = {
+    checker: ts.TypeChecker;
+    code: string;
+    program: ts.Program;
+    shared: SharedContext;
+    sourceFile: ts.SourceFile;
+};
+
+type TransformResult = {
+    imports?: ImportIntent[];
+    prepend?: string[];
+    replacements?: ReplacementIntent[];
+};
+
+type ImportIntent = {
+    add?: string[];
+    namespace?: string;
+    package: string;
+    remove?: string[];
+};
+
+type ReplacementIntent = {
+    generate: (sourceFile: ts.SourceFile) => string;
+    node: ts.Node;
+};
+```
+
+## Shared Config
+
+Importable base tsconfig files:
+
+```json
+{ "extends": "@esportsplus/typescript/tsconfig.browser.json" }
+{ "extends": "@esportsplus/typescript/tsconfig.node.json" }
+{ "extends": "@esportsplus/typescript/tsconfig.package.json" }
+```
+
+## Scripts
+
+```bash
+pnpm build       # tsc && tsc-alias
+pnpm test        # vitest run
+pnpm bench:run   # vitest bench --run
+```

package/build/cli/tsc.d.ts

@@ -1 +1,10 @@
-export {};
+import type { Plugin } from '../compiler/types.js';
+type PluginConfig = {
+    transform: string;
+};
+declare function build(config: object, tsconfig: string, pluginConfigs: PluginConfig[]): Promise<void>;
+declare function isPlugin(value: unknown): value is Plugin;
+declare function loadPlugins(configs: PluginConfig[], root: string): Promise<Plugin[]>;
+declare function normalizePath(fileName: string): string;
+declare function runTscAlias(args: string[]): Promise<number>;
+export { build, isPlugin, loadPlugins, normalizePath, runTscAlias };

package/build/cli/tsc.js

@@ -1,10 +1,10 @@
-import { spawn } from 'child_process';
 import { createRequire } from 'module';
+import { PACKAGE_NAME } from '../constants.js';
 import { pathToFileURL } from 'url';
+import { spawn } from 'child_process';
+import coordinator from '../compiler/coordinator.js';
 import path from 'path';
 import ts from 'typescript';
-import coordinator from '../compiler/coordinator.js';
-import { PACKAGE_NAME } from '../constants.js';
 const BACKSLASH_REGEX = /\\/g;
 let require = createRequire(import.meta.url), skipFlags = new Set(['--help', '--init', '--noEmit', '--showConfig', '--version', '-h', '-noEmit', '-v']);
 async function build(config, tsconfig, pluginConfigs) {
@@ -137,4 +137,7 @@ function runTscAlias(args) {
         child.on('exit', (code) => resolve(code ?? 0));
     });
 }
-main();
+if (process.env.VITEST === undefined) {
+    main();
+}
+export { build, isPlugin, loadPlugins, normalizePath, runTscAlias };

package/build/compiler/ast.d.ts

@@ -1,8 +1,5 @@
-import ts from 'typescript';
-type Range = {
-    end: number;
-    start: number;
-};
+import type { Range } from './types.js';
+import { ts } from '../index.js';
 declare const _default: {
     expression: {
         name: (node: ts.Expression) => string | null;

package/build/compiler/ast.js

@@ -1,4 +1,4 @@
-import ts from 'typescript';
+import { ts } from '../index.js';
 const expression = {
     name: (node) => {
         if (ts.isIdentifier(node)) {

package/build/compiler/coordinator.js

@@ -2,13 +2,31 @@ import { ts } from '../index.js';
 import imports from './imports.js';
 import languageService from './language-service.js';
 function applyImports(code, file, intents) {
+    let merged = new Map();
     for (let i = 0, n = intents.length; i < n; i++) {
-        let intent = intents[i];
-        code = modify(code, file, intent.package, {
-            add: intent.add,
-            namespace: intent.namespace,
-            remove: intent.remove
-        });
+        let intent = intents[i], existing = merged.get(intent.package);
+        if (existing) {
+            if (intent.add) {
+                (existing.add ??= []).push(...intent.add);
+            }
+            if (intent.namespace) {
+                existing.namespace = intent.namespace;
+            }
+            if (intent.remove) {
+                (existing.remove ??= []).push(...intent.remove);
+            }
+        }
+        else {
+            merged.set(intent.package, {
+                add: intent.add ? [...intent.add] : undefined,
+                namespace: intent.namespace,
+                remove: intent.remove ? [...intent.remove] : undefined
+            });
+        }
+    }
+    let keys = [...merged.keys()];
+    for (let i = 0, n = keys.length; i < n; i++) {
+        code = modify(code, file, keys[i], merged.get(keys[i]));
         if (i < n - 1) {
             file = ts.createSourceFile(file.fileName, code, file.languageVersion, true);
         }
@@ -40,9 +58,9 @@ function applyPrepend(code, file, prepend) {
         }
     }
     if (position === 0) {
-        return prepend.join('\n') + code;
+        return prepend.join('\n') + '\n' + code;
     }
-    return code.slice(0, position) + prepend.join('\n') + code.slice(position);
+    return code.slice(0, position) + '\n' + prepend.join('\n') + '\n' + code.slice(position);
 }
 function hasPattern(code, patterns) {
     for (let i = 0, n = patterns.length; i < n; i++) {
@@ -105,12 +123,19 @@ function replaceReverse(code, replacements) {
         return code;
     }
     replacements.sort((a, b) => b.start - a.start);
-    let result = code;
+    let parts = [], pos = code.length;
     for (let i = 0, n = replacements.length; i < n; i++) {
         let r = replacements[i];
-        result = result.substring(0, r.start) + r.newText + result.substring(r.end);
+        if (r.end < pos) {
+            parts.push(code.substring(r.end, pos));
+        }
+        parts.push(r.newText);
+        pos = r.start;
     }
-    return result;
+    if (pos > 0) {
+        parts.push(code.substring(0, pos));
+    }
+    return parts.reverse().join('');
 }
 const transform = (plugins, code, file, program, root, shared) => {
     if (plugins.length === 0) {
@@ -134,10 +159,16 @@ const transform = (plugins, code, file, program, root, shared) => {
             pluginChanged = true;
         }
         if (prepend?.length) {
+            if (pluginChanged) {
+                currentFile = ts.createSourceFile(fileName, currentCode, file.languageVersion, true);
+            }
             currentCode = applyPrepend(currentCode, currentFile, prepend);
             pluginChanged = true;
         }
         if (imports?.length) {
+            if (pluginChanged) {
+                currentFile = ts.createSourceFile(fileName, currentCode, file.languageVersion, true);
+            }
             currentCode = applyImports(currentCode, currentFile, imports);
             pluginChanged = true;
         }