xlsxrb 0.1.13 → 0.1.15

data/sig/generated/xlsxrb.rbs

@@ -29,6 +29,8 @@ module Xlsxrb
   class ParseError < Error
   end
 
+  OMITTED_TARGET: untyped
+
   # Raised when cell, row, or workbook parameters fail specification validation.
   class ValidationError < Error
   end
@@ -51,19 +53,25 @@ module Xlsxrb
 
   # Helper to construct {Elements::RichText} objects with formatted text runs.
   #
-  # @example Create multi-run rich text
+  # @example Create multi-run rich text with hashes
   #   rt = Xlsxrb.rich_text({ text: "Total: ", font: { bold: true } }, { text: "$100" })
   #
+  # @example Create rich text with text/font pairs
+  #   rt = Xlsxrb.rich_text("Normal text, ", ["bold text, ", { bold: true }], ["red text", { color: "FF0000" }])
+  #
+  # @example Create rich text with format objects implementing to_font_hash
+  #   rt = Xlsxrb.rich_text("Normal text, ", bold_format, "bold text")
+  #
   # @example Create simple styled text
   #   rt = Xlsxrb.rich_text(text: "Important Notice", bold: true, color: "FF0000")
   #
-  # @param runs [Array<Hash, String>] Optional array of rich text run hashes or string.
+  # @param runs [Array<Hash, String, Array, Elements::RichTextRun, Object>] Optional array of rich text run items.
   # @param text [String, nil] Plain text string (convenience parameter).
   # @param font_props [Hash] Inline font styling options (e.g. bold: true, color: "FF0000").
   # @return [Elements::RichText] The compiled rich text element.
   # @api public
-  # : (*(Hash[Symbol, untyped] | String) runs, ?text: String?, **untyped font_props) -> Elements::RichText
-  def self.rich_text: (*Hash[Symbol, untyped] | String runs, ?text: String?, **untyped font_props) -> Elements::RichText
+  # : (*(Hash[Symbol, untyped] | Elements::RichTextRun | String | Array[untyped] | untyped) runs, ?text: String?, **untyped font_props) -> Elements::RichText
+  def self.rich_text: (*Hash[Symbol, untyped] | Elements::RichTextRun | String | Array[untyped] | untyped runs, ?text: String?, **untyped font_props) -> Elements::RichText
 
   # Creates an {Elements::Formula} object for use in cell values.
   #
@@ -75,10 +83,160 @@ module Xlsxrb
   #
   # @param expression [String] The formula expression without leading '=' (e.g. "SUM(A1:A10)").
   # @param cached_value [Object, nil] Optional precomputed value for readers that do not evaluate formulas.
+  # @param type [Symbol, String, nil] Formula type (:shared, :array, etc.).
+  # @param ref [String, nil] Target cell or range reference (e.g. "A1:C1").
+  # @return [Elements::Formula]
+  # @api public
+  # : (String expression, ?cached_value: (String | Numeric | bool | nil), ?type: (Symbol | String)?, ?ref: String?) -> Elements::Formula
+  def self.formula: (String expression, ?cached_value: String | Numeric | bool | nil, ?type: (Symbol | String)?, ?ref: String?) -> Elements::Formula
+
+  # Creates an array or dynamic array {Elements::Formula} object.
+  #
+  # @example Create a multi-cell array formula
+  #   formula = Xlsxrb.array_formula("SUM(B1:B10*C1:C10)", "A1:C1", cached_value: 0)
+  #
+  # @example Create a dynamic array formula
+  #   formula = Xlsxrb.array_formula("SORT(UNIQUE(A1:A10))", "D1")
+  #
+  # @param expression [String] The formula expression without leading '='.
+  # @param ref [String, nil] Target cell or range reference (e.g. "A1:C1" or "D1").
+  # @param cached_value [Object, nil] Optional precomputed value.
   # @return [Elements::Formula]
   # @api public
