html-to-markdown 3.18.7 → 3.20.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e175db6704b5a4ac22e317895b4314dff1dbc809ed724da74ddc664b1edfeeb6
-  data.tar.gz: ca4ce9c464f60b9150bc7d508b5310841b08f6bef99218dbb2635a7a6b19bc89
+  metadata.gz: f43865f82a7e4c6d23c66a65771037f4d8ee80030446ffaa3f540b186a63d495
+  data.tar.gz: 9153d54e8c57c12d344ad60c428a456f23ad99b986b9c095611ef5209861ca3f
 SHA512:
-  metadata.gz: 8a7a0b77e588a87d4f65e277c7a8408724f396c567171314ce13a9c44f5e20a5b7455f10f0c21c8037af138a6b1797604d5ac742e7f8f044139246c37bbf9a81
-  data.tar.gz: c55d9cdace13731aa4aad7c9656b6d0a56b831949ef2c5937adbdca64ae77ac9e72161c2d4bf41c98b2f6ae626e8b42cee92d4369cf63f1f08a09f822b7b07d8
+  metadata.gz: 23eb08b05df928356dd4d205fb51ab09ed795a73ade15c16e81925eb3abe4d251bea9434ba4b47f8d8ddcb1c1be9d6e291c7c3d42bd67f8d2b9639099b712fd9
+  data.tar.gz: 9a64c7eb777837684aec301285b64494e3fe4dcd76e507f079808586e83acf655953cf321796b11339f6e128dd75873ee905a1dd718867cd273556c34de1c1d2

data/README.md

@@ -1,5 +1,5 @@
 <!-- This file is auto-generated by alef — DO NOT EDIT. -->
-<!-- alef:hash:cb80328456dcb271efa3f7851e475022ff26cfe3112b09a2e41384313ff520d0 -->
+<!-- alef:hash:cef2039678dca43690ca25831e1f26c8093fb9ed088d15c4faa6cfd46a216194 -->
 <!-- To regenerate: alef readme -->
 <!-- To verify freshness: alef verify -->
 
