xlsxrb 0.1.14 → 0.1.16

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

@@ -10,6 +10,8 @@ module Xlsxrb
 
       EMPTY_HASH: untyped
 
+      EMPTY_BINARY: untyped
+
       TAG_DELIM_BYTES: untyped
 
       ROW_ATTR_START_BYTES: untyped
@@ -47,8 +49,22 @@ module Xlsxrb
 
       def self.extract_inline_text: (untyped xml, untyped from, untyped to) -> untyped
 
+      STRICT_NUMERIC_RE: ::Regexp
+
+      # Resolves a cell value from its type attribute and parsed XML content (<v> or <is>).
+      # Consolidates parsing across fast-scan direct, row values, events, and listener paths.
+      # : (String? type, String? raw_value, String? is_xml, Array[String | Elements::RichText | untyped] shared_strings) -> untyped
+      def self.resolve_cell_value: (String? type, String? raw_value, String? is_xml, Array[String | Elements::RichText | untyped] shared_strings) -> untyped
+
       def self.resolve_fast_value: (untyped raw, untyped type, untyped shared_strings) -> untyped
 
+      # Converts the text of a numeric cell (<c t="n">) into an Integer or Float.
+      # An empty <v></v> carries no value and yields nil. Text that is not an xsd:double
+      # (e.g. "abc") cannot come from a conforming producer and raises ParseError
+      # instead of silently becoming 0.
+      # : (String raw) -> (Integer | Float)?
+      def self.numeric_cell_value: (String raw) -> (Integer | Float)?
+
       # SECURITY NOTE: Decodes only standard predefined XML entities in a single pass.
       # This completely prevents "Billion Laughs" attacks (exponential entity expansion)
       # because it avoids recursive expansion and ignores custom entities entirely.
@@ -99,8 +115,8 @@ module Xlsxrb
       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]
+      # : (String xml, Integer from, Integer to, Array[String | Elements::RichText | untyped] 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 | Elements::RichText | untyped] 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, ?date1904: untyped) -> untyped
+      attr_accessor escape_formulas: untyped
+
+      def initialize: (untyped io, ?date1904: untyped, ?escape_formulas: untyped) -> untyped
 
       def set_column_style: (untyped col_index, untyped style_id) -> untyped
 
@@ -24,7 +26,7 @@ module Xlsxrb
       #   split_pane: { x_split:, y_split:, top_left_cell: }
       #   selection: { active_cell:, sqref:, pane: }
       #   sheet_view: Hash of sheet view properties
-      def start: (?columns: untyped, ?sheet_properties: untyped, ?freeze_pane: untyped, ?split_pane: untyped, ?selection: untyped, ?sheet_view: untyped) -> untyped
+      def start: (?columns: untyped, ?sheet_properties: untyped, ?freeze_pane: untyped, ?split_pane: untyped, ?selection: untyped, ?sheet_view: untyped, ?sheet_format: untyped) -> untyped
 
       # Write a single row. Automatically calls start if needed.
       def write_row: (untyped row_index, untyped cells, ?attrs: untyped, ?unmapped: untyped, ?sst_index: untyped) -> untyped
@@ -34,16 +36,22 @@ module Xlsxrb
 
       # Write the worksheet footer. Call once after all rows.
       # Options for post-sheetData elements (in OOXML order):
-      def finish: (?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, ?tables: untyped, ?table_start_rid: untyped, ?legacy_drawing_rid: untyped, ?sparkline_groups: untyped) -> untyped
+      def finish: (?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, ?tables: untyped, ?table_start_rid: untyped, ?legacy_drawing_rid: untyped, ?sparkline_groups: untyped) -> untyped
 
       private
 
+      def resolve_style_id: (untyped style, untyped style_map) -> untyped
+
       def write_sheet_properties: (untyped props) -> untyped
 
       def write_sheet_views: (?freeze_pane: untyped, ?split_pane: untyped, ?selection: untyped, ?sheet_view: untyped) -> untyped
 
+      def write_sheet_format_pr: (untyped fmt) -> untyped
+
       def write_sheet_protection: (untyped opts) -> untyped
 
+      def write_protected_ranges: (untyped ranges) -> untyped
+
       def write_auto_filter: (untyped range, untyped filter_columns, untyped sort_state) -> untyped
 
       def write_filter_column: (untyped col_id, untyped filter) -> untyped
@@ -68,6 +76,8 @@ module Xlsxrb
 
       def write_col_breaks: (untyped breaks) -> untyped
 
+      def write_cell_watches: (untyped watches) -> untyped
+
       def write_table_parts: (untyped tables, untyped start_rid) -> untyped
 
       def write_sparklines: (untyped groups) -> untyped

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

