html-to-markdown 3.18.6 → 3.19.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2016ec0d020c4c703d6b8834cdb15f5131fb819d1f9957119ef85ffef73c2570
-  data.tar.gz: f47a1fd34111b85f55eb9b0bfcdcc8fa34aba0224f7e26a46d865999e505df0c
+  metadata.gz: e42d1e5a9c4cab13d5840556d5e6a518aa98576495b6fe08cf376a93392d8ba5
+  data.tar.gz: 7e20b6da6705d9bcf643ee55dccd5b0de4131b170236c2bf9785eed5dd048133
 SHA512:
-  metadata.gz: 3c9054a3dd71258420649bf3972e6727487ce7a6245039356d3e805d5f36ddb2a6ead7e9a098b66836cd1a394baedb8910dfe2a82eda21d64c1e0dbcaa0f09a3
-  data.tar.gz: c73096310520b1a5ebc40d4c214e4ccd77dec47314c7e1b4bfd55e3a21f9b47cf3475da18e2fe5b76247c5ba8c9ba53566e6a30284b1761456a1cb6bce42f169
+  metadata.gz: 9510c005552e50c8397a8db398cc8f63e5d57dbd5ca889c96077019d2db9f60f63fd1a14a234d3836752aedae0620919a07d6c90b8bf5fce5dbded58c0d49f1a
+  data.tar.gz: a79521d8aa524eb9261167d71fd56a1fffa31ec7a1f2a4458ba3076d968d1361f18b96ca5f907d596120f0ad84e743ecd2e1d62f78f0582af1dd3b523845fb6c

data/ext/html_to_markdown_rb/native/Cargo.lock

