idml 0.8.5 → 0.8.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ac8e5f6dd1f360428509a0ae78c7c537b80cbd1d41fa5e85f5e1fe61f0cac48e
-  data.tar.gz: 2dcf34fd3fe19ef2978783e6857bd724872b741b8aab9b5418d77a10431b8aad
+  metadata.gz: '04038941020b897a48513a0386fe33c4108384351a40e47e4ea50c2f09709611'
+  data.tar.gz: 5e79b2dc7e0ec38818d06b74196bfb61227e4cb80c2e5989f8b836858469db70
 SHA512:
-  metadata.gz: 30deff6b7352132cf5c019bde7423294232fafbe7b25898e7188d754f721ba3d6a498f6e41f31ef86afafe4f4e768dfb459fc272eda6ac288df1ab033cf88cc2
-  data.tar.gz: ba95fecbb82c8546c3ec4e31c3b3fdebfe1237fd8b7b5ec8e0a53c54d612dff72d9f1e3c89c6f88b8b7d5309f579a94a5e60132a50b37739914f21595bcf4b8f
+  metadata.gz: 115565aeb1f5c1da58d7a94337b3a8243da2303b4e12b25516582a7cc94065752d54df398a4f02632067b3a2b9495449911b43ee85b410d23b6a90d27e33c2ca
+  data.tar.gz: 3754116e6abce4fb0481f8fdb02edb3452df9a0a6f7ff0417ca9500ab80155b91ceea0336a37d9defe41c75963c7040b75a2774f096fc5217285d57e19e6a41a

data/TODO.pdf/114-text-wrap-around-shapes.md

@@ -1,6 +1,12 @@
 # TODO PDF 114: Text wrap around shapes (TextWrapPreference)
 
-## Status: OPEN — gap identified in 2026-08-10 audit
+## Status: PARTIAL — `Render::TextWrapResolver` computes BoundingBox-mode
+contours from page items declaring TextWrapPreference.
+`overlap_width(line_y, line_height, frame_x, frame_right)` returns the
+horizontal overlap for a text line. Rectangle now carries the
+TextWrapPreference child. Integration with TextFrameRenderer
+(per-line wrap width adjustment during layout) is the remaining work —
+requires line-by-line contour queries in the layout pipeline.
 
 ## Problem
 

data/lib/idml/elements/rectangle.rb

@@ -24,6 +24,7 @@ module Idml
       attribute :item_layer, :string
       attribute :properties, Idml::Elements::Properties, collection: true
       attribute :transparency_setting, Idml::Elements::TransparencySetting
+      attribute :text_wrap_preference, Idml::Elements::TextWrapPreference
       attribute :image, Idml::Elements::Image, collection: true
 
       xml do
@@ -46,6 +47,7 @@ module Idml
         map_attribute "ItemLayer", to: :item_layer
         map_element "Properties", to: :properties
         map_element "TransparencySetting", to: :transparency_setting
+        map_element "TextWrapPreference", to: :text_wrap_preference
         map_element "Image", to: :image
       end
 

data/lib/idml/render/text_wrap_resolver.rb

