satteri 0.3.5 → 0.5.0

package/dist/binding.browser.d.ts

@@ -1 +1 @@
-export { applyCommandsAndConvertToHastHandle, applyCommandsToHandle, applyCommandsToMdastHandle, compileHandle, compileMdx, convertMdastToHastHandle, createHastHandle, createMdastHandle, createMdxHastHandle, createMdxMdastHandle, dropHandle, getHandleSource, getNodeData, mdastTextContentHandle, parseEsm, parseExpression, parseToHtml, renderHandle, serializeHandle, setNodeData, textContentHandle, walkHandle, walkMdastHandle, } from "../satteri_napi.wasi-browser.js";
+export { applyCommandsAndConvertToHastHandle, applyCommandsToHandle, applyCommandsToMdastHandle, compileHandle, compileMdx, convertMdastToHastHandle, createHastHandle, createMdastHandle, createMdxHastHandle, createMdxMdastHandle, dropHandle, getHandleSource, getMdastFrontmatter, getNodeData, mdastTextContentHandle, parseEsm, parseExpression, parseToHtml, renderHandle, serializeHandle, setNodeData, textContentHandle, walkHandle, walkMdastHandle, } from "../satteri_napi.wasi-browser.js";

package/dist/binding.browser.js

@@ -1,2 +1,2 @@
 // @ts-nocheck — WASM browser binding has no type declarations
-export { applyCommandsAndConvertToHastHandle, applyCommandsToHandle, applyCommandsToMdastHandle, compileHandle, compileMdx, convertMdastToHastHandle, createHastHandle, createMdastHandle, createMdxHastHandle, createMdxMdastHandle, dropHandle, getHandleSource, getNodeData, mdastTextContentHandle, parseEsm, parseExpression, parseToHtml, renderHandle, serializeHandle, setNodeData, textContentHandle, walkHandle, walkMdastHandle, } from "../satteri_napi.wasi-browser.js";
+export { applyCommandsAndConvertToHastHandle, applyCommandsToHandle, applyCommandsToMdastHandle, compileHandle, compileMdx, convertMdastToHastHandle, createHastHandle, createMdastHandle, createMdxHastHandle, createMdxMdastHandle, dropHandle, getHandleSource, getMdastFrontmatter, getNodeData, mdastTextContentHandle, parseEsm, parseExpression, parseToHtml, renderHandle, serializeHandle, setNodeData, textContentHandle, walkHandle, walkMdastHandle, } from "../satteri_napi.wasi-browser.js";

package/dist/binding.d.ts

@@ -1 +1 @@
-export { applyCommandsAndConvertToHastHandle, applyCommandsToHandle, applyCommandsToMdastHandle, compileHandle, compileMdx, convertMdastToHastHandle, createHastHandle, createMdastHandle, createMdxHastHandle, createMdxMdastHandle, dropHandle, getHandleSource, getNodeData, mdastTextContentHandle, parseEsm, parseExpression, parseToHtml, renderHandle, serializeHandle, setNodeData, textContentHandle, walkHandle, walkMdastHandle, } from "../index.js";
+export { applyCommandsAndConvertToHastHandle, applyCommandsToHandle, applyCommandsToMdastHandle, compileHandle, compileMdx, convertMdastToHastHandle, createHastHandle, createMdastHandle, createMdxHastHandle, createMdxMdastHandle, dropHandle, getHandleSource, getMdastFrontmatter, getNodeData, mdastTextContentHandle, parseEsm, parseExpression, parseToHtml, renderHandle, serializeHandle, setNodeData, textContentHandle, walkHandle, walkMdastHandle, } from "../index.js";

package/dist/binding.js

@@ -1 +1 @@
-export { applyCommandsAndConvertToHastHandle, applyCommandsToHandle, applyCommandsToMdastHandle, compileHandle, compileMdx, convertMdastToHastHandle, createHastHandle, createMdastHandle, createMdxHastHandle, createMdxMdastHandle, dropHandle, getHandleSource, getNodeData, mdastTextContentHandle, parseEsm, parseExpression, parseToHtml, renderHandle, serializeHandle, setNodeData, textContentHandle, walkHandle, walkMdastHandle, } from "../index.js";
+export { applyCommandsAndConvertToHastHandle, applyCommandsToHandle, applyCommandsToMdastHandle, compileHandle, compileMdx, convertMdastToHastHandle, createHastHandle, createMdastHandle, createMdxHastHandle, createMdxMdastHandle, dropHandle, getHandleSource, getMdastFrontmatter, getNodeData, mdastTextContentHandle, parseEsm, parseExpression, parseToHtml, renderHandle, serializeHandle, setNodeData, textContentHandle, walkHandle, walkMdastHandle, } from "../index.js";

package/dist/compile.d.ts

