xlsxrb 0.1.4 → 0.1.6

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

@@ -0,0 +1,45 @@
+# Generated from lib/xlsxrb/ooxml/xml_builder.rb with RBS::Inline
+
+module Xlsxrb
+  module Ooxml
+    # Streams well-formed XML to a writable IO without building a DOM.
+    class XmlBuilder
+      XML_HEADER: ::String
+
+      ESCAPE_MAP: untyped
+
+      ESCAPE_RE: ::Regexp
+
+      def initialize: (untyped io) -> untyped
+
+      def declaration: () -> untyped
+
+      EMPTY_HASH: untyped
+
+      # Opens a tag, yields for children, then closes the tag.
+      def tag: (untyped name, ?untyped attrs) ?{ (?) -> untyped } -> untyped
+
+      def open_tag: (untyped name, ?untyped attrs) -> untyped
+
+      def close_tag: (untyped name) -> untyped
+
+      def empty_tag: (untyped name, ?untyped attrs) -> untyped
+
+      def text: (untyped content) -> untyped
+
+      # Write raw XML string (for unmapped_data restoration).
+      def raw: (untyped xml_string) -> untyped
+
+      # Serialize an unmapped_data hash back to XML.
+      def write_unmapped: (untyped node) -> untyped
+
+      def to_s: () -> untyped
+
+      private
+
+      def write_attrs: (untyped attrs) -> untyped
+
+      def escape: (untyped value) -> untyped
+    end
+  end
+end

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

@@ -0,0 +1,30 @@
+# Generated from lib/xlsxrb/ooxml/xml_parser.rb with RBS::Inline
+
+module Xlsxrb
+  module Ooxml
+    # Thin wrapper around REXML SAX2 parser for streaming XML processing.
+    # Unknown elements are captured as unmapped data hashes.
+    module XmlParser
+      # Parses XML string using SAX2, calling the given listener.
+      def self.parse: (untyped xml_string, untyped listener) -> untyped
+
+      # Base listener with unmapped-data collection support.
+      class BaseListener
+        include REXML::SAX2Listener
+
+        attr_reader unmapped_data: untyped
+
+        def initialize: () -> untyped
+
+        # Override in subclass: return true if the tag is recognized.
+        def recognized_tag?: (untyped _uri, untyped _localname, untyped _qname) -> 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
+      end
+    end
+  end
+end

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

@@ -0,0 +1,38 @@
+# Generated from lib/xlsxrb/ooxml/zip_generator.rb with RBS::Inline
+
+module Xlsxrb
+  module Ooxml
+    # Generates a simple ZIP file using only the standard library.
+    class ZipGenerator
+      def initialize: (untyped filepath) -> untyped
+
+      # Adds an entry to the ZIP archive.
+      def add_entry: (untyped filepath, untyped content) -> untyped
+
+      # Generates the ZIP file.
+      def generate: () -> untyped
+
+      private
+
+      def write_entries: () -> untyped
+
+      def write_local_header: (untyped entry) -> untyped
+
+      def write_file_data: (untyped entry) -> untyped
+
+      def write_central_directory: () -> untyped
+
+      def compress: (untyped content) -> untyped
+
+      def crc32: (untyped content) -> untyped
+
+      def dos_datetime: (untyped time) -> untyped
+
+      def le16: (untyped value) -> untyped
+
+      def le32: (untyped value) -> untyped
+
+      def calculate_central_dir_size: () -> untyped
+    end
+  end
+end

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

