xlsxrb 0.1.13 → 0.1.14

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

@@ -21,18 +21,101 @@ module Xlsxrb
 
       attr_reader charts: untyped
 
+      attr_reader conditional_formatting: untyped
+
+      attr_reader data_validations: untyped
+
       attr_reader unmapped_data: untyped
 
       attr_reader errors: untyped
 
+      attr_reader state: untyped
+
+      attr_reader hyperlinks: untyped
+
+      attr_reader comments: untyped
+
+      attr_reader images: untyped
+
+      attr_reader styles: untyped
+
+      attr_reader date1904: untyped
+
+      attr_reader print_area: untyped
+
+      attr_reader print_titles: untyped
+
+      attr_reader sparkline_groups: untyped
+
+      attr_writer dimension: untyped
+
+      alias conditional_formats conditional_formatting
+
       # @param name [String] The worksheet name (max 31 characters).
       # @param rows [Array<Elements::Row>] Rows in the sheet.
       # @param columns [Array<Elements::Column>] Column definitions.
       # @param charts [Array<Hash>] Charts in the sheet.
+      # @param conditional_formatting [Array<Hash>, nil] Conditional formatting rules.
+      # @param data_validations [Array<Hash>] Data validation rules.
       # @param unmapped_data [Hash] Additional metadata for round-tripping.
       # @param errors [Array<String>, nil] Validation errors.
-      # : (name: String?, ?rows: Array[Elements::Row], ?columns: Array[Elements::Column], ?charts: Array[Hash[Symbol, untyped]], ?unmapped_data: Hash[untyped, untyped], ?errors: Array[String]?) -> void
-      def initialize: (name: String?, ?rows: Array[Elements::Row], ?columns: Array[Elements::Column], ?charts: Array[Hash[Symbol, untyped]], ?unmapped_data: Hash[untyped, untyped], ?errors: Array[String]?) -> void
+      # @param conditional_formats [Array<Hash>, nil] Alias for conditional_formatting.
+      # @param state [Symbol] Sheet visibility state (:visible, :hidden, or :very_hidden).
+      # @param hyperlinks [Hash{String => Hash}] Hyperlink mappings by cell reference.
+      # @param comments [Array<Hash>] Comments and notes in the sheet.
+      # @param images [Array<Elements::Image>] Embedded images in the sheet.
+      # @param styles [Hash, nil] Optional parsed styles hash.
+      # @param dimension [String, nil] Sheet dimension reference string (e.g. "A1:Z50000").
+      # @param trim_empty_rows [Boolean] Whether to omit trailing empty rows during iteration.
+      # @param pad_empty_rows [Boolean] Whether to yield empty rows for skipped row numbers.
+      # @param pad_empty_cells [Boolean] Whether to pad missing cells within rows.
+      # @param print_area [String, nil] Sheet print area range (e.g. "A1:H50").
+      # @param print_titles [Hash, nil] Repeating print title rows/cols (e.g. { rows: "1:2", cols: "A:B" }).
+      # @param sparkline_groups [Array<Hash>] Sparkline groups in the sheet.
+      # : (name: String?, ?rows: Array[Elements::Row], ?columns: Array[Elements::Column], ?charts: Array[Hash[Symbol, untyped]], ?conditional_formatting: Array[Hash[Symbol, untyped]]?, ?data_validations: Array[Hash[Symbol, untyped]], ?unmapped_data: Hash[untyped, untyped], ?errors: Array[String]?, ?conditional_formats: Array[Hash[Symbol, untyped]]?, ?state: Symbol, ?hyperlinks: Hash[String, Hash[Symbol, untyped]], ?comments: Array[Hash[Symbol, untyped]], ?images: Array[Elements::Image], ?styles: Hash[untyped, untyped]?, ?date1904: bool, ?dimension: String?, ?trim_empty_rows: bool, ?pad_empty_rows: bool, ?pad_empty_cells: bool, ?print_area: String?, ?print_titles: Hash[Symbol, untyped]?, ?sparkline_groups: Array[Hash[Symbol, untyped]]) -> void
+      def initialize: (name: String?, ?rows: Array[Elements::Row], ?columns: Array[Elements::Column], ?charts: Array[Hash[Symbol, untyped]], ?conditional_formatting: Array[Hash[Symbol, untyped]]?, ?data_validations: Array[Hash[Symbol, untyped]], ?unmapped_data: Hash[untyped, untyped], ?errors: Array[String]?, ?conditional_formats: Array[Hash[Symbol, untyped]]?, ?state: Symbol, ?hyperlinks: Hash[String, Hash[Symbol, untyped]], ?comments: Array[Hash[Symbol, untyped]], ?images: Array[Elements::Image], ?styles: Hash[untyped, untyped]?, ?date1904: bool, ?dimension: String?, ?trim_empty_rows: bool, ?pad_empty_rows: bool, ?pad_empty_cells: bool, ?print_area: String?, ?print_titles: Hash[Symbol, untyped]?, ?sparkline_groups: Array[Hash[Symbol, untyped]]) -> void
+
+      # Returns whether trailing empty rows are omitted during iteration.
+      #
+      # @return [Boolean]
+      # @api public
+      # : () -> bool
+      def trim_empty_rows?: () -> bool
+
+      alias trim_empty_rows trim_empty_rows?
+
+      # Returns whether skipped rows are padded during iteration.
+      #
+      # @return [Boolean]
+      # @api public
+      # : () -> bool
+      def pad_empty_rows?: () -> bool
+
+      alias pad_empty_rows pad_empty_rows?
+
+      # Returns whether missing cells within rows are padded during iteration.
+      #
+      # @return [Boolean]
+      # @api public
+      # : () -> bool
+      def pad_empty_cells?: () -> bool
+
+      alias pad_empty_cells pad_empty_cells?
+
+      # Returns whether the worksheet uses the 1904 date system.
+      #
+      # @return [Boolean]
+      # @api public
+      # : () -> bool
+      def date1904?: () -> bool
+
+      # Returns the worksheet dimension reference string (e.g. "A1:Z50000"),
+      # or computes it dynamically from rows if not explicitly set.
+      #
+      # @return [String, nil]
+      # @api public
+      # : () -> String?
+      def dimension: () -> String?
 
       # Iterate over rows in the worksheet.
       #
