xlsxrb 0.1.11 → 0.1.13

data/sig/generated/xlsxrb/chart_builder.rbs

@@ -62,8 +62,8 @@ module Xlsxrb
     # @param kwargs [Hash] Keyword arguments for legend styling/layout.
     # @return [Object] The configured legend property.
     # @api public
-    # : (*(Hash[Symbol, String | Integer | bool | nil] | String) args, **String | Integer | bool | nil kwargs) -> (Hash[Symbol, String | Integer | bool | nil] | String)
-    def legend: (*Hash[Symbol, String | Integer | bool | nil] | String args, **String | Integer | bool | nil kwargs) -> (Hash[Symbol, String | Integer | bool | nil] | String)
+    # : (*(Hash[Symbol, String | Numeric | bool | nil] | String) args, **String | Numeric | bool | nil kwargs) -> (Hash[Symbol, String | Numeric | bool | nil] | String)
+    def legend: (*Hash[Symbol, String | Numeric | bool | nil] | String args, **String | Numeric | bool | nil kwargs) -> (Hash[Symbol, String | Numeric | bool | nil] | String)
 
     # Configures the plot_area property for this chart.
     #
@@ -71,8 +71,8 @@ module Xlsxrb
     # @param kwargs [Hash] Keyword arguments for plot area configuration.
     # @return [Object] The configured plot_area property.
     # @api public
-    # : (*(Hash[Symbol, String | Integer | bool | nil] | String) args, **String | Integer | bool | nil kwargs) -> (Hash[Symbol, String | Integer | bool | nil] | String)
-    def plot_area: (*Hash[Symbol, String | Integer | bool | nil] | String args, **String | Integer | bool | nil kwargs) -> (Hash[Symbol, String | Integer | bool | nil] | String)
+    # : (*(Hash[Symbol, String | Numeric | bool | nil] | String) args, **String | Numeric | bool | nil kwargs) -> (Hash[Symbol, String | Numeric | bool | nil] | String)
+    def plot_area: (*Hash[Symbol, String | Numeric | bool | nil] | String args, **String | Numeric | bool | nil kwargs) -> (Hash[Symbol, String | Numeric | bool | nil] | String)
 
     # Configures the chart_space property for this chart.
     #
@@ -80,8 +80,8 @@ module Xlsxrb
     # @param kwargs [Hash] Keyword arguments.
     # @return [Object] The configured chart_space property.
     # @api public
-    # : (*(Hash[Symbol, String | Integer | bool | nil] | String) args, **String | Integer | bool | nil kwargs) -> (Hash[Symbol, String | Integer | bool | nil] | String)
-    def chart_space: (*Hash[Symbol, String | Integer | bool | nil] | String args, **String | Integer | bool | nil kwargs) -> (Hash[Symbol, String | Integer | bool | nil] | String)
+    # : (*(Hash[Symbol, String | Numeric | bool | nil] | String) args, **String | Numeric | bool | nil kwargs) -> (Hash[Symbol, String | Numeric | bool | nil] | String)
+    def chart_space: (*Hash[Symbol, String | Numeric | bool | nil] | String args, **String | Numeric | bool | nil kwargs) -> (Hash[Symbol, String | Numeric | bool | nil] | String)
 
     # Configures the style index/id for this chart.
     #
@@ -89,8 +89,8 @@ module Xlsxrb
     # @param kwargs [Hash] Keyword arguments.
     # @return [Object] The configured style property.
     # @api public
-    # : (*(Hash[Symbol, String | Integer | bool | nil] | String | Integer) args, **String | Integer | bool | nil kwargs) -> (Hash[Symbol, String | Integer | bool | nil] | String | Integer)
-    def style: (*Hash[Symbol, String | Integer | bool | nil] | String | Integer args, **String | Integer | bool | nil kwargs) -> (Hash[Symbol, String | Integer | bool | nil] | String | Integer)
+    # : (*(Hash[Symbol, String | Numeric | bool | nil] | String | Integer) args, **String | Numeric | bool | nil kwargs) -> (Hash[Symbol, String | Numeric | bool | nil] | String | Integer)
+    def style: (*Hash[Symbol, String | Numeric | bool | nil] | String | Integer args, **String | Numeric | bool | nil kwargs) -> (Hash[Symbol, String | Numeric | bool | nil] | String | Integer)
 
     # Configures data labels for this chart.
     #
@@ -98,8 +98,8 @@ module Xlsxrb
     # @param kwargs [Hash] Keyword arguments.
     # @return [Object] The configured data_labels property.
     # @api public
