xlsxrb 0.1.13 → 0.1.14

data/sig/generated/xlsxrb/stream_writer.rbs

@@ -123,12 +123,24 @@ module Xlsxrb
       # @param hidden [Boolean] Whether the row is hidden.
       # @param custom_height [Boolean] Whether to flag as custom height.
       # @param outline_level [Integer, nil] Grouping/outline level (0 - 7).
+      # @param collapsed [Boolean] Whether the row is collapsed.
       # @return [void]
       # @api public
-      # : (Array[untyped] | Hash[untyped, untyped] values, ?styles: untyped, ?height: Float | Integer | nil, ?hidden: bool, ?custom_height: bool, ?outline_level: Integer | nil) -> void
-      def row: (Array[untyped] | Hash[untyped, untyped] values, ?styles: untyped, ?height: Float | Integer | nil, ?hidden: bool, ?custom_height: bool, ?outline_level: Integer | nil) -> void
+      # : (Array[untyped] | Hash[untyped, untyped] values, ?styles: untyped, ?height: Float | Integer | nil, ?hidden: bool, ?custom_height: bool, ?collapsed: bool, ?outline_level: Integer | nil) -> void
+      def row: (Array[untyped] | Hash[untyped, untyped] values, ?styles: untyped, ?height: Float | Integer | nil, ?hidden: bool, ?custom_height: bool, ?collapsed: bool, ?outline_level: Integer | nil) -> void
 
-      alias << row
+      alias add_row row
+
+      # Appends a row to the worksheet and returns self for chaining.
+      #
+      # @example
+      #   sheet << ["A", 1] << ["B", 2]
+      #
+      # @param values [Array, Hash] Row cell values.
+      # @return [self]
+      # @api public
+      # : (Array[untyped] | Hash[untyped, untyped] values) -> self
+      def <<: (Array[untyped] | Hash[untyped, untyped] values) -> self
 
       # Configures column width and properties.
       #
@@ -179,8 +191,8 @@ module Xlsxrb
       # @param location [String, nil] Destination location / URL (keyword alternative).
       # @return [void]
       # @api public
-      # : (String cell, ?String? url, ?display: String?, ?tooltip: String?, ?location: String?) -> void
-      def hyperlink: (String cell, ?String? url, ?display: String?, ?tooltip: String?, ?location: String?) -> void
+      # : (String | Integer cell, ?(String | Elements::Hyperlink)? url, ?display: String?, ?tooltip: String?, ?location: String?) -> void
+      def hyperlink: (String | Integer cell, ?(String | Elements::Hyperlink)? url, ?display: String?, ?tooltip: String?, ?location: String?) -> void
 
       # Sets the auto-filter range on the active sheet.
       #
@@ -307,6 +319,26 @@ module Xlsxrb
       # : (sparklines: Array[Hash[Symbol, untyped]], ?type: (String | Symbol)?, **untyped opts) -> void
       def sparkline_group: (sparklines: Array[Hash[Symbol, untyped]], ?type: (String | Symbol)?, **untyped opts) -> void
 
+      # Adds a single sparkline to the sheet.
+      #
+      # @example Add a line sparkline
+      #   s.add_sparkline(location: "F1", range: "A1:E1")
+      #
+      # @example Add a column sparkline with high/low markers
+      #   s.add_sparkline(location: "F2", range: "A2:E2", type: :column, high: true, low: true)
+      #
+      # @example Add a win/loss sparkline
+      #   s.add_sparkline(location: "F3", range: "A3:E3", type: :win_loss)
+      #
+      # @param location [String, nil] Target cell for the sparkline (e.g. "F1").
+      # @param range [String, nil] Data range for the sparkline (e.g. "A1:E1").
+      # @param type [Symbol, String, nil] Sparkline type (:line, :column, :win_loss / :stacked).
+      # @param opts [Hash] Additional sparkline options.
+      # @return [void]
+      # @api public
+      # : (?location: String?, ?range: String?, ?type: (String | Symbol)?, **untyped opts) -> void
+      def add_sparkline: (?location: String?, ?range: String?, ?type: (String | Symbol)?, **untyped opts) -> void
+
       # Sets workbook-level properties.
       #
       # @param opts [Hash] Workbook property options.
@@ -377,6 +409,24 @@ module Xlsxrb
       # : (?rows: String?, ?cols: String?) -> void
       def print_titles: (?rows: String?, ?cols: String?) -> void
 