@@ -14,7 +14,10 @@ module Xlsxrb
         # : (untyped protection) -> ::String
         def emit_protection_xml: (untyped protection) -> untyped
 
-        # : (untyped source, ?tag: ::String) -> (::String | ::String | ::String | ::String | "")
+        # : (untyped rgb) -> ::String?
+        def format_rgb_hex: (untyped rgb) -> untyped
+
+        # : (untyped source, ?tag: ::String) -> ::String
         def emit_color_xml: (untyped source, ?tag: untyped) -> untyped
 
         # : (untyped font) -> untyped
@@ -23,7 +26,7 @@ module Xlsxrb
         # : (untyped fill) -> (untyped | ::String)
         def emit_fill_xml: (untyped fill) -> untyped
 
-        # : (untyped tag, untyped fill, untyped prefix) -> (::String | ::String | ::String | ::String | "")
+        # : (untyped tag, untyped fill, untyped prefix) -> ::String
         def emit_fill_color_xml: (untyped tag, untyped fill, untyped prefix) -> untyped
 
         # : (untyped gradient) -> untyped

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

@@ -46,7 +46,12 @@ module Xlsxrb
       # : (untyped value) -> String
       def self.escape: (untyped value) -> String
 
-      # Unescapes predefined XML entities in a string in a single pass.
+      NUM_ENTITY_RE: ::Regexp
+
+      XSTRING_RE: ::Regexp
+
+      # Unescapes predefined and numeric/hex XML entities, as well as
+      # ISO/IEC 29500-1 ST_Xstring (_xHHHH_) control character sequences.
       #
       # @param value [Object]
       # @return [String]

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

@@ -41,8 +41,8 @@ module Xlsxrb
 
         attr_reader compression_method: untyped
 
-        # : (untyped io, Integer data_offset, Integer compressed_size, Integer compression_method, ?max_uncompressed_size: Integer?) -> void
-        def initialize: (untyped io, Integer data_offset, Integer compressed_size, Integer compression_method, ?max_uncompressed_size: Integer?) -> void
+        # : (untyped io, Integer data_offset, Integer compressed_size, Integer compression_method, ?max_uncompressed_size: Integer?, ?encoding: Encoding?) -> void
+        def initialize: (untyped io, Integer data_offset, Integer compressed_size, Integer compression_method, ?max_uncompressed_size: Integer?, ?encoding: Encoding?) -> void
 
         # : (?Integer? length) -> String?
         def read: (?Integer? length) -> String?
@@ -86,12 +86,12 @@ module Xlsxrb
       def each_entry: () ?{ (?) -> untyped } -> untyped
 
       # Opens an EntryStreamIO for an entry by name.
-      # : (String entry_name) -> EntryStreamIO
-      def open_entry_io: (String entry_name) -> EntryStreamIO
+      # : (String entry_name, ?encoding: (Encoding | String | false | nil)) -> EntryStreamIO
+      def open_entry_io: (String entry_name, ?encoding: Encoding | String | false | nil) -> EntryStreamIO
 
       # Yields inflated binary chunks directly from the compressed stream.
-      # : (String entry_name, ?chunk_size: Integer) ?{ (String) -> void } -> (void | Enumerator[String, void])
-      def each_entry_chunk: (untyped entry_name, ?chunk_size: untyped) ?{ (?) -> untyped } -> untyped
+      # : (String entry_name, ?chunk_size: Integer, ?encoding: (Encoding | String | false | nil)) ?{ (String) -> void } -> (void | Enumerator[String, void])
+      def each_entry_chunk: (untyped entry_name, ?chunk_size: untyped, ?encoding: untyped) ?{ (?) -> untyped } -> untyped
 
       # Returns true if the archive contains the specified entry.
       # : (String name) -> bool
@@ -138,6 +138,9 @@ module Xlsxrb
       def ci_catalog: () -> untyped
 
       def normalize_text_encoding: (untyped data) -> untyped
+
+      # : (String extra_data, Integer usize, Integer csize, Integer offset) -> [Integer, Integer, Integer]
+      def parse_zip64_extra: (String extra_data, Integer usize, Integer csize, Integer offset) -> [ Integer, Integer, Integer ]
     end
   end
 end

data/sig/generated/xlsxrb/stream_row.rbs

@@ -43,10 +43,11 @@ module Xlsxrb
     # @param collapsed [Boolean] Whether the row is collapsed.
     # @param outline_level [Integer, nil] Grouping/outline level.
     # @param style_index [Integer, nil] Style index.
