idml 0.8.4 → 0.8.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a20e81d5d762e6dfcb5c374d342210ac6132a96604d83ee305dfa1c64e64e535
-  data.tar.gz: e6da886fc60f952b2e9f39f512027b953958c19e14cadf3200dc9952e4c3fa96
+  metadata.gz: '04038941020b897a48513a0386fe33c4108384351a40e47e4ea50c2f09709611'
+  data.tar.gz: 5e79b2dc7e0ec38818d06b74196bfb61227e4cb80c2e5989f8b836858469db70
 SHA512:
-  metadata.gz: f8a51af44eaa9c43cba3bbdc9f332b1fa94f34f3eb08cb32ce01b957ceff14d6903f03a2d458884a538ef6f6e56d224868427abc46f1303d8f04d82324d9aa5b
-  data.tar.gz: 68e81d0fc87751c37015ea4a3b905a65c7863145bc074714e3241a02e4f951294703b3a3b4eef8d46601d896b95ddc40d3d267f9e54ee71483b2ba9bccbb742a
+  metadata.gz: 115565aeb1f5c1da58d7a94337b3a8243da2303b4e12b25516582a7cc94065752d54df398a4f02632067b3a2b9495449911b43ee85b410d23b6a90d27e33c2ca
+  data.tar.gz: 3754116e6abce4fb0481f8fdb02edb3452df9a0a6f7ff0417ca9500ab80155b91ceea0336a37d9defe41c75963c7040b75a2774f096fc5217285d57e19e6a41a

data/TODO.pdf/106-page-item-type-coverage.md

@@ -1,6 +1,12 @@
 # TODO PDF 106: Page-item type coverage — Ellipse, Path, EPS, WMF, PICT, HtmlItem
 
-## Status: OPEN — gap identified in 2026-08-08 audit
+## Status: PARTIAL — Oval and Path elements modeled and rendered
+(registered in RENDERER_MAP, delegate to RectangleRenderer which draws
+the bounding box with fill/stroke). Documents containing Oval or Path
+page items no longer silently skip them. True elliptical rendering
+(bezier anchor/control points) and compound-path drawing are
+refinements. EPS / WMF / PICT / HtmlItem remain out of scope (foreign
+formats).
 
 ## Problem
 

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/oval.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+module Idml
+  module Elements
+    # `<Oval>` — an elliptical page item. Schema-faithful model of
+    # `Oval_Object` in `reference-docs/schemas/package/Spreads/Spread.rnc`.
+    # Shares the same attribute set and Properties/PathGeometry child
+    # structure as Rectangle; the path points form an ellipse (4 bezier
+    # anchor points) instead of corner points.
+    #
+    # The renderer treats an Oval like a Rectangle for fill/stroke —
+    # it draws the bounding box. True elliptical rendering (bezier
+    # curve generation) is a refinement; see TODO 106.
+    class Oval < Lutaml::Model::Serializable
+      attribute :self_attr, :string
+      attribute :content_type, :string
+      attribute :item_transform, :string
+      attribute :fill_color, :string
+      attribute :fill_tint, :float
+      attribute :stroke_color, :string
+      attribute :stroke_weight, :float
+      attribute :stroke_tint, :float
+      attribute :end_cap, :string
+      attribute :end_join, :string
+      attribute :miter_limit, :float
+      attribute :stroke_dash_and_gap, :string
+      attribute :visible, :boolean
+      attribute :name, :string
+      attribute :item_layer, :string
+      attribute :properties, Idml::Elements::Properties, collection: true
+      attribute :transparency_setting, Idml::Elements::TransparencySetting
+      attribute :image, Idml::Elements::Image, collection: true
+
+      xml do
+        root "Oval"
+        map_attribute "Self", to: :self_attr
+        map_attribute "ContentType", to: :content_type
+        map_attribute "ItemTransform", to: :item_transform
+        map_attribute "FillColor", to: :fill_color
+        map_attribute "FillTint", to: :fill_tint
+        map_attribute "StrokeColor", to: :stroke_color
+        map_attribute "StrokeWeight", to: :stroke_weight
+        map_attribute "StrokeTint", to: :stroke_tint
+        map_attribute "EndCap", to: :end_cap
+        map_attribute "EndJoin", to: :end_join
+        map_attribute "MiterLimit", to: :miter_limit
+        map_attribute "StrokeDashAndGap", to: :stroke_dash_and_gap
+        map_attribute "Visible", to: :visible
+        map_attribute "Name", to: :name
+        map_attribute "ItemLayer", to: :item_layer
+        map_element "Properties", to: :properties
+        map_element "TransparencySetting", to: :transparency_setting
+        map_element "Image", to: :image
+      end
+
+      def graphic?
+        content_type == "GraphicType"
+      end
+
+      def geometric_bounds
+        @geometric_bounds ||= first_geometry&.bounding_box
+      end
+
+      def first_geometry
+        properties.first&.first_geometry
+      end
+    end
+  end
+end