@@ -1,4 +1,4 @@
-import type { MdastPluginDefinition, HastPluginDefinition } from "./plugin.js";
+import type { MdastPluginInput, HastPluginInput } from "./plugin.js";
 import type { MdastNode, HastNode } from "./types.js";
 /** Configuration for static subtree collapsing during MDX compilation. */
 export interface OptimizeStaticConfig {
@@ -45,12 +45,20 @@ export interface Features {
     smartPunctuation?: boolean | SmartPunctuationOptions;
 }
 export interface CompileOptions {
-    mdastPlugins?: MdastPluginDefinition[];
-    hastPlugins?: HastPluginDefinition[];
+    mdastPlugins?: MdastPluginInput[];
+    hastPlugins?: HastPluginInput[];
     features?: Features;
     filename?: string;
 }
-export interface MdxCompileOptions extends CompileOptions {
+/**
+ * MDX-only compile options.
+ *
+ * These are the fields specific to MDX compilation, separate from the shared
+ * pipeline options in {@link CompileOptions}. Useful for wrappers (Vite/Rollup
+ * plugins, framework integrations) that want to expose MDX-specific knobs
+ * without re-exposing the shared pipeline fields.
+ */
+export interface MdxOnlyOptions {
     optimizeStatic?: OptimizeStaticConfig;
     /** Place to import automatic JSX runtimes from (e.g. "react", "preact"). Default: "react". */
     jsxImportSource?: string;
@@ -78,8 +86,50 @@ export interface MdxCompileOptions extends CompileOptions {
      */
     outputFormat?: "program" | "function-body";
 }
-export declare function markdownToHtml(source: string, options?: CompileOptions): string | Promise<string>;
-export declare function mdxToJs(source: string, options?: MdxCompileOptions): string | Promise<string>;
+export interface MdxCompileOptions extends CompileOptions, MdxOnlyOptions {
+}
+/** Frontmatter block extracted from the parsed Markdown/MDX source. */
+export interface Frontmatter {
+    /** Delimiter syntax used for the block. */
+    kind: "yaml" | "toml";
+    /** Raw content between the delimiters (`---`/`+++` lines excluded). */
+    value: string;
+}
+/** Result of {@link markdownToHtml}. */
+export interface MarkdownToHtmlResult {
+    /** Rendered HTML string. */
+    html: string;
+    /** Frontmatter block at the start of the document, or `null` if none. */
+    frontmatter: Frontmatter | null;
+}
+/** Result of {@link mdxToJs}. */
+export interface MdxToJsResult {
+    /** Compiled JavaScript module source. */
+    code: string;
+    /** Frontmatter block at the start of the document, or `null` if none. */
+    frontmatter: Frontmatter | null;
+}
+type AnyFn = (...args: any[]) => unknown;
+type ReturnsPromise<F> = F extends AnyFn ? Extract<ReturnType<F>, Promise<unknown>> extends never ? false : true : false;
+type FieldIsAsync<V> = V extends AnyFn ? ReturnsPromise<V> : V extends {
+    visit: infer F;
+} ? ReturnsPromise<F> : V extends ReadonlyArray<infer Item> ? Item extends {
+    visit: infer F;
+} ? ReturnsPromise<F> : false : false;
+type AnyVisitorAsync<P> = {
+    [K in keyof P]-?: FieldIsAsync<NonNullable<P[K]>>;
+}[keyof P];
+type IsPluginAsync<P> = true extends AnyVisitorAsync<P> ? true : false;
+type ResolveInput<P> = P extends () => infer D ? D : P;
+type AnyInputAsync<Ps> = Ps extends ReadonlyArray<infer P> ? true extends IsPluginAsync<ResolveInput<P>> ? true : false : false;
+type OptionsAsync<O> = (O extends {
+    mdastPlugins: infer Ps;
+} ? AnyInputAsync<Ps> : false) extends true ? true : (O extends {
+    hastPlugins: infer Ps;
+} ? AnyInputAsync<Ps> : false) extends true ? true : false;
+type ResultFor<O, R> = OptionsAsync<O> extends true ? Promise<R> : R;
+export declare function markdownToHtml<O extends CompileOptions>(source: string, options?: O): ResultFor<O, MarkdownToHtmlResult>;
+export declare function mdxToJs<O extends MdxCompileOptions>(source: string, options?: O): ResultFor<O, MdxToJsResult>;
 export interface EvaluateOptions extends Omit<MdxCompileOptions, "jsx" | "outputFormat"> {
     Fragment: unknown;
     jsx: (type: unknown, props: unknown, key?: unknown) => unknown;
@@ -115,3 +165,4 @@ export declare function markdownToHast(source: string, options?: {
 export declare function mdxToHast(source: string, options?: {
     features?: Features;
 }): HastNode;
+export {};

package/dist/compile.js

@@ -1,6 +1,6 @@
 import { visitHastHandle, resolveSubscriptions } from "./hast/hast-visitor.js";
 import { visitMdastHandle, resolveMdastSubscriptions, } from "./mdast/mdast-visitor.js";
-import { parseToHtml, compileMdx, createHastHandle, createMdxHastHandle, renderHandle, compileHandle, applyCommandsToHandle, dropHandle, createMdastHandle, createMdxMdastHandle, applyCommandsToMdastHandle, convertMdastToHastHandle, applyCommandsAndConvertToHastHandle, getHandleSource, serializeHandle, } from "#binding";
+import { createHastHandle, createMdxHastHandle, renderHandle, compileHandle, dropHandle, createMdastHandle, createMdxMdastHandle, applyCommandsToMdastHandle, convertMdastToHastHandle, getHandleSource, getMdastFrontmatter, serializeHandle, } from "#binding";
 import { MdastReader } from "./mdast/mdast-reader.js";
 import { materializeMdastTree } from "./mdast/mdast-materializer.js";
 import { HastReader } from "./hast/hast-reader.js";
@@ -41,7 +41,8 @@ function runMdastPluginsOnHandle(handle, plugins, filename) {
     const runNext = () => {
         while (i < plugins.length) {
             const idx = i++;
-            const plugin = plugins[idx];
+            const raw = plugins[idx];
+            const plugin = typeof raw === "function" ? raw() : raw;
             const subs = resolveMdastSubscriptions(plugin);
             const result = visitMdastHandle(handle, plugin, subs, () => getHandleSource(handle), filename);
             if (result instanceof Promise) {
@@ -72,8 +73,9 @@ function runHastPluginsOnHandle(handle, plugins, source, filename) {
     let i = 0;
     const runNext = () => {
         while (i < plugins.length) {
-            const plugin = plugins[i];
+            const raw = plugins[i];
             i++;
+            const plugin = typeof raw === "function" ? raw() : raw;
             const subs = resolveSubscriptions(plugin);
             const result = visitHastHandle(handle, plugin, subs, source, filename);
             if (result instanceof Promise) {
@@ -123,52 +125,41 @@ function mdxOptionsToNative(opts) {
 export function markdownToHtml(source, options = {}) {
     const { mdastPlugins = [], hastPlugins = [], features, filename = "<unknown>" } = options;
     const nativeFeatures = featuresToNative(features);
-    // TODO: When there's no plugins, we shouldn't go through all the steps below, we could just call parseToHtml directly.
-    // However right now pulldown-cmark's HTML output is super different from our target (unified's). So until that's fixed, we'll do the slower pipeline
-    const handleResult = createHastHandleFromMdast(source, mdastPlugins, false, filename, nativeFeatures);
-    const finish = (hastHandle) => {
-        const asyncResult = runHastPluginsOnHandle(hastHandle, hastPlugins, source, filename);
-        if (asyncResult instanceof Promise) {
-            return asyncResult.then(() => {
-                const html = renderHandle(hastHandle);
-                dropHandle(hastHandle);
-                return html;
-            });
-        }
-        const html = renderHandle(hastHandle);
-        dropHandle(hastHandle);
-        return html;
+    const result = createHastHandleFromMdast(source, mdastPlugins, false, filename, nativeFeatures);
+    const render = (h, frontmatter) => {
+        const html = renderHandle(h);
+        dropHandle(h);
+        return { html, frontmatter };
     };
-    if (handleResult instanceof Promise) {
-        return handleResult.then(finish);
-    }
-    return finish(handleResult);
+    const runHastThenRender = (r) => {
+        const hastResult = runHastPluginsOnHandle(r.hastHandle, hastPlugins, source, filename);
+        if (hastResult instanceof Promise)
+            return hastResult.then(() => render(r.hastHandle, r.frontmatter));
+        return render(r.hastHandle, r.frontmatter);
+    };
+    if (result instanceof Promise)
+        return result.then(runHastThenRender);
+    return runHastThenRender(result);
 }
 export function mdxToJs(source, options = {}) {
     const { mdastPlugins = [], hastPlugins = [], features, filename = "<unknown>", ...mdxFields } = options;
     const mdxOptions = mdxOptionsToNative(mdxFields);
     const nativeFeatures = featuresToNative(features);
-    if (mdastPlugins.length === 0 && hastPlugins.length === 0) {
-        return compileMdx(source, mdxOptions, nativeFeatures);
-    }
-    const handleResult = createHastHandleFromMdast(source, mdastPlugins, true, filename, nativeFeatures);
-    const finish = (hastHandle) => {
-        const asyncResult = runHastPluginsOnHandle(hastHandle, hastPlugins, source, filename);
-        if (asyncResult instanceof Promise) {
-            return asyncResult.then(() => {
-                const js = compileHandle(hastHandle, mdxOptions);
-                dropHandle(hastHandle);
-                return js;
-            });
-        }
-        const js = compileHandle(hastHandle, mdxOptions);
-        dropHandle(hastHandle);
-        return js;
+    const result = createHastHandleFromMdast(source, mdastPlugins, true, filename, nativeFeatures);
+    const compile = (h, frontmatter) => {
+        const code = compileHandle(h, mdxOptions);
+        dropHandle(h);
+        return { code, frontmatter };
     };
-    if (handleResult instanceof Promise) {
-        return handleResult.then(finish);
-    }
-    return finish(handleResult);
+    const runHastThenCompile = (r) => {
+        const hastResult = runHastPluginsOnHandle(r.hastHandle, hastPlugins, source, filename);
+        if (hastResult instanceof Promise)
+            return hastResult.then(() => compile(r.hastHandle, r.frontmatter));
+        return compile(r.hastHandle, r.frontmatter);
+    };
+    if (result instanceof Promise)
+        return result.then(runHastThenCompile);
+    return runHastThenCompile(result);
 }
 /**
  * Compile and evaluate MDX in one step.
@@ -184,37 +175,44 @@ export function mdxToJs(source, options = {}) {
 export function evaluate(source, options) {
     const { Fragment, jsx, jsxs, jsxDEV, useMDXComponents, ...compileOpts } = options;
     const runtime = { Fragment, jsx, jsxs, jsxDEV, useMDXComponents };
-    const code = mdxToJs(source, { ...compileOpts, outputFormat: "function-body" });
-    if (code instanceof Promise) {
-        return code.then((resolved) => new Function(resolved)(runtime));
+    const result = mdxToJs(source, { ...compileOpts, outputFormat: "function-body" });
+    if (result instanceof Promise) {
+        return result.then((resolved) => new Function(resolved.code)(runtime));
     }
-    return new Function(code)(runtime);
+    return new Function(result.code)(runtime);
 }
-// Pipeline: parse → mdast plugins → hast conversion → hast plugins
-// All arenas stay in Rust. No intermediate buffer copies to JS.
-/** Parse + mdast plugins + convert to HAST handle. */
+function readFrontmatter(handle) {
+    const raw = getMdastFrontmatter(handle);
+    return raw ? { kind: raw.kind === "toml" ? "toml" : "yaml", value: raw.value } : null;
+}
+/** Parse, run mdast plugins, capture frontmatter, then convert to HAST.
+ *  Frontmatter is read from the post-plugin MDAST so visitor mutations to
+ *  the yaml/toml node are reflected in the returned value. */
 function createHastHandleFromMdast(source, mdastPlugins, mdx, filename, 
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 nativeFeatures) {
-    if (mdastPlugins.length === 0) {
-        return mdx
-            ? createMdxHastHandle(source, nativeFeatures)
-            : createHastHandle(source, nativeFeatures);
-    }
     const mdastHandle = mdx
         ? createMdxMdastHandle(source, nativeFeatures)
         : createMdastHandle(source, nativeFeatures);
+    if (mdastPlugins.length === 0) {
+        const frontmatter = readFrontmatter(mdastHandle);
+        const hastHandle = convertMdastToHastHandle(mdastHandle);
+        return { hastHandle, frontmatter };
+    }
     const mdastResult = runMdastPluginsOnHandle(mdastHandle, mdastPlugins, filename);
-    const convert = (r) => {
+    // Splits the previous fused apply+convert call so we can read frontmatter
+    // off the mutated MDAST handle before the conversion consumes it.
+    const finalize = (r) => {
         if (r.pendingCommands) {
-            return applyCommandsAndConvertToHastHandle(r.handle, r.pendingCommands);
+            applyCommandsToMdastHandle(r.handle, r.pendingCommands);
         }
-        return convertMdastToHastHandle(r.handle);
+        const frontmatter = readFrontmatter(r.handle);
+        const hastHandle = convertMdastToHastHandle(r.handle);
+        return { hastHandle, frontmatter };
     };
-    if (mdastResult instanceof Promise) {
-        return mdastResult.then(convert);
-    }
-    return convert(mdastResult);
+    if (mdastResult instanceof Promise)
+        return mdastResult.then(finalize);
+    return finalize(mdastResult);
 }
 // Step-by-step API: individual pipeline stages with materialized trees
 /** Parse Markdown source into a materialized mdast tree. */

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 export { markdownToHtml, mdxToJs, evaluate, markdownToMdast, mdxToMdast, markdownToHast, mdxToHast, } from "./compile.js";
-export type { CompileOptions, MdxCompileOptions, EvaluateOptions, OptimizeStaticConfig, Features, SmartPunctuationOptions, } from "./compile.js";
+export type { CompileOptions, MdxCompileOptions, MdxOnlyOptions, EvaluateOptions, OptimizeStaticConfig, Features, SmartPunctuationOptions, Frontmatter, MarkdownToHtmlResult, MdxToJsResult, } from "./compile.js";
 export { defineMdastPlugin, defineHastPlugin } from "./plugin.js";
-export type { MdastPluginDefinition, HastPluginDefinition } from "./plugin.js";
+export type { MdastPluginDefinition, HastPluginDefinition, MdastPluginInput, HastPluginInput, } from "./plugin.js";
 export type { HastVisitorInstance, HastVisitorContext, HastFilteredVisitor, EstreeProgram, } from "./hast/hast-visitor.js";
 export type { MdastNode, HastNode, Position, Point, MdxJsxAttributeNode, MdxJsxExpressionAttributeNode, MdxJsxAttributeValueExpressionNode, MdxJsxAttributeUnion, } from "./types.js";
 export { visitMdastHandle, resolveMdastSubscriptions } from "./mdast/mdast-visitor.js";

package/dist/plugin.d.ts

@@ -6,5 +6,15 @@ export type MdastPluginDefinition = MdastPluginInstance & {
 export type HastPluginDefinition = HastVisitorInstance & {
     name: string;
 };
-export declare function defineMdastPlugin(definition: MdastPluginDefinition): MdastPluginDefinition;
-export declare function defineHastPlugin(definition: HastPluginDefinition): HastPluginDefinition;
+/**
+ * Entry accepted by `mdastPlugins`: a definition reused across documents,
+ * or a factory called once per compile so closures reset per document.
+ */
+export type MdastPluginInput = MdastPluginDefinition | (() => MdastPluginDefinition);
+/**
+ * Entry accepted by `hastPlugins`: a definition reused across documents,
+ * or a factory called once per compile so closures reset per document.
+ */
+export type HastPluginInput = HastPluginDefinition | (() => HastPluginDefinition);
+export declare function defineMdastPlugin<P extends MdastPluginDefinition>(definition: P): P;
+export declare function defineHastPlugin<P extends HastPluginDefinition>(definition: P): P;

package/dist/plugin.js

@@ -1,3 +1,6 @@
+// Generic so the inferred plugin type preserves each visitor's *actual* return
+// type. That lets call sites of `markdownToHtml`/`mdxToJs` distinguish sync
+// plugins from async ones in their conditional return type.
 export function defineMdastPlugin(definition) {
     if (!definition.name) {
         throw new Error("Plugin definition must have a name");

package/index.d.ts

@@ -48,6 +48,12 @@ export declare function dropHandle(handle: AnyHandle): void
  */
 export declare function getHandleSource(handle: AnyHandle): string
 
+/**
+ * Return the first YAML or TOML frontmatter block in the MDAST arena, if any.
+ * Walks the root node's direct children and returns the first yaml/toml literal.
+ */
+export declare function getMdastFrontmatter(handle: MdastHandle): JsFrontmatter | null
+
 /**
  * Read the node_data JSON blob for a node. Returns null if none is set.
  * Works for both MDAST and HAST handles.
@@ -78,6 +84,14 @@ export interface JsFeatures {
   smartPunctuationOptions?: JsSmartPunctuationOptions
 }
 
+/** Frontmatter extracted from an MDAST arena. */
+export interface JsFrontmatter {
+  /** Either `"yaml"` or `"toml"`. */
+  kind: string
+  /** Raw frontmatter content between the delimiters (no `---`/`+++` lines). */
+  value: string
+}
+
 /** MDX compile options passed from JavaScript. */
 export interface JsMdxOptions {
   /**
@@ -169,9 +183,9 @@ export declare function parseToHtml(source: string, features?: JsFeatures | unde
 export declare function renderHandle(handle: HastHandle): string
 
 /**
- * Serialize a handle's arena to a binary buffer. Works for both MDAST
- * (read-only snapshot for the JS visitor) and HAST (fallback path for
- * `transformRoot`) — the kind tag is embedded in the buffer header.
+ * Serialize a handle's arena to the wire-format buffer JS instantiates a
+ * reader from. The kind tag in the header tells the JS side whether to
+ * pick `MdastReader` or `HastReader`.
  */
 export declare function serializeHandle(handle: AnyHandle): Uint8Array
 

package/index.js

@@ -81,8 +81,8 @@ function requireNative() {
       try {
         const binding = require('@bruits/satteri-android-arm64')
         const bindingPackageVersion = require('@bruits/satteri-android-arm64/package.json').version
-        if (bindingPackageVersion !== '0.3.4' && 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.3.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.4.0' && 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.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -97,8 +97,8 @@ function requireNative() {
       try {
         const binding = require('@bruits/satteri-android-arm-eabi')
         const bindingPackageVersion = require('@bruits/satteri-android-arm-eabi/package.json').version
-        if (bindingPackageVersion !== '0.3.4' && 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.3.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.4.0' && 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.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -118,8 +118,8 @@ function requireNative() {
       try {
         const binding = require('@bruits/satteri-win32-x64-gnu')
         const bindingPackageVersion = require('@bruits/satteri-win32-x64-gnu/package.json').version
-        if (bindingPackageVersion !== '0.3.4' && 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.3.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.4.0' && 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.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -134,8 +134,8 @@ function requireNative() {
       try {
         const binding = require('@bruits/satteri-win32-x64-msvc')
         const bindingPackageVersion = require('@bruits/satteri-win32-x64-msvc/package.json').version
-        if (bindingPackageVersion !== '0.3.4' && 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.3.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.4.0' && 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.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -151,8 +151,8 @@ function requireNative() {
       try {
         const binding = require('@bruits/satteri-win32-ia32-msvc')
         const bindingPackageVersion = require('@bruits/satteri-win32-ia32-msvc/package.json').version
-        if (bindingPackageVersion !== '0.3.4' && 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.3.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.4.0' && 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.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -167,8 +167,8 @@ function requireNative() {
       try {
         const binding = require('@bruits/satteri-win32-arm64-msvc')
         const bindingPackageVersion = require('@bruits/satteri-win32-arm64-msvc/package.json').version
-        if (bindingPackageVersion !== '0.3.4' && 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.3.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.4.0' && 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.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -186,8 +186,8 @@ function requireNative() {
     try {
       const binding = require('@bruits/satteri-darwin-universal')
       const bindingPackageVersion = require('@bruits/satteri-darwin-universal/package.json').version
-      if (bindingPackageVersion !== '0.3.4' && 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.3.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      if (bindingPackageVersion !== '0.4.0' && 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.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
       }
       return binding
     } catch (e) {
@@ -202,8 +202,8 @@ function requireNative() {
       try {
         const binding = require('@bruits/satteri-darwin-x64')
         const bindingPackageVersion = require('@bruits/satteri-darwin-x64/package.json').version
-        if (bindingPackageVersion !== '0.3.4' && 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.3.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.4.0' && 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.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -218,8 +218,8 @@ function requireNative() {
       try {
         const binding = require('@bruits/satteri-darwin-arm64')
         const bindingPackageVersion = require('@bruits/satteri-darwin-arm64/package.json').version
-        if (bindingPackageVersion !== '0.3.4' && 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.3.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.4.0' && 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.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -238,8 +238,8 @@ function requireNative() {
       try {
         const binding = require('@bruits/satteri-freebsd-x64')
         const bindingPackageVersion = require('@bruits/satteri-freebsd-x64/package.json').version
-        if (bindingPackageVersion !== '0.3.4' && 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.3.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.4.0' && 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.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -254,8 +254,8 @@ function requireNative() {
       try {
         const binding = require('@bruits/satteri-freebsd-arm64')
         const bindingPackageVersion = require('@bruits/satteri-freebsd-arm64/package.json').version
-        if (bindingPackageVersion !== '0.3.4' && 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.3.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.4.0' && 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.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -275,8 +275,8 @@ function requireNative() {
         try {
           const binding = require('@bruits/satteri-linux-x64-musl')
           const bindingPackageVersion = require('@bruits/satteri-linux-x64-musl/package.json').version
-          if (bindingPackageVersion !== '0.3.4' && 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.3.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.4.0' && 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.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -291,8 +291,8 @@ function requireNative() {
         try {
           const binding = require('@bruits/satteri-linux-x64-gnu')
           const bindingPackageVersion = require('@bruits/satteri-linux-x64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.3.4' && 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.3.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.4.0' && 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.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -309,8 +309,8 @@ function requireNative() {
         try {
           const binding = require('@bruits/satteri-linux-arm64-musl')
           const bindingPackageVersion = require('@bruits/satteri-linux-arm64-musl/package.json').version
-          if (bindingPackageVersion !== '0.3.4' && 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.3.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.4.0' && 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.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -325,8 +325,8 @@ function requireNative() {
         try {
           const binding = require('@bruits/satteri-linux-arm64-gnu')
           const bindingPackageVersion = require('@bruits/satteri-linux-arm64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.3.4' && 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.3.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.4.0' && 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.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -343,8 +343,8 @@ function requireNative() {
         try {
           const binding = require('@bruits/satteri-linux-arm-musleabihf')
           const bindingPackageVersion = require('@bruits/satteri-linux-arm-musleabihf/package.json').version
-          if (bindingPackageVersion !== '0.3.4' && 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.3.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.4.0' && 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.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -359,8 +359,8 @@ function requireNative() {
         try {
           const binding = require('@bruits/satteri-linux-arm-gnueabihf')
           const bindingPackageVersion = require('@bruits/satteri-linux-arm-gnueabihf/package.json').version
-          if (bindingPackageVersion !== '0.3.4' && 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.3.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.4.0' && 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.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -377,8 +377,8 @@ function requireNative() {
         try {
           const binding = require('@bruits/satteri-linux-loong64-musl')
           const bindingPackageVersion = require('@bruits/satteri-linux-loong64-musl/package.json').version
-          if (bindingPackageVersion !== '0.3.4' && 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.3.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.4.0' && 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.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -393,8 +393,8 @@ function requireNative() {
         try {
           const binding = require('@bruits/satteri-linux-loong64-gnu')
           const bindingPackageVersion = require('@bruits/satteri-linux-loong64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.3.4' && 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.3.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.4.0' && 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.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -411,8 +411,8 @@ function requireNative() {
         try {
           const binding = require('@bruits/satteri-linux-riscv64-musl')
           const bindingPackageVersion = require('@bruits/satteri-linux-riscv64-musl/package.json').version
-          if (bindingPackageVersion !== '0.3.4' && 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.3.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.4.0' && 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.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -427,8 +427,8 @@ function requireNative() {
         try {
           const binding = require('@bruits/satteri-linux-riscv64-gnu')
           const bindingPackageVersion = require('@bruits/satteri-linux-riscv64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.3.4' && 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.3.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.4.0' && 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.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -444,8 +444,8 @@ function requireNative() {
       try {
         const binding = require('@bruits/satteri-linux-ppc64-gnu')
         const bindingPackageVersion = require('@bruits/satteri-linux-ppc64-gnu/package.json').version
-        if (bindingPackageVersion !== '0.3.4' && 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.3.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.4.0' && 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.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -460,8 +460,8 @@ function requireNative() {
       try {
         const binding = require('@bruits/satteri-linux-s390x-gnu')
         const bindingPackageVersion = require('@bruits/satteri-linux-s390x-gnu/package.json').version
-        if (bindingPackageVersion !== '0.3.4' && 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.3.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.4.0' && 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.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -480,8 +480,8 @@ function requireNative() {
       try {
         const binding = require('@bruits/satteri-openharmony-arm64')
         const bindingPackageVersion = require('@bruits/satteri-openharmony-arm64/package.json').version
-        if (bindingPackageVersion !== '0.3.4' && 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.3.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.4.0' && 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.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -496,8 +496,8 @@ function requireNative() {
       try {
         const binding = require('@bruits/satteri-openharmony-x64')
         const bindingPackageVersion = require('@bruits/satteri-openharmony-x64/package.json').version
-        if (bindingPackageVersion !== '0.3.4' && 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.3.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.4.0' && 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.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -512,8 +512,8 @@ function requireNative() {
       try {
         const binding = require('@bruits/satteri-openharmony-arm')
         const bindingPackageVersion = require('@bruits/satteri-openharmony-arm/package.json').version
-        if (bindingPackageVersion !== '0.3.4' && 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.3.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.4.0' && 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.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -562,6 +562,14 @@ if (!nativeBinding || process.env.NAPI_RS_FORCE_WASI) {
   }
 }
 
+if (!nativeBinding && globalThis.process?.versions?.['webcontainer']) {
+  try {
+    nativeBinding = require('./webcontainer-fallback.cjs');
+  } catch (err) {
+    loadErrors.push(err)
+  }
+}
+
 if (!nativeBinding) {
   if (loadErrors.length > 0) {
     throw new Error(
@@ -579,7 +587,7 @@ if (!nativeBinding) {
   throw new Error(`Failed to load native binding`)
 }
 
-const { applyCommandsAndConvertToHastHandle, applyCommandsToHandle, applyCommandsToMdastHandle, compileHandle, compileMdx, convertMdastToHastHandle, createHastHandle, createMdastHandle, createMdxHastHandle, createMdxMdastHandle, dropHandle, getHandleSource, getNodeData, mdastTextContentHandle, parseEsm, parseExpression, parseToHtml, renderHandle, serializeHandle, setNodeData, textContentHandle, walkHandle, walkMdastHandle } = nativeBinding
+const { applyCommandsAndConvertToHastHandle, applyCommandsToHandle, applyCommandsToMdastHandle, compileHandle, compileMdx, convertMdastToHastHandle, createHastHandle, createMdastHandle, createMdxHastHandle, createMdxMdastHandle, dropHandle, getHandleSource, getMdastFrontmatter, getNodeData, mdastTextContentHandle, parseEsm, parseExpression, parseToHtml, renderHandle, serializeHandle, setNodeData, textContentHandle, walkHandle, walkMdastHandle } = nativeBinding
 export { applyCommandsAndConvertToHastHandle }
 export { applyCommandsToHandle }
 export { applyCommandsToMdastHandle }
@@ -592,6 +600,7 @@ export { createMdxHastHandle }
 export { createMdxMdastHandle }
 export { dropHandle }
 export { getHandleSource }
+export { getMdastFrontmatter }
 export { getNodeData }
 export { mdastTextContentHandle }
 export { parseEsm }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "satteri",
-  "version": "0.3.5",
+  "version": "0.5.0",
   "description": "High-performance Markdown and MDX processing",
   "repository": {
     "type": "git",
@@ -14,7 +14,8 @@
     "satteri_napi.wasi.cjs",
     "satteri_napi.wasi-browser.js",
     "wasi-worker.mjs",
-    "wasi-worker-browser.mjs"
+    "wasi-worker-browser.mjs",
+    "webcontainer-fallback.cjs"
   ],
   "type": "module",
   "main": "./dist/index.js",
@@ -78,17 +79,21 @@
     ]
   },
   "optionalDependencies": {
-    "@bruits/satteri-linux-x64-gnu": "0.3.5",
-    "@bruits/satteri-darwin-x64": "0.3.5",
-    "@bruits/satteri-darwin-arm64": "0.3.5",
-    "@bruits/satteri-win32-x64-msvc": "0.3.5",
-    "@bruits/satteri-wasm32-wasi": "0.3.5"
+    "@bruits/satteri-linux-x64-gnu": "0.5.0",
+    "@bruits/satteri-darwin-x64": "0.5.0",
+    "@bruits/satteri-darwin-arm64": "0.5.0",
+    "@bruits/satteri-win32-x64-msvc": "0.5.0",
+    "@bruits/satteri-wasm32-wasi": "0.5.0"
   },
   "scripts": {
     "build:wasm": "napi build --manifest-path ../../crates/satteri-napi-binding/Cargo.toml --output-dir . --platform --release --esm --strip --target wasm32-wasip1-threads",
+    "postbuild:wasm": "node patch-binding.js",
     "build:native": "napi build --manifest-path ../../crates/satteri-napi-binding/Cargo.toml --output-dir . --platform --release --esm --strip",
+    "postbuild:native": "node patch-binding.js",
     "build:native:cross": "napi build --manifest-path ../../crates/satteri-napi-binding/Cargo.toml --output-dir . --platform --release --esm --strip --cross-compile",
+    "postbuild:native:cross": "node patch-binding.js",
     "build:native:debug": "napi build --manifest-path ../../crates/satteri-napi-binding/Cargo.toml --output-dir . --platform --esm",
+    "postbuild:native:debug": "node patch-binding.js",
     "build:ts": "tsc --project tsconfig.build.json",
     "build": "pnpm build:native && pnpm build:ts",
     "artifacts": "napi create-npm-dirs && napi artifacts",

package/satteri_napi.wasi-browser.js

@@ -69,6 +69,7 @@ export const createMdxHastHandle = __napiModule.exports.createMdxHastHandle
 export const createMdxMdastHandle = __napiModule.exports.createMdxMdastHandle
 export const dropHandle = __napiModule.exports.dropHandle
 export const getHandleSource = __napiModule.exports.getHandleSource
+export const getMdastFrontmatter = __napiModule.exports.getMdastFrontmatter
 export const getNodeData = __napiModule.exports.getNodeData
 export const mdastTextContentHandle = __napiModule.exports.mdastTextContentHandle
 export const parseEsm = __napiModule.exports.parseEsm

package/satteri_napi.wasi.cjs

@@ -120,6 +120,7 @@ module.exports.createMdxHastHandle = __napiModule.exports.createMdxHastHandle
 module.exports.createMdxMdastHandle = __napiModule.exports.createMdxMdastHandle
 module.exports.dropHandle = __napiModule.exports.dropHandle
 module.exports.getHandleSource = __napiModule.exports.getHandleSource
+module.exports.getMdastFrontmatter = __napiModule.exports.getMdastFrontmatter
 module.exports.getNodeData = __napiModule.exports.getNodeData
 module.exports.mdastTextContentHandle = __napiModule.exports.mdastTextContentHandle
 module.exports.parseEsm = __napiModule.exports.parseEsm

package/webcontainer-fallback.cjs

@@ -0,0 +1,23 @@
+// Adapted from https://github.com/rolldown/rolldown/blob/main/packages/rolldown/src/webcontainer-fallback.cjs
+
+const fs = require("node:fs");
+const childProcess = require("node:child_process");
+
+const pkg = require("./package.json");
+const version = pkg.version;
+
+const baseDir = `/tmp/satteri-${version}`;
+const bindingEntry = `${baseDir}/node_modules/@bruits/satteri-wasm32-wasi/satteri_napi.wasi.cjs`;
+
+if (!fs.existsSync(bindingEntry)) {
+  const bindingPkg = `@bruits/satteri-wasm32-wasi@${version}`;
+  fs.rmSync(baseDir, { recursive: true, force: true });
+  fs.mkdirSync(baseDir, { recursive: true });
+  console.log(`[satteri] Downloading ${bindingPkg} on WebContainer...`);
+  childProcess.execFileSync("pnpm", ["i", bindingPkg], {
+    cwd: baseDir,
+    stdio: "inherit",
+  });
+}
+
+module.exports = require(bindingEntry);