-  # : (String expression, ?cached_value: (String | Numeric | bool | nil)) -> Elements::Formula
-  def self.formula: (String expression, ?cached_value: String | Numeric | bool | nil) -> Elements::Formula
+  # : (String expression, ?String? ref, ?cached_value: (String | Numeric | bool | nil)) -> Elements::Formula
+  def self.array_formula: (String expression, ?String? ref, ?cached_value: String | Numeric | bool | nil) -> Elements::Formula
+
+  # Creates an {Elements::Hyperlink} object for use in cell hyperlinks.
+  #
+  # @example Create an external hyperlink with a ScreenTip tooltip
+  #   link = Xlsxrb.hyperlink("https://example.com", tooltip: "Visit Example")
+  #
+  # @example Create an internal worksheet link
+  #   link = Xlsxrb.hyperlink(location: "Sheet2!A1", tooltip: "Go to Sheet 2")
+  #
+  # @param url [String, nil] External hyperlink URL.
+  # @param display [String, nil] Optional display label.
+  # @param tooltip [String, nil] Optional hover ScreenTip text.
+  # @param location [String, nil] Optional internal sheet coordinate.
+  # @return [Elements::Hyperlink]
+  # @api public
+  # : (?String? url, ?display: String?, ?tooltip: String?, ?location: String?) -> Elements::Hyperlink
+  def self.hyperlink: (?String? url, ?display: String?, ?tooltip: String?, ?location: String?) -> Elements::Hyperlink
+
+  # Formats a cell value according to an Excel format code string.
+  #
+  # @param value [Object, nil] Value to format.
+  # @param format_code [String, nil] Excel format code string.
+  # @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
+
+  # Converts a Date or Time to an Excel numeric serial number (1900 or 1904 system).
+  #
+  # @example
+  #   Xlsxrb.date_to_serial(Date.new(2026, 1, 1)) #=> 46023
+  #
+  # @param date_or_time [Date, Time] Date or Time instance.
+  # @param date1904 [Boolean] Whether to use the 1904 date system.
+  # @return [Integer, Float] Serial number.
+  # @api public
+  # : (Date | Time date_or_time, ?date1904: bool) -> (Integer | Float)
+  def self.date_to_serial: (Date | Time date_or_time, ?date1904: bool) -> (Integer | Float)
+
+  # Converts an Excel serial number to a Date.
+  #
+  # @example
+  #   Xlsxrb.serial_to_date(46023) #=> #<Date: 2026-01-01>
+  #
+  # @param serial [Numeric] Excel serial number.
+  # @param date1904 [Boolean] Whether to use the 1904 date system.
+  # @return [Date]
+  # @api public
+  # : (Numeric serial, ?date1904: bool) -> Date
+  def self.serial_to_date: (Numeric serial, ?date1904: bool) -> Date
+
+  # Converts a Time or Date to a fractional Excel serial number.
+  #
+  # @example
+  #   Xlsxrb.datetime_to_serial(Time.utc(2026, 1, 1, 12, 0, 0)) #=> 46023.5
+  #
+  # @param time [Time, Date] Time or Date instance.
+  # @param date1904 [Boolean] Whether to use the 1904 date system.
+  # @return [Float] Fractional serial number.
+  # @api public
+  # : (Time | Date time, ?date1904: bool) -> Float
+  def self.datetime_to_serial: (Time | Date time, ?date1904: bool) -> Float
+
+  # Converts an Excel serial number to a Time (UTC).
+  #
+  # @example
+  #   Xlsxrb.serial_to_time(46023.5) #=> 2026-01-01 12:00:00 UTC
+  #
+  # @param serial [Numeric] Excel serial number.
+  # @param date1904 [Boolean] Whether to use the 1904 date system.
+  # @return [Time]
+  # @api public
+  # : (Numeric serial, ?date1904: bool) -> Time
+  def self.serial_to_time: (Numeric serial, ?date1904: bool) -> Time
+
+  alias self.serial_to_datetime self.serial_to_time
+
+  # Converts a cell range reference string (e.g. "A1:C10", "A1") to 0-based [[top_row, left_col], [bottom_row, right_col]].
+  #
+  # @example
+  #   Xlsxrb.parse_range("A1:C10") #=> [[0, 0], [9, 2]]
+  #
+  # @param range_ref [String, nil]
+  # @return [Array([Integer, Integer], [Integer, Integer]), nil]
+  # @api public
+  # : (String? range_ref) -> [[Integer, Integer], [Integer, Integer]]?
+  def self.parse_range: (String? range_ref) -> [ [ Integer, Integer ], [ Integer, Integer ] ]?
+
+  # Converts 0-based bounding coordinates to an A1-style range reference string.
+  #
+  # @example
+  #   Xlsxrb.range_to_ref(0, 0, 9, 2) #=> "A1:C10"
+  #
+  # @param top_row [Integer]
+  # @param left_col [Integer]
+  # @param bottom_row [Integer]
+  # @param right_col [Integer]
+  # @return [String]
+  # @api public
+  # : (Integer top_row, Integer left_col, Integer bottom_row, Integer right_col) -> String
+  def self.range_to_ref: (Integer top_row, Integer left_col, Integer bottom_row, Integer right_col) -> String
+
+  # Resolves an ECMA-376 indexed color palette index (0..63) to an RRGGBB hex string (or AARRGGBB if alpha: true).
+  #
+  # @example
+  #   Xlsxrb.palette_color(12)               #=> "0000FF"
+  #   Xlsxrb.palette_color(12, alpha: true)  #=> "FF0000FF"
+  #
+  # @param index [Object, nil] Palette index (0..63).
+  # @param alpha [Boolean] Whether to prefix "FF" alpha channel.
+  # @return [String, nil]
+  # @api public
+  # : (untyped index, ?alpha: bool) -> String?
+  def self.palette_color: (untyped index, ?alpha: bool) -> String?
+
+  # Converts any supported color representation (palette index 0..63, CSS name, #RGB, #RRGGBB, #AARRGGBB, integer RGB)
+  # to a normalized hex string.
+  #
+  # @example
+  #   Xlsxrb.to_hex_color(12)                      #=> "0000FF"
+  #   Xlsxrb.to_hex_color(:navy)                   #=> "000080"
+  #   Xlsxrb.to_hex_color("#FF0000")               #=> "FF0000"
+  #
+  # @param color [Integer, String, Symbol, nil]
+  # @param alpha [Boolean] Whether to include the alpha channel (default false -> "RRGGBB").
+  # @return [String, nil]
+  # @api public
+  # : (Integer | String | Symbol | nil color, ?alpha: bool) -> String?
+  def self.to_hex_color: (Integer | String | Symbol | nil color, ?alpha: bool) -> String?
+
+  alias self.color_to_hex self.to_hex_color
 
   # Reads an XLSX file (streaming and lazy-loaded by default) from a file path, IO stream, or binary String.
   #
