Add experimental TSRX compiler frontends by ryansolid · Pull Request #3086 · solidjs/solid

ryansolid · 2026-08-28T04:33:12Z

Summary

add first-class .tsrx syntax routing to both @solidjs/babel-plugin and @solidjs/compiler
parse authored JS/TS leaves once and lower TSRX semantics directly into Oxc AST before the shared Solid JSX transforms
lower statement containers, control flow, dynamic tags, scoped styles, and compiler-generated deferred bindings with Babel/native parity coverage
reject authored lazy destructuring (&{ ... } / &[ ... ]) so Solid property and accessor reads remain explicit
provide authored source maps plus a compiler-owned typecheck projection with exact editor mappings and incomplete-snapshot recovery
compose lowered .tsrx modules with Solid's function-level \"use server\" transform while preserving path-stable IDs

Vite integration: solidjs/solid-vite-plugin#333

Test plan

pnpm --filter @solidjs/babel-plugin test
compiler Rust tests with default, no-default, and TSRX-only feature configurations
compiler JavaScript suite: 5,803 passed, 28 intentionally skipped
Clippy with warnings denied across compiler feature configurations
full Babel/native and cross-mode parity ratchets
focused TSRX runtime, typecheck projection, source-map, recovery, directive, and scoped-style coverage

Release plan

Ready for review as an RC.6 candidate. The branch is merged with current next; final release inclusion remains contingent on repository CI and maintainer review.

Made with Cursor

.tsrx sources desugar TSRX constructs into the shared Solid JSX lowering in @solidjs/babel-plugin (via @tsrx/core) and @solidjs/compiler (via a pinned oxc-tsrx text projection), with byte-parity enforced by the fixture corpus and parity harness. Also fixes DOM insert markers to ride the following sibling's declared walk variable, matching Babel. Co-authored-by: Cursor <cursoragent@cursor.com>

Exercise Unicode spans, lexical traps, nested backend lowering, accessor scope, and early-error constraints so the shared corpus catches frontend drift. Rewrite lazy binding update targets in the native compiler to match the Babel frontend. Co-authored-by: Cursor <cursoragent@cursor.com>

Execute the same authored fixtures through Babel and Oxc against the real Solid DOM and SSR runtimes, asserting reactive updates, keyed identity, events, lazy writes, branches, and empty fallbacks independently of code-generation parity. Co-authored-by: Cursor <cursoragent@cursor.com>

Add full lazy destructuring semantics and close parser parity gaps so both frontends support expression containers, accessor-backed patterns, and lazy arrow parameters. Co-authored-by: Cursor <cursoragent@cursor.com>

Compile TSRX style blocks into parity-tested scoped CSS sidecars across Babel and native pipelines without runtime helpers. Co-authored-by: Cursor <cursoragent@cursor.com>

changeset-bot · 2026-08-28T04:33:20Z

🦋 Changeset detected

Latest commit: 59e1502

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 11 packages

Name	Type
@solidjs/compiler	Minor
@solidjs/babel-plugin	Minor
test-integration	Patch
@solidjs/diagnostics	Minor
@solidjs/element	Minor
@solidjs/h	Minor
@solidjs/html	Minor
@solidjs/signals	Minor
solid-js	Minor
@solidjs/universal	Minor
@solidjs/web	Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

github-actions · 2026-08-28T04:35:31Z

size-limit report 📦

Path	Size
signals: core floor (createSignal/Memo/Effect/Root/flush)	7.59 KB (0%)
signals: + createStore	13.22 KB (0%)
signals: + isPending/latest	9.53 KB (0%)
app: render + one signal (the simple-app floor)	10.24 KB (0%)
app: hydrating (no stores) with Show/For/Loading/Errored/lazy	16.9 KB (0%)
app: hydrating + every store primitive family	24.33 KB (0%)
app: CSR with Show/For/Loading/Errored/lazy	12.34 KB (0%)
frames: eager client consumer (frames client + transport, lazy codec)	10.6 KB (0%)

coveralls · 2026-08-28T04:37:41Z

Coverage Report for CI Build 33159014288

Warning

Build has drifted: This PR's base is out of sync with its target branch, so coverage data may include unrelated changes.
Quick fix: rebase this PR. Learn more →