-    # : (*(Hash[Symbol, String | Integer | bool | nil] | String) args, **String | Integer | bool | nil kwargs) -> (Hash[Symbol, String | Integer | bool | nil] | String)
-    def data_labels: (*Hash[Symbol, String | Integer | bool | nil] | String args, **String | Integer | bool | nil kwargs) -> (Hash[Symbol, String | Integer | bool | nil] | String)
+    # : (*(Hash[Symbol, String | Numeric | bool | nil] | String) args, **String | Numeric | bool | nil kwargs) -> (Hash[Symbol, String | Numeric | bool | nil] | String)
+    def data_labels: (*Hash[Symbol, String | Numeric | bool | nil] | String args, **String | Numeric | bool | nil kwargs) -> (Hash[Symbol, String | Numeric | bool | nil] | String)
 
     # Configures whether to plot visible cells only.
     #
@@ -107,8 +107,8 @@ module Xlsxrb
     # @param kwargs [Hash] Keyword arguments.
     # @return [Boolean, String]
     # @api public
-    # : (*(bool | String) args, **String | Integer | bool | nil kwargs) -> (bool | String)
-    def plot_visible_only: (*bool | String args, **String | Integer | bool | nil kwargs) -> (bool | String)
+    # : (*(bool | String) args, **String | Numeric | bool | nil kwargs) -> (bool | String)
+    def plot_visible_only: (*bool | String args, **String | Numeric | bool | nil kwargs) -> (bool | String)
 
     # Configures how blank cells are displayed in the chart.
     #
@@ -116,8 +116,8 @@ module Xlsxrb
     # @param kwargs [Hash] Keyword arguments.
     # @return [String]
     # @api public
-    # : (*(String) args, **String | Integer | bool | nil kwargs) -> String
-    def display_blanks_as: (*String args, **String | Integer | bool | nil kwargs) -> String
+    # : (*(String) args, **String | Numeric | bool | nil kwargs) -> String
+    def display_blanks_as: (*String args, **String | Numeric | bool | nil kwargs) -> String
 
     # Configures 3D view properties for 3D charts.
     #
@@ -125,8 +125,8 @@ module Xlsxrb
     # @param kwargs [Hash] Keyword arguments.
     # @return [Object]
     # @api public
-    # : (*(Hash[Symbol, String | Integer | bool | nil] | String) args, **String | Integer | bool | nil kwargs) -> (Hash[Symbol, String | Integer | bool | nil] | String)
-    def view3d: (*Hash[Symbol, String | Integer | bool | nil] | String args, **String | Integer | bool | nil kwargs) -> (Hash[Symbol, String | Integer | bool | nil] | String)
+    # : (*(Hash[Symbol, String | Numeric | bool | nil] | String) args, **String | Numeric | bool | nil kwargs) -> (Hash[Symbol, String | Numeric | bool | nil] | String)
+    def view3d: (*Hash[Symbol, String | Numeric | bool | nil] | String args, **String | Numeric | bool | nil kwargs) -> (Hash[Symbol, String | Numeric | bool | nil] | String)
 
     # Configures the category axis properties for this chart.
     #
@@ -134,8 +134,8 @@ module Xlsxrb
     # @param kwargs [Hash] Keyword arguments.
     # @return [Object]
     # @api public
-    # : (*(Hash[Symbol, String | Integer | bool | nil] | String) args, **String | Integer | bool | nil kwargs) -> (Hash[Symbol, String | Integer | bool | nil] | String)
-    def category_axis: (*Hash[Symbol, String | Integer | bool | nil] | String args, **String | Integer | bool | nil kwargs) -> (Hash[Symbol, String | Integer | bool | nil] | String)
+    # : (*(Hash[Symbol, String | Numeric | bool | nil] | String) args, **String | Numeric | bool | nil kwargs) -> (Hash[Symbol, String | Numeric | bool | nil] | String)
+    def category_axis: (*Hash[Symbol, String | Numeric | bool | nil] | String args, **String | Numeric | bool | nil kwargs) -> (Hash[Symbol, String | Numeric | bool | nil] | String)
 
     # Configures the value axis properties for this chart.
     #
@@ -143,8 +143,8 @@ module Xlsxrb
     # @param kwargs [Hash] Keyword arguments.
     # @return [Object]
     # @api public
-    # : (*(Hash[Symbol, String | Integer | bool | nil] | String) args, **String | Integer | bool | nil kwargs) -> (Hash[Symbol, String | Integer | bool | nil] | String)
-    def value_axis: (*Hash[Symbol, String | Integer | bool | nil] | String args, **String | Integer | bool | nil kwargs) -> (Hash[Symbol, String | Integer | bool | nil] | String)
+    # : (*(Hash[Symbol, String | Numeric | bool | nil] | String) args, **String | Numeric | bool | nil kwargs) -> (Hash[Symbol, String | Numeric | bool | nil] | String)
+    def value_axis: (*Hash[Symbol, String | Numeric | bool | nil] | String args, **String | Numeric | bool | nil kwargs) -> (Hash[Symbol, String | Numeric | bool | nil] | String)
 
     # Configures whether to show the legend key in data labels.
     #
