xlsxrb 0.1.14 → 0.1.15

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 476e6f6e689eb65fecbbda4b81592c124b50f16fff0bbc9fec027a1f55ed4454
-  data.tar.gz: 8364dc6bff9b5f9601dc4cb375ef27b0456b7f88e721b2b52d1db7ba342c7de5
+  metadata.gz: 0ec522a5f1d603d001d74555842823cfd56bf1fc96239e3e04daabadd345b5e9
+  data.tar.gz: b8cb5562079da225ceae806972851c9f0a1462083a1d8a05753f6896d511b6b5
 SHA512:
-  metadata.gz: 31f365a17ad3f5976033ddc7a9220c5606c6d8f6acfca356ef1b3404cd1ed6d1f86d2c86d57a5e27daf15a46bea3d1c193f4fb60662b2eccbc7078fe41777bbb
-  data.tar.gz: 67fe19a961f2bb204d19e5b9a49ade2c01e48de7d6a09ac1c87f7c591b570c0ba64494b43ce59d3ea492a70e18cf967d775af4fb55623287ab6b7b648bb0843c
+  metadata.gz: d3344f027a164d86a5546b45be5cac8213588ef99aa27d5a3b466b0c0504f5fe8607cb34d6b95e6bc42685108b1403eb8a0e5a28fa268a1707911c65fcc42e2d
+  data.tar.gz: 47f50e238ff4f5209421d99f34ddd58fb26c6428020f0ff9731b8b34374e9b757621fe833f57763978346adc5243064d2bb8e16ceca27f05a0627402b5bf0b3d

data/CHANGELOG.md

@@ -1,5 +1,52 @@
 ## [Unreleased]
 
