yuku-tsrx

A Zig parser, analyzer, and code generator for .tsrx

Built as a compile-time dialect on Yuku, with a JavaScript API on top of a native addon.

src/Cart.tsrx

export function Cart({ items }): unknown @{
  const total = items.length;

  <section className="cart">
    @if (total > 0) {
      @for (const item of items; index i; key item.id) {
        <span>{i}:{item.id}</span>
      } @empty {
        <span>empty</span>
      }
    } @else {
      <span>no cart</span>
    }
    <style>.cart { display: grid; }</style>
  </section>
}

        a TSRX component, highlighted with the TSRX grammar
        tsx · module
      

The decoded program, as JSON. TSRX nodes keep their own names: JSXCodeBlock, TSRXExpression, JSXStyleElement.

the parser starts when this page loads

Measured, not claimed

These four numbers are computed from benchmarks/m6-baseline.json when this page is built, so they cannot drift from the committed report.

3.47× faster median parse than @tsrx/core 29,666 ns vs 103,075 ns per parse

33,708 parses/s median parses per second @tsrx/core: 9,702 parses/s

32.3 MB/s source parsed per second @tsrx/core: 9.3 MB/s

15% less peak memory than @tsrx/core 264.7 MB vs 310.0 MB peak RSS

yuku-tsrx29.67 µs

@tsrx/core103.08 µs

Shorter is faster. Median microseconds per parse of the same 214,751-byte input, 25 iterations, alternating order.

One measurement on one machine (Apple M5 Pro, a 224-file corpus). Your hardware will differ. MB means 1,000,000 bytes.

See the report and its caveats

A dialect on Yuku

TSRX rules are compiled into Yuku through its extension points. Yuku does the JavaScript and TypeScript work.
A real parser you can call

parse and parseModule return a TSRX AST from an ESM JavaScript API over a native addon.
An analyzer with a semantic view

analyze adds a SemanticView over references, scopes, and symbols alongside the parse result.
A code generator

generate turns a program back into source, with options for stripping, minifying, quotes, and comments.
TSRX node names, not a lowering

The AST carries JSXCodeBlock, TSRXExpression, JSXStyleElement and the rest by name.
No fork

A Yuku built without a dialect compiles to exactly what it did before. Nothing upstream is copied or patched.

Built on the Yuku seam in PR #164

yuku-tsrx is a dialect adapter that plugs into the extension points Yuku exposes. It is an independent project and nothing here is a fork of Yuku.

Read how the seam is used

yuku-tsrx

Measured, not claimed

A dialect on Yuku

A real parser you can call

An analyzer with a semantic view

A code generator

TSRX node names, not a lowering

No fork

Built on the Yuku seam in PR #164