@@ -41,14 +124,25 @@ module Xlsxrb
       #     puts row.to_a.inspect
       #   end
       #
-      # @yield [row]
-      # @yieldparam row [Elements::Row]
-      # @return [Enumerator, void]
+      # @overload each(trim_empty_rows: nil, pad_empty_rows: nil, pad_empty_cells: nil, &block)
+      #   @param trim_empty_rows [Boolean, nil] Whether to omit trailing empty rows.
+      #   @param pad_empty_rows [Boolean, nil] Whether to yield empty rows for skipped row numbers.
+      #   @param pad_empty_cells [Boolean, nil] Whether to pad missing cells within rows.
+      #   @yield [row]
+      #   @yieldparam row [Elements::Row]
+      #   @return [void]
+      #
+      # @overload each(trim_empty_rows: nil, pad_empty_rows: nil, pad_empty_cells: nil)
+      #   @param trim_empty_rows [Boolean, nil] Whether to omit trailing empty rows.
+      #   @param pad_empty_rows [Boolean, nil] Whether to yield empty rows for skipped row numbers.
+      #   @param pad_empty_cells [Boolean, nil] Whether to pad missing cells within rows.
+      #   @return [Enumerator<Elements::Row, void>]
+      #
       # @api public
-      # : () { (Elements::Row) -> void } -> void
-      # : () -> Enumerator[Elements::Row, void]
-      def each: () { (Elements::Row) -> void } -> void
-              | () -> Enumerator[Elements::Row, void]
+      # : (?trim_empty_rows: bool?, ?pad_empty_rows: bool?, ?pad_empty_cells: bool?) { (Elements::Row) -> void } -> void
+      # : (?trim_empty_rows: bool?, ?pad_empty_rows: bool?, ?pad_empty_cells: bool?) -> Enumerator[Elements::Row, void]
+      def each: (?trim_empty_rows: bool?, ?pad_empty_rows: bool?, ?pad_empty_cells: bool?) { (Elements::Row) -> void } -> void
+              | (?trim_empty_rows: bool?, ?pad_empty_rows: bool?, ?pad_empty_cells: bool?) -> Enumerator[Elements::Row, void]
 
       # Iterate over rows in the worksheet.
       #
@@ -57,14 +151,49 @@ module Xlsxrb
       #     puts "Row #{row.index}: #{row.to_a.inspect}"
       #   end
       #