+      # Sets repeating title rows to appear at the top of each printed page.
+      #
+      # @param first [Integer, String] First row index (0-based) or range string (e.g. "1:2").
+      # @param last [Integer, String, nil] Optional last row index (0-based).
+      # @return [void]
+      # @api public
+      # : (Integer | String first, ?(Integer | String)? last) -> void
+      def repeat_rows: (Integer | String first, ?(Integer | String)? last) -> void
+
+      # Sets repeating title columns to appear at the left of each printed page.
+      #
+      # @param first [Integer, String] First column index (0-based) or column name/range.
+      # @param last [Integer, String, nil] Optional last column index/name.
+      # @return [void]
+      # @api public
+      # : (Integer | String first, ?(Integer | String)? last) -> void
+      def repeat_columns: (Integer | String first, ?(Integer | String)? last) -> void
+
       # Splits sheet view into panes.
       #
       # @param x_split [Numeric, nil] Horizontal split position.
@@ -573,22 +623,32 @@ module Xlsxrb
     # @param outline_level [Integer, nil] Grouping/outline level (0 - 7).
     # @return [void]
     # @api public
-    # : (Array[untyped] | Hash[untyped, untyped] values, ?styles: untyped, ?height: Float | Integer | nil, ?hidden: bool, ?custom_height: bool, ?outline_level: Integer | nil) -> void
-    def row: (Array[untyped] | Hash[untyped, untyped] values, ?styles: untyped, ?height: Float | Integer | nil, ?hidden: bool, ?custom_height: bool, ?outline_level: Integer | nil) -> void
+    # : (Array[untyped] | Hash[untyped, untyped] values, ?styles: untyped, ?height: Float | Integer | nil, ?hidden: bool, ?custom_height: bool, ?collapsed: bool, ?outline_level: Integer | nil) -> void
+    def row: (Array[untyped] | Hash[untyped, untyped] values, ?styles: untyped, ?height: Float | Integer | nil, ?hidden: bool, ?custom_height: bool, ?collapsed: bool, ?outline_level: Integer | nil) -> void
+
+    alias add_row row
 
-    alias << row
+    # Appends a row to the worksheet and returns self for chaining.
+    #
+    # @example
+    #   writer << ["A", 1] << ["B", 2]
+    #
+    # @param values [Array, Hash] Row cell values.
+    # @return [self]
+    # @api public
+    # : (Array[untyped] | Hash[untyped, untyped] values) -> self
+    def <<: (Array[untyped] | Hash[untyped, untyped] values) -> self
 
     # Sets column formatting and properties for one or multiple columns.
     #
     # @param index [Integer, String, Range, Array] Column index (0-based) or letter ("A".."D").
     # @param width [Float, Integer, nil] Column width in character units (0 - 255).
     # @param hidden [Boolean] Whether the column is hidden.
-    # @param custom_width [Boolean] Whether custom width is set.
-    # @param outline_level [Integer, nil] Grouping/outline level.
+    # @param style [Integer, Symbol, String, nil] Column style format or index.
     # @return [void]
     # @api public
-    # : (Integer | String | Range[Integer | String] | Array[Integer | String] index, ?width: Float | Integer | nil, ?hidden: bool, ?custom_width: bool, ?outline_level: Integer | nil) -> void
-    def column: (Integer | String | Range[Integer | String] | Array[Integer | String] index, ?width: Float | Integer | nil, ?hidden: bool, ?custom_width: bool, ?outline_level: Integer | nil) -> void
+    # : (Integer | String | Range[Integer | String] | Array[Integer | String] index, ?width: Float | Integer | nil, ?hidden: bool, ?custom_width: bool, ?outline_level: Integer | nil, ?style: (Integer | Symbol | String)?) -> void
+    def column: (Integer | String | Range[Integer | String] | Array[Integer | String] index, ?width: Float | Integer | nil, ?hidden: bool, ?custom_width: bool, ?outline_level: Integer | nil, ?style: (Integer | Symbol | String)?) -> void
 
     # Adds a chart to the current worksheet.
     #
@@ -609,8 +669,8 @@ module Xlsxrb
     # @param location [String, nil] Internal location.
     # @return [void]
     # @api public
-    # : (String | Integer cell, ?String? url, ?display: String?, ?tooltip: String?, ?location: String?) -> void
-    def hyperlink: (String | Integer cell, ?String? url, ?display: String?, ?tooltip: String?, ?location: String?) -> void
+    # : (String | Integer cell, ?(String | Elements::Hyperlink)? url, ?display: String?, ?tooltip: String?, ?location: String?) -> void
+    def hyperlink: (String | Integer cell, ?(String | Elements::Hyperlink)? url, ?display: String?, ?tooltip: String?, ?location: String?) -> void
 
     # Sets the auto-filter range on the active sheet.
     #
