xlsxrb 0.1.13 → 0.1.15

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.
       #
@@ -220,16 +232,25 @@ module Xlsxrb
 
       # Adds data validation rules to a range.
       #
+      # Adds data validation to a cell or range.
+      #
       # @example Dropdown list validation
       #   s.validate_data("B2:B100", type: "list", formula1: '"High,Medium,Low"')
       #
-      # @param range [String] The cell range (e.g. "B2:B10").
-      # @param type [String, Symbol] Validation type ("list", "whole", "decimal", "date", "time", "textLength", "custom").
+      # @example Block syntax
+      #   s.validate_data("B2:B100") do |dv|
+      #     dv.type :list
+      #     dv.formula1 '"High,Medium,Low"'
+      #   end
+      #
+      # @param range [String, nil] The cell range (e.g. "B2:B10").
+      # @param type [String, Symbol, nil] Validation type ("list", "whole", "decimal", "date", "time", "textLength", "custom").
       # @param opts [Hash] Validation options.
+      # @yield [data_validation_builder] Optional configuration block.
       # @return [void]
       # @api public
-      # : (String range, ?type: String | Symbol, **untyped opts) -> void
-      def validate_data: (String range, ?type: String | Symbol, **untyped opts) -> void
+      # : (?String? range, ?type: (String | Symbol)?, **untyped opts) ?{ (DataValidationBuilder) -> void } -> void
+      def validate_data: (?String? range, ?type: (String | Symbol)?, **untyped opts) ?{ (DataValidationBuilder) -> void } -> void
 
       # Adds conditional formatting to a range.
       #
@@ -246,19 +267,26 @@ module Xlsxrb
 
       # Adds a formatted Excel Table to the sheet.
       #
-      # @example
+      # @example Standard keyword arguments
       #   s.table("A1:C10", columns: ["ID", "Name", "Total"], name: "SalesTable", style: "TableStyleMedium9")
       #
-      # @param ref [String] The cell range for the table (e.g. "A1:D10").
-      # @param columns [Array<String>, Array<Hash>] Column names or definitions.
+      # @example Block syntax
+      #   s.table("A1:C10") do |t|
+      #     t.columns ["ID", "Name", "Total"]
+      #     t.style "TableStyleMedium9"
+      #   end
+      #
+      # @param ref [String, nil] The cell range for the table (e.g. "A1:D10").
+      # @param columns [Array<String>, Array<Hash>, nil] Column names or definitions.
       # @param name [String, nil] Table name.
       # @param display_name [String, nil] Display name.
       # @param style [String, nil] Table style name.
       # @param opts [Hash] Additional options.
+      # @yield [table_builder] Optional configuration block.
       # @return [void]
       # @api public
-      # : (String ref, columns: untyped, ?name: String?, ?display_name: String?, ?style: String?, **untyped opts) -> void
-      def table: (String ref, columns: untyped, ?name: String?, ?display_name: String?, ?style: String?, **untyped opts) -> void
+      # : (?String? ref, ?columns: untyped, ?name: String?, ?display_name: String?, ?style: String?, **untyped opts) ?{ (TableBuilder) -> void } -> void
+      def table: (?String? ref, ?columns: untyped, ?name: String?, ?display_name: String?, ?style: String?, **untyped opts) ?{ (TableBuilder) -> void } -> void
 
       # simplecov:disable
       # Edge case / untested delegation block
@@ -307,6 +335,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 +425,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.
@@ -525,6 +591,16 @@ module Xlsxrb
       # : (Symbol | String name, untyped value) -> void
       def sheet_view: (Symbol | String name, untyped value) -> void
 
+      # Configures sheet format properties (e.g. default_row_height, default_col_width).
+      #
+      # @param name [Symbol, String, Hash, nil] Property name or hash of properties.
+      # @param value [Object, nil] Property value when name is provided.
+      # @param opts [Hash] Keyword arguments for sheet format properties.
+      # @return [Hash[Symbol, untyped]]
+      # @api public
+      # : (?Symbol | String | Hash[Symbol, untyped] | nil name, ?untyped value, **untyped opts) -> Hash[Symbol, untyped]
+      def sheet_format: (?Symbol | String | Hash[Symbol, untyped] | nil name, ?untyped value, **untyped opts) -> Hash[Symbol, untyped]
+
       # simplecov:disable
       # Edge case / untested delegation block
       # Adds a horizontal page break after the given row index.
@@ -544,6 +620,29 @@ module Xlsxrb
       # @api public
       # : (Integer col_index) -> void
       def page_break_col: (Integer col_index) -> void
+
+      # Adds a protected range to the sheet.
+      #
+      # @param name [String] Name of the protected range.
+      # @param sqref [String] Cell range (e.g. "A1:B10").
+      # @param password [String, nil] Optional password or hash.
+      # @param opts [Hash] Additional options.
+      # @return [void]
+      # @api public
+      # : (String name, String sqref, ?password: String?, **untyped opts) -> void
+      def protected_range: (String name, String sqref, ?password: String?, **untyped opts) -> void
+
+      alias add_protected_range protected_range
+
+      # Adds a cell watch to the sheet.
+      #
+      # @param ref [String] Cell reference (e.g. "A1").
+      # @return [void]
+      # @api public
+      # : (String ref) -> void
+      def cell_watch: (String ref) -> void
+
+      alias add_cell_watch cell_watch
     end
 
     # Adds a new sheet to the workbook and starts streaming rows into it.
@@ -573,22 +672,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 +718,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.
     #
@@ -641,12 +750,13 @@ module Xlsxrb
 
     # Adds a data validation rule.
     #
-    # @param sqref [String] Cell range.
+    # @param sqref [String, nil] Cell range.
     # @param opts [Hash] Validation options.