-      # @yield [row]
-      # @yieldparam row [Elements::Row]
-      # @return [Enumerator, void]
+      # @overload each_row(trim_empty_rows: nil, pad_empty_rows: nil, pad_empty_cells: nil, &block)
+      #   @param trim_empty_rows [Boolean, nil] Whether to omit trailing empty rows.
+      #   @param pad_empty_rows [Boolean, nil] Whether to yield empty rows for skipped row numbers.
+      #   @param pad_empty_cells [Boolean, nil] Whether to pad missing cells within rows.
+      #   @yield [row]
+      #   @yieldparam row [Elements::Row]
+      #   @return [void]
+      #
+      # @overload each_row(trim_empty_rows: nil, pad_empty_rows: nil, pad_empty_cells: nil)
+      #   @param trim_empty_rows [Boolean, nil] Whether to omit trailing empty rows.
+      #   @param pad_empty_rows [Boolean, nil] Whether to yield empty rows for skipped row numbers.
+      #   @param pad_empty_cells [Boolean, nil] Whether to pad missing cells within rows.
+      #   @return [Enumerator<Elements::Row, void>]
+      #
       # @api public
-      # : () { (Elements::Row) -> void } -> void
-      # : () -> Enumerator[Elements::Row, void]
-      def each_row: () { (Elements::Row) -> void } -> void
-                  | () -> Enumerator[Elements::Row, void]
+      # : (?trim_empty_rows: bool?, ?pad_empty_rows: bool?, ?pad_empty_cells: bool?) { (Elements::Row) -> void } -> void
+      # : (?trim_empty_rows: bool?, ?pad_empty_rows: bool?, ?pad_empty_cells: bool?) -> Enumerator[Elements::Row, void]
+      def each_row: (?trim_empty_rows: bool?, ?pad_empty_rows: bool?, ?pad_empty_cells: bool?) { (Elements::Row) -> void } -> void
+                  | (?trim_empty_rows: bool?, ?pad_empty_rows: bool?, ?pad_empty_cells: bool?) -> Enumerator[Elements::Row, void]
+
+      # Iterates over row values as Arrays.
+      #
+      # @overload each_row_values(type_cast: false, trim_empty_rows: nil, pad_empty_rows: nil, pad_empty_cells: nil, &block)
+      #   @param type_cast [Boolean] Whether to coerce date/time serial numbers into Date/Time instances.
+      #   @param trim_empty_rows [Boolean, nil] Whether to omit trailing empty rows.
+      #   @param pad_empty_rows [Boolean, nil] Whether to yield empty rows for skipped row numbers.
+      #   @param pad_empty_cells [Boolean, nil] Whether to pad missing cells within rows.
+      #   @yield [values]
+      #   @yieldparam values [Array<Object>] Row values array.
+      #   @return [void]
+      #
+      # @overload each_row_values(type_cast: false, trim_empty_rows: nil, pad_empty_rows: nil, pad_empty_cells: nil)
+      #   @param type_cast [Boolean] Whether to coerce date/time serial numbers into Date/Time instances.
+      #   @param trim_empty_rows [Boolean, nil] Whether to omit trailing empty rows.
+      #   @param pad_empty_rows [Boolean, nil] Whether to yield empty rows for skipped row numbers.
+      #   @param pad_empty_cells [Boolean, nil] Whether to pad missing cells within rows.
+      #   @return [Enumerator<Array<Object>, void>]
+      #
+      # @api public
+      # : (?type_cast: bool, ?trim_empty_rows: bool?, ?pad_empty_rows: bool?, ?pad_empty_cells: bool?) { (Array[untyped]) -> void } -> void
+      # : (?type_cast: bool, ?trim_empty_rows: bool?, ?pad_empty_rows: bool?, ?pad_empty_cells: bool?) -> Enumerator[Array[untyped], void]
+      def each_row_values: (?type_cast: bool, ?trim_empty_rows: bool?, ?pad_empty_rows: bool?, ?pad_empty_cells: bool?) { (Array[untyped]) -> void } -> void
+                         | (?type_cast: bool, ?trim_empty_rows: bool?, ?pad_empty_rows: bool?, ?pad_empty_cells: bool?) -> Enumerator[Array[untyped], void]
 
       # Iterate over all cells across rows.
       #
@@ -77,12 +206,89 @@ module Xlsxrb
       def each_cell: () { (Elements::Cell) -> void } -> void
                    | () -> Enumerator[Elements::Cell, void]
 
