hexapdf 1.7.0 → 1.9.0

data/lib/hexapdf/font_loader/standard14.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2025 Thomas Leitner
+# Copyright (C) 2014-2026 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as

data/lib/hexapdf/font_loader/variant_from_name.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2025 Thomas Leitner
+# Copyright (C) 2014-2026 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as

data/lib/hexapdf/font_loader.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2025 Thomas Leitner
+# Copyright (C) 2014-2026 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as
@@ -45,6 +45,53 @@ module HexaPDF
   # needs to be usable by the PDF canvas. See below for details.
   #
   #
+  # == Available Font Loaders
+  #
+  # The following font loaders are available:
+  #
+  # HexaPDF::FontLoader::Standard14::
+  #     This one makes the standard 14 PDF fonts (Helvetica in variants none, italic, bold and bold
+  #     italic; Times in variants none, italic, bold and bold italic; Symbol; and ZapfDingbats)
+  #     available.
+  #
+  #     Usage:
+  #
+  #       canvas.font('Times', variant: :bold)
+  #
+  # HexaPDF::FontLoader::FromFile::
+  #     Interprets the font name as filename and tries to load the font from there. In this case a
+  #     +:variant+ argument cannot be used as the font file is directly specified.
+  #
+  #     Usage:
+  #
+  #       canvas.font('/usr/share/fonts/truetype/hack/Hack-Regular.ttf')
+  #
+  # HexaPDF::FontLoader::VariantFromName:
+  #     This one doesn't really load a font itself but makes it possible to append the variant name
+  #     to the font name. So it resolves e.g. 'Times bold' to the font 'Times' in variant :bold.
+  #
+  #     Usage:
+  #
+  #       canvas.font('Times bold')
+  #
+  # HexaPDF::FontLoader::FromConfiguration
+  #     This font loader defers to FromFile when loading the actual fonts. It allows defining font
+  #     mappings using the configuration option 'font.map' where a font name is mapped to a hash
+  #     that maps variant names to font file names.
+  #
+  #     Usage:
+  #
+  #       doc.config['font.map'] = {
+  #         'Hack' => {
+  #            none: '/usr/share/fonts/ttf/Hack-Regular.ttf',
+  #            bold: '/usr/share/fonts/ttf/Hack-Bold.ttf',
+  #            italic: '/usr/share/fonts/ttf/Hack-Italic.ttf',
+  #            bold_italic: '/usr/share/fonts/ttf/Hack-BoldItalic.ttf',
+  #          },
+  #        }
+  #        canvas.font('Hack', variant: :italic)
+  #
+  #
   # == Implementation of a Font Loader
   #
   # Each font loader is a (stateless) object (normally a module) that has to be callable, i.e. it

data/lib/hexapdf/image_loader/jpeg.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2025 Thomas Leitner
+# Copyright (C) 2014-2026 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as

data/lib/hexapdf/image_loader/pdf.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2025 Thomas Leitner
+# Copyright (C) 2014-2026 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as

data/lib/hexapdf/image_loader/png.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2025 Thomas Leitner
+# Copyright (C) 2014-2026 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as

data/lib/hexapdf/image_loader.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2025 Thomas Leitner
+# Copyright (C) 2014-2026 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as

data/lib/hexapdf/importer.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2025 Thomas Leitner
+# Copyright (C) 2014-2026 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as

data/lib/hexapdf/layout/box.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2025 Thomas Leitner
+# Copyright (C) 2014-2026 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as

data/lib/hexapdf/layout/box_fitter.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2025 Thomas Leitner
+# Copyright (C) 2014-2026 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as

data/lib/hexapdf/layout/column_box.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2025 Thomas Leitner
+# Copyright (C) 2014-2026 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as

data/lib/hexapdf/layout/container_box.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2025 Thomas Leitner
+# Copyright (C) 2014-2026 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as
@@ -163,15 +163,13 @@ module HexaPDF
         @box_fitter = BoxFitter.new([my_frame])
         children.each {|box| @box_fitter.fit(box) }
 
-        if @box_fitter.success?
+        if @box_fitter.success? || (!@box_fitter.fit_results.empty? && @splitable)
           update_content_width do
             result = @box_fitter.fit_results.max_by {|r| r.mask.x + r.mask.width }
             children.empty? ? 0 : result.mask.x + result.mask.width - my_frame.left
           end
           update_content_height { @box_fitter.content_heights.max }
-          fit_result.success!
-        elsif !@box_fitter.fit_results.empty? && @splitable
-          fit_result.overflow!
+          @box_fitter.success? ? fit_result.success! : fit_result.overflow!
         end
       end
 

data/lib/hexapdf/layout/frame.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2025 Thomas Leitner
+# Copyright (C) 2014-2026 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as