+## [0.1.15] - 2026-10-17
+
+### Added
+- Block form for table and data validation configuration: Support optional configuration block in `table` and `validate_data` methods on `WorksheetBuilder`, `StreamWriter`, and `WorksheetProxy` using `TableBuilder` and `DataValidationBuilder` contexts.
+- Protected range and cell watch configuration DSL and properties (`protected_range` and `cell_watch`): Add `protected_range` (and alias `add_protected_range`) and `cell_watch` (and alias `add_cell_watch`) methods to `WorksheetBuilder`, `StreamWriter`, and `WorksheetProxy`, normalize passwords into ECMA-376 compliant hashes or modern SHA-512 protection attributes, serialize `<protectedRanges>` and `<cellWatches>` according to OOXML schema sequence rules in `WorksheetWriter`, and expose `protected_ranges` and `cell_watches` readers on `Elements::Worksheet` and `StreamSheet`.
+- Range coordinate conversion utilities (`Xlsxrb::Utils.parse_range` and `range_to_ref`): Parse cell range references (`"A1:C10"`, `"A1"`) to 0-based `[[top_row, left_col], [bottom_row, right_col]]` coordinate pairs, and format bounding coordinate tuples into A1-style range references (`"A1:C10"`) with `Xlsxrb.parse_range` and `Xlsxrb.range_to_ref` facade methods.
+- Sheet format configuration DSL and properties (`sheet_format`): Add `sheet_format` method to `WorksheetBuilder`, `StreamWriter`, and `WorksheetProxy` supporting `default_row_height:`, `default_col_width:`, and extended properties (`outline_level_row`, `outline_level_col`, `zero_height`, `custom_height`, `thick_top`, `thick_bottom`), serialize `<sheetFormatPr>` schema-compliantly in `WorksheetWriter` and `WorkbookWriter`, and expose `sheet_format` reader on `Elements::Worksheet` and `StreamSheet`.
+- Numeric and hexadecimal XML entity decoding in `XmlBuilder.unescape`: Support decoding decimal (`&#...;`) and hexadecimal (`&#x...;`) XML numeric character references with UTF-8 encoding and `RangeError` fallback.
+- ZIP64 extra field support in `ZipReader`: Support reading ZIP64 extra fields (`0x0001`) in both central directory headers and local file headers for 64-bit uncompressed sizes, compressed sizes, and local header offsets.
+- Expose `merged_cells` and `auto_filter` on `Elements::Worksheet`: Expose parsed sheet merge ranges and auto filter definitions directly on in-memory worksheets when loaded via `Xlsxrb.read` and `StreamSheet#load`.
+- Expose document properties and protection settings on `Elements::Workbook`: Expose `core_properties`, `app_properties`, `custom_properties`, and `workbook_protection` readers on in-memory workbooks, populating them during `Xlsxrb.read` from `docProps/core.xml`, `docProps/app.xml`, `docProps/custom.xml`, and `<workbookProtection>`.
+- Support updating cell hyperlinks and comments in `Xlsxrb.modify`: Synchronize modified cell hyperlinks and comments during template modification, updating or creating `_rels/sheetN.xml.rels`, `commentsN.xml`, `vmlDrawingN.vml`, and schema-compliant `<hyperlinks>` and `<legacyDrawing>` tags in worksheet XML.
+- Expose sheet structure, print, and view metadata on `Elements::Worksheet` and `StreamSheet`: Expose `tables`, `shapes`, `freeze_pane`, `page_setup`, `page_margins`, `header_footer`, `print_options`, `sheet_protection`, `sheet_view`, `sheet_properties`, `row_breaks`, and `col_breaks` on both streaming and in-memory worksheets.
+- WebAssembly Live Playground Monaco Editor integration: Replaced `<textarea>` with Monaco Editor in `docs/preview.html` featuring `vs-dark` theme, Ruby syntax highlighting, 2-space auto-indentation, auto-closing brackets and quotes, minimap, line numbers, and xlsxrb DSL snippet completion candidates (`Xlsxrb.write`, `wb.sheet`, `wb.style`, `s.row`, `s.column`, `s.chart`, `s.table`, `s.merge`, etc.). Implemented Blob URL worker initialization for Cross-Origin Isolation (COOP/COEP) compatibility and isolated AMD loader state during UMD binary bootstrap.
+- Automated documentation and playground verification (`rake doc:check`): Validate generated documentation assets (file existence, minimum sizes, and magic bytes), verify HTTP server responses (status 200/206, MIME types, COOP/COEP headers, and absence of invalid compression headers) via byte-range requests, and automatically parse and execute all Live Playground presets to guarantee error-free generation prior to preview and deployment.
+- WebAssembly Live Playground: Revamped `docs/preview.html` with current `Xlsxrb.write` DSL, added visually striking Executive Dashboard first view featuring an embedded Ruby gem logo image, KPI summary cards, zebra-striped table, currency formats, `=SUM` formulas, and a clustered bar chart in ~55 lines, added interactive preset selector with 11 spreadsheet scenarios (executive dashboard, sales reports, bar/line/pie charts, tables, borders, number formats, conditional formatting, hyperlinks, and Japanese text), direct URL deeplinking (`?example=...`), and seamless link integration throughout `VisualGallery.md` and `README.md`.
+- New visual examples and VRT baselines for missing formatting and print features: `hyperlinks.rb` (external and internal cell hyperlinks), `column_styles.rb` (column-level default number formats and styling), `page_repeat_rows.rb` (repeating header rows for print setup), and `sheet_protection.rb` (password protection with granular permissions).
+
+### Changed
+- Standardized top navigation header across all documentation pages and Live Playground: Unified navbar with `Documentation`, `Visual Gallery`, `Live Playground`, and `GitHub` navigation links, active page highlighting, search input, and SVG theme toggle.
+- Reorganized documentation sidebar navigation: Promoted `Visual Gallery` and `Live Playground` to prominent action items at the top of the sidebar, renamed the collapsible `docs` folder to an open `Guides` section, and formatted screaming uppercase filenames into clean Title Case labels (`Architecture`, `Development Guide`, etc.) to eliminate visual noise.
+- Enhanced search index discoverability: Pre-indexed all documentation guides, pages, and the Live Playground in `search_data.js` so search queries for "Visual Gallery", "Playground", and "Architecture" yield instant results.
+- Universal rendering without font tofu: Replaced theme toggle emojis with SVG sun and moon icons, and replaced README comparison table emoji checkmarks with accessible text badges (`Yes` / `-`) to eliminate tofu glyphs (`□`) across Linux and headless environments.
+- Visual Gallery layout polish: Constrained gallery overview thumbnails to 160px width with neat borders, styled `Live Playground` actions as interactive buttons, and constrained full baseline preview images to a maximum height of 480px to avoid unbounded scrolling whitespace.
+- Documentation callout banners: Transformed GitHub-style markdown alert blockquotes (`[!TIP]`, `[!NOTE]`, `[!WARNING]`) into styled callout banners with SVGs.
+- Cleaned up duplicated inline doc tags: Stripped repeated `rbs_inline: enabled` and `@api public` tags from generated module documentation.
+- Align WebAssembly Live Playground design with documentation: Unify `docs/preview.html` visual styling with the RDoc Aliki documentation design system, adding light and dark theme support with local storage persistence, synchronized Monaco Editor theme switching (`vs` and `vs-dark`), top navigation bar matching documentation layout with links to documentation and visual gallery, solid brand coral red Run button matching documentation accent tokens, and dynamic status dot indicator (`Initializing...`, `Ready`, `Rendering...`, `Error`).
+- Cleaned up visual examples and gallery generator: Stripped internal read validation debug dumps across all visual examples to present concise DSL code snippets, refreshed formula and merge syntax to use modern public APIs (`Xlsxrb.formula`, `A1:C1` ranges), and reorganized `VisualGallery.md` into 9 structured capability categories with dedicated preview tables and live playground links.
+- Removed non-visual and redundant visual examples: Removed `invoice_statement.rb` and `streaming_append.rb` and their baseline directories from the visual regression test suite and gallery.
+- Use `nil` for unstyled cells in `embedded_images.rb` example instead of undefined `"left"`.
+
+### Fixed
+- XML namespace prefix tolerance in template modification (`replace_sheet_data`): Locate `<sheetData>` and matching closing tags dynamically regardless of XML namespace prefixes (such as `<x:sheetData>` or `<d:sheetData>`) or self-closing syntax during `Xlsxrb.modify`.
+- Resilience against duplicate XML declarations and malformed `.rels` files in `RelationshipsParser`: Sanitize duplicate or multiple `<?xml ...?>` declarations and provide regex fallback scanning if SAX parsing fails on malformed relationship XML.
+- Fix false positive date detection for color tags like `[Red]` in `Ooxml::Reader#date_pattern?`: Unify custom number format date evaluation with `NumberFormatter.date_format?`, ignoring bracketed formatting codes (such as `[Red]` or `[Green]`) so negative numbers with colored styles are not misidentified as dates.
+- Fix layout overlap between Playground Run & Preview button and theme toggle: Override absolute positioning of `.theme-toggle` from RDoc Aliki styles with static inline-flex flow in `docs/preview.html` to eliminate button collision and preserve clean spacing across light and dark modes.
+- Prevent WebAssembly out-of-memory error during ZetaOffice instantiation on Firefox: Provide custom `Module.instantiateWasm` handler in `docs/preview.html` with streaming-first compilation (`WebAssembly.instantiateStreaming` / `WebAssembly.compileStreaming`) to bypass Emscripten's default `instantiateArrayBuffer` fallback that allocates an extra 160MB ArrayBuffer on memory pressure, and sequence Ruby Wasm and LibreOffice Wasm engine initialization to eliminate concurrent memory peaks.
+- Resolve WebAssembly Live Playground (`docs/preview.html`) console errors and warnings across Chromium and Firefox:
+  - Compile `ruby.wasm` via streaming (`WebAssembly.compileStreaming`) with automatic fallback to avoid large intermediate ArrayBuffer heap allocations, eliminating `InternalError: out of memory` on memory-constrained browser environments.
+  - Bypass service worker registration and reloading in `coi-serviceworker.js` when native Cross-Origin Isolation headers (`COOP`/`COEP`) are already present, preventing in-flight network request abortions (`NS_BINDING_ABORTED`).
+  - Filter benign C/C++ Emscripten/Qt runtime stderr diagnostics in `Module.printErr` and route diagnostic output to `console.log` rather than `console.warn`.
+  - Guard UNO document model close/dispose handling in `office_thread.js` to cleanly close previous models without emitting `console.warn` on preset switching or re-runs.
+- Prevent unhandled clipboard permission errors in Live Playground on Firefox: Intercept `navigator.permissions.query` in `docs/preview.html` and worker thread bootstrap to resolve dummy `PermissionStatus` objects for `clipboard-read` and `clipboard-write`, preventing uncaught `TypeError` exceptions from Embind in browsers that do not support clipboard descriptors in `PermissionDescriptor`.
+- Fix missing closing angle bracket on styled formula cells in `WorksheetWriter`: Add missing `>` before `<f>` element when emitting styled formula cells in `WorksheetWriter#write_row_values`, resolving XML syntax errors (`<c r="..." s="..."<f>`) that caused LibreOffice and spreadsheet engines to reject sheet formatting.
+- Prevent serialization of unresolved non-integer style names as `s` attribute in `WorksheetWriter`: Guard style resolution in `WorksheetWriter` to only emit valid integer style indices, ignoring unresolved strings or symbols to maintain ECMA-376 XML Schema conformance (`xs:unsignedInt`).
+- Prevent invalid `Content-Encoding: br` header in local `doc:preview` server: Remove erroneous Brotli encoding header injected on uncompressed Emscripten `.data` packages (such as `soffice.data`), and supply native Cross-Origin Isolation headers (`COOP`, `COEP`, `CORP`) to resolve browser decompression failures (`NS_ERROR_INVALID_CONTENT_ENCODING`).
+
 ## [0.1.14] - 2026-10-10
 
 ### Added