@@ -100,7 +100,7 @@ Ship identical Markdown across every runtime while enjoying native extension per
 gem install html-to-markdown
 ```
 
-Requires Ruby 3.2+ with Magnus native extension bindings. Published for Linux, macOS.
+Requires Ruby 3.3+ with Magnus native extension bindings. Published for Linux, macOS.
 
 ## Performance Snapshot
 

data/ext/html_to_markdown_rb/native/Cargo.lock

@@ -31,10 +31,10 @@ dependencies = [
 ]
 
 [[package]]
-name = "astral-tl"
-version = "0.8.0"
+name = "astral-html"
+version = "0.0.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "04d4bb5df351abb6758a04240b0193794ddaf34a7c0b9452fab3c25dcce39e88"
+checksum = "d050c4dc17bfd8bf50da08bda9ef724b44a1b4ec09a5811f193f978cb6fbadbb"
 dependencies = [
  "memchr",
 ]
@@ -252,7 +252,7 @@ checksum = "491194d601b4fa9fac3c9571e014070a0ad1bc3392d1bc10419695196a8b3cc3"
 
 [[package]]
 name = "html-to-markdown-rb"
-version = "3.18.7"
+version = "3.20.0"
 dependencies = [
  "async-trait",
  "html-to-markdown-rs",
@@ -266,12 +266,12 @@ dependencies = [
 
 [[package]]
 name = "html-to-markdown-rs"
-version = "3.18.7"
+version = "3.20.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "259eff8de02b67e436fa4ccd377dbf6105d530fc405f20489677f417cf673a7a"
+checksum = "87d942a115ed580f0f224aa32114e82b964dcd05a9cfa71b015829d7fafba1b2"
 dependencies = [
  "ahash",
- "astral-tl",
+ "astral-html",
  "base64",
  "bitflags",
  "html-escape",
@@ -283,6 +283,7 @@ dependencies = [
  "regex",
  "serde",
  "serde_json",
+ "smallvec",
  "thiserror",
  "tracing",
  "url",
@@ -485,9 +486,9 @@ dependencies = [
 
 [[package]]
 name = "log"
-version = "0.4.34"
+version = "0.4.35"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f9f8bd3e56ce4dfc153cf470fffbfa98c7620958b312ca5c3a4b8d5181fd13c6"
+checksum = "5d15f86d12da44cd8d4ec3c73984537eb7f4cadcb9776a575a0a8a05ca11005c"
 
 [[package]]
 name = "magnus"
@@ -1072,9 +1073,18 @@ dependencies = [
 
 [[package]]
 name = "utf8_iter"
-version = "1.0.4"
+version = "1.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "af3bd9d3e571c26fcce9d033b87ea5ab061b8d2ffe9b7a5675d810d68f03edf0"
+dependencies = [
+ "utf_types",
+]
+
+[[package]]
+name = "utf_types"
+version = "1.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b6c140620e7ffbb22c2dee59cafe6084a59b5ffc27a8859a5f0d494b5d52b6be"
+checksum = "3a3b425286980a367278453f3b6d28cdcb134b574e5a35824a6ff5eebad50bb6"
 
 [[package]]
 name = "version_check"

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:ada94196b1eb7453e4131fa267514d382755d55a82cd30bd90db1323ab8c9fbc
+# alef:hash:2037391b7b71beb6a98065ebcf3cf7a6468bb5565cae33f921c678449cee8a10
 # To regenerate: alef generate
 # To verify freshness: alef verify
 
 [package]
 name = "html-to-markdown-rb"
-version = "3.18.7"
+version = "3.20.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.7", features = ["serde", "metadata", "visitor", "inline-images", "testkit"] }
+html-to-markdown-rs = { version = "3.20.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:71422c48948c3ed5a6716f00e2d54cb32804161fd701c7c7549a6fcf652e6bf5
+// alef:hash:12cba80e3c0806295fe73c09cbd3a6127be840c81ee90b163b8a848eda56f40f
 // Re-generate with: alef generate
 #![allow(dead_code, unused_imports, unused_variables)]
 #![allow(
@@ -97,7 +97,6 @@ pub struct ConversionOptions {
     preserve_tags: Vec<String>,
     skip_images: bool,
     inline_data_media: InlineDataMedia,
-    use_accessible_names: bool,
     hidden_content: HiddenContent,
     url_escape_style: UrlEscapeStyle,
     link_style: LinkStyle,
@@ -470,15 +469,6 @@ impl ConversionOptions {
                 })?,
                 None => InlineDataMedia::Keep,
             },
-            use_accessible_names: match kwargs.get(ruby.to_symbol("use_accessible_names")) {
-                Some(v) => bool::try_convert(v).map_err(|e| {
-                    magnus::Error::new(
-                        unsafe { magnus::Ruby::get_unchecked() }.exception_type_error(),
-                        format!("invalid value for `use_accessible_names`: {}", e),
-                    )
-                })?,
-                None => true,
-            },
             hidden_content: match kwargs.get(ruby.to_symbol("hidden_content")) {
                 Some(v) => HiddenContent::try_convert(v).map_err(|e| {
                     magnus::Error::new(
@@ -748,10 +738,6 @@ impl ConversionOptions {
         self.inline_data_media.clone()
     }
 
-    fn use_accessible_names(&self) -> bool {
-        self.use_accessible_names
-    }
-
     fn hidden_content(&self) -> HiddenContent {
         self.hidden_content.clone()
     }
@@ -848,7 +834,6 @@ pub struct ConversionOptionsUpdate {
     preserve_tags: Option<Vec<String>>,
     skip_images: Option<bool>,
     inline_data_media: Option<InlineDataMedia>,
-    use_accessible_names: Option<bool>,
     hidden_content: Option<HiddenContent>,
     url_escape_style: Option<UrlEscapeStyle>,
     link_style: Option<LinkStyle>,
@@ -1230,18 +1215,6 @@ impl ConversionOptionsUpdate {
                 })?),
                 None => None,
             },
-            use_accessible_names: match kwargs
-                .get(ruby.to_symbol("use_accessible_names"))
-                .filter(|v| !v.is_nil())
-            {
-                Some(v) => Some(bool::try_convert(v).map_err(|e| {
-                    magnus::Error::new(
-                        unsafe { magnus::Ruby::get_unchecked() }.exception_type_error(),
-                        format!("invalid value for `use_accessible_names`: {}", e),
-                    )
-                })?),
-                None => None,
-            },
             hidden_content: match kwargs.get(ruby.to_symbol("hidden_content")).filter(|v| !v.is_nil()) {
                 Some(v) => Some(HiddenContent::try_convert(v).map_err(|e| {
                     magnus::Error::new(
@@ -1514,10 +1487,6 @@ impl ConversionOptionsUpdate {
         self.inline_data_media.clone()
     }
 
-    fn use_accessible_names(&self) -> Option<bool> {
-        self.use_accessible_names
-    }
-
     fn hidden_content(&self) -> Option<HiddenContent> {
         self.hidden_content.clone()
     }
@@ -5377,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();
@@ -7101,7 +7120,6 @@ impl From<ConversionOptions> for html_to_markdown_rs::options::ConversionOptions
             preserve_tags: val.preserve_tags.into_iter().collect(),
             skip_images: val.skip_images,
             inline_data_media: val.inline_data_media.into(),
-            use_accessible_names: val.use_accessible_names,
             hidden_content: val.hidden_content.into(),
             url_escape_style: val.url_escape_style.into(),
             link_style: val.link_style.into(),
@@ -7160,7 +7178,6 @@ impl From<html_to_markdown_rs::options::ConversionOptions> for ConversionOptions
             preserve_tags: val.preserve_tags.into_iter().collect(),
             skip_images: val.skip_images,
             inline_data_media: val.inline_data_media.into(),
-            use_accessible_names: val.use_accessible_names,
             hidden_content: val.hidden_content.into(),
             url_escape_style: val.url_escape_style.into(),
             link_style: val.link_style.into(),
@@ -7218,7 +7235,6 @@ impl From<html_to_markdown_rs::options::ConversionOptionsUpdate> for ConversionO
             preserve_tags: val.preserve_tags.map(|v| v.into_iter().collect()),
             skip_images: val.skip_images,
             inline_data_media: val.inline_data_media.map(Into::into),
-            use_accessible_names: val.use_accessible_names,
             hidden_content: val.hidden_content.map(Into::into),
             url_escape_style: val.url_escape_style.map(Into::into),
             link_style: val.link_style.map(Into::into),
@@ -8589,11 +8605,6 @@ fn ruby_init(ruby: &Ruby) -> Result<(), Error> {
 
     class.define_method("inline_data_media", method!(ConversionOptions::inline_data_media, 0))?;
 
-    class.define_method(
-        "use_accessible_names",
-        method!(ConversionOptions::use_accessible_names, 0),
-    )?;
-
     class.define_method("hidden_content", method!(ConversionOptions::hidden_content, 0))?;
 
     class.define_method("url_escape_style", method!(ConversionOptions::url_escape_style, 0))?;
@@ -8735,11 +8746,6 @@ fn ruby_init(ruby: &Ruby) -> Result<(), Error> {
         method!(ConversionOptionsUpdate::inline_data_media, 0),
     )?;
 
-    class.define_method(
-        "use_accessible_names",
-        method!(ConversionOptionsUpdate::use_accessible_names, 0),
-    )?;
-
     class.define_method("hidden_content", method!(ConversionOptionsUpdate::hidden_content, 0))?;
 
     class.define_method(
@@ -9092,15 +9098,21 @@ 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)?;
+    module.define_error("ParseError", conversion_error_class)?;
+    module.define_error("SanitizationError", conversion_error_class)?;
+    module.define_error("ConfigError", conversion_error_class)?;
+    module.define_error("IoError", conversion_error_class)?;
+    module.define_error("PanicError", conversion_error_class)?;
+    module.define_error("InvalidInputError", conversion_error_class)?;
+    module.define_error("InputTooLargeError", conversion_error_class)?;
+    module.define_error("OtherError", conversion_error_class)?;
+    module.funcall::<_, _, magnus::Value>("module_eval", ("class ConversionError\n  module Family; end\n  include Family\n  def self.===(other)\n    super || (equal?(ConversionError) && Family === other)\n  end\nend",))?;
 
     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:299c795cac1725ee5096f21cf00f81cdcbd4aff13fae056be3fb44d637926bea
 # 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
@@ -383,7 +386,7 @@ module HtmlToMarkdown
     # @return [self]
     sig { params(hash: T::Hash[T.untyped, T.untyped]).returns(T.attached_class) }
     def self.from_hash(hash)
-      new(url: hash[:url] || hash["url"], title: hash[:title] || hash["title"])
+      new(url: hash.key?(:url) ? hash[:url] : hash["url"], title: hash.key?(:title) ? hash[:title] : hash["title"])
     end
   end
 end
@@ -477,7 +480,7 @@ module HtmlToMarkdown
     # @return [self]
     sig { params(hash: T::Hash[T.untyped, T.untyped]).returns(T.attached_class) }
     def self.from_hash(hash)
-      new(level: hash[:level] || hash["level"], text: hash[:text] || hash["text"])
+      new(level: hash.key?(:level) ? hash[:level] : hash["level"], text: hash.key?(:text) ? hash[:text] : hash["text"])
     end
   end
   ## A paragraph of text.
@@ -518,7 +521,7 @@ module HtmlToMarkdown
     # @return [self]
     sig { params(hash: T::Hash[T.untyped, T.untyped]).returns(T.attached_class) }
     def self.from_hash(hash)
-      new(text: hash[:text] || hash["text"])
+      new(text: hash.key?(:text) ? hash[:text] : hash["text"])
     end
   end
   ## A list container (ordered or unordered). Children are `ListItem` nodes.
@@ -559,7 +562,7 @@ module HtmlToMarkdown
     # @return [self]
     sig { params(hash: T::Hash[T.untyped, T.untyped]).returns(T.attached_class) }
     def self.from_hash(hash)
-      new(ordered: hash[:ordered] || hash["ordered"])
+      new(ordered: hash.key?(:ordered) ? hash[:ordered] : hash["ordered"])
     end
   end
   ## A single list item.
@@ -600,7 +603,7 @@ module HtmlToMarkdown
     # @return [self]
     sig { params(hash: T::Hash[T.untyped, T.untyped]).returns(T.attached_class) }
     def self.from_hash(hash)
-      new(text: hash[:text] || hash["text"])
+      new(text: hash.key?(:text) ? hash[:text] : hash["text"])
     end
   end
   ## A table with structured cell data.
@@ -641,7 +644,7 @@ module HtmlToMarkdown
     # @return [self]
     sig { params(hash: T::Hash[T.untyped, T.untyped]).returns(T.attached_class) }
     def self.from_hash(hash)
-      new(grid: hash[:grid] || hash["grid"])
+      new(grid: hash.key?(:grid) ? hash[:grid] : hash["grid"])
     end
   end
   ## An image element.
@@ -689,9 +692,9 @@ module HtmlToMarkdown
     sig { params(hash: T::Hash[T.untyped, T.untyped]).returns(T.attached_class) }
     def self.from_hash(hash)
       new(
-        description: hash[:description] || hash["description"],
-        src: hash[:src] || hash["src"],
-        image_index: hash[:image_index] || hash["image_index"]
+        description: hash.key?(:description) ? hash[:description] : hash["description"],
+        src: hash.key?(:src) ? hash[:src] : hash["src"],
+        image_index: hash.key?(:image_index) ? hash[:image_index] : hash["image_index"]
       )
     end
   end
@@ -736,7 +739,10 @@ module HtmlToMarkdown
     # @return [self]
     sig { params(hash: T::Hash[T.untyped, T.untyped]).returns(T.attached_class) }
     def self.from_hash(hash)
-      new(text: hash[:text] || hash["text"], language: hash[:language] || hash["language"])
+      new(
+        text: hash.key?(:text) ? hash[:text] : hash["text"],
+        language: hash.key?(:language) ? hash[:language] : hash["language"]
+      )
     end
   end
   ## A block quote container.
@@ -856,7 +862,10 @@ module HtmlToMarkdown
     # @return [self]
     sig { params(hash: T::Hash[T.untyped, T.untyped]).returns(T.attached_class) }
     def self.from_hash(hash)
-      new(term: hash[:term] || hash["term"], definition: hash[:definition] || hash["definition"])
+      new(
+        term: hash.key?(:term) ? hash[:term] : hash["term"],
+        definition: hash.key?(:definition) ? hash[:definition] : hash["definition"]
+      )
     end
   end
   ## A raw block preserved as-is (e.g. `<script>`, `<style>` content).
@@ -900,7 +909,10 @@ module HtmlToMarkdown
     # @return [self]
     sig { params(hash: T::Hash[T.untyped, T.untyped]).returns(T.attached_class) }
     def self.from_hash(hash)
-      new(format: hash[:format] || hash["format"], content: hash[:content] || hash["content"])
+      new(
+        format: hash.key?(:format) ? hash[:format] : hash["format"],
+        content: hash.key?(:content) ? hash[:content] : hash["content"]
+      )
     end
   end
   ## A block of key-value metadata pairs (from `<head>` meta tags).
@@ -941,7 +953,7 @@ module HtmlToMarkdown
     # @return [self]
     sig { params(hash: T::Hash[T.untyped, T.untyped]).returns(T.attached_class) }
     def self.from_hash(hash)
-      new(entries: hash[:entries] || hash["entries"])
+      new(entries: hash.key?(:entries) ? hash[:entries] : hash["entries"])
     end
   end
   ## A section grouping container (auto-generated from heading hierarchy).
@@ -989,9 +1001,9 @@ module HtmlToMarkdown
     sig { params(hash: T::Hash[T.untyped, T.untyped]).returns(T.attached_class) }
     def self.from_hash(hash)
       new(
-        label: hash[:label] || hash["label"],
-        heading_level: hash[:heading_level] || hash["heading_level"],
-        heading_text: hash[:heading_text] || hash["heading_text"]
+        label: hash.key?(:label) ? hash[:label] : hash["label"],
+        heading_level: hash.key?(:heading_level) ? hash[:heading_level] : hash["heading_level"],
+        heading_text: hash.key?(:heading_text) ? hash[:heading_text] : hash["heading_text"]
       )
     end
   end
@@ -1078,7 +1090,7 @@ module HtmlToMarkdown
     # @return [self]
     sig { params(hash: T::Hash[T.untyped, T.untyped]).returns(T.attached_class) }
     def self.from_hash(hash)
-      new(value: hash[:output] || hash["output"])
+      new(value: hash.key?(:output) ? hash[:output] : hash["output"])
     end
   end
   ## Skip this element entirely (don't output anything)
@@ -1153,7 +1165,7 @@ module HtmlToMarkdown
     # @return [self]
     sig { params(hash: T::Hash[T.untyped, T.untyped]).returns(T.attached_class) }
     def self.from_hash(hash)
-      new(value: hash[:output] || hash["output"])
+      new(value: hash.key?(:output) ? hash[:output] : hash["output"])
     end
   end
 end

data/lib/html_to_markdown/version.rb

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

data/sig/types.rbs

@@ -1,5 +1,5 @@
 # This file is auto-generated by alef — DO NOT EDIT.
-# alef:hash:b61c3a1ce940a4abd4e06f83687b3557a485d83d7451fad630c72b325b0def95
+# alef:hash:1d4b142f8a480d7e1db67239954e5333ef61df246e0597c2429f8c8ec6660510
 # To regenerate: alef generate
 # To verify freshness: alef verify
 
@@ -45,7 +45,6 @@ type json_value = Hash[String, untyped] | Array[untyped] | String | Integer | Fl
     attr_reader preserve_tags: Array[String]
         attr_reader skip_images: bool
         attr_reader inline_data_media: enum_InlineDataMedia
-        attr_reader use_accessible_names: bool
         attr_reader hidden_content: enum_HiddenContent
         attr_reader url_escape_style: enum_UrlEscapeStyle
         attr_reader link_style: enum_LinkStyle
@@ -62,7 +61,7 @@ type json_value = Hash[String, untyped] | Array[untyped] | String | Integer | Fl
         attr_reader base_url: String?
         attr_reader visitor: VisitorHandle?
 
-def initialize: (?heading_style: enum_HeadingStyle, ?list_indent_type: enum_ListIndentType, ?list_indent_width: Integer, ?bullets: String, ?strong_em_symbol: String, ?escape_asterisks: bool, ?escape_underscores: bool, ?escape_misc: bool, ?escape_ascii: bool, ?code_language: String, ?autolinks: bool, ?expand_abbreviations: bool, ?include_blockquote_citations: bool, ?default_title: bool, ?br_in_tables: bool, ?compact_tables: bool, ?highlight_style: enum_HighlightStyle, ?extract_metadata: bool, ?whitespace_mode: enum_WhitespaceMode, ?strip_newlines: bool, ?wrap: bool, ?wrap_width: Integer, ?convert_as_inline: bool, ?sub_symbol: String, ?sup_symbol: String, ?newline_style: enum_NewlineStyle, ?code_block_style: enum_CodeBlockStyle, ?keep_inline_images_in: Array[String], ?preprocessing: PreprocessingOptions, ?encoding: String, ?debug: bool, ?strip_tags: Array[String], ?preserve_tags: Array[String], ?skip_images: bool, ?inline_data_media: enum_InlineDataMedia, ?use_accessible_names: bool, ?hidden_content: enum_HiddenContent, ?url_escape_style: enum_UrlEscapeStyle, ?link_style: enum_LinkStyle, ?output_format: enum_OutputFormat, ?include_document_structure: bool, ?extract_images: bool, ?max_image_size: Integer, ?max_input_size: Integer, ?capture_svg: bool, ?infer_dimensions: bool, ?max_depth: Integer, ?exclude_selectors: Array[String], ?tier_strategy: enum_TierStrategy, ?base_url: String, ?visitor: VisitorHandle) -> void
+def initialize: (?heading_style: enum_HeadingStyle, ?list_indent_type: enum_ListIndentType, ?list_indent_width: Integer, ?bullets: String, ?strong_em_symbol: String, ?escape_asterisks: bool, ?escape_underscores: bool, ?escape_misc: bool, ?escape_ascii: bool, ?code_language: String, ?autolinks: bool, ?expand_abbreviations: bool, ?include_blockquote_citations: bool, ?default_title: bool, ?br_in_tables: bool, ?compact_tables: bool, ?highlight_style: enum_HighlightStyle, ?extract_metadata: bool, ?whitespace_mode: enum_WhitespaceMode, ?strip_newlines: bool, ?wrap: bool, ?wrap_width: Integer, ?convert_as_inline: bool, ?sub_symbol: String, ?sup_symbol: String, ?newline_style: enum_NewlineStyle, ?code_block_style: enum_CodeBlockStyle, ?keep_inline_images_in: Array[String], ?preprocessing: PreprocessingOptions, ?encoding: String, ?debug: bool, ?strip_tags: Array[String], ?preserve_tags: Array[String], ?skip_images: bool, ?inline_data_media: enum_InlineDataMedia, ?hidden_content: enum_HiddenContent, ?url_escape_style: enum_UrlEscapeStyle, ?link_style: enum_LinkStyle, ?output_format: enum_OutputFormat, ?include_document_structure: bool, ?extract_images: bool, ?max_image_size: Integer, ?max_input_size: Integer, ?capture_svg: bool, ?infer_dimensions: bool, ?max_depth: Integer, ?exclude_selectors: Array[String], ?tier_strategy: enum_TierStrategy, ?base_url: String, ?visitor: VisitorHandle) -> void
     end
 
     class ConversionOptionsUpdate
@@ -101,7 +100,6 @@ def initialize: (?heading_style: enum_HeadingStyle, ?list_indent_type: enum_List
     attr_reader preserve_tags: Array[String]?
         attr_reader skip_images: bool?
         attr_reader inline_data_media: enum_InlineDataMedia?
-        attr_reader use_accessible_names: bool?
         attr_reader hidden_content: enum_HiddenContent?
         attr_reader url_escape_style: enum_UrlEscapeStyle?
         attr_reader link_style: enum_LinkStyle?
@@ -118,7 +116,7 @@ def initialize: (?heading_style: enum_HeadingStyle, ?list_indent_type: enum_List
         attr_reader base_url: String?
         attr_reader visitor: VisitorHandle?
 
-def initialize: (?heading_style: enum_HeadingStyle, ?list_indent_type: enum_ListIndentType, ?list_indent_width: Integer, ?bullets: String, ?strong_em_symbol: String, ?escape_asterisks: bool, ?escape_underscores: bool, ?escape_misc: bool, ?escape_ascii: bool, ?code_language: String, ?autolinks: bool, ?expand_abbreviations: bool, ?include_blockquote_citations: bool, ?default_title: bool, ?br_in_tables: bool, ?compact_tables: bool, ?highlight_style: enum_HighlightStyle, ?extract_metadata: bool, ?whitespace_mode: enum_WhitespaceMode, ?strip_newlines: bool, ?wrap: bool, ?wrap_width: Integer, ?convert_as_inline: bool, ?sub_symbol: String, ?sup_symbol: String, ?newline_style: enum_NewlineStyle, ?code_block_style: enum_CodeBlockStyle, ?keep_inline_images_in: Array[String], ?preprocessing: PreprocessingOptionsUpdate, ?encoding: String, ?debug: bool, ?strip_tags: Array[String], ?preserve_tags: Array[String], ?skip_images: bool, ?inline_data_media: enum_InlineDataMedia, ?use_accessible_names: bool, ?hidden_content: enum_HiddenContent, ?url_escape_style: enum_UrlEscapeStyle, ?link_style: enum_LinkStyle, ?output_format: enum_OutputFormat, ?include_document_structure: bool, ?extract_images: bool, ?max_image_size: Integer, ?max_input_size: Integer?, ?capture_svg: bool, ?infer_dimensions: bool, ?max_depth: Integer?, ?exclude_selectors: Array[String], ?tier_strategy: enum_TierStrategy, ?base_url: String?, ?visitor: VisitorHandle) -> void
+def initialize: (?heading_style: enum_HeadingStyle, ?list_indent_type: enum_ListIndentType, ?list_indent_width: Integer, ?bullets: String, ?strong_em_symbol: String, ?escape_asterisks: bool, ?escape_underscores: bool, ?escape_misc: bool, ?escape_ascii: bool, ?code_language: String, ?autolinks: bool, ?expand_abbreviations: bool, ?include_blockquote_citations: bool, ?default_title: bool, ?br_in_tables: bool, ?compact_tables: bool, ?highlight_style: enum_HighlightStyle, ?extract_metadata: bool, ?whitespace_mode: enum_WhitespaceMode, ?strip_newlines: bool, ?wrap: bool, ?wrap_width: Integer, ?convert_as_inline: bool, ?sub_symbol: String, ?sup_symbol: String, ?newline_style: enum_NewlineStyle, ?code_block_style: enum_CodeBlockStyle, ?keep_inline_images_in: Array[String], ?preprocessing: PreprocessingOptionsUpdate, ?encoding: String, ?debug: bool, ?strip_tags: Array[String], ?preserve_tags: Array[String], ?skip_images: bool, ?inline_data_media: enum_InlineDataMedia, ?hidden_content: enum_HiddenContent, ?url_escape_style: enum_UrlEscapeStyle, ?link_style: enum_LinkStyle, ?output_format: enum_OutputFormat, ?include_document_structure: bool, ?extract_images: bool, ?max_image_size: Integer, ?max_input_size: Integer?, ?capture_svg: bool, ?infer_dimensions: bool, ?max_depth: Integer?, ?exclude_selectors: Array[String], ?tier_strategy: enum_TierStrategy, ?base_url: String?, ?visitor: VisitorHandle) -> void
     end
 
     class ConversionResult
@@ -305,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
@@ -328,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
@@ -345,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
@@ -354,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.7
+  version: 3.20.0
 platform: ruby
 authors:
 - Na'aman Hirschfeld
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-10-27 00:00:00.000000000 Z
+date: 2026-11-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rb_sys
@@ -83,7 +83,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.2.0
+      version: 3.3.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="