commonmarker 2.9.0-aarch64-linux → 2.10.1-aarch64-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d48b2e22d0777ed9d8682bb637ee21959fee05d40303ca35e12a9e99f382ab65
-  data.tar.gz: 11d12bcbb557c16bf2c016223c0e0cd9f6c36922658ae16a55aeebdd85c0a1b2
+  metadata.gz: f6fcc312c1bc820c8d1358f1c294020e71be9f0c7e0123d5145a511c0a9f7379
+  data.tar.gz: 41a2f9aee62a4ea199121f1220846f3cb0b885368350d310a4060b30a3e25667
 SHA512:
-  metadata.gz: 6761af36b22d99b341b921be171908033860f91a24b008b5f6a614bf28eaad2016ade4dc1a92b76e66b690f1acfd576e9196846dbb2b9f6645b16348bb33c0bd
-  data.tar.gz: 7b57510624e79276796769797d854d766f03359d484a24f658af1dba0af01aad2c85c3e63153d5c556d79c84e074af3e0f8307b9f9d54fb95925e440a4155ac1
+  metadata.gz: c3821aed6a01a1b9b6fd870e9583f11e80c06e96db157df9de18063504c1aac842ee970bc7ec69c6ae08437bfbf34876393f0d09a157d3914992725e45e13f70
+  data.tar.gz: 5430cb7ce30b259835d0c53279e70d94fb46a4d8d71659f24acc1a00a9d9036994ddc6a128b3d93fbd5d9e9ea0773835e7f1277eebac61d5e6a381f3839c9651

data/README.md