data/README.md

@@ -10,16 +10,17 @@ The Ruby ecosystem has several XLSX libraries designed for specific tradeoffs:
 
 | Library | Read | Write | Streaming | In-Memory |
 | :--- | :---: | :---: | :---: | :---: |
-| [roo](https://rubygems.org/gems/roo) | ✅ | ❌ | ✅ | ❌ |
-| [creek](https://rubygems.org/gems/creek) | ✅ | ❌ | ✅ | ❌ |
-| [xsv](https://rubygems.org/gems/xsv) | ✅ | ❌ | ✅ | ❌ |
-| [simple_xlsx_reader](https://rubygems.org/gems/simple_xlsx_reader) | ✅ | ❌ | ✅ | ❌ |
-| [caxlsx / axlsx](https://rubygems.org/gems/caxlsx) | ❌ | ✅ | ❌ | ✅ |
-| [write_xlsx](https://rubygems.org/gems/write_xlsx) | ❌ | ✅ | ❌ | ✅ |
-| [xlsxtream](https://rubygems.org/gems/xlsxtream) | ❌ | ✅ | ✅ | ❌ |
-| [fast_excel](https://rubygems.org/gems/fast_excel) | ❌ | ✅ | ✅ | ❌ |
-| [rubyXL](https://rubygems.org/gems/rubyXL) | ✅ | ✅ | ❌ | ✅ |
-| [xlsxrb](https://github.com/niku/xlsxrb) | ✅ | ✅ | ✅ | ✅ |
+| [roo](https://rubygems.org/gems/roo) | Yes | - | - | Yes |
+| [creek](https://rubygems.org/gems/creek) | Yes | - | Yes | - |
+| [xsv](https://rubygems.org/gems/xsv) | Yes | - | Yes | - |
+| [simple_xlsx_reader](https://rubygems.org/gems/simple_xlsx_reader) | Yes | - | Yes | - |
+| [caxlsx / axlsx](https://rubygems.org/gems/caxlsx) | - | Yes | - | Yes |
+| [write_xlsx](https://rubygems.org/gems/write_xlsx) | - | Yes | - | Yes |
+| [xlsxtream](https://rubygems.org/gems/xlsxtream) | - | Yes | Yes | - |
+| [fast_excel](https://rubygems.org/gems/fast_excel) | - | Yes | Yes | - |
+| [rubyXL](https://rubygems.org/gems/rubyXL) | Yes | Yes | - | Yes |
+| [xlsxrb](https://github.com/niku/xlsxrb) | Yes | Yes | Yes | Yes |
+
 
 These libraries make different architectural tradeoffs:
 * Streaming Model: Writes or reads rows sequentially on-the-fly to maintain a constant $O(1)$, low-memory footprint regardless of dataset size.
@@ -39,7 +40,7 @@ Maintaining a gem that supports both reading and writing across streaming and in
 
 ### Autonomous Quality Assurance
 
-To maintain its multi-layered QA suite (Steep static typing, 100% mutation kill rate across 38 subjects, ECMA-376 XSD validation, and $O(1)$ streaming memory) without high manual maintenance overhead, xlsxrb defines remediation workflows for AI coding agents ([AGENTS.md](AGENTS.md), [docs/QA_AGENTS.md](docs/QA_AGENTS.md)).
+To maintain its multi-layered QA suite (Steep static typing, 100% mutation kill rate across 43 subjects, ECMA-376 XSD validation, and $O(1)$ streaming memory) without high manual maintenance overhead, xlsxrb defines remediation workflows for AI coding agents ([AGENTS.md](AGENTS.md), [docs/QA_AGENTS.md](docs/QA_AGENTS.md)).
 
 ## Installation
 
@@ -52,13 +53,13 @@ bundle add xlsxrb
 
 Try `xlsxrb` directly in your browser without installing anything!
 
-[👉 Try the Live Demo / Interactive Playground](https://niku.github.io/xlsxrb/docs/visual/VisualGallery_md.html)
+[Try the Live Demo / Interactive Playground](https://niku.github.io/xlsxrb/preview.html)
 
 <p align="center">
   <img src="docs/assets/playground_preview.png" width="100%" alt="Interactive WebAssembly Playground with Live LibreOffice Preview"/>
 </p>
 
-You can also browse 50+ rendered visual examples across all features in the [Visual Examples Gallery](docs/visual/VisualGallery.md).
+You can also browse 80+ rendered visual examples across all features in the [Visual Examples Gallery](docs/visual/VisualGallery.md).
 
 ## Usage
 
@@ -172,7 +173,7 @@ Verified by a multi-layered QA architecture:
 * Microsoft Open XML SDK Validation: Validates generated OOXML structures against Microsoft's official SDK.
 * Visual Regression Testing (VRT): Headless LibreOffice Calc pixel-by-pixel rendering checks.
 * Contract & Round-Trip Tests: Verifies parity between Streaming and In-Memory APIs and round-trip read/write accuracy.
-* Mutation Testing (Mutant): 100% mutant kill rate (1,091/1,091 mutations across 38 subjects) on pure algorithms, predicates, and coordinates ([docs/MUTATION_TESTING.md](docs/MUTATION_TESTING.md)).
+* Mutation Testing (Mutant): 100% mutant kill rate (1,528/1,528 mutations across 43 subjects) on pure algorithms, predicates, and coordinates ([docs/MUTATION_TESTING.md](docs/MUTATION_TESTING.md)).
 * Security & DoS Protection: Formula injection mitigation and ZIP bomb protection.
 
 For full architectural details, see [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) and [docs/QUALITY_ASSURANCE.md](docs/QUALITY_ASSURANCE.md).

data/lib/xlsxrb/elements/workbook.rb

@@ -72,6 +72,42 @@ module Xlsxrb
         props&.[](:date1904) ? true : false
       end
 
+      # Returns core document properties (e.g. title, creator, created), or an empty hash.
+      #
+      # @return [Hash<Symbol, untyped>]
+      # @api public
+      #: () -> Hash[Symbol, untyped]
+      def core_properties
+        unmapped_data[:core_properties] || unmapped_data.dig(:facade, :core_properties) || {}
+      end
+
+      # Returns application properties (e.g. app_name, doc_security), or an empty hash.
+      #
+      # @return [Hash<Symbol, untyped>]
+      # @api public
+      #: () -> Hash[Symbol, untyped]
+      def app_properties
+        unmapped_data[:app_properties] || unmapped_data.dig(:facade, :app_properties) || {}
+      end
+
+      # Returns custom document properties as an array of property hashes, or an empty array.
+      #
+      # @return [Array<Hash[Symbol, untyped]>]
+      # @api public
+      #: () -> Array[Hash[Symbol, untyped]]
+      def custom_properties
+        unmapped_data[:custom_properties] || unmapped_data.dig(:facade, :custom_properties) || []
+      end
+
+      # Returns workbook protection settings as a hash, or nil if unprotected.
+      #
+      # @return [Hash[Symbol, untyped], nil]
+      # @api public
+      #: () -> Hash[Symbol, untyped]?
+      def workbook_protection
+        unmapped_data[:workbook_protection] || unmapped_data.dig(:facade, :workbook_protection)
+      end
+
       # Returns the defined name matching name (and optionally sheet), or nil.
       #
       # @example

data/lib/xlsxrb/elements/worksheet.rb

@@ -17,7 +17,7 @@ module Xlsxrb
     class Worksheet
       [Enumerable, CoordinateAccess].each { |m| include m }
 
-      attr_reader :name, :rows, :columns, :charts, :conditional_formatting, :data_validations, :unmapped_data, :errors, :state, :hyperlinks, :comments, :images, :styles, :date1904, :print_area, :print_titles, :sparkline_groups
+      attr_reader :name, :rows, :columns, :charts, :conditional_formatting, :data_validations, :unmapped_data, :errors, :state, :hyperlinks, :comments, :images, :styles, :date1904, :print_area, :print_titles, :sparkline_groups, :merged_cells, :auto_filter, :tables, :shapes, :freeze_pane, :page_setup, :page_margins, :header_footer, :print_options, :sheet_protection, :sheet_view, :sheet_properties, :sheet_format, :row_breaks, :col_breaks, :protected_ranges, :cell_watches
       attr_writer :dimension
       alias conditional_formats conditional_formatting
 
@@ -42,8 +42,25 @@ module Xlsxrb
       # @param print_area [String, nil] Sheet print area range (e.g. "A1:H50").
       # @param print_titles [Hash, nil] Repeating print title rows/cols (e.g. { rows: "1:2", cols: "A:B" }).
       # @param sparkline_groups [Array<Hash>] Sparkline groups in the sheet.
-      #: (name: String?, ?rows: Array[Elements::Row], ?columns: Array[Elements::Column], ?charts: Array[Hash[Symbol, untyped]], ?conditional_formatting: Array[Hash[Symbol, untyped]]?, ?data_validations: Array[Hash[Symbol, untyped]], ?unmapped_data: Hash[untyped, untyped], ?errors: Array[String]?, ?conditional_formats: Array[Hash[Symbol, untyped]]?, ?state: Symbol, ?hyperlinks: Hash[String, Hash[Symbol, untyped]], ?comments: Array[Hash[Symbol, untyped]], ?images: Array[Elements::Image], ?styles: Hash[untyped, untyped]?, ?date1904: bool, ?dimension: String?, ?trim_empty_rows: bool, ?pad_empty_rows: bool, ?pad_empty_cells: bool, ?print_area: String?, ?print_titles: Hash[Symbol, untyped]?, ?sparkline_groups: Array[Hash[Symbol, untyped]]) -> void
-      def initialize(name:, rows: [], columns: [], charts: [], conditional_formatting: nil, data_validations: [], unmapped_data: {}, errors: nil, conditional_formats: nil, state: :visible, hyperlinks: {}, comments: [], images: [], styles: nil, date1904: false, dimension: nil, trim_empty_rows: false, pad_empty_rows: false, pad_empty_cells: false, print_area: nil, print_titles: nil, sparkline_groups: [])
+      # @param merged_cells [Array<String>] Merged cell ranges (e.g. ["A1:B2"]).
+      # @param auto_filter [String, nil] AutoFilter range (e.g. "A1:E10").
+      # @param tables [Array<Hash>] Table definitions in the sheet.
+      # @param shapes [Array<Hash>] Shape definitions in the sheet.
+      # @param freeze_pane [Hash, nil] Freeze pane settings (e.g. { row: 1, col: 0 }).
+      # @param page_setup [Hash] Page setup properties (e.g. orientation, paper size).
+      # @param page_margins [Hash, nil] Page margins settings.
+      # @param header_footer [Hash] Header and footer configurations.
+      # @param print_options [Hash] Print options (e.g. gridlines, headings).
+      # @param sheet_protection [Hash, nil] Sheet protection settings.
+      # @param sheet_view [Hash] Sheet view configurations (e.g. zoom, gridlines).
+      # @param sheet_properties [Hash] Sheet properties (e.g. tabColor, outlinePr).
+      # @param sheet_format [Hash] Sheet format properties (e.g. defaultRowHeight, defaultColWidth).
+      # @param row_breaks [Array<Integer | Hash>] Explicit page row breaks.
+      # @param col_breaks [Array<Integer | Hash>] Explicit page column breaks.
+      # @param protected_ranges [Array<Hash>] Protected range definitions.
+      # @param cell_watches [Array<String>] Watched cell references.
+      #: (name: String?, ?rows: Array[Elements::Row], ?columns: Array[Elements::Column], ?charts: Array[Hash[Symbol, untyped]], ?conditional_formatting: Array[Hash[Symbol, untyped]]?, ?data_validations: Array[Hash[Symbol, untyped]], ?unmapped_data: Hash[untyped, untyped], ?errors: Array[String]?, ?conditional_formats: Array[Hash[Symbol, untyped]]?, ?state: Symbol, ?hyperlinks: Hash[String, untyped], ?comments: Array[Hash[Symbol, untyped]], ?images: Array[Elements::Image], ?styles: Hash[untyped, untyped]?, ?date1904: bool, ?dimension: String?, ?trim_empty_rows: bool, ?pad_empty_rows: bool, ?pad_empty_cells: bool, ?print_area: String?, ?print_titles: Hash[Symbol, untyped]?, ?sparkline_groups: Array[Hash[Symbol, untyped]], ?merged_cells: Array[String], ?auto_filter: String?, ?tables: Array[Hash[Symbol, untyped]], ?shapes: Array[Hash[Symbol, untyped]], ?freeze_pane: Hash[Symbol, untyped]?, ?page_setup: Hash[Symbol, untyped], ?page_margins: Hash[Symbol, untyped]?, ?header_footer: Hash[Symbol, untyped], ?print_options: Hash[Symbol, untyped], ?sheet_protection: Hash[Symbol, untyped]?, ?sheet_view: Hash[Symbol, untyped], ?sheet_properties: Hash[Symbol, untyped], ?sheet_format: Hash[Symbol, untyped], ?row_breaks: Array[untyped], ?col_breaks: Array[untyped], ?protected_ranges: Array[Hash[Symbol, untyped]], ?cell_watches: Array[String]) -> void
+      def initialize(name:, rows: [], columns: [], charts: [], conditional_formatting: nil, data_validations: [], unmapped_data: {}, errors: nil, conditional_formats: nil, state: :visible, hyperlinks: {}, comments: [], images: [], styles: nil, date1904: false, dimension: nil, trim_empty_rows: false, pad_empty_rows: false, pad_empty_cells: false, print_area: nil, print_titles: nil, sparkline_groups: [], merged_cells: [], auto_filter: nil, tables: [], shapes: [], freeze_pane: nil, page_setup: {}, page_margins: nil, header_footer: {}, print_options: {}, sheet_protection: nil, sheet_view: {}, sheet_properties: {}, sheet_format: {}, row_breaks: [], col_breaks: [], protected_ranges: [], cell_watches: [])
         @name = name
         @rows = (rows || []).freeze
         @columns = (columns || []).freeze
@@ -67,6 +84,23 @@ module Xlsxrb
         @trim_empty_rows = trim_empty_rows ? true : false
         @pad_empty_rows = pad_empty_rows ? true : false
         @pad_empty_cells = pad_empty_cells ? true : false
+        @merged_cells = (merged_cells || []).freeze
+        @auto_filter = auto_filter
+        @tables = (tables || []).freeze
+        @shapes = (shapes || []).freeze
+        @freeze_pane = freeze_pane&.freeze
+        @page_setup = (page_setup || {}).freeze
+        @page_margins = page_margins&.freeze
+        @header_footer = (header_footer || {}).freeze
+        @print_options = (print_options || {}).freeze
+        @sheet_protection = sheet_protection&.freeze
+        @sheet_view = (sheet_view || {}).freeze
+        @sheet_properties = (sheet_properties || {}).freeze
+        @sheet_format = (sheet_format || unmapped_data[:sheet_format] || unmapped_data.dig(:facade, :sheet_format) || {}).freeze
+        @row_breaks = (row_breaks || []).freeze
+        @col_breaks = (col_breaks || []).freeze
+        @protected_ranges = (protected_ranges || unmapped_data[:protected_ranges] || unmapped_data.dig(:facade, :protected_ranges) || []).freeze
+        @cell_watches = (cell_watches || unmapped_data[:cell_watches] || unmapped_data.dig(:facade, :cell_watches) || []).freeze
       end
 
       # Returns whether trailing empty rows are omitted during iteration.
@@ -488,6 +522,23 @@ module Xlsxrb
         new_print_titles = changes.key?(:print_titles) ? changes[:print_titles] : print_titles
         new_sparklines = changes.key?(:sparkline_groups) ? changes[:sparkline_groups] : sparkline_groups
         new_trim = changes.key?(:trim_empty_rows) ? changes[:trim_empty_rows] : @trim_empty_rows
+        new_merged = changes.key?(:merged_cells) ? changes[:merged_cells] : merged_cells
+        new_auto_filter = changes.key?(:auto_filter) ? changes[:auto_filter] : auto_filter
+        new_tables = changes.key?(:tables) ? changes[:tables] : tables
+        new_shapes = changes.key?(:shapes) ? changes[:shapes] : shapes
+        new_freeze_pane = changes.key?(:freeze_pane) ? changes[:freeze_pane] : freeze_pane
+        new_page_setup = changes.key?(:page_setup) ? changes[:page_setup] : page_setup
+        new_page_margins = changes.key?(:page_margins) ? changes[:page_margins] : page_margins
+        new_header_footer = changes.key?(:header_footer) ? changes[:header_footer] : header_footer
+        new_print_options = changes.key?(:print_options) ? changes[:print_options] : print_options
+        new_sheet_protection = changes.key?(:sheet_protection) ? changes[:sheet_protection] : sheet_protection
+        new_sheet_view = changes.key?(:sheet_view) ? changes[:sheet_view] : sheet_view
+        new_sheet_properties = changes.key?(:sheet_properties) ? changes[:sheet_properties] : sheet_properties
+        new_sheet_format = changes.key?(:sheet_format) ? changes[:sheet_format] : sheet_format
+        new_row_breaks = changes.key?(:row_breaks) ? changes[:row_breaks] : row_breaks
+        new_col_breaks = changes.key?(:col_breaks) ? changes[:col_breaks] : col_breaks
+        new_protected_ranges = changes.key?(:protected_ranges) ? changes[:protected_ranges] : protected_ranges
+        new_cell_watches = changes.key?(:cell_watches) ? changes[:cell_watches] : cell_watches
 
         self.class.new(
           name: new_name,
@@ -507,7 +558,24 @@ module Xlsxrb
           print_area: new_print_area,
           print_titles: new_print_titles,
           sparkline_groups: new_sparklines,
-          trim_empty_rows: new_trim
+          trim_empty_rows: new_trim,
+          merged_cells: new_merged,
+          auto_filter: new_auto_filter,
+          tables: new_tables,
+          shapes: new_shapes,
+          freeze_pane: new_freeze_pane,
+          page_setup: new_page_setup,
+          page_margins: new_page_margins,
+          header_footer: new_header_footer,
+          print_options: new_print_options,
+          sheet_protection: new_sheet_protection,
+          sheet_view: new_sheet_view,
+          sheet_properties: new_sheet_properties,
+          sheet_format: new_sheet_format,
+          row_breaks: new_row_breaks,
+          col_breaks: new_col_breaks,
+          protected_ranges: new_protected_ranges,
+          cell_watches: new_cell_watches
         )
       end
 
@@ -533,7 +601,22 @@ module Xlsxrb
           print_area: print_area,
           print_titles: print_titles,
           sparkline_groups: sparkline_groups,
-          trim_empty_rows: @trim_empty_rows
+          trim_empty_rows: @trim_empty_rows,
+          merged_cells: merged_cells,
+          auto_filter: auto_filter,
+          tables: tables,
+          shapes: shapes,
+          freeze_pane: freeze_pane,
+          page_setup: page_setup,
+          page_margins: page_margins,
+          header_footer: header_footer,
+          print_options: print_options,
+          sheet_protection: sheet_protection,
+          sheet_view: sheet_view,
+          sheet_properties: sheet_properties,
+          sheet_format: sheet_format,
+          row_breaks: row_breaks,
+          col_breaks: col_breaks
         }
       end
 
@@ -544,13 +627,25 @@ module Xlsxrb
 
         name == other.name && rows == other.rows && columns == other.columns && charts == other.charts &&
           conditional_formatting == other.conditional_formatting && data_validations == other.data_validations &&
-          state == other.state && hyperlinks == other.hyperlinks && comments == other.comments
+          state == other.state && hyperlinks == other.hyperlinks && comments == other.comments &&
+          merged_cells == other.merged_cells && auto_filter == other.auto_filter &&
+          tables == other.tables && shapes == other.shapes && freeze_pane == other.freeze_pane &&
+          page_setup == other.page_setup && page_margins == other.page_margins &&
+          header_footer == other.header_footer && print_options == other.print_options &&
+          sheet_protection == other.sheet_protection && sheet_view == other.sheet_view &&
+          sheet_properties == other.sheet_properties && sheet_format == other.sheet_format &&
+          row_breaks == other.row_breaks && col_breaks == other.col_breaks
       end
       alias eql? ==
 
       #: () -> Integer
       def hash
-        [self.class, name, rows, columns, charts, conditional_formatting, data_validations, state, hyperlinks, comments].hash
+        [
+          self.class, name, rows, columns, charts, conditional_formatting, data_validations,
+          state, hyperlinks, comments, merged_cells, auto_filter, tables, shapes, freeze_pane,
+          page_setup, page_margins, header_footer, print_options, sheet_protection, sheet_view,
+          sheet_properties, sheet_format, row_breaks, col_breaks
+        ].hash
       end
 
       # Returns self when load is called on an already in-memory Worksheet.

data/lib/xlsxrb/ooxml/reader/listeners/feature_listeners.rb

@@ -204,7 +204,7 @@ module Xlsxrb
         def start_element(_uri, local_name, qname, _attributes)
           name = element_name(local_name, qname)
           case name
-          when "Application", "AppVersion"
+          when "Application", "AppVersion", "Company", "Manager"
             @current_field = name
             @text_buffer = +""
           when "HeadingPairs"
@@ -232,6 +232,12 @@ module Xlsxrb
           when "AppVersion"
             @properties[:app_version] = @text_buffer.dup
             @current_field = nil
+          when "Company"
+            @properties[:company] = @text_buffer.dup
+            @current_field = nil
+          when "Manager"
+            @properties[:manager] = @text_buffer.dup
+            @current_field = nil
           when "lpstr"
             if @inside_titles_of_parts
               @titles_of_parts << @text_buffer.dup

data/lib/xlsxrb/ooxml/reader.rb

@@ -5,6 +5,7 @@
 require "zlib"
 require "rexml/parsers/sax2parser"
 require "rexml/sax2listener"
+require_relative "../number_formatter"
 
 module Xlsxrb
   module Ooxml
@@ -1280,9 +1281,7 @@ module Xlsxrb
       end
 
       def date_pattern?(code)
-        # Strip quoted strings to avoid false matches.
-        stripped = code.gsub(/"[^"]*"/, "").gsub(/\\[.]/, "")
-        stripped.match?(/[ymdhsYMDHS]/)
+        NumberFormatter.date_format?(code)
       end
 
       def extract_zip_entry(entry_name)

data/lib/xlsxrb/ooxml/workbook_parser.rb

@@ -89,8 +89,28 @@ module Xlsxrb
       def self.parse(xml_string)
         return {} if xml_string.nil? || xml_string.empty?
 
+        sanitized = xml_string.lstrip
+        if sanitized.start_with?("<?xml")
+          first_decl_end = sanitized.index("?>")
+          if first_decl_end
+            decl = sanitized[0..(first_decl_end + 1)]
+            rest = sanitized[(first_decl_end + 2)..].gsub(/<\?xml\b[^>]*\?>/i, "")
+            sanitized = "#{decl}#{rest}".lstrip
+          end
+        end
+
         listener = Listener.new
-        XmlParser.parse(xml_string, listener)
+        begin
+          XmlParser.parse(sanitized, listener)
+        rescue StandardError
+          # Fallback to regex scanning if SAX parser fails on malformed XML
+          sanitized.scan(%r{<(?:[a-zA-Z0-9_]+:)?Relationship\b([^>]*)/?>}i) do |match|
+            attrs_str = match[0]
+            id = attrs_str[/\bId=["']([^"']+)["']/i, 1]
+            target = attrs_str[/\bTarget=["']([^"']+)["']/i, 1]
+            listener.relationships[id] = target if id && target
+          end
+        end
         listener.relationships
       end
 

data/lib/xlsxrb/ooxml/workbook_writer.rb

@@ -93,6 +93,9 @@ module Xlsxrb
               selection: sheet[:selection],
               sheet_view: sheet[:sheet_view],
               sheet_properties: sheet[:sheet_properties],
+              sheet_format: sheet[:sheet_format],
+              protected_ranges: sheet[:protected_ranges],
+              cell_watches: sheet[:cell_watches],
               tables: sheet_tables,
               table_start_rid: info[:table_start_rid],
               legacy_drawing_rid: info[:vml_rid],
@@ -917,14 +920,14 @@ module Xlsxrb
       end
 
       def write_worksheet_xml(io, sheet, drawing_rid: nil, sheet_protection: nil,
-                              auto_filter: nil, filter_columns: nil, sort_state: nil,
-                              merge_cells: nil, conditional_formats: nil,
+                              protected_ranges: nil, auto_filter: nil, filter_columns: nil,
+                              sort_state: nil, merge_cells: nil, conditional_formats: nil,
                               data_validations: nil, hyperlinks: nil,
                               print_options: nil, page_margins: nil, page_setup: nil,
                               header_footer: nil, row_breaks: nil, col_breaks: nil,
-                              freeze_pane: nil, split_pane: nil, selection: nil,
-                              sheet_view: nil, sheet_properties: nil,
-                              tables: nil, table_start_rid: nil,
+                              cell_watches: nil, freeze_pane: nil, split_pane: nil,
+                              selection: nil, sheet_view: nil, sheet_properties: nil,
+                              sheet_format: nil, tables: nil, table_start_rid: nil,
                               legacy_drawing_rid: nil, sparkline_groups: nil)
         date1904 = @workbook_properties&.[](:date1904) ? true : false
         ws = WorksheetWriter.new(io, date1904: date1904)
@@ -934,7 +937,8 @@ module Xlsxrb
           freeze_pane: freeze_pane,
           split_pane: split_pane,
           selection: selection,
-          sheet_view: sheet_view
+          sheet_view: sheet_view,
+          sheet_format: sheet_format
         )
         if sheet[:rows_tmp_path]
           File.open(sheet[:rows_tmp_path], "rb") do |f|
@@ -961,6 +965,7 @@ module Xlsxrb
         ws.finish(
           drawing_rid: drawing_rid,
           sheet_protection: sheet_protection,
+          protected_ranges: protected_ranges,
           auto_filter: auto_filter,
           filter_columns: filter_columns,
           sort_state: sort_state,
@@ -974,6 +979,7 @@ module Xlsxrb
           header_footer: header_footer,
           row_breaks: row_breaks,
           col_breaks: col_breaks,
+          cell_watches: cell_watches,
           tables: tables,
           table_start_rid: table_start_rid,
           legacy_drawing_rid: legacy_drawing_rid,
@@ -1102,11 +1108,13 @@ module Xlsxrb
         @custom_properties.each_with_index do |prop, idx|
           b.open_tag("property", { fmtid: "{D5CDD505-2E9C-101B-9397-08002B2CF9AE}", pid: (idx + 2).to_s, name: prop[:name] })
           case prop[:type]
-          when :number
+          when :number, :int, :i4
             b.tag("vt:i4") { |_| b.text(prop[:value].to_s) }
-          when :bool
+          when :float, :r8
+            b.tag("vt:r8") { |_| b.text(prop[:value].to_s) }
+          when :bool, :boolean
             b.tag("vt:bool") { |_| b.text(prop[:value] ? "true" : "false") }
-          when :date
+          when :date, :filetime
             b.tag("vt:filetime") { |_| b.text(prop[:value].to_s) }
           else
             b.tag("vt:lpwstr") { |_| b.text(prop[:value].to_s) }