@opensip-tools/lang-typescript 1.0.4

package/dist/ast-utilities.js

@@ -0,0 +1,217 @@
+// @fitness-ignore-file batch-operation-limits -- iterates bounded collections (config entries, registry items, or small analysis results)
+/**
+ * @fileoverview Shared AST utilities for fitness checks.
+ *
+ * Common TypeScript AST operations for source parsing, tree walking,
+ * and node inspection. Used by AST-based fitness checks. Lives in
+ * @opensip-tools/lang-typescript so the dependency on `typescript` is
+ * isolated to the language pack.
+ */
+import { getParseTree } from '@opensip-tools/core/languages/parse-cache.js';
+import * as ts from 'typescript';
+import { typescriptAdapter } from './adapter.js';
+// =============================================================================
+// SOURCE PARSING
+// =============================================================================
+/**
+ * Parse TypeScript/JavaScript source into an AST SourceFile.
+ * Returns null on parse failure.
+ */
+export function parseSource(content, filePath) {
+    try {
+        return ts.createSourceFile(filePath, content, ts.ScriptTarget.Latest, true);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Cached parse — uses the language-aware parse cache via the registered
+ * TS adapter. Falls back to a direct parse when no cache is active.
+ */
+export function getSharedSourceFile(filePath, content) {
+    return getParseTree(typescriptAdapter, filePath, content);
+}
+// =============================================================================
+// TREE WALKING
+// =============================================================================
+/**
+ * Depth-first walk of all nodes in a SourceFile or subtree.
+ */
+export function walkNodes(root, visitor) {
+    function visit(node) {
+        visitor(node);
+        ts.forEachChild(node, visit);
+    }
+    ts.forEachChild(root, visit);
+}
+// =============================================================================
+// NODE INSPECTION
+// =============================================================================
+/**
+ * Get the leaf identifier text from an expression node.
+ */
+export function getIdentifierName(node) {
+    if (ts.isIdentifier(node))
+        return node.text;
+    if (ts.isPropertyAccessExpression(node))
+        return node.name.text;
+    return '';
+}
+/**
+ * Get the full dotted path of a property access chain.
+ */
+export function getPropertyChain(node) {
+    if (ts.isIdentifier(node))
+        return node.text;
+    if (ts.isPropertyAccessExpression(node)) {
+        return `${getPropertyChain(node.expression)}.${node.name.text}`;
+    }
+    return '';
+}
+/**
+ * Get the 1-indexed line number for a node.
+ */
+export function getLineNumber(node, sourceFile) {
+    const { line } = sourceFile.getLineAndCharacterOfPosition(node.getStart());
+    return line + 1;
+}
+/**
+ * Get the column number (0-indexed) for a node.
+ */
+export function getColumn(node, sourceFile) {
+    const { character } = sourceFile.getLineAndCharacterOfPosition(node.getStart());
+    return character;
+}
+/**
+ * Check if a node is a property access matching a specific property name.
+ */
+export function isPropertyAccess(node, propertyName) {
+    return ts.isPropertyAccessExpression(node) && node.name.text === propertyName;
+}
+/**
+ * Check if a node is a literal value.
+ */
+export function isLiteral(node) {
+    if (ts.isStringLiteral(node) || ts.isNumericLiteral(node))
+        return true;
+    if (ts.isNoSubstitutionTemplateLiteral(node))
+        return true;
+    if (node.kind === ts.SyntaxKind.TrueKeyword || node.kind === ts.SyntaxKind.FalseKeyword)
+        return true;
+    if (node.kind === ts.SyntaxKind.NullKeyword)
+        return true;
+    if (ts.isIdentifier(node) && node.text === 'undefined')
+        return true;
+    return false;
+}
+/**
+ * Check if a node is inside a string literal or template literal.
+ */
+export function isInStringLiteral(node) {
+    let current = node.parent;
+    while (!ts.isSourceFile(current)) {
+        if (ts.isStringLiteral(current) ||
+            ts.isNoSubstitutionTemplateLiteral(current) ||
+            ts.isTemplateExpression(current)) {
+            return true;
+        }
+        current = current.parent;
+    }
+    return false;
+}
+// =============================================================================
+// NODE FINDERS
+// =============================================================================
+/**
+ * Find all call expressions matching `object.method()` pattern.
+ */
+export function findCallExpressions(root, objectName, methodName) {
+    const results = [];
+    walkNodes(root, (node) => {
+        if (!ts.isCallExpression(node))
+            return;
+        const expr = node.expression;
+        if (!ts.isPropertyAccessExpression(expr))
+            return;
+        if (expr.name.text !== methodName)
+            return;
+        const chain = getPropertyChain(expr.expression);
+        if (chain === objectName || chain.endsWith(`.${objectName}`)) {
+            results.push(node);
+        }
+    });
+    return results;
+}
+/**
+ * Find all binary expressions with a specific operator.
+ */
+export function findBinaryExpressions(root, operator) {
+    const results = [];
+    walkNodes(root, (node) => {
+        if (ts.isBinaryExpression(node) && node.operatorToken.kind === operator) {
+            results.push(node);
+        }
+    });
+    return results;
+}
+/**
+ * Find all template literal expressions (with substitutions).
+ */
+export function findTemplateLiterals(root) {
+    const results = [];
+    walkNodes(root, (node) => {
+        if (ts.isTemplateExpression(node)) {
+            results.push(node);
+        }
+    });
+    return results;
+}
+// =============================================================================
+// COMMENT DETECTION
+// =============================================================================
+function isPositionInRanges(position, ranges) {
+    if (!ranges)
+        return false;
+    for (const range of ranges) {
+        if (position >= range.pos && position < range.end)
+            return true;
+    }
+    return false;
+}
+/**
+ * Check if a position in the source falls inside a comment.
+ */
+export function isInComment(position, sourceFile) {
+    const text = sourceFile.getFullText();
+    const lineStarts = sourceFile.getLineStarts();
+    for (let i = 0; i < lineStarts.length; i++) {
+        const lineStart = lineStarts[i] ?? 0;
+        const lineEnd = i + 1 < lineStarts.length ? (lineStarts[i + 1] ?? text.length) : text.length;
+        if (position < lineStart || position >= lineEnd)
+            continue;
+        if (isPositionInRanges(position, ts.getLeadingCommentRanges(text, lineStart)))
+            return true;
+        if (isPositionInRanges(position, ts.getTrailingCommentRanges(text, lineStart)))
+            return true;
+    }
+    return false;
+}
+// =============================================================================
+// STRING UTILITIES
+// =============================================================================
+/**
+ * Count unescaped backtick characters in a line.
+ */
+export function countUnescapedBackticks(line) {
+    let count = 0;
+    for (let ci = 0; ci < line.length; ci++) {
+        if (line[ci] === '`' && (ci === 0 || line[ci - 1] !== '\\'))
+            count++;
+    }
+    return count;
+}
+/** Re-export TypeScript namespace for check authors */
+// eslint-disable-next-line unicorn/prefer-export-from -- `export * as from 'typescript'` is invalid (typescript uses `export =`); the namespace import + named export form is the only working shape
+export { ts };
+//# sourceMappingURL=ast-utilities.js.map

package/dist/ast-utilities.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { typescriptAdapter, adapters } from './adapter.js';
+export { parseSource } from './parse.js';
+export { typescriptQuery } from './query.js';
+export { stripStrings, stripComments, filterContent, clearFilterCache } from './strip.js';
+export type { FilteredContent } from './strip.js';
+export { getSharedSourceFile, walkNodes, getIdentifierName, getPropertyChain, getLineNumber, getColumn, isPropertyAccess, isLiteral, isInStringLiteral, findCallExpressions, findBinaryExpressions, findTemplateLiterals, isInComment, countUnescapedBackticks, ts, } from './ast-utilities.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAC5C,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AACzF,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAIjD,OAAO,EACL,mBAAmB,EACnB,SAAS,EACT,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,SAAS,EACT,gBAAgB,EAChB,SAAS,EACT,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,WAAW,EACX,uBAAuB,EACvB,EAAE,GACH,MAAM,oBAAoB,CAAA"}

package/dist/index.js

@@ -0,0 +1,9 @@
+// TypeScript LanguageAdapter for opensip-tools
+export { typescriptAdapter, adapters } from './adapter.js';
+export { parseSource } from './parse.js';
+export { typescriptQuery } from './query.js';
+export { stripStrings, stripComments, filterContent, clearFilterCache } from './strip.js';
+// Legacy AST helpers — re-exported so existing TS checks can keep their imports
+// pointing at @opensip-tools/lang-typescript instead of @opensip-tools/core/framework/*
+export { getSharedSourceFile, walkNodes, getIdentifierName, getPropertyChain, getLineNumber, getColumn, isPropertyAccess, isLiteral, isInStringLiteral, findCallExpressions, findBinaryExpressions, findTemplateLiterals, isInComment, countUnescapedBackticks, ts, } from './ast-utilities.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAC5C,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAGzF,gFAAgF;AAChF,wFAAwF;AACxF,OAAO,EACL,mBAAmB,EACnB,SAAS,EACT,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,SAAS,EACT,gBAAgB,EAChB,SAAS,EACT,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,WAAW,EACX,uBAAuB,EACvB,EAAE,GACH,MAAM,oBAAoB,CAAA"}

package/dist/parse.d.ts

@@ -0,0 +1,10 @@
+import ts from 'typescript';
+/**
+ * Parse TypeScript/JavaScript source into a SourceFile.
+ * Returns null on parse failure.
+ *
+ * Uses ts.ScriptKind.TSX so the same parse path handles .ts and .tsx
+ * (and is permissive enough for .js / .jsx).
+ */
+export declare function parseSource(content: string, filePath: string): ts.SourceFile | null;
+//# sourceMappingURL=parse.d.ts.map

package/dist/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAA;AAE3B;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,EAAE,CAAC,UAAU,GAAG,IAAI,CAYnF"}

package/dist/parse.js

@@ -0,0 +1,18 @@
+import ts from 'typescript';
+/**
+ * Parse TypeScript/JavaScript source into a SourceFile.
+ * Returns null on parse failure.
+ *
+ * Uses ts.ScriptKind.TSX so the same parse path handles .ts and .tsx
+ * (and is permissive enough for .js / .jsx).
+ */
+export function parseSource(content, filePath) {
+    try {
+        return ts.createSourceFile(filePath, content, ts.ScriptTarget.Latest, 
+        /* setParentNodes */ true, ts.ScriptKind.TSX);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=parse.js.map

package/dist/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAA;AAE3B;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,QAAgB;IAC3D,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,gBAAgB,CACxB,QAAQ,EACR,OAAO,EACP,EAAE,CAAC,YAAY,CAAC,MAAM;QACtB,oBAAoB,CAAC,IAAI,EACzB,EAAE,CAAC,UAAU,CAAC,GAAG,CAClB,CAAA;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC"}

package/dist/query.d.ts

@@ -0,0 +1,4 @@
+import ts from 'typescript';
+import type { LanguageQueryAPI } from '@opensip-tools/core/languages/adapter.js';
+export declare const typescriptQuery: LanguageQueryAPI<ts.SourceFile, ts.Node>;
+//# sourceMappingURL=query.d.ts.map

package/dist/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../src/query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAA;AAE3B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAA;AAahF,eAAO,MAAM,eAAe,EAAE,gBAAgB,CAAC,EAAE,CAAC,UAAU,EAAE,EAAE,CAAC,IAAI,CA4DpE,CAAA"}

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,19 @@
+/**
+ * @fileoverview TypeScript string and comment stripping.
+ *
+ * Implements the LanguageAdapter contract methods stripStrings/stripComments
+ * by re-using the rich filterContent implementation in core. Both functions
+ * preserve byte length so line/column positions remain stable.
+ */
+/**
+ * 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;
+export { filterContent, clearFilterCache } from '@opensip-tools/fitness';
+export type { FilteredContent } from '@opensip-tools/fitness';
+//# 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;;;;;;GAMG;AAIH;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAErD;AAKD,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AACxE,YAAY,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA"}

package/dist/strip.js

@@ -0,0 +1,26 @@
+/**
+ * @fileoverview TypeScript string and comment stripping.
+ *
+ * Implements the LanguageAdapter contract methods stripStrings/stripComments
+ * by re-using the rich filterContent implementation in core. Both functions
+ * preserve byte length so line/column positions remain stable.
+ */
+import { filterContent } from '@opensip-tools/fitness';
+/**
+ * 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;
+}
+// Re-export filterContent and the FilteredContent type for richer
+// position-aware needs. The clearFilterCache helper is also re-exported
+// for compatibility with any callers that managed it directly.
+export { filterContent, clearFilterCache } from '@opensip-tools/fitness';
+//# 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;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAEtD;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,OAAO,aAAa,CAAC,OAAO,CAAC,CAAC,IAAI,CAAA;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,OAAO,aAAa,CAAC,OAAO,CAAC,CAAC,cAAc,CAAA;AAC9C,CAAC;AAED,kEAAkE;AAClE,wEAAwE;AACxE,+DAA+D;AAC/D,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@opensip-tools/lang-typescript",
+  "version": "1.0.4",
+  "license": "MIT",
+  "description": "TypeScript/JavaScript language adapter for opensip-tools",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/opensip-ai/opensip-tools.git",
+    "directory": "packages/languages/lang-typescript"
+  },
+  "homepage": "https://github.com/opensip-ai/opensip-tools",
+  "bugs": {
+    "url": "https://github.com/opensip-ai/opensip-tools/issues"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./adapter": "./dist/adapter.js",
+    "./parse": "./dist/parse.js",
+    "./query": "./dist/query.js",
+    "./strip": "./dist/strip.js",
+    "./ast-utilities": "./dist/ast-utilities.js"
+  },
+  "dependencies": {
+    "typescript": "~5.7.0",
+    "@opensip-tools/core": "1.0.4",
+    "@opensip-tools/fitness": "1.0.4"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "vitest": "^2.1.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run --passWithNoTests",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}

package/src/__tests__/adapter.test.ts

@@ -0,0 +1,67 @@
+import { describe, expect, it } from 'vitest'
+
+import { typescriptAdapter } from '../adapter.js'
+
+describe('typescriptAdapter', () => {
+  it('declares the expected identity and extensions', () => {
+    expect(typescriptAdapter.id).toBe('typescript')
+    expect(typescriptAdapter.fileExtensions).toContain('.ts')
+    expect(typescriptAdapter.fileExtensions).toContain('.tsx')
+    expect(typescriptAdapter.fileExtensions).toContain('.js')
+    expect(typescriptAdapter.fileExtensions).toContain('.jsx')
+  })
+
+  it('parse() returns a non-null SourceFile for valid input', () => {
+    const tree = typescriptAdapter.parse('const x = 1;', 'foo.ts')
+    expect(tree).not.toBeNull()
+    expect(tree?.fileName).toBe('foo.ts')
+  })
+
+  it('parse() handles broken input by returning a SourceFile (TS is forgiving)', () => {
+    const tree = typescriptAdapter.parse('let x =;', 'broken.ts')
+    expect(tree).not.toBeNull()
+  })
+
+  it('query.findFunctions returns named and anonymous functions', () => {
+    const tree = typescriptAdapter.parse('function a(){} const b = () => {}', 'foo.ts')!
+    const fns = typescriptAdapter.query!.findFunctions(tree)
+    expect(fns.length).toBe(2)
+    const names = fns.map((f) => f.name).sort()
+    expect(names).toEqual([null, 'a'].sort())
+  })
+
+  it('query.findImports returns named imports and specifier', () => {
+    const tree = typescriptAdapter.parse(
+      "import { x, y } from './foo'",
+      'foo.ts',
+    )!
+    const imports = typescriptAdapter.query!.findImports(tree)
+    expect(imports.length).toBe(1)
+    expect(imports[0].specifier).toBe('./foo')
+    expect([...imports[0].names].sort()).toEqual(['x', 'y'])
+  })
+
+  it('query.findCallsTo matches the leaf call name', () => {
+    const tree = typescriptAdapter.parse('foo(); bar.baz();', 'foo.ts')!
+    expect(typescriptAdapter.query!.findCallsTo(tree, 'foo').length).toBe(1)
+    expect(typescriptAdapter.query!.findCallsTo(tree, 'baz').length).toBe(1)
+    expect(typescriptAdapter.query!.findCallsTo(tree, 'absent').length).toBe(0)
+  })
+
+  it('stripStrings replaces string content but preserves length', () => {
+    const original = 'const x = "abc"; const y = 1'
+    const stripped = typescriptAdapter.stripStrings(original)
+    expect(stripped.length).toBe(original.length)
+    expect(stripped).not.toContain('abc')
+    expect(stripped).toContain('const x =')
+    expect(stripped).toContain('const y = 1')
+  })
+
+  it('stripComments replaces comment content', () => {
+    const original = '// hello\nconst x = 1'
+    const stripped = typescriptAdapter.stripComments(original)
+    expect(stripped.length).toBe(original.length)
+    expect(stripped).not.toContain('hello')
+    expect(stripped).toContain('const x = 1')
+  })
+})