@@ -152,8 +152,8 @@ module Xlsxrb
     # @param kwargs [Hash] Keyword arguments.
     # @return [Boolean, String]
     # @api public
-    # : (*(bool | String) args, **String | Integer | bool | nil kwargs) -> (bool | String)
-    def show_legend_key: (*bool | String args, **String | Integer | bool | nil kwargs) -> (bool | String)
+    # : (*(bool | String) args, **String | Numeric | bool | nil kwargs) -> (bool | String)
+    def show_legend_key: (*bool | String args, **String | Numeric | bool | nil kwargs) -> (bool | String)
 
     # Builder for a single series entry in block-style chart definitions.
     #
@@ -208,8 +208,8 @@ module Xlsxrb
       # @param kwargs [Hash] Keyword arguments.
       # @return [Object]
       # @api public
-      # : (*(Hash[Symbol, String | Integer | bool | nil] | String) args, **String | Integer | bool | nil kwargs) -> (Hash[Symbol, String | Integer | bool | nil] | String)
-      def fill: (*Hash[Symbol, String | Integer | bool | nil] | String args, **String | Integer | bool | nil kwargs) -> (Hash[Symbol, String | Integer | bool | nil] | String)
+      # : (*(Hash[Symbol, String | Numeric | bool | nil] | String) args, **String | Numeric | bool | nil kwargs) -> (Hash[Symbol, String | Numeric | bool | nil] | String)
+      def fill: (*Hash[Symbol, String | Numeric | bool | nil] | String args, **String | Numeric | bool | nil kwargs) -> (Hash[Symbol, String | Numeric | bool | nil] | String)
 
       # Configures line color/thickness for this series.
       #
@@ -217,8 +217,8 @@ module Xlsxrb
       # @param kwargs [Hash] Keyword arguments.
       # @return [Object]
       # @api public
-      # : (*(Hash[Symbol, String | Integer | bool | nil] | String) args, **String | Integer | bool | nil kwargs) -> (Hash[Symbol, String | Integer | bool | nil] | String)
-      def line: (*Hash[Symbol, String | Integer | bool | nil] | String args, **String | Integer | bool | nil kwargs) -> (Hash[Symbol, String | Integer | bool | nil] | String)
+      # : (*(Hash[Symbol, String | Numeric | bool | nil] | String) args, **String | Numeric | bool | nil kwargs) -> (Hash[Symbol, String | Numeric | bool | nil] | String)
+      def line: (*Hash[Symbol, String | Numeric | bool | nil] | String args, **String | Numeric | bool | nil kwargs) -> (Hash[Symbol, String | Numeric | bool | nil] | String)
 
       # Configures trendline for this series.
       #
@@ -226,8 +226,8 @@ module Xlsxrb
       # @param kwargs [Hash] Keyword arguments.
       # @return [Object]
       # @api public
-      # : (*(Hash[Symbol, String | Integer | bool | nil] | String) args, **String | Integer | bool | nil kwargs) -> (Hash[Symbol, String | Integer | bool | nil] | String)
-      def trendline: (*Hash[Symbol, String | Integer | bool | nil] | String args, **String | Integer | bool | nil kwargs) -> (Hash[Symbol, String | Integer | bool | nil] | String)
+      # : (*(Hash[Symbol, String | Numeric | bool | nil] | String) args, **String | Numeric | bool | nil kwargs) -> (Hash[Symbol, String | Numeric | bool | nil] | String)
+      def trendline: (*Hash[Symbol, String | Numeric | bool | nil] | String args, **String | Numeric | bool | nil kwargs) -> (Hash[Symbol, String | Numeric | bool | nil] | String)
 
       # Configures data labels for this series.
       #
@@ -235,8 +235,8 @@ module Xlsxrb
       # @param kwargs [Hash] Keyword arguments.
       # @return [Object]
       # @api public
-      # : (*(Hash[Symbol, String | Integer | bool | nil] | String) args, **String | Integer | bool | nil kwargs) -> (Hash[Symbol, String | Integer | bool | nil] | String)
-      def data_labels: (*Hash[Symbol, String | Integer | bool | nil] | String args, **String | Integer | bool | nil kwargs) -> (Hash[Symbol, String | Integer | bool | nil] | String)
+      # : (*(Hash[Symbol, String | Numeric | bool | nil] | String) args, **String | Numeric | bool | nil kwargs) -> (Hash[Symbol, String | Numeric | bool | nil] | String)
+      def data_labels: (*Hash[Symbol, String | Numeric | bool | nil] | String args, **String | Numeric | bool | nil kwargs) -> (Hash[Symbol, String | Numeric | bool | nil] | String)
 
       # Configures line smoothing for this series.
       #
