satteri 0.9.4 → 0.10.0

package/index.d.ts

@@ -1,11 +1,29 @@
 /* auto-generated by NAPI-RS */
 /* eslint-disable */
+/**
+ * Same as `apply_commands_and_render_handle` but for the MDX → JS path.
+ * Fuses apply + simplify + compile + drop.
+ */
+export declare function applyCommandsAndCompileHandle(handle: HastHandle, commandBuf: Uint8Array, options?: JsMdxOptions | undefined | null): CompileJsOneShot
+
 /**
  * Apply MDAST commands and convert to HAST handle in one step.
  * The MDAST handle is consumed (emptied).
  */
 export declare function applyCommandsAndConvertToHastHandle(handle: MdastHandle, commandBuf: Uint8Array, convertOptions?: JsConvertOptions | undefined | null): HastHandle
 
+/**
+ * Fused tail step for `markdownToHtml` with a HAST plugin: apply the plugin's
+ * command buffer, render the resulting HAST to HTML, and leave the handle
+ * drained, all in one NAPI roundtrip. Saves the `apply` + `render` + `drop`
+ * crossings the old path made separately.
+ *
+ * The handle keeps existing (callers can still `dropHandle` it on the JS
+ * side if they want explicit cleanup), but the arena inside is left empty so
+ * the next access sees no state and the underlying allocations are freed.
+ */
+export declare function applyCommandsAndRenderHandle(handle: HastHandle, commandBuf: Uint8Array): RenderHtmlOneShot
+
 /**
  * Apply a command buffer to a HAST handle's arena in-place. Returns how many
  * patches were dropped because their target lived inside a subtree this pass
@@ -21,9 +39,32 @@ export declare function applyCommandsToHandle(handle: HastHandle, commandBuf: Ui
  */
 export declare function applyCommandsToMdastHandle(handle: MdastHandle, commandBuf: Uint8Array): number
 
+/**
+ * Fused tail for `mdxToJs` when there's an MDAST plugin but no HAST plugin.
+ * Apply → extract frontmatter → convert → simplify → compile, all in one
+ * NAPI roundtrip.
+ */
+export declare function applyMdastCommandsAndConvertAndCompile(handle: MdastHandle, commandBuf: Uint8Array, options?: JsMdxOptions | undefined | null, convertOptions?: JsConvertOptions | undefined | null): MdxJsOneShot
+
+/**
+ * Fused tail for `markdownToHtml` when there's an MDAST plugin but no HAST
+ * plugin: apply the MDAST commands, extract frontmatter from the (now
+ * possibly-mutated) MDAST, convert MDAST → HAST, render to HTML. All in one
+ * NAPI roundtrip. Saves the convert + render + drop + frontmatter crossings
+ * the old path made separately, and reads frontmatter *after* mutations so a
+ * plugin that rewrites yaml/toml is observed correctly.
+ */
+export declare function applyMdastCommandsAndConvertAndRender(handle: MdastHandle, commandBuf: Uint8Array, convertOptions?: JsConvertOptions | undefined | null): MarkdownHtmlOneShot
+
 /** Compile a HAST handle's arena to MDX JavaScript. Does not consume the handle. */
 export declare function compileHandle(handle: HastHandle, options?: JsMdxOptions | undefined | null): string
 
+/** Result of the fused apply + compile tail; see [`RenderHtmlOneShot`]. */
+export interface CompileJsOneShot {
+  code: string
+  droppedTransforms: number
+}
+
 /** Compile MDX source directly to JavaScript. */
 export declare function compileMdx(source: string, options?: JsMdxOptions | undefined | null, features?: JsFeatures | undefined | null, convertOptions?: JsConvertOptions | undefined | null): string
 