+      # Returns all images anchored at a specific cell reference or 0-based coordinate.
+      #
+      # @param ref_or_row [String, Symbol, Integer] Cell reference (e.g. "A1") or 0-based row index.
+      # @param col [Integer, nil] Optional 0-based column index.
+      # @return [Array<Elements::Image>]
+      # @api public
+      # : (String | Symbol | Integer ref_or_row, ?Integer? col) -> Array[Elements::Image]
+      def images_at: (String | Symbol | Integer ref_or_row, ?Integer? col) -> Array[Elements::Image]
+
+      # Yields self with images loaded or returns self.
+      #
+      # @yield [sheet]
+      # @yieldparam sheet [Elements::Worksheet]
+      # @return [Elements::Worksheet, void]
+      # @api public
+      # : () { (Elements::Worksheet) -> void } -> void
+      # : () -> Elements::Worksheet
+      def with_images: () { (Elements::Worksheet) -> void } -> void
+                     | () -> Elements::Worksheet
+
       # Returns whether the worksheet is valid according to OOXML specifications.
       #
       # @return [Boolean]
       # : () -> bool
       def valid?: () -> bool
 
+      # Returns whether the worksheet is hidden (:hidden or :very_hidden).
+      #
+      # @return [Boolean]
+      # @api public
+      # : () -> bool
+      def hidden?: () -> bool
+
+      # Returns whether the worksheet is visible.
+      #
+      # @return [Boolean]
+      # @api public
+      # : () -> bool
+      def visible?: () -> bool
+
+      # Returns hyperlink metadata for the given cell reference, or nil.
+      #
+      # @param ref_or_row [String, Symbol, Integer] Cell reference (e.g. "A1") or 0-based row index.
+      # @param col [Integer, nil] Optional 0-based column index if ref_or_row is a row index.
+      # @return [Hash, nil]
+      # @api public
+      # : (String | Symbol | Integer ref_or_row, ?Integer? col) -> Hash[Symbol, untyped]?
+      def hyperlink: (String | Symbol | Integer ref_or_row, ?Integer? col) -> Hash[Symbol, untyped]?
+
+      # Returns comment metadata for the given cell reference, or nil.
+      #
+      # @param ref_or_row [String, Symbol, Integer] Cell reference (e.g. "A1") or 0-based row index.
+      # @param col [Integer, nil] Optional 0-based column index if ref_or_row is a row index.
+      # @return [Hash, nil]
+      # @api public
+      # : (String | Symbol | Integer ref_or_row, ?Integer? col) -> Hash[Symbol, untyped]?
+      def comment: (String | Symbol | Integer ref_or_row, ?Integer? col) -> Hash[Symbol, untyped]?
+
+      # Returns comments indexed by cell reference.
+      #
+      # @return [Hash<String, Hash[Symbol, untyped]>]
+      # @api public
+      # : () -> Hash[String, Hash[Symbol, untyped]]
+      def comments_by_ref: () -> Hash[String, Hash[Symbol, untyped]]
+
+      # Access a cell by reference or 0-based coordinates.
+      #
+      # @param ref_or_row [String, Symbol, Integer] Cell reference (e.g. "A1") or 0-based row index.
+      # @param col [Integer, nil] Optional 0-based column index.
+      # @return [Elements::Cell, nil]
+      # @api public
+      # : (String | Symbol | Integer ref_or_row, ?Integer? col) -> Elements::Cell?
+      def cell: (String | Symbol | Integer ref_or_row, ?Integer? col) -> Elements::Cell?
+
+      # Returns the formatted string representation of a cell's value.
+      #
+      # @param ref_or_row [String, Symbol, Integer] Cell reference (e.g. "A1") or 0-based row index.
+      # @param col [Integer, nil] Optional 0-based column index.
+      # @return [String, nil]
+      # @api public
+      # : (String | Symbol | Integer ref_or_row, ?Integer? col) -> String?
+      def formatted_value: (String | Symbol | Integer ref_or_row, ?Integer? col) -> String?
+
       # Returns a new Worksheet with the specified cell updated.
       #
       # @example
@@ -92,10 +298,12 @@ module Xlsxrb
       # @param value [Object] The new cell value.
       # @param style_index [Integer, String, nil] Optional new style index.
       # @param formula [Elements::Formula, nil] Optional new formula.
+      # @param hyperlink [Hash, String, nil] Optional new hyperlink.
+      # @param comment [Hash, String, nil] Optional new comment.
       # @return [Worksheet] A new Worksheet instance.
       # @api public
