@opensip-cli/lang-typescript 0.1.0

package/dist/query.js

@@ -0,0 +1,74 @@
+import ts from 'typescript';
+function locationOf(sourceFile, node) {
+    const { line, character } = sourceFile.getLineAndCharacterOfPosition(node.getStart(sourceFile));
+    return { file: sourceFile.fileName, line: line + 1, column: character };
+}
+function walk(node, visit) {
+    visit(node);
+    ts.forEachChild(node, (child) => walk(child, visit));
+}
+export const typescriptQuery = {
+    findFunctions(tree) {
+        const out = [];
+        walk(tree, (n) => {
+            if (ts.isFunctionDeclaration(n) ||
+                ts.isFunctionExpression(n) ||
+                ts.isArrowFunction(n) ||
+                ts.isMethodDeclaration(n)) {
+                const name = n.name?.text ?? null;
+                out.push({ name, location: locationOf(tree, n), node: n });
+            }
+        });
+        return out;
+    },
+    findImports(tree) {
+        const out = [];
+        walk(tree, (n) => {
+            if (ts.isImportDeclaration(n) && ts.isStringLiteral(n.moduleSpecifier)) {
+                const specifier = n.moduleSpecifier.text;
+                const names = [];
+                const clause = n.importClause;
+                if (clause?.name)
+                    names.push(clause.name.text);
+                if (clause?.namedBindings && ts.isNamedImports(clause.namedBindings)) {
+                    for (const elem of clause.namedBindings.elements)
+                        names.push(elem.name.text);
+                }
+                out.push({ specifier, names, location: locationOf(tree, n) });
+            }
+        });
+        return out;
+    },
+    findCallsTo(tree, name) {
+        const out = [];
+        walk(tree, (n) => {
+            if (ts.isCallExpression(n)) {
+                const expr = n.expression;
+                let target = '';
+                if (ts.isIdentifier(expr))
+                    target = expr.text;
+                else if (ts.isPropertyAccessExpression(expr))
+                    target = expr.name.text;
+                if (target === name)
+                    out.push(n);
+            }
+        });
+        return out;
+    },
+    findStringLiterals(tree) {
+        const out = [];
+        walk(tree, (n) => {
+            if (ts.isStringLiteralLike(n)) {
+                out.push({ value: n.text, location: locationOf(tree, n) });
+            }
+        });
+        return out;
+    },
+    getLocation(tree, node) {
+        return locationOf(tree, node);
+    },
+    getText(tree, node) {
+        return node.getText(tree);
+    },
+};
+//# sourceMappingURL=query.js.map

package/dist/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../src/query.ts"],"names":[],"mappings":"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"}

package/dist/strip.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @fileoverview TypeScript string and comment stripping.
+ *
+ * Implements the LanguageAdapter contract methods stripStrings/stripComments
+ * by re-using the rich filterContent implementation in this package. Both
+ * functions preserve byte length so line/column positions remain stable.
+ *
+ * For the canonical rationale on why a TS-AST-aware stripper coexists
+ * with the regex-based language-agnostic strippers in
+ * `@opensip-cli/fitness/framework/strip-literals.ts`, see that file's
+ * header. The dispatch boundary that selects between the two families
+ * is `applyContentFilter` in
+ * `@opensip-cli/core/languages/content-filter-dispatch.ts`
+ * (audit 2026-05-23 F9).
+ */
+/**
+ * Replace string literal content with whitespace of equal length.
+ * Quote/backtick delimiters are preserved; only the inside is blanked.
+ */
+export declare function stripStrings(content: string): string;
+/**
+ * Replace string literals AND comments with whitespace of equal length.
+ */
+export declare function stripComments(content: string): string;
+//# sourceMappingURL=strip.d.ts.map

package/dist/strip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strip.d.ts","sourceRoot":"","sources":["../src/strip.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAErD"}

package/dist/strip.js

