Crate stator_jse 

stator_jse — the foundational engine library for the Stator JavaScript engine.

Crate layout

• error — Engine error types and StatorResult alias.
• gc — Garbage collector infrastructure (heap, tracing, handles).
• objects — JavaScript value representation and heap object types.
• sandbox — Memory sandbox: virtual-address range reservation, pointer bounds checking, and external pointer table.
• zone — Bump-pointer region allocator for compiler temporaries.
• parser — Lexer (parser::scanner), AST (parser::ast), and scope analysis (parser::scope), and lazy parsing (parser::preparser)
• interpreter — Bytecode interpreter (interpreter::Interpreter): fetch-decode-dispatch loop, interpreter::InterpreterFrame activation frame, and arithmetic/comparison opcode handlers.
• bytecode — Bytecode instruction set (bytecode::bytecodes): ~174 opcodes matching V8 Ignition semantics, operand encoding, and encode/decode utilities. bytecode::bytecode_array provides the compact bytecode::bytecode_array::BytecodeArray type with constant pool and source-position table. bytecode::register provides the bytecode::register::Register type and bytecode::register::RegisterAllocator for register assignment during compilation. bytecode::bytecode_generator provides the bytecode::bytecode_generator::BytecodeGenerator that compiles a JavaScript AST into a bytecode::bytecode_array::BytecodeArray. bytecode::feedback provides bytecode::feedback::FeedbackVector, bytecode::feedback::FeedbackMetadata, bytecode::feedback::FeedbackSlotKind, and bytecode::feedback::InlineCacheState for inline-cache feedback.

Modules

builtins

Built-in JavaScript object static methods (Object, Promise, …). Built-in JavaScript objects and their static methods.

bytecode

Bytecode instruction set and encode/decode utilities. Bytecode module: instruction set and encoding for the Stator VM.

compiler

JIT compiler infrastructure: baseline code generator and macro-assembler. Compiler infrastructure for the Stator JIT.

dom

DOM integration layer: object wrapping, property interceptors, internal fields, and weak references for bridging the JS engine with web platform APIs. DOM integration layer for bridging Stator JS engine with web platform APIs.

error

Engine error types and [StatorResult] alias. Error types for the Stator engine.

event_loop

Event loop integration: macrotask scheduling, timer management, and microtask queue draining for embedder coordination. Event loop integration layer.

executable_memory

Cross-platform abstraction for allocating, populating, and releasing W^X executable memory regions used by the baseline and Maglev JIT tiers. Cross-platform abstraction for allocating, populating, and releasing the executable memory regions used by Stator’s baseline and Maglev JIT tiers.

ffi

V8-compatible FFI wrapper types (V8Object, V8Array, V8Number, etc.). V8-compatible FFI wrapper types for the Stator JavaScript engine.

gc

Garbage collector infrastructure: heap, tracing, and handle scopes.

ic

Inline-cache runtime: property load/store fast paths and call-site tracking. Inline-cache (IC) runtime for the Stator VM.

inspector

Chrome DevTools Protocol (CDP) WebSocket inspector server and sampling CPU profiler. Chrome DevTools Protocol (CDP) inspector interface.

interpreter

Bytecode interpreter: fetch-decode-dispatch loop and activation frame. Bytecode interpreter for the Stator VM.

objects

JavaScript value representation and heap object types.

parser

JavaScript parser infrastructure (lexer and AST node definitions). JavaScript parser infrastructure.

platform

Platform abstraction for embedder-provided task scheduling and timing. Platform abstraction: exposes engine hooks (task scheduling, timers) for embedder customisation.

sandbox

Memory sandbox: virtual-address range reservation, pointer bounds checking, and external pointer table for non-sandbox memory. Memory sandbox for Stator heap isolation.

snapshot

Startup snapshot: binary serialization and deserialization of heap state. Startup snapshot — binary serialization and deserialization of heap state.

wasm

WebAssembly backend: engine, module, and instance wrappers (Wasmtime). WebAssembly backend for the Stator engine.

zone

Bump-pointer region allocator for compiler temporaries. Zone allocator for compiler temporaries.