+    # @param styles [Elements::Styles, Hash, nil] Optional parsed styles.
     # @param date1904 [Boolean] Whether the 1904 date system is active.
     # @param pad_empty_cells [Boolean] Whether missing cells in this row are padded.
-    # : (index: Integer, xml_bytes: String, from: Integer, to: Integer, shared_strings: Array[String], ?prefix: String, ?height: Float | Integer | nil, ?hidden: bool, ?custom_height: bool, ?collapsed: bool, ?outline_level: Integer | nil, ?style_index: Integer | nil, ?styles: Hash[untyped, untyped]?, ?date1904: bool, ?pad_empty_cells: bool) -> void
-    def initialize: (index: Integer, xml_bytes: String, from: Integer, to: Integer, shared_strings: Array[String], ?prefix: String, ?height: Float | Integer | nil, ?hidden: bool, ?custom_height: bool, ?collapsed: bool, ?outline_level: Integer | nil, ?style_index: Integer | nil, ?styles: Hash[untyped, untyped]?, ?date1904: bool, ?pad_empty_cells: bool) -> void
+    # : (index: Integer, xml_bytes: String, from: Integer, to: Integer, shared_strings: Array[String], ?prefix: String, ?height: Float | Integer | nil, ?hidden: bool, ?custom_height: bool, ?collapsed: bool, ?outline_level: Integer | nil, ?style_index: Integer | nil, ?styles: (Elements::Styles | Hash[untyped, untyped])?, ?date1904: bool, ?pad_empty_cells: bool) -> void
+    def initialize: (index: Integer, xml_bytes: String, from: Integer, to: Integer, shared_strings: Array[String], ?prefix: String, ?height: Float | Integer | nil, ?hidden: bool, ?custom_height: bool, ?collapsed: bool, ?outline_level: Integer | nil, ?style_index: Integer | nil, ?styles: (Elements::Styles | Hash[untyped, untyped])?, ?date1904: bool, ?pad_empty_cells: bool) -> void
 
     # rubocop:disable Style/OptionalBooleanParameter
     def self.fast_create: (untyped index, untyped xml_bytes, untyped from, untyped to, untyped shared_strings, ?untyped prefix, ?untyped height, ?untyped hidden, ?untyped custom_height, ?untyped outline_level, ?untyped style_index, ?untyped styles, ?untyped date1904, ?untyped collapsed, ?untyped pad_empty_cells) -> untyped

data/sig/generated/xlsxrb/stream_sheet.rbs

@@ -34,9 +34,9 @@ module Xlsxrb
     # : Symbol
     attr_reader state: untyped
 
-    # @return [Hash, nil] The parsed styles definition hash.
+    # @return [Elements::Styles, Hash, nil] The parsed styles definition.
     # @api public
-    # : Hash[untyped, untyped]?
+    # : (Elements::Styles | Hash[untyped, untyped])?
     attr_reader styles: untyped
 
     # Initializes a streaming worksheet context.
@@ -44,7 +44,7 @@ module Xlsxrb
     # @param name [String] The sheet name.
     # @param sheet_source [String, Proc, IO, nil] Raw XML content or chunk supplier/stream.
     # @param shared_strings [Array<String>] Shared strings table.
-    # @param styles [Hash, nil] Optional parsed styles hash.
+    # @param styles [Elements::Styles, Hash, nil] Optional parsed styles.
     # @param zip_reader [Ooxml::ZipReader, nil] Optional ZipReader context.
     # @param entry_name [String, nil] Archive entry name for this sheet.
     # @param date1904 [Boolean] Whether the 1904 date system is active.
@@ -53,8 +53,8 @@ module Xlsxrb
     # @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 images [Array<Elements::Image>, nil] Optional preloaded images array.
