Phase 0: Research & Setup

[jschatz1]

Duration: 2 weeks

Study the Source

1. Read bun/src/js_parser.zig - main parser
2. Read esbuild's parser (Go) for comparison - it's the original
3. Document the architecture decisions

Key Insight from Bun

"Everything is either an Expression, a Binding, or a Statement" - naming conventions from esbuild

Setup

howth/
└── crates/
    └── howth-parser/        # New crate
        ├── src/
        │   ├── lib.rs
        │   ├── lexer.rs     # Tokenizer
        │   ├── token.rs     # Token types
        │   ├── ast.rs       # AST node types
        │   ├── parser.rs    # Main parser
        │   ├── expr.rs      # Expression parsing
        │   ├── stmt.rs      # Statement parsing
        │   ├── binding.rs   # Binding patterns
        │   ├── typescript.rs # TS extensions
        │   ├── jsx.rs       # JSX extensions
        │   └── codegen.rs   # Output generation
        └── Cargo.toml

Deliverables

• Document Bun parser architecture
• Document esbuild parser architecture
• Create howth-parser crate skeleton
• Define initial module structure

[himax12]

@jschatz1 i want to pick this issue