@@ -244,8 +244,8 @@ module Xlsxrb
       # @param kwargs [Hash] Keyword arguments.
       # @return [Boolean, String]
       # @api public
-      # : (*(bool | String) args, **String | Integer | bool | nil kwargs) -> (bool | String)
-      def smooth: (*bool | String args, **String | Integer | bool | nil kwargs) -> (bool | String)
+      # : (*(bool | String) args, **String | Numeric | bool | nil kwargs) -> (bool | String)
+      def smooth: (*bool | String args, **String | Numeric | bool | nil kwargs) -> (bool | String)
 
       # Configures 3D bar/column shape (e.g. "cylinder", "cone", "pyramid").
       #
@@ -253,8 +253,8 @@ module Xlsxrb
       # @param kwargs [Hash] Keyword arguments.
       # @return [String]
       # @api public
-      # : (*(String) args, **String | Integer | bool | nil kwargs) -> String
-      def shape: (*String args, **String | Integer | bool | nil kwargs) -> String
+      # : (*(String) args, **String | Numeric | bool | nil kwargs) -> String
+      def shape: (*String args, **String | Numeric | bool | nil kwargs) -> String
 
       # Configures individual series chart type override in combo charts.
       #
@@ -262,8 +262,8 @@ module Xlsxrb
       # @param kwargs [Hash] Keyword arguments.
       # @return [String]
       # @api public
-      # : (*(String) args, **String | Integer | bool | nil kwargs) -> String
-      def type: (*String args, **String | Integer | bool | nil kwargs) -> String
+      # : (*(String) args, **String | Numeric | bool | nil kwargs) -> String
+      def type: (*String args, **String | Numeric | bool | nil kwargs) -> String
     end
   end
 end

data/sig/generated/xlsxrb/dsl_helpers.rbs

@@ -0,0 +1,92 @@
+# Generated from lib/xlsxrb/dsl_helpers.rb with RBS::Inline
+
+module Xlsxrb
+  # Internal helper module for normalizing and validating DSL arguments
+  # shared between {WorksheetBuilder} (in-memory) and {StreamWriter} (streaming).
+  #
+  # @api private
+  module DslHelpers
+    # Normalizes merge cell range string or coordinate components into a canonical range reference (e.g. "A1:C3").
+    #
+    # @param range [String, Hash, nil]
+    # @param row [Integer, nil]
+    # @param col_start [Integer, String, nil]
+    # @param col_end [Integer, String, nil]
+    # @param row_start [Integer, nil]
+    # @param row_end [Integer, nil]
+    # @param strict_excel_mode [Boolean]
+    # @return [String]
+    # : (untyped range, ?row: Integer?, ?col_start: (Integer | String)?, ?col_end: (Integer | String)?, ?row_start: Integer?, ?row_end: Integer?, ?strict_excel_mode: bool) -> String
+    def self.normalize_merge_range: (untyped range, ?row: Integer?, ?col_start: (Integer | String)?, ?col_end: (Integer | String)?, ?row_start: Integer?, ?row_end: Integer?, ?strict_excel_mode: bool) -> String
+
+    # Normalizes sheet protection options and hashes plain-text password if supplied.
+    #
+    # @param opts [Hash]
+    # @return [Hash]
+    # : (Hash[Symbol, untyped] opts) -> Hash[Symbol, untyped]
+    def self.normalize_protection_options: (Hash[Symbol, untyped] opts) -> Hash[Symbol, untyped]
+
+    # Normalizes column index or letter or Range to an array of 0-based column integers.
+    #
+    # @param index [Integer, String, Symbol, Range, Array]
+    # @return [Array<Integer>]
+    # : (untyped index) -> Array[Integer]
+    def self.normalize_column_indices: (untyped index) -> Array[Integer]
+
+    # Normalizes page margins into a compact hash.
+    #
+    # @param left [Float, nil]
+    # @param right [Float, nil]
+    # @param top [Float, nil]
+    # @param bottom [Float, nil]
+    # @param header [Float, nil]
+    # @param footer [Float, nil]
+    # @return [Hash{Symbol => Float}]
+    # : (?left: Float?, ?right: Float?, ?top: Float?, ?bottom: Float?, ?header: Float?, ?footer: Float?) -> Hash[Symbol, Float]
+    def self.normalize_page_margins: (?left: Float?, ?right: Float?, ?top: Float?, ?bottom: Float?, ?header: Float?, ?footer: Float?) -> Hash[Symbol, Float]
+
+    # Normalizes table options hash.
+    #
+    # @param ref [String]
+    # @param columns [Array<String>, Array<Hash>]
+    # @param name [String, nil]
+    # @param display_name [String, nil]
+    # @param style [String, nil]
+    # @param opts [Hash]
+    # @return [Hash]
+    # : (String ref, columns: untyped, ?name: String?, ?display_name: String?, ?style: String?, **untyped opts) -> Hash[Symbol, untyped]
+    def self.normalize_table_options: (String ref, columns: untyped, ?name: String?, ?display_name: String?, ?style: String?, **untyped opts) -> Hash[Symbol, untyped]
+
+    # Converts a cell range (e.g. "A1:B2" or "A1") to an absolute reference format (e.g. "$A$1:$B$2" or "$A$1").
+    #
+    # @param range [String]
+    # @return [String]
+    # : (String range) -> String
+    def self.absolute_range: (String range) -> String
+
+    # Normalizes row values: if given a column-keyed Hash, converts to a sparse Array.
+    # If already an Array or other non-Hash enumerable, returns as-is without allocations.
+    #
+    # @param values [Array<Object>, Hash{String, Integer, Symbol => Object}, nil]
+    # @return [Array<Object>, nil]
+    # : (untyped values) -> untyped
+    def self.normalize_row_values: (untyped values) -> untyped
+
+    # Normalizes row styles: if given a Hash of column-keyed styles (including Ranges/Arrays),
+    # expands to a sparse Array of styles. If already an Array or nil, returns as-is without allocations.
+    #
+    # @param styles [untyped]
+    # @return [untyped]
+    # : (untyped styles) -> untyped
+    def self.normalize_row_styles: (untyped styles) -> untyped
+
+    # Validates row index and height against Excel limits in strict mode.
+    #
+    # @param row_index [Integer]
+    # @param height [Float, Integer, nil]
+    # @param strict_excel_mode [Boolean]
+    # @return [void]
+    # : (Integer row_index, Float | Integer | nil height, ?strict_excel_mode: bool) -> void
+    def self.validate_row_bounds!: (Integer row_index, Float | Integer | nil height, ?strict_excel_mode: bool) -> void
+  end
+end

