html-to-markdown-wasm 2.8.2 → 2.9.0

package/README.md

@@ -15,7 +15,7 @@ Runs anywhere: Node.js, Deno, Bun, browsers, and edge runtimes.
 [![PyPI](https://badge.fury.io/py/html-to-markdown.svg)](https://pypi.org/project/html-to-markdown/)
 [![Packagist](https://img.shields.io/packagist/v/goldziher/html-to-markdown.svg)](https://packagist.org/packages/goldziher/html-to-markdown)
 [![RubyGems](https://badge.fury.io/rb/html-to-markdown.svg)](https://rubygems.org/gems/html-to-markdown)
-[![NuGet](https://img.shields.io/nuget/v/HtmlToMarkdown.svg)](https://www.nuget.org/packages/HtmlToMarkdown/)
+[![NuGet](https://img.shields.io/nuget/v/Goldziher.HtmlToMarkdown.svg)](https://www.nuget.org/packages/Goldziher.HtmlToMarkdown/)
 [![Maven Central](https://img.shields.io/maven-central/v/io.github.goldziher/html-to-markdown.svg)](https://central.sonatype.com/artifact/io.github.goldziher/html-to-markdown)
 [![Go Reference](https://pkg.go.dev/badge/github.com/Goldziher/html-to-markdown/packages/go/htmltomarkdown.svg)](https://pkg.go.dev/github.com/Goldziher/html-to-markdown/packages/go/htmltomarkdown)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/Goldziher/html-to-markdown/blob/main/LICENSE)

package/dist/README.md

@@ -9,7 +9,7 @@ High-performance HTML → Markdown conversion powered by Rust. Shipping as a Rus
 [![Packagist](https://img.shields.io/packagist/v/goldziher/html-to-markdown.svg)](https://packagist.org/packages/goldziher/html-to-markdown)
 [![RubyGems](https://badge.fury.io/rb/html-to-markdown.svg)](https://rubygems.org/gems/html-to-markdown)
 [![Hex.pm](https://img.shields.io/hexpm/v/html_to_markdown.svg)](https://hex.pm/packages/html_to_markdown)
-[![NuGet](https://img.shields.io/nuget/v/HtmlToMarkdown.svg)](https://www.nuget.org/packages/HtmlToMarkdown/)
+[![NuGet](https://img.shields.io/nuget/v/Goldziher.HtmlToMarkdown.svg)](https://www.nuget.org/packages/Goldziher.HtmlToMarkdown/)
 [![Maven Central](https://img.shields.io/maven-central/v/io.github.goldziher/html-to-markdown.svg)](https://central.sonatype.com/artifact/io.github.goldziher/html-to-markdown)
 [![Go Reference](https://pkg.go.dev/badge/github.com/Goldziher/html-to-markdown/packages/go/htmltomarkdown.svg)](https://pkg.go.dev/github.com/Goldziher/html-to-markdown/packages/go/htmltomarkdown)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/Goldziher/html-to-markdown/blob/main/LICENSE)
@@ -219,6 +219,20 @@ Need a call-stack view of the Rust core? Run `task flamegraph:rust` (or call the
 
 ## Compatibility (v1 → v2)
 
+## Testing
+
+Use the task runner to execute the entire matrix locally:
+
+```bash
+# All core test suites (Rust, Python, Ruby, Node, PHP, Go, C#, Elixir, Java)
+task test
+
+# Run the Wasmtime-backed WASM integration tests
+task wasm:test:wasmtime
+```
+
+The Wasmtime suite builds the `html-to-markdown-wasm` artifact with the same flags used in CI and drives it through Wasmtime to ensure the non-JS runtime behaves exactly like the browser/Deno builds.
+
 - V2’s Rust core sustains **150–210 MB/s** throughput; V1 averaged **≈ 2.5 MB/s** in its Python/BeautifulSoup implementation (60–80× faster).
 - The Python package offers a compatibility shim in `html_to_markdown.v1_compat` (`convert_to_markdown`, `convert_to_markdown_stream`, `markdownify`). The shim is deprecated, emits `DeprecationWarning` on every call, and will be removed in v3.0—plan migrations now. Details and keyword mappings live in [Python README](https://github.com/Goldziher/html-to-markdown/blob/main/packages/python/README.md#v1-compatibility).
 - CLI flag changes, option renames, and other breaking updates are summarised in [CHANGELOG](https://github.com/Goldziher/html-to-markdown/blob/main/CHANGELOG.md#breaking-changes).

package/dist/html_to_markdown_wasm.d.ts

@@ -1,9 +1,9 @@
 /* tslint:disable */
 /* eslint-disable */
-export function createConversionOptionsHandle(options: any): WasmConversionOptionsHandle;
-export function convertWithInlineImages(html: string, options: any, image_config?: WasmInlineImageConfig | null): WasmHtmlExtraction;
-export function convertBytesWithOptionsHandle(html: Uint8Array, handle: WasmConversionOptionsHandle): string;
-export function convertWithOptionsHandle(html: string, handle: WasmConversionOptionsHandle): string;
+/**
+ * Initialize panic hook for better error messages in the browser
+ */
+export function init(): void;
 export function convertBytes(html: Uint8Array, options: any): string;
 /**
  * Convert HTML to Markdown
@@ -24,11 +24,11 @@ export function convertBytes(html: Uint8Array, options: any): string;
  * ```
  */
 export function convert(html: string, options: any): string;
+export function convertWithInlineImages(html: string, options: any, image_config?: WasmInlineImageConfig | null): WasmHtmlExtraction;
+export function convertBytesWithOptionsHandle(html: Uint8Array, handle: WasmConversionOptionsHandle): string;
+export function convertWithOptionsHandle(html: string, handle: WasmConversionOptionsHandle): string;
 export function convertBytesWithInlineImages(html: Uint8Array, options: any, image_config?: WasmInlineImageConfig | null): WasmHtmlExtraction;
-/**
- * Initialize panic hook for better error messages in the browser
- */
-export function init(): void;
+export function createConversionOptionsHandle(options: any): WasmConversionOptionsHandle;
 export class WasmConversionOptionsHandle {
   free(): void;
   [Symbol.dispose](): void;

package/dist/html_to_markdown_wasm_bg.js

@@ -232,71 +232,23 @@ function getArrayJsValueFromWasm0(ptr, len) {
     return result;
 }
 /**
- * @param {any} options
- * @returns {WasmConversionOptionsHandle}
- */
-export function createConversionOptionsHandle(options) {
-    try {
-        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-        wasm.createConversionOptionsHandle(retptr, addHeapObject(options));
-        var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
-        var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
-        var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
-        if (r2) {
-            throw takeObject(r1);
-        }
-        return WasmConversionOptionsHandle.__wrap(r0);
-    } finally {
-        wasm.__wbindgen_add_to_stack_pointer(16);
-    }
-}
-
-function _assertClass(instance, klass) {
-    if (!(instance instanceof klass)) {
-        throw new Error(`expected instance of ${klass.name}`);
-    }
-}
-/**
- * @param {string} html
- * @param {any} options
- * @param {WasmInlineImageConfig | null} [image_config]
- * @returns {WasmHtmlExtraction}
+ * Initialize panic hook for better error messages in the browser
  */
-export function convertWithInlineImages(html, options, image_config) {
-    try {
-        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-        const ptr0 = passStringToWasm0(html, wasm.__wbindgen_export, wasm.__wbindgen_export2);
-        const len0 = WASM_VECTOR_LEN;
-        let ptr1 = 0;
-        if (!isLikeNone(image_config)) {
-            _assertClass(image_config, WasmInlineImageConfig);
-            ptr1 = image_config.__destroy_into_raw();
-        }
-        wasm.convertWithInlineImages(retptr, ptr0, len0, addHeapObject(options), ptr1);
-        var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
-        var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
-        var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
-        if (r2) {
-            throw takeObject(r1);
-        }
-        return WasmHtmlExtraction.__wrap(r0);
-    } finally {
-        wasm.__wbindgen_add_to_stack_pointer(16);
-    }
+export function init() {
+    wasm.init();
 }
 
 /**
  * @param {Uint8Array} html
- * @param {WasmConversionOptionsHandle} handle
+ * @param {any} options
  * @returns {string}
  */
-export function convertBytesWithOptionsHandle(html, handle) {
+export function convertBytes(html, options) {
     let deferred2_0;
     let deferred2_1;
     try {
         const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-        _assertClass(handle, WasmConversionOptionsHandle);
-        wasm.convertBytesWithOptionsHandle(retptr, addHeapObject(html), handle.__wbg_ptr);
+        wasm.convertBytes(retptr, addHeapObject(html), addHeapObject(options));
         var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
         var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
         var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
@@ -317,19 +269,34 @@ export function convertBytesWithOptionsHandle(html, handle) {
 }
 
 /**
+ * Convert HTML to Markdown
+ *
+ * # Arguments
+ *
+ * * `html` - The HTML string to convert
+ * * `options` - Optional conversion options (as a JavaScript object)
+ *
+ * # Example
+ *
+ * ```javascript
+ * import { convert } from 'html-to-markdown-wasm';
+ *
+ * const html = '<h1>Hello World</h1>';
+ * const markdown = convert(html);
+ * console.log(markdown); // # Hello World
+ * ```
  * @param {string} html
- * @param {WasmConversionOptionsHandle} handle
+ * @param {any} options
  * @returns {string}
  */
-export function convertWithOptionsHandle(html, handle) {
+export function convert(html, options) {
     let deferred3_0;
     let deferred3_1;
     try {
         const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
         const ptr0 = passStringToWasm0(html, wasm.__wbindgen_export, wasm.__wbindgen_export2);
         const len0 = WASM_VECTOR_LEN;
-        _assertClass(handle, WasmConversionOptionsHandle);
-        wasm.convertWithOptionsHandle(retptr, ptr0, len0, handle.__wbg_ptr);
+        wasm.convert(retptr, ptr0, len0, addHeapObject(options));
         var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
         var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
         var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
@@ -349,17 +316,52 @@ export function convertWithOptionsHandle(html, handle) {
     }
 }
 
+function _assertClass(instance, klass) {
+    if (!(instance instanceof klass)) {
+        throw new Error(`expected instance of ${klass.name}`);
+    }
+}
 /**
- * @param {Uint8Array} html
+ * @param {string} html
  * @param {any} options
+ * @param {WasmInlineImageConfig | null} [image_config]
+ * @returns {WasmHtmlExtraction}
+ */
+export function convertWithInlineImages(html, options, image_config) {
+    try {
+        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+        const ptr0 = passStringToWasm0(html, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+        const len0 = WASM_VECTOR_LEN;
+        let ptr1 = 0;
+        if (!isLikeNone(image_config)) {
+            _assertClass(image_config, WasmInlineImageConfig);
+            ptr1 = image_config.__destroy_into_raw();
+        }
+        wasm.convertWithInlineImages(retptr, ptr0, len0, addHeapObject(options), ptr1);
+        var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+        var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+        var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+        if (r2) {
+            throw takeObject(r1);
+        }
+        return WasmHtmlExtraction.__wrap(r0);
+    } finally {
+        wasm.__wbindgen_add_to_stack_pointer(16);
+    }
+}
+
+/**
+ * @param {Uint8Array} html
+ * @param {WasmConversionOptionsHandle} handle
  * @returns {string}
  */
-export function convertBytes(html, options) {
+export function convertBytesWithOptionsHandle(html, handle) {
     let deferred2_0;
     let deferred2_1;
     try {
         const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-        wasm.convertBytes(retptr, addHeapObject(html), addHeapObject(options));
+        _assertClass(handle, WasmConversionOptionsHandle);
+        wasm.convertBytesWithOptionsHandle(retptr, addHeapObject(html), handle.__wbg_ptr);
         var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
         var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
         var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
@@ -380,34 +382,19 @@ export function convertBytes(html, options) {
 }
 
 /**
- * Convert HTML to Markdown
- *
- * # Arguments
- *
- * * `html` - The HTML string to convert
- * * `options` - Optional conversion options (as a JavaScript object)
- *
- * # Example
- *
- * ```javascript
- * import { convert } from 'html-to-markdown-wasm';
- *
- * const html = '<h1>Hello World</h1>';
- * const markdown = convert(html);
- * console.log(markdown); // # Hello World
- * ```
  * @param {string} html
- * @param {any} options
+ * @param {WasmConversionOptionsHandle} handle
  * @returns {string}
  */
-export function convert(html, options) {
+export function convertWithOptionsHandle(html, handle) {
     let deferred3_0;
     let deferred3_1;
     try {
         const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
         const ptr0 = passStringToWasm0(html, wasm.__wbindgen_export, wasm.__wbindgen_export2);
         const len0 = WASM_VECTOR_LEN;
-        wasm.convert(retptr, ptr0, len0, addHeapObject(options));
+        _assertClass(handle, WasmConversionOptionsHandle);
+        wasm.convertWithOptionsHandle(retptr, ptr0, len0, handle.__wbg_ptr);
         var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
         var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
         var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
@@ -455,10 +442,23 @@ export function convertBytesWithInlineImages(html, options, image_config) {
 }
 
 /**
- * Initialize panic hook for better error messages in the browser
+ * @param {any} options
+ * @returns {WasmConversionOptionsHandle}
  */
-export function init() {
-    wasm.init();
+export function createConversionOptionsHandle(options) {
+    try {
+        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+        wasm.createConversionOptionsHandle(retptr, addHeapObject(options));
+        var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+        var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+        var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+        if (r2) {
+            throw takeObject(r1);
+        }
+        return WasmConversionOptionsHandle.__wrap(r0);
+    } finally {
+        wasm.__wbindgen_add_to_stack_pointer(16);
+    }
 }
 
 const WasmConversionOptionsHandleFinalization = (typeof FinalizationRegistry === 'undefined')

package/dist/package.json

@@ -4,7 +4,7 @@
   "collaborators": [
     "Na'aman Hirschfeld <nhirschfeld@gmail.com>"
   ],
-  "version": "2.8.2",
+  "version": "2.9.0",
   "license": "MIT",
   "repository": {
     "type": "git",

package/dist-node/README.md

@@ -9,7 +9,7 @@ High-performance HTML → Markdown conversion powered by Rust. Shipping as a Rus
 [![Packagist](https://img.shields.io/packagist/v/goldziher/html-to-markdown.svg)](https://packagist.org/packages/goldziher/html-to-markdown)
 [![RubyGems](https://badge.fury.io/rb/html-to-markdown.svg)](https://rubygems.org/gems/html-to-markdown)
 [![Hex.pm](https://img.shields.io/hexpm/v/html_to_markdown.svg)](https://hex.pm/packages/html_to_markdown)
-[![NuGet](https://img.shields.io/nuget/v/HtmlToMarkdown.svg)](https://www.nuget.org/packages/HtmlToMarkdown/)
+[![NuGet](https://img.shields.io/nuget/v/Goldziher.HtmlToMarkdown.svg)](https://www.nuget.org/packages/Goldziher.HtmlToMarkdown/)
 [![Maven Central](https://img.shields.io/maven-central/v/io.github.goldziher/html-to-markdown.svg)](https://central.sonatype.com/artifact/io.github.goldziher/html-to-markdown)
 [![Go Reference](https://pkg.go.dev/badge/github.com/Goldziher/html-to-markdown/packages/go/htmltomarkdown.svg)](https://pkg.go.dev/github.com/Goldziher/html-to-markdown/packages/go/htmltomarkdown)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/Goldziher/html-to-markdown/blob/main/LICENSE)
@@ -219,6 +219,20 @@ Need a call-stack view of the Rust core? Run `task flamegraph:rust` (or call the
 
 ## Compatibility (v1 → v2)
 
+## Testing
+
+Use the task runner to execute the entire matrix locally:
+
+```bash
+# All core test suites (Rust, Python, Ruby, Node, PHP, Go, C#, Elixir, Java)
+task test
+
+# Run the Wasmtime-backed WASM integration tests
+task wasm:test:wasmtime
+```
+
+The Wasmtime suite builds the `html-to-markdown-wasm` artifact with the same flags used in CI and drives it through Wasmtime to ensure the non-JS runtime behaves exactly like the browser/Deno builds.
+
 - V2’s Rust core sustains **150–210 MB/s** throughput; V1 averaged **≈ 2.5 MB/s** in its Python/BeautifulSoup implementation (60–80× faster).
 - The Python package offers a compatibility shim in `html_to_markdown.v1_compat` (`convert_to_markdown`, `convert_to_markdown_stream`, `markdownify`). The shim is deprecated, emits `DeprecationWarning` on every call, and will be removed in v3.0—plan migrations now. Details and keyword mappings live in [Python README](https://github.com/Goldziher/html-to-markdown/blob/main/packages/python/README.md#v1-compatibility).
 - CLI flag changes, option renames, and other breaking updates are summarised in [CHANGELOG](https://github.com/Goldziher/html-to-markdown/blob/main/CHANGELOG.md#breaking-changes).

package/dist-node/html_to_markdown_wasm.d.ts

@@ -1,9 +1,9 @@
 /* tslint:disable */
 /* eslint-disable */
-export function createConversionOptionsHandle(options: any): WasmConversionOptionsHandle;
-export function convertWithInlineImages(html: string, options: any, image_config?: WasmInlineImageConfig | null): WasmHtmlExtraction;
-export function convertBytesWithOptionsHandle(html: Uint8Array, handle: WasmConversionOptionsHandle): string;
-export function convertWithOptionsHandle(html: string, handle: WasmConversionOptionsHandle): string;
+/**
+ * Initialize panic hook for better error messages in the browser
+ */
+export function init(): void;
 export function convertBytes(html: Uint8Array, options: any): string;
 /**
  * Convert HTML to Markdown
@@ -24,11 +24,11 @@ export function convertBytes(html: Uint8Array, options: any): string;
  * ```
  */
 export function convert(html: string, options: any): string;
+export function convertWithInlineImages(html: string, options: any, image_config?: WasmInlineImageConfig | null): WasmHtmlExtraction;
+export function convertBytesWithOptionsHandle(html: Uint8Array, handle: WasmConversionOptionsHandle): string;
+export function convertWithOptionsHandle(html: string, handle: WasmConversionOptionsHandle): string;
 export function convertBytesWithInlineImages(html: Uint8Array, options: any, image_config?: WasmInlineImageConfig | null): WasmHtmlExtraction;
-/**
- * Initialize panic hook for better error messages in the browser
- */
-export function init(): void;
+export function createConversionOptionsHandle(options: any): WasmConversionOptionsHandle;
 export class WasmConversionOptionsHandle {
   free(): void;
   [Symbol.dispose](): void;

package/dist-node/html_to_markdown_wasm.js

@@ -222,71 +222,23 @@ function getArrayJsValueFromWasm0(ptr, len) {
     return result;
 }
 /**
- * @param {any} options
- * @returns {WasmConversionOptionsHandle}
- */
-exports.createConversionOptionsHandle = function(options) {
-    try {
-        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-        wasm.createConversionOptionsHandle(retptr, addHeapObject(options));
-        var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
-        var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
-        var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
-        if (r2) {
-            throw takeObject(r1);
-        }
-        return WasmConversionOptionsHandle.__wrap(r0);
-    } finally {
-        wasm.__wbindgen_add_to_stack_pointer(16);
-    }
-};
-
-function _assertClass(instance, klass) {
-    if (!(instance instanceof klass)) {
-        throw new Error(`expected instance of ${klass.name}`);
-    }
-}
-/**
- * @param {string} html
- * @param {any} options
- * @param {WasmInlineImageConfig | null} [image_config]
- * @returns {WasmHtmlExtraction}
+ * Initialize panic hook for better error messages in the browser
  */
-exports.convertWithInlineImages = function(html, options, image_config) {
-    try {
-        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-        const ptr0 = passStringToWasm0(html, wasm.__wbindgen_export, wasm.__wbindgen_export2);
-        const len0 = WASM_VECTOR_LEN;
-        let ptr1 = 0;
-        if (!isLikeNone(image_config)) {
-            _assertClass(image_config, WasmInlineImageConfig);
-            ptr1 = image_config.__destroy_into_raw();
-        }
-        wasm.convertWithInlineImages(retptr, ptr0, len0, addHeapObject(options), ptr1);
-        var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
-        var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
-        var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
-        if (r2) {
-            throw takeObject(r1);
-        }
-        return WasmHtmlExtraction.__wrap(r0);
-    } finally {
-        wasm.__wbindgen_add_to_stack_pointer(16);
-    }
+exports.init = function() {
+    wasm.init();
 };
 
 /**
  * @param {Uint8Array} html
- * @param {WasmConversionOptionsHandle} handle
+ * @param {any} options
  * @returns {string}
  */
-exports.convertBytesWithOptionsHandle = function(html, handle) {
+exports.convertBytes = function(html, options) {
     let deferred2_0;
     let deferred2_1;
     try {
         const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-        _assertClass(handle, WasmConversionOptionsHandle);
-        wasm.convertBytesWithOptionsHandle(retptr, addHeapObject(html), handle.__wbg_ptr);
+        wasm.convertBytes(retptr, addHeapObject(html), addHeapObject(options));
         var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
         var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
         var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
@@ -307,19 +259,34 @@ exports.convertBytesWithOptionsHandle = function(html, handle) {
 };
 
 /**
+ * Convert HTML to Markdown
+ *
+ * # Arguments
+ *
+ * * `html` - The HTML string to convert
+ * * `options` - Optional conversion options (as a JavaScript object)
+ *
+ * # Example
+ *
+ * ```javascript
+ * import { convert } from 'html-to-markdown-wasm';
+ *
+ * const html = '<h1>Hello World</h1>';
+ * const markdown = convert(html);
+ * console.log(markdown); // # Hello World
+ * ```
  * @param {string} html
- * @param {WasmConversionOptionsHandle} handle
+ * @param {any} options
  * @returns {string}
  */
-exports.convertWithOptionsHandle = function(html, handle) {
+exports.convert = function(html, options) {
     let deferred3_0;
     let deferred3_1;
     try {
         const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
         const ptr0 = passStringToWasm0(html, wasm.__wbindgen_export, wasm.__wbindgen_export2);
         const len0 = WASM_VECTOR_LEN;
-        _assertClass(handle, WasmConversionOptionsHandle);
-        wasm.convertWithOptionsHandle(retptr, ptr0, len0, handle.__wbg_ptr);
+        wasm.convert(retptr, ptr0, len0, addHeapObject(options));
         var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
         var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
         var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
@@ -339,17 +306,52 @@ exports.convertWithOptionsHandle = function(html, handle) {
     }
 };
 
+function _assertClass(instance, klass) {
+    if (!(instance instanceof klass)) {
+        throw new Error(`expected instance of ${klass.name}`);
+    }
+}
 /**
- * @param {Uint8Array} html
+ * @param {string} html
  * @param {any} options
+ * @param {WasmInlineImageConfig | null} [image_config]
+ * @returns {WasmHtmlExtraction}
+ */
+exports.convertWithInlineImages = function(html, options, image_config) {
+    try {
+        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+        const ptr0 = passStringToWasm0(html, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+        const len0 = WASM_VECTOR_LEN;
+        let ptr1 = 0;
+        if (!isLikeNone(image_config)) {
+            _assertClass(image_config, WasmInlineImageConfig);
+            ptr1 = image_config.__destroy_into_raw();
+        }
+        wasm.convertWithInlineImages(retptr, ptr0, len0, addHeapObject(options), ptr1);
+        var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+        var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+        var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+        if (r2) {
+            throw takeObject(r1);
+        }
+        return WasmHtmlExtraction.__wrap(r0);
+    } finally {
+        wasm.__wbindgen_add_to_stack_pointer(16);
+    }
+};
+
+/**
+ * @param {Uint8Array} html
+ * @param {WasmConversionOptionsHandle} handle
  * @returns {string}
  */
-exports.convertBytes = function(html, options) {
+exports.convertBytesWithOptionsHandle = function(html, handle) {
     let deferred2_0;
     let deferred2_1;
     try {
         const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-        wasm.convertBytes(retptr, addHeapObject(html), addHeapObject(options));
+        _assertClass(handle, WasmConversionOptionsHandle);
+        wasm.convertBytesWithOptionsHandle(retptr, addHeapObject(html), handle.__wbg_ptr);
         var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
         var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
         var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
@@ -370,34 +372,19 @@ exports.convertBytes = function(html, options) {
 };
 
 /**
- * Convert HTML to Markdown
- *
- * # Arguments
- *
- * * `html` - The HTML string to convert
- * * `options` - Optional conversion options (as a JavaScript object)
- *
- * # Example
- *
- * ```javascript
- * import { convert } from 'html-to-markdown-wasm';
- *
- * const html = '<h1>Hello World</h1>';
- * const markdown = convert(html);
- * console.log(markdown); // # Hello World
- * ```
  * @param {string} html
- * @param {any} options
+ * @param {WasmConversionOptionsHandle} handle
  * @returns {string}
  */
-exports.convert = function(html, options) {
+exports.convertWithOptionsHandle = function(html, handle) {
     let deferred3_0;
     let deferred3_1;
     try {
         const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
         const ptr0 = passStringToWasm0(html, wasm.__wbindgen_export, wasm.__wbindgen_export2);
         const len0 = WASM_VECTOR_LEN;
-        wasm.convert(retptr, ptr0, len0, addHeapObject(options));
+        _assertClass(handle, WasmConversionOptionsHandle);
+        wasm.convertWithOptionsHandle(retptr, ptr0, len0, handle.__wbg_ptr);
         var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
         var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
         var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
@@ -445,10 +432,23 @@ exports.convertBytesWithInlineImages = function(html, options, image_config) {
 };
 
 /**
- * Initialize panic hook for better error messages in the browser
+ * @param {any} options
+ * @returns {WasmConversionOptionsHandle}
  */
-exports.init = function() {
-    wasm.init();
+exports.createConversionOptionsHandle = function(options) {
+    try {
+        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+        wasm.createConversionOptionsHandle(retptr, addHeapObject(options));
+        var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+        var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+        var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+        if (r2) {
+            throw takeObject(r1);
+        }
+        return WasmConversionOptionsHandle.__wrap(r0);
+    } finally {
+        wasm.__wbindgen_add_to_stack_pointer(16);
+    }
 };
 
 const WasmConversionOptionsHandleFinalization = (typeof FinalizationRegistry === 'undefined')

package/dist-node/package.json

@@ -3,7 +3,7 @@
   "collaborators": [
     "Na'aman Hirschfeld <nhirschfeld@gmail.com>"
   ],
-  "version": "2.8.2",
+  "version": "2.9.0",
   "license": "MIT",
   "repository": {
     "type": "git",

package/dist-web/README.md

@@ -9,7 +9,7 @@ High-performance HTML → Markdown conversion powered by Rust. Shipping as a Rus
 [![Packagist](https://img.shields.io/packagist/v/goldziher/html-to-markdown.svg)](https://packagist.org/packages/goldziher/html-to-markdown)
 [![RubyGems](https://badge.fury.io/rb/html-to-markdown.svg)](https://rubygems.org/gems/html-to-markdown)
 [![Hex.pm](https://img.shields.io/hexpm/v/html_to_markdown.svg)](https://hex.pm/packages/html_to_markdown)
-[![NuGet](https://img.shields.io/nuget/v/HtmlToMarkdown.svg)](https://www.nuget.org/packages/HtmlToMarkdown/)
+[![NuGet](https://img.shields.io/nuget/v/Goldziher.HtmlToMarkdown.svg)](https://www.nuget.org/packages/Goldziher.HtmlToMarkdown/)
 [![Maven Central](https://img.shields.io/maven-central/v/io.github.goldziher/html-to-markdown.svg)](https://central.sonatype.com/artifact/io.github.goldziher/html-to-markdown)
 [![Go Reference](https://pkg.go.dev/badge/github.com/Goldziher/html-to-markdown/packages/go/htmltomarkdown.svg)](https://pkg.go.dev/github.com/Goldziher/html-to-markdown/packages/go/htmltomarkdown)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/Goldziher/html-to-markdown/blob/main/LICENSE)
@@ -219,6 +219,20 @@ Need a call-stack view of the Rust core? Run `task flamegraph:rust` (or call the
 
 ## Compatibility (v1 → v2)
 
+## Testing
+
+Use the task runner to execute the entire matrix locally:
+
+```bash
+# All core test suites (Rust, Python, Ruby, Node, PHP, Go, C#, Elixir, Java)
+task test
+
+# Run the Wasmtime-backed WASM integration tests
+task wasm:test:wasmtime
+```
+
+The Wasmtime suite builds the `html-to-markdown-wasm` artifact with the same flags used in CI and drives it through Wasmtime to ensure the non-JS runtime behaves exactly like the browser/Deno builds.
+
 - V2’s Rust core sustains **150–210 MB/s** throughput; V1 averaged **≈ 2.5 MB/s** in its Python/BeautifulSoup implementation (60–80× faster).
 - The Python package offers a compatibility shim in `html_to_markdown.v1_compat` (`convert_to_markdown`, `convert_to_markdown_stream`, `markdownify`). The shim is deprecated, emits `DeprecationWarning` on every call, and will be removed in v3.0—plan migrations now. Details and keyword mappings live in [Python README](https://github.com/Goldziher/html-to-markdown/blob/main/packages/python/README.md#v1-compatibility).
 - CLI flag changes, option renames, and other breaking updates are summarised in [CHANGELOG](https://github.com/Goldziher/html-to-markdown/blob/main/CHANGELOG.md#breaking-changes).

package/dist-web/html_to_markdown_wasm.d.ts

@@ -1,9 +1,9 @@
 /* tslint:disable */
 /* eslint-disable */
-export function createConversionOptionsHandle(options: any): WasmConversionOptionsHandle;
-export function convertWithInlineImages(html: string, options: any, image_config?: WasmInlineImageConfig | null): WasmHtmlExtraction;
-export function convertBytesWithOptionsHandle(html: Uint8Array, handle: WasmConversionOptionsHandle): string;
-export function convertWithOptionsHandle(html: string, handle: WasmConversionOptionsHandle): string;
+/**
+ * Initialize panic hook for better error messages in the browser
+ */
+export function init(): void;
 export function convertBytes(html: Uint8Array, options: any): string;
 /**
  * Convert HTML to Markdown
@@ -24,11 +24,11 @@ export function convertBytes(html: Uint8Array, options: any): string;
  * ```
  */
 export function convert(html: string, options: any): string;
+export function convertWithInlineImages(html: string, options: any, image_config?: WasmInlineImageConfig | null): WasmHtmlExtraction;
+export function convertBytesWithOptionsHandle(html: Uint8Array, handle: WasmConversionOptionsHandle): string;
+export function convertWithOptionsHandle(html: string, handle: WasmConversionOptionsHandle): string;
 export function convertBytesWithInlineImages(html: Uint8Array, options: any, image_config?: WasmInlineImageConfig | null): WasmHtmlExtraction;
-/**
- * Initialize panic hook for better error messages in the browser
- */
-export function init(): void;
+export function createConversionOptionsHandle(options: any): WasmConversionOptionsHandle;
 export class WasmConversionOptionsHandle {
   free(): void;
   [Symbol.dispose](): void;

package/dist-web/html_to_markdown_wasm.js

@@ -228,71 +228,23 @@ function getArrayJsValueFromWasm0(ptr, len) {
     return result;
 }
 /**
- * @param {any} options
- * @returns {WasmConversionOptionsHandle}
- */
-export function createConversionOptionsHandle(options) {
-    try {
-        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-        wasm.createConversionOptionsHandle(retptr, addHeapObject(options));
-        var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
-        var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
-        var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
-        if (r2) {
-            throw takeObject(r1);
-        }
-        return WasmConversionOptionsHandle.__wrap(r0);
-    } finally {
-        wasm.__wbindgen_add_to_stack_pointer(16);
-    }
-}
-
-function _assertClass(instance, klass) {
-    if (!(instance instanceof klass)) {
-        throw new Error(`expected instance of ${klass.name}`);
-    }
-}
-/**
- * @param {string} html
- * @param {any} options
- * @param {WasmInlineImageConfig | null} [image_config]
- * @returns {WasmHtmlExtraction}
+ * Initialize panic hook for better error messages in the browser
  */
-export function convertWithInlineImages(html, options, image_config) {
-    try {
-        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-        const ptr0 = passStringToWasm0(html, wasm.__wbindgen_export, wasm.__wbindgen_export2);
-        const len0 = WASM_VECTOR_LEN;
-        let ptr1 = 0;
-        if (!isLikeNone(image_config)) {
-            _assertClass(image_config, WasmInlineImageConfig);
-            ptr1 = image_config.__destroy_into_raw();
-        }
-        wasm.convertWithInlineImages(retptr, ptr0, len0, addHeapObject(options), ptr1);
-        var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
-        var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
-        var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
-        if (r2) {
-            throw takeObject(r1);
-        }
-        return WasmHtmlExtraction.__wrap(r0);
-    } finally {
-        wasm.__wbindgen_add_to_stack_pointer(16);
-    }
+export function init() {
+    wasm.init();
 }
 
 /**
  * @param {Uint8Array} html
- * @param {WasmConversionOptionsHandle} handle
+ * @param {any} options
  * @returns {string}
  */
-export function convertBytesWithOptionsHandle(html, handle) {
+export function convertBytes(html, options) {
     let deferred2_0;
     let deferred2_1;
     try {
         const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-        _assertClass(handle, WasmConversionOptionsHandle);
-        wasm.convertBytesWithOptionsHandle(retptr, addHeapObject(html), handle.__wbg_ptr);
+        wasm.convertBytes(retptr, addHeapObject(html), addHeapObject(options));
         var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
         var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
         var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
@@ -313,19 +265,34 @@ export function convertBytesWithOptionsHandle(html, handle) {
 }
 
 /**
+ * Convert HTML to Markdown
+ *
+ * # Arguments
+ *
+ * * `html` - The HTML string to convert
+ * * `options` - Optional conversion options (as a JavaScript object)
+ *
+ * # Example
+ *
+ * ```javascript
+ * import { convert } from 'html-to-markdown-wasm';
+ *
+ * const html = '<h1>Hello World</h1>';
+ * const markdown = convert(html);
+ * console.log(markdown); // # Hello World
+ * ```
  * @param {string} html
- * @param {WasmConversionOptionsHandle} handle
+ * @param {any} options
  * @returns {string}
  */
-export function convertWithOptionsHandle(html, handle) {
+export function convert(html, options) {
     let deferred3_0;
     let deferred3_1;
     try {
         const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
         const ptr0 = passStringToWasm0(html, wasm.__wbindgen_export, wasm.__wbindgen_export2);
         const len0 = WASM_VECTOR_LEN;
-        _assertClass(handle, WasmConversionOptionsHandle);
-        wasm.convertWithOptionsHandle(retptr, ptr0, len0, handle.__wbg_ptr);
+        wasm.convert(retptr, ptr0, len0, addHeapObject(options));
         var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
         var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
         var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
@@ -345,17 +312,52 @@ export function convertWithOptionsHandle(html, handle) {
     }
 }
 
+function _assertClass(instance, klass) {
+    if (!(instance instanceof klass)) {
+        throw new Error(`expected instance of ${klass.name}`);
+    }
+}
 /**
- * @param {Uint8Array} html
+ * @param {string} html
  * @param {any} options
+ * @param {WasmInlineImageConfig | null} [image_config]
+ * @returns {WasmHtmlExtraction}
+ */
+export function convertWithInlineImages(html, options, image_config) {
+    try {
+        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+        const ptr0 = passStringToWasm0(html, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+        const len0 = WASM_VECTOR_LEN;
+        let ptr1 = 0;
+        if (!isLikeNone(image_config)) {
+            _assertClass(image_config, WasmInlineImageConfig);
+            ptr1 = image_config.__destroy_into_raw();
+        }
+        wasm.convertWithInlineImages(retptr, ptr0, len0, addHeapObject(options), ptr1);
+        var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+        var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+        var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+        if (r2) {
+            throw takeObject(r1);
+        }
+        return WasmHtmlExtraction.__wrap(r0);
+    } finally {
+        wasm.__wbindgen_add_to_stack_pointer(16);
+    }
+}
+
+/**
+ * @param {Uint8Array} html
+ * @param {WasmConversionOptionsHandle} handle
  * @returns {string}
  */
-export function convertBytes(html, options) {
+export function convertBytesWithOptionsHandle(html, handle) {
     let deferred2_0;
     let deferred2_1;
     try {
         const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-        wasm.convertBytes(retptr, addHeapObject(html), addHeapObject(options));
+        _assertClass(handle, WasmConversionOptionsHandle);
+        wasm.convertBytesWithOptionsHandle(retptr, addHeapObject(html), handle.__wbg_ptr);
         var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
         var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
         var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
@@ -376,34 +378,19 @@ export function convertBytes(html, options) {
 }
 
 /**
- * Convert HTML to Markdown
- *
- * # Arguments
- *
- * * `html` - The HTML string to convert
- * * `options` - Optional conversion options (as a JavaScript object)
- *
- * # Example
- *
- * ```javascript
- * import { convert } from 'html-to-markdown-wasm';
- *
- * const html = '<h1>Hello World</h1>';
- * const markdown = convert(html);
- * console.log(markdown); // # Hello World
- * ```
  * @param {string} html
- * @param {any} options
+ * @param {WasmConversionOptionsHandle} handle
  * @returns {string}
  */
-export function convert(html, options) {
+export function convertWithOptionsHandle(html, handle) {
     let deferred3_0;
     let deferred3_1;
     try {
         const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
         const ptr0 = passStringToWasm0(html, wasm.__wbindgen_export, wasm.__wbindgen_export2);
         const len0 = WASM_VECTOR_LEN;
-        wasm.convert(retptr, ptr0, len0, addHeapObject(options));
+        _assertClass(handle, WasmConversionOptionsHandle);
+        wasm.convertWithOptionsHandle(retptr, ptr0, len0, handle.__wbg_ptr);
         var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
         var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
         var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
@@ -451,10 +438,23 @@ export function convertBytesWithInlineImages(html, options, image_config) {
 }
 
 /**
- * Initialize panic hook for better error messages in the browser
+ * @param {any} options
+ * @returns {WasmConversionOptionsHandle}
  */
-export function init() {
-    wasm.init();
+export function createConversionOptionsHandle(options) {
+    try {
+        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+        wasm.createConversionOptionsHandle(retptr, addHeapObject(options));
+        var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+        var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+        var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+        if (r2) {
+            throw takeObject(r1);
+        }
+        return WasmConversionOptionsHandle.__wrap(r0);
+    } finally {
+        wasm.__wbindgen_add_to_stack_pointer(16);
+    }
 }
 
 const WasmConversionOptionsHandleFinalization = (typeof FinalizationRegistry === 'undefined')

package/dist-web/package.json

@@ -4,7 +4,7 @@
   "collaborators": [
     "Na'aman Hirschfeld <nhirschfeld@gmail.com>"
   ],
-  "version": "2.8.2",
+  "version": "2.9.0",
   "license": "MIT",
   "repository": {
     "type": "git",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "html-to-markdown-wasm",
-  "version": "2.8.2",
+  "version": "2.9.0",
   "description": "High-performance HTML to Markdown converter - WebAssembly bindings",
   "main": "dist/html_to_markdown_wasm.js",
   "types": "dist/html_to_markdown_wasm.d.ts",
@@ -55,7 +55,7 @@
   "devDependencies": {
     "@types/node": "^24.10.1",
     "tsx": "^4.20.6",
-    "vitest": "^4.0.8",
+    "vitest": "^4.0.11",
     "wasm-pack": "^0.13.1"
   },
   "publishConfig": {