@@ -0,0 +1,110 @@
+# frozen_string_literal: true
+
+module Idml
+  module Render
+    # Resolves text-wrap contours from page items that declare
+    # TextWrapPreference. For BoundingBox mode (the common case),
+    # the contour is the item's geometric bounds expanded by the
+    # wrap offsets. TextFrameRenderer queries this resolver per
+    # text line to compute the effective wrap width — lines that
+    # overlap a contour get their width reduced by the overlap.
+    #
+    # Supported: BoundingBox mode (rectangle intersection).
+    # Unsupported: Shape mode (contour following), Inverse mode.
+    class TextWrapResolver
+      # A wrap contour: a PDF-coordinate rectangle the text avoids.
+      Contour = Struct.new(
+        :x, :y, :width, :height,
+        keyword_init: true
+      )
+
+      OFFSET_ATTRS = %i[
+        offset_top offset_left offset_bottom offset_right
+      ].freeze
+
+      def self.build(spread, page_height: 792)
+        contours = []
+        spread.each_page_item do |item|
+          contour = contour_for(item, page_height)
+          contours << contour if contour
+        end
+        new(contours)
+      end
+
+      def initialize(contours)
+        @contours = contours
+      end
+
+      attr_reader :contours
+
+      # Returns the total horizontal overlap of all contours with a
+      # text line at the given y range within the given x range.
+      # Sum, not max — multiple overlapping contours compound.
+      # Returns 0.0 when there's no overlap.
+      def overlap_width(line_y, line_height, frame_x, frame_right)
+        @contours.sum do |contour|
+          overlap = line_overlap(contour, line_y, line_height,
+                                 frame_x, frame_right)
+          overlap[:width]
+        end
+      end
+
+      def self.contour_for(item, page_height)
+        pref = wrap_preference(item)
+        return nil unless pref
+        return nil unless bounding_box_mode?(pref)
+
+        bounds = item.geometric_bounds
+        return nil unless bounds
+
+        rect = Geometry.placement_rect(bounds, item.item_transform,
+                                       page_height)
+        Contour.new(
+          x: rect[:x], y: rect[:y],
+          width: rect[:width], height: rect[:height]
+        )
+      end
+      private_class_method :contour_for
+
+      def self.wrap_preference(item)
+        pref = item.text_wrap_preference if item.is_a?(Lutaml::Model::Serializable)
+        return nil unless pref
+        return nil if pref.text_wrap_mode.nil? ||
+          pref.text_wrap_mode == "None"
+
+        pref
+      end
+      private_class_method :wrap_preference
+
+      def self.bounding_box_mode?(pref)
+        pref.text_wrap_mode == "BoundingBox"
+      end
+      private_class_method :bounding_box_mode?
+
+      def line_overlap(contour, line_y, line_height, frame_x, frame_right)
+        return { width: 0.0 } unless y_overlap?(contour, line_y, line_height)
+        return { width: 0.0 } unless x_overlap?(contour, frame_x, frame_right)
+
+        { width: x_overlap_width(contour, frame_x, frame_right) }
+      end
+
+      def y_overlap?(contour, line_y, line_height)
+        line_top = line_y + line_height
+        line_bottom = line_y
+        contour_top = contour.y + contour.height
+        contour_bottom = contour.y
+        line_top > contour_bottom && line_bottom < contour_top
+      end
+
+      def x_overlap?(contour, frame_x, frame_right)
+        contour.x < frame_right && contour.x + contour.width > frame_x
+      end
+
+      def x_overlap_width(contour, frame_x, frame_right)
+        left = [contour.x, frame_x].max
+        right = [contour.x + contour.width, frame_right].min
+        [right - left, 0].max
+      end
+    end
+  end
+end

data/lib/idml/render.rb

@@ -21,6 +21,7 @@ module Idml
     autoload :StoryChainController, "#{__dir__}/render/story_chain_controller"
     autoload :LayerFilter,         "#{__dir__}/render/layer_filter"
     autoload :ConditionFilter,     "#{__dir__}/render/condition_filter"
+    autoload :TextWrapResolver,    "#{__dir__}/render/text_wrap_resolver"
     autoload :Placement,           "#{__dir__}/render/placement"
     autoload :ImageCollector,      "#{__dir__}/render/image_collector"
     autoload :StructureTracker,    "#{__dir__}/render/structure_tracker"

data/lib/idml/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: idml
 version: !ruby/object:Gem::Version
-  version: 0.8.5
+  version: 0.8.6
 platform: ruby
 authors:
 - Ribose
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-08-14 00:00:00.000000000 Z
+date: 2026-08-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bigdecimal
@@ -475,6 +475,7 @@ files:
 - lib/idml/render/structure_tracker.rb
 - lib/idml/render/style_lookup.rb
 - lib/idml/render/style_resolver.rb
+- lib/idml/render/text_wrap_resolver.rb
 - lib/idml/text_engine.rb
 - lib/idml/text_engine/cjk_layout.rb
 - lib/idml/text_engine/justifier.rb