data/sig/generated/xlsxrb/elements/cell.rbs

@@ -115,6 +115,13 @@ module Xlsxrb
       # : () -> Time?
       def to_time: () -> Time?
 
+      # Pure calculation: converts a 0-based column index to an Excel letter.
+      #
+      # @param index [Integer] 0-based column index.
+      # @return [String] Excel column letter.
+      # : (Integer index) -> String
+      def self.calculate_column_letter: (Integer index) -> String
+
       # Converts a 0-based column index to an Excel letter (0 -> "A", 25 -> "Z", 26 -> "AA").
       #
       # @example
@@ -127,6 +134,13 @@ module Xlsxrb
       # : (untyped index) -> String
       def self.column_letter: (untyped index) -> String
 
+      # Pure calculation: converts an uppercase column letter string to a 0-based index.
+      #
+      # @param letter [String] Uppercase column letter string (e.g. "A", "AA").
+      # @return [Integer] 0-based column index.
+      # : (String letter) -> Integer
+      def self.calculate_column_index: (String letter) -> Integer
+
       # Converts a column letter (e.g. "A", :AA) to a 0-based column index.
       #
       # @example
@@ -151,6 +165,21 @@ module Xlsxrb
       # : (String? ref) -> [Integer, Integer]?
       def self.parse_ref: (String? ref) -> [ Integer, Integer ]?
 
+      # Returns whether the coordinates are within OOXML limits (row: 0..1,048,575, col: 0..16,383).
+      #
+      # @param row_index [Integer] 0-based row index.
+      # @param column_index [Integer] 0-based column index.
+      # @return [Boolean]
+      # : (untyped row_index, untyped column_index) -> bool
+      def self.valid_coordinates?: (untyped row_index, untyped column_index) -> bool
+
+      # Returns whether the value type is supported by OOXML specifications.
+      #
+      # @param value [Object]
+      # @return [Boolean]
+      # : (untyped value) -> bool
+      def self.valid_value?: (untyped value) -> bool
+
       # Validates cell coordinates and value type against OOXML specifications.
       #
       # @param row_index [Integer]

data/sig/generated/xlsxrb/elements/column.rbs

@@ -9,27 +9,38 @@ module Xlsxrb
     #   col = Elements::Column.new(index: 0, width: 25.0)
     #
     # @api public