@@ -5,7 +5,7 @@ Ruby wrapper for Rust's [comrak](https://github.com/kivikakk/comrak) crate.
 It passes all of the CommonMark test suite, and is therefore spec-complete. It also includes extensions to the CommonMark spec as documented in the [GitHub Flavored Markdown spec](http://github.github.com/gfm/), such as support for tables, strikethroughs, and autolinking.
 
 > [!NOTE]
-> By default, the following extensions are enabled for end user convenience: `strikethrough`, `tagfilter`, `table`, `autolink`, `tasklist` (all from the [GFM spec](http://github.github.com/gfm/)), and `shortcodes`. The `syntax_highlighter` plugin is also enabled by default, using the `"base16-ocean.dark"` theme.
+> By default, the following extensions are enabled for end user convenience: `strikethrough`, `table`, `autolink`, `tasklist` (all from the [GFM spec](http://github.github.com/gfm/)), and `shortcodes`. The `syntax_highlighter` plugin is also enabled by default, using the `"base16-ocean.dark"` theme.
 >
 > For more information on the available options and extensions, see [the documentation below](#options-and-plugins).
 
@@ -140,6 +140,24 @@ doc.to_commonmark
 # => # The site\n\nGitHub\n
 ```
 
+### Reading and writing node content
+
+`string_content` reads and writes the text of nodes whose content is plain text (like `:text`, `:code`, and `:code_block`).
+
+`literal` reads and writes the raw string a node carries, for every node type that has one (like `:text`, `:code`, `:code_block`, `:html_block`, `:html_inline`, `:raw`, `:math`, and `:frontmatter`).
+
+The two exist separately because they mean different things. Rewriting `string_content` only ever swaps text for text. Rewriting `literal` on an `:html_block`, `:html_inline`, or `:raw` node writes markup that is emitted unescaped:
+
+```ruby
+doc = Commonmarker.parse("A <b>bold</b> claim")
+
+doc.walk do |node|
+  node.literal = "<i>" if node.type == :html_inline && node.literal == "<b>"
+end
+```
+
+Note that a `:frontmatter` node's literal includes its delimiters and trailing newlines, so anything you assign must include them too.
+
 ## Options and plugins
 
 ### Options
@@ -166,24 +184,25 @@ Note that there is a distinction in comrak for "parse" options and "render" opti
 | `leave_footnote_definitions` | Allow footnote definitions to remain in their original positions instead of being moved to the document's end (only affects AST)            | `false` |
 | `ignore_setext`              | Ignores setext-style headings.                                                                                                              | `false` |
 | `sourcepos_chars`            | Use character-based column tracking in source positions instead of byte-based. Relevant for multi-byte UTF-8 documents with `sourcepos`.    | `false` |
+| `max_nesting_depth`          | The deepest a node may nest below the document. Deeper documents raise `Commonmarker::NestingDepthExceededError` instead of being parsed.  | `1000`  |
 
 ### Render options
 
-| Name                 | Description                                                                                            | Default |
-| -------------------- | ------------------------------------------------------------------------------------------------------ | ------- |
-| `hardbreaks`         | [Soft line breaks](http://spec.commonmark.org/0.27/#soft-line-breaks) translate into hard line breaks. | `true`  |
-| `github_pre_lang`    | GitHub-style `<pre lang="xyz">` is used for fenced code blocks with info tags.                         | `true`  |
-| `full_info_string`   | Gives info string data after a space in a `data-meta` attribute on code blocks.                        | `false` |
-| `width`              | The wrap column when outputting CommonMark.                                                            | `80`    |
-| `unsafe`             | Allow rendering of raw HTML and potentially dangerous links.                                           | `false` |
-| `escape`             | Escape raw HTML instead of clobbering it.                                                              | `false` |
-| `sourcepos`          | Include source position attribute in HTML and XML output.                                              | `false` |
-| `escaped_char_spans` | Wrap escaped characters in span tags.                                                                  | `true`  |
-| `ignore_empty_links` | Ignores empty links, leaving the Markdown text in place.                                               | `false` |
-| `gfm_quirks`         | Outputs HTML with GFM-style quirks; namely, not nesting `<strong>` inlines.                            | `false` |
-| `prefer_fenced`      | Always output fenced code blocks, even where an indented one could be used.                            | `false` |
-| `tasklist_classes`   | Add CSS classes to the HTML output of the tasklist extension                                           | `false` |
-| `compact_html`       | Suppress newlines in pretty-printed HTML output.                                                       | `false` |
+| Name                 | Description                                                                                                              | Default      |
+| -------------------- | ------------------------------------------------------------------------------------------------------------------------ | ------------ |
+| `hardbreaks`         | [Soft line breaks](http://spec.commonmark.org/0.27/#soft-line-breaks) translate into hard line breaks.                   | `true`       |
+| `github_pre_lang`    | GitHub-style `<pre lang="xyz">` is used for fenced code blocks with info tags.                                           | `true`       |
+| `full_info_string`   | Gives info string data after a space in a `data-meta` attribute on code blocks.                                          | `false`      |
+| `width`              | The wrap column when outputting CommonMark.                                                                              | `80`         |
+| `unsafe`             | Allow rendering of raw HTML and potentially dangerous links.                                                             | `false`      |
+| `escape`             | Escape raw HTML instead of clobbering it.                                                                                | `false`      |
+| `sourcepos`          | Include source position attribute in HTML and XML output.                                                                | `false`      |
+| `escaped_char_spans` | Wrap escaped characters in span tags.                                                                                    | `true`       |
+| `ignore_empty_links` | Ignores empty links, leaving the Markdown text in place.                                                                 | `false`      |
+| `gfm_quirks`         | Outputs HTML with GFM-style quirks; namely, not nesting `<strong>` inlines.                                              | `false`      |
+| `prefer_fenced`      | Always output fenced code blocks, even where an indented one could be used.                                              | `false`      |
+| `tasklist_classes`   | Add CSS classes to the HTML output of the tasklist extension                                                             | `false`      |
+| `compact_html`       | Suppress newlines in pretty-printed HTML output.                                                                         | `false`      |
 | `alert_style`        | The style of alert output: `"specific"` (`<div class="markdown-alert">`) or `"semantic"` (`<aside class="admonition">`). | `"specific"` |
 
 As well, there are several extensions which you can toggle in the same manner:
@@ -200,7 +219,6 @@ Commonmarker.to_html('"Hi *there*"', options: {
 | Name                          | Description                                                                                                         | Default |
 | ----------------------------- | ------------------------------------------------------------------------------------------------------------------- | ------- |
 | `strikethrough`               | Enables the [strikethrough extension](https://github.github.com/gfm/#strikethrough-extension-) from the GFM spec.   | `true`  |
-| `tagfilter`                   | Enables the [tagfilter extension](https://github.github.com/gfm/#disallowed-raw-html-extension-) from the GFM spec. | `true`  |
 | `table`                       | Enables the [table extension](https://github.github.com/gfm/#tables-extension-) from the GFM spec.                  | `true`  |
 | `autolink`                    | Enables the [autolink extension](https://github.github.com/gfm/#autolinks-extension-) from the GFM spec.            | `true`  |
 | `tasklist`                    | Enables the [task list extension](https://github.github.com/gfm/#task-list-items-extension-) from the GFM spec.     | `true`  |

data/lib/commonmarker/config.rb

@@ -13,6 +13,7 @@ module Commonmarker
         leave_footnote_definitions: false,
         ignore_setext: false,
         sourcepos_chars: false,
+        max_nesting_depth: 1000,
       }.freeze,
       render: {
         hardbreaks: true,
@@ -32,7 +33,6 @@ module Commonmarker
       }.freeze,
       extension: {
         strikethrough: true,
-        tagfilter: true,
         table: true,
         autolink: true,
         tasklist: true,
@@ -68,8 +68,8 @@ module Commonmarker
       syntax_highlighter: {
         theme: "base16-ocean.dark",
         path: "",
-      },
-    }
+      }.freeze,
+    }.freeze
 
     class << self
       include Commonmarker::Utils

data/lib/commonmarker/errors.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Commonmarker
+  # Raised when a document nests more deeply than the `max_nesting_depth`
+  # parse option allows.
+  class NestingDepthExceededError < StandardError; end
+end

data/lib/commonmarker/node/inspect.rb

@@ -28,10 +28,8 @@ module Commonmarker
             :fence_info,
             :alert_type,
           ].filter_map do |name|
-            [name, __send__(name)]
-          rescue StandardError
-            nil
-          end.compact
+            [name, __send__(name)] if respond_to?(name)
+          end
 
           printer.seplist(attrs) do |name, value|
             printer.text("#{name}=")

data/lib/commonmarker/node.rb

@@ -8,15 +8,40 @@ module Commonmarker
     include Enumerable
     include Inspect
 
-    # Public: An iterator that "walks the tree," descending into children recursively.
+    # Public: Whether this node responds to the given method.
     #
-    # blk - A {Proc} representing the action to take for each child
+    # name        - A {Symbol} or {String} naming the method.
+    # include_all - A {Boolean} indicating whether to consider private methods.
+    #
+    # Returns a {Boolean}.
+    def respond_to?(name, include_all = false)
+      return false if node_supports?(name.to_sym) == false
+
+      super
+    end
+
+    # Public: An iterator that "walks the tree," yielding each node and then
+    # its descendants, in document order.
+    #
+    # The walk is iterative rather than recursive, so arbitrarily deep trees
+    # can't exhaust the stack.
+    #
+    # blk - A {Proc} representing the action to take for each node
     def walk(&block)
       return enum_for(:walk) unless block
 
       yield self
-      each do |child|
-        child.walk(&block)
+
+      # Like #each, the next sibling is captured before a node is yielded, so
+      # the block may detach or replace the node it is given. `pending` holds
+      # the sibling to resume at once each ancestor's subtree is done.
+      pending = []
+      node = first_child
+      while node
+        next_node = node.next_sibling
+        yield node
+        pending << next_node if next_node
+        node = node.first_child || pending.pop
       end
     end
 

data/lib/commonmarker/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Commonmarker
-  VERSION = "2.9.0"
+  VERSION = "2.10.1"
 end

data/lib/commonmarker.rb

@@ -2,6 +2,7 @@
 
 require_relative "commonmarker/extension"
 
+require "commonmarker/errors"
 require "commonmarker/utils"
 require "commonmarker/node"
 require "commonmarker/config"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: commonmarker
 version: !ruby/object:Gem::Version
-  version: 2.9.0
+  version: 2.10.1
 platform: aarch64-linux
 authors:
 - Garen Torikian
@@ -9,36 +9,8 @@ authors:
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2026-07-14 00:00:00.000000000 Z
-dependencies:
-- !ruby/object:Gem::Dependency
-  name: rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '13.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '13.0'
-- !ruby/object:Gem::Dependency
-  name: rake-compiler
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.2'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.2'
+date: 2026-10-16 00:00:00.000000000 Z
+dependencies: []
 description: A fast, safe, extensible parser for CommonMark. This wraps the comrak
   Rust crate.
 email: 
@@ -55,6 +27,7 @@ files:
 - lib/commonmarker/4.0/commonmarker.so
 - lib/commonmarker/config.rb
 - lib/commonmarker/constants.rb
+- lib/commonmarker/errors.rb
 - lib/commonmarker/extension.rb
 - lib/commonmarker/node.rb
 - lib/commonmarker/node/ast.rb