solid-jsx-oxc 0.1.0-alpha.1

package/binding.d.ts

@@ -0,0 +1,56 @@
+/* auto-generated by NAPI-RS */
+/* eslint-disable */
+/** Transform options exposed to JavaScript */
+export interface JsTransformOptions {
+  /**
+   * The module to import runtime helpers from
+   * @default "solid-js/web"
+   */
+  moduleName?: string
+  /**
+   * Generate mode: "dom", "ssr", or "universal"
+   * @default "dom"
+   */
+  generate?: string
+  /**
+   * Whether to enable hydration support
+   * @default false
+   */
+  hydratable?: boolean
+  /**
+   * Whether to delegate events
+   * @default true
+   */
+  delegateEvents?: boolean
+  /**
+   * Whether to wrap conditionals
+   * @default true
+   */
+  wrapConditionals?: boolean
+  /**
+   * Whether to pass context to custom elements
+   * @default true
+   */
+  contextToCustomElements?: boolean
+  /**
+   * Source filename
+   * @default "input.jsx"
+   */
+  filename?: string
+  /**
+   * Whether to generate source maps
+   * @default false
+   */
+  sourceMap?: boolean
+}
+
+/** Transform JSX source code */
+export declare function transformJsx(source: string, options?: JsTransformOptions | undefined | null): TransformResult
+
+/** Result of a transform operation */
+export interface TransformResult {
+  /** The transformed code */
+  code: string
+  /** Source map (if enabled) */
+  map?: string
+}

package/index.d.ts

@@ -0,0 +1,115 @@
+/**
+ * solid-jsx-oxc - OXC-based JSX compiler for SolidJS
+ */
+
+export interface TransformOptions {
+  /**
+   * The module to import runtime helpers from
+   * @default "solid-js/web"
+   */
+  moduleName?: string;
+
+  /**
+   * Generate mode: "dom", "ssr", or "universal"
+   * @default "dom"
+   */
+  generate?: 'dom' | 'ssr' | 'universal';
+
+  /**
+   * Whether to enable hydration support
+   * @default false
+   */
+  hydratable?: boolean;
+
+  /**
+   * Whether to delegate events
+   * @default true
+   */
+  delegateEvents?: boolean;
+
+  /**
+   * Whether to wrap conditionals
+   * @default true
+   */
+  wrapConditionals?: boolean;
+
+  /**
+   * Whether to pass context to custom elements
+   * @default true
+   */
+  contextToCustomElements?: boolean;
+
+  /**
+   * Source filename
+   * @default "input.jsx"
+   */
+  filename?: string;
+
+  /**
+   * Whether to generate source maps
+   * @default false
+   */
+  sourceMap?: boolean;
+
+  /**
+   * Built-in components that receive special handling
+   */
+  builtIns?: string[];
+}
+
+export interface TransformResult {
+  /** The transformed code */
+  code: string;
+  /** Source map (if enabled) */
+  map?: string;
+}
+
+/**
+ * Transform JSX source code
+ * @param source - The source code to transform
+ * @param options - Transform options
+ * @returns The transformed code and optional source map
+ */
+export function transform(source: string, options?: TransformOptions): TransformResult;
+
+/**
+ * Low-level transform function from the native binding.
+ * Prefers snake_case option names.
+ */
+export function transformJsx(source: string, options?: {
+  module_name?: string;
+  generate?: string;
+  hydratable?: boolean;
+  delegate_events?: boolean;
+  wrap_conditionals?: boolean;
+  context_to_custom_elements?: boolean;
+  filename?: string;
+  source_map?: boolean;
+} | null): TransformResult;
+
+export interface PresetResult {
+  options: TransformOptions;
+  transform: (source: string) => TransformResult;
+}
+
+/**
+ * Create a preset configuration (for compatibility with babel-preset-solid interface)
+ * @param context - Babel context (ignored, for compatibility)
+ * @param options - User options
+ * @returns Preset configuration with options and transform function
+ */
+export function preset(context: unknown, options?: TransformOptions): PresetResult;
+
+/**
+ * Default options matching babel-preset-solid
+ */
+export const defaultOptions: Required<Omit<TransformOptions, 'filename'>>;
+
+declare const _default: {
+  transform: typeof transform;
+  preset: typeof preset;
+  defaultOptions: typeof defaultOptions;
+  transformJsx: typeof transformJsx;
+};
+
+export default _default;

package/index.js