-    class Column < Data
-      attr_reader index(): untyped
-
-      attr_reader width(): untyped
-
-      attr_reader hidden(): untyped
-
-      attr_reader custom_width(): untyped
-
-      attr_reader outline_level(): untyped
-
-      attr_reader unmapped_data(): untyped
-
-      attr_reader errors(): untyped
-
-      def self.new: (untyped index, untyped width, untyped hidden, untyped custom_width, untyped outline_level, untyped unmapped_data, untyped errors) -> instance
-                  | (index: untyped, width: untyped, hidden: untyped, custom_width: untyped, outline_level: untyped, unmapped_data: untyped, errors: untyped) -> instance
-
-      def self.members: () -> [ :index, :width, :hidden, :custom_width, :outline_level, :unmapped_data, :errors ]
-
-      def members: () -> [ :index, :width, :hidden, :custom_width, :outline_level, :unmapped_data, :errors ]
+    # rubocop:disable Style/DataInheritance -- Required as class syntax for mutant subject matcher
+    class Column
+      # rubocop:enable Style/DataInheritance
+      # @param index [Integer] 0-based column index.
+      # @param width [Float, Integer, nil] Column width in characters.
+      # @param hidden [Boolean] Whether the column is hidden.
+      # @param custom_width [Boolean] Whether custom width flag is set.
+      # @param outline_level [Integer, nil] Grouping/outline level.
+      # @param unmapped_data [Hash] Additional metadata.
+      # @param errors [Array<String>, nil] Validation errors.
+      # : (index: Integer, ?width: Float | Integer | nil, ?hidden: bool, ?custom_width: bool, ?outline_level: Integer | nil, ?unmapped_data: Hash[untyped, untyped], ?errors: Array[String]?) -> void
+      def initialize: (index: Integer, ?width: Float | Integer | nil, ?hidden: bool, ?custom_width: bool, ?outline_level: Integer | nil, ?unmapped_data: Hash[untyped, untyped], ?errors: Array[String]?) -> void
+
+      # Returns whether the column definition is valid according to OOXML specifications.
+      #
+      # @return [Boolean]
+      # : () -> bool
+      def valid?: () -> bool
+
+      # Returns whether the column index is within valid OOXML range (0..16383).
+      #
+      # @param index [Object]
+      # @return [Boolean]
+      # : (untyped index) -> bool
+      def self.valid_index?: (untyped index) -> bool
+
+      # Validates column index against OOXML limits.
+      #
+      # @param index [Integer]
+      # @return [Array<String>] List of errors.
+      # : (untyped index) -> Array[String]
+      def self.validate: (untyped index) -> Array[String]
     end
   end
 end

data/sig/generated/xlsxrb/elements/row.rbs

@@ -11,29 +11,109 @@ module Xlsxrb
     #   row.to_a            # array of cell values
     #
     # @api public
-    class Row < Data
-      attr_reader index(): untyped
+    # rubocop:disable Style/DataInheritance -- Required as class syntax for mutant subject matcher
+    class Row
+      # @param index [Integer] 0-based row index.
+      # @param cells [Array<Elements::Cell>] Cells in this row.
+      # @param height [Float, Integer, nil] Row height in points.
+      # @param hidden [Boolean] Whether the row is hidden.
+      # @param custom_height [Boolean] Whether custom height is set.
+      # @param outline_level [Integer, nil] Grouping/outline level.
+      # @param unmapped_data [Hash] Additional metadata.
+      # @param errors [Array<String>, nil] Validation errors.
+      # : (index: Integer, ?cells: Array[Elements::Cell], ?height: Float | Integer | nil, ?hidden: bool, ?custom_height: bool, ?outline_level: Integer | nil, ?unmapped_data: Hash[untyped, untyped], ?errors: Array[String]?) -> void
+      def initialize: (index: Integer, ?cells: Array[Elements::Cell], ?height: Float | Integer | nil, ?hidden: bool, ?custom_height: bool, ?outline_level: Integer | nil, ?unmapped_data: Hash[untyped, untyped], ?errors: Array[String]?) -> void
 
-      attr_reader cells(): untyped
+      # Access a cell by 0-based column index, or access row attributes via Symbol.
+      #
+      # @example
+      #   row[0]          #=> Cell at column 0
+      #   row[:height]    #=> 25.0
+      #   row[:cells]     #=> [Cell, Cell, ...]
+      #
+      # @param col_index [Integer, Symbol] Column index or attribute symbol.
+      # @return [Elements::Cell, Object, nil]
+      # @api public
+      # : (Integer | Symbol col_index) -> untyped
+      def []: (Integer | Symbol col_index) -> untyped
 