-    # : (String name, untyped sheet_source, Array[String] shared_strings, ?Hash[untyped, untyped]? styles, ?zip_reader: Ooxml::ZipReader?, ?entry_name: String?, ?state: Symbol, ?date1904: bool, ?dimension: String?, ?trim_empty_rows: bool, ?pad_empty_rows: bool, ?pad_empty_cells: bool, ?images: Array[Elements::Image]?) -> void
-    def initialize: (String name, untyped sheet_source, Array[String] shared_strings, ?Hash[untyped, untyped]? styles, ?zip_reader: Ooxml::ZipReader?, ?entry_name: String?, ?state: Symbol, ?date1904: bool, ?dimension: String?, ?trim_empty_rows: bool, ?pad_empty_rows: bool, ?pad_empty_cells: bool, ?images: Array[Elements::Image]?) -> void
+    # : (String name, untyped sheet_source, Array[String] shared_strings, ?(Elements::Styles | Hash[untyped, untyped])? styles, ?zip_reader: Ooxml::ZipReader?, ?entry_name: String?, ?state: Symbol, ?date1904: bool, ?dimension: String?, ?trim_empty_rows: bool, ?pad_empty_rows: bool, ?pad_empty_cells: bool, ?images: Array[Elements::Image]?) -> void
+    def initialize: (String name, untyped sheet_source, Array[String] shared_strings, ?(Elements::Styles | Hash[untyped, untyped])? styles, ?zip_reader: Ooxml::ZipReader?, ?entry_name: String?, ?state: Symbol, ?date1904: bool, ?dimension: String?, ?trim_empty_rows: bool, ?pad_empty_rows: bool, ?pad_empty_cells: bool, ?images: Array[Elements::Image]?) -> void
 
     # Returns whether trailing empty rows are omitted during iteration.
     #
@@ -143,6 +143,13 @@ module Xlsxrb
     # : () -> bool
     def visible?: () -> bool
 
+    # Returns whether the sheet is very hidden (:very_hidden).
+    #
+    # @return [Boolean]
+    # @api public
+    # : () -> bool
+    def very_hidden?: () -> bool
+
     # Iterates over rows in this streaming worksheet with O(1) memory.
     #
     # @overload each_row(&block)
@@ -353,13 +360,132 @@ module Xlsxrb
     # : () -> Array[Hash[Symbol, untyped]]
     def conditional_formats: () -> Array[Hash[Symbol, untyped]]
 
+    alias conditional_formatting conditional_formats
+
+    # Returns tables defined in this worksheet.
+    #
+    # @return [Array<Hash[Symbol, untyped]>]
+    # @api public
+    # : () -> Array[Hash[Symbol, untyped]]
+    def tables: () -> Array[Hash[Symbol, untyped]]
+
+    # Returns shapes defined in this worksheet.
+    #
+    # @return [Array<Hash[Symbol, untyped]>]
+    # @api public
+    # : () -> Array[Hash[Symbol, untyped]]
+    def shapes: () -> Array[Hash[Symbol, untyped]]
+
+    # Returns freeze pane settings for this worksheet, or nil if none.
+    #
+    # @return [Hash[Symbol, untyped], nil]
+    # @api public
+    # : () -> Hash[Symbol, untyped]?
+    def freeze_pane: () -> Hash[Symbol, untyped]?
+
+    # Returns sheet view properties for this worksheet.
+    #
+    # @return [Hash[Symbol, untyped]]
+    # @api public
+    # : () -> Hash[Symbol, untyped]
+    def sheet_view: () -> Hash[Symbol, untyped]
+
+    # Returns selection settings for this worksheet, or nil if none.
+    #
+    # @return [Hash[Symbol, untyped], nil]
+    # @api public
+    # : () -> Hash[Symbol, untyped]?
+    def selection: () -> Hash[Symbol, untyped]?
+
+    # Returns sheet protection settings as a hash, or nil if unprotected.
+    #
+    # @return [Hash[Symbol, untyped], nil]
+    # @api public
+    # : () -> Hash[Symbol, untyped]?
+    def sheet_protection: () -> Hash[Symbol, untyped]?
+
+    # Returns sheet-level properties (tabColor, outlinePr) for this worksheet.
+    #
+    # @return [Hash[Symbol, untyped]]
+    # @api public
+    # : () -> Hash[Symbol, untyped]
+    def sheet_properties: () -> Hash[Symbol, untyped]
+
+    # Returns sheet format properties (defaultRowHeight, defaultColWidth, baseColWidth) for this worksheet.
+    #
+    # @return [Hash[Symbol, untyped]]
+    # @api public
+    # : () -> Hash[Symbol, untyped]
+    def sheet_format: () -> Hash[Symbol, untyped]
+
+    # Returns page setup configurations for this worksheet.
+    #
+    # @return [Hash[Symbol, untyped]]
+    # @api public
+    # : () -> Hash[Symbol, untyped]
+    def page_setup: () -> Hash[Symbol, untyped]
+
+    # Returns page margins for this worksheet, or nil if none.
+    #
+    # @return [Hash[Symbol, untyped], nil]
+    # @api public
+    # : () -> Hash[Symbol, untyped]?
+    def page_margins: () -> Hash[Symbol, untyped]?
+
+    # Returns header/footer configurations for this worksheet.
+    #
+    # @return [Hash[Symbol, untyped]]
+    # @api public
+    # : () -> Hash[Symbol, untyped]
+    def header_footer: () -> Hash[Symbol, untyped]
+
+    # Returns print options for this worksheet.
+    #
+    # @return [Hash[Symbol, untyped]]
+    # @api public
+    # : () -> Hash[Symbol, untyped]
+    def print_options: () -> Hash[Symbol, untyped]
+
+    # Returns explicit row page breaks for this worksheet.
+    #
+    # @return [Array<untyped>]
+    # @api public
+    # : () -> Array[untyped]
+    def row_breaks: () -> Array[untyped]
+
+    # Returns explicit column page breaks for this worksheet.
+    #
+    # @return [Array<untyped>]
+    # @api public
+    # : () -> Array[untyped]
+    def col_breaks: () -> Array[untyped]
+
+    # Returns protected ranges defined for this worksheet.
+    #
+    # @return [Array<Hash[Symbol, untyped]>]
+    # @api public
+    # : () -> Array[Hash[Symbol, untyped]]
+    def protected_ranges: () -> Array[Hash[Symbol, untyped]]
+
+    # Returns cell watch cell references defined for this worksheet.
+    #
+    # @return [Array<String>]
+    # @api public
+    # : () -> Array[String]
+    def cell_watches: () -> Array[String]
+
     # Closes any underlying reader resources.
     # : () -> void
     def close: () -> void
 
     private
 
