macroforge 0.1.40 → 0.1.41

package/index.d.ts

@@ -700,6 +700,26 @@ export declare function __macroforgeRunSerialize(contextJson: string): string
  */
 export declare function checkSyntax(code: string, filepath: string): SyntaxCheckResult
 
+/**
+ * Clears the configuration cache.
+ *
+ * This is useful for testing to ensure each test starts with a clean state.
+ * In production, clearing the cache will force configs to be re-parsed on next access.
+ *
+ * # Example
+ *
+ * ```javascript
+ * const { clearConfigCache, loadConfig } = require('macroforge-ts');
+ *
+ * // Clear cache before each test
+ * clearConfigCache();
+ *
+ * // Now load a fresh config
+ * const result = loadConfig(configContent, configPath);
+ * ```
+ */
+export declare function clearConfigCache(): void
+
 /**
  * Entry for a registered decorator in the manifest.
  *
@@ -769,6 +789,24 @@ export interface ExpandOptions {
    * ```
    */
   externalDecoratorModules?: Array<string>
+  /**
+   * Path to a previously loaded config file.
+   *
+   * When provided, the expansion will use the cached configuration
+   * (including foreign types) from this path. The config must have been
+   * previously loaded via [`load_config`].
+   *
+   * # Example
+   *
+   * ```javascript
+   * // First, load the config
+   * const configResult = loadConfig(configContent, configPath);
+   *
+   * // Then use it during expansion
+   * expandSync(code, filepath, { configPath });
+   * ```
+   */
+  configPath?: string
 }
 
 /**
@@ -901,6 +939,59 @@ export interface JsDiagnostic {
   category?: string
 }
 
+/**
+ * Load and parse a macroforge configuration file.
+ *
+ * Parses a `macroforge.config.js/ts` file and caches the result for use
+ * during macro expansion. The configuration includes both simple settings
+ * (like `keepDecorators`) and foreign type handlers.
+ *
+ * # Arguments
+ *
+ * * `content` - The raw content of the configuration file
+ * * `filepath` - Path to the configuration file (used to determine syntax and as cache key)
+ *
+ * # Returns
+ *
+ * A [`LoadConfigResult`] containing the parsed configuration summary.
+ *
+ * # Example
+ *
+ * ```javascript
+ * import { loadConfig, expandSync } from 'macroforge';
+ * import fs from 'fs';
+ *
+ * const configPath = 'macroforge.config.js';
+ * const configContent = fs.readFileSync(configPath, 'utf-8');
+ *
+ * // Load and cache the configuration
+ * const result = loadConfig(configContent, configPath);
+ * console.log(`Loaded config with ${result.foreignTypeCount} foreign types`);
+ *
+ * // The config is now cached and will be used by expandSync
+ * const expanded = expandSync(code, filepath, { configPath });
+ * ```
+ */
+export declare function loadConfig(content: string, filepath: string): LoadConfigResult
+
+/**
+ * Result of loading a macroforge configuration file.
+ *
+ * Returned by [`load_config`] after parsing a `macroforge.config.js/ts` file.
+ */
+export interface LoadConfigResult {
+  /** Whether to preserve `@derive` decorators in the output code. */
+  keepDecorators: boolean
+  /** Whether to generate a convenience const for non-class types. */
+  generateConvenienceConst: boolean
+  /** Whether the config has any foreign type handlers defined. */
+  hasForeignTypes: boolean
+  /** Number of foreign types configured. */
+  foreignTypeCount: number
+  /** Return types mode: "vanilla", "custom", or "effect". */
+  returnTypes: string
+}
+
 /**
  * A diagnostic message produced during macro expansion.
  *
@@ -1060,6 +1151,11 @@ export interface ProcessFileOptions {
    * See [`ExpandOptions::external_decorator_modules`] for details.
    */
   externalDecoratorModules?: Array<string>