-      attr_reader height(): untyped
+      # Iterate over cells in this row.
+      #
+      # @example
+      #   row.each do |cell|
+      #     puts cell.value
+      #   end
+      #
+      # @yield [cell]
+      # @yieldparam cell [Elements::Cell]
+      # @return [Enumerator, void]
+      # @api public
+      # : () { (Elements::Cell) -> void } -> void
+      # : () -> Enumerator[Elements::Cell, void]
+      def each: () { (Elements::Cell) -> void } -> void
+              | () -> Enumerator[Elements::Cell, void]
 
-      attr_reader hidden(): untyped
+      # Iterate over cells in this row.
+      #
+      # @example
+      #   row.each_cell do |cell|
+      #     puts "#{cell.ref}: #{cell.value}"
+      #   end
+      #
+      # @yield [cell]
+      # @yieldparam cell [Elements::Cell]
+      # @return [Enumerator, void]
+      # @api public
+      # : () { (Elements::Cell) -> void } -> void
+      # : () -> Enumerator[Elements::Cell, void]
+      def each_cell: () { (Elements::Cell) -> void } -> void
+                   | () -> Enumerator[Elements::Cell, void]
 
-      attr_reader custom_height(): untyped
+      # Convert row cells to an Array of raw values.
+      #
+      # @example
+      #   row.to_a #=> ["ID", "Name", "Total"]
+      #
+      # @return [Array<Object>]
+      # @api public
+      # : () -> Array[untyped]
+      def to_a: () -> Array[untyped]
 
-      attr_reader outline_level(): untyped
+      # Returns whether the row is valid according to OOXML specifications.
+      #
+      # @return [Boolean]
+      # : () -> bool
+      def valid?: () -> bool
 
-      attr_reader unmapped_data(): untyped
+      # Returns the cell at the given 0-based column index, or nil.
+      #
+      # @param column_index [Integer] 0-based column index.
+      # @return [Elements::Cell, nil]
+      # @api public
+      # : (Integer column_index) -> Elements::Cell?
+      def cell_at: (Integer column_index) -> Elements::Cell?
 
-      attr_reader errors(): untyped
+      # Returns cell values as an Array (sparse columns get nil).
+      #
+      # @return [Array<Object>]
+      # @api public
+      # : () -> Array[untyped]
+      def values: () -> Array[untyped]
 
-      def self.new: (untyped index, untyped cells, untyped height, untyped hidden, untyped custom_height, untyped outline_level, untyped unmapped_data, untyped errors) -> instance
-                  | (index: untyped, cells: untyped, height: untyped, hidden: untyped, custom_height: untyped, outline_level: untyped, unmapped_data: untyped, errors: untyped) -> instance
+      # Returns whether the row index is within valid OOXML range (0..1048575).
+      #
+      # @param index [Object]
+      # @return [Boolean]
+      # : (untyped index) -> bool
+      def self.valid_index?: (untyped index) -> bool
 
-      def self.members: () -> [ :index, :cells, :height, :hidden, :custom_height, :outline_level, :unmapped_data, :errors ]
-
-      def members: () -> [ :index, :cells, :height, :hidden, :custom_height, :outline_level, :unmapped_data, :errors ]
+      # Validates row index and cells against OOXML limits.
+      #
+      # @param index [Integer]
+      # @param cells [Array<Elements::Cell>]
+      # @return [Array<String>] List of errors.
+      # : (untyped index, untyped cells) -> Array[String]
+      def self.validate: (untyped index, untyped cells) -> Array[String]
     end
   end
 end

data/sig/generated/xlsxrb/elements/workbook.rbs

@@ -10,23 +10,115 @@ module Xlsxrb
     #   workbook.each { |s| puts s.name }
     #
     # @api public
-    class Workbook < Data
-      attr_reader sheets(): untyped
+    # rubocop:disable Style/DataInheritance -- Required as class syntax for mutant subject matcher
+    class Workbook
+      # @param sheets [Array<Elements::Worksheet, StreamSheet>] Worksheets in the workbook.
+      # @param shared_strings [Array<String>] Shared strings table.
+      # @param styles [Hash] Styles definition.
+      # @param unmapped_data [Hash] Additional metadata for round-tripping.
+      # @param errors [Array<String>, nil] Validation errors.
+      # : (?sheets: Array[Elements::Worksheet | StreamSheet], ?shared_strings: Array[String], ?styles: Hash[untyped, untyped], ?unmapped_data: Hash[untyped, untyped], ?errors: Array[String]?) -> void
+      def initialize: (?sheets: Array[Elements::Worksheet | StreamSheet], ?shared_strings: Array[String], ?styles: Hash[untyped, untyped], ?unmapped_data: Hash[untyped, untyped], ?errors: Array[String]?) -> void
 