@@ -706,6 +766,26 @@ module Xlsxrb
     # : (sparklines: untyped, ?type: untyped, **untyped opts) -> void
     def sparkline_group: (sparklines: untyped, ?type: untyped, **untyped opts) -> void
 
+    # Adds a single sparkline to the sheet.
+    #
+    # @example Add a line sparkline
+    #   writer.add_sparkline(location: "F1", range: "A1:E1")
+    #
+    # @example Add a column sparkline with high/low markers
+    #   writer.add_sparkline(location: "F2", range: "A2:E2", type: :column, high: true, low: true)
+    #
+    # @example Add a win/loss sparkline
+    #   writer.add_sparkline(location: "F3", range: "A3:E3", type: :win_loss)
+    #
+    # @param location [String, nil] Target cell for the sparkline (e.g. "F1").
+    # @param range [String, nil] Data range for the sparkline (e.g. "A1:E1").
+    # @param type [Symbol, String, nil] Sparkline type (:line, :column, :win_loss / :stacked).
+    # @param opts [Hash] Additional sparkline options.
+    # @return [void]
+    # @api public
+    # : (?location: String?, ?range: String?, ?type: (String | Symbol)?, **untyped opts) -> void
+    def add_sparkline: (?location: String?, ?range: String?, ?type: (String | Symbol)?, **untyped opts) -> void
+
     # Merges a range of cells into a single cell.
     #
     # @param range [String, Hash, nil] Cell range (e.g. "A1:B2") or hash of coordinates.
@@ -886,6 +966,32 @@ module Xlsxrb
     # : (?rows: String?, ?cols: String?, ?sheet: String?) -> void
     def print_titles: (?rows: String?, ?cols: String?, ?sheet: String?) -> void
 
+    # Sets repeating title rows for pagination on the current or named sheet.
+    #
+    # @example Repeat first row
+    #   stream.repeat_rows(0)
+    #
+    # @param first [Integer, String] First row index (0-based) or range string (e.g. "1:2").
+    # @param last [Integer, String, nil] Optional last row index (0-based).
+    # @param sheet [String, nil] Target sheet name.
+    # @return [void]
+    # @api public
+    # : (Integer | String first, ?(Integer | String)? last, ?sheet: String?) -> void
+    def repeat_rows: (Integer | String first, ?(Integer | String)? last, ?sheet: String?) -> void
+
+    # Sets repeating title columns for pagination on the current or named sheet.
+    #
+    # @example Repeat columns A through C
+    #   stream.repeat_columns("A", "C")
+    #
+    # @param first [Integer, String] First column index (0-based) or column name/range.
+    # @param last [Integer, String, nil] Optional last column index/name.
+    # @param sheet [String, nil] Target sheet name.
+    # @return [void]
+    # @api public
+    # : (Integer | String first, ?(Integer | String)? last, ?sheet: String?) -> void
+    def repeat_columns: (Integer | String first, ?(Integer | String)? last, ?sheet: String?) -> void
+
     # Sets workbook protection.
     #
     # @param opts [Hash] Protection options.

data/sig/generated/xlsxrb/style_builder.rbs

@@ -7,6 +7,43 @@ module Xlsxrb
   class StyleBuilder
     COLORS: untyped
 