-      # : (String ref, ?value: untyped, ?style_index: Integer | String | nil, ?formula: Elements::Formula?) -> Elements::Worksheet
-      def update_cell: (String ref, ?value: untyped, ?style_index: Integer | String | nil, ?formula: Elements::Formula?) -> Elements::Worksheet
+      # : (String ref, ?value: untyped, ?style_index: Integer | String | nil, ?formula: Elements::Formula?, ?hyperlink: (Hash[Symbol, untyped] | String)?, ?comment: (Hash[Symbol, untyped] | String)?) -> Elements::Worksheet
+      def update_cell: (String ref, ?value: untyped, ?style_index: Integer | String | nil, ?formula: Elements::Formula?, ?hyperlink: (Hash[Symbol, untyped] | String)?, ?comment: (Hash[Symbol, untyped] | String)?) -> Elements::Worksheet
 
       # Returns a new Worksheet with attributes replaced (Data-like behavior).
       #
@@ -143,6 +351,11 @@ module Xlsxrb
       # @return [Array<String>] List of errors.
       # : (untyped name, untyped rows) -> Array[String]
       def self.validate: (untyped name, untyped rows) -> Array[String]
+
+      private
+
+      # : () -> String?
+      def compute_dimension: () -> String?
     end
   end
 end

data/sig/generated/xlsxrb/number_formatter.rbs

@@ -0,0 +1,132 @@
+# Generated from lib/xlsxrb/number_formatter.rb with RBS::Inline
+
+module Xlsxrb
+  # Formats cell values according to OpenXML formatCode strings.
+  # Evaluates and converts numeric, currency, percentage, date/time, scientific,
+  # and accounting format patterns into string representations.
+  #
+  # @api public
+  module NumberFormatter
+    # Built-in date and time format code strings.
+    DATE_PATTERNS: untyped
+
+    # Formats a cell value according to an Excel format code string.
+    #
+    # @param value [Object, nil] The cell's raw or typed value.
+    # @param format_code [String, nil] Excel format code pattern.
+    # @param date1904 [Boolean] Whether the 1904 date system is active.
+    # @return [String] Formatted string representation.
+    # @api public
+    # : (untyped value, ?String? format_code, ?date1904: bool) -> String
+    def self.format: (untyped value, ?String? format_code, ?date1904: bool) -> String
+
+    # Resolves the format code string for a given style index from a styles definition hash.
+    #
+    # @param style_index [Integer, nil] 0-based style index in cellXfs.
+    # @param styles [Hash, nil] Parsed styles hash.
+    # @return [String, nil] Format code string, or nil if not found.
+    # @api public
+    # : (Integer? style_index, untyped styles) -> String?
+    def self.format_code_for: (Integer? style_index, untyped styles) -> String?
+
+    # Returns the classified format category for a format code string.
+    #
+    # @param format_code [String, nil] Format code string.
+    # @return [Symbol, nil] :date, :datetime, :time, :number, :text, :general, or nil.
+    # @api public
+    # : (String? format_code) -> Symbol?
+    def self.format_type: (String? format_code) -> Symbol?
+
+    # Checks whether a format code string represents a date, datetime, or time pattern.
+    #
+    # @param format_code [String, nil]
+    # @param num_fmt_id [Integer, nil]
+    # @return [Boolean]
+    # : (String? format_code, ?Integer? num_fmt_id) -> bool
+    def self.date_format?: (String? format_code, ?Integer? num_fmt_id) -> bool
+
+    # Checks whether a format code string represents a date-only pattern.
+    #
+    # @param format_code [String, nil]
+    # @param num_fmt_id [Integer, nil]
+    # @return [Boolean]
+    # @api public
+    # : (String? format_code, ?Integer? num_fmt_id) -> bool
+    def self.date_only_format?: (String? format_code, ?Integer? num_fmt_id) -> bool
+
+    # Checks whether a format code string represents a datetime pattern.
+    #
+    # @param format_code [String, nil]
+    # @param num_fmt_id [Integer, nil]
+    # @return [Boolean]
+    # @api public
+    # : (String? format_code, ?Integer? num_fmt_id) -> bool
+    def self.datetime_format?: (String? format_code, ?Integer? num_fmt_id) -> bool
+
+    # Checks whether a format code string represents a time-only pattern.
+    #
+    # @param format_code [String, nil]
+    # @param num_fmt_id [Integer, nil]
+    # @return [Boolean]
+    # @api public
+    # : (String? format_code, ?Integer? num_fmt_id) -> bool
+    def self.time_format?: (String? format_code, ?Integer? num_fmt_id) -> bool
+
+    # Returns the format category Symbol for a style index and styles definition.
+    #
+    # @param style_index [Integer, nil]
+    # @param styles [untyped]
+    # @return [Symbol, nil]
+    # @api public
+    # : (Integer? style_index, untyped styles) -> Symbol?
+    def self.format_type_for: (Integer? style_index, untyped styles) -> Symbol?
+
+    # Checks whether a style index represents a date, datetime, or time format.
+    #
+    # @param style_index [Integer, nil]
+    # @param styles [untyped]
+    # @return [Boolean]
+    # @api public
+    # : (Integer? style_index, untyped styles) -> bool
+    def self.date_format_for?: (Integer? style_index, untyped styles) -> bool
+
+    # Checks whether a style index represents a datetime format.
+    #
+    # @param style_index [Integer, nil]
+    # @param styles [untyped]
+    # @return [Boolean]
+    # @api public
+    # : (Integer? style_index, untyped styles) -> bool
+    def self.datetime_format_for?: (Integer? style_index, untyped styles) -> bool
+
+    # Checks whether a style index represents a time format.
+    #
+    # @param style_index [Integer, nil]
+    # @param styles [untyped]
+    # @return [Boolean]
+    # @api public
+    # : (Integer? style_index, untyped styles) -> bool
+    def self.time_format_for?: (Integer? style_index, untyped styles) -> bool
+
+    # Checks whether a style index represents a date-only format.
+    #
+    # @param style_index [Integer, nil]
+    # @param styles [untyped]
+    # @return [Boolean]
+    # @api public
+    # : (Integer? style_index, untyped styles) -> bool
+    def self.date_only_format_for?: (Integer? style_index, untyped styles) -> bool
+
+    private def self.default_format: (untyped value) -> untyped
+
+    private def self.split_sections: (untyped code) -> untyped
+
+    private def self.format_number: (untyped value, untyped code) -> untyped
+
+    private def self.format_single_number: (untyped num, untyped pattern, untyped is_neg) -> untyped
+
+    private def self.format_datetime: (untyped datetime, untyped format_code) -> untyped
+
+    private def self.excel_to_strftime: (untyped format_code) -> untyped
+  end
+end