@@ -34,20 +75,41 @@ export declare function convertMdastToHastHandle(handle: MdastHandle, convertOpt
  * Parse markdown source and convert to HAST. Returns an opaque handle.
  * The arena stays in Rust memory, no buffer is copied to JS.
  */
-export declare function createHastHandle(source: string, features?: JsFeatures | undefined | null, convertOptions?: JsConvertOptions | undefined | null): HastHandle
+export declare function createHastHandle(source: string, features?: JsFeatures | undefined | null, convertOptions?: JsConvertOptions | undefined | null, trackPositions?: boolean | undefined | null): HastHandle
+
+/**
+ * Parse an HTML string into structured HAST (elements, text, comments).
+ * Returns an opaque handle; the arena stays in Rust memory.
+ */
+export declare function createHastHandleFromHtml(html: string): HastHandle
 
-/** Parse markdown source into an MDAST arena handle. */
-export declare function createMdastHandle(source: string, features?: JsFeatures | undefined | null): MdastHandle
+/**
+ * Parse + frontmatter + HAST conversion in one crossing (HAST-plugin path
+ * head). Returns a `[handle, frontmatter]` pair.
+ */
+export declare function createHastHandleWithFrontmatter(source: string, features?: JsFeatures | undefined | null, convertOptions?: JsConvertOptions | undefined | null, trackPositions?: boolean | undefined | null): [HastHandle, JsFrontmatter | undefined | null]
+
+/**
+ * Parse markdown source into an MDAST arena handle.
+ *
+ * `track_positions` (default `true`) controls whether `position` is recorded
+ * on nodes. The plugin pipeline passes `false` when no plugin reads positions,
+ * skipping the `LineIndex` build + per-node line/column lookups (~15% of parse).
+ */
+export declare function createMdastHandle(source: string, features?: JsFeatures | undefined | null, trackPositions?: boolean | undefined | null): MdastHandle
 
 /** Parse MDX source and convert to HAST. Returns an opaque handle. */
-export declare function createMdxHastHandle(source: string, features?: JsFeatures | undefined | null, convertOptions?: JsConvertOptions | undefined | null): HastHandle
+export declare function createMdxHastHandle(source: string, features?: JsFeatures | undefined | null, convertOptions?: JsConvertOptions | undefined | null, trackPositions?: boolean | undefined | null): HastHandle
+
+/** MDX variant of [`create_hast_handle_with_frontmatter`]. */
+export declare function createMdxHastHandleWithFrontmatter(source: string, features?: JsFeatures | undefined | null, convertOptions?: JsConvertOptions | undefined | null, trackPositions?: boolean | undefined | null): [HastHandle, JsFrontmatter | undefined | null]
 
 /** Parse MDX source into an MDAST arena handle. */
-export declare function createMdxMdastHandle(source: string, features?: JsFeatures | undefined | null): MdastHandle
+export declare function createMdxMdastHandle(source: string, features?: JsFeatures | undefined | null, trackPositions?: boolean | undefined | null): MdastHandle
 
 /**
- * Release a handle's arena memory. The handle becomes empty but remains
- * valid (subsequent calls are no-ops or return empty results).
+ * Empty a handle's arena into the thread-local pool; the handle stays valid
+ * (subsequent calls are no-ops or return empty results).
  */
 export declare function dropHandle(handle: AnyHandle): void
 
@@ -86,6 +148,11 @@ export interface JsConvertOptions {
    * Default: `"Back to reference {reference}"`.
    */
   footnoteBackLabel?: string | ((arg0: number, arg1: number) => string)
+  /**
+   * Reparse raw HTML embedded in markdown into real HAST nodes. Default:
+   * false. Only effective in builds with the `from-html` feature.
+   */
+  rawHtml?: boolean
 }
 
 /** Feature toggles for the Markdown/MDX parser, passed from JavaScript. */
@@ -110,6 +177,8 @@ export interface JsFeatures {
   subscript?: boolean
   /** Obsidian-style wikilinks (`[[link]]`). Default: false. */
   wikilinks?: boolean
+  /** Definition lists (`Term` then `: definition`). Default: false. */
+  definitionList?: boolean
   /** Smart punctuation: all categories on. Default: false. */
   smartPunctuation?: boolean
   /** Granular smart-punctuation control (overrides `smart_punctuation`). */
@@ -229,12 +298,55 @@ export interface JsTextContentOptions {
   includeHtml?: boolean
 }
 
+/**
+ * One-shot result returned by the no-plugin fast path and the MDAST-plugin
+ * fused tail. `dropped_transforms` is only ever non-zero on the fused-tail
+ * path (the fast path applies no commands).
+ */
+export interface MarkdownHtmlOneShot {
+  html: string
+  frontmatter?: JsFrontmatter
+  droppedTransforms: number
+}
+
+/**
+ * Fast path: parse markdown → MDAST → HAST → HTML, plus extract frontmatter,
+ * in a single NAPI roundtrip. Used by `markdownToHtml` when the caller didn't
+ * configure any plugins. Skips 5 of the 6 NAPI crossings the handle-based
+ * path makes (createMdast, getFrontmatter, convertToHast, dropMdast, render,
+ * dropHast → just one call).
+ */
+export declare function markdownToHtmlFast(source: string, features?: JsFeatures | undefined | null, convertOptions?: JsConvertOptions | undefined | null): MarkdownHtmlOneShot
+
+/**
+ * Plain-Markdown variant of [`mdx_to_js_fast`]: MDX syntax stays literal text.
+ * Used by `markdownToJs` when the caller didn't configure any plugins.
+ */
+export declare function markdownToJsFast(source: string, features?: JsFeatures | undefined | null, options?: JsMdxOptions | undefined | null, convertOptions?: JsConvertOptions | undefined | null): MdxJsOneShot
+
 /**
  * Collect the concatenated text content of an MDAST node and all its descendants.
  * Mirrors `mdast-util-to-string`: collects value from text nodes, alt from images.
  */
 export declare function mdastTextContentHandle(handle: MdastHandle, nodeId: number, options?: JsTextContentOptions | undefined | null): string
 
+/**
+ * One-shot result returned by the no-plugin `mdxToJs` fast path and the
+ * MDAST-plugin fused tail; see [`MarkdownHtmlOneShot`].
+ */
+export interface MdxJsOneShot {
+  code: string
+  frontmatter?: JsFrontmatter
+  droppedTransforms: number
+}
+
+/**
+ * Fast path: parse MDX → MDAST → HAST → JS, plus extract frontmatter, in a
+ * single NAPI roundtrip. Used by `mdxToJs` when the caller didn't configure
+ * any plugins. Skips 5 of the 6 NAPI crossings the handle-based path makes.
+ */
+export declare function mdxToJsFast(source: string, features?: JsFeatures | undefined | null, options?: JsMdxOptions | undefined | null, convertOptions?: JsConvertOptions | undefined | null): MdxJsOneShot
+
 /** Parse ESM (import/export statements) and return ESTree-compatible AST as JSON. */
 export declare function parseEsm(source: string): string | null
 
@@ -250,6 +362,17 @@ export declare function parseToHtml(source: string, features?: JsFeatures | unde
 /** Render a HAST handle's arena to HTML. Does not consume the handle. */
 export declare function renderHandle(handle: HastHandle): string
 
+/**
+ * Result of the fused apply + render tail. `dropped_transforms` mirrors the
+ * count `apply_commands_to_handle` returns: patches dropped because their
+ * target lived inside a removed/replaced subtree; the JS pipeline warns when
+ * non-zero.
+ */
+export interface RenderHtmlOneShot {
+  html: string
+  droppedTransforms: number
+}
+
 /**
  * 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

package/index.js

@@ -3,11 +3,11 @@
 // @ts-nocheck
 /* auto-generated by NAPI-RS */
 
-import { createRequire } from 'node:module'
+import { createRequire } from 'module'
 const require = createRequire(import.meta.url)
 const __dirname = new URL('.', import.meta.url).pathname
 
-const { readFileSync } = require('node:fs')
+const { readFileSync } = require('fs')
 let nativeBinding = null
 const loadErrors = []
 
@@ -37,7 +37,7 @@ const isMuslFromFilesystem = () => {
 
 const isMuslFromReport = () => {
   let report = null
-  if (typeof process.report?.getReport === 'function') {
+  if (process.report && typeof process.report.getReport === 'function') {
     process.report.excludeNetwork = true
     report = process.report.getReport()
   }
@@ -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.8.1' && 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.8.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.9.5' && 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.9.5 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.8.1' && 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.8.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.9.5' && 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.9.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -109,7 +109,7 @@ function requireNative() {
     }
   } else if (process.platform === 'win32') {
     if (process.arch === 'x64') {
-      if (process.config?.variables?.shlib_suffix === 'dll.a' || process.config?.variables?.node_target_type === 'shared_library') {
+      if ((process.config && process.config.variables && process.config.variables.shlib_suffix === 'dll.a') || (process.config && process.config.variables && process.config.variables.node_target_type === 'shared_library')) {
         try {
         return require('./satteri_napi.win32-x64-gnu.node')
       } 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.8.1' && 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.8.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.9.5' && 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.9.5 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.8.1' && 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.8.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.9.5' && 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.9.5 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.8.1' && 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.8.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.9.5' && 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.9.5 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.8.1' && 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.8.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.9.5' && 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.9.5 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.8.1' && 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.8.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      if (bindingPackageVersion !== '0.9.5' && 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.9.5 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.8.1' && 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.8.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.9.5' && 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.9.5 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.8.1' && 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.8.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.9.5' && 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.9.5 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.8.1' && 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.8.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.9.5' && 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.9.5 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.8.1' && 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.8.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.9.5' && 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.9.5 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.8.1' && 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.8.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.9.5' && 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.9.5 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.8.1' && 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.8.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.9.5' && 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.9.5 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.8.1' && 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.8.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.9.5' && 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.9.5 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.8.1' && 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.8.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.9.5' && 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.9.5 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.8.1' && 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.8.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.9.5' && 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.9.5 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.8.1' && 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.8.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.9.5' && 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.9.5 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.8.1' && 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.8.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.9.5' && 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.9.5 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.8.1' && 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.8.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.9.5' && 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.9.5 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.8.1' && 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.8.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.9.5' && 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.9.5 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.8.1' && 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.8.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.9.5' && 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.9.5 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.8.1' && 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.8.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.9.5' && 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.9.5 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.8.1' && 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.8.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.9.5' && 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.9.5 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.8.1' && 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.8.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.9.5' && 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.9.5 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.8.1' && 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.8.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.9.5' && 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.9.5 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.8.1' && 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.8.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.9.5' && 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.9.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -529,23 +529,33 @@ function requireNative() {
 
 nativeBinding = requireNative()
 
-if (!nativeBinding || process.env.NAPI_RS_FORCE_WASI) {
+// NAPI_RS_FORCE_WASI is a tri-state flag:
+//   unset / any other value → native binding preferred, WASI is only a fallback
+//   'true'                   → force WASI fallback even if native loaded
+//   'error'                  → force WASI and throw if no WASI binding is found
+// Treating any non-empty string as truthy (the historical behavior) meant
+// NAPI_RS_FORCE_WASI=false, NAPI_RS_FORCE_WASI=0, etc. inadvertently triggered
+// the WASI path, causing ENOENT for packages shipped without a .wasi.cjs file.
+const forceWasi =
+  process.env.NAPI_RS_FORCE_WASI === 'true' || process.env.NAPI_RS_FORCE_WASI === 'error'
+
+if (!nativeBinding || forceWasi) {
   let wasiBinding = null
   let wasiBindingError = null
   try {
     wasiBinding = require('./satteri_napi.wasi.cjs')
     nativeBinding = wasiBinding
   } catch (err) {
-    if (process.env.NAPI_RS_FORCE_WASI) {
+    if (forceWasi) {
       wasiBindingError = err
     }
   }
-  if (!nativeBinding || process.env.NAPI_RS_FORCE_WASI) {
+  if (!nativeBinding || forceWasi) {
     try {
       wasiBinding = require('@bruits/satteri-wasm32-wasi')
       nativeBinding = wasiBinding
     } catch (err) {
-      if (process.env.NAPI_RS_FORCE_WASI) {
+      if (forceWasi) {
         if (!wasiBindingError) {
           wasiBindingError = err
         } else {
@@ -572,37 +582,48 @@ if (!nativeBinding && globalThis.process?.versions?.['webcontainer']) {
 
 if (!nativeBinding) {
   if (loadErrors.length > 0) {
-    throw new Error(
+    const error = new Error(
       `Cannot find native binding. ` +
         `npm has a bug related to optional dependencies (https://github.com/npm/cli/issues/4828). ` +
         'Please try `npm i` again after removing both package-lock.json and node_modules directory.',
-      {
-        cause: loadErrors.reduce((err, cur) => {
-          cur.cause = err
-          return cur
-        }),
-      },
     )
+    // assign instead of the `new Error(message, { cause })` options form,
+    // which Node < 16.9 silently ignores
+    error.cause = loadErrors.reduce((err, cur) => {
+      cur.cause = err
+      return cur
+    })
+    throw error
   }
   throw new Error(`Failed to load native binding`)
 }
 
-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
+const { applyCommandsAndCompileHandle, applyCommandsAndConvertToHastHandle, applyCommandsAndRenderHandle, applyCommandsToHandle, applyCommandsToMdastHandle, applyMdastCommandsAndConvertAndCompile, applyMdastCommandsAndConvertAndRender, compileHandle, compileMdx, convertMdastToHastHandle, createHastHandle, createHastHandleFromHtml, createHastHandleWithFrontmatter, createMdastHandle, createMdxHastHandle, createMdxHastHandleWithFrontmatter, createMdxMdastHandle, dropHandle, getHandleSource, getMdastFrontmatter, getNodeData, markdownToHtmlFast, markdownToJsFast, mdastTextContentHandle, mdxToJsFast, parseEsm, parseExpression, parseToHtml, renderHandle, serializeHandle, setNodeData, textContentHandle, walkHandle, walkMdastHandle } = nativeBinding
+export { applyCommandsAndCompileHandle }
 export { applyCommandsAndConvertToHastHandle }
+export { applyCommandsAndRenderHandle }
 export { applyCommandsToHandle }
 export { applyCommandsToMdastHandle }
+export { applyMdastCommandsAndConvertAndCompile }
+export { applyMdastCommandsAndConvertAndRender }
 export { compileHandle }
 export { compileMdx }
 export { convertMdastToHastHandle }
 export { createHastHandle }
+export { createHastHandleFromHtml }
+export { createHastHandleWithFrontmatter }
 export { createMdastHandle }
 export { createMdxHastHandle }
+export { createMdxHastHandleWithFrontmatter }
 export { createMdxMdastHandle }
 export { dropHandle }
 export { getHandleSource }
 export { getMdastFrontmatter }
 export { getNodeData }
+export { markdownToHtmlFast }
+export { markdownToJsFast }
 export { mdastTextContentHandle }
+export { mdxToJsFast }
 export { parseEsm }
 export { parseExpression }
 export { parseToHtml }