Coverage remained the same at 72.216%

Details

Coverage remained the same as the base build.
Patch coverage: No coverable lines changed in this PR.
No coverage regressions found.

Uncovered Changes

No uncovered changes found.

Coverage Regressions

No coverage regressions found.

Coverage Stats


Relevant Lines:	996
Covered Lines:	767
Line Coverage:	77.01%
Relevant Branches:	782
Covered Branches:	517
Branch Coverage:	66.11%
Branches in Coverage %:	Yes
Coverage Strength:	14.64 hits per line

💛 - Coveralls

codspeed-hq · 2026-08-28T04:46:20Z

Merging this PR will not alter performance

✅ 136 untouched benchmarks
⏩ 132 skipped benchmarks¹

_{Comparing tsrx-frontend (59e1502) with next (d13b1ce)}

132 benchmarks were skipped, so the baseline results were used instead. If they were deleted from the codebase, click here and archive them to remove them from the performance reports. ↩

Allow secondary compiler passes to retain the authored TSRX path so server-function IDs stay aligned with Vite's manifest. Co-authored-by: Cursor <cursoragent@cursor.com>

Scope selectors against known elements instead of allowing unrelated selectors whenever a dynamic child is present. Co-authored-by: Cursor <cursoragent@cursor.com>

Compose Oxc mappings through exact projection ranges while leaving generated scaffolding unmapped. Co-authored-by: Cursor <cursoragent@cursor.com>

socket-security · 2026-08-28T09:22:07Z

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff	Package	Supply Chain Security	Vulnerability	Quality	Maintenance	License
	npm/@tsrx/core@0.1.63

View full report

Centralize Solid TSRX control-flow semantics for runtime and independently typecheckable projections while fixing index-only loop callbacks, authored coordinates, and embedded payload ordering. Co-authored-by: Cursor <cursoragent@cursor.com>

Replace runtime text projection and reparse with compiler-owned semantic lowering while retaining projection only for tooling output. Co-authored-by: Cursor <cursoragent@cursor.com>

Pin the compiler to the merged tooling projection fixes used by direct AST leaf loading. Co-authored-by: Cursor <cursoragent@cursor.com>

Publish fail-closed authored ranges so language tooling can use the compiler-owned typecheck projection without attributing generated helpers to user source. Co-authored-by: Cursor <cursoragent@cursor.com>

Consume the upstream parser recovery contract only in the typecheck projection and materialize generated placeholders without mapping them to authored text, while keeping runtime compilation strict. Co-authored-by: Cursor <cursoragent@cursor.com>

Keep Solid's reactive reads explicit while retaining the deferred-pattern machinery used internally by keyed loops and catch clauses. Co-authored-by: Cursor <cursoragent@cursor.com>

Resolve the parity harness conflict while retaining TSRX filename routing and the updated patch-mode matrix. Co-authored-by: Cursor <cursoragent@cursor.com>

Preserve native JSX child shape, callback setup placement, and deferred SSR child evaluation so direct lowering matches the Babel frontend after merging next. Co-authored-by: Cursor <cursoragent@cursor.com>

rc.6 publishes the TSRX compiler frontends this branch routes (solidjs/solid#3086). The workspace catalog moves to ^2.0.0-rc.6 (minimumReleaseAgeExclude extended per the existing pattern), and the plugin's @solidjs/compiler and @solidjs/babel-plugin floors move from ^2.0.0-rc.3 to ^2.0.0-rc.6 — the real requirement, since older compilers reject .tsrx outright. The published Babel frontend resolves TSRX parsing through its optional peer @tsrx/core (exact 0.1.63), so the vite-8 example installs it for the Babel half of the matrix; the native binary bundles its own frontend. Full gate green against published rc.6 (no linking): ssr 12/12 + boundary 8/8, css-matrix 82/82 + bridge 19/19, start-ssr 366/366 + http-bridge 10/10, start-client 45/45, start-env 47/47, cypress e2e 1/1, and the TSRX matrix on both compiler backends: vite-8 prod builds, vitest browser 1/1, SSR entry builds, and dev transform/CSS-sidecar/HMR/source-map/server-function smoke checks. Co-authored-by: Cursor <cursoragent@cursor.com>

ryansolid · 2026-08-28T04:33:12Z