@@ -86,18 +244,24 @@ module Xlsxrb
   # yields each {StreamSheet} sequentially. Call {#load} on the returned Workbook or Sheet
   # to convert to an in-memory representation for coordinate random access (`sheet["A1"]`).
   #
-  # @overload read(source, password: nil, &block)
+  # @overload read(source, password: nil, trim_empty_rows: false, pad_empty_rows: false, pad_empty_cells: false, &block)
   #   Yields each {StreamSheet} sequentially in streaming mode.
   #   @param source [String, IO, StringIO] File path, binary content string, or readable IO stream.
   #   @param password [String, nil] Optional password to decrypt password-protected XLSX files.
+  #   @param trim_empty_rows [Boolean] Whether to omit trailing empty rows during sheet 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.
   #   @yield [sheet]
   #   @yieldparam sheet [StreamSheet] The streaming worksheet object.
   #   @return [void]
   #
-  # @overload read(source, password: nil)
+  # @overload read(source, password: nil, trim_empty_rows: false, pad_empty_rows: false, pad_empty_cells: false)
   #   Returns a lazy {Elements::Workbook} object.
   #   @param source [String, IO, StringIO] File path, binary content string, or readable IO stream.
   #   @param password [String, nil] Optional password to decrypt password-protected XLSX files.
