coradoc-adoc 2.0.26 → 2.0.27

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6d381a7e511028e9caa79826eccd74e14694968a18825cd179d28cbd785928c7
-  data.tar.gz: 0646f6bf33b86848c345fa772e23583def67169f01ae9b9a905ec0f8fa1922c7
+  metadata.gz: ac328212768fb69c29726e260db2af252ebb60fff81682bb7eed8ad9984bee1a
+  data.tar.gz: 4b5af72762fcbf96fe40594cd4b849e328b2fe03cc027aa37e08435869656c1c
 SHA512:
-  metadata.gz: 86b395057b440b17616f1743a4d4e72f8c9cffb21b344019b695233c81445450bfd2e17bfc77cb0e706d1284267c4e399680d1174818ebae709570c485c5d435
-  data.tar.gz: 25d8a142605cd3fe9df0dbd191c1004f4d9450ba79614a7b660cd629ef7c8673045143d4b5ed9fd7c0cdf25385d94ec615c2d2591479f41c228abe1fa16c77aa
+  metadata.gz: 26ad434a7f144350750011ccca8a932c193ed9687c001080ce6549edcbdb1c16f2d072eb3d62dd0fa825eb744707beae7cb24be4876e03ac1054b2dffa2eaecf
+  data.tar.gz: bf54821072c38fc983b68be86fca0d0cd46b6358b6b2239d84697cff44aadf3ab4cc5cc88a03760b29d78929568c874367a90cb9ad9c0d3c6405fa512795ea05

data/lib/coradoc/asciidoc/parser/block_header.rb

@@ -3,19 +3,29 @@
 module Coradoc
   module AsciiDoc
     module Parser
-      # Single Responsibility: parse the optional header that precedes a block.
+      # Single Responsibility: parse the optional header that precedes a
+      # structural element (block or section).
       #
-      # Encapsulates the canonical AsciiDoc block-header grammar in one place
-      # (DRY, MECE, single source of truth). Before this module existed, every
-      # block-like rule (block, table, section, paragraph, block_image) inlined
-      # its own header rule with subtly different slot orderings — and several
-      # of them captured the same Parslet key more than once in a single
-      # sequence, which triggered Parslet's "Duplicate subtrees while merging
-      # result" warning and silently discarded one of the captured values.
+      # Encapsulates the canonical AsciiDoc header grammar in one place
+      # (DRY, MECE, single source of truth). Two flavours live here because
+      # blocks and sections have different header grammars:
       #
-      # Canonical header shape, each component at most once:
+      #   block_header   = block_title? >> element_id? >> attribute_blocks?
+      #   section_header =                    element_id? >> attribute_blocks?
       #
-      #   block_title? >> element_id? >> attribute_blocks?
+      # Asciidoctor does NOT permit `.Title` to apply to a section — sections
+      # accept `[role]` attribute lists and `[[id]]` anchors but not block
+      # titles. The section's heading IS its title. Mixing the two shapes
+      # into one rule caused `section_block` to admit `.Foo` lines that
+      # collided with `section_title`'s `:title` capture, triggering
+      # Parslet's "Duplicate subtrees while merging result … (keys:
+      # [:title])" warning and silently dropping the block title.
+      #
+      # Before this module existed, every block-like rule inlined its own
+      # header rule with subtly different slot orderings — and several
+      # captured the same Parslet key more than once in a single sequence,
+      # which triggered Parslet's "Duplicate subtrees" warning and silently
+      # discarded one of the captured values.
       #
       # `attribute_blocks` accepts one or more consecutive `[...]` attribute
       # lists, captured as a Parslet sequence under the :attribute_list key.
@@ -31,8 +41,11 @@ module Coradoc
       # every attribute and lets the transformer merge them into a single
       # Coradoc::AsciiDoc::Model::AttributeList downstream.
       module BlockHeader
-        # Canonical block header rule. Single canonical order; each of title,
-        # id, and attribute_blocks is optional and matched at most once.
+        # Canonical block header rule. Includes the block title — every
+        # real block (delimited block, table, paragraph, image) accepts
+        # an optional `.Title` line before its body. Single canonical
+        # order; each of title, id, and attribute_blocks is optional and
+        # matched at most once.
         # @return [Parslet::Atoms::Base]
         def block_header
           block_title.maybe >>
@@ -40,6 +53,16 @@ module Coradoc
             attribute_blocks.maybe
         end
 
+        # Section header rule. Asciidoctor does not permit `.Title` on
+        # sections — the section heading itself is the title. Sections
+        # still accept the same element_id and attribute_blocks slots
+        # that blocks do (`[[anchor]]`, `[appendix]`, `[role=x]`, etc.).
+        # @return [Parslet::Atoms::Base]
+        def section_header
+          element_id.maybe >>
+            attribute_blocks.maybe
+        end
+
         # One or more consecutive attribute_list + newline sequences, captured
         # as a Parslet sequence under :attribute_list. When multiple `[...]`
         # blocks precede a delimiter, all of them reach the transformer; when

data/lib/coradoc/asciidoc/parser/section.rb

@@ -27,7 +27,7 @@ module Coradoc
         def section_block(level = 2)
           return nil if level > 8
 
-          block_header >>
+          section_header >>
             section_title(level).as(:title) >>
             contents.as(:contents).maybe
         end

data/lib/coradoc/asciidoc/version.rb

@@ -2,6 +2,6 @@
 
 module Coradoc
   module AsciiDoc
-    VERSION = '2.0.26'
+    VERSION = '2.0.27'
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: coradoc-adoc
 version: !ruby/object:Gem::Version
-  version: 2.0.26
+  version: 2.0.27
 platform: ruby
 authors:
 - Ribose Inc.