+    # @yield [data_validation_builder] Optional configuration block.
     # @return [void]
     # @api public
-    # : (untyped sqref, **untyped opts) -> void
-    def validate_data: (untyped sqref, **untyped opts) -> void
+    # : (?String? sqref, **untyped opts) ?{ (DataValidationBuilder) -> void } -> void
+    def validate_data: (?String? sqref, **untyped opts) ?{ (DataValidationBuilder) -> void } -> void
 
     # Adds a conditional formatting rule.
     #
@@ -659,16 +769,17 @@ module Xlsxrb
 
     # Adds an Excel Table (ListObject).
     #
-    # @param ref [String] Table range.
-    # @param columns [Array<String>] Column names.
+    # @param ref [String, nil] Table range.
+    # @param columns [Array<String>, nil] Column names.
     # @param name [String, nil] Table name.
     # @param display_name [String, nil] Display name.
     # @param style [String, nil] Table style.
     # @param opts [Hash] Additional options.
+    # @yield [table_builder] Optional configuration block.
     # @return [void]
     # @api public
-    # : (untyped ref, columns: untyped, ?name: untyped, ?display_name: untyped, ?style: untyped, **untyped opts) -> void
-    def table: (untyped ref, columns: untyped, ?name: untyped, ?display_name: untyped, ?style: untyped, **untyped opts) -> void
+    # : (?String? ref, ?columns: untyped, ?name: untyped, ?display_name: untyped, ?style: untyped, **untyped opts) ?{ (TableBuilder) -> void } -> void
+    def table: (?String? ref, ?columns: untyped, ?name: untyped, ?display_name: untyped, ?style: untyped, **untyped opts) ?{ (TableBuilder) -> void } -> void
 
     # Adds a Pivot Table.
     #
@@ -706,6 +817,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.
@@ -840,6 +971,16 @@ module Xlsxrb
     # : (Symbol name, untyped value) -> void
     def sheet_view: (Symbol name, untyped value) -> void
 
+    # Configures sheet format properties (e.g. default_row_height, default_col_width).
+    #
+    # @param name [Symbol, String, Hash, nil] Property name or hash of properties.
+    # @param value [Object, nil] Property value when name is provided.
+    # @param opts [Hash] Keyword arguments for sheet format properties.
+    # @return [Hash[Symbol, untyped]]
+    # @api public
+    # : (?Symbol | String | Hash[Symbol, untyped] | nil name, ?untyped value, **untyped opts) -> Hash[Symbol, untyped]
+    def sheet_format: (?Symbol | String | Hash[Symbol, untyped] | nil name, ?untyped value, **untyped opts) -> Hash[Symbol, untyped]
+
     # Inserts a horizontal page break before a row.
     #
     # @param row_num [Integer] 1-based row number.
@@ -856,6 +997,29 @@ module Xlsxrb
     # : (Integer col_index) -> void
     def page_break_col: (Integer col_index) -> void
 
+    # Adds a protected range to the current sheet.
+    #
+    # @param name [String] Name of the protected range.
+    # @param sqref [String] Cell range (e.g. "A1:B10").
+    # @param password [String, nil] Optional password or hash.
+    # @param opts [Hash] Additional options.
+    # @return [void]
+    # @api public
+    # : (String name, String sqref, ?password: String?, **untyped opts) -> void
+    def protected_range: (String name, String sqref, ?password: String?, **untyped opts) -> void
+
+    alias add_protected_range protected_range
+
+    # Adds a cell watch to the current sheet.
+    #
+    # @param ref [String] Cell reference (e.g. "A1").
+    # @return [void]
+    # @api public
+    # : (String ref) -> void
+    def cell_watch: (String ref) -> void
+
+    alias add_cell_watch cell_watch
+
     # Adds a defined name.
     #
     # @param name [String] The defined name.
@@ -886,6 +1050,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,151 @@
+# 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 cell range reference string (e.g. "A1:C10", "B2:D5", "A1") to 0-based
+    # [[top_row, left_col], [bottom_row, right_col]] coordinate pairs.
+    #
+    # @example Range reference
+    #   Xlsxrb::Utils.parse_range("A1:C10") #=> [[0, 0], [9, 2]]
+    #
+    # @example Single cell reference
+    #   Xlsxrb::Utils.parse_range("B5")     #=> [[4, 1], [4, 1]]
+    #
+    # @param range_ref [String, nil] Cell range reference string.
+    # @return [Array([Integer, Integer], [Integer, Integer]), nil] 0-based coordinate pairs, or nil if invalid.
+    # @api public
+    # : (String? range_ref) -> [[Integer, Integer], [Integer, Integer]]?
+    def self.parse_range: (String? range_ref) -> [ [ Integer, Integer ], [ Integer, Integer ] ]?
+
+    # Converts 0-based bounding coordinates to an A1-style range reference string.
+    #
+    # @example Range coordinates
+    #   Xlsxrb::Utils.range_to_ref(0, 0, 9, 2) #=> "A1:C10"
+    #
+    # @example Single cell coordinates
+    #   Xlsxrb::Utils.range_to_ref(4, 1, 4, 1) #=> "B5"
+    #
+    # @param top_row [Integer] 0-based start row index.
+    # @param left_col [Integer] 0-based start column index.
+    # @param bottom_row [Integer] 0-based end row index.
+    # @param right_col [Integer] 0-based end column index.
+    # @return [String] A1-style range reference string.
+    # @api public
+    # : (Integer top_row, Integer left_col, Integer bottom_row, Integer right_col) -> String
+    def self.range_to_ref: (Integer top_row, Integer left_col, Integer bottom_row, Integer right_col) -> 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