+  /**
+   * Path to a previously loaded config file (for foreign types lookup).
+   * See [`ExpandOptions::config_path`] for details.
+   */
+  configPath?: string
 }
 
 /**

package/index.js

@@ -77,8 +77,8 @@ function requireNative() {
       try {
         const binding = require('@macroforge/bin-android-arm64')
         const bindingPackageVersion = require('@macroforge/bin-android-arm64/package.json').version
-        if (bindingPackageVersion !== '0.1.40' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.40 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.41' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.41 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -93,8 +93,8 @@ function requireNative() {
       try {
         const binding = require('@macroforge/bin-android-arm-eabi')
         const bindingPackageVersion = require('@macroforge/bin-android-arm-eabi/package.json').version
-        if (bindingPackageVersion !== '0.1.40' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.40 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.41' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.41 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -114,8 +114,8 @@ function requireNative() {
       try {
         const binding = require('@macroforge/bin-win32-x64-gnu')
         const bindingPackageVersion = require('@macroforge/bin-win32-x64-gnu/package.json').version
-        if (bindingPackageVersion !== '0.1.40' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.40 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.41' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.41 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -130,8 +130,8 @@ function requireNative() {
       try {
         const binding = require('@macroforge/bin-win32-x64-msvc')
         const bindingPackageVersion = require('@macroforge/bin-win32-x64-msvc/package.json').version
-        if (bindingPackageVersion !== '0.1.40' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.40 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.41' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.41 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -147,8 +147,8 @@ function requireNative() {
       try {
         const binding = require('@macroforge/bin-win32-ia32-msvc')
         const bindingPackageVersion = require('@macroforge/bin-win32-ia32-msvc/package.json').version
-        if (bindingPackageVersion !== '0.1.40' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.40 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.41' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.41 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -163,8 +163,8 @@ function requireNative() {
       try {
         const binding = require('@macroforge/bin-win32-arm64-msvc')
         const bindingPackageVersion = require('@macroforge/bin-win32-arm64-msvc/package.json').version
-        if (bindingPackageVersion !== '0.1.40' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.40 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.41' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.41 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -182,8 +182,8 @@ function requireNative() {
     try {
       const binding = require('@macroforge/bin-darwin-universal')
       const bindingPackageVersion = require('@macroforge/bin-darwin-universal/package.json').version
-      if (bindingPackageVersion !== '0.1.40' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-        throw new Error(`Native binding package version mismatch, expected 0.1.40 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      if (bindingPackageVersion !== '0.1.41' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+        throw new Error(`Native binding package version mismatch, expected 0.1.41 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
       }
       return binding
     } catch (e) {
@@ -198,8 +198,8 @@ function requireNative() {
       try {
         const binding = require('@macroforge/bin-darwin-x64')
         const bindingPackageVersion = require('@macroforge/bin-darwin-x64/package.json').version
-        if (bindingPackageVersion !== '0.1.40' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.40 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.41' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.41 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -214,8 +214,8 @@ function requireNative() {
       try {
         const binding = require('@macroforge/bin-darwin-arm64')
         const bindingPackageVersion = require('@macroforge/bin-darwin-arm64/package.json').version
-        if (bindingPackageVersion !== '0.1.40' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.40 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.41' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.41 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -234,8 +234,8 @@ function requireNative() {
       try {
         const binding = require('@macroforge/bin-freebsd-x64')
         const bindingPackageVersion = require('@macroforge/bin-freebsd-x64/package.json').version
-        if (bindingPackageVersion !== '0.1.40' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.40 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.41' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.41 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -250,8 +250,8 @@ function requireNative() {
       try {
         const binding = require('@macroforge/bin-freebsd-arm64')
         const bindingPackageVersion = require('@macroforge/bin-freebsd-arm64/package.json').version
-        if (bindingPackageVersion !== '0.1.40' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.40 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.41' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.41 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -271,8 +271,8 @@ function requireNative() {
         try {
           const binding = require('@macroforge/bin-linux-x64-musl')
           const bindingPackageVersion = require('@macroforge/bin-linux-x64-musl/package.json').version
-          if (bindingPackageVersion !== '0.1.40' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.40 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.41' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.41 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -287,8 +287,8 @@ function requireNative() {
         try {
           const binding = require('@macroforge/bin-linux-x64-gnu')
           const bindingPackageVersion = require('@macroforge/bin-linux-x64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.1.40' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.40 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.41' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.41 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -305,8 +305,8 @@ function requireNative() {
         try {
           const binding = require('@macroforge/bin-linux-arm64-musl')
           const bindingPackageVersion = require('@macroforge/bin-linux-arm64-musl/package.json').version
-          if (bindingPackageVersion !== '0.1.40' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.40 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.41' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.41 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -321,8 +321,8 @@ function requireNative() {
         try {
           const binding = require('@macroforge/bin-linux-arm64-gnu')
           const bindingPackageVersion = require('@macroforge/bin-linux-arm64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.1.40' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.40 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.41' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.41 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -339,8 +339,8 @@ function requireNative() {
         try {
           const binding = require('@macroforge/bin-linux-arm-musleabihf')
           const bindingPackageVersion = require('@macroforge/bin-linux-arm-musleabihf/package.json').version
-          if (bindingPackageVersion !== '0.1.40' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.40 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.41' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.41 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -355,8 +355,8 @@ function requireNative() {
         try {
           const binding = require('@macroforge/bin-linux-arm-gnueabihf')
           const bindingPackageVersion = require('@macroforge/bin-linux-arm-gnueabihf/package.json').version
-          if (bindingPackageVersion !== '0.1.40' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.40 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.41' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.41 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -373,8 +373,8 @@ function requireNative() {
         try {
           const binding = require('@macroforge/bin-linux-loong64-musl')
           const bindingPackageVersion = require('@macroforge/bin-linux-loong64-musl/package.json').version
-          if (bindingPackageVersion !== '0.1.40' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.40 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.41' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.41 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -389,8 +389,8 @@ function requireNative() {
         try {
           const binding = require('@macroforge/bin-linux-loong64-gnu')
           const bindingPackageVersion = require('@macroforge/bin-linux-loong64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.1.40' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.40 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.41' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.41 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -407,8 +407,8 @@ function requireNative() {
         try {
           const binding = require('@macroforge/bin-linux-riscv64-musl')
           const bindingPackageVersion = require('@macroforge/bin-linux-riscv64-musl/package.json').version
-          if (bindingPackageVersion !== '0.1.40' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.40 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.41' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.41 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -423,8 +423,8 @@ function requireNative() {
         try {
           const binding = require('@macroforge/bin-linux-riscv64-gnu')
           const bindingPackageVersion = require('@macroforge/bin-linux-riscv64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.1.40' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.40 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.41' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.41 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -440,8 +440,8 @@ function requireNative() {
       try {
         const binding = require('@macroforge/bin-linux-ppc64-gnu')
         const bindingPackageVersion = require('@macroforge/bin-linux-ppc64-gnu/package.json').version
-        if (bindingPackageVersion !== '0.1.40' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.40 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.41' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.41 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -456,8 +456,8 @@ function requireNative() {
       try {
         const binding = require('@macroforge/bin-linux-s390x-gnu')
         const bindingPackageVersion = require('@macroforge/bin-linux-s390x-gnu/package.json').version
-        if (bindingPackageVersion !== '0.1.40' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.40 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.41' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.41 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -476,8 +476,8 @@ function requireNative() {
       try {
         const binding = require('@macroforge/bin-openharmony-arm64')
         const bindingPackageVersion = require('@macroforge/bin-openharmony-arm64/package.json').version
-        if (bindingPackageVersion !== '0.1.40' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.40 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.41' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.41 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -492,8 +492,8 @@ function requireNative() {
       try {
         const binding = require('@macroforge/bin-openharmony-x64')
         const bindingPackageVersion = require('@macroforge/bin-openharmony-x64/package.json').version
-        if (bindingPackageVersion !== '0.1.40' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.40 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.41' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.41 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -508,8 +508,8 @@ function requireNative() {
       try {
         const binding = require('@macroforge/bin-openharmony-arm')
         const bindingPackageVersion = require('@macroforge/bin-openharmony-arm/package.json').version
-        if (bindingPackageVersion !== '0.1.40' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.40 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.41' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.41 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -592,7 +592,9 @@ module.exports.__macroforgeRunPartialEq = nativeBinding.__macroforgeRunPartialEq
 module.exports.__macroforgeRunPartialOrd = nativeBinding.__macroforgeRunPartialOrd
 module.exports.__macroforgeRunSerialize = nativeBinding.__macroforgeRunSerialize
 module.exports.checkSyntax = nativeBinding.checkSyntax
+module.exports.clearConfigCache = nativeBinding.clearConfigCache
 module.exports.Derive = nativeBinding.Derive
 module.exports.expandSync = nativeBinding.expandSync
+module.exports.loadConfig = nativeBinding.loadConfig
 module.exports.parseImportSources = nativeBinding.parseImportSources
 module.exports.transformSync = nativeBinding.transformSync

package/js/utils/effect.ts

@@ -0,0 +1,43 @@
+/**
+ * # Macroforge Effect Utils Module
+ *
+ * This module re-exports Effect library types for use in generated macro code
+ * when `returnTypes: 'effect'` is configured.
+ *
+ * ## Exit<E, A>
+ *
+ * Represents the result of a computation that may fail.
+ * Used by the `Deserialize` macro for validation errors.
+ *
+ * ```typescript
+ * import { Exit } from "macroforge/utils/effect";
+ *
+ * const result = User.fromStringifiedJSON(json);
+ * if (Exit.isSuccess(result)) {
+ *   const user = result.value;
+ * } else {
+ *   console.error(result.cause); // Array of field errors
+ * }
+ * ```
+ *
+ * ## Option<A>
+ *
+ * Represents an optional value.
+ * Used by `PartialOrd` macro for incomparable values.
+ *
+ * ```typescript
+ * import { Option } from "macroforge/utils/effect";
+ *
+ * const cmp = user1.compareTo(user2);
+ * if (Option.isSome(cmp)) {
+ *   console.log(cmp.value); // -1, 0, or 1
+ * } else {
+ *   console.log("Values are incomparable");
+ * }
+ * ```
+ *
+ * @module macroforge/utils/effect
+ */
+
+// Re-export Exit and Option from effect for use in generated code
+export { Exit, Option } from "effect";

