@codeslick/ast-utils

Multi-language AST parsing utilities for static code analysis with TypeScript Compiler API integration.

Features

- TypeScript Compiler API: Full type checking and diagnostics (95%+ error detection)
- Batch Processing: 17x faster analysis for multiple files
- JSX Support: Detect and handle JSX syntax
- Variable Tracking: Track variable declarations and usage

Installation

``bash
npm install @codeslick/ast-utils
`

Usage

`typescript
import { getTypeScriptDiagnostics, convertDiagnosticsToIssues } from '@codeslick/ast-utils';

const code = const x: string = 42;; // Type error

const diagnostics = getTypeScriptDiagnostics(code);
const issues = convertDiagnosticsToIssues(diagnostics);

console.log(issues[0].message);
// "TypeScript Error (2322): Type 'number' is not assignable to type 'string'"
`

API

- getTypeScriptDiagnostics(code, fileName?, options?) - Analyze single file
- getBatchTypeScriptDiagnostics(filePaths, options?) - Batch processing (17x faster)
- convertDiagnosticsToIssues(diagnostics) - Convert to security issues format
- detectJSX(code) - Check if code contains JSX
- isJSXElement(varName, hasJSX)` - Check if variable is JSX element

TypeScript Version

CRITICAL: This package requires TypeScript 5.9.3 (pinned). The Compiler API has breaking changes between versions.

License

MIT © Vitor Lourenco