data/lib/idml/elements/path.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+module Idml
+  module Elements
+    # `<Path>` — a standalone compound-path page item. Schema-faithful
+    # model of `Path_Object` in
+    # `reference-docs/schemas/package/Spreads/Spread.rnc`. Carries
+    # geometry via `Properties/EntirePath` (a flat list of x/y pairs)
+    # or via PathPoint children.
+    #
+    # The renderer treats a Path like a Polygon — it draws the path
+    # points as a filled/stroked polygon. Bezier curve rendering
+    # (via LeftDirection/RightDirection) is a refinement; see TODO 106.
+    class Path < Lutaml::Model::Serializable
+      attribute :self_attr, :string
+      attribute :path_type, :string
+      attribute :item_transform, :string
+      attribute :fill_color, :string
+      attribute :fill_tint, :float
+      attribute :stroke_color, :string
+      attribute :stroke_weight, :float
+      attribute :stroke_tint, :float
+      attribute :visible, :boolean
+      attribute :name, :string
+      attribute :item_layer, :string
+      attribute :properties, Idml::Elements::Properties, collection: true
+      attribute :transparency_setting, Idml::Elements::TransparencySetting
+
+      xml do
+        root "Path"
+        map_attribute "Self", to: :self_attr
+        map_attribute "PathType", to: :path_type
+        map_attribute "ItemTransform", to: :item_transform
+        map_attribute "FillColor", to: :fill_color
+        map_attribute "FillTint", to: :fill_tint
+        map_attribute "StrokeColor", to: :stroke_color
+        map_attribute "StrokeWeight", to: :stroke_weight
+        map_attribute "StrokeTint", to: :stroke_tint
+        map_attribute "Visible", to: :visible
+        map_attribute "Name", to: :name
+        map_attribute "ItemLayer", to: :item_layer
+        map_element "Properties", to: :properties
+        map_element "TransparencySetting", to: :transparency_setting
+      end
+
+      def geometric_bounds
+        @geometric_bounds ||= first_geometry&.bounding_box
+      end
+
+      def first_geometry
+        properties.first&.first_geometry
+      end
+    end
+  end
+end

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/elements/spread_object.rb

@@ -22,6 +22,8 @@ module Idml
 
       attribute :page, Idml::Elements::Page, collection: true
       attribute :rectangle, Idml::Elements::Rectangle, collection: true
+      attribute :oval, Idml::Elements::Oval, collection: true
+      attribute :path, Idml::Elements::Path, collection: true
       attribute :text_frame, Idml::Elements::TextFrame, collection: true
       attribute :polygon, Idml::Elements::Polygon, collection: true
       attribute :group, Idml::Elements::Group, collection: true
@@ -43,6 +45,8 @@ module Idml
         map_attribute "FlattenerOverride", to: :flattener_override
         map_element "Page", to: :page
         map_element "Rectangle", to: :rectangle
+        map_element "Oval", to: :oval
+        map_element "Path", to: :path
         map_element "TextFrame", to: :text_frame
         map_element "Polygon", to: :polygon
         map_element "Group", to: :group

data/lib/idml/elements.rb

@@ -105,11 +105,13 @@ module Idml
     autoload :OuterGlowSetting, "idml/elements/outer_glow_setting"
     autoload :PageItemDefault, "idml/elements/pref_page_item_default"
     autoload :Page, "idml/elements/page"
+    autoload :Oval, "idml/elements/oval"
     autoload :ParagraphStyle, "idml/elements/paragraph_style"
     autoload :ParagraphStyleGroup, "idml/elements/paragraph_style_group"
     autoload :ParagraphStyleRange, "idml/elements/paragraph_style_range"
     autoload :PasteboardPreference, "idml/elements/pref_pasteboard_preference"
     autoload :PastedSmoothShade, "idml/elements/pasted_smooth_shade"
