idml 0.7.3 → 0.7.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 66e6127aeed8e54926e01cacb67c81445565c1e43a558015fd9740e022c12372
-  data.tar.gz: 20b6dcdef5ee316ca394a2b062ed0dac2db9137e08e28f7649944623420e3938
+  metadata.gz: 2f60e795f4325dcc4006a28915a18baf7069e21767694ca670c41f84db62d98d
+  data.tar.gz: 4f1f4846d41050b518c8add338ce431951b45ea58891b2c56154b47e59478bc7
 SHA512:
-  metadata.gz: 94180fd8ac2231198178f40f2051d4e1bd9c56d917cd271808fc87f7de66746739c4ecad65e23f6bbb57be539f061ff5ef9abfda56e71a2bb23ddc403ac3d9a5
-  data.tar.gz: 353fcc512f92ed689fc1e41cabf4fe9310bcb5ce0464be24b0be6a452c1559f860201c7132318bb3fd4be9c510eed63ebb98f056b927b9e781bffcfc2123f632
+  metadata.gz: bbf7caac497ce2ab01a8c35af7bad78a24b7a706db6baa582b7d416cae1ce4995f18a3903379c4e994ab49ca1f28efd33e162821dead95250ae8248c041d16cd
+  data.tar.gz: ed5d2ae0abf40c0c6bf101d3c05ca35f59bc48aefed14366de7f5ac0f15979ff458ca7cf8493d012c4f6a78b0c1889815f987ea3dc9f24971f31ae34583f6fc4

data/TODO.pdf/115-bullet-numbered-lists.md

@@ -1,6 +1,9 @@
 # TODO PDF 115: Bullet and numbered list rendering
 
-## Status: OPEN — gap identified in 2026-08-10 audit
+## Status: DONE for inline marker emission. Hanging-indent layout
+(bullet in a left gutter with wrapped lines indented to align with
+text after marker) is a follow-up — currently the marker sits inline
+before the first run's text.
 
 ## Problem
 

data/lib/idml/render/list_marker.rb

@@ -0,0 +1,63 @@
+# frozen_string: true
+
+module Idml
+  module Render
+    # Produces a list-marker string for a paragraph (bullet glyph or
+    # numbered-list expression). IDML stores the resolved marker
+    # directly on the PSR (BulletCharacterValue as a Unicode codepoint,
+    # NumberingExpression as the rendered text), so the renderer
+    # doesn't need to maintain its own counter.
+    #
+    # Used by `StyleResolver` to prepend the marker to the paragraph's
+    # first run's text. The marker becomes part of the run's natural
+    # text flow — no special positioning needed for MVP.
+    #
+    # Hanging-indent layout (bullet aligned in a left gutter with
+    # wrapped lines indented to align with text after the marker) is
+    # a follow-up; for now the marker sits inline before the text.
+    module ListMarker
+      DEFAULT_BULLET = "•".freeze # BULLET
+      DEFAULT_TEXT_AFTER = "\t".freeze
+
+      # Returns the marker string for the paragraph, or nil when the
+      # paragraph isn't part of a list.
+      def self.marker_for(paragraph)
+        return nil unless paragraph
+
+        case paragraph.bullets_and_numbering_list_type
+        when "BulletList" then bullet_marker(paragraph)
+        when "NumberedList" then numbered_marker(paragraph)
+        end
+      end
+
+      def self.bullet_marker(paragraph)
+        bullet = bullet_char(paragraph)
+        suffix = text_after(paragraph)
+        "#{bullet}#{suffix}"
+      end
+      private_class_method :bullet_marker
+
+      def self.numbered_marker(paragraph)
+        expr = paragraph.numbering_expression
+        return nil if expr.nil? || expr.empty?
+
+        suffix = text_after(paragraph)
+        "#{expr}#{suffix}"
+      end
+      private_class_method :numbered_marker
+
+      def self.bullet_char(paragraph)
+        codepoint = paragraph.bullet_character_value
+        return DEFAULT_BULLET unless codepoint&.positive?
+
+        [codepoint].pack("U")
+      end
+      private_class_method :bullet_char
+
+      def self.text_after(paragraph)
+        paragraph.bullets_text_after || DEFAULT_TEXT_AFTER
+      end
+      private_class_method :text_after
+    end
+  end
+end

