xlsxrb 0.1.13 → 0.1.14

data/sig/generated/xlsxrb/colors.rbs

@@ -0,0 +1,40 @@
+# Generated from lib/xlsxrb/colors.rb with RBS::Inline
+
+module Xlsxrb
+  # ECMA-376 Part 4 §18.8.27 Standard Indexed Color Palette and utilities.
+  module Colors
+    # Standard ECMA-376 indexed colors (indices 0 through 63 as 6-character RRGGBB hex strings).
+    # Indices 8 through 63 represent the classic 56-color palette.
+    INDEXED_COLORS: untyped
+
+    # Resolves a palette index (0..63) to an RRGGBB hex string (or AARRGGBB if alpha: true).
+    #
+    # @example
+    #   Xlsxrb::Colors.palette_color(12)               #=> "0000FF"
+    #   Xlsxrb::Colors.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::Colors.to_hex(12)                      #=> "0000FF"
+    #   Xlsxrb::Colors.to_hex(12, alpha: true)         #=> "FF0000FF"
+    #   Xlsxrb::Colors.to_hex(:navy)                   #=> "000080"
+    #   Xlsxrb::Colors.to_hex("#FF0000")               #=> "FF0000"
+    #   Xlsxrb::Colors.to_hex(0xFF0000)                #=> "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: (Integer | String | Symbol | nil color, ?alpha: bool) -> String?
+  end
+end

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

@@ -28,6 +28,16 @@ module Xlsxrb
 
       attr_reader errors: untyped
 
+      attr_reader hyperlink: untyped
+
+      attr_reader comment: untyped
+
+      attr_reader raw_value: untyped
+
+      attr_reader format_code: untyped
+
+      attr_reader date1904: untyped
+
       # @param row_index [Integer] 0-based row index.
       # @param column_index [Integer] 0-based column index.
       # @param value [Object, nil] The cell's value.
@@ -35,10 +45,16 @@ module Xlsxrb
       # @param style_index [Integer, String, nil] Style identifier.
       # @param unmapped_data [Hash] Additional metadata.
       # @param errors [Array<String>, nil] Validation errors.
-      # : (row_index: untyped, column_index: untyped, ?value: untyped, ?formula: (Elements::Formula | String)?, ?style_index: (Integer | String)?, ?unmapped_data: Hash[untyped, untyped], ?errors: Array[String]?) -> void
-      def initialize: (row_index: untyped, column_index: untyped, ?value: untyped, ?formula: (Elements::Formula | String)?, ?style_index: (Integer | String)?, ?unmapped_data: Hash[untyped, untyped], ?errors: Array[String]?) -> void
+      # @param hyperlink [Hash, String, Elements::Hyperlink, nil] Optional hyperlink metadata or URL.
+      # @param comment [Hash, String, nil] Optional cell comment or note.
+      # @param raw_value [String, nil] Optional unparsed raw string value.
+      # @param format_code [String, nil] Optional OpenXML number/date format code.
+      # @param date1904 [Boolean] Whether the cell belongs to a 1904 date system workbook.
+      # : (row_index: untyped, column_index: untyped, ?value: untyped, ?formula: (Elements::Formula | String)?, ?style_index: (Integer | String)?, ?unmapped_data: Hash[untyped, untyped], ?errors: Array[String]?, ?hyperlink: (Hash[Symbol, untyped] | String | Elements::Hyperlink)?, ?comment: (Hash[Symbol, untyped] | String)?, ?raw_value: String?, ?format_code: String?, ?date1904: bool) -> void
+      def initialize: (row_index: untyped, column_index: untyped, ?value: untyped, ?formula: (Elements::Formula | String)?, ?style_index: (Integer | String)?, ?unmapped_data: Hash[untyped, untyped], ?errors: Array[String]?, ?hyperlink: (Hash[Symbol, untyped] | String | Elements::Hyperlink)?, ?comment: (Hash[Symbol, untyped] | String)?, ?raw_value: String?, ?format_code: String?, ?date1904: bool) -> void
 