@@ -0,0 +1,30 @@
+/**
+ * @fileoverview TypeScript string and comment stripping.
+ *
+ * Implements the LanguageAdapter contract methods stripStrings/stripComments
+ * by re-using the rich filterContent implementation in this package. Both
+ * functions preserve byte length so line/column positions remain stable.
+ *
+ * For the canonical rationale on why a TS-AST-aware stripper coexists
+ * with the regex-based language-agnostic strippers in
+ * `@opensip-cli/fitness/framework/strip-literals.ts`, see that file's
+ * header. The dispatch boundary that selects between the two families
+ * is `applyContentFilter` in
+ * `@opensip-cli/core/languages/content-filter-dispatch.ts`
+ * (audit 2026-05-23 F9).
+ */
+import { filterContent } from './filter.js';
+/**
+ * Replace string literal content with whitespace of equal length.
+ * Quote/backtick delimiters are preserved; only the inside is blanked.
+ */
+export function stripStrings(content) {
+    return filterContent(content).code;
+}
+/**
+ * Replace string literals AND comments with whitespace of equal length.
+ */
+export function stripComments(content) {
+    return filterContent(content).codeNoComments;
+}
+//# sourceMappingURL=strip.js.map

package/dist/strip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strip.js","sourceRoot":"","sources":["../src/strip.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,OAAO,aAAa,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,OAAO,aAAa,CAAC,OAAO,CAAC,CAAC,cAAc,CAAC;AAC/C,CAAC"}

package/dist/workspace-units.d.ts

@@ -0,0 +1,19 @@
+import type { WorkspaceUnit } from '@opensip-cli/core';
+/**
+ * Walk <rootDir>/packages/** for directories containing tsconfig.json.
+ * Each match becomes a WorkspaceUnit. Behavior matches the legacy
+ * `discoverWorkspacePackages` in graph's scope.ts which this replaces.
+ *
+ * Returns absolute paths, sorted lexicographically.
+ *
+ * The unit `id` is the unit's path RELATIVE to <rootDir>/packages, in POSIX
+ * form (e.g. `fitness/engine`, `graph/engine`, `core`). It must be unique and
+ * stable: a bare `basename(dir)` collapses nested packages that share a leaf
+ * name (this monorepo has `fitness/engine`, `graph/engine`, and
+ * `simulation/engine` — three distinct packages all named `engine`). The id is
+ * the shard id (graph's per-shard fragment-cache PRIMARY KEY), so a collision
+ * silently overwrites cache rows and breaks build determinism. The
+ * root-relative path restores a 1:1 id↔unit mapping.
+ */
+export declare function discoverTypescriptWorkspaceUnits(rootDir: string): Promise<readonly WorkspaceUnit[]>;
+//# sourceMappingURL=workspace-units.d.ts.map

package/dist/workspace-units.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-units.d.ts","sourceRoot":"","sources":["../src/workspace-units.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAKvD;;;;;;;;;;;;;;;GAeG;AAEH,wBAAsB,gCAAgC,CACpD,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,SAAS,aAAa,EAAE,CAAC,CAiCnC"}

package/dist/workspace-units.js