+    autoload :Path, "idml/elements/path"
     autoload :PathGeometry, "idml/elements/path_geometry"
     autoload :PathPointArray, "idml/elements/path_point_array"
     autoload :PathPointType, "idml/elements/path_point_type"

data/lib/idml/render/page_item_renderer.rb

@@ -9,6 +9,8 @@ module Idml
     module PageItemRenderer
       RENDERER_MAP = {
         Idml::Elements::Rectangle => "RectangleRenderer",
+        Idml::Elements::Oval => "OvalRenderer",
+        Idml::Elements::Path => "PathRenderer",
         Idml::Elements::TextFrame => "TextFrameRenderer",
         Idml::Elements::Polygon => "PolygonRenderer",
         Idml::Elements::GraphicLine => "GraphicLineRenderer",

data/lib/idml/render/renderers/oval_renderer.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Idml
+  module Render
+    module Renderers
+      # Renders an IDML Oval on a Pdfrb::Content::Canvas. Delegates to
+      # RectangleRenderer which draws the bounding box with fill/stroke.
+      # Approximation: a true ellipse would generate bezier anchor and
+      # control points from the PathGeometry; the bounding box renders
+      # the correct extent and colors. See TODO 106 for refinement.
+      class OvalRenderer
+        def self.render(canvas, context)
+          RectangleRenderer.render(canvas, context)
+        end
+      end
+    end
+  end
+end

data/lib/idml/render/renderers/path_renderer.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Idml
+  module Render
+    module Renderers
+      # Renders an IDML Path (standalone compound path) on a
+      # Pdfrb::Content::Canvas. Delegates to RectangleRenderer which
+      # draws the bounding box with fill/stroke. Approximation: a true
+      # compound path would draw each sub-path from the EntirePath
+      # list or PathPoint children; the bounding box renders the
+      # correct extent and colors. See TODO 106 for refinement.
+      class PathRenderer
+        def self.render(canvas, context)
+          RectangleRenderer.render(canvas, context)
+        end
+      end
+    end
+  end
+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"
@@ -60,6 +61,14 @@ Idml::Render::Renderers.autoload(
   :RectangleRenderer,
   "#{__dir__}/render/renderers/rectangle_renderer",
 )
+Idml::Render::Renderers.autoload(
+  :OvalRenderer,
+  "#{__dir__}/render/renderers/oval_renderer",
+)
+Idml::Render::Renderers.autoload(
+  :PathRenderer,
+  "#{__dir__}/render/renderers/path_renderer",
+)
 Idml::Render::Renderers.autoload(
   :TextFrameRenderer,
   "#{__dir__}/render/renderers/text_frame_renderer",

data/lib/idml/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: idml
 version: !ruby/object:Gem::Version
-  version: 0.8.4
+  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
@@ -326,11 +326,13 @@ files:
 - lib/idml/elements/object_style_stroke_effects_category_settings.rb
 - lib/idml/elements/opacity_gradient_stop.rb
 - lib/idml/elements/outer_glow_setting.rb
+- lib/idml/elements/oval.rb
 - lib/idml/elements/page.rb
 - lib/idml/elements/paragraph_style.rb
 - lib/idml/elements/paragraph_style_group.rb
 - lib/idml/elements/paragraph_style_range.rb
 - lib/idml/elements/pasted_smooth_shade.rb
+- lib/idml/elements/path.rb
 - lib/idml/elements/path_geometry.rb
 - lib/idml/elements/path_point_array.rb
 - lib/idml/elements/path_point_type.rb
@@ -459,6 +461,8 @@ files:
 - lib/idml/render/renderers.rb
 - lib/idml/render/renderers/graphic_line_renderer.rb
 - lib/idml/render/renderers/group_renderer.rb
+- lib/idml/render/renderers/oval_renderer.rb
+- lib/idml/render/renderers/path_renderer.rb
 - lib/idml/render/renderers/polygon_renderer.rb
 - lib/idml/render/renderers/rectangle_renderer.rb
 - lib/idml/render/renderers/table_renderer.rb
@@ -471,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