-      def self.fast_create: (untyped row_index, untyped column_index, untyped value, ?untyped style_index, ?untyped formula) -> untyped
+      # rubocop:disable Style/OptionalBooleanParameter
+      def self.fast_create: (untyped row_index, untyped column_index, untyped value, ?untyped style_index, ?untyped formula, ?untyped raw_value, ?untyped format_code, ?untyped date1904) -> untyped
 
       def ==: (untyped other) -> untyped
 
@@ -65,14 +81,101 @@ module Xlsxrb
       # : () -> String
       def ref: () -> String
 
+      # Returns whether the cell contains a formula.
+      #
+      # @return [Boolean]
+      # @api public
+      # : () -> bool
+      def formula?: () -> bool
+
+      # Returns the formula expression string without leading '=', or nil.
+      #
+      # @return [String, nil]
+      # @api public
+      # : () -> String?
+      def formula_expression: () -> String?
+
+      # Returns whether the cell contains a hyperlink.
+      #
+      # @return [Boolean]
+      # @api public
+      # : () -> bool
+      def link?: () -> bool
+
+      alias hyperlink? link?
+
+      # Returns the hyperlink target URL or location string, or nil.
+      #
+      # @return [String, nil]
+      # @api public
+      # : () -> String?
+      def url: () -> String?
+
+      # Returns the hyperlink tooltip (ScreenTip) text, or nil.
+      #
+      # @return [String, nil]
+      # @api public
+      # : () -> String?
+      def tooltip: () -> String?
+
+      # Returns whether the cell contains a comment or note.
+      #
+      # @return [Boolean]
+      # @api public
+      # : () -> bool
+      def comment?: () -> bool
+
+      # Returns the plain text of the cell comment or note, or nil.
+      #
+      # @return [String, nil]
+      # @api public
+      # : () -> String?
+      def comment_text: () -> String?
+
+      # Returns the formatted string representation of the cell value according to its format code.
+      #
+      # @param custom_format_code [String, nil] Optional format code override.
+      # @return [String, nil]
+      # @api public
+      # : (?String? custom_format_code) -> String?
+      def formatted_value: (?String? custom_format_code) -> String?
+
       # Access cell attributes by Symbol key.
       #
-      # @param key [Symbol] Attribute key (:value, :formula, :style_index, :ref, :column_index, :row_index, :type).
+      # @param key [Symbol] Attribute key (:value, :formula, :style_index, :ref, :column_index, :row_index, :type, :raw_value, :format_code, :formatted_value).
       # @return [Object, nil]
       # @api public
       # : (Symbol key) -> untyped
       def []: (Symbol key) -> untyped
 
+      # Returns the classified format category for this cell (:date, :datetime, :time, :number, :text, :general, or nil).
+      #
+      # @return [Symbol, nil]
+      # @api public
+      # : () -> Symbol?
+      def format_type: () -> Symbol?
+
+      # Returns whether the cell has a date, datetime, or time format.
+      #
+      # @return [Boolean]
+      # @api public
+      # : () -> bool
+      def date_format?: () -> bool
+
+      # Returns whether the cell has a time-only format.
+      #
+      # @return [Boolean]
+      # @api public
+      # : () -> bool
+      def time_format?: () -> bool
+
+      # Returns whether the cell's workbook uses the 1904 date system.
+      #
+      # @return [Boolean]
+      # @api public
+      # : () -> bool
+      def date1904?: () -> bool
+
       # Returns the cell value.
       #
       # @return [Object, nil]
@@ -103,17 +206,19 @@ module Xlsxrb
 
       # Converts the cell value (numeric serial date or date string) to Date.
       #
+      # @param date1904 [Boolean, nil] Whether to use the 1904 date system (defaults to cell's date1904 setting).
       # @return [Date, nil]
       # @api public
-      # : () -> Date?
-      def to_date: () -> Date?
+      # : (?date1904: bool?) -> Date?
+      def to_date: (?date1904: bool?) -> Date?
 
       # Converts the cell value (numeric serial datetime or datetime string) to Time.
       #
+      # @param date1904 [Boolean, nil] Whether to use the 1904 date system (defaults to cell's date1904 setting).
       # @return [Time, nil]
       # @api public
-      # : () -> Time?
-      def to_time: () -> Time?
+      # : (?date1904: bool?) -> Time?
+      def to_time: (?date1904: bool?) -> Time?
 
       # Pure calculation: converts a 0-based column index to an Excel letter.
       #

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