+    CSS_COLORS: untyped
+
+    BORDER_STYLES: untyped
+
+    BORDER_INDEX_MAP: untyped
+
+    # Normalizes a color definition (CSS color name, hex code, or RGB integer) to an OpenXML hex color string.
+    #
+    # @example
+    #   StyleBuilder.normalize_color(:navy)                 #=> "FF000080"
+    #   StyleBuilder.normalize_color("#FF0000")             #=> "FFFF0000"
+    #   StyleBuilder.normalize_color("#F00")                #=> "FFFF0000"
+    #   StyleBuilder.normalize_color("FF0000", alpha: false) #=> "FF0000"
+    #   StyleBuilder.normalize_color(0xFF0000)              #=> "FFFF0000"
+    #
+    # @param color [String, Symbol, Integer, nil]
+    # @param alpha [Boolean] Whether to include the alpha channel ("AARRGGBB" vs "RRGGBB").
+    # @return [String, nil]
+    # @api public
+    # : (String | Symbol | Integer | nil color, ?alpha: bool) -> String?
+    def self.normalize_color: (String | Symbol | Integer | nil color, ?alpha: bool) -> String?
+
+    # Normalizes a border style symbol, string, or integer index to an OOXML ST_BorderStyle symbol.
+    #
+    # @example
+    #   StyleBuilder.normalize_border_style(:border_thin)      #=> :thin
+    #   StyleBuilder.normalize_border_style(1)                 #=> :thin
+    #   StyleBuilder.normalize_border_style(:medium_dashed)    #=> :mediumDashed
+    #   StyleBuilder.normalize_border_style("double")          #=> :double
+    #   StyleBuilder.normalize_border_style(0)                 #=> :none
+    #
+    # @param style [Symbol, String, Integer, nil]
+    # @return [Symbol, nil]
+    # @api public
+    # : (Symbol | String | Integer | nil style) -> Symbol?
+    def self.normalize_border_style: (Symbol | String | Integer | nil style) -> Symbol?
+
     # Resolves a color symbol, string, or prefix to an aRGB hex string.
     #
     # @param color [Symbol, String, Object, nil]
@@ -147,55 +184,55 @@ module Xlsxrb
     def border: (**untyped) -> self
 
     # Sets all borders.
-    # @param style [String, Symbol] The border style.
+    # @param style [String, Symbol, Integer] The border style.
     # @param color [String, Symbol, nil] The color.
     # @return [self]
     # @api public
-    # : (?style: String | Symbol, ?color: String | Symbol | nil) -> self
-    def border_all: (?style: String | Symbol, ?color: String | Symbol | nil) -> self
+    # : (?style: String | Symbol | Integer, ?color: String | Symbol | nil) -> self
+    def border_all: (?style: String | Symbol | Integer, ?color: String | Symbol | nil) -> self
 
     # Sets the left border.
-    # @param style [String, Symbol] The border style.
+    # @param style [String, Symbol, Integer] The border style.
     # @param color [String, Symbol, nil] The color.
     # @return [self]
     # @api public
-    # : (?style: String | Symbol, ?color: String | Symbol | nil) -> self
-    def border_left: (?style: String | Symbol, ?color: String | Symbol | nil) -> self
+    # : (?style: String | Symbol | Integer, ?color: String | Symbol | nil) -> self
+    def border_left: (?style: String | Symbol | Integer, ?color: String | Symbol | nil) -> self
 
     # Sets the right border.
-    # @param style [String, Symbol] The border style.
+    # @param style [String, Symbol, Integer] The border style.
     # @param color [String, Symbol, nil] The color.
     # @return [self]
     # @api public
-    # : (?style: String | Symbol, ?color: String | Symbol | nil) -> self
-    def border_right: (?style: String | Symbol, ?color: String | Symbol | nil) -> self
+    # : (?style: String | Symbol | Integer, ?color: String | Symbol | nil) -> self
+    def border_right: (?style: String | Symbol | Integer, ?color: String | Symbol | nil) -> self
 
     # Sets the top border.
-    # @param style [String, Symbol] The border style.
+    # @param style [String, Symbol, Integer] The border style.
     # @param color [String, Symbol, nil] The color.
     # @return [self]
     # @api public
-    # : (?style: String | Symbol, ?color: String | Symbol | nil) -> self
-    def border_top: (?style: String | Symbol, ?color: String | Symbol | nil) -> self
+    # : (?style: String | Symbol | Integer, ?color: String | Symbol | nil) -> self
+    def border_top: (?style: String | Symbol | Integer, ?color: String | Symbol | nil) -> self
 
     # Sets the bottom border.
-    # @param style [String, Symbol] The border style.
+    # @param style [String, Symbol, Integer] The border style.
     # @param color [String, Symbol, nil] The color.
     # @return [self]
     # @api public
-    # : (?style: String | Symbol, ?color: String | Symbol | nil) -> self
-    def border_bottom: (?style: String | Symbol, ?color: String | Symbol | nil) -> self
+    # : (?style: String | Symbol | Integer, ?color: String | Symbol | nil) -> self
+    def border_bottom: (?style: String | Symbol | Integer, ?color: String | Symbol | nil) -> self
 
     # rubocop:disable Naming/MethodParameterName
     # Sets diagonal borders.
-    # @param style [String, Symbol] The border style.
+    # @param style [String, Symbol, Integer] The border style.
     # @param color [String, Symbol, nil] The color.
     # @param up [Boolean] Diagonal up.
     # @param down [Boolean] Diagonal down.
     # @return [self]
     # @api public