+  #   @param trim_empty_rows [Boolean] Whether to omit trailing empty rows during sheet 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.
   #   @return [Elements::Workbook]
   #
   # @example Streaming read across sheets and rows (O(1) constant memory)
@@ -118,22 +282,25 @@ module Xlsxrb
   # @raise [InvalidPasswordError] If the supplied password is incorrect.
   # @raise [ParseError] If the spreadsheet XML structure is invalid.
   # @api public
-  # : (untyped source, ?password: String?) { (StreamSheet) -> void } -> void
-  # : (untyped source, ?password: String?) -> Elements::Workbook
-  def self.read: (untyped source, ?password: String?) { (StreamSheet) -> void } -> void
-               | (untyped source, ?password: String?) -> Elements::Workbook
+  # : (untyped source, ?password: String?, ?trim_empty_rows: bool, ?pad_empty_rows: bool, ?pad_empty_cells: bool) { (StreamSheet) -> void } -> void
+  # : (untyped source, ?password: String?, ?trim_empty_rows: bool, ?pad_empty_rows: bool, ?pad_empty_cells: bool) -> Elements::Workbook
+  def self.read: (untyped source, ?password: String?, ?trim_empty_rows: bool, ?pad_empty_rows: bool, ?pad_empty_cells: bool) { (StreamSheet) -> void } -> void
+               | (untyped source, ?password: String?, ?trim_empty_rows: bool, ?pad_empty_rows: bool, ?pad_empty_cells: bool) -> Elements::Workbook
+
+  alias self.stream self.read
 
   # Writes an XLSX file or IO stream (streaming or in-memory), or returns a binary string.
   #
-  # @overload write(target, password: nil, encryption_mode: :standard, strict_excel_mode: true, &block)
+  # @overload write(?target, password: nil, encryption_mode: :standard, strict_excel_mode: true, &block)
   #   Streaming write: yields a {StreamWriter} context for high-speed, zero-allocation XLSX generation.
-  #   @param target [String, IO, StringIO] Destination file path or writable IO object.
+  #   If target is omitted, returns the generated XLSX as an in-memory binary String.
+  #   @param target [String, IO, StringIO, nil] Optional destination file path or writable IO object.
   #   @param password [String, nil] Optional password to encrypt the generated XLSX file.
   #   @param encryption_mode [Symbol] Encryption algorithm (:standard or :agile).
   #   @param strict_excel_mode [Boolean] Whether to enforce Microsoft Excel specification limits.
   #   @yield [stream_writer]
   #   @yieldparam stream_writer [Xlsxrb::StreamWriter]
-  #   @return [void]
+  #   @return [String, void] Binary data if target is omitted, or void if written to target.
   #
   # @overload write(workbook, password: nil, encryption_mode: :standard)
   #   In-memory write: exports the workbook to an in-memory binary String.
@@ -155,6 +322,11 @@ module Xlsxrb
   #     writer.sheet("Sheet1") { |s| s.row(["Hello", "World"]) }
   #   end
   #
+  # @example Streaming write to in-memory binary string (target omitted)
+  #   binary_data = Xlsxrb.write do |writer|
+  #     writer.sheet("Sheet1") { |s| s.row(["Hello", "World"]) }
+  #   end
+  #
   # @example Password-protected streaming write
   #   Xlsxrb.write("protected.xlsx", password: "SecretPassword123") do |writer|
   #     writer.sheet("Confidential") { |s| s.row(["Private Data", 100]) }
@@ -166,10 +338,10 @@ module Xlsxrb
   # @api public
   # : (Elements::Workbook workbook, ?password: String?, ?encryption_mode: Symbol) -> String
   # : (untyped target, Elements::Workbook | untyped workbook, ?password: String?, ?encryption_mode: Symbol) -> void
