@effectweb/compiler 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 TeleVecha contributors
+
+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,18 @@
+# @effectweb/compiler
+
+Native Rust/Oxc compiler for EffectWeb snapshot JSX.
+
+```ts
+import { defineConfig } from 'vite';
+import { snapshotCompiler } from '@effectweb/compiler/vite';
+
+export default defineConfig({ plugins: [snapshotCompiler()] });
+```
+
+Install `effectweb` and its required Effect version in the application. Set TypeScript `jsx` to `preserve` and `jsxImportSource` to `effectweb`.
+
+For direct compilation, import `compileSnapshot` from `@effectweb/compiler`; the result contains generated code, a source map, and diagnostics. The Vite plugin reports diagnostics and enables development instrumentation during serve.
+
+Requires Node.js 22.14+. Optional packages provide binaries for glibc Linux x64/arm64, macOS x64/arm64, and Windows x64. Keep optional dependencies enabled. Installation does not compile Rust. Framework contributors build from source using Rust 1.96+.
+
+See [EffectWeb](https://github.com/DerpyCrabs/EffectWeb) for authoring and development instructions.

package/dist/index.d.ts

@@ -0,0 +1 @@
+export { compileSnapshot, type SnapshotCompilerOptions, type SnapshotCompilerResult, type SnapshotDiagnostic, } from './snapshotJsx.js';

package/dist/index.js

@@ -0,0 +1 @@
+export { compileSnapshot, } from './snapshotJsx.js';

package/dist/snapshotJsx.d.ts

@@ -0,0 +1,20 @@
+export interface SnapshotDiagnostic {
+    readonly file: string;
+    readonly line: number;
+    readonly column: number;
+    readonly message: string;
+}
+export interface SnapshotCompilerOptions {
+    /** An additional public module exporting view; relative imports ending in /mvu also work. */
+    importSource?: string;
+    runtimeModule?: string;
+    development?: boolean;
+    onDiagnostic?: (diagnostic: SnapshotDiagnostic) => void;
+}
+export interface SnapshotCompilerResult {
+    readonly code: string;
+    readonly map: string | null;
+    readonly diagnostics: readonly SnapshotDiagnostic[];
+}
+/** JSX analysis and lowering run in Rust/Oxc; this boundary only transports options and results. */
+export declare function compileSnapshot(source: string, filename: string, options?: SnapshotCompilerOptions): SnapshotCompilerResult;

package/dist/snapshotJsx.js

@@ -0,0 +1,9 @@
+import { compile } from '../native.cjs';
+/** JSX analysis and lowering run in Rust/Oxc; this boundary only transports options and results. */
+export function compileSnapshot(source, filename, options = {}) {
+    const { onDiagnostic, ...nativeOptions } = { importSource: 'effectweb', ...options };
+    const result = JSON.parse(compile(source, filename, JSON.stringify(nativeOptions)));
+    for (const diagnostic of result.diagnostics)
+        onDiagnostic?.(diagnostic);
+    return result;
+}

package/dist/vite.d.ts

@@ -0,0 +1,4 @@
+import type { Plugin } from 'vite';
+import { type SnapshotCompilerOptions } from './snapshotJsx.js';
+/** Rust/Oxc lowers snapshot JSX before Vite's TypeScript pass. */
+export declare function snapshotCompiler(options?: SnapshotCompilerOptions): Plugin;

package/dist/vite.js

@@ -0,0 +1,27 @@
+import { compileSnapshot } from './snapshotJsx.js';
+/** Rust/Oxc lowers snapshot JSX before Vite's TypeScript pass. */
+export function snapshotCompiler(options = {}) {
+    let development = false;
+    return {
+        config() {
+            return { resolve: { dedupe: ['effect'] } };
+        },
+        configResolved(config) {
+            development = config.command === 'serve';
+        },
+        name: 'effectweb-jsx',
+        enforce: 'pre',
+        transform(code, id) {
+            const filename = id.split('?')[0];
+            if (!filename?.endsWith('.tsx'))
+                return;
+            const result = compileSnapshot(code, filename, {
+                ...options,
+                development,
+                onDiagnostic: options.onDiagnostic ??
+                    ((diagnostic) => this.warn(`${diagnostic.file}:${diagnostic.line}:${diagnostic.column} ${diagnostic.message}`)),
+            });
+            return { code: result.code, map: result.map };
+        },
+    };
+}

package/native.cjs

@@ -0,0 +1,23 @@
+const { existsSync } = require('node:fs');
+const { join } = require('node:path');
+const { name } = require('./package.json');
+const local = join(__dirname, 'native', 'snapshot-compiler.node');
+let suffix;
+if (existsSync(local)) suffix = 'local';
+else if (process.platform === 'linux') {
+  if (!process.report.getReport().header.glibcVersionRuntime) {
+    throw new Error(`${name} currently supports glibc Linux. musl requires a source build.`);
+  }
+  suffix = `linux-${process.arch}-gnu`;
+} else if (process.platform === 'darwin') suffix = `darwin-${process.arch}`;
+else if (process.platform === 'win32') suffix = `win32-${process.arch}-msvc`;
+else throw new Error(`${name}: unsupported platform ${process.platform}/${process.arch}`);
+try {
+  const binding = existsSync(local) ? require(local) : require(`${name}-${suffix}`);
+  exports.compile = binding.compile;
+} catch (error) {
+  throw new Error(
+    `Cannot load ${name} for ${suffix}. Install optional dependencies; framework contributors should run npm run build:compiler.`,
+    { cause: error },
+  );
+}

package/native.d.cts

@@ -0,0 +1 @@
+export function compile(source: string, filename: string, options: string): string;

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@effectweb/compiler",
+  "version": "0.1.1",
+  "description": "Native Oxc compiler and Vite plugin for effectweb",
+  "homepage": "https://github.com/DerpyCrabs/EffectWeb",
+  "bugs": {
+    "url": "https://github.com/DerpyCrabs/EffectWeb/issues"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/DerpyCrabs/EffectWeb.git",
+    "directory": "packages/compiler"
+  },
+  "files": [
+    "dist",
+    "native.cjs",
+    "native.d.cts",
+    "LICENSE",
+    "README.md"
+  ],
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./vite": {
+      "types": "./dist/vite.d.ts",
+      "import": "./dist/vite.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "vite": "*"
+  },
+  "peerDependenciesMeta": {
+    "vite": {
+      "optional": true
+    }
+  },
+  "optionalDependencies": {
+    "@effectweb/compiler-darwin-arm64": "0.1.1",
+    "@effectweb/compiler-darwin-x64": "0.1.1",
+    "@effectweb/compiler-linux-arm64-gnu": "0.1.1",
+    "@effectweb/compiler-linux-x64-gnu": "0.1.1",
+    "@effectweb/compiler-win32-x64-msvc": "0.1.1"
+  },
+  "engines": {
+    "node": ">=22.14"
+  }
+}