@@ -0,0 +1,45 @@
+# Generated from lib/xlsxrb/ooxml/zip_reader.rb with RBS::Inline
+
+module Xlsxrb
+  module Ooxml
+    # Reads ZIP archives using only stdlib (zlib).
+    # Scans local file headers sequentially — works with non-seekable IO.
+    class ZipReader
+      LOCAL_HEADER_SIG: untyped
+
+      MAX_UNCOMPRESSED_SIZE: untyped
+
+      attr_accessor max_uncompressed_size: untyped
+
+      # Opens a ZIP from a file path or IO and yields the reader.
+      # : (untyped source, ?max_uncompressed_size: Integer) ?{ (ZipReader) -> untyped } -> (ZipReader | untyped)
+      def self.open: (untyped source, ?max_uncompressed_size: Integer) ?{ (ZipReader) -> untyped } -> (ZipReader | untyped)
+
+      # : (untyped io, ?max_uncompressed_size: Integer) -> void
+      def initialize: (untyped io, ?max_uncompressed_size: Integer) -> void
+
+      # Returns a Hash { entry_name => raw_bytes } for all entries.
+      def read_all: () -> untyped
+
+      # Returns raw bytes for a single entry, or nil if not found.
+      def read_entry: (untyped name) -> untyped
+
+      # Yields (entry_name, data_string) for each file in the archive.
+      def each_entry: () ?{ (?) -> untyped } -> untyped
+
+      private
+
+      def entries: () -> untyped
+
+      def parse_entries: () -> untyped
+
+      def parse_from_central_directory: (untyped io) -> untyped
+
+      def find_data_descriptor_stream: (untyped io, untyped method) -> untyped
+
+      def decompress: (untyped raw, untyped method) -> untyped
+
+      def safe_inflate: (untyped raw, untyped wbits) -> untyped
+    end
+  end
+end

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

@@ -0,0 +1,45 @@
+# Generated from lib/xlsxrb/ooxml/zip_writer.rb with RBS::Inline
+
+module Xlsxrb
+  module Ooxml
+    # Writes ZIP archives using only stdlib (zlib).
+    # Supports streaming: entries are written sequentially, central directory at close.
+    class ZipWriter
+      def self.open: (untyped target) ?{ (?) -> untyped } -> untyped
+
+      def initialize: (untyped io) -> untyped
+
+      # Add a file entry with string content.
+      def add_entry: (untyped path, untyped content) -> untyped
+
+      # Add a file entry with binary content (no encoding conversion).
+      def add_binary_entry: (untyped path, untyped content) -> untyped
+
+      # Write a string directly into the current ZIP entry stream.
+      # Use start_entry / write_data / finish_entry for true streaming.
+      def start_entry: (untyped path) -> untyped
+
+      def write_data: (untyped str) -> untyped
+
+      def finish_entry: () -> untyped
+
+      def close: () -> untyped
+
+      private
+
+      def determine_seekable: () -> untyped
+
+      def write_bytes: (untyped data) -> untyped
+
+      def write_raw_entry: (untyped path, untyped content_bytes) -> untyped
+
+      def deflate: (untyped content) -> untyped
+
+      def write_local_header: (untyped path, untyped crc, untyped compressed_size, untyped uncompressed_size, ?gp_flag: untyped, ?count_bytes: untyped) -> untyped
+
+      def write_central_directory: () -> untyped
+
+      def write_end_of_central_directory: (untyped cd_offset, untyped cd_size) -> untyped
+    end
+  end
+end

data/sig/generated/xlsxrb/ooxml.rbs

@@ -0,0 +1,23 @@
+# Generated from lib/xlsxrb/ooxml.rb with RBS::Inline
+
+module Xlsxrb
+  # Low-level OOXML infrastructure layer.
+  # Handles ZIP extraction, SAX XML parsing, and XML generation
+  # in strict accordance with ECMA-376.
+  module Ooxml
+    class Event < Data
+      attr_reader type(): untyped
+
+      attr_reader args(): untyped
+
+      attr_reader source(): untyped
+
+      def self.new: (untyped type, untyped args, untyped source) -> instance
+                  | (type: untyped, args: untyped, source: untyped) -> instance
+
+      def self.members: () -> [ :type, :args, :source ]
+
+      def members: () -> [ :type, :args, :source ]
+    end
+  end
+end

data/sig/generated/xlsxrb/style_builder.rbs