@@ -0,0 +1,122 @@
+/**
+ * solid-jsx-oxc - OXC-based JSX compiler for SolidJS
+ *
+ * This is the JavaScript wrapper around the Rust NAPI bindings.
+ * It provides the same interface as babel-preset-solid.
+ */
+
+// Try to load the native module
+let nativeBinding = null;
+
+// Detect platform and architecture
+const platform = process.platform;
+const arch = process.arch;
+
+// Map Node.js platform/arch to binary file suffix
+const platformMap = {
+  'darwin-arm64': 'darwin-arm64',
+  'darwin-x64': 'darwin-x64',
+  'linux-x64': 'linux-x64-gnu',
+  'linux-arm64': 'linux-arm64-gnu',
+  'win32-x64': 'win32-x64-msvc',
+  'win32-arm64': 'win32-arm64-msvc',
+};
+
+const platformKey = `${platform}-${arch}`;
+const nativeTarget = platformMap[platformKey];
+
+try {
+  if (nativeTarget) {
+    // Try platform-specific binary first
+    nativeBinding = require(`./solid-jsx-oxc.${nativeTarget}.node`);
+  } else {
+    // Fallback to generic name
+    nativeBinding = require('./solid-jsx-oxc.node');
+  }
+} catch (e) {
+  // Fallback message if native module not found
+  console.warn(`solid-jsx-oxc: Native module not found for ${platformKey}. Run \`npm run build\` to compile.`);
+  console.warn(e.message);
+}
+
+/**
+ * Default options matching babel-preset-solid
+ */
+const defaultOptions = {
+  moduleName: 'solid-js/web',
+  builtIns: [
+    'For',
+    'Show',
+    'Switch',
+    'Match',
+    'Suspense',
+    'SuspenseList',
+    'Portal',
+    'Index',
+    'Dynamic',
+    'ErrorBoundary'
+  ],
+  contextToCustomElements: true,
+  wrapConditionals: true,
+  generate: 'dom', // 'dom' | 'ssr' | 'universal'
+  hydratable: false,
+  delegateEvents: true,
+  sourceMap: false,
+};
+
+/**
+ * Transform JSX source code
+ * @param {string} source - The source code to transform
+ * @param {object} options - Transform options
+ * @returns {{ code: string, map?: string }}
+ */
+function transform(source, options = {}) {
+  if (!nativeBinding) {
+    throw new Error('solid-jsx-oxc: Native module not loaded. Ensure it is built for your platform.');
+  }
+
+  const mergedOptions = { ...defaultOptions, ...options };
+
+  // Map options to match Rust struct field names (snake_case)
+  const rustOptions = {
+    module_name: mergedOptions.moduleName,
+    generate: mergedOptions.generate,
+    hydratable: mergedOptions.hydratable,
+    delegate_events: mergedOptions.delegateEvents,
+    wrap_conditionals: mergedOptions.wrapConditionals,
+    context_to_custom_elements: mergedOptions.contextToCustomElements,
+    filename: mergedOptions.filename,
+    source_map: mergedOptions.sourceMap,
+  };
+
+  return nativeBinding.transformJsx(source, rustOptions);
+}
+
+/**
+ * Create a preset configuration (for compatibility with babel-preset-solid interface)
+ * @param {object} context - Babel context (ignored, for compatibility)
+ * @param {object} options - User options
+ * @returns {object}
+ */
+function preset(context, options = {}) {
+  const mergedOptions = { ...defaultOptions, ...options };
+
+  return {
+    // Return the options that would be passed to the transform
+    options: mergedOptions,
+
+    // The transform function
+    transform: (source) => transform(source, mergedOptions),
+  };
+}
+
+module.exports = {
+  transform,
+  preset,
+  defaultOptions,
+  // Also export the raw binding for advanced usage
+  transformJsx: nativeBinding ? nativeBinding.transformJsx : null,
+};
+
+// Also export as default for ESM compatibility
+module.exports.default = module.exports;

package/index.mjs

@@ -0,0 +1,4 @@
+// ESM wrapper for solid-jsx-oxc
+import mod from './index.js';
+export const { transform, preset, defaultOptions, transformJsx } = mod;
+export default mod;

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "solid-jsx-oxc",
+  "version": "0.1.0-alpha.1",
+  "description": "OXC-based JSX compiler for SolidJS",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "require": "./index.js",
+      "import": "./index.mjs"
+    }
+  },
+  "files": [
+    "index.js",
+    "index.mjs",
+    "index.d.ts",
+    "binding.d.ts",
+    "*.node"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ryansolid/dom-expressions"
+  },
+  "keywords": [
+    "solid",
+    "solidjs",
+    "jsx",
+    "compiler",
+    "oxc",
+    "rust",
+    "napi",
+    "rolldown"
+  ],
+  "author": "SolidJS Contributors",
+  "license": "MIT",
+  "napi": {
+    "binaryName": "solid-jsx-oxc",
+    "targets": [
+      "x86_64-apple-darwin",
+      "aarch64-apple-darwin",
+      "x86_64-unknown-linux-gnu",
+      "x86_64-pc-windows-msvc",
+      "aarch64-unknown-linux-gnu",
+      "aarch64-pc-windows-msvc"
+    ]
+  },
+  "scripts": {
+    "artifacts": "napi artifacts",
+    "build": "napi build --platform --release --features napi --no-js --dts binding.d.ts",
+    "build:debug": "napi build --platform --features napi --no-js --dts binding.d.ts",
+    "clean": "rm -f *.node",
+    "rebuild": "bun run clean && bun run build",
+    "test": "cargo test",
+    "test:js": "bun run verify",
+    "verify": "bun scripts/verify.mjs",
+    "bench": "cargo bench",
+    "release": "bun scripts/release.mjs",
+    "release:alpha": "bun scripts/release.mjs alpha",
+    "release:beta": "bun scripts/release.mjs beta",
+    "release:next": "bun scripts/release.mjs next"
+  },
+  "devDependencies": {
+    "@napi-rs/cli": "^3.0.0-alpha.69"
+  },
+  "engines": {
+    "node": ">= 18"
+  }
+}