-    # : (?style: String | Symbol, ?color: String | Symbol | nil, ?up: bool, ?down: bool) -> self
-    def border_diagonal: (?style: String | Symbol, ?color: String | Symbol | nil, ?up: bool, ?down: bool) -> self
+    # : (?style: String | Symbol | Integer, ?color: String | Symbol | nil, ?up: bool, ?down: bool) -> self
+    def border_diagonal: (?style: String | Symbol | Integer, ?color: String | Symbol | nil, ?up: bool, ?down: bool) -> self
 
     # Sets horizontal alignment.
     # @param value [String, Symbol] The alignment.

data/sig/generated/xlsxrb/utils.rbs

@@ -0,0 +1,119 @@
+# Generated from lib/xlsxrb/utils.rb with RBS::Inline
+
+module Xlsxrb
+  # Public coordinate conversion and reference parsing utilities.
+  #
+  # @api public
+  module Utils
+    # Converts a cell reference string (e.g. "A1", "BC100") to 0-based [row, col] coordinates.
+    #
+    # @example
+    #   Xlsxrb::Utils.ref_to_row_col("A1")    #=> [0, 0]
+    #   Xlsxrb::Utils.ref_to_row_col("BC100") #=> [99, 54]
+    #
+    # @param cell_ref [String, nil] Excel cell reference string.
+    # @return [Array(Integer, Integer), nil] 0-based [row_idx, col_idx] tuple, or nil if invalid.
+    # @api public
+    # : (String? cell_ref) -> [Integer, Integer]?
+    def self.ref_to_row_col: (String? cell_ref) -> [ Integer, Integer ]?
+
+    # Converts 0-based [row_idx, col_idx] coordinates to an A1-style reference string.
+    #
+    # @example
+    #   Xlsxrb::Utils.row_col_to_ref(0, 0)   #=> "A1"
+    #   Xlsxrb::Utils.row_col_to_ref(99, 54) #=> "BC100"
+    #
+    # @param row_idx [Integer] 0-based row index.
+    # @param col_idx [Integer] 0-based column index.
+    # @return [String] A1-style reference string.
+    # @api public
+    # : (Integer row_idx, Integer col_idx) -> String
+    def self.row_col_to_ref: (Integer row_idx, Integer col_idx) -> String
+
+    # Converts a column letter name (e.g. "A", "BC") to a 0-based integer index.
+    #
+    # @example
+    #   Xlsxrb::Utils.col_name_to_index("A")  #=> 0
+    #   Xlsxrb::Utils.col_name_to_index("BC") #=> 54
+    #
+    # @param col_name [String, Symbol, Integer] Column letter or index.
+    # @return [Integer] 0-based column index.
+    # @api public
+    # : (String | Symbol | Integer col_name) -> Integer
+    def self.col_name_to_index: (String | Symbol | Integer col_name) -> Integer
+
+    # Converts a 0-based column integer index to a column letter name (e.g. 0 -> "A", 54 -> "BC").
+    #
+    # @example
+    #   Xlsxrb::Utils.col_index_to_name(0)  #=> "A"
+    #   Xlsxrb::Utils.col_index_to_name(54) #=> "BC"
+    #
+    # @param col_idx [Integer] 0-based column index.
+    # @return [String] Column letter name.
+    # @api public
+    # : (Integer col_idx) -> String
+    def self.col_index_to_name: (Integer col_idx) -> String
+
+    # Splits an A1-style cell reference into its column name and 1-based row number.
+    #
+    # @example
+    #   Xlsxrb::Utils.split_coordinate("A1")    #=> ["A", 1]
+    #   Xlsxrb::Utils.split_coordinate("BC100") #=> ["BC", 100]
+    #
+    # @param cell_ref [String, nil] Excel cell reference string.
+    # @return [Array(String, Integer), nil] [col_name, row_number] tuple (1-based row), or nil if invalid.
+    # @api public
+    # : (String? cell_ref) -> [String, Integer]?
+    def self.split_coordinate: (String? cell_ref) -> [ String, Integer ]?
+
+    # Converts a Date or Time to an Excel numeric serial number (1900 or 1904 system).
+    #
+    # @example
+    #   Xlsxrb::Utils.date_to_serial(Date.new(2026, 1, 1)) #=> 46023
+    #
+    # @param date_or_time [Date, Time] Date or Time instance.
+    # @param date1904 [Boolean] Whether to use the 1904 date system.
+    # @return [Integer, Float] Serial number.
+    # @api public
+    # : (Date | Time date_or_time, ?date1904: bool) -> (Integer | Float)
+    def self.date_to_serial: (Date | Time date_or_time, ?date1904: bool) -> (Integer | Float)
+
+    # Converts an Excel serial number to a Date.
+    #
+    # @example
+    #   Xlsxrb::Utils.serial_to_date(46023) #=> #<Date: 2026-01-01>
+    #
+    # @param serial [Numeric] Excel serial number.
+    # @param date1904 [Boolean] Whether to use the 1904 date system.
+    # @return [Date]
+    # @api public
+    # : (Numeric serial, ?date1904: bool) -> Date
+    def self.serial_to_date: (Numeric serial, ?date1904: bool) -> Date
+
+    # Converts a Time or Date to a fractional Excel serial number.
+    #
+    # @example
+    #   Xlsxrb::Utils.datetime_to_serial(Time.utc(2026, 1, 1, 12, 0, 0)) #=> 46023.5
+    #
+    # @param time [Time, Date] Time or Date instance.
+    # @param date1904 [Boolean] Whether to use the 1904 date system.
+    # @return [Float] Fractional serial number.
+    # @api public
+    # : (Time | Date time, ?date1904: bool) -> Float
+    def self.datetime_to_serial: (Time | Date time, ?date1904: bool) -> Float
+
+    # Converts an Excel serial number to a Time (UTC).
+    #
+    # @example
+    #   Xlsxrb::Utils.serial_to_time(46023.5) #=> 2026-01-01 12:00:00 UTC
+    #
+    # @param serial [Numeric] Excel serial number.
+    # @param date1904 [Boolean] Whether to use the 1904 date system.
+    # @return [Time]
+    # @api public
+    # : (Numeric serial, ?date1904: bool) -> Time
+    def self.serial_to_time: (Numeric serial, ?date1904: bool) -> Time
+
+    alias self.serial_to_datetime self.serial_to_time
+  end
+end

