idml 0.8.2 → 0.8.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 27df11baaefb3de6bfc6198404a9b3ad10b54b53de8a44cbe58658afdfdf4d4b
-  data.tar.gz: 4274cf4d1869bab1457da1427d8ba96d27cf64ced0140174923b7492ee283dd8
+  metadata.gz: 0672dfcc5cf9d3116f38dd98904f2d2ba10a8373d04814d6fa936f0bffcf93c0
+  data.tar.gz: a3e3d982c061380e4201490366bac05c066bec85829b397378f933a6fea27d27
 SHA512:
-  metadata.gz: '02936232be8a99effaf2f417d765281700c8f6b89004bab18e462d29d8b60b12259a715780fd0c2c1b68d41e5f82cd087b2933753551c72f3235d5cfbe3e3640'
-  data.tar.gz: e92764f18f109a4ae66dabb4ebfcb3a991cd2926c22e7836de42e99d7c1b45e931cd0aa4f22678193564fb82bdbf24eeccd593405a1ada0322cda7f5ce54f32d
+  metadata.gz: fac32a9ec144ccf1970834c0724e1eb33667f140955f2b10fad3168823c55f64826b33ccb5b4aa781ecd53b6478515cac62809603d290706a4c433784b10b266
+  data.tar.gz: ed671dd23f413602e93506584114efb806a294d2970ccd0c17571b786dba9b64323dcfb03411cf8cd0571aaf9696eda7792e4eac8eee4197100797b37eed3c43

data/TODO.pdf/113-multi-column-text-frames.md

@@ -1,6 +1,10 @@
 # TODO PDF 113: Multi-column text frames (TextColumnCount, TextColumnGutter)
 
-## Status: OPEN — gap identified in 2026-08-10 audit
+## Status: DONE — engine_render detects TextColumnCount > 1 and
+splits the frame into N column-specific Frame structs. Text flows
+column 1 → column 2 → ... → chain to next frame via StoryChainController.
+Each column acts as a mini-frame with the same height/insets but a
+narrower width. TextColumnGutter honored as the gap between columns.
 
 ## Problem
 

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

@@ -158,7 +158,22 @@ module Idml
         # next frame in the chain.
         def self.engine_render(canvas, state, context, box, font)
           layout_frame = layout_frame(context.item, box)
-          top_y = box[:y] + box[:height] - (layout_frame.inset_top || 0)
+          col_count = text_column_count(context)
+
+          if col_count && col_count > 1
+            engine_render_multi_column(canvas, state, context, layout_frame,
+                                       font, col_count)
+          else
+            engine_render_single_column(canvas, state, context, layout_frame,
+                                        font)
+          end
+        end
+        private_class_method :engine_render
+
+        def self.engine_render_single_column(canvas, state, context,
+                                              layout_frame, font)
+          top_y = layout_frame.y + layout_frame.height -
+            (layout_frame.inset_top || 0)
           bottom_limit = TextEngine::VerticalLayout.bottom_limit(layout_frame)
           cursor_y = vertical_justify_top(top_y, bottom_limit, state, context)
           char_cursor = state.char_cursor
@@ -174,7 +189,87 @@ module Idml
           consume_paragraphs(canvas, state, context, layout_frame, font,
                              cursor_y, bottom_limit, char_cursor)
         end
-        private_class_method :engine_render
+        private_class_method :engine_render_single_column
+
+        # Renders text across N columns within a single frame. Text
+        # flows column 1 → column 2 → ... → chain to next frame. Each
+        # column acts as a mini-frame with the same height but a
+        # narrower width. The chain state threads across columns
+        # transparently.
+        def self.engine_render_multi_column(canvas, state, context,
+                                             layout_frame, font, col_count)
+          gutter = text_column_gutter(context) || 0
+          col_frames = build_column_frames(layout_frame, col_count, gutter)
+
+          col_frames.each do |col_frame|
+            break if state_empty?(state)
+
+            render_column(canvas, state, context, col_frame, font)
+          end
+        end
+        private_class_method :engine_render_multi_column
+
+        def self.render_column(canvas, state, context, col_frame, font)
+          top_y = col_frame.y + col_frame.height - (col_frame.inset_top || 0)
+          bottom_limit = TextEngine::VerticalLayout.bottom_limit(col_frame)
+          cursor_y = top_y
+          char_cursor = state.char_cursor
+
+          if state.current_paragraph
+            cursor_y, char_cursor = resume_paragraph(
+              canvas, state, context, col_frame, font,
+              cursor_y, bottom_limit, char_cursor
+            )
+            return if state.current_paragraph
+          end
+
+          consume_paragraphs(canvas, state, context, col_frame, font,
+                             cursor_y, bottom_limit, char_cursor)
+        end
+        private_class_method :render_column
+
+        def self.state_empty?(state)
+          state.paragraphs.empty? && state.current_paragraph.nil?
+        end
+        private_class_method :state_empty?
+
+        def self.text_column_count(context)
+          pref = context.item&.text_frame_preference&.first
+          pref&.text_column_count
+        end
+        private_class_method :text_column_count
+
+        def self.text_column_gutter(context)
+          pref = context.item&.text_frame_preference&.first
+          pref&.text_column_gutter
+        end
+        private_class_method :text_column_gutter
+
+        # Builds N column-specific Frame structs from the parent
+        # layout frame. Each column has the same y/height/insets but
+        # a different x and width so VerticalLayout's geometry math
+        # produces correct per-column results.
+        def self.build_column_frames(layout_frame, col_count, gutter)
+          inset_left = layout_frame.inset_left || 0
+          inset_right = layout_frame.inset_right || 0
+          content_width = layout_frame.width - inset_left - inset_right
+          col_width = (content_width - ((col_count - 1) * gutter)) / col_count
+
+          Array.new(col_count) do |i|
+            col_left = layout_frame.x + inset_left + (i * (col_width + gutter))
+            TextEngine::Frame.new(
+              x: col_left - inset_left,
+              y: layout_frame.y,
+              width: col_width + inset_left + inset_right,
+              height: layout_frame.height,
+              inset_top: layout_frame.inset_top,
+              inset_bottom: layout_frame.inset_bottom,
+              inset_left: inset_left,
+              inset_right: inset_right,
+            )
+          end
+        end
+        private_class_method :build_column_frames
 
         # Computes the starting cursor_y for vertical justification.
         # IDML's TextFramePreference.VerticalJustification can be:

data/lib/idml/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: idml
 version: !ruby/object:Gem::Version
-  version: 0.8.2
+  version: 0.8.3
 platform: ruby
 authors:
 - Ribose
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-08-13 00:00:00.000000000 Z
+date: 2026-08-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bigdecimal