driftdetect-core 0.1.0

package/dist/parsers/typescript-parser.d.ts

@@ -0,0 +1,264 @@
+/**
+ * TypeScript Parser - TypeScript/JavaScript parsing using TypeScript Compiler API
+ *
+ * Extracts imports, exports, classes, functions, interfaces, and type aliases
+ * from TypeScript and JavaScript files.
+ *
+ * @requirements 3.2
+ */
+import { BaseParser } from './base-parser.js';
+import type { AST, ASTNode, Language, ParseResult, Position } from './types.js';
+/**
+ * Information about an import statement extracted from parsed source
+ */
+export interface ParsedImportInfo {
+    /** Module specifier (e.g., './utils', 'lodash') */
+    moduleSpecifier: string;
+    /** Named imports (e.g., { foo, bar }) */
+    namedImports: string[];
+    /** Default import name */
+    defaultImport: string | null;
+    /** Namespace import (e.g., * as utils) */
+    namespaceImport: string | null;
+    /** Whether this is a type-only import */
+    isTypeOnly: boolean;
+    /** Start position */
+    startPosition: Position;
+    /** End position */
+    endPosition: Position;
+}
+/**
+ * Information about an export statement extracted from parsed source
+ */
+export interface ParsedExportInfo {
+    /** Exported name */
+    name: string;
+    /** Local name if different from exported name */
+    localName: string | null;
+    /** Whether this is a default export */
+    isDefault: boolean;
+    /** Whether this is a type-only export */
+    isTypeOnly: boolean;
+    /** Whether this is a re-export from another module */
+    isReExport: boolean;
+    /** Module specifier for re-exports */
+    moduleSpecifier: string | null;
+    /** Start position */
+    startPosition: Position;
+    /** End position */
+    endPosition: Position;
+}
+/**
+ * Information about a class declaration
+ */
+export interface ClassInfo {
+    /** Class name */
+    name: string;
+    /** Whether the class is exported */
+    isExported: boolean;
+    /** Whether this is a default export */
+    isDefault: boolean;
+    /** Whether the class is abstract */
+    isAbstract: boolean;
+    /** Extended class name */
+    extends: string | null;
+    /** Implemented interfaces */
+    implements: string[];
+    /** Method names */
+    methods: string[];
+    /** Property names */
+    properties: string[];
+    /** Start position */
+    startPosition: Position;
+    /** End position */
+    endPosition: Position;
+}
+/**
+ * Information about a function declaration
+ */
+export interface FunctionInfo {
+    /** Function name */
+    name: string;
+    /** Whether the function is exported */
+    isExported: boolean;
+    /** Whether this is a default export */
+    isDefault: boolean;
+    /** Whether the function is async */
+    isAsync: boolean;
+    /** Whether the function is a generator */
+    isGenerator: boolean;
+    /** Parameter names */
+    parameters: string[];
+    /** Start position */
+    startPosition: Position;
+    /** End position */
+    endPosition: Position;
+}
+/**
+ * Information about an interface declaration
+ */
+export interface InterfaceInfo {
+    /** Interface name */
+    name: string;
+    /** Whether the interface is exported */
+    isExported: boolean;
+    /** Extended interfaces */
+    extends: string[];
+    /** Property names */
+    properties: string[];
+    /** Method names */
+    methods: string[];
+    /** Start position */
+    startPosition: Position;
+    /** End position */
+    endPosition: Position;
+}
+/**
+ * Information about a type alias declaration
+ */
+export interface TypeAliasInfo {
+    /** Type alias name */
+    name: string;
+    /** Whether the type alias is exported */
+    isExported: boolean;
+    /** Start position */
+    startPosition: Position;
+    /** End position */
+    endPosition: Position;
+}
+/**
+ * Extended parse result with TypeScript-specific information
+ */
+export interface TypeScriptParseResult extends ParseResult {
+    /** Extracted imports */
+    imports: ParsedImportInfo[];
+    /** Extracted exports */
+    exports: ParsedExportInfo[];
+    /** Extracted classes */
+    classes: ClassInfo[];
+    /** Extracted functions */
+    functions: FunctionInfo[];
+    /** Extracted interfaces */
+    interfaces: InterfaceInfo[];
+    /** Extracted type aliases */
+    typeAliases: TypeAliasInfo[];
+}
+/**
+ * TypeScript/JavaScript parser using the TypeScript Compiler API.
+ *
+ * Provides AST parsing and extraction of imports, exports, classes,
+ * functions, interfaces, and type aliases.
+ *
+ * @requirements 3.2 - Support TypeScript and JavaScript
+ */
+export declare class TypeScriptParser extends BaseParser {
+    readonly language: Language;
+    readonly extensions: string[];
+    /**
+     * Parse TypeScript/JavaScript source code into an AST.
+     *
+     * @param source - The source code to parse
+     * @param filePath - Optional file path for error reporting
+     * @returns ParseResult containing the AST or errors
+     *
+     * @requirements 3.2, 3.3
+     */
+    parse(source: string, filePath?: string): TypeScriptParseResult;
+    /**
+     * Query the AST for nodes matching a pattern.
+     *
+     * Supports querying by node type (e.g., 'ImportDeclaration', 'ClassDeclaration').
+     *
+     * @param ast - The AST to query
+     * @param pattern - The node type to search for
+     * @returns Array of matching AST nodes
+     *
+     * @requirements 3.5
+     */
+    query(ast: AST, pattern: string): ASTNode[];
+    /**
+     * Get the TypeScript ScriptKind based on file extension.
+     */
+    private getScriptKind;
+    /**
+     * Convert a TypeScript AST node to our unified AST format.
+     */
+    private convertNode;
+    /**
+     * Convert a character offset to a Position (row, column).
+     */
+    private getPosition;
+    /**
+     * Extract syntax errors from the source file.
+     */
+    private extractErrors;
+    /**
+     * Extract import information from the source file.
+     */
+    private extractImports;
+    /**
+     * Parse a single import declaration.
+     */
+    private parseImportDeclaration;
+    /**
+     * Extract export information from the source file.
+     */
+    private extractExports;
+    /**
+     * Check if a node has an export modifier.
+     */
+    private hasExportModifier;
+    /**
+     * Check if a node has a default modifier.
+     */
+    private hasDefaultModifier;
+    /**
+     * Parse an export declaration.
+     */
+    private parseExportDeclaration;
+    /**
+     * Parse an export assignment (export default or export =).
+     */
+    private parseExportAssignment;
+    /**
+     * Parse an exported declaration.
+     */
+    private parseExportedDeclaration;
+    /**
+     * Extract class information from the source file.
+     */
+    private extractClasses;
+    /**
+     * Parse a class declaration.
+     */
+    private parseClassDeclaration;
+    /**
+     * Extract function information from the source file.
+     */
+    private extractFunctions;
+    /**
+     * Parse a function declaration.
+     */
+    private parseFunctionDeclaration;
+    /**
+     * Parse a variable declaration with a function expression or arrow function.
+     */
+    private parseVariableFunction;
+    /**
+     * Extract interface information from the source file.
+     */
+    private extractInterfaces;
+    /**
+     * Parse an interface declaration.
+     */
+    private parseInterfaceDeclaration;
+    /**
+     * Extract type alias information from the source file.
+     */
+    private extractTypeAliases;
+    /**
+     * Parse a type alias declaration.
+     */
+    private parseTypeAliasDeclaration;
+}
+//# sourceMappingURL=typescript-parser.d.ts.map

package/dist/parsers/typescript-parser.d.ts.map

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