-  # : (untyped target_or_workbook, ?Elements::Workbook | untyped workbook_or_nil, ?password: String?, ?encryption_mode: Symbol, ?strict_excel_mode: bool) ?{ (StreamWriter) -> void } -> untyped
+  # : (?untyped target_or_workbook, ?Elements::Workbook | untyped workbook_or_nil, ?password: String?, ?encryption_mode: Symbol, ?strict_excel_mode: bool) ?{ (StreamWriter) -> void } -> untyped
   def self.write: (Elements::Workbook workbook, ?password: String?, ?encryption_mode: Symbol) -> String
                 | (untyped target, Elements::Workbook | untyped workbook, ?password: String?, ?encryption_mode: Symbol) -> void
-                | (untyped target_or_workbook, ?Elements::Workbook | untyped workbook_or_nil, ?password: String?, ?encryption_mode: Symbol, ?strict_excel_mode: bool) ?{ (StreamWriter) -> void } -> untyped
+                | (?untyped target_or_workbook, ?Elements::Workbook | untyped workbook_or_nil, ?password: String?, ?encryption_mode: Symbol, ?strict_excel_mode: bool) ?{ (StreamWriter) -> void } -> untyped
 
   # Modifies an existing XLSX file in-memory using an immutable transformation block.
   #
@@ -213,14 +385,32 @@ module Xlsxrb
   # : (?strict_excel_mode: bool) ?{ (WorkbookBuilder) -> void } -> Elements::Workbook
   def self.build: (?strict_excel_mode: bool) ?{ (WorkbookBuilder) -> void } -> Elements::Workbook
 
-  # : (String name, String? sheet_xml, Array[String] shared_strings, untyped _styles) -> Elements::Worksheet
-  private def self.build_worksheet: (String name, String? sheet_xml, Array[String] shared_strings, untyped _styles) -> Elements::Worksheet
+  # : (String name, String? sheet_xml, Array[String] shared_strings, untyped styles, ?state: Symbol, ?zip_reader: Ooxml::ZipReader?, ?entry_name: String?, ?hyperlinks: Hash[String, untyped]?, ?comments: Array[Hash[Symbol, untyped]]?, ?images: Array[Elements::Image]?, ?date1904: bool, ?dimension: String?, ?trim_empty_rows: bool, ?pad_empty_rows: bool, ?pad_empty_cells: bool, ?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]?) -> Elements::Worksheet
+  private def self.build_worksheet: (String name, String? sheet_xml, Array[String] shared_strings, untyped styles, ?state: Symbol, ?zip_reader: Ooxml::ZipReader?, ?entry_name: String?, ?hyperlinks: Hash[String, untyped]?, ?comments: Array[Hash[Symbol, untyped]]?, ?images: Array[Elements::Image]?, ?date1904: bool, ?dimension: String?, ?trim_empty_rows: bool, ?pad_empty_rows: bool, ?pad_empty_cells: bool, ?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]?) -> Elements::Worksheet
 
-  # : (untyped raw_row) -> (Elements::Row | untyped)
-  private def self.build_row_from_raw: (untyped raw_row) -> (Elements::Row | untyped)
+  # : (String? sheet_xml, ?zip_reader: Ooxml::ZipReader?, ?entry_name: String?, ?rels_xml: String?) -> Hash[String, Hash[Symbol, untyped]]
+  private def self.resolve_hyperlinks: (String? sheet_xml, ?zip_reader: Ooxml::ZipReader?, ?entry_name: String?, ?rels_xml: String?) -> Hash[String, Hash[Symbol, untyped]]
 
