kataan 0.0.7

A high-performance JavaScript engine written in pure Rust. Library, C FFI, and CLI.
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
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147

name: CI

on:
  push:
    branches: [master]
  pull_request:
  schedule:
    # Nightly full Test262 conformance run (07:17 UTC — off the busy top of hour).
    - cron: "17 7 * * *"
  workflow_dispatch:

permissions:
  contents: read

env:
  CARGO_TERM_COLOR: always

jobs:
  test:
    name: Test & lint (${{ matrix.os }})
    runs-on: ${{ matrix.os }}
    strategy:
      fail-fast: false
      matrix:
        os: [ubuntu-latest, windows-latest, macos-latest]
    steps:
      - uses: actions/checkout@v6

      - name: Fetch the intl crate (path-dependency sibling)
        run: git clone --depth 1 https://github.com/KarpelesLab/intlrs.git ../unicoders

      - name: Install Rust
        uses: dtolnay/rust-toolchain@stable
        with:
          components: rustfmt, clippy

      - name: Cache
        uses: Swatinem/rust-cache@v2
        with:
          key: ${{ matrix.os }}

      - name: Format
        if: runner.os == 'Linux' # formatting is platform-independent
        # Scope to our own package: the `intl` path dependency (`../unicoders`) is
        # an upstream checkout whose formatting we do not gate on.
        run: cargo fmt --check -p kataan

      - name: Clippy (all features, warnings denied)
        run: cargo clippy --all-targets --all-features -- -D warnings

      - name: Test (all features)
        run: cargo test --all-features

  core_builds:
    name: Core / no_std builds
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6

      - name: Fetch the intl crate (path-dependency sibling)
        run: git clone --depth 1 https://github.com/KarpelesLab/intlrs.git ../unicoders

      - name: Install Rust
        uses: dtolnay/rust-toolchain@stable

      - name: Cache
        uses: Swatinem/rust-cache@v2

      # The pure language core must build with only `alloc` — no std, no host.
      - name: Build language core (alloc only)
        run: cargo build --no-default-features --features alloc

      - name: Build with regex but no host
        run: cargo build --no-default-features --features alloc,regex,intl

  c_abi:
    name: C ABI smoke test
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6

      - name: Fetch the intl crate (path-dependency sibling)
        run: git clone --depth 1 https://github.com/KarpelesLab/intlrs.git ../unicoders

      - name: Install Rust
        uses: dtolnay/rust-toolchain@stable

      - name: Cache
        uses: Swatinem/rust-cache@v2

      - name: Build the C library (static + shared)
        run: |
          cargo rustc --lib --release --features ffi --crate-type staticlib
          cargo rustc --lib --release --features ffi --crate-type cdylib

      - name: Compile and run the C smoke test
        run: |
          cc tests/ffi_smoke.c -I include target/release/libkataan.a \
             -lpthread -ldl -lm -o ffi_smoke
          ./ffi_smoke

  docs:
    name: Docs build (warnings denied)
    runs-on: ubuntu-latest
    env:
      RUSTDOCFLAGS: -D warnings -D rustdoc::broken-intra-doc-links
    steps:
      - uses: actions/checkout@v6

      - name: Fetch the intl crate (path-dependency sibling)
        run: git clone --depth 1 https://github.com/KarpelesLab/intlrs.git ../unicoders

      - name: Install Rust
        uses: dtolnay/rust-toolchain@stable

      - name: Cache
        uses: Swatinem/rust-cache@v2

      - name: cargo doc --no-deps --all-features
        run: cargo doc --no-deps --all-features

  test262_official:
    name: Test262 full conformance (nightly)
    # Heavy: runs the whole ~53k-test official corpus. Only on the nightly
    # schedule or a manual dispatch, never on every PR.
    if: github.event_name == 'schedule' || github.event_name == 'workflow_dispatch'
    runs-on: ubuntu-latest
    timeout-minutes: 45
    steps:
      - uses: actions/checkout@v6
        with:
          # Pull the pinned tc39/test262 corpus submodule (shallow).
          submodules: recursive

      - name: Fetch the intl crate (path-dependency sibling)
        run: git clone --depth 1 https://github.com/KarpelesLab/intlrs.git ../unicoders

      - name: Install Rust
        uses: dtolnay/rust-toolchain@stable

      - name: Cache
        uses: Swatinem/rust-cache@v2

      # Gates against tests/test262-status.txt: fails if any test regresses
      # (fails while not listed in the ledger). Prints the measured pass-rate.
      - name: Run the official Test262 corpus
        run: cargo test --release --test test262_official -- --ignored --nocapture