@pyreon/compiler 0.13.1 → 0.15.0

package/README.md

@@ -52,18 +52,28 @@ const App = () => <div>{_$h0}</div>
 
 ## API
 
-- **`transformJSX(code: string, filename?: string): TransformResult`** -- Transforms JSX source code. Returns an object with the transformed `code` string.
+- **`transformJSX(code, filename?, options?): TransformResult`** -- Transforms JSX source code. Uses the Rust native binary when available, falls back to JS.
+- **`transformJSX_JS(code, filename?, options?): TransformResult`** -- JS-only transform (bypasses native binary). Useful for debugging or cross-backend testing.
 
 ### Types
 
-- **`TransformResult`** -- `{ code: string }` -- The output of a transform pass.
+- **`TransformResult`** -- `{ code: string; usesTemplates?: boolean; warnings: CompilerWarning[] }`
+- **`TransformOptions`** -- `{ ssr?: boolean }` -- Set `ssr: true` to skip `_tpl()` template emission for server-side rendering.
+
+## Architecture
+
+**Dual-backend**: Rust native binary (napi-rs, 3.7-8.9x faster) with automatic JS fallback.
+
+- **Rust path** (`native/`): full reactive pass using `oxc_parser`/`oxc_ast` Rust crates directly. Zero JSON serialization, zero JS AST traversal. Single-pass recursive walk with cached analysis.
+- **JS fallback** (`src/jsx.ts`): uses `oxc-parser` (Rust NAPI binding) for parsing + JS reactive pass. Activated automatically when the native binary isn't available.
+- **Auto-detection**: `transformJSX()` loads the native binary via `createRequire` (ESM-safe), falls back per-call with try/catch.
 
 ## Implementation Notes
 
-- Uses the TypeScript parser for AST positions and magic-string for source replacements.
 - Props named `key` and `ref` are never wrapped.
 - Props matching `on[A-Z]*` (event handlers) are never wrapped.
-- No extra runtime dependencies beyond TypeScript (already a dev dependency).
+- Prop-derived variable resolution is fully AST-based — walks `IdentifierReference` nodes, never scans source text.
+- 527 tests: 347 original + 180 cross-backend equivalence tests (Unicode, TypeScript syntax, control flow, string collision resistance).
 
 ## License
 

package/lib/analysis/index.js.html