-  # : (Elements::Cell cell, Array[String] sst, Hash[String, Integer] sst_index) -> Hash[Symbol, untyped]
-  private def self.build_raw_cell: (Elements::Cell cell, Array[String] sst, Hash[String, Integer] sst_index) -> Hash[Symbol, untyped]
+  # : (String base_dir, String target) -> String
+  private def self.resolve_relative_path: (String base_dir, String target) -> String
+
+  # : (?zip_reader: Ooxml::ZipReader?, ?entry_name: String?) -> Array[Hash[Symbol, untyped]]
+  private def self.resolve_comments: (?zip_reader: Ooxml::ZipReader?, ?entry_name: String?) -> Array[Hash[Symbol, untyped]]
+
+  # : (?zip_reader: Ooxml::ZipReader?, ?entry_name: String?) -> Array[Elements::Image]
+  private def self.resolve_images: (?zip_reader: Ooxml::ZipReader?, ?entry_name: String?) -> Array[Elements::Image]
+
+  # : (?zip_reader: Ooxml::ZipReader?, ?entry_name: String?) -> Array[Hash[Symbol, untyped]]
+  private def self.resolve_tables: (?zip_reader: Ooxml::ZipReader?, ?entry_name: String?) -> Array[Hash[Symbol, untyped]]
+
+  # : (?zip_reader: Ooxml::ZipReader?, ?entry_name: String?) -> Array[Hash[Symbol, untyped]]
+  private def self.resolve_shapes: (?zip_reader: Ooxml::ZipReader?, ?entry_name: String?) -> Array[Hash[Symbol, untyped]]
+
+  # : (untyped raw_row, ?Hash[String, Hash[Symbol, untyped]] hyperlinks, ?(Array[Hash[Symbol, untyped]] | Hash[String, Hash[Symbol, untyped]]) comments, ?Hash[untyped, untyped]? styles, ?date1904: bool) -> (Elements::Row | untyped)
+  private def self.build_row_from_raw: (untyped raw_row, ?Hash[String, Hash[Symbol, untyped]] hyperlinks, ?Array[Hash[Symbol, untyped]] | Hash[String, Hash[Symbol, untyped]] comments, ?Hash[untyped, untyped]? styles, ?date1904: bool) -> (Elements::Row | untyped)
+
+  # : (Elements::Cell cell, Array[String] sst, Hash[String, Integer] sst_index, ?date1904: bool) -> Hash[Symbol, untyped]
+  private def self.build_raw_cell: (Elements::Cell cell, Array[String] sst, Hash[String, Integer] sst_index, ?date1904: bool) -> Hash[Symbol, untyped]
 
   # : (Elements::Row row) -> Hash[Symbol, untyped]
   private def self.build_row_attrs: (Elements::Row row) -> Hash[Symbol, untyped]
@@ -240,8 +430,14 @@ module Xlsxrb
   # : (String sheet_xml, Array[Elements::Row] rows) -> String
   private def self.update_dimension: (String sheet_xml, Array[Elements::Row] rows) -> String
 
-  # : (Array[Elements::Row] rows, Array[untyped] shared_strings, Hash[untyped, Integer] sst_index, ?use_sst: bool) -> String
-  private def self.serialize_sheet_data_xml: (Array[Elements::Row] rows, Array[untyped] shared_strings, Hash[untyped, Integer] sst_index, ?use_sst: bool) -> String
+  # : (String sheet_xml, String? orig_rels_xml, Hash[String, untyped] new_hyperlinks) -> [String, String?]
+  private def self.update_sheet_hyperlinks: (String sheet_xml, String? orig_rels_xml, Hash[String, untyped] new_hyperlinks) -> [ String, String? ]
+
+  # : (String sheet_xml, String _rels_path, String? orig_rels_xml, Array[Hash[Symbol, untyped]] new_comments, Ooxml::ZipReader zip_reader, Integer sheet_idx, String entry_name, Hash[String, String] replaced_entries) -> [String, String?]
+  private def self.update_sheet_comments: (String sheet_xml, String _rels_path, String? orig_rels_xml, Array[Hash[Symbol, untyped]] new_comments, Ooxml::ZipReader zip_reader, Integer sheet_idx, String entry_name, Hash[String, String] replaced_entries) -> [ String, String? ]
+
+  # : (Array[Elements::Row] rows, Array[untyped] shared_strings, Hash[untyped, Integer] sst_index, ?use_sst: bool, ?date1904: bool) -> String
+  private def self.serialize_sheet_data_xml: (Array[Elements::Row] rows, Array[untyped] shared_strings, Hash[untyped, Integer] sst_index, ?use_sst: bool, ?date1904: bool) -> String
 
   # Builds a raw cell hash from a value for streaming writes.
   #
@@ -252,6 +448,6 @@ module Xlsxrb
   # @param sst_index [Hash{String => Integer}] Shared strings index mapping.
   # @return [Hash{Symbol => Object}] Raw cell hash.
   # @api public