package/js/utils/index.d.ts

@@ -40,6 +40,73 @@
  * @module macroforge/utils
  */
 export { Result, Option } from "@rydshift/mirror/declarative";
+/**
+ * Represents a successful deserialization result.
+ * Used when `returnTypes: 'vanilla'` is configured.
+ */
+export interface DeserializeSuccess<T> {
+    readonly success: true;
+    readonly value: T;
+}
+/**
+ * Represents a failed deserialization result with field errors.
+ * Used when `returnTypes: 'vanilla'` is configured.
+ */
+export interface DeserializeFailure {
+    readonly success: false;
+    readonly errors: Array<{
+        field: string;
+        message: string;
+    }>;
+}
+/**
+ * A simple discriminated union for deserialization results.
+ * Used when `returnTypes: 'vanilla'` is configured.
+ *
+ * @example
+ * ```typescript
+ * const result = userDeserialize(json);
+ * if (result.success) {
+ *   const user = result.value;
+ * } else {
+ *   console.error(result.errors);
+ * }
+ * ```
+ */
+export type DeserializeResult<T> = DeserializeSuccess<T> | DeserializeFailure;
+/**
+ * Namespace with helper functions for working with vanilla DeserializeResult.
+ * These mirror the Result API for familiarity.
+ */
+export declare namespace DeserializeResult {
+    /**
+     * Creates a successful result.
+     */
+    function ok<T>(value: T): DeserializeResult<T>;
+    /**
+     * Creates a failed result with errors.
+     */
+    function err<T>(errors: Array<{
+        field: string;
+        message: string;
+    }>): DeserializeResult<T>;
+    /**
+     * Type guard to check if the result is successful.
+     */
+    function isOk<T>(result: DeserializeResult<T>): result is DeserializeSuccess<T>;
+    /**
+     * Type guard to check if the result is a failure.
+     */
+    function isErr<T>(result: DeserializeResult<T>): result is DeserializeFailure;
+    /**
+     * Unwraps the value or throws an error.
+     */
+    function unwrap<T>(result: DeserializeResult<T>): T;
+    /**
+     * Unwraps the value or returns a default.
+     */
+    function unwrapOr<T>(result: DeserializeResult<T>, defaultValue: T): T;
+}
 /**
  *
  *

package/js/utils/index.mjs

@@ -1,6 +1,36 @@
 // js/utils/index.ts
 import { Result, Option } from "@rydshift/mirror/declarative";
+var DeserializeResult;
+((DeserializeResult) => {
+  function ok(value) {
+    return { success: true, value };
+  }
+  DeserializeResult.ok = ok;
+  function err(errors) {
+    return { success: false, errors };
+  }
+  DeserializeResult.err = err;
+  function isOk(result) {
+    return result.success;
+  }
+  DeserializeResult.isOk = isOk;
+  function isErr(result) {
+    return !result.success;
+  }
+  DeserializeResult.isErr = isErr;
+  function unwrap(result) {
+    if (result.success)
+      return result.value;
+    throw new Error(`Deserialization failed: ${JSON.stringify(result.errors)}`);
+  }
+  DeserializeResult.unwrap = unwrap;
+  function unwrapOr(result, defaultValue) {
+    return result.success ? result.value : defaultValue;
+  }
+  DeserializeResult.unwrapOr = unwrapOr;
+})(DeserializeResult ||= {});
 export {
   Result,
-  Option
+  Option,
+  DeserializeResult
 };

package/js/utils/index.ts

@@ -43,6 +43,97 @@
 // Re-export Result and Option from @rydshift/mirror for use in generated code
 export { Result, Option } from "@rydshift/mirror/declarative";
 
+// ============================================================================
+// Vanilla Return Types
+// ============================================================================
+// These types are used when `returnTypes: 'vanilla'` is configured.
+// They provide simple discriminated unions without requiring external dependencies.
+
+/**
+ * Represents a successful deserialization result.
+ * Used when `returnTypes: 'vanilla'` is configured.
+ */
+export interface DeserializeSuccess<T> {
+  readonly success: true;
+  readonly value: T;
+}
+
+/**
+ * Represents a failed deserialization result with field errors.
+ * Used when `returnTypes: 'vanilla'` is configured.
+ */
+export interface DeserializeFailure {
+  readonly success: false;
+  readonly errors: Array<{ field: string; message: string }>;
+}
+
+/**
+ * A simple discriminated union for deserialization results.
+ * Used when `returnTypes: 'vanilla'` is configured.
+ *
+ * @example
+ * ```typescript
+ * const result = userDeserialize(json);
+ * if (result.success) {
+ *   const user = result.value;
+ * } else {
+ *   console.error(result.errors);
+ * }
+ * ```
+ */
+export type DeserializeResult<T> = DeserializeSuccess<T> | DeserializeFailure;
+
+/**
+ * Namespace with helper functions for working with vanilla DeserializeResult.
+ * These mirror the Result API for familiarity.
+ */
+export namespace DeserializeResult {
+  /**
+   * Creates a successful result.
+   */
+  export function ok<T>(value: T): DeserializeResult<T> {
+    return { success: true, value };
+  }
+
+  /**
+   * Creates a failed result with errors.
+   */
+  export function err<T>(errors: Array<{ field: string; message: string }>): DeserializeResult<T> {
+    return { success: false, errors };
+  }
+
+  /**
+   * Type guard to check if the result is successful.
+   */
+  export function isOk<T>(result: DeserializeResult<T>): result is DeserializeSuccess<T> {
+    return result.success;
+  }
+
+  /**
+   * Type guard to check if the result is a failure.
+   */
+  export function isErr<T>(result: DeserializeResult<T>): result is DeserializeFailure {
+    return !result.success;
+  }
+
+  /**
+   * Unwraps the value or throws an error.
+   */
+  export function unwrap<T>(result: DeserializeResult<T>): T {
+    if (result.success) return result.value;
+    throw new Error(
+      `Deserialization failed: ${JSON.stringify((result as DeserializeFailure).errors)}`,
+    );
+  }
+
+  /**
+   * Unwraps the value or returns a default.
+   */
+  export function unwrapOr<T>(result: DeserializeResult<T>, defaultValue: T): T {
+    return result.success ? result.value : defaultValue;
+  }
+}
+
 /**
  *
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "macroforge",
-  "version": "0.1.40",
+  "version": "0.1.41",
   "description": "TypeScript macro expansion engine powered by Rust and SWC",
   "main": "index.js",
   "types": "index.d.ts",
@@ -67,12 +67,12 @@
     "node": ">= 18"
   },
   "optionalDependencies": {
-    "@macroforge/bin-darwin-x64": "0.1.40",
-    "@macroforge/bin-darwin-arm64": "0.1.40",
-    "@macroforge/bin-linux-x64-gnu": "0.1.40",
-    "@macroforge/bin-linux-arm64-gnu": "0.1.40",
-    "@macroforge/bin-win32-x64-msvc": "0.1.40",
-    "@macroforge/bin-win32-arm64-msvc": "0.1.40"
+    "@macroforge/bin-darwin-x64": "0.1.41",
+    "@macroforge/bin-darwin-arm64": "0.1.41",
+    "@macroforge/bin-linux-x64-gnu": "0.1.41",
+    "@macroforge/bin-linux-arm64-gnu": "0.1.41",
+    "@macroforge/bin-win32-x64-msvc": "0.1.41",
+    "@macroforge/bin-win32-arm64-msvc": "0.1.41"
   },
   "scripts": {
     "build:serde": "bun build js/serde/index.ts --outfile js/serde/index.mjs && bun x tsc js/serde/index.ts --declaration --emitDeclarationOnly --outDir js/serde --lib ES2024 --skipLibCheck",