benjamn/recast
Recast
Recast هو محلل وطابعة AST بلغة JavaScript مصمم لإعادة هيكلة الكود المؤتمت. يقوم بتحويل الكود المصدري إلى أشجار بناء جملة مجردة يمكن تعديلها ثم طباعتها مرة أخرى إلى كود مصدري.
يركز المشروع على التحويلات التي تحافظ على التنسيق، حيث يخزن البيانات الوصفية الأصلية للمسافات البيضاء والمسافات البادئة داخل عقد شجرة البناء لإعادة بناء الكود دون فقدان تخطيطه الأصلي. كما يولد خرائط مصدر على مستوى الأحرف للحفاظ على مراسلات دقيقة بين المدخلات الأصلية والمخرجات المحولة.
تتضمن مجموعة الأدوات أدوات مساعدة للتلاعب بشجرة البناء باستخدام نمط الزائر (visitor pattern)، بالإضافة إلى خيارات لطباعة الأنماط العامة الجميلة. يتم توفير واجهة سطر أوامر لتنفيذ دوال التحويل هذه على الملفات المستهدفة وكتابة النتائج على القرص.
Features
- Automated Code Refactoring - Automates structural changes to JavaScript source code through programmatic AST manipulation to update patterns across codebases.
- AST Structure Modification - Provides utilities for replacing, inserting, and removing nodes within the abstract syntax tree structure.
- AST-Based Source Transformations - Provides structural modifications of source code by replacing matched syntax tree nodes while preserving original formatting.
- JavaScript AST Transformations - Performs structural modifications of JavaScript source code represented as an abstract syntax tree.
- Formatting-Preserving Transformers - Modifies JavaScript syntax trees while preserving original whitespace and indentation in the resulting output.
- Code Refactoring Tools - Automates JavaScript code refactoring by manipulating AST nodes and regenerating source files.
- Format-Preserving Printing - Retains original whitespace and formatting tokens within the AST to reconstruct source code without losing layout.
- JavaScript AST Printers - Provides a complete system for parsing JavaScript into ASTs and printing them back to source code.
- Source Code Generators - Programmatically generates valid JavaScript source code from modified abstract syntax tree representations.
- Abstract Syntax Tree Parsing - Converts JavaScript source code into a structured tree representation while retaining formatting metadata.
- Tree Traversal - Utilizes a visitor pattern to programmatically navigate and apply transformations to nodes within the syntax tree.
- Non-Destructive Source Printing - Splices original source text fragments around modified syntax tree nodes to maintain existing indentation during printing.
- Syntax Tree Transformers - Provides tools for modifying and rewriting syntax trees to perform complex code transformations.
- Source Map Generation - Implements character-level source maps to maintain precise correspondences between original input and transformed output.
- Pretty Printing Algorithms - Offers a generic style pretty-printer that applies consistent global indentation rules regardless of original formatting.
- JavaScript Source Maps - Generates precise character-level source maps specifically for transformed JavaScript files.
- Source Map Generation - Creates character-by-character mappings between original source files and generated output for debugging.
- Source Map Generators - Provides character-level source maps that link transformed output back to the original JavaScript source files.
- AST & Language Tools - JavaScript AST transformer with source map support.
- Development Utilities - Syntax tree transformer and source map generator.