data/lib/idml/render/style_resolver.rb

@@ -55,6 +55,10 @@ module Idml
         :right_indent,
         :auto_leading,
         :drop_cap_lines,
+        :bullets_and_numbering_list_type,
+        :bullet_character_value,
+        :bullets_text_after,
+        :numbering_expression,
         :drop_cap_characters,
         # RuleAbove / RuleBelow — paragraph rules (horizontal lines
         # above/below the paragraph block). Driven by PSR attributes.
@@ -115,7 +119,7 @@ module Idml
           runs = csr_runs(psr, condition_filter: condition_filter)
           next if runs.empty?
 
-          Paragraph.new(
+          paragraph = Paragraph.new(
             runs: runs,
             alignment: runs.first.alignment,
             space_before: psr.space_before,
@@ -126,6 +130,10 @@ module Idml
             auto_leading: psr.auto_leading,
             drop_cap_lines: psr.drop_cap_lines,
             drop_cap_characters: psr.drop_cap_characters,
+            bullets_and_numbering_list_type: psr.bullets_and_numbering_list_type,
+            bullet_character_value: psr.bullet_character_value,
+            bullets_text_after: psr.bullets_text_after,
+            numbering_expression: psr.numbering_expression,
             rule_above: psr.rule_above,
             rule_above_line_weight: psr.rule_above_line_weight,
             rule_above_color: psr.stroke_color,
@@ -143,6 +151,8 @@ module Idml
             rule_below_right_indent: psr.rule_below_right_indent,
             rule_below_width: psr.rule_below_width,
           )
+          prepend_list_marker(paragraph)
+          paragraph
         end
       end
 
@@ -193,6 +203,19 @@ module Idml
       end
       private_class_method :alignment_for
 
+      # Prepends the list marker (bullet glyph or numbered expression)
+      # to the paragraph's first run when the paragraph is part of
+      # a list. Mutates the first run's text in place.
+      def self.prepend_list_marker(paragraph)
+        marker = ListMarker.marker_for(paragraph)
+        return unless marker
+        return if paragraph.runs.empty?
+
+        first_run = paragraph.runs.first
+        first_run.text = "#{marker}#{first_run.text}"
+      end
+      private_class_method :prepend_list_marker
+
       # Concatenate runs into a single block. Used when the renderer
       # can't handle per-run styling (e.g., no font metrics available).
       def self.concatenate(runs)

data/lib/idml/render.rb

@@ -16,6 +16,7 @@ module Idml
     autoload :CharacterStyle,      "#{__dir__}/render/character_style"
     autoload :ParagraphRules,      "#{__dir__}/render/paragraph_rules"
     autoload :DropCap,             "#{__dir__}/render/drop_cap"
+    autoload :ListMarker,          "#{__dir__}/render/list_marker"
     autoload :StoryChainController, "#{__dir__}/render/story_chain_controller"
     autoload :LayerFilter,         "#{__dir__}/render/layer_filter"
     autoload :ConditionFilter,     "#{__dir__}/render/condition_filter"

data/lib/idml/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Idml
-  VERSION = "0.7.3"
+  VERSION = "0.7.4"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: idml
 version: !ruby/object:Gem::Version
-  version: 0.7.3
+  version: 0.7.4
 platform: ruby
 authors:
 - Ribose
@@ -444,6 +444,7 @@ files:
 - lib/idml/render/image.rb
 - lib/idml/render/image_collector.rb
 - lib/idml/render/layer_filter.rb
+- lib/idml/render/list_marker.rb
 - lib/idml/render/metadata_builder.rb
 - lib/idml/render/page_item_renderer.rb
 - lib/idml/render/paragraph_rules.rb