@zenithbuild/compiler 0.5.0-beta.2.5 → 0.6.0

package/README.md

@@ -5,6 +5,12 @@
 
 The Iron Heart of the Zenith framework. High-performance native compiler and build-time architect.
 
+## 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`.

package/dist/index.js

@@ -5,13 +5,32 @@ import { fileURLToPath } from 'node:url'
 const __filename = fileURLToPath(import.meta.url)
 const __dirname = path.dirname(__filename)
 
-export function compile(entryPath, options = {}) {
+/**
+ * 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')
-  const args = [entryPath]
+  let args
+  let spawnOpts = { encoding: 'utf8' }
 
-  const result = spawnSync(bin, args, {
-    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
+  } else {
+    args = [entryPathOrSource]
+  }
+
+  const result = spawnSync(bin, args, spawnOpts)
 
   if (result.status !== 0) {
     throw new Error(result.stderr || 'Compiler execution failed')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zenithbuild/compiler",
-  "version": "0.5.0-beta.2.5",
+  "version": "0.6.0",
   "type": "module",
   "main": "./dist/index.js",
   "exports": {