data/sig/generated/xlsxrb/workbook_builder.rbs

@@ -75,6 +75,32 @@ module Xlsxrb
     # : (?rows: String?, ?cols: String?, ?sheet: String?) -> void
     def print_titles: (?rows: String?, ?cols: String?, ?sheet: String?) -> void
 
+    # Sets repeating title rows for pagination on the target or active sheet.
+    #
+    # @example Repeat first row
+    #   wb.repeat_rows(0)
+    #
+    # @param first [Integer, String] First row index (0-based) or range string (e.g. "1:2").
+    # @param last [Integer, String, nil] Optional last row index (0-based).
+    # @param sheet [String, nil] Target sheet name.
+    # @return [void]
+    # @api public
+    # : (Integer | String first, ?(Integer | String)? last, ?sheet: String?) -> void
+    def repeat_rows: (Integer | String first, ?(Integer | String)? last, ?sheet: String?) -> void
+
+    # Sets repeating title columns for pagination on the target or active sheet.
+    #
+    # @example Repeat columns A through C
+    #   wb.repeat_columns("A", "C")
+    #
+    # @param first [Integer, String] First column index (0-based) or column name/range.
+    # @param last [Integer, String, nil] Optional last column index/name.
+    # @param sheet [String, nil] Target sheet name.
+    # @return [void]
+    # @api public
+    # : (Integer | String first, ?(Integer | String)? last, ?sheet: String?) -> void
+    def repeat_columns: (Integer | String first, ?(Integer | String)? last, ?sheet: String?) -> void
+
     # Sets workbook structure and window protection.
     #
     # @param opts [Hash] Protection options (e.g. lock_structure: true, password: "secret").

data/sig/generated/xlsxrb/worksheet_builder.rbs

@@ -7,8 +7,11 @@ module Xlsxrb
   class WorksheetBuilder
     # @param name [String] The worksheet name.
     # @param strict_excel_mode [Boolean] Whether to enforce Microsoft Excel limits.
-    # : (String name, ?strict_excel_mode: bool) -> void
-    def initialize: (String name, ?strict_excel_mode: bool) -> void
+    # @param state [Symbol] Sheet visibility state (:visible, :hidden, or :very_hidden).
+    # : (String name, ?strict_excel_mode: bool, ?state: Symbol) -> void
+    def initialize: (String name, ?strict_excel_mode: bool, ?state: Symbol) -> void
+
+    attr_reader name: untyped
 
     # Defines or configures a named cell style.
     #
