@zenithbuild/compiler 0.6.9 → 0.6.11

package/README.md

@@ -1,39 +1,12 @@
-# @zenithbuild/compiler 🏗️
+# @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.
+Internal meta package for the Zenith compiler.
 
+This package resolves the platform-specific `zenith-compiler` binary shipped by:
 
-The Iron Heart of the Zenith framework. High-performance native compiler and build-time architect.
+- `@zenithbuild/compiler-darwin-arm64`
+- `@zenithbuild/compiler-darwin-x64`
+- `@zenithbuild/compiler-linux-x64`
+- `@zenithbuild/compiler-win32-x64`
 
-## Canonical Docs
-
-- Compiler boundary: `../zenith-docs/documentation/contracts/compiler-boundary.md`
-- IR envelope: `../zenith-docs/documentation/contracts/ir-envelope.md`
-- Component script hoisting: `../zenith-docs/documentation/contracts/component-script-hoisting.md`
-
-## 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
+The JavaScript bridge remains internal and is not a public framework API.

package/dist/index.js

@@ -1,40 +1,94 @@
-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)
-
-/**
- * Compile Zenith source.
- *
- * Back-compat: compile(filePath) reads from file.
- * New mode: compile({ source, filePath }) or compile(source, filePath) uses stdin.
- *
- * @param {string|{ source: string, filePath: string }} entryPathOrSource - File path, or source string, or { source, filePath }
- * @param {string|object} [filePathOrOptions] - File path (when first arg is source string), or options (ignored)
- * @returns {object} Parsed JSON output (includes warnings array)
- */
-export function compile(entryPathOrSource, filePathOrOptions = {}) {
-  const bin = path.resolve(__dirname, '../target/release/zenith-compiler')
-  let args
-  let spawnOpts = { encoding: 'utf8' }
-
-  if (typeof entryPathOrSource === 'object' && entryPathOrSource !== null && 'source' in entryPathOrSource && 'filePath' in entryPathOrSource) {
-    args = ['--stdin', entryPathOrSource.filePath]
-    spawnOpts.input = entryPathOrSource.source
-  } else if (typeof entryPathOrSource === 'string' && typeof filePathOrOptions === 'string') {
-    args = ['--stdin', filePathOrOptions]
-    spawnOpts.input = entryPathOrSource
+// meta/index.ts
+import { existsSync } from "node:fs";
+import { createRequire } from "node:module";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { spawnSync } from "node:child_process";
+var __filename2 = fileURLToPath(import.meta.url);
+var __dirname2 = path.dirname(__filename2);
+var require2 = createRequire(import.meta.url);
+var PLATFORM_PACKAGES = {
+  "darwin-arm64": {
+    packageName: "@zenithbuild/compiler-darwin-arm64",
+    binaryName: "zenith-compiler",
+    os: "darwin",
+    arch: "arm64"
+  },
+  "darwin-x64": {
+    packageName: "@zenithbuild/compiler-darwin-x64",
+    binaryName: "zenith-compiler",
+    os: "darwin",
+    arch: "x64"
+  },
+  "linux-x64": {
+    packageName: "@zenithbuild/compiler-linux-x64",
+    binaryName: "zenith-compiler",
+    os: "linux",
+    arch: "x64"
+  },
+  "win32-x64": {
+    packageName: "@zenithbuild/compiler-win32-x64",
+    binaryName: "zenith-compiler.exe",
+    os: "win32",
+    arch: "x64"
+  }
+};
+function safeResolvePackageRoot(packageName) {
+  try {
+    return path.dirname(require2.resolve(`${packageName}/package.json`));
+  } catch {
+    return null;
+  }
+}
+function currentPlatformPackage() {
+  return PLATFORM_PACKAGES[`${process.platform}-${process.arch}`] || null;
+}
+function resolveLegacyCompilerBin() {
+  const legacyBinary = path.resolve(__dirname2, "..", "target", "release", process.platform === "win32" ? "zenith-compiler.exe" : "zenith-compiler");
+  return existsSync(legacyBinary) ? legacyBinary : null;
+}
+function resolveCompilerBin() {
+  const platformPackage = currentPlatformPackage();
+  if (platformPackage) {
+    const packageRoot = safeResolvePackageRoot(platformPackage.packageName);
+    if (packageRoot) {
+      const binaryPath = path.resolve(packageRoot, "bin", platformPackage.binaryName);
+      if (existsSync(binaryPath)) {
+        return binaryPath;
+      }
+    }
+  }
+  const legacyBinary = resolveLegacyCompilerBin();
+  if (legacyBinary) {
+    return legacyBinary;
+  }
+  const supportedPlatforms = Object.keys(PLATFORM_PACKAGES).join(", ");
+  const expectedPackage = platformPackage?.packageName || "@zenithbuild/compiler-<platform>";
+  throw new Error(`[zenith] Compiler binary not installed for ${process.platform}-${process.arch}. ` + `Reinstall @zenithbuild/compiler and ensure ${expectedPackage} is present. ` + `Supported platform packages: ${supportedPlatforms}.`);
+}
+function compile(entryPathOrSource, filePathOrOptions = {}) {
+  const bin = resolveCompilerBin();
+  let args;
+  const spawnOptions = { encoding: "utf8" };
+  if (typeof entryPathOrSource === "object" && entryPathOrSource !== null && "source" in entryPathOrSource && "filePath" in entryPathOrSource) {
+    args = ["--stdin", entryPathOrSource.filePath];
+    spawnOptions.input = entryPathOrSource.source;
+  } else if (typeof entryPathOrSource === "string" && typeof filePathOrOptions === "string") {
+    args = ["--stdin", filePathOrOptions];
+    spawnOptions.input = entryPathOrSource;
   } else {
-    args = [entryPathOrSource]
+    args = [String(entryPathOrSource)];
+  }
+  const result = spawnSync(bin, args, spawnOptions);
+  if (result.error) {
+    throw new Error(result.error.message);
   }
-
-  const result = spawnSync(bin, args, spawnOpts)
-
   if (result.status !== 0) {
-    throw new Error(result.stderr || 'Compiler execution failed')
+    throw new Error(result.stderr || "Compiler execution failed");
   }
-
-  return JSON.parse(result.stdout)
+  return JSON.parse(result.stdout);
 }
+export {
+  resolveCompilerBin,
+  compile
+};

package/package.json

@@ -1,18 +1,16 @@
 {
   "name": "@zenithbuild/compiler",
-  "version": "0.6.9",
+  "version": "0.6.11",
   "type": "module",
   "main": "./dist/index.js",
   "exports": {
-    ".": "./dist/index.js"
+    ".": "./dist/index.js",
+    "./package.json": "./package.json"
   },
   "files": [
     "dist",
-    "COMPILER_JS_BRIDGE_CONTRACT.md",
-    "dist/**",
-    "target/release/zenith-compiler",
-    "LICENSE",
     "README.md",
+    "LICENSE",
     "package.json"
   ],
   "repository": {
@@ -26,7 +24,17 @@
   "homepage": "https://github.com/zenithbuild/framework#readme",
   "private": false,
   "scripts": {
-    "build": "cargo build --release",
+    "build": "rm -rf dist && bun build meta/index.ts --outdir dist --target node --format esm && node ../../scripts/stage-compiler-platform-package.mjs",
     "prepublishOnly": "npm run build"
+  },
+  "optionalDependencies": {
+    "@zenithbuild/compiler-darwin-arm64": "0.6.11",
+    "@zenithbuild/compiler-darwin-x64": "0.6.11",
+    "@zenithbuild/compiler-linux-x64": "0.6.11",
+    "@zenithbuild/compiler-win32-x64": "0.6.11"
+  },
+  "devDependencies": {
+    "@types/node": "latest",
+    "typescript": "^5"
   }
 }

package/COMPILER_JS_BRIDGE_CONTRACT.md

@@ -1,32 +0,0 @@
-# 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.