@@ -152,9 +152,9 @@ dependencies = [
 
 [[package]]
 name = "crc32fast"
-version = "1.5.2"
+version = "1.5.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "01a7799fd6b852db0e61728dde9a204c423b44d689dbd432522543614b490e78"
+checksum = "0ba106e844045ddc02c20768ac4b0b7cb45f2cc2ecbd833ac9f5dacb183c2055"
 dependencies = [
  "cfg-if",
 ]
@@ -252,7 +252,7 @@ checksum = "491194d601b4fa9fac3c9571e014070a0ad1bc3392d1bc10419695196a8b3cc3"
 
 [[package]]
 name = "html-to-markdown-rb"
-version = "3.18.6"
+version = "3.19.0"
 dependencies = [
  "async-trait",
  "html-to-markdown-rs",
@@ -266,9 +266,9 @@ dependencies = [
 
 [[package]]
 name = "html-to-markdown-rs"
-version = "3.18.6"
+version = "3.19.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "efd51611ec6a8f3046a351920c7d67c89189c2d4789167c77be5556816cad17b"
+checksum = "ddada45be32a036999fbda2be5df286dc2001816e60099ec3fd445fc6c3bb69b"
 dependencies = [
  "ahash",
  "astral-tl",
@@ -301,9 +301,9 @@ dependencies = [
 
 [[package]]
 name = "icu_collections"
-version = "2.3.0"
+version = "2.4.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "fa68d21081c4a05d5a901a1c62add574c77048b6a1c67be3b50ce0b60d4ca513"
+checksum = "fe090a42a0d3140fed8c63263ed1fecc02422cb2f4bfe55cd8de2de1b8e105dd"
 dependencies = [
  "displaydoc",
  "potential_utf",
@@ -315,9 +315,9 @@ dependencies = [
 
 [[package]]
 name = "icu_locale_core"
-version = "2.3.0"
+version = "2.4.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d56e28588da92eee5c3201a6eff33fabdd49b62269c8938d4ff050ce4d900deb"
+checksum = "25d29b57c17c6528d0dc4c2141cfa2d08200465acb537a3909c8b9b8a4a984c0"
 dependencies = [
  "displaydoc",
  "litemap",
@@ -328,9 +328,9 @@ dependencies = [
 
 [[package]]
 name = "icu_normalizer"
-version = "2.3.0"
+version = "2.4.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "12f9cf5f235641ed274641dd81c3f28d870e276763d0797aeeab72317b1c646f"
+checksum = "404a3b8c486f205c87fe7f23ab6894d84a4ad76d6e4671ae1981ba7def87c599"
 dependencies = [
  "icu_collections",
  "icu_normalizer_data",
@@ -342,15 +342,15 @@ dependencies = [
 
 [[package]]
 name = "icu_normalizer_data"
-version = "2.3.0"
+version = "2.4.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1563da1ed3e0b3bf3d74c9b85917ac9c56464d2f57242270c09c9e752f8021a0"
+checksum = "20f0088bfb7441f7a37fa0c9e20cb1e9cba1cac6b9ce8cd2a6dc44294f8e8cbc"
 
 [[package]]
 name = "icu_properties"
-version = "2.3.0"
+version = "2.4.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7e7ca276ad3145661a65914e6daf131ca5120cd3dcee8f8f3214b8875184a148"
+checksum = "2ea83d991c56158f7cf898bf86436c1dfe7c07ee82fe88951f2695c9f37a379f"
 dependencies = [
  "displaydoc",
  "icu_collections",
@@ -363,15 +363,15 @@ dependencies = [
 
 [[package]]
 name = "icu_properties_data"
-version = "2.3.0"
+version = "2.4.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e590f038c1464a96894fd6d10127e90a8be4509f56ff7ecef851b15cee0b7caa"
+checksum = "b98f29af82d02b163fe50161388350e743bb3107cc8e8c2f7314cb505faddfcf"
 
 [[package]]
 name = "icu_provider"
-version = "2.3.1"
+version = "2.4.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d27bbb9d3abbefac45d55f647c9de1d44aafcd1186eb91879afef17c396c3e73"
+checksum = "413099315636c588ee8f011190b329b971a09a8fae9d157e01dcae8379468514"
 dependencies = [
  "displaydoc",
  "icu_locale_core",
@@ -897,9 +897,9 @@ checksum = "33f4fe9184a62d842c9ef383018f3306d8ba224fd9d836f56d7288308847c256"
 
 [[package]]
 name = "smallvec"
-version = "1.16.3"
+version = "1.16.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5b3dc8af474f516a851ff4bd12db780f948b9250ad37211e4eec0bccea54e01b"
+checksum = "d0d5d4b1981b8bbbb7aed204cae5726d683d5d6ac7e74ec54122ea28f315e7c8"
 
 [[package]]
 name = "stable_deref_trait"
@@ -1004,9 +1004,9 @@ dependencies = [
 
 [[package]]
 name = "tinystr"
-version = "0.8.4"
+version = "0.8.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b1e27c91459209c2986af3dcf603a5a74a4368754ce37414f59acc971167f643"
+checksum = "abc840c238154d58f9e86b2792261edfde565a17696e1cda1a449de27979801a"
 dependencies = [
  "displaydoc",
  "zerovec",
@@ -1014,9 +1014,9 @@ dependencies = [
 
 [[package]]
 name = "tokio"
-version = "1.53.3"
+version = "1.54.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ce3335fa71841cda333a58d7615b03901380ecf09d59b3296d21f8bbac0dde4e"
+checksum = "b52fd3255258d26fac7264ab5a76b53c13367136dc011d3d6ad4f8ed070396a3"
 dependencies = [
  "pin-project-lite",
 ]
@@ -1120,9 +1120,9 @@ checksum = "3ad82d2a33cdc9674dc7465672f271e096168fcdbe0f799d9e6db8c5892679dc"
 
 [[package]]
 name = "yoke"
-version = "0.8.3"
+version = "0.8.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "709fe23a0424b6a435d82152b1bd3fdfb0833487d5fa90d05d42762a9891fef5"
+checksum = "417ef3fcf6c300b7dbd25c85531a746931c02ad536f3cf4786ed1e88223340b3"
 dependencies = [
  "stable_deref_trait",
  "yoke-derive",
@@ -1195,9 +1195,9 @@ dependencies = [
 
 [[package]]
 name = "zerovec"
-version = "0.11.8"
+version = "0.11.9"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "bb0464e17806c1d976d5cba29399c7f08e516e279e2ba493f63123b5fca67dd8"
+checksum = "f58a2799cfe9a1670c7ea8edbd52ef8edb93cb37a7f83bf31ba9e35d9dae6a40"
 dependencies = [
  "yoke",
  "zerofrom",
@@ -1206,9 +1206,9 @@ dependencies = [
 
 [[package]]
 name = "zerovec-derive"
-version = "0.11.6"
+version = "0.11.7"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "34df6fc39dbd26ddc9c10e6a2984476e13acce22e64e4487636ef494369225da"
+checksum = "c3743ddbf47738d929cd1ae2e199d40d0162979dfe31aef8ae646d2bf00bf97a"
 dependencies = [
  "proc-macro2",
  "quote",

data/ext/html_to_markdown_rb/native/Cargo.toml

@@ -1,11 +1,11 @@
 # This file is auto-generated by alef — DO NOT EDIT.
-# alef:hash:43d86acd6ca5c60e5484c6647082e19bd47b267ba99994e27d4642a4a3a2b1ac
+# alef:hash:fa3a53f518517843e506e230f22cd23c0afd1bcead1c05e1f1d17a72039f3f7d
 # To regenerate: alef generate
 # To verify freshness: alef verify
 
 [package]
 name = "html-to-markdown-rb"
-version = "3.18.6"
+version = "3.19.0"
 edition = "2024"
 authors = ["Na'aman Hirschfeld <naaman@xberg.io>", "Tobias Perlstein <tobias@xberg.io>"]
 license = "MIT"
@@ -31,7 +31,7 @@ visitor = ["html-to-markdown-rs/visitor"]
 
 [dependencies]
 async-trait = "0.1"
-html-to-markdown-rs = { version = "3.18.6", features = ["serde", "metadata", "visitor", "inline-images", "testkit"] }
+html-to-markdown-rs = { version = "3.19.0", features = ["serde", "metadata", "visitor", "inline-images", "testkit"] }
 magnus = "0.9"
 rb-sys = ">=0.9.130, <0.10"
 serde = { version = "1", features = ["derive"] }

data/ext/html_to_markdown_rb/src/lib.rs

@@ -1,5 +1,5 @@
 // This file is auto-generated by alef. DO NOT EDIT.
-// alef:hash:b6d61bd5ff22300c6e6fbed28fdf0552577fb61799af32cc2d7a7244ab333361
+// alef:hash:4b8dded025d0cab583492c692b2a248f959abe1e38e464768e056b4624f1bb5e
 // Re-generate with: alef generate
 #![allow(dead_code, unused_imports, unused_variables)]
 #![allow(
@@ -5346,6 +5346,56 @@ pub fn convert(args: &[magnus::Value]) -> Result<ConversionResult, Error> {
         })
 }
 
+#[allow(clippy::missing_errors_doc)]
+#[allow(unused_variables)]
+pub fn convert_with_accessible_names(args: &[magnus::Value]) -> Result<ConversionResult, Error> {
+    let args = magnus::scan_args::scan_args::<(String, bool), (Option<magnus::Value>,), (), (), (), ()>(args)?;
+    let (html, use_accessible_names) = args.required;
+    let (visitor,) = args.optional;
+    let options_core = match visitor {
+        Some(v) if !v.is_nil() => {
+            if magnus::RHash::from_value(v).is_some() {
+                let json = v.funcall::<_, _, String>("to_json", ()).map_err(|e| {
+                    magnus::Error::new(
+                        unsafe { magnus::Ruby::get_unchecked() }.exception_runtime_error(),
+                        format!("failed to serialize Ruby options to JSON: {}", e),
+                    )
+                })?;
+                serde_json::from_str::<html_to_markdown_rs::ConversionOptions>(&json).map_err(|e| {
+                    magnus::Error::new(
+                        unsafe { magnus::Ruby::get_unchecked() }.exception_runtime_error(),
+                        format!("failed to deserialize options JSON: {}", e),
+                    )
+                })?
+            } else if let Ok(opts_binding) = <&ConversionOptions as magnus::TryConvert>::try_convert(v) {
+                opts_binding.clone().into()
+            } else {
+                let bridge = RbHtmlVisitorBridge::new(v, String::new())?;
+                let handle = std::sync::Arc::new(std::sync::Mutex::new(bridge)) as html_to_markdown_rs::VisitorHandle;
+                #[allow(
+                    clippy::field_reassign_with_default,
+                    reason = "External options may be non-exhaustive or contain private fields"
+                )]
+                {
+                    let mut opts = html_to_markdown_rs::ConversionOptions::default();
+                    opts.visitor = Some(handle);
+                    opts
+                }
+            }
+        }
+        _ => html_to_markdown_rs::ConversionOptions::default(),
+    };
+
+    html_to_markdown_rs::convert_with_accessible_names(&html, use_accessible_names, Some(options_core))
+        .map(|val| val.into())
+        .map_err(|e| {
+            magnus::Error::new(
+                unsafe { magnus::Ruby::get_unchecked() }.exception_runtime_error(),
+                e.to_string(),
+            )
+        })
+}
+
 fn nodecontext_to_rb_hash(ctx: &html_to_markdown_rs::NodeContext) -> magnus::RHash {
     let ruby = unsafe { magnus::Ruby::get_unchecked() };
     let h = ruby.hash_new();
@@ -8420,11 +8470,49 @@ impl From<html_to_markdown_rs::options::WhitespaceMode> for WhitespaceMode {
     }
 }
 
-/// Convert a `html_to_markdown_rs::error::ConversionError` error to a Magnus runtime error.
+/// Convert the error a core call returned into the typed Ruby exception of its family. An error
+/// of a type with no converter becomes a `RuntimeError` with the message.
+#[allow(dead_code)]
+fn alef_magnus_err<E: std::fmt::Display + 'static>(e: E) -> magnus::Error {
+    let message = e.to_string();
+    #[allow(unused_variables)]
+    let any: Box<dyn std::any::Any> = Box::new(e);
+    let any = match any.downcast::<html_to_markdown_rs::error::ConversionError>() {
+        Ok(typed) => return conversion_error_to_magnus_err(*typed),
+        Err(any) => any,
+    };
+    let _ = any;
+    magnus::Error::new(
+        unsafe { magnus::Ruby::get_unchecked() }.exception_runtime_error(),
+        message,
+    )
+}
+
+/// Convert a `html_to_markdown_rs::error::ConversionError` error to a typed Ruby exception.
 #[allow(dead_code)]
 fn conversion_error_to_magnus_err(e: html_to_markdown_rs::error::ConversionError) -> magnus::Error {
-    let msg = e.to_string();
-    magnus::Error::new(unsafe { magnus::Ruby::get_unchecked() }.exception_runtime_error(), msg)
+    use magnus::prelude::*;
+    let message = e.to_string();
+    let ruby = unsafe { magnus::Ruby::get_unchecked() };
+    #[allow(unreachable_patterns)]
+    let class_name = match &e {
+        html_to_markdown_rs::error::ConversionError::ParseError(..) => "ParseError",
+        html_to_markdown_rs::error::ConversionError::SanitizationError(..) => "SanitizationError",
+        html_to_markdown_rs::error::ConversionError::ConfigError(..) => "ConfigError",
+        html_to_markdown_rs::error::ConversionError::IoError(..) => "IoError",
+        html_to_markdown_rs::error::ConversionError::Panic(..) => "PanicError",
+        html_to_markdown_rs::error::ConversionError::InvalidInput(..) => "InvalidInputError",
+        html_to_markdown_rs::error::ConversionError::InputTooLarge { .. } => "InputTooLargeError",
+        html_to_markdown_rs::error::ConversionError::Other(..) => "OtherError",
+        _ => "ConversionError",
+    };
+    let build = || -> Result<magnus::Error, magnus::Error> {
+        let module = ruby.define_module("HtmlToMarkdownRs")?;
+        let class: magnus::ExceptionClass = module.const_get(class_name)?;
+        let exception = class.new_instance((message.as_str(),))?;
+        Ok(magnus::Error::from(exception))
+    };
+    build().unwrap_or_else(|_| magnus::Error::new(ruby.exception_runtime_error(), message))
 }
 
 #[magnus::init]
@@ -9010,5 +9098,20 @@ fn ruby_init(ruby: &Ruby) -> Result<(), Error> {
 
     module.define_module_function("convert", function!(convert, -1))?;
 
+    module.define_module_function(
+        "convert_with_accessible_names",
+        function!(convert_with_accessible_names, -1),
+    )?;
+
+    let conversion_error_class = module.define_error("ConversionError", ruby.exception_standard_error())?;
+    let parse_error_class = module.define_error("ParseError", conversion_error_class)?;
+    let sanitization_error_class = module.define_error("SanitizationError", conversion_error_class)?;
+    let config_error_class = module.define_error("ConfigError", conversion_error_class)?;
+    let io_error_class = module.define_error("IoError", conversion_error_class)?;
+    let panic_error_class = module.define_error("PanicError", conversion_error_class)?;
+    let invalid_input_error_class = module.define_error("InvalidInputError", conversion_error_class)?;
+    let input_too_large_error_class = module.define_error("InputTooLargeError", conversion_error_class)?;
+    let other_error_class = module.define_error("OtherError", conversion_error_class)?;
+
     Ok(())
 }

data/lib/html_to_markdown/native.rb

@@ -1,5 +1,5 @@
 # This file is auto-generated by alef — DO NOT EDIT.
-# alef:hash:b035df027077810826d9d805f32ef7ac142e025791c1098a52026f8500fe0fbc
+# alef:hash:09a04cb502ed10072dd986b919b61b19dd89f1684de6b0ec0ad98dbc4a7f9805
 # To regenerate: alef generate
 # To verify freshness: alef verify
 # frozen_string_literal: true
@@ -60,6 +60,9 @@ module HtmlToMarkdown
   define_singleton_method(:convert) { |*args, **kwargs, &blk|
     HtmlToMarkdownRs.public_send(:convert, *args, **kwargs, &blk)
   }
+  define_singleton_method(:convert_with_accessible_names) { |*args, **kwargs, &blk|
+    HtmlToMarkdownRs.public_send(:convert_with_accessible_names, *args, **kwargs, &blk)
+  }
 end
 
 module HtmlToMarkdown

data/lib/html_to_markdown/version.rb

@@ -1,10 +1,10 @@
 # This file is auto-generated by alef — DO NOT EDIT.
-# alef:hash:e90d67885156fd26c02ed8c039c97e94a8952f927f71c2ba4a501543e4b86b9d
+# alef:hash:2af93614191f5e65ab3e6f136720482baa1b1ccd900ee7561aeb92a517ef3fe1
 # To regenerate: alef generate
 # To verify freshness: alef verify
 # frozen_string_literal: true
 
 module HtmlToMarkdown
   ## The version string for this package.
-  VERSION = "3.18.6"
+  VERSION = "3.19.0"
 end

data/sig/types.rbs

@@ -1,5 +1,5 @@
 # This file is auto-generated by alef — DO NOT EDIT.
-# alef:hash:7e44e5dc91835ebf404d75449ed2551d0fa980cdfa15ba6064871d3aa3ecde5b
+# alef:hash:0715469498b948fa0fede0134e676b43663986d359510ac029708f761e5dd5eb
 # To regenerate: alef generate
 # To verify freshness: alef verify
 
@@ -303,7 +303,155 @@ def initialize: (?rows: Integer, ?cols: Integer, ?cells: Array[GridCell]) -> voi
     class VisitorHandle
     end
 
-    class AnnotationKind
+    module AnnotationKind
+    def self.from_hash: (untyped hash) -> untyped
+    end
+
+    class AnnotationKindBold
+        include AnnotationKind
+    def bold?: () -> bool
+    def italic?: () -> bool
+    def underline?: () -> bool
+    def strikethrough?: () -> bool
+    def code?: () -> bool
+    def subscript?: () -> bool
+    def superscript?: () -> bool
+    def highlight?: () -> bool
+    def link?: () -> bool
+
+    def self.from_hash: (untyped hash) -> untyped
+        def self.new:  -> AnnotationKindBold
+    end
+
+    class AnnotationKindItalic
+        include AnnotationKind
+    def bold?: () -> bool
+    def italic?: () -> bool
+    def underline?: () -> bool
+    def strikethrough?: () -> bool
+    def code?: () -> bool
+    def subscript?: () -> bool
+    def superscript?: () -> bool
+    def highlight?: () -> bool
+    def link?: () -> bool
+
+    def self.from_hash: (untyped hash) -> untyped
+        def self.new:  -> AnnotationKindItalic
+    end
+
+    class AnnotationKindUnderline
+        include AnnotationKind
+    def bold?: () -> bool
+    def italic?: () -> bool
+    def underline?: () -> bool
+    def strikethrough?: () -> bool
+    def code?: () -> bool
+    def subscript?: () -> bool
+    def superscript?: () -> bool
+    def highlight?: () -> bool
+    def link?: () -> bool
+
+    def self.from_hash: (untyped hash) -> untyped
+        def self.new:  -> AnnotationKindUnderline
+    end
+
+    class AnnotationKindStrikethrough
+        include AnnotationKind
+    def bold?: () -> bool
+    def italic?: () -> bool
+    def underline?: () -> bool
+    def strikethrough?: () -> bool
+    def code?: () -> bool
+    def subscript?: () -> bool
+    def superscript?: () -> bool
+    def highlight?: () -> bool
+    def link?: () -> bool
+
+    def self.from_hash: (untyped hash) -> untyped
+        def self.new:  -> AnnotationKindStrikethrough
+    end
+
+    class AnnotationKindCode
+        include AnnotationKind
+    def bold?: () -> bool
+    def italic?: () -> bool
+    def underline?: () -> bool
+    def strikethrough?: () -> bool
+    def code?: () -> bool
+    def subscript?: () -> bool
+    def superscript?: () -> bool
+    def highlight?: () -> bool
+    def link?: () -> bool
+
+    def self.from_hash: (untyped hash) -> untyped
+        def self.new:  -> AnnotationKindCode
+    end
+
+    class AnnotationKindSubscript
+        include AnnotationKind
+    def bold?: () -> bool
+    def italic?: () -> bool
+    def underline?: () -> bool
+    def strikethrough?: () -> bool
+    def code?: () -> bool
+    def subscript?: () -> bool
+    def superscript?: () -> bool
+    def highlight?: () -> bool
+    def link?: () -> bool
+
+    def self.from_hash: (untyped hash) -> untyped
+        def self.new:  -> AnnotationKindSubscript
+    end
+
+    class AnnotationKindSuperscript
+        include AnnotationKind
+    def bold?: () -> bool
+    def italic?: () -> bool
+    def underline?: () -> bool
+    def strikethrough?: () -> bool
+    def code?: () -> bool
+    def subscript?: () -> bool
+    def superscript?: () -> bool
+    def highlight?: () -> bool
+    def link?: () -> bool
+
+    def self.from_hash: (untyped hash) -> untyped
+        def self.new:  -> AnnotationKindSuperscript
+    end
+
+    class AnnotationKindHighlight
+        include AnnotationKind
+    def bold?: () -> bool
+    def italic?: () -> bool
+    def underline?: () -> bool
+    def strikethrough?: () -> bool
+    def code?: () -> bool
+    def subscript?: () -> bool
+    def superscript?: () -> bool
+    def highlight?: () -> bool
+    def link?: () -> bool
+
+    def self.from_hash: (untyped hash) -> untyped
+        def self.new:  -> AnnotationKindHighlight
+    end
+
+    class AnnotationKindLink
+        include AnnotationKind
+        attr_reader url: String
+        attr_reader title: String?
+
+    def bold?: () -> bool
+    def italic?: () -> bool
+    def underline?: () -> bool
+    def strikethrough?: () -> bool
+    def code?: () -> bool
+    def subscript?: () -> bool
+    def superscript?: () -> bool
+    def highlight?: () -> bool
+    def link?: () -> bool
+
+    def self.from_hash: (untyped hash) -> untyped
+    def self.new: (url: String, title: String) -> AnnotationKindLink
     end
 
     type enum_CodeBlockStyle = :Indented | :Backticks | :Tildes
@@ -326,7 +474,298 @@ def initialize: (?rows: Integer, ?cols: Integer, ?cells: Array[GridCell]) -> voi
 
     type enum_NewlineStyle = :Spaces | :Backslash
 
-    class NodeContent
+    module NodeContent
+    def self.from_hash: (untyped hash) -> untyped
+    end
+
+    class NodeContentHeading
+        include NodeContent
+        attr_reader level: Integer
+        attr_reader text: String
+
+    def heading?: () -> bool
+    def paragraph?: () -> bool
+    def list?: () -> bool
+    def list_item?: () -> bool
+    def table?: () -> bool
+    def image?: () -> bool
+    def code?: () -> bool
+    def quote?: () -> bool
+    def definition_list?: () -> bool
+    def definition_item?: () -> bool
+    def raw_block?: () -> bool
+    def metadata_block?: () -> bool
+    def group?: () -> bool
+
+    def self.from_hash: (untyped hash) -> untyped
+    def self.new: (level: Integer, text: String) -> NodeContentHeading
+    end
+
+    class NodeContentParagraph
+        include NodeContent
+        attr_reader text: String
+
+    def heading?: () -> bool
+    def paragraph?: () -> bool
+    def list?: () -> bool
+    def list_item?: () -> bool
+    def table?: () -> bool
+    def image?: () -> bool
+    def code?: () -> bool
+    def quote?: () -> bool
+    def definition_list?: () -> bool
+    def definition_item?: () -> bool
+    def raw_block?: () -> bool
+    def metadata_block?: () -> bool
+    def group?: () -> bool
+
+    def self.from_hash: (untyped hash) -> untyped
+    def self.new: (text: String) -> NodeContentParagraph
+    end
+
+    class NodeContentList
+        include NodeContent
+        attr_reader ordered: bool
+
+    def heading?: () -> bool
+    def paragraph?: () -> bool
+    def list?: () -> bool
+    def list_item?: () -> bool
+    def table?: () -> bool
+    def image?: () -> bool
+    def code?: () -> bool
+    def quote?: () -> bool
+    def definition_list?: () -> bool
+    def definition_item?: () -> bool
+    def raw_block?: () -> bool
+    def metadata_block?: () -> bool
+    def group?: () -> bool
+
+    def self.from_hash: (untyped hash) -> untyped
+    def self.new: (ordered: bool) -> NodeContentList
+    end
+
+    class NodeContentListItem
+        include NodeContent
+        attr_reader text: String
+
+    def heading?: () -> bool
+    def paragraph?: () -> bool
+    def list?: () -> bool
+    def list_item?: () -> bool
+    def table?: () -> bool
+    def image?: () -> bool
+    def code?: () -> bool
+    def quote?: () -> bool
+    def definition_list?: () -> bool
+    def definition_item?: () -> bool
+    def raw_block?: () -> bool
+    def metadata_block?: () -> bool
+    def group?: () -> bool
+
+    def self.from_hash: (untyped hash) -> untyped
+    def self.new: (text: String) -> NodeContentListItem
+    end
+
+    class NodeContentTable
+        include NodeContent
+        attr_reader grid: TableGrid
+
+    def heading?: () -> bool
+    def paragraph?: () -> bool
+    def list?: () -> bool
+    def list_item?: () -> bool
+    def table?: () -> bool
+    def image?: () -> bool
+    def code?: () -> bool
+    def quote?: () -> bool
+    def definition_list?: () -> bool
+    def definition_item?: () -> bool
+    def raw_block?: () -> bool
+    def metadata_block?: () -> bool
+    def group?: () -> bool
+
+    def self.from_hash: (untyped hash) -> untyped
+    def self.new: (grid: TableGrid) -> NodeContentTable
+    end
+
+    class NodeContentImage
+        include NodeContent
+        attr_reader description: String?
+        attr_reader src: String?
+        attr_reader image_index: Integer?
+
+    def heading?: () -> bool
+    def paragraph?: () -> bool
+    def list?: () -> bool
+    def list_item?: () -> bool
+    def table?: () -> bool
+    def image?: () -> bool
+    def code?: () -> bool
+    def quote?: () -> bool
+    def definition_list?: () -> bool
+    def definition_item?: () -> bool
+    def raw_block?: () -> bool
+    def metadata_block?: () -> bool
+    def group?: () -> bool
+
+    def self.from_hash: (untyped hash) -> untyped
+    def self.new: (description: String, src: String, image_index: Integer) -> NodeContentImage
+    end
+
+    class NodeContentCode
+        include NodeContent
+        attr_reader text: String
+        attr_reader language: String?
+
+    def heading?: () -> bool
+    def paragraph?: () -> bool
+    def list?: () -> bool
+    def list_item?: () -> bool
+    def table?: () -> bool
+    def image?: () -> bool
+    def code?: () -> bool
+    def quote?: () -> bool
+    def definition_list?: () -> bool
+    def definition_item?: () -> bool
+    def raw_block?: () -> bool
+    def metadata_block?: () -> bool
+    def group?: () -> bool
+
+    def self.from_hash: (untyped hash) -> untyped
+    def self.new: (text: String, language: String) -> NodeContentCode
+    end
+
+    class NodeContentQuote
+        include NodeContent
+    def heading?: () -> bool
+    def paragraph?: () -> bool
+    def list?: () -> bool
+    def list_item?: () -> bool
+    def table?: () -> bool
+    def image?: () -> bool
+    def code?: () -> bool
+    def quote?: () -> bool
+    def definition_list?: () -> bool
+    def definition_item?: () -> bool
+    def raw_block?: () -> bool
+    def metadata_block?: () -> bool
+    def group?: () -> bool
+
+    def self.from_hash: (untyped hash) -> untyped
+        def self.new:  -> NodeContentQuote
+    end
+
+    class NodeContentDefinitionList
+        include NodeContent
+    def heading?: () -> bool
+    def paragraph?: () -> bool
+    def list?: () -> bool
+    def list_item?: () -> bool
+    def table?: () -> bool
+    def image?: () -> bool
+    def code?: () -> bool
+    def quote?: () -> bool
+    def definition_list?: () -> bool
+    def definition_item?: () -> bool
+    def raw_block?: () -> bool
+    def metadata_block?: () -> bool
+    def group?: () -> bool
+
+    def self.from_hash: (untyped hash) -> untyped
+        def self.new:  -> NodeContentDefinitionList
+    end
+
+    class NodeContentDefinitionItem
+        include NodeContent
+        attr_reader term: String
+        attr_reader definition: String
+
+    def heading?: () -> bool
+    def paragraph?: () -> bool
+    def list?: () -> bool
+    def list_item?: () -> bool
+    def table?: () -> bool
+    def image?: () -> bool
+    def code?: () -> bool
+    def quote?: () -> bool
+    def definition_list?: () -> bool
+    def definition_item?: () -> bool
+    def raw_block?: () -> bool
+    def metadata_block?: () -> bool
+    def group?: () -> bool
+
+    def self.from_hash: (untyped hash) -> untyped
+    def self.new: (term: String, definition: String) -> NodeContentDefinitionItem
+    end
+
+    class NodeContentRawBlock
+        include NodeContent
+        attr_reader format: String
+        attr_reader content: String
+
+    def heading?: () -> bool
+    def paragraph?: () -> bool
+    def list?: () -> bool
+    def list_item?: () -> bool
+    def table?: () -> bool
+    def image?: () -> bool
+    def code?: () -> bool
+    def quote?: () -> bool
+    def definition_list?: () -> bool
+    def definition_item?: () -> bool
+    def raw_block?: () -> bool
+    def metadata_block?: () -> bool
+    def group?: () -> bool
+
+    def self.from_hash: (untyped hash) -> untyped
+    def self.new: (format: String, content: String) -> NodeContentRawBlock
+    end
+
+    class NodeContentMetadataBlock
+        include NodeContent
+    attr_reader entries: Array[MetadataEntry]
+
+    def heading?: () -> bool
+    def paragraph?: () -> bool
+    def list?: () -> bool
+    def list_item?: () -> bool
+    def table?: () -> bool
+    def image?: () -> bool
+    def code?: () -> bool
+    def quote?: () -> bool
+    def definition_list?: () -> bool
+    def definition_item?: () -> bool
+    def raw_block?: () -> bool
+    def metadata_block?: () -> bool
+    def group?: () -> bool
+
+    def self.from_hash: (untyped hash) -> untyped
+def self.new: (entries: Array[MetadataEntry]) -> NodeContentMetadataBlock
+    end
+
+    class NodeContentGroup
+        include NodeContent
+        attr_reader label: String?
+        attr_reader heading_level: Integer?
+        attr_reader heading_text: String?
+
+    def heading?: () -> bool
+    def paragraph?: () -> bool
+    def list?: () -> bool
+    def list_item?: () -> bool
+    def table?: () -> bool
+    def image?: () -> bool
+    def code?: () -> bool
+    def quote?: () -> bool
+    def definition_list?: () -> bool
+    def definition_item?: () -> bool
+    def raw_block?: () -> bool
+    def metadata_block?: () -> bool
+    def group?: () -> bool
+
+    def self.from_hash: (untyped hash) -> untyped
+    def self.new: (label: String, heading_level: Integer, heading_text: String) -> NodeContentGroup
     end
 
     type enum_NodeType = :Text | :Element | :Heading | :Paragraph | :Div | :Blockquote | :Pre | :Hr | :List | :ListItem | :DefinitionList | :DefinitionTerm | :DefinitionDescription | :Table | :TableRow | :TableCell | :TableHeader | :TableBody | :TableHead | :TableFoot | :Link | :Image | :Strong | :Em | :Code | :Strikethrough | :Underline | :Subscript | :Superscript | :Mark | :Small | :Br | :Span | :Article | :Section | :Nav | :Aside | :Header | :Footer | :Main | :Figure | :Figcaption | :Time | :Details | :Summary | :Form | :Input | :Select | :Option | :Button | :Textarea | :Label | :Fieldset | :Legend | :Audio | :Video | :Picture | :Source | :Iframe | :Svg | :Canvas | :Ruby | :Rt | :Rp | :Abbr | :Kbd | :Samp | :Var | :Cite | :Q | :Del | :Ins | :Data | :Meter | :Progress | :Output | :Template | :Slot | :Html | :Head | :Body | :Title | :Meta | :LinkTag | :Style | :Script | :Base | :Custom
@@ -343,7 +782,72 @@ def initialize: (?rows: Integer, ?cols: Integer, ?cells: Array[GridCell]) -> voi
 
     type enum_UrlEscapeStyle = :Angle | :Percent
 
-    class VisitResult
+    module VisitResult
+    def self.from_hash: (untyped hash) -> untyped
+    end
+
+    class VisitResultContinue
+        include VisitResult
+    def continue?: () -> bool
+    def custom?: () -> bool
+    def skip?: () -> bool
+    def preserve_html?: () -> bool
+    def error?: () -> bool
+
+    def self.from_hash: (untyped hash) -> untyped
+        def self.new:  -> VisitResultContinue
+    end
+
+    class VisitResultCustom
+        include VisitResult
+        attr_reader value: String
+
+    def continue?: () -> bool
+    def custom?: () -> bool
+    def skip?: () -> bool
+    def preserve_html?: () -> bool
+    def error?: () -> bool
+
+    def self.from_hash: (untyped hash) -> untyped
+    def self.new: (value: String) -> VisitResultCustom
+    end
+
+    class VisitResultSkip
+        include VisitResult
+    def continue?: () -> bool
+    def custom?: () -> bool
+    def skip?: () -> bool
+    def preserve_html?: () -> bool
+    def error?: () -> bool
+
+    def self.from_hash: (untyped hash) -> untyped
+        def self.new:  -> VisitResultSkip
+    end
+
+    class VisitResultPreserveHtml
+        include VisitResult
+    def continue?: () -> bool
+    def custom?: () -> bool
+    def skip?: () -> bool
+    def preserve_html?: () -> bool
+    def error?: () -> bool
+
+    def self.from_hash: (untyped hash) -> untyped
+        def self.new:  -> VisitResultPreserveHtml
+    end
+
+    class VisitResultError
+        include VisitResult
+        attr_reader value: String
+
+    def continue?: () -> bool
+    def custom?: () -> bool
+    def skip?: () -> bool
+    def preserve_html?: () -> bool
+    def error?: () -> bool
+
+    def self.from_hash: (untyped hash) -> untyped
+    def self.new: (value: String) -> VisitResultError
     end
 
     type enum_WarningKind = :image_extraction_failed | :encoding_fallback | :truncated_input | :malformed_html | :sanitization_applied | :depth_limit_exceeded
@@ -352,6 +856,8 @@ def initialize: (?rows: Integer, ?cols: Integer, ?cells: Array[GridCell]) -> voi
 
 def self.convert: (String html, ?ConversionOptions options) -> ConversionResult
 
+def self.convert_with_accessible_names: (String html, bool use_accessible_names, ?ConversionOptions options) -> ConversionResult
+
     interface _HtmlVisitor
         # Optional methods the bridge calls when the object defines them (the
         # trait's Rust default behavior applies otherwise): visit_text, visit_element_start, visit_element_end, visit_link, visit_image, visit_heading, visit_code_block, visit_code_inline, visit_list_item, visit_list_start, visit_list_end, visit_table_start, visit_table_row, visit_table_end, visit_blockquote, visit_strong, visit_emphasis, visit_strikethrough, visit_underline, visit_subscript, visit_superscript, visit_mark, visit_line_break, visit_horizontal_rule, visit_custom_element, visit_definition_list_start, visit_definition_term, visit_definition_description, visit_definition_list_end, visit_form, visit_input, visit_button, visit_audio, visit_video, visit_iframe, visit_details, visit_summary, visit_figure_start, visit_figcaption, visit_figure_end.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: html-to-markdown
 version: !ruby/object:Gem::Version
-  version: 3.18.6
+  version: 3.19.0
 platform: ruby
 authors:
 - Na'aman Hirschfeld
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-10-22 00:00:00.000000000 Z
+date: 2026-10-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rb_sys