@@ -38,11 +41,25 @@ module Xlsxrb
     # @param hidden [Boolean] Whether the row is hidden.
     # @param custom_height [Boolean] Whether custom row height is enforced.
     # @param outline_level [Integer, nil] Grouping/outline hierarchy level.
+    # @param collapsed [Boolean] Whether the row is collapsed.
     # @return [void]
     # @raise [ArgumentError] If limits are exceeded when strict_excel_mode is enabled.
     # @api public
-    # : (Array[untyped] | Hash[untyped, untyped] values, ?styles: untyped, ?height: Float | Integer | nil, ?hidden: bool, ?custom_height: bool, ?outline_level: Integer | nil) -> void
-    def row: (Array[untyped] | Hash[untyped, untyped] values, ?styles: untyped, ?height: Float | Integer | nil, ?hidden: bool, ?custom_height: bool, ?outline_level: Integer | nil) -> void
+    # : (Array[untyped] | Hash[untyped, untyped] values, ?styles: untyped, ?height: Float | Integer | nil, ?hidden: bool, ?custom_height: bool, ?collapsed: bool, ?outline_level: Integer | nil) -> void
+    def row: (Array[untyped] | Hash[untyped, untyped] values, ?styles: untyped, ?height: Float | Integer | nil, ?hidden: bool, ?custom_height: bool, ?collapsed: bool, ?outline_level: Integer | nil) -> void
+
+    alias add_row row
+
+    # Appends a row to the worksheet and returns self for chaining.
+    #
+    # @example
+    #   sheet << ["A", 1] << ["B", 2]
+    #
+    # @param values [Array, Hash] Row cell values.
+    # @return [self]
+    # @api public
+    # : (Array[untyped] | Hash[untyped, untyped] values) -> self
+    def <<: (Array[untyped] | Hash[untyped, untyped] values) -> self
 
     # Sets column formatting and properties for one or multiple columns.
     #
@@ -54,14 +71,12 @@ module Xlsxrb
     #
     # @param index [Integer, String, Range, Array] Column index (0-based), letter ("A"), or range ("A".."D").
     # @param width [Float, Integer, nil] Column width in character units (0 to 255).
-    # @param hidden [Boolean] Whether the column is hidden.
-    # @param custom_width [Boolean] Whether custom width is explicitly set.
-    # @param outline_level [Integer, nil] Grouping/outline level.
+    # @param style [Integer, Symbol, String, nil] Column style format or index.
     # @return [void]
     # @raise [ArgumentError] If width exceeds 255 in strict mode.
     # @api public
-    # : (Integer | String | Range[Integer | String] | Array[Integer | String] index, ?width: Float | Integer | nil, ?hidden: bool, ?custom_width: bool, ?outline_level: Integer | nil) -> void
-    def column: (Integer | String | Range[Integer | String] | Array[Integer | String] index, ?width: Float | Integer | nil, ?hidden: bool, ?custom_width: bool, ?outline_level: Integer | nil) -> void
+    # : (Integer | String | Range[Integer | String] | Array[Integer | String] index, ?width: Float | Integer | nil, ?hidden: bool, ?custom_width: bool, ?outline_level: Integer | nil, ?style: (Integer | Symbol | String)?) -> void
+    def column: (Integer | String | Range[Integer | String] | Array[Integer | String] index, ?width: Float | Integer | nil, ?hidden: bool, ?custom_width: bool, ?outline_level: Integer | nil, ?style: (Integer | Symbol | String)?) -> void
 
     # Adds a chart to the worksheet.
     #
@@ -82,8 +97,8 @@ module Xlsxrb
     # @param location [String, nil] Optional internal sheet location (e.g. "Sheet2!A1").
     # @return [void]
     # @api public
-    # : (String | Integer cell, ?String? url, ?display: String?, ?tooltip: String?, ?location: String?) -> void
-    def hyperlink: (String | Integer cell, ?String? url, ?display: String?, ?tooltip: String?, ?location: String?) -> void
+    # : (String | Integer cell, ?(String | Elements::Hyperlink)? url, ?display: String?, ?tooltip: String?, ?location: String?) -> void
+    def hyperlink: (String | Integer cell, ?(String | Elements::Hyperlink)? url, ?display: String?, ?tooltip: String?, ?location: String?) -> void
 
     # Sets an auto-filter range on the sheet.
     #