data/lib/hexapdf/layout/image_box.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2025 Thomas Leitner
+# Copyright (C) 2014-2026 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as

data/lib/hexapdf/layout/inline_box.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2025 Thomas Leitner
+# Copyright (C) 2014-2026 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as

data/lib/hexapdf/layout/line.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2025 Thomas Leitner
+# Copyright (C) 2014-2026 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as

data/lib/hexapdf/layout/list_box.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2025 Thomas Leitner
+# Copyright (C) 2014-2026 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as

data/lib/hexapdf/layout/numeric_refinements.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2025 Thomas Leitner
+# Copyright (C) 2014-2026 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as

data/lib/hexapdf/layout/page_style.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2025 Thomas Leitner
+# Copyright (C) 2014-2026 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as

data/lib/hexapdf/layout/style.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2025 Thomas Leitner
+# Copyright (C) 2014-2026 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as
@@ -811,18 +811,76 @@ module HexaPDF
       #   font_features(features = nil)
       #
       # The font features (e.g. kerning, ligatures, ...) that should be applied by the shaping
-      # engine, defaults to {} (i.e. no font features are applied).
+      # engine, defaults to the empty hash {} (i.e. no font features are applied).
       #
-      # Each feature to be applied is indicated by a key with a truthy value.
+      # Each feature can either be activated using `true` as value, deactivated using `false` as
+      # value or set to a specific mode using an integer. What is actually supported depends on the
+      # used shaping engine.
       #
-      # See: HexaPDF::Layout::TextShaper#shape_text for available features.
+      # See: #shaping_engine
       #
       # Examples:
       #
       #   #>pdf-composer100
       #   composer.style(:base, font: ["Times", custom_encoding: true], font_size: 30)
       #   composer.text("Test flight")
-      #   composer.text("Test flight", font_features: {kern: true, liga: true})
+      #   composer.text("Test flight", font_features: {kern: true, liga: false})
+
+      ##
+      # :method: font_script
+      # :call-seq:
+      #   font_script(script = nil)
+      #
+      # The script in which the text is written, defaults to +nil+.
+      #
+      # This is used by the shaping engine to select the correct shaping implementation. If not set,
+      # the script is guessed from the text.
+      #
+      # See: #shaping_engine
+
+      ##
+      # :method: language
+      # :call-seq:
+      #   language(lang = nil)
+      #
+      # The language in which the text is written, defaults to +nil+.
+      #
+      # This is used, for example, by the shaping engine to correctly shape the text.
+      #
+      # See: #shaping_engine
+
+      ##
+      # :method: direction
+      # :call-seq:
+      #   direction(dir = nil)
+      #
+      # The direction of text, defaults to +:ltr+ (possible values are +:ltr+ and +:rtl+).
+      #
+      # This is used by the shaping engine to correctly shape the text.
+      #
+      # See: #shaping_engine
+
+      ##
+      # :method: shaping_engine
+      # :call-seq:
+      #   shaping_engine(engine = nil)
+      #
+      # The shaping engine that should be used, defaults to +:internal+. The other possible value is
+      # +:harfbuzz+.
+      #
+      # When set to +:harfbuzz+, the Rubygem +harfbuzz-ruby+ needs to be installed. If it is not
+      # available, HexaPDF will raise an error.
+      #
+      # See: HexaPDF::Layout::TextShaper for details.
+      #
+      # Examples:
+      #
+      #   #>pdf-composer100
+      #   composer.style(:base, font: 'Inter')
+      #   composer.text("Incoming WAVE!")
+      #   composer.formatted_text(["Incoming WAVE!",
+      #                            {text: " Take Cover!", font_features: {ss06: true}}],
+      #                            shaping_engine: :harfbuzz)
 
       ##
       # :method: text_rendering_mode
@@ -1541,6 +1599,10 @@ module HexaPDF
         [:horizontal_scaling, 100],
         [:text_rise, 0],
         [:font_features, {}],