@@ -0,0 +1,78 @@
+// @fitness-ignore-file error-handling-quality -- safeIsDir/walk helpers for the workspace-units scan: statSync exception → "not a directory", readdirSync exception → "unreadable subdir, skip"; failure IS the function contract in each catch (already marked v8-ignore at each site as defensive/unreachable on real input).
+// @fitness-ignore-file detached-promises -- `walk` is a synchronous filesystem walk function (declared with `function`, returns void); heuristic flags it because it's invoked inside an async-returning enclosing function.
+import { existsSync, readdirSync, statSync } from 'node:fs';
+import { join, relative, resolve, sep } from 'node:path';
+const PACKAGES_SEARCH_ROOT = 'packages';
+const SEARCH_MAX_DEPTH = 3;
+/**
+ * Walk <rootDir>/packages/** for directories containing tsconfig.json.
+ * Each match becomes a WorkspaceUnit. Behavior matches the legacy
+ * `discoverWorkspacePackages` in graph's scope.ts which this replaces.
+ *
+ * Returns absolute paths, sorted lexicographically.
+ *
+ * The unit `id` is the unit's path RELATIVE to <rootDir>/packages, in POSIX
+ * form (e.g. `fitness/engine`, `graph/engine`, `core`). It must be unique and
+ * stable: a bare `basename(dir)` collapses nested packages that share a leaf
+ * name (this monorepo has `fitness/engine`, `graph/engine`, and
+ * `simulation/engine` — three distinct packages all named `engine`). The id is
+ * the shard id (graph's per-shard fragment-cache PRIMARY KEY), so a collision
+ * silently overwrites cache rows and breaks build determinism. The
+ * root-relative path restores a 1:1 id↔unit mapping.
+ */
+// eslint-disable-next-line @typescript-eslint/require-await
+export async function discoverTypescriptWorkspaceUnits(rootDir) {
+    const root = resolve(rootDir, PACKAGES_SEARCH_ROOT);
+    if (!existsSync(root) || !safeIsDir(root))
+        return [];
+    const out = [];
+    walk(root, 0);
+    out.sort((a, b) => a.rootDir.localeCompare(b.rootDir));
+    return out;
+    function walk(dir, depth) {
+        if (depth > SEARCH_MAX_DEPTH)
+            return;
+        const tsconfigPath = join(dir, 'tsconfig.json');
+        if (existsSync(tsconfigPath)) {
+            out.push({
+                id: unitId(root, dir),
+                rootDir: dir,
+                configPath: tsconfigPath,
+            });
+            return;
+        }
+        let entries;
+        try {
+            entries = readdirSync(dir);
+        }
+        catch {
+            /* v8 ignore next */
+            return;
+        }
+        for (const entry of entries) {
+            if (entry === 'node_modules' || entry === 'dist' || entry === 'build')
+                continue;
+            const sub = join(dir, entry);
+            if (!safeIsDir(sub))
+                continue;
+            walk(sub, depth + 1);
+        }
+    }
+}
+/**
+ * Derive a unique, stable unit id: the directory's path relative to the
+ * packages root, normalized to POSIX separators (so ids are identical on
+ * Windows and POSIX). E.g. `<root>/packages/fitness/engine` → `fitness/engine`.
+ */
+function unitId(packagesRoot, dir) {
+    return relative(packagesRoot, dir).split(sep).join('/');
+}
+function safeIsDir(p) {
+    try {
+        return statSync(p).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=workspace-units.js.map

package/dist/workspace-units.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-units.js","sourceRoot":"","sources":["../src/workspace-units.ts"],"names":[],"mappings":"AAAA,gUAAgU;AAChU,6NAA6N;AAC7N,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC5D,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAIzD,MAAM,oBAAoB,GAAG,UAAU,CAAC;AACxC,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAE3B;;;;;;;;;;;;;;;GAeG;AACH,4DAA4D;AAC5D,MAAM,CAAC,KAAK,UAAU,gCAAgC,CACpD,OAAe;IAEf,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,EAAE,oBAAoB,CAAC,CAAC;IACpD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACrD,MAAM,GAAG,GAAoB,EAAE,CAAC;IAChC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACd,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACvD,OAAO,GAAG,CAAC;IAEX,SAAS,IAAI,CAAC,GAAW,EAAE,KAAa;QACtC,IAAI,KAAK,GAAG,gBAAgB;YAAE,OAAO;QACrC,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;QAChD,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAC7B,GAAG,CAAC,IAAI,CAAC;gBACP,EAAE,EAAE,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC;gBACrB,OAAO,EAAE,GAAG;gBACZ,UAAU,EAAE,YAAY;aACzB,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QACD,IAAI,OAA0B,CAAC;QAC/B,IAAI,CAAC;YACH,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC;YACP,oBAAoB;YACpB,OAAO;QACT,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,KAAK,KAAK,cAAc,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,OAAO;gBAAE,SAAS;YAChF,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAC7B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC;gBAAE,SAAS;YAC9B,IAAI,CAAC,GAAG,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,MAAM,CAAC,YAAoB,EAAE,GAAW;IAC/C,OAAO,QAAQ,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC1D,CAAC;AAED,SAAS,SAAS,CAAC,CAAS;IAC1B,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@opensip-cli/lang-typescript",
+  "version": "0.1.0",
+  "license": "Apache-2.0",
+  "description": "TypeScript/JavaScript language adapter for opensip-cli",
+  "keywords": [
+    "opensip-cli",
+    "static-analysis",
+    "code-quality",
+    "parser",
+    "ast",
+    "tree-sitter",
+    "typescript",
+    "javascript"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/opensip-ai/opensip-cli.git",
+    "directory": "packages/languages/lang-typescript"
+  },
+  "homepage": "https://github.com/opensip-ai/opensip-cli",
+  "bugs": {
+    "url": "https://github.com/opensip-ai/opensip-cli/issues"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "NOTICE"
+  ],
+  "dependencies": {
+    "typescript": "~6.0.3",
+    "@opensip-cli/core": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.13.2",
+    "vitest": "^4.1.8"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run --passWithNoTests",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}