data/sig/generated/xlsxrb/ooxml/reader.rbs

@@ -158,6 +158,12 @@ module Xlsxrb
       # Returns workbook properties (e.g. { date1904: false, default_theme_version: 166925 }).
       def workbook_properties: () -> untyped
 
+      # Returns whether the workbook uses the 1904 date system.
+      #
+      # @return [Boolean]
+      # : () -> bool
+      def date1904?: () -> bool
+
       # Returns the workbook conformance class ("transitional" or "strict"), or nil if not set.
       def conformance: () -> untyped
 

data/sig/generated/xlsxrb/ooxml/shared_strings_parser.rbs

@@ -14,6 +14,8 @@ module Xlsxrb
       def self.fast_scan: (untyped xml_src) -> untyped
 
       def self.extract_multi_t: (untyped xml, untyped from, untyped to) -> untyped
+
+      def self.normalize_newlines: (untyped str) -> untyped
     end
   end
 end

data/sig/generated/xlsxrb/ooxml/styles_parser.rbs

@@ -3,9 +3,10 @@
 module Xlsxrb
   module Ooxml
     # SAX-based parser for xl/styles.xml.
-    # Returns a Hash with :num_fmts, :fonts, :fills, :borders, :cell_xfs, :cell_style_xfs.
+    # Returns an Elements::Styles (Hash) with :num_fmts, :fonts, :fills, :borders, :cell_xfs, :cell_style_xfs.
     class StylesParser
-      def self.parse: (untyped xml_string) -> untyped
+      # : (String? xml_string) -> Elements::Styles
+      def self.parse: (String? xml_string) -> Elements::Styles
 
       # SAX listener for parsing styles.xml content.
       class Listener
@@ -35,6 +36,8 @@ module Xlsxrb
 
         def handle_alignment: (untyped attrs) -> untyped
 
+        def handle_protection: (untyped attrs) -> untyped
+
         def finalize_xf: () -> untyped
 
         def extract_color: (untyped attrs) -> untyped

data/sig/generated/xlsxrb/ooxml/utils.rbs

@@ -9,6 +9,11 @@ module Xlsxrb
 
       EPOCH_1900_JD: untyped
 