-  # : (Integer row_index, Integer col_index, untyped value, Array[String] sst, Hash[String, Integer] sst_index) -> Hash[Symbol, untyped]
-  def self.build_raw_cell_from_value: (Integer row_index, Integer col_index, untyped value, Array[String] sst, Hash[String, Integer] sst_index) -> Hash[Symbol, untyped]
+  # : (Integer row_index, Integer col_index, untyped value, Array[String] sst, Hash[String, Integer] sst_index, ?date1904: bool) -> Hash[Symbol, untyped]
+  def self.build_raw_cell_from_value: (Integer row_index, Integer col_index, untyped value, Array[String] sst, Hash[String, Integer] sst_index, ?date1904: bool) -> Hash[Symbol, untyped]
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: xlsxrb
 version: !ruby/object:Gem::Version
-  version: 0.1.13
+  version: 0.1.15
 platform: ruby
 authors:
 - niku
@@ -53,15 +53,19 @@ files:
 - lib/ruby_lsp/xlsxrb/completion_listener.rb
 - lib/xlsxrb.rb
 - lib/xlsxrb/chart_builder.rb
+- lib/xlsxrb/colors.rb
 - lib/xlsxrb/dsl_helpers.rb
 - lib/xlsxrb/elements.rb
 - lib/xlsxrb/elements/cell.rb
 - lib/xlsxrb/elements/column.rb
 - lib/xlsxrb/elements/coordinate_access.rb
+- lib/xlsxrb/elements/image.rb
 - lib/xlsxrb/elements/row.rb
+- lib/xlsxrb/elements/styles.rb
 - lib/xlsxrb/elements/types.rb
 - lib/xlsxrb/elements/workbook.rb
 - lib/xlsxrb/elements/worksheet.rb
+- lib/xlsxrb/number_formatter.rb
 - lib/xlsxrb/ooxml.rb
 - lib/xlsxrb/ooxml/cfb.rb
 - lib/xlsxrb/ooxml/crypto.rb
@@ -93,20 +97,25 @@ files:
 - lib/xlsxrb/stream_sheet.rb
 - lib/xlsxrb/stream_writer.rb
 - lib/xlsxrb/style_builder.rb
+- lib/xlsxrb/utils.rb
 - lib/xlsxrb/version.rb
 - lib/xlsxrb/workbook_builder.rb
 - lib/xlsxrb/worksheet_builder.rb
 - sig/generated/xlsxrb.rbs
 - sig/generated/xlsxrb/chart_builder.rbs
+- sig/generated/xlsxrb/colors.rbs
 - sig/generated/xlsxrb/dsl_helpers.rbs
 - sig/generated/xlsxrb/elements.rbs
 - sig/generated/xlsxrb/elements/cell.rbs
 - sig/generated/xlsxrb/elements/column.rbs
 - sig/generated/xlsxrb/elements/coordinate_access.rbs
+- sig/generated/xlsxrb/elements/image.rbs
 - sig/generated/xlsxrb/elements/row.rbs
+- sig/generated/xlsxrb/elements/styles.rbs
 - sig/generated/xlsxrb/elements/types.rbs
 - sig/generated/xlsxrb/elements/workbook.rbs
 - sig/generated/xlsxrb/elements/worksheet.rbs
+- sig/generated/xlsxrb/number_formatter.rbs
 - sig/generated/xlsxrb/ooxml.rbs
 - sig/generated/xlsxrb/ooxml/cfb.rbs
 - sig/generated/xlsxrb/ooxml/crypto.rbs
@@ -138,6 +147,7 @@ files:
 - sig/generated/xlsxrb/stream_sheet.rbs
 - sig/generated/xlsxrb/stream_writer.rbs
 - sig/generated/xlsxrb/style_builder.rbs
+- sig/generated/xlsxrb/utils.rbs
 - sig/generated/xlsxrb/version.rbs
 - sig/generated/xlsxrb/workbook_builder.rbs
 - sig/generated/xlsxrb/worksheet_builder.rbs