-    # Returns the full raw XML string for this worksheet, loaded on demand.
+    # : () -> Hash[Symbol, untyped]
+    def sheet_view_data: () -> Hash[Symbol, untyped]
+
+    # : () -> Hash[Symbol, untyped]
+    def print_page_data: () -> Hash[Symbol, untyped]
+
     # : () -> String
     def raw_sheet_xml: () -> String
 

data/sig/generated/xlsxrb/stream_writer.rbs

@@ -17,12 +17,16 @@ module Xlsxrb
     # : String?
     attr_reader current_sheet: untyped
 
+    # @return [Boolean] Whether to treat strings starting with formula prefixes as plain text.
+    attr_accessor escape_formulas: untyped
+
     # Initializes a streaming writer context.
     #
     # @param target [String, IO, StringIO] Destination file path or writable IO stream.
     # @param strict_excel_mode [Boolean] Whether to enforce Microsoft Excel specification limits.
-    # : (untyped target, ?strict_excel_mode: bool) -> void
-    def initialize: (untyped target, ?strict_excel_mode: bool) -> void
+    # @param escape_formulas [Boolean] Whether to treat strings starting with formula prefixes as plain text.
+    # : (untyped target, ?strict_excel_mode: bool, ?escape_formulas: bool) -> void
+    def initialize: (untyped target, ?strict_excel_mode: bool, ?escape_formulas: bool) -> void
 
     # Sets a workbook property.
     #
@@ -124,10 +128,11 @@ module Xlsxrb
       # @param custom_height [Boolean] Whether to flag as custom height.
       # @param outline_level [Integer, nil] Grouping/outline level (0 - 7).
       # @param collapsed [Boolean] Whether the row is collapsed.
+      # @param style [Integer, Symbol, String, Hash, nil] Row style format or index.
       # @return [void]
       # @api public
-      # : (Array[untyped] | Hash[untyped, untyped] values, ?styles: untyped, ?height: Float | Integer | nil, ?hidden: bool, ?custom_height: bool, ?collapsed: bool, ?outline_level: Integer | nil) -> void
-      def row: (Array[untyped] | Hash[untyped, untyped] values, ?styles: untyped, ?height: Float | Integer | nil, ?hidden: bool, ?custom_height: bool, ?collapsed: bool, ?outline_level: Integer | nil) -> void
+      # : (Array[untyped] | Hash[untyped, untyped] values, ?styles: untyped, ?height: Float | Integer | nil, ?hidden: bool, ?custom_height: bool, ?collapsed: bool, ?outline_level: Integer | nil, ?style: untyped) -> void
+      def row: (Array[untyped] | Hash[untyped, untyped] values, ?styles: untyped, ?height: Float | Integer | nil, ?hidden: bool, ?custom_height: bool, ?collapsed: bool, ?outline_level: Integer | nil, ?style: untyped) -> void
 
       alias add_row row
 
@@ -154,10 +159,11 @@ module Xlsxrb
       # @param custom_width [Boolean] Whether to flag as custom width.
       # @param outline_level [Integer, nil] Grouping/outline level (0 - 7).
       # @param collapsed [Boolean] Whether the outline group is collapsed.
+      # @param style [Integer, Symbol, String, Hash, nil] Column style format or index.
       # @return [void]
       # @api public