@@ -17,10 +17,11 @@ module Xlsxrb
       # @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 style_index [Integer, String, nil] Optional style identifier.
       # @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
+      # : (index: Integer, ?width: Float | Integer | nil, ?hidden: bool, ?custom_width: bool, ?outline_level: Integer | nil, ?style_index: (Integer | String)?, ?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, ?style_index: (Integer | String)?, ?unmapped_data: Hash[untyped, untyped], ?errors: Array[String]?) -> void
 
       # Returns whether the column definition is valid according to OOXML specifications.
       #

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

@@ -55,6 +55,24 @@ module Xlsxrb
       # : () -> Elements::Row?
       def last_row: () -> Elements::Row?
 
+      # Returns the 1-based index of the first column containing data, or nil.
+      #
+      # @return [Integer, nil]
+      # @api public
+      # : () -> Integer?
+      def first_column: () -> Integer?
+
+      alias first_col first_column
+
+      # Returns the 1-based index of the last column containing data, or nil.
+      #
+      # @return [Integer, nil]
+      # @api public
+      # : () -> Integer?
+      def last_column: () -> Integer?
+
+      alias last_col last_column
+
       # Returns the raw cell value at the given Excel-style reference (e.g. "A1").
       #
       # @example

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

@@ -0,0 +1,82 @@
+# Generated from lib/xlsxrb/elements/image.rb with RBS::Inline
+
+module Xlsxrb
+  module Elements
+    # Represents an embedded image anchored to worksheet cells.
+    # Coordinates (from_row, from_col, to_row, to_col) are 0-based.
+    #
+    # @example Access image properties
+    #   image = sheet.images.first
+    #   image.filename       #=> "image1.png"
+    #   image.cell_ref       #=> "B3"
+    #   image.content_type   #=> "image/png"
+    #   image.data           #=> "\x89PNG..."
+    #
+    # @api public
+    class Image
+      MIME_TYPES: untyped
+
+      # @param filename [String] Target filename (e.g. "image1.png").
+      # @param name [String, nil] Image or shape name.
+      # @param content_type [String, nil] MIME content type (e.g. "image/png").
+      # @param data [String, nil] Raw binary image data.
+      # @param from_col [Integer] 0-based starting column index.
+      # @param from_row [Integer] 0-based starting row index.
+      # @param to_col [Integer, nil] 0-based ending column index (nil for 1-cell anchor).
+      # @param to_row [Integer, nil] 0-based ending row index (nil for 1-cell anchor).
+      # @param cx [Integer, nil] Extent width in EMUs (English Metric Units).
+      # @param cy [Integer, nil] Extent height in EMUs (English Metric Units).
+      # @param unmapped_data [Hash] Additional metadata from drawing XML.
+      # : (filename: String, ?name: String?, ?content_type: String?, ?data: String?, ?from_col: Integer, ?from_row: Integer, ?to_col: Integer?, ?to_row: Integer?, ?cx: Integer?, ?cy: Integer?, ?unmapped_data: Hash[untyped, untyped]) -> void
+      # rubocop:disable Naming/MethodParameterName
+      def initialize: (filename: String, ?name: String?, ?content_type: String?, ?data: String?, ?from_col: Integer, ?from_row: Integer, ?to_col: Integer?, ?to_row: Integer?, ?cx: Integer?, ?cy: Integer?, ?unmapped_data: Hash[untyped, untyped]) -> void
+
+      # Returns the top-left cell coordinate reference string (e.g. "A1").
+      #
+      # @return [String]
+      # @api public
+      # : () -> String
+      def cell_ref: () -> String
+
+      alias cell cell_ref
+
+      alias ref cell_ref
+
+      # Returns the bottom-right cell coordinate reference string (e.g. "B5"), or nil for 1-cell anchors.
+      #
+      # @return [String, nil]
+      # @api public
+      # : () -> String?
+      def to_cell_ref: () -> String?
+
+      # Returns whether this image uses a one-cell anchor.
+      #
+      # @return [Boolean]
+      # @api public
+      # : () -> bool
+      def one_cell_anchor?: () -> bool
+
+      # Returns whether this image uses a two-cell anchor.
+      #
+      # @return [Boolean]
+      # @api public
+      # : () -> bool
+      def two_cell_anchor?: () -> bool
+
+      # Returns the size of the binary image data in bytes.
+      #
+      # @return [Integer]
+      # @api public
+      # : () -> Integer
+      def bytesize: () -> Integer
+
+      # Writes the image data directly to a file on disk.
+      #
+      # @param path [String] Target file path.
+      # @return [Integer] Number of bytes written.
+      # @api public
+      # : (String path) -> Integer
+      def write_to: (String path) -> Integer
+    end
+  end
+end

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