-      attr_reader shared_strings(): untyped
+      # Iterate over worksheets.
+      #
+      # @example
+      #   workbook.each do |sheet|
+      #     puts sheet.name
+      #   end
+      #
+      # @yield [sheet]
+      # @yieldparam sheet [Elements::Worksheet, StreamSheet]
+      # @return [Enumerator, void]
+      # : () { (Elements::Worksheet | StreamSheet) -> void } -> void
+      # : () -> Enumerator[Elements::Worksheet | StreamSheet, void]
+      def each: () { (Elements::Worksheet | StreamSheet) -> void } -> void
+              | () -> Enumerator[Elements::Worksheet | StreamSheet, void]
 
-      attr_reader styles(): untyped
+      alias each_sheet each
 
-      attr_reader unmapped_data(): untyped
+      # Returns whether the workbook is valid according to ECMA-376 rules.
+      #
+      # @return [Boolean]
+      # : () -> bool
+      def valid?: () -> bool
 
-      attr_reader errors(): untyped
+      # Returns the worksheet at the given 0-based index or by name.
+      #
+      # @example
+      #   wb.sheet(0)
+      #   wb.sheet("Sales")
+      #
+      # @param identifier [Integer, String, untyped] 0-based index or sheet name.
+      # @return [Elements::Worksheet, StreamSheet, nil]
+      # @api public
+      # : (?Integer | String | untyped identifier) -> (Elements::Worksheet | StreamSheet)?
+      def sheet: (?Integer | String | untyped identifier) -> (Elements::Worksheet | StreamSheet)?
 
-      def self.new: (untyped sheets, untyped shared_strings, untyped styles, untyped unmapped_data, untyped errors) -> instance
-                  | (sheets: untyped, shared_strings: untyped, styles: untyped, unmapped_data: untyped, errors: untyped) -> instance
+      alias [] sheet
 
-      def self.members: () -> [ :sheets, :shared_strings, :styles, :unmapped_data, :errors ]
+      # Loads all sheets into memory, returning an Elements::Workbook where every
+      # worksheet is a fully-parsed Elements::Worksheet supporting coordinate random access.
+      #
+      # @example
+      #   wb = Xlsxrb.read("file.xlsx").load
+      #   puts wb["Sheet1"]["A1"].value
+      #
+      # @return [Elements::Workbook]
+      # @api public
+      # : () -> Elements::Workbook
+      def load: () -> Elements::Workbook
 
-      def members: () -> [ :sheets, :shared_strings, :styles, :unmapped_data, :errors ]
+      alias to_workbook load
+
+      # Closes any streaming resources associated with worksheets.
+      #
+      # @return [void]
+      # @api public
+      # : () -> void
+      def close: () -> void
+
+      # Returns a new Workbook with the specified sheet updated.
+      # Yields the matched worksheet to the block, which must return a new Worksheet.
+      #
+      # @example
+      #   new_wb = wb.update_sheet("Sheet1") do |sheet|
+      #     sheet.update_cell("A1", value: "New Title")
+      #   end
+      #
+      # @param identifier [Integer, String] 0-based index or sheet name.
+      # @yield [sheet]
+      # @yieldparam sheet [Elements::Worksheet] The worksheet to update.
+      # @yieldreturn [Elements::Worksheet] The modified worksheet.
+      # @return [Elements::Workbook] A new Workbook instance.
+      # @api public
+      # : (Integer | String identifier) ?{ (Elements::Worksheet) -> Elements::Worksheet } -> Elements::Workbook
+      def update_sheet: (Integer | String identifier) ?{ (Elements::Worksheet) -> Elements::Worksheet } -> Elements::Workbook
+
+      # Returns an Array of all worksheet names.
+      #
+      # @return [Array<String>]
+      # @api public
+      # : () -> Array[String]
+      def sheet_names: () -> Array[String]
+
+      # Save the workbook to an XLSX file.
+      #
+      # @example
+      #   wb.save("output.xlsx")
+      #
+      # @param filepath [String, IO, StringIO] Destination file path or IO stream.
+      # @return [void]
+      # @api public
+      # : (String | IO | StringIO filepath) -> void
+      def save: (String | IO | StringIO filepath) -> void
+
+      # Validates workbook structure according to OOXML specifications.
+      #
+      # @param sheets [Array<Elements::Worksheet>]
+      # @return [Array<String>] List of error messages.
+      # : (untyped sheets) -> Array[String]
+      def self.validate: (untyped sheets) -> Array[String]
     end
   end
 end