Module parser 

Parser types - AST node definitions for TypeScript.

This module defines the AST node types that match TypeScript’s parser output. The goal is to produce an identical AST structure that can be serialized and consumed by the TypeScript type checker.

DESIGN NOTES:

• We use arena allocation (indices) rather than Box/Rc for node references
• All nodes have common fields: kind, flags, pos, end
• Node-specific data is stored in enum variants
• This design allows efficient serialization to/from JavaScript

PERFORMANCE NOTES:

• The node module provides a cache-optimized 16-byte node representation
• Current Node enum is 208 bytes (0.31 nodes/cache-line)
• Node is 16 bytes (4 nodes/cache-line) - 13x better cache locality

Modules

base

Shared parser base types used by both Node and (legacy) AST.

flags

Node flags and modifier flags for AST nodes.

node

Thin Node Architecture for Cache-Efficient AST

parse_rules

Parsing rule modules

state

Parser - Cache-optimized parser using NodeArena

syntax_kind_ext

Extended SyntaxKind values for AST nodes that are not tokens. These match TypeScript’s SyntaxKind enum values exactly.

Structs

NodeArena

Arena for thin nodes with typed data pools. Provides O(1) allocation and cache-efficient storage.

NodeIndex

Index into an arena. Used instead of pointers/references for serialization-friendly graphs.

NodeList

A list of node indices, representing children or a node array.

ParseDiagnostic

A parse-time diagnostic (error or warning).

ParserState

This parser produces the same AST semantically as ParserState, but uses the cache-optimized NodeArena for storage.

TextRange

A text range with start and end positions. All positions are character indices (not byte indices).