@@ -18,11 +18,12 @@ module Xlsxrb
       # @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 collapsed [Boolean] Whether the row is collapsed.
       # @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
+      # : (index: Integer, ?cells: Array[Elements::Cell], ?height: Float | Integer | nil, ?hidden: bool, ?custom_height: bool, ?collapsed: 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, ?collapsed: bool, ?outline_level: Integer | nil, ?unmapped_data: Hash[untyped, untyped], ?errors: Array[String]?) -> void
 
       # Access a cell by 0-based column index, or access row attributes via Symbol.
       #
@@ -37,6 +38,55 @@ module Xlsxrb
       # : (Integer | Symbol col_index) -> untyped
       def []: (Integer | Symbol col_index) -> untyped
 
+      # Returns a new Row with missing cells padded up to the maximum column index.
+      #
+      # @return [Elements::Row]
+      # @api public
+      # : () -> Elements::Row
+      def pad_empty_cells: () -> Elements::Row
+
+      # Returns a coordinate-keyed Hash of cell values (e.g. {"A1" => "value", "B1" => 123}).
+      #
+      # @param type_cast [Boolean] Whether to coerce date/time serial numbers into Date/Time instances.
+      # @return [Hash{String => Object}]
+      # @api public
+      # : (?type_cast: bool) -> Hash[String, untyped]
+      def cells_hash: (?type_cast: bool) -> Hash[String, untyped]
+
+      # Returns whether the row is hidden.
+      #
+      # @return [Boolean]
+      # @api public
+      # : () -> bool
+      def hidden?: () -> bool
+
+      # Returns whether the row is collapsed.
+      #
+      # @return [Boolean]
+      # @api public
+      # : () -> bool
+      def collapsed?: () -> bool
+
+      # Returns whether custom height is set.
+      #
+      # @return [Boolean]
+      # @api public
+      # : () -> bool
+      def custom_height?: () -> bool
+
+      # Returns a frozen Hash of row attributes.
+      #
+      # @return [Hash{Symbol => Object}]
+      # @api public
+      # : () -> Hash[Symbol, untyped]
+      def attributes: () -> Hash[Symbol, untyped]
+
+      # Returns style_index if present in unmapped_data.
+      #
+      # @return [Integer, nil]
+      # : () -> Integer?
+      def style_index: () -> Integer?
+
       # Iterate over cells in this row.
       #
       # @example
@@ -85,6 +135,13 @@ module Xlsxrb
       # : () -> bool
       def valid?: () -> bool
 
+      # Returns whether the row contains no cell values (or all cell values are nil or empty strings).
+      #
+      # @return [Boolean]
+      # @api public
+      # : () -> bool
+      def empty?: () -> bool
+
       # Returns the cell at the given 0-based column index, or nil.
       #
       # @param column_index [Integer] 0-based column index.
@@ -95,10 +152,32 @@ module Xlsxrb
 
       # Returns cell values as an Array (sparse columns get nil).
       #
+      # @param type_cast [Boolean] Whether to coerce date/time serial numbers into Date/Time instances.
       # @return [Array<Object>]
       # @api public
-      # : () -> Array[untyped]
-      def values: () -> Array[untyped]
+      # : (?type_cast: bool) -> Array[untyped]
+      def values: (?type_cast: bool) -> Array[untyped]
+
+      # Returns unparsed raw cell values as an Array (sparse columns get nil).
+      #
+      # @return [Array<String, nil>]
+      # @api public
+      # : () -> Array[String?]
+      def raw_values: () -> Array[String?]
+
+      # Returns formatted string representations of cell values as an Array (sparse columns get nil).
+      #
+      # @return [Array<String, nil>]
+      # @api public
+      # : () -> Array[String?]
+      def formatted_values: () -> Array[String?]
+
+      # Returns formula expressions without leading '=' as an Array (sparse columns get nil).
+      #
+      # @return [Array<String, nil>]
+      # @api public
+      # : () -> Array[String?]
+      def formulas: () -> Array[String?]
 
       # Returns whether the row index is within valid OOXML range (0..1048575).
       #

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