@@ -0,0 +1,250 @@
+# Generated from lib/xlsxrb/style_builder.rb with RBS::Inline
+
+module Xlsxrb
+  # Helper class for building cell styles with a fluent DSL.
+  # Encapsulates font, fill, border, alignment, and number format properties.
+  # @api public
+  class StyleBuilder
+    COLORS: untyped
+
+    def resolve_color: (untyped color) -> untyped
+
+    # : (?String? name) -> void
+    def initialize: (?String? name) -> void
+
+    attr_reader name: untyped
+
+    attr_reader font_props: untyped
+
+    attr_reader fill_props: untyped
+
+    attr_reader border_props: untyped
+
+    attr_reader num_fmt_id: untyped
+
+    attr_reader alignment: untyped
+
+    # Applies option-style definitions so callers can use add_style(name, **opts)
+    # as an alternative to block-based fluent chaining.
+    # Applies option-style definitions so callers can use add_style(name, **opts)
+    # as an alternative to block-based fluent chaining.
+    # @param opts [Hash] The styling options.
+    # @return [self]
+    # @api public
+    # : (**untyped) -> self
+    def apply_options!: (**untyped) -> self
+
+    # Configures multiple font properties at once.
+    # @param opts [Hash] The font properties.
+    # @return [self]
+    # @api public
+    # : (**untyped) -> self
+    def font: (**untyped) -> self
+
+    # rubocop:disable Style/OptionalBooleanParameter
+    # Sets the font to bold.
+    # @param value [Boolean] Whether to apply bold.
+    # @return [self]
+    # @api public
+    # : (?bool) -> self
+    def bold: (?bool) -> self
+
+    # Sets the font to italic.
+    # @param value [Boolean] Whether to apply italic.
+    # @return [self]
+    # @api public
+    # : (?bool) -> self
+    def italic: (?bool) -> self
+
+    # Sets the font size.
+    # @param size_value [Numeric] The size.
+    # @return [self]
+    # @api public
+    # : (Numeric) -> self
+    def size: (Numeric) -> self
+
+    # Sets the font name.
+    # @param name [String] The font name.
+    # @return [self]
+    # @api public
+    # : (String) -> self
+    def font_name: (String) -> self
+
+    # Sets the font color.
+    # @param color [String, Symbol] The color.
+    # @return [self]
+    # @api public
+    # : (String | Symbol) -> self
+    def font_color: (String | Symbol) -> self
+
+    # Sets the font underline style.
+    # @param val [String] The underline style (e.g., 'single').
+    # @return [self]
+    # @api public
+    # : (?String) -> self
+    def underline: (?String) -> self
+
+    # Sets the font strikethrough.
+    # @param value [Boolean] Whether to apply strike.
+    # @return [self]
+    # @api public
+    # : (?bool) -> self
+    def strike: (?bool) -> self
+
+    # Sets the vertical alignment of the font.
+    # @param value [String] The alignment value.
+    # @return [self]
+    # @api public
+    # : (String) -> self
+    def vert_align: (String) -> self
+
+    # Sets the fill pattern.
+    # @param pattern [String, Symbol] The pattern type.
+    # @param fg_color [String, Symbol, nil] The foreground color.
+    # @param bg_color [String, Symbol, nil] The background color.
+    # @return [self]
+    # @api public
+    # Configures fill properties.
+    # @param pattern [String, Symbol] The pattern type.
+    # @param fg_color [String, Symbol, nil] The foreground color.
+    # @param bg_color [String, Symbol, nil] The background color.
+    # @return [self]
+    # @api public
+    # : (String | Symbol pattern, ?fg_color: String | Symbol | nil, ?bg_color: String | Symbol | nil) -> self
+    def fill_pattern: (String | Symbol pattern, ?fg_color: String | Symbol | nil, ?bg_color: String | Symbol | nil) -> self
+
+    # Sets a solid fill color.
+    # @param color [String, Symbol] The color.
+    # @return [self]
+    # @api public
+    # : (String | Symbol) -> self
+    def fill_color: (String | Symbol) -> self
+
+    # : (?pattern: String | Symbol, ?fg_color: String | Symbol | nil, ?bg_color: String | Symbol | nil) -> self
+    def fill: (?pattern: String | Symbol, ?fg_color: String | Symbol | nil, ?bg_color: String | Symbol | nil) -> self
+
+    # Sets a gradient fill.
+    # @param type [String] The gradient type.
+    # @param degree [Numeric, nil] The degree.
+    # @param stops [Array] The gradient stops.
+    # @return [self]
+    # @api public
+    # : (type: String, ?degree: Numeric | nil, ?stops: Array[untyped]) -> self
+    def fill_gradient: (type: String, ?degree: Numeric | nil, ?stops: Array[untyped]) -> self
+
+    # Configures multiple border properties.
+    # @param opts [Hash] Border options.
+    # @return [self]
+    # @api public
+    # : (**untyped) -> self
+    def border: (**untyped) -> self
+
+    # Sets all borders.
+    # @param style [String, Symbol] The border style.
+    # @param color [String, Symbol, nil] The color.
+    # @return [self]
+    # @api public
+    # : (?style: String | Symbol, ?color: String | Symbol | nil) -> self
+    def border_all: (?style: String | Symbol, ?color: String | Symbol | nil) -> self
+
+    # Sets the left border.
+    # @param style [String, Symbol] The border style.
+    # @param color [String, Symbol, nil] The color.
+    # @return [self]
+    # @api public
+    # : (?style: String | Symbol, ?color: String | Symbol | nil) -> self
+    def border_left: (?style: String | Symbol, ?color: String | Symbol | nil) -> self
+
+    # Sets the right border.
+    # @param style [String, Symbol] The border style.
+    # @param color [String, Symbol, nil] The color.
+    # @return [self]
+    # @api public
+    # : (?style: String | Symbol, ?color: String | Symbol | nil) -> self
+    def border_right: (?style: String | Symbol, ?color: String | Symbol | nil) -> self
+
+    # Sets the top border.
+    # @param style [String, Symbol] The border style.
+    # @param color [String, Symbol, nil] The color.
+    # @return [self]
+    # @api public
+    # : (?style: String | Symbol, ?color: String | Symbol | nil) -> self
+    def border_top: (?style: String | Symbol, ?color: String | Symbol | nil) -> self
+
+    # Sets the bottom border.
+    # @param style [String, Symbol] The border style.
+    # @param color [String, Symbol, nil] The color.
+    # @return [self]
+    # @api public
+    # : (?style: String | Symbol, ?color: String | Symbol | nil) -> self
+    def border_bottom: (?style: String | Symbol, ?color: String | Symbol | nil) -> self
+
+    # rubocop:disable Naming/MethodParameterName
+    # Sets diagonal borders.
+    # @param style [String, Symbol] The border style.
+    # @param color [String, Symbol, nil] The color.
+    # @param up [Boolean] Diagonal up.
+    # @param down [Boolean] Diagonal down.
+    # @return [self]
+    # @api public
+    # : (?style: String | Symbol, ?color: String | Symbol | nil, ?up: bool, ?down: bool) -> self
+    def border_diagonal: (?style: String | Symbol, ?color: String | Symbol | nil, ?up: bool, ?down: bool) -> self
+
+    # Sets horizontal alignment.
+    # @param value [String, Symbol] The alignment.
+    # @return [self]
+    # @api public
+    # : (String | Symbol) -> self
+    def align_horizontal: (String | Symbol) -> self
+
+    # Sets vertical alignment.
+    # @param value [String, Symbol] The alignment.
+    # @return [self]
+    # @api public
+    # : (String | Symbol) -> self
+    def align_vertical: (String | Symbol) -> self
+
+    # rubocop:disable Style/OptionalBooleanParameter
+    # Sets text wrapping.
+    # @param value [Boolean] Whether to wrap text.
+    # @return [self]
+    # @api public
+    # : (?bool) -> self
+    def wrap_text: (?bool) -> self
+
+    # Sets shrink to fit.
+    # @param value [Boolean] Whether to shrink text.
+    # @return [self]
+    # @api public
+    # : (?bool) -> self
+    def shrink_to_fit: (?bool) -> self
+
+    # Sets text rotation.
+    # @param value [Numeric] The rotation angle.
+    # @return [self]
+    # @api public
+    # : (Numeric) -> self
+    def text_rotation: (Numeric) -> self
+
+    # Sets text indent.
+    # @param value [Numeric] The indent level.
+    # @return [self]
+    # @api public
+    # : (Numeric) -> self
+    def indent: (Numeric) -> self
+
+    # Sets the number format.
+    # @param num_fmt_id [String, Integer] The format id or format string.
+    # @return [self]
+    # @api public
+    # : (String | Integer) -> self
+    def number_format: (String | Integer) -> self
+
+    alias num_fmt number_format
+
+    # Register this style with the given Writer, returning the style_id.
+    # writer:: Xlsxrb::Ooxml::Writer instance
+    # : (untyped writer) -> Integer
+    def register_with: (untyped writer) -> Integer
+  end
+end

data/sig/generated/xlsxrb/version.rbs

@@ -0,0 +1,5 @@
+# Generated from lib/xlsxrb/version.rb with RBS::Inline
+
+module Xlsxrb
+  VERSION: ::String
+end