sim-codec-javascript 0.1.0

Bounded, lossless ECMAScript 2026 source frontend for SIM
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48

//! Bounded, lossless ECMAScript 2026 Script and Module frontend.
//!
//! The public model is deliberately neutral syntax data. It has no compiler IR,
//! runtime, TypeScript, Shape, or kernel dependency. Parser extensions can wrap
//! [`Node`] and attach their own [`Origin`] without changing JavaScript syntax.
//!
//! The frozen downstream extension seam is exactly [`Token`], [`SyntaxTree`],
//! [`Node`], [`Origin`], and [`JavascriptBuilder`]. It carries syntax and
//! lowering data only; TypeScript policy remains a one-way downstream concern.

#![forbid(unsafe_code)]
#![deny(missing_docs)]

mod codec;
mod lexer;
mod lower;
mod parser;
mod types;

pub use codec::{JavascriptCodec, JavascriptCodecLib};
pub use lexer::{tokenize, tokenize_with_limits};
pub use lower::{
    JavascriptBuilder, decode_javascript, decode_javascript_located, decode_javascript_tree,
    encode_javascript, lower_javascript,
};
pub use parser::{parse_module, parse_module_with_limits, parse_script, parse_script_with_limits};
pub use types::{
    Asi, Diagnostic, DiagnosticCode, Goal, LexicalGoal, Limits, Node, NodeKind, Origin, Span,
    SyntaxTree, Token, TokenKind,
};

/// Frozen ECMA-262 edition.
pub const ECMA262_EDITION: &str = "ECMA-262, 17th edition (ECMAScript 2026)";
/// Immutable specification authority used by this frontend.
pub const ECMA262_AUTHORITY: &str = "https://tc39.es/ecma262/2026/multipage/";
/// Date on which the edition identity and grammar inventory were frozen.
pub const ECMA262_FROZEN_ON: &str = "2026-08-01";
/// Frozen Test262 evidence corpus revision. Test262 is an oracle, not a dependency.
pub const TEST262_REVISION: &str = "tc39/test262@main as observed 2026-08-01";
/// SHA-256 of the checked source corpus manifest.
pub const CORPUS_MANIFEST_SHA256: &str =
    "88b15b687f3741ba7c0145d1e2f09e05f0b1d8bf95656f257656fe3aefe416da";

/// Stable local id used before a host assigns `codec/javascript` an id.
pub const JAVASCRIPT_CODEC_ID: sim_kernel::CodecId = sim_kernel::CodecId(0x4a_53_00_00);

#[cfg(test)]
mod tests;