@zenithbuild/compiler 0.5.0-beta.2.3

package/COMPILER_JS_BRIDGE_CONTRACT.md

@@ -0,0 +1,32 @@
+# Zenith Compiler JS Bridge Contract (V0)
+
+Status: FROZEN (V0)
+
+## Identity
+
+`@zenithbuild/compiler` is a deterministic Rust execution bridge.
+
+## Allowed Responsibilities
+
+- Invoke the Rust compiler binary with deterministic arguments.
+- Parse Rust compiler JSON stdout.
+- Throw deterministic errors on non-zero exit or invalid JSON output.
+
+## Explicit Non-Responsibilities
+
+- It does not parse AST.
+- It does not transform IR.
+- It does not contain compiler logic.
+- It does not import other Zenith layers.
+
+## Explicit Prohibitions
+
+- No `eval`.
+- No browser globals.
+- No dynamic imports.
+- No bundler/runtime knowledge.
+- No CLI orchestration logic.
+
+## Boundary
+
+This package only invokes the Rust binary and returns parsed JSON.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Zenith Team
+
+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,33 @@
+# @zenithbuild/compiler 🏗️
+
+> **⚠️ Internal API:** This package is an internal implementation detail of the Zenith framework. It is not intended for public use and its API may break without warning. Please use `@zenithbuild/core` instead.
+
+
+The Iron Heart of the Zenith framework. High-performance native compiler and build-time architect.
+
+## Overview
+
+@zenithbuild/compiler owns everything related to structure, wiring, and validation. It is a coordinated companion to `@zenithbuild/core`.
+
+### Core Responsibilities
+- **Parsing**: Native AST parsing of `.zen` files (Rust).
+- **Transformation**: Lowering templates to optimized execution plans.
+- **Dependency Management**: Compile-time resolution of imports and reactive graphs.
+- **CSS Engine**: High-speed CSS compilation and Tailwind integration.
+- **Bundle Generation**: Composing the thin client runtime for the browser.
+
+## Coordinated System
+
+Zenith is built as a coordinated system. The compiler produces artifacts that the Core runtime consumes blindly.
+- **No runtime decisions**: If it can be known at compile time, the compiler decides it.
+- **Tight Coupling**: Versioned and released in lockstep with `@zenithbuild/core`.
+
+## Internal Structure
+
+- `native/`: The Rust-powered core compiler.
+- `src/parse/`: TypeScript wrappers for the native parser.
+- `src/runtime/`: logic for generating the `bundle.js` target.
+
+## License
+
+MIT

package/dist/index.js

@@ -0,0 +1,21 @@
+import { spawnSync } from 'node:child_process'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = path.dirname(__filename)
+
+export function compile(entryPath, options = {}) {
+  const bin = path.resolve(__dirname, '../target/release/zenith-compiler')
+  const args = [entryPath]
+
+  const result = spawnSync(bin, args, {
+    encoding: 'utf8'
+  })
+
+  if (result.status !== 0) {
+    throw new Error(result.stderr || 'Compiler execution failed')
+  }
+
+  return JSON.parse(result.stdout)
+}

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@zenithbuild/compiler",
+  "version": "0.5.0-beta.2.3",
+  "type": "module",
+  "main": "./dist/index.js",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "COMPILER_JS_BRIDGE_CONTRACT.md",
+    "dist/**",
+    "target/release/zenith-compiler",
+    "LICENSE",
+    "README.md",
+    "package.json"
+  ],
+  "private": false,
+  "scripts": {
+    "build": "cargo build --release",
+    "prepublishOnly": "npm run build"
+  }
+}