-      # : (Integer | String | Symbol | Range[Integer | String] | Array[Integer | String] col_index, ?width: Float | Integer | nil, ?hidden: bool, ?best_fit: bool, ?custom_width: bool, ?outline_level: Integer | nil, ?collapsed: bool) -> void
-      def column: (Integer | String | Symbol | Range[Integer | String] | Array[Integer | String] col_index, ?width: Float | Integer | nil, ?hidden: bool, ?best_fit: bool, ?custom_width: bool, ?outline_level: Integer | nil, ?collapsed: bool) -> void
+      # : (Integer | String | Symbol | Range[Integer | String] | Array[Integer | String] col_index, ?width: Float | Integer | nil, ?hidden: bool, ?best_fit: bool, ?custom_width: bool, ?outline_level: Integer | nil, ?collapsed: bool, ?style: (Integer | Symbol | String | Hash[Symbol, untyped])?) -> void
+      def column: (Integer | String | Symbol | Range[Integer | String] | Array[Integer | String] col_index, ?width: Float | Integer | nil, ?hidden: bool, ?best_fit: bool, ?custom_width: bool, ?outline_level: Integer | nil, ?collapsed: bool, ?style: (Integer | Symbol | String | Hash[Symbol, untyped])?) -> void
 
       # Adds a chart to the active sheet.
       #
@@ -232,16 +238,25 @@ module Xlsxrb
 
       # Adds data validation rules to a range.
       #
+      # Adds data validation to a cell or range.
+      #
       # @example Dropdown list validation
       #   s.validate_data("B2:B100", type: "list", formula1: '"High,Medium,Low"')
       #
-      # @param range [String] The cell range (e.g. "B2:B10").
-      # @param type [String, Symbol] Validation type ("list", "whole", "decimal", "date", "time", "textLength", "custom").
+      # @example Block syntax
+      #   s.validate_data("B2:B100") do |dv|
+      #     dv.type :list
+      #     dv.formula1 '"High,Medium,Low"'
+      #   end
+      #
+      # @param range [String, nil] The cell range (e.g. "B2:B10").
+      # @param type [String, Symbol, nil] Validation type ("list", "whole", "decimal", "date", "time", "textLength", "custom").
       # @param opts [Hash] Validation options.
+      # @yield [data_validation_builder] Optional configuration block.
       # @return [void]
       # @api public
-      # : (String range, ?type: String | Symbol, **untyped opts) -> void
-      def validate_data: (String range, ?type: String | Symbol, **untyped opts) -> void
+      # : (?String? range, ?type: (String | Symbol)?, **untyped opts) ?{ (DataValidationBuilder) -> void } -> void
+      def validate_data: (?String? range, ?type: (String | Symbol)?, **untyped opts) ?{ (DataValidationBuilder) -> void } -> void
 
       # Adds conditional formatting to a range.
       #
@@ -258,19 +273,26 @@ module Xlsxrb
 
       # Adds a formatted Excel Table to the sheet.
       #
-      # @example
+      # @example Standard keyword arguments
       #   s.table("A1:C10", columns: ["ID", "Name", "Total"], name: "SalesTable", style: "TableStyleMedium9")
       #
-      # @param ref [String] The cell range for the table (e.g. "A1:D10").
-      # @param columns [Array<String>, Array<Hash>] Column names or definitions.
+      # @example Block syntax
+      #   s.table("A1:C10") do |t|
+      #     t.columns ["ID", "Name", "Total"]
+      #     t.style "TableStyleMedium9"
+      #   end
+      #
+      # @param ref [String, nil] The cell range for the table (e.g. "A1:D10").
+      # @param columns [Array<String>, Array<Hash>, nil] Column names or definitions.
       # @param name [String, nil] Table name.
       # @param display_name [String, nil] Display name.
       # @param style [String, nil] Table style name.
       # @param opts [Hash] Additional options.
+      # @yield [table_builder] Optional configuration block.
       # @return [void]
       # @api public
-      # : (String ref, columns: untyped, ?name: String?, ?display_name: String?, ?style: String?, **untyped opts) -> void
-      def table: (String ref, columns: untyped, ?name: String?, ?display_name: String?, ?style: String?, **untyped opts) -> void
+      # : (?String? ref, ?columns: untyped, ?name: String?, ?display_name: String?, ?style: String?, **untyped opts) ?{ (TableBuilder) -> void } -> void
+      def table: (?String? ref, ?columns: untyped, ?name: String?, ?display_name: String?, ?style: String?, **untyped opts) ?{ (TableBuilder) -> void } -> void
 
       # simplecov:disable
       # Edge case / untested delegation block