@@ -5386,7 +5386,7 @@ var drawChart = (function (exports) {
   </script>
   <script>
     /*<!--*/
-    const data = {"version":2,"tree":{"name":"root","children":[{"name":"index.js","children":[{"name":"src","children":[{"uid":"75ad5d2d-1","name":"jsx.ts"},{"uid":"75ad5d2d-3","name":"project-scanner.ts"},{"uid":"75ad5d2d-5","name":"react-intercept.ts"},{"uid":"75ad5d2d-7","name":"index.ts"}]}]}],"isRoot":true},"nodeParts":{"75ad5d2d-1":{"renderedLength":37221,"gzipLength":10092,"brotliLength":0,"metaUid":"75ad5d2d-0"},"75ad5d2d-3":{"renderedLength":4762,"gzipLength":1730,"brotliLength":0,"metaUid":"75ad5d2d-2"},"75ad5d2d-5":{"renderedLength":27692,"gzipLength":6920,"brotliLength":0,"metaUid":"75ad5d2d-4"},"75ad5d2d-7":{"renderedLength":0,"gzipLength":0,"brotliLength":0,"metaUid":"75ad5d2d-6"}},"nodeMetas":{"75ad5d2d-0":{"id":"/src/jsx.ts","moduleParts":{"index.js":"75ad5d2d-1"},"imported":[{"uid":"75ad5d2d-8"}],"importedBy":[{"uid":"75ad5d2d-6"}]},"75ad5d2d-2":{"id":"/src/project-scanner.ts","moduleParts":{"index.js":"75ad5d2d-3"},"imported":[{"uid":"75ad5d2d-9"},{"uid":"75ad5d2d-10"}],"importedBy":[{"uid":"75ad5d2d-6"}]},"75ad5d2d-4":{"id":"/src/react-intercept.ts","moduleParts":{"index.js":"75ad5d2d-5"},"imported":[{"uid":"75ad5d2d-8"}],"importedBy":[{"uid":"75ad5d2d-6"}]},"75ad5d2d-6":{"id":"/src/index.ts","moduleParts":{"index.js":"75ad5d2d-7"},"imported":[{"uid":"75ad5d2d-0"},{"uid":"75ad5d2d-2"},{"uid":"75ad5d2d-4"}],"importedBy":[],"isEntry":true},"75ad5d2d-8":{"id":"typescript","moduleParts":{},"imported":[],"importedBy":[{"uid":"75ad5d2d-0"},{"uid":"75ad5d2d-4"}]},"75ad5d2d-9":{"id":"node:fs","moduleParts":{},"imported":[],"importedBy":[{"uid":"75ad5d2d-2"}]},"75ad5d2d-10":{"id":"node:path","moduleParts":{},"imported":[],"importedBy":[{"uid":"75ad5d2d-2"}]}},"env":{"rollup":"4.23.0"},"options":{"gzip":true,"brotli":false,"sourcemap":false}};
+    const data = {"version":2,"tree":{"name":"root","children":[{"name":"index.js","children":[{"name":"src","children":[{"uid":"7624ee76-1","name":"event-names.ts"},{"uid":"7624ee76-3","name":"jsx.ts"},{"uid":"7624ee76-5","name":"project-scanner.ts"},{"uid":"7624ee76-7","name":"react-intercept.ts"},{"uid":"7624ee76-9","name":"pyreon-intercept.ts"},{"uid":"7624ee76-11","name":"test-audit.ts"},{"uid":"7624ee76-13","name":"index.ts"}]}]}],"isRoot":true},"nodeParts":{"7624ee76-1":{"renderedLength":2941,"gzipLength":1335,"brotliLength":0,"metaUid":"7624ee76-0"},"7624ee76-3":{"renderedLength":43854,"gzipLength":10520,"brotliLength":0,"metaUid":"7624ee76-2"},"7624ee76-5":{"renderedLength":4762,"gzipLength":1730,"brotliLength":0,"metaUid":"7624ee76-4"},"7624ee76-7":{"renderedLength":27698,"gzipLength":6923,"brotliLength":0,"metaUid":"7624ee76-6"},"7624ee76-9":{"renderedLength":20090,"gzipLength":6573,"brotliLength":0,"metaUid":"7624ee76-8"},"7624ee76-11":{"renderedLength":13163,"gzipLength":5058,"brotliLength":0,"metaUid":"7624ee76-10"},"7624ee76-13":{"renderedLength":0,"gzipLength":0,"brotliLength":0,"metaUid":"7624ee76-12"}},"nodeMetas":{"7624ee76-0":{"id":"/src/event-names.ts","moduleParts":{"index.js":"7624ee76-1"},"imported":[],"importedBy":[{"uid":"7624ee76-2"}]},"7624ee76-2":{"id":"/src/jsx.ts","moduleParts":{"index.js":"7624ee76-3"},"imported":[{"uid":"7624ee76-14"},{"uid":"7624ee76-15"},{"uid":"7624ee76-16"},{"uid":"7624ee76-17"},{"uid":"7624ee76-0"}],"importedBy":[{"uid":"7624ee76-12"}]},"7624ee76-4":{"id":"/src/project-scanner.ts","moduleParts":{"index.js":"7624ee76-5"},"imported":[{"uid":"7624ee76-18"},{"uid":"7624ee76-17"}],"importedBy":[{"uid":"7624ee76-12"}]},"7624ee76-6":{"id":"/src/react-intercept.ts","moduleParts":{"index.js":"7624ee76-7"},"imported":[{"uid":"7624ee76-19"}],"importedBy":[{"uid":"7624ee76-12"}]},"7624ee76-8":{"id":"/src/pyreon-intercept.ts","moduleParts":{"index.js":"7624ee76-9"},"imported":[{"uid":"7624ee76-19"}],"importedBy":[{"uid":"7624ee76-12"}]},"7624ee76-10":{"id":"/src/test-audit.ts","moduleParts":{"index.js":"7624ee76-11"},"imported":[{"uid":"7624ee76-18"},{"uid":"7624ee76-17"}],"importedBy":[{"uid":"7624ee76-12"}]},"7624ee76-12":{"id":"/src/index.ts","moduleParts":{"index.js":"7624ee76-13"},"imported":[{"uid":"7624ee76-2"},{"uid":"7624ee76-4"},{"uid":"7624ee76-6"},{"uid":"7624ee76-8"},{"uid":"7624ee76-10"}],"importedBy":[],"isEntry":true},"7624ee76-14":{"id":"oxc-parser","moduleParts":{},"imported":[],"importedBy":[{"uid":"7624ee76-2"}]},"7624ee76-15":{"id":"node:module","moduleParts":{},"imported":[],"importedBy":[{"uid":"7624ee76-2"}]},"7624ee76-16":{"id":"node:url","moduleParts":{},"imported":[],"importedBy":[{"uid":"7624ee76-2"}]},"7624ee76-17":{"id":"node:path","moduleParts":{},"imported":[],"importedBy":[{"uid":"7624ee76-2"},{"uid":"7624ee76-4"},{"uid":"7624ee76-10"}]},"7624ee76-18":{"id":"node:fs","moduleParts":{},"imported":[],"importedBy":[{"uid":"7624ee76-4"},{"uid":"7624ee76-10"}]},"7624ee76-19":{"id":"typescript","moduleParts":{},"imported":[],"importedBy":[{"uid":"7624ee76-6"},{"uid":"7624ee76-8"}]}},"env":{"rollup":"4.23.0"},"options":{"gzip":true,"brotli":false,"sourcemap":false}};
 
     const run = () => {
       const width = window.innerWidth;