xlsxrb 0.1.13 → 0.1.15

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

@@ -21,18 +21,152 @@ 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_reader merged_cells: untyped
+
+      attr_reader auto_filter: untyped
+
+      attr_reader tables: untyped
+
+      attr_reader shapes: untyped
+
+      attr_reader freeze_pane: untyped
+
+      attr_reader page_setup: untyped
+
+      attr_reader page_margins: untyped
+
+      attr_reader header_footer: untyped
+
+      attr_reader print_options: untyped
+
+      attr_reader sheet_protection: untyped
+
+      attr_reader sheet_view: untyped
+
+      attr_reader sheet_properties: untyped
+
+      attr_reader sheet_format: untyped
+
+      attr_reader row_breaks: untyped
+
+      attr_reader col_breaks: untyped
+
+      attr_reader protected_ranges: untyped
+
+      attr_reader cell_watches: 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.
+      # @param merged_cells [Array<String>] Merged cell ranges (e.g. ["A1:B2"]).
+      # @param auto_filter [String, nil] AutoFilter range (e.g. "A1:E10").
+      # @param tables [Array<Hash>] Table definitions in the sheet.
+      # @param shapes [Array<Hash>] Shape definitions in the sheet.
+      # @param freeze_pane [Hash, nil] Freeze pane settings (e.g. { row: 1, col: 0 }).
+      # @param page_setup [Hash] Page setup properties (e.g. orientation, paper size).
+      # @param page_margins [Hash, nil] Page margins settings.
+      # @param header_footer [Hash] Header and footer configurations.
+      # @param print_options [Hash] Print options (e.g. gridlines, headings).
+      # @param sheet_protection [Hash, nil] Sheet protection settings.
+      # @param sheet_view [Hash] Sheet view configurations (e.g. zoom, gridlines).
+      # @param sheet_properties [Hash] Sheet properties (e.g. tabColor, outlinePr).
+      # @param sheet_format [Hash] Sheet format properties (e.g. defaultRowHeight, defaultColWidth).
+      # @param row_breaks [Array<Integer | Hash>] Explicit page row breaks.
+      # @param col_breaks [Array<Integer | Hash>] Explicit page column breaks.
+      # @param protected_ranges [Array<Hash>] Protected range definitions.
+      # @param cell_watches [Array<String>] Watched cell references.
+      # : (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, 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]], ?merged_cells: Array[String], ?auto_filter: String?, ?tables: Array[Hash[Symbol, untyped]], ?shapes: Array[Hash[Symbol, untyped]], ?freeze_pane: Hash[Symbol, untyped]?, ?page_setup: Hash[Symbol, untyped], ?page_margins: Hash[Symbol, untyped]?, ?header_footer: Hash[Symbol, untyped], ?print_options: Hash[Symbol, untyped], ?sheet_protection: Hash[Symbol, untyped]?, ?sheet_view: Hash[Symbol, untyped], ?sheet_properties: Hash[Symbol, untyped], ?sheet_format: Hash[Symbol, untyped], ?row_breaks: Array[untyped], ?col_breaks: Array[untyped], ?protected_ranges: Array[Hash[Symbol, untyped]], ?cell_watches: Array[String]) -> 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, 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]], ?merged_cells: Array[String], ?auto_filter: String?, ?tables: Array[Hash[Symbol, untyped]], ?shapes: Array[Hash[Symbol, untyped]], ?freeze_pane: Hash[Symbol, untyped]?, ?page_setup: Hash[Symbol, untyped], ?page_margins: Hash[Symbol, untyped]?, ?header_footer: Hash[Symbol, untyped], ?print_options: Hash[Symbol, untyped], ?sheet_protection: Hash[Symbol, untyped]?, ?sheet_view: Hash[Symbol, untyped], ?sheet_properties: Hash[Symbol, untyped], ?sheet_format: Hash[Symbol, untyped], ?row_breaks: Array[untyped], ?col_breaks: Array[untyped], ?protected_ranges: Array[Hash[Symbol, untyped]], ?cell_watches: Array[String]) -> 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 +175,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 +202,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 +257,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 +349,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 +402,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/workbook_writer.rbs

@@ -68,7 +68,7 @@ module Xlsxrb
 
       def write_shared_strings_xml: (untyped zip) -> untyped
 
-      def write_worksheet_xml: (untyped io, untyped sheet, ?drawing_rid: untyped, ?sheet_protection: untyped, ?auto_filter: untyped, ?filter_columns: untyped, ?sort_state: untyped, ?merge_cells: untyped, ?conditional_formats: untyped, ?data_validations: untyped, ?hyperlinks: untyped, ?print_options: untyped, ?page_margins: untyped, ?page_setup: untyped, ?header_footer: untyped, ?row_breaks: untyped, ?col_breaks: untyped, ?freeze_pane: untyped, ?split_pane: untyped, ?selection: untyped, ?sheet_view: untyped, ?sheet_properties: untyped, ?tables: untyped, ?table_start_rid: untyped, ?legacy_drawing_rid: untyped, ?sparkline_groups: untyped) -> untyped
+      def write_worksheet_xml: (untyped io, untyped sheet, ?drawing_rid: untyped, ?sheet_protection: untyped, ?protected_ranges: untyped, ?auto_filter: untyped, ?filter_columns: untyped, ?sort_state: untyped, ?merge_cells: untyped, ?conditional_formats: untyped, ?data_validations: untyped, ?hyperlinks: untyped, ?print_options: untyped, ?page_margins: untyped, ?page_setup: untyped, ?header_footer: untyped, ?row_breaks: untyped, ?col_breaks: untyped, ?cell_watches: untyped, ?freeze_pane: untyped, ?split_pane: untyped, ?selection: untyped, ?sheet_view: untyped, ?sheet_properties: untyped, ?sheet_format: untyped, ?tables: untyped, ?table_start_rid: untyped, ?legacy_drawing_rid: untyped, ?sparkline_groups: untyped) -> untyped
 
       def build_table_xml: (untyped tbl, untyped table_id) -> untyped