@pyreon/compiler 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-present Vit Bokisch
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,67 @@
+# @pyreon/compiler
+
+JSX reactive transform for Pyreon. Automatically wraps dynamic expressions in reactive getters and hoists static JSX nodes to module scope.
+
+## Install
+
+```bash
+bun add @pyreon/compiler
+```
+
+## Quick Start
+
+```ts
+import { transformJSX } from "@pyreon/compiler"
+
+const result = transformJSX(`
+  const App = () => <div class={color()}>{count()}</div>
+`, "app.tsx")
+
+console.log(result.code)
+// Dynamic expressions are wrapped: {() => count()}, class={() => color()}
+// Static JSX nodes are hoisted to module scope
+```
+
+## What It Does
+
+The compiler transforms JSX expression containers and props so the Pyreon runtime receives reactive getters instead of eagerly-evaluated values.
+
+| Input | Output | Reason |
+|---|---|---|
+| `<div>{expr}</div>` | `<div>{() => expr}</div>` | Dynamic child |
+| `<div class={expr}>` | `<div class={() => expr}>` | Dynamic prop |
+| `<button onClick={fn}>` | unchanged | Event handler |
+| `<div>{() => expr}</div>` | unchanged | Already wrapped |
+| `<div>{"literal"}</div>` | unchanged | Static value |
+
+### Static Hoisting
+
+Fully static JSX subtrees inside expression containers are hoisted to module-level constants, so they are created once at module initialization rather than per-render.
+
+```ts
+// Before
+const App = () => <div>{<span>Hello</span>}</div>
+
+// After
+const _$h0 = <span>Hello</span>
+const App = () => <div>{_$h0}</div>
+```
+
+## API
+
+- **`transformJSX(code: string, filename?: string): TransformResult`** -- Transforms JSX source code. Returns an object with the transformed `code` string.
+
+### Types
+
+- **`TransformResult`** -- `{ code: string }` -- The output of a transform pass.
+
+## 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).
+
+## License
+
+MIT