@@ -0,0 +1,79 @@
+# Generated from lib/xlsxrb/elements/styles.rb with RBS::Inline
+
+module Xlsxrb
+  module Elements
+    # Represents the workbook stylesheet definitions (fonts, fills, borders, cellXfs, and numFmts).
+    # Inherits from Hash for backward compatibility with existing styles hash structures,
+    # while providing precomputed O(1) number format classifications.
+    #
+    # @api public
+    class Styles < Hash[untyped, untyped]
+      # Initializes the styles container, optionally wrapping an existing styles hash.
+      #
+      # @param initial_hash [Hash, nil] Initial styles dictionary.
+      # : (?Hash[untyped, untyped]? initial_hash) -> void
+      def initialize: (?Hash[untyped, untyped]? initial_hash) -> void
+
+      # Returns the format code string for a given style index.
+      #
+      # @param style_index [Integer, nil]
+      # @return [String, nil]
+      # @api public
+      # : (Integer? style_index) -> String?
+      def number_format: (Integer? style_index) -> String?
+
+      alias format_code number_format
+
+      alias format_code_for number_format
+
+      # Returns the classified format category (:date, :datetime, :time, :number, :text, :general) for a style index.
+      #
+      # @param style_index [Integer, nil]
+      # @return [Symbol, nil]
+      # @api public
+      # : (Integer? style_index) -> Symbol?
+      def format_type: (Integer? style_index) -> Symbol?
+
+      alias classification_for format_type
+
+      # Returns whether the style index represents a date, datetime, or time pattern.
+      #
+      # @param style_index [Integer, nil]
+      # @return [Boolean]
+      # @api public
+      # : (Integer? style_index) -> bool
+      def date_format?: (Integer? style_index) -> bool
+
+      # Returns whether the style index represents a datetime pattern.
+      #
+      # @param style_index [Integer, nil]
+      # @return [Boolean]
+      # @api public
+      # : (Integer? style_index) -> bool
+      def datetime_format?: (Integer? style_index) -> bool
+
+      # Returns whether the style index represents a time pattern.
+      #
+      # @param style_index [Integer, nil]
+      # @return [Boolean]
+      # @api public
+      # : (Integer? style_index) -> bool
+      def time_format?: (Integer? style_index) -> bool
+
+      # Returns whether the style index represents a date-only pattern.
+      #
+      # @param style_index [Integer, nil]
+      # @return [Boolean]
+      # @api public
+      # : (Integer? style_index) -> bool
+      def date_only_format?: (Integer? style_index) -> bool
+
+      # Precomputes format code and type classification lookups for all cellXfs.
+      #
+      # @return [self]
+      # @api public
+      # : () -> self
+      def precompute!: () -> self
+    end
+  end
+end

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

@@ -62,6 +62,25 @@ module Xlsxrb
       def members: () -> [ :code ]
     end
 
+    # Represents a formatted text run within a rich text string.
+    #
+    # @example
+    #   run = Elements::RichTextRun.new(text: "Hello", font: { bold: true })
+    #
+    # @api public
+    class RichTextRun < Data
+      attr_reader text(): untyped
+
+      attr_reader font(): untyped
+
+      def self.new: (untyped text, untyped font) -> instance
+                  | (text: untyped, font: untyped) -> instance
+
+      def self.members: () -> [ :text, :font ]
+
+      def members: () -> [ :text, :font ]
+    end
+
     # Represents a rich text string with multiple formatting runs.
     #
     # @example
@@ -78,5 +97,29 @@ module Xlsxrb
 
       def members: () -> [ :runs ]
     end