@@ -575,6 +597,16 @@ module Xlsxrb
       # : (Symbol | String name, untyped value) -> void
       def sheet_view: (Symbol | String name, untyped value) -> void
 
+      # Configures sheet format properties (e.g. default_row_height, default_col_width).
+      #
+      # @param name [Symbol, String, Hash, nil] Property name or hash of properties.
+      # @param value [Object, nil] Property value when name is provided.
+      # @param opts [Hash] Keyword arguments for sheet format properties.
+      # @return [Hash[Symbol, untyped]]
+      # @api public
+      # : (?Symbol | String | Hash[Symbol, untyped] | nil name, ?untyped value, **untyped opts) -> Hash[Symbol, untyped]
+      def sheet_format: (?Symbol | String | Hash[Symbol, untyped] | nil name, ?untyped value, **untyped opts) -> Hash[Symbol, untyped]
+
       # simplecov:disable
       # Edge case / untested delegation block
       # Adds a horizontal page break after the given row index.
@@ -594,6 +626,29 @@ module Xlsxrb
       # @api public
       # : (Integer col_index) -> void
       def page_break_col: (Integer col_index) -> void
+
+      # Adds a protected range to the sheet.
+      #
+      # @param name [String] Name of the protected range.
+      # @param sqref [String] Cell range (e.g. "A1:B10").
+      # @param password [String, nil] Optional password or hash.
+      # @param opts [Hash] Additional options.
+      # @return [void]
+      # @api public
+      # : (String name, String sqref, ?password: String?, **untyped opts) -> void
+      def protected_range: (String name, String sqref, ?password: String?, **untyped opts) -> void
+
+      alias add_protected_range protected_range
+
+      # Adds a cell watch to the sheet.
+      #
+      # @param ref [String] Cell reference (e.g. "A1").
+      # @return [void]
+      # @api public
+      # : (String ref) -> void
+      def cell_watch: (String ref) -> void
+
+      alias add_cell_watch cell_watch
     end
 
     # Adds a new sheet to the workbook and starts streaming rows into it.
@@ -621,10 +676,11 @@ module Xlsxrb
     # @param hidden [Boolean] Whether the row is hidden.
     # @param custom_height [Boolean] Whether custom row height is set.
     # @param outline_level [Integer, nil] Grouping/outline level (0 - 7).
+    # @param style [Integer, Symbol, String, Hash, nil] Row style format or index.
     # @return [void]
     # @api public
-    # : (Array[untyped] | Hash[untyped, untyped] values, ?styles: untyped, ?height: Float | Integer | nil, ?hidden: bool, ?custom_height: bool, ?collapsed: bool, ?outline_level: Integer | nil) -> void
-    def row: (Array[untyped] | Hash[untyped, untyped] values, ?styles: untyped, ?height: Float | Integer | nil, ?hidden: bool, ?custom_height: bool, ?collapsed: bool, ?outline_level: Integer | nil) -> void
+    # : (Array[untyped] | Hash[untyped, untyped] values, ?styles: untyped, ?height: Float | Integer | nil, ?hidden: bool, ?custom_height: bool, ?collapsed: bool, ?outline_level: Integer | nil, ?style: untyped) -> void
+    def row: (Array[untyped] | Hash[untyped, untyped] values, ?styles: untyped, ?height: Float | Integer | nil, ?hidden: bool, ?custom_height: bool, ?collapsed: bool, ?outline_level: Integer | nil, ?style: untyped) -> void
 
     alias add_row row
 
@@ -644,11 +700,11 @@ module Xlsxrb
     # @param index [Integer, String, Range, Array] Column index (0-based) or letter ("A".."D").
     # @param width [Float, Integer, nil] Column width in character units (0 - 255).
     # @param hidden [Boolean] Whether the column is hidden.
-    # @param style [Integer, Symbol, String, nil] Column style format or index.
+    # @param style [Integer, Symbol, String, Hash, nil] Column style format or index.
     # @return [void]
     # @api public
