benjamn/ast-types
Ast Types
This project is a framework for building, manipulating, and analyzing abstract syntax trees. It provides a toolkit for defining, traversing, and validating syntax trees that are compatible with the Mozilla Parser API, serving as a foundation for static code inspection and automated transformation tasks.
The library distinguishes itself through a declarative type system that enforces structural integrity across node hierarchies. By wrapping raw syntax nodes in context-aware objects, it enables developers to track parent relationships and ancestor chains without modifying the underlying tree structure. This system supports the registration of custom syntax types, allowing for the extension of standard hierarchies to accommodate non-standard language features.
The toolkit includes comprehensive utilities for navigating complex structures using visitor patterns, which facilitate both inspection and modification of code. It also provides integrated scope analysis to resolve variable bindings and lookup depths, alongside schema-driven validation to ensure that all nodes conform to predefined specifications.
Features
- AST Manipulation Libraries - Provides a toolkit for defining, traversing, and validating Mozilla Parser API compatible syntax trees.
- JavaScript AST Transformations - Automates code refactoring and transpilation tasks by traversing and modifying syntax tree nodes.
- AST Variable Scope Analysis - Implements scope analysis to resolve variable bindings and lookup depths by identifying declarations within code blocks.
- JavaScript Static Analyzers - Provides tools for inspecting and analyzing JavaScript source code by navigating its underlying syntax tree structure.
- AST Visitor Patterns - Navigates complex tree structures using visitor patterns to enable code inspection and modification.
- AST Context Analysis - Provides utilities for tracking ancestor chains and parent relationships within abstract syntax trees during traversal.
- Language Extensions - Enables the definition of new syntax or language features by extending standard node hierarchies.
- Tree Traversal - Supports syntax tree traversal using a visitor pattern to inspect, transform, or validate code structures.
- Code Analysis Tools - Inspects variable scope and navigates nested code structures through visitor patterns and path-based node management.
- Custom Node Definitions - Supports the registration of custom syntax types to extend standard hierarchies for non-standard language features.
- Runtime Schema Validations - Ensures data integrity during tree construction and transformation by validating node structures against predefined type definitions.
- Structured Type Declarations - Defines a formal schema for syntax nodes with support for property requirements and default values.
- Syntax Tree Construction - Provides a framework for constructing and extending node hierarchies with declarative type definitions.
- Syntax Tree Transformers - Ensures generated or modified code structures conform to language specifications by enforcing type hierarchies and property requirements.
- Node Type Validators - Ensures syntax tree nodes conform to language specifications by enforcing required field types and default values.
- Path-Based Node Selection - Wraps raw syntax nodes in context-aware objects to track parent relationships without mutating the original tree.