+
+    # Represents a worksheet hyperlink with an optional target URL, display text, tooltip (ScreenTip), and internal location.
+    #
+    # @example Create a hyperlink
+    #   link = Elements::Hyperlink.new(url: "https://example.com", tooltip: "Visit website")
+    #
+    # @api public
+    # rubocop:disable Lint/DataDefineOverride -- :display represents the hyperlink display text attribute in OOXML
+    class Hyperlink < Data
+      attr_reader url(): untyped
+
+      attr_reader display(): untyped
+
+      attr_reader tooltip(): untyped
+
+      attr_reader location(): untyped
+
+      def self.new: (untyped url, untyped display, untyped tooltip, untyped location) -> instance
+                  | (url: untyped, display: untyped, tooltip: untyped, location: untyped) -> instance
+
+      def self.members: () -> [ :url, :display, :tooltip, :location ]
+
+      def members: () -> [ :url, :display, :tooltip, :location ]
+    end
   end
 end

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

@@ -17,8 +17,10 @@ module Xlsxrb
       # @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
+      # @param defined_names [Array<Hash>, nil] Defined names list.
+      # @param date1904 [Boolean] Whether the workbook uses the 1904 date system.
+      # : (?sheets: Array[Elements::Worksheet | StreamSheet], ?shared_strings: Array[String], ?styles: Hash[untyped, untyped], ?unmapped_data: Hash[untyped, untyped], ?errors: Array[String]?, ?defined_names: Array[Hash[Symbol, untyped]]?, ?date1904: bool) -> void
+      def initialize: (?sheets: Array[Elements::Worksheet | StreamSheet], ?shared_strings: Array[String], ?styles: Hash[untyped, untyped], ?unmapped_data: Hash[untyped, untyped], ?errors: Array[String]?, ?defined_names: Array[Hash[Symbol, untyped]]?, ?date1904: bool) -> void
 
       # Iterate over worksheets.
       #
@@ -43,6 +45,26 @@ module Xlsxrb
       # : () -> bool
       def valid?: () -> bool
 
+      # Returns whether the workbook uses the 1904 date system.
+      #
+      # @return [Boolean]
+      # @api public
+      # : () -> bool
+      def date1904?: () -> bool
+
+      # Returns the defined name matching name (and optionally sheet), or nil.
+      #
+      # @example
+      #   wb.defined_name("SalesTotal")
+      #   wb.defined_name("Print_Area", sheet: "Sheet1")
+      #
+      # @param name [String] The defined name.
+      # @param sheet [String, Integer, nil] Optional sheet name or 0-based index.
+      # @return [Hash[Symbol, untyped], nil]
+      # @api public
+      # : (String name, ?sheet: (String | Integer)?) -> Hash[Symbol, untyped]?
+      def defined_name: (String name, ?sheet: (String | Integer)?) -> Hash[Symbol, untyped]?
+
       # Returns the worksheet at the given 0-based index or by name.
       #
       # @example
@@ -57,6 +79,33 @@ module Xlsxrb
 
       alias [] sheet
 
+      # Returns the formatted string representation of a cell's value in the specified sheet.
+      #
+      # @param sheet_identifier [Integer, String, untyped] 0-based index or sheet name.
+      # @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
+      # : (Integer | String | untyped sheet_identifier, String | Symbol | Integer ref_or_row, ?Integer? col) -> String?
+      def formatted_value: (Integer | String | untyped sheet_identifier, String | Symbol | Integer ref_or_row, ?Integer? col) -> String?
+
+      # Returns all embedded images across all worksheets.
+      #
+      # @return [Array<Elements::Image>]
+      # @api public
+      # : () -> Array[Elements::Image]
+      def images: () -> Array[Elements::Image]
+
+      # Returns all images anchored at a specific cell in the given worksheet.
+      #
+      # @param sheet_identifier [Integer, String, untyped] Sheet index or sheet name.
+      # @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
+      # : (Integer | String | untyped sheet_identifier, String | Symbol | Integer ref_or_row, ?Integer? col) -> Array[Elements::Image]
+      def images_at: (Integer | String | untyped sheet_identifier, String | Symbol | Integer ref_or_row, ?Integer? col) -> Array[Elements::Image]
+
       # Loads all sheets into memory, returning an Elements::Workbook where every
       # worksheet is a fully-parsed Elements::Worksheet supporting coordinate random access.
       #