-    # : (Integer | String | Range[Integer | String] | Array[Integer | String] index, ?width: Float | Integer | nil, ?hidden: bool, ?custom_width: bool, ?outline_level: Integer | nil, ?style: (Integer | Symbol | String)?) -> void
-    def column: (Integer | String | Range[Integer | String] | Array[Integer | String] index, ?width: Float | Integer | nil, ?hidden: bool, ?custom_width: bool, ?outline_level: Integer | nil, ?style: (Integer | Symbol | String)?) -> void
+    # : (Integer | String | Range[Integer | String] | Array[Integer | String] index, ?width: Float | Integer | nil, ?hidden: bool, ?custom_width: bool, ?outline_level: Integer | nil, ?style: (Integer | Symbol | String | Hash[Symbol, untyped])?) -> void
+    def column: (Integer | String | Range[Integer | String] | Array[Integer | String] index, ?width: Float | Integer | nil, ?hidden: bool, ?custom_width: bool, ?outline_level: Integer | nil, ?style: (Integer | Symbol | String | Hash[Symbol, untyped])?) -> void
 
     # Adds a chart to the current worksheet.
     #
@@ -701,12 +757,13 @@ module Xlsxrb
 
     # Adds a data validation rule.
     #
-    # @param sqref [String] Cell range.
+    # @param sqref [String, nil] Cell range.
     # @param opts [Hash] Validation options.
+    # @yield [data_validation_builder] Optional configuration block.
     # @return [void]
     # @api public
-    # : (untyped sqref, **untyped opts) -> void
-    def validate_data: (untyped sqref, **untyped opts) -> void
+    # : (?String? sqref, **untyped opts) ?{ (DataValidationBuilder) -> void } -> void
+    def validate_data: (?String? sqref, **untyped opts) ?{ (DataValidationBuilder) -> void } -> void
 
     # Adds a conditional formatting rule.
     #
@@ -719,16 +776,17 @@ module Xlsxrb
 
     # Adds an Excel Table (ListObject).
     #
-    # @param ref [String] Table range.
-    # @param columns [Array<String>] Column names.
+    # @param ref [String, nil] Table range.
+    # @param columns [Array<String>, nil] Column names.
     # @param name [String, nil] Table name.
     # @param display_name [String, nil] Display name.
     # @param style [String, nil] Table style.
     # @param opts [Hash] Additional options.
+    # @yield [table_builder] Optional configuration block.
     # @return [void]
     # @api public
-    # : (untyped ref, columns: untyped, ?name: untyped, ?display_name: untyped, ?style: untyped, **untyped opts) -> void
-    def table: (untyped ref, columns: untyped, ?name: untyped, ?display_name: untyped, ?style: untyped, **untyped opts) -> void
+    # : (?String? ref, ?columns: untyped, ?name: untyped, ?display_name: untyped, ?style: untyped, **untyped opts) ?{ (TableBuilder) -> void } -> void
+    def table: (?String? ref, ?columns: untyped, ?name: untyped, ?display_name: untyped, ?style: untyped, **untyped opts) ?{ (TableBuilder) -> void } -> void
 
     # Adds a Pivot Table.
     #
@@ -920,6 +978,16 @@ module Xlsxrb
     # : (Symbol name, untyped value) -> void
     def sheet_view: (Symbol name, untyped value) -> void
 
+    # Configures sheet format properties (e.g. default_row_height, default_col_width).
+    #
+    # @param name [Symbol, String, Hash, nil] Property name or hash of properties.
+    # @param value [Object, nil] Property value when name is provided.
+    # @param opts [Hash] Keyword arguments for sheet format properties.
+    # @return [Hash[Symbol, untyped]]
+    # @api public
+    # : (?Symbol | String | Hash[Symbol, untyped] | nil name, ?untyped value, **untyped opts) -> Hash[Symbol, untyped]
+    def sheet_format: (?Symbol | String | Hash[Symbol, untyped] | nil name, ?untyped value, **untyped opts) -> Hash[Symbol, untyped]
+
     # Inserts a horizontal page break before a row.
     #
     # @param row_num [Integer] 1-based row number.
@@ -936,6 +1004,29 @@ module Xlsxrb
     # : (Integer col_index) -> void
     def page_break_col: (Integer col_index) -> void
 
+    # Adds a protected range to the current sheet.
+    #
+    # @param name [String] Name of the protected range.
+    # @param sqref [String] Cell range (e.g. "A1:B10").
+    # @param password [String, nil] Optional password or hash.
+    # @param opts [Hash] Additional options.
+    # @return [void]
+    # @api public
+    # : (String name, String sqref, ?password: String?, **untyped opts) -> void
+    def protected_range: (String name, String sqref, ?password: String?, **untyped opts) -> void
+
+    alias add_protected_range protected_range
+
+    # Adds a cell watch to the current sheet.
+    #
+    # @param ref [String] Cell reference (e.g. "A1").
+    # @return [void]
+    # @api public
+    # : (String ref) -> void
+    def cell_watch: (String ref) -> void
+
+    alias add_cell_watch cell_watch
+
     # Adds a defined name.
     #
     # @param name [String] The defined name.