@@ -178,6 +193,26 @@ module Xlsxrb
     # : (sparklines: Array[String | Hash[Symbol, untyped]], ?type: (String | Symbol)?, **untyped opts) -> void
     def sparkline_group: (sparklines: Array[String | Hash[Symbol, untyped]], ?type: (String | Symbol)?, **untyped opts) -> void
 
+    # Adds a single sparkline to the sheet.
+    #
+    # @example Add a line sparkline
+    #   sheet.add_sparkline(location: "F1", range: "A1:E1")
+    #
+    # @example Add a column sparkline with high/low markers
+    #   sheet.add_sparkline(location: "F2", range: "A2:E2", type: :column, high: true, low: true)
+    #
+    # @example Add a win/loss sparkline
+    #   sheet.add_sparkline(location: "F3", range: "A3:E3", type: :win_loss)
+    #
+    # @param location [String, nil] Target cell for the sparkline (e.g. "F1").
+    # @param range [String, nil] Data range for the sparkline (e.g. "A1:E1").
+    # @param type [Symbol, String, nil] Sparkline type (:line, :column, :win_loss / :stacked).
+    # @param opts [Hash] Additional sparkline options.
+    # @return [void]
+    # @api public
+    # : (?location: String?, ?range: String?, ?type: (String | Symbol)?, **untyped opts) -> void
+    def add_sparkline: (?location: String?, ?range: String?, ?type: (String | Symbol)?, **untyped opts) -> void
+
     # Merges a range of cells into a single cell.
     #
     # @example Merge with string range
@@ -264,6 +299,67 @@ module Xlsxrb
     # : (Symbol name, untyped value) -> void
     def print_options: (Symbol name, untyped value) -> void
 
+    # Sets or gets the print area for the worksheet.
+    #
+    # @example Set print area range
+    #   sheet.print_area("A1:H50")
+    #
+    # @example Get print area range
+    #   sheet.print_area #=> "A1:H50"
+    #
+    # @param range [String, nil] Cell range (e.g. "A1:H50").
+    # @return [String, nil]
+    # @api public
+    # : (?String? range) -> String?
+    def print_area: (?String? range) -> String?
+
+    # Sets or gets repeating print titles (rows and/or columns) for pagination.
+    #
+    # @example Set repeating header rows
+    #   sheet.print_titles(rows: "1:2")
+    #
+    # @example Get repeating print titles
+    #   sheet.print_titles #=> { rows: "1:2", cols: nil }
+    #
+    # @param rows [String, nil] Repeating row range (e.g. "1:2").
+    # @param cols [String, nil] Repeating column range (e.g. "A:B").
+    # @return [Hash, nil]
+    # @api public
+    # : (?rows: String?, ?cols: String?) -> Hash[Symbol, untyped]?
+    def print_titles: (?rows: String?, ?cols: String?) -> Hash[Symbol, untyped]?
+
+    # Sets repeating title rows to appear at the top of each printed page.
+    # Accepts 0-indexed row numbers (WriteXLSX / xlsxrb convention) or Excel range string ("1:2").
+    #
+    # @example Repeat first row
+    #   sheet.repeat_rows(0)
+    #
+    # @example Repeat rows 1 through 3
+    #   sheet.repeat_rows(0, 2)
+    #
+    # @param first [Integer, String] First row index (0-based) or range string (e.g. "1:2").
+    # @param last [Integer, String, nil] Optional last row index (0-based, defaults to first).
+    # @return [void]
+    # @api public
+    # : (Integer | String first, ?(Integer | String)? last) -> void
+    def repeat_rows: (Integer | String first, ?(Integer | String)? last) -> void
+
+    # Sets repeating title columns to appear at the left of each printed page.
+    # Accepts 0-indexed column numbers (0 => "A"), column names ("A", "B"), or range string ("A:B").
+    #
+    # @example Repeat column A
+    #   sheet.repeat_columns(0)
+    #
+    # @example Repeat columns A through C
+    #   sheet.repeat_columns("A", "C")
+    #
+    # @param first [Integer, String] First column index (0-based) or column name/range.
+    # @param last [Integer, String, nil] Optional last column index/name (defaults to first).
+    # @return [void]
+    # @api public
+    # : (Integer | String first, ?(Integer | String)? last) -> void
+    def repeat_columns: (Integer | String first, ?(Integer | String)? last) -> void
+
     # Sets sheet-level protection with optional password hashing.
     #
     # @param opts [Hash] Protection options (e.g. password: "secret", select_locked_cells: true).