+        [:font_script, nil],
+        [:language, nil],
+        [:direction, :ltr, {valid_values: [:ltr, :rtl]}],
+        [:shaping_engine, :internal, {valid_values: [:internal, :harfbuzz]}],
         [:text_rendering_mode, "Content::TextRenderingMode::FILL",
          {setter: "Content::TextRenderingMode.normalize(value)"}],
         [:subscript, false,

data/lib/hexapdf/layout/table_box.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2025 Thomas Leitner
+# Copyright (C) 2014-2026 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as
@@ -108,6 +108,17 @@ module HexaPDF
     #           [layout.text('E'), layout.text('F')]]
     #  composer.column(height: 50) {|col| col.table(cells) }
     #
+    # If a cell doesn't completely fit, it is split. Non-split cells in the same continuation row
+    # retain their style but are empty:
+    #
+    #  #>pdf-composer
+    #  cells = [[layout.text('A'), layout.text('B')],
+    #           [layout.text('C'), layout.text("D1\nD2")],
+    #           [layout.text('E'), layout.text('F')]]
+    #  composer.column(height: 50) {|col| col.table(cells) }
+    #
+    # Note that the above is only true for cells in rows that are not part of a row-span.
+    #
     # It is also possible to use row and column spans:
     #
     #  #>pdf-composer
@@ -237,6 +248,7 @@ module HexaPDF
 
         # Fits the children of the table cell into the given rectangular area.
         def fit_content(available_width, available_height, frame)
+          @remaining_boxes = nil
           width = available_width - reserved_width
           height = @used_height = available_height - reserved_height
           return if width <= 0 || height <= 0
@@ -245,21 +257,27 @@ module HexaPDF
           case children
           when Box
             child_result = frame.fit(children)
-            if child_result.success?
+            box, @remaining_boxes = children.split if child_result.overflow?
+            if child_result.success? || box
               @preferred_width = child_result.x + child_result.box.width + reserved_width
               @height = @preferred_height = child_result.box.height + reserved_height
               @fit_results = [child_result]
-              fit_result.success!
+              box ? fit_result.overflow! : fit_result.success!
             end
           when Array
             box_fitter = BoxFitter.new([frame])
             children.each {|box| box_fitter.fit(box) }
-            if box_fitter.success?
+            if box_fitter.success? || !box_fitter.fit_results.empty?
               max_x_result = box_fitter.fit_results.max_by {|result| result.x + result.box.width }
               @preferred_width = max_x_result.x + max_x_result.box.width + reserved_width
               @height = @preferred_height = box_fitter.content_heights[0] + reserved_height
               @fit_results = box_fitter.fit_results
-              fit_result.success!
+              if box_fitter.success?
+                fit_result.success!
+              else
+                @remaining_boxes = box_fitter.remaining_boxes
+                fit_result.overflow!
+              end
             end
           else
             @preferred_width = reserved_width
@@ -274,6 +292,14 @@ module HexaPDF
           end
         end
 
+        # Splits the content of the cell.
+        def split_content
+          box = create_split_box
+          box.instance_variable_set(:@children, @remaining_boxes)
+          box.instance_variable_set(:@remaining_boxes, nil)
+          [self, box]
+        end
+
         # Draws the content of the cell.
         def draw_content(canvas, x, y)
           return if @fit_results.empty?
@@ -363,7 +389,7 @@ module HexaPDF
         # Note that the same cell instance may be returned for different (row, column) arguments if
         # the cell spans more than one row and/or column.
         def [](row, column)
-          @cells[row]&.[](column)
+          row == @overridden_row_index ? @overridden_row_cells[column] : @cells[row]&.[](column)
         end
 
         # Returns the number of rows.
@@ -378,7 +404,15 @@ module HexaPDF
 
         # Iterates over each row.
         def each_row(&block)
-          @cells.each(&block)
+          return to_enum(__method__) unless block_given?
+
+          if @overridden_row_index
+            @cells[0...@overridden_row_index].each(&block)
+            block&.call(@overridden_row_cells)
+            @cells[(@overridden_row_index + 1)..-1].each(&block)
+          else
+            @cells.each(&block)
+          end
         end
 
         # Applies the given style properties to all cells and optionally yields all cells for more
@@ -409,12 +443,19 @@ module HexaPDF
           row_heights = {}
           zero_height_rows = {}
           row_spans = []
+          split_row_cells = nil
 
           @cells[start_row..-1].each.with_index(start_row) do |columns, row_index|
+            columns = @overridden_row_cells if row_index == @overridden_row_index
+
+            # Rows containing row-spanning cells aren't supported for cell-splitting
+            row_has_row_spans = columns.any? {|cell| cell.row != row_index || cell.row_span > 1 }
+
             # 1. Fit all columns of the row and record the max height of all non-row-span cells. If
             #    a row has zero height (usually because it only has row-span cells), record that
             #    information. Additionally store all cells with row-spans.
             row_fit = true
+            row_has_split_cells = false
             row_height = 0
             columns.each_with_index do |cell, col_index|
               next if cell.row != row_index || cell.column != col_index
@@ -423,9 +464,14 @@ module HexaPDF
                                      else
                                        column_info[cell.column].last
                                      end
-              unless cell.fit(available_cell_width, available_height, frame).success?
-                row_fit = false
-                break
+              cell_fit_result = cell.fit(available_cell_width, available_height, frame)
+              unless cell_fit_result.success?
+                if !row_has_row_spans && cell_fit_result.overflow?
+                  row_has_split_cells = true
+                else
+                  row_fit = false
+                  break
+                end
               end
               if row_height < cell.preferred_height && cell.row_span == 1
                 row_height = cell.preferred_height
@@ -462,6 +508,11 @@ module HexaPDF
                   available_height -= cell.preferred_height - row_span_height
                 end
               end
+
+              if row_has_split_cells
+                split_row_cells = create_split_row_cells(columns)
+                break
+              end
             else
               last_fitted_row_index = columns.min_by(&:row).row - 1 if height != available_height
               break
@@ -473,6 +524,7 @@ module HexaPDF
             #    final height and top-left corner of each cell needs to be set.
             running_height = 0
             @cells[start_row..last_fitted_row_index].each.with_index(start_row) do |columns, row_index|
+              columns = @overridden_row_cells if row_index == @overridden_row_index
               columns.each_with_index do |cell, col_index|
                 next if cell.row != row_index || cell.column != col_index
                 cell.left = column_info[cell.column].first
@@ -488,13 +540,15 @@ module HexaPDF
             end
           end
 
-          [height - available_height, last_fitted_row_index < start_row ? -1 : last_fitted_row_index]
+          [height - available_height, last_fitted_row_index < start_row ? -1 : last_fitted_row_index,
+           split_row_cells]
         end
 
         # Draws the rows from +start_row+ to +end_row+ on the given +canvas+, with the top-left
         # corner of the resulting table being at (+x+, +y+).
         def draw_rows(start_row, end_row, canvas, x, y)
           @cells[start_row..end_row].each.with_index(start_row) do |columns, row_index|
+            columns = @overridden_row_cells if row_index == @overridden_row_index
             columns.each_with_index do |cell, col_index|
               next if cell.row != row_index || cell.column != col_index
               cell.draw(canvas, x + cell.left, y - cell.top - cell.height)
@@ -557,6 +611,22 @@ module HexaPDF
           end
         end
 
+        # Splits all cells in +columns+ and returns the new array.
+        def create_split_row_cells(columns)
+          columns.map.with_index do |cell, col_index|
+            next cell unless cell.column == col_index
+            _, split_box = cell.split
+            if split_box
+              split_box
+            else
+              # Create an empty clone of the fully fit cell
+              empty_cell = cell.send(:create_split_box)
+              empty_cell.instance_variable_set(:@children, nil)
+              empty_cell
+            end
+          end
+        end
+
       end
 
       # The Cells instance containing the data of the table.
@@ -682,6 +752,7 @@ module HexaPDF
         @special_cells_fit_not_successful = false
         [@header_cells, @footer_cells].each do |special_cells|
           next unless special_cells
+          # Ignore split-cells (3rd result element) as not fully-fit headers/footers lead to failure
           special_used_height, last_fitted_row_index = special_cells.fit_rows(0, height, columns, frame)
           height -= special_used_height
           used_height += special_used_height
@@ -689,13 +760,14 @@ module HexaPDF
           return nil if @special_cells_fit_not_successful
         end
 
-        main_used_height, @last_fitted_row_index = @cells.fit_rows(@start_row_index, height, columns, frame)
+        main_used_height, @last_fitted_row_index, @split_row_cells =
+          @cells.fit_rows(@start_row_index, height, columns, frame)
         used_height += main_used_height
 
         update_content_width { columns[-1].sum + rw }
         update_content_height { used_height + rh }
 
-        if @last_fitted_row_index == @cells.number_of_rows - 1
+        if @last_fitted_row_index == @cells.number_of_rows - 1 && !@split_row_cells
           fit_result.success!
         elsif @last_fitted_row_index >= 0
           fit_result.overflow!
@@ -724,8 +796,19 @@ module HexaPDF
       # Splits the content of the table box. This method is called from Box#split.
       def split_content
         box = create_split_box
-        box.instance_variable_set(:@start_row_index, @last_fitted_row_index + 1)
+
+        if @split_row_cells
+          cells = @cells.clone
+          cells.instance_variable_set(:@overridden_row_cells, @split_row_cells)
+          cells.instance_variable_set(:@overridden_row_index, @last_fitted_row_index)
+          box.instance_variable_set(:@cells, cells)
+          box.instance_variable_set(:@start_row_index, @last_fitted_row_index)
+        else
+          box.instance_variable_set(:@start_row_index, @last_fitted_row_index + 1)
+        end
+
         box.instance_variable_set(:@last_fitted_row_index, -1)
+        box.instance_variable_set(:@split_row_cells, nil)
         box.instance_variable_set(:@special_cells_fit_not_successful, nil)
         header_cells = @header ? Cells.new(@header.call(self), cell_style: @cell_style) : nil
         box.instance_variable_set(:@header_cells, header_cells)

data/lib/hexapdf/layout/text_box.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2025 Thomas Leitner
+# Copyright (C) 2014-2026 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as