+      # Excel 1904 date system epoch.
+      EPOCH_1904: untyped
+
+      EPOCH_1904_JD: untyped
+
       # Built-in number format codes defined by SpreadsheetML.
       BUILTIN_NUM_FMT_CODES: untyped
 
@@ -21,17 +26,21 @@ module Xlsxrb
       # Default date-time format code used by Writer for Time cells.
       DEFAULT_DATETIME_FORMAT: ::String
 
-      # Converts a Date to an Excel serial number (1900 system).
-      def self.date_to_serial: (untyped date) -> untyped
+      # Converts a Date to an Excel serial number (1900 or 1904 system).
+      # : (Date date, ?date1904: bool) -> untyped
+      def self.date_to_serial: (Date date, ?date1904: bool) -> untyped
 
-      # Converts an Excel serial number (1900 system) to a Date.
-      def self.serial_to_date: (untyped serial) -> untyped
+      # Converts an Excel serial number (1900 or 1904 system) to a Date.
+      # : (Numeric serial, ?date1904: bool) -> Date
+      def self.serial_to_date: (Numeric serial, ?date1904: bool) -> Date
 
-      # Converts a Time to a fractional Excel serial number (1900 system).
-      def self.datetime_to_serial: (untyped time) -> untyped
+      # Converts a Time to a fractional Excel serial number (1900 or 1904 system).
+      # : (Time time, ?date1904: bool) -> Float
+      def self.datetime_to_serial: (Time time, ?date1904: bool) -> Float
 
-      # Converts a fractional Excel serial number to a Time (1900 system, UTC).
-      def self.serial_to_datetime: (untyped serial) -> untyped
+      # Converts a fractional Excel serial number to a Time (1900 or 1904 system, UTC).
+      # : (Numeric serial, ?date1904: bool) -> Time
+      def self.serial_to_datetime: (Numeric serial, ?date1904: bool) -> Time
 
       # Hashes a plain-text password for use with sheet/workbook protection.
       # Returns { algorithm_name:, hash_value:, salt_value:, spin_count: }.

data/sig/generated/xlsxrb/ooxml/workbook_parser.rbs

@@ -7,19 +7,25 @@ module Xlsxrb
     class WorkbookParser
       def self.parse: (untyped xml_string) -> untyped
 
-      # SAX listener for workbook.xml sheets.
+      def self.parse_with_properties: (untyped xml_string) -> untyped
+
+      # SAX listener for workbook.xml sheets, properties, and defined names.
       class Listener
         include REXML::SAX2Listener
 
         attr_reader sheets: untyped
 
+        attr_reader date1904: untyped
+
+        attr_reader defined_names: untyped
+
         def initialize: () -> untyped
 
         def start_element: (untyped _uri, untyped localname, untyped _qname, untyped attrs) -> untyped
 
-        def end_element: (untyped _uri, untyped _localname, untyped _qname) -> untyped
+        def characters: (untyped text) -> untyped
 
-        def characters: (untyped _text) -> untyped
+        def end_element: (untyped _uri, untyped localname, untyped _qname) -> untyped
       end
     end
 

data/sig/generated/xlsxrb/ooxml/worksheet_parser.rbs

@@ -10,20 +10,32 @@ module Xlsxrb
 
       EMPTY_HASH: untyped
 
+      TAG_DELIM_BYTES: untyped
+
+      ROW_ATTR_START_BYTES: untyped
+
       # Parses all rows from a worksheet XML string.
       # Returns an Array of raw row hashes:
       #   { index:, cells: [{ ref:, type:, style_index:, value:, formula: }], attrs:, unmapped: }
-      def self.parse: (untyped xml_string, ?shared_strings: untyped) -> untyped
+      def self.parse: (untyped xml_string, ?shared_strings: untyped, ?styles: untyped) -> untyped
 
       # Streaming parse: yields one raw row hash at a time.
-      def self.each_row: (untyped xml_source, ?shared_strings: untyped, ?part_name: untyped) ?{ (?) -> untyped } -> untyped
+      def self.each_row: (untyped xml_source, ?shared_strings: untyped, ?part_name: untyped, ?styles: untyped, ?date1904: untyped, ?trim_empty_rows: untyped, ?pad_empty_rows: untyped, ?pad_empty_cells: untyped) ?{ (?) -> untyped } -> untyped
 
       # Parses column definitions (<cols>) from a worksheet.
-      def self.parse_columns: (untyped xml_string, ?part_name: untyped) -> untyped
+      def self.parse_columns: (untyped xml_string, ?untyped _part_name) -> untyped
 
       # Yields Event objects for columns, rows, cells, and hyperlinks.
       def self.each_event: (untyped xml_string, ?shared_strings: untyped, ?part_name: untyped) ?{ (?) -> untyped } -> untyped
 
+      # Parses all hyperlink elements from worksheet XML.
+      #
+      # @param xml_string [String, nil]
+      # @return [Array<Hash[Symbol, untyped]>]
+      # @api public
+      # : (String?) -> Array[Hash[Symbol, untyped]]
+      def self.parse_hyperlinks: (String?) -> Array[Hash[Symbol, untyped]]
+
       def self.fast_scan_events: (untyped xml_src, untyped shared_strings, untyped part_name) ?{ (?) -> untyped } -> untyped
 
       def self.extract_row_attrs: (untyped row_tag) -> untyped
@@ -43,6 +55,9 @@ module Xlsxrb
       # : (String str) -> String
       def self.decode_xml_entities: (String str) -> String
 
+      # : (String str) -> String
+      def self.normalize_text: (String str) -> String
+
       # Parses <cols> section for column definitions.
       class ColumnsListener
         include REXML::SAX2Listener
@@ -58,9 +73,11 @@ module Xlsxrb
         def characters: (untyped _text) -> untyped
       end
 
-      def self.fast_scan_rows_direct: (untyped xml_src, untyped shared_strings, untyped _part_name) ?{ (?) -> untyped } -> untyped
+      # rubocop:disable Style/OptionalBooleanParameter
+      def self.fast_scan_rows_direct: (untyped xml_src, untyped shared_strings, untyped _part_name, ?untyped styles, ?untyped date1904, ?untyped pad_empty_cells) ?{ (?) -> untyped } -> untyped
 
-      def self.scan_rows_stream: (untyped source, untyped shared_strings, untyped _part_name) ?{ (?) -> untyped } -> untyped
+      # rubocop:disable Style/OptionalBooleanParameter
+      def self.scan_rows_stream: (untyped source, untyped shared_strings, untyped _part_name, ?untyped styles, ?untyped date1904, ?untyped pad_empty_cells) ?{ (?) -> untyped } -> untyped
 
       COL_LETTERS: untyped
 
@@ -78,7 +95,12 @@ module Xlsxrb
 
       def self.fast_parse_cells_direct: (untyped xml, untyped from, untyped to, untyped shared_strings, untyped row_source, ?untyped prefix) -> untyped
 
-      def self.fast_scan_cells_direct: (untyped xml, untyped from, untyped to, untyped shared_strings, untyped row_source, ?untyped _prefix) ?{ (?) -> untyped } -> untyped
+      # rubocop:disable Style/OptionalBooleanParameter
+      def self.fast_scan_cells_direct: (untyped xml, untyped from, untyped to, untyped shared_strings, untyped row_source, ?untyped _prefix, ?untyped styles, ?untyped date1904) ?{ (?) -> untyped } -> untyped
+
+      # rubocop:disable Style/OptionalBooleanParameter
+      # : (String xml, Integer from, Integer to, Array[String] shared_strings, ?untyped styles, ?bool date1904, ?type_cast: bool) -> Array[untyped]
+      def self.fast_scan_row_values: (String xml, Integer from, Integer to, Array[String] shared_strings, ?untyped styles, ?bool date1904, ?type_cast: bool) -> Array[untyped]
     end
   end
 end

data/sig/generated/xlsxrb/ooxml/worksheet_writer.rbs

@@ -13,7 +13,9 @@ module Xlsxrb
 
       INTEGER_STRINGS: untyped
 
-      def initialize: (untyped io) -> untyped
+      def initialize: (untyped io, ?date1904: untyped) -> untyped
+
+      def set_column_style: (untyped col_index, untyped style_id) -> untyped
 
       # Write the worksheet header. Call once before writing rows.
       # Options for pre-sheetData elements:

data/sig/generated/xlsxrb/ooxml/writer.rbs

@@ -432,6 +432,8 @@ module Xlsxrb
       # : (untyped name, untyped value) -> untyped
       def set_workbook_property: (untyped name, untyped value) -> untyped
 
+      alias workbook_property set_workbook_property
+
       # Returns workbook properties hash.
       # : () -> untyped
       def workbook_properties: () -> untyped