xlsxrb 0.1.11 → 0.1.13

data/docs/PEER_LIBRARIES.md

@@ -1,121 +0,0 @@
-# Ruby XLSX Ecosystem & Peer Libraries
-
-The Ruby ecosystem is fortunate to have a rich set of mature, well-engineered XLSX libraries. Each library represents deliberate architectural choices tailored for specific problem spaces.
-
-This document provides a respectful overview of the peer libraries in the Ruby ecosystem, explains the underlying engineering tradeoffs (such as Streaming vs. In-Memory and Shared String Tables vs. Inline Strings), and shares comprehensive benchmark measurements.
-
----
-
-## The Peer Libraries
-
-| Library | I/O | Official Self-Description / Focus | Best Fit (In Our View) |
-| :--- | :---: | :--- | :--- |
-| **[roo](https://rubygems.org/gems/roo)** | `R` | *"Roo can access the contents of various spreadsheet files (Excelx, LibreOffice, OpenOffice, CSV)."* | Unified interface for reading across diverse spreadsheet formats. |
-| **[creek](https://rubygems.org/gems/creek)** | `R` | *"A Ruby gem that streams and parses large Excel (xlsx and xlsm) files fast and efficiently."* | Streaming large spreadsheet uploads row-by-row with lightweight SAX parsing. |
-| **[xsv](https://rubygems.org/gems/xsv)** | `R` | *"A fast and lightweight xlsx parser that provides nothing a CSV parser wouldn't."* | High-speed, CSV-like tabular data ingestion without styling overhead. |
-| **[simple_xlsx_reader](https://rubygems.org/gems/simple_xlsx_reader)** | `R` | *"Read xlsx data the Ruby way"* — parses sheets into Ruby primitives with low memory. | Memory-conscious tabular data extraction directly into Ruby types. |
-| **[caxlsx / axlsx](https://rubygems.org/gems/caxlsx)** | `W` | *"Excel OOXML (xlsx) with charts, styles, images and autowidth columns"* with full schema validation. | Generating rich, styled business reports with charts, images, and visual design. |
-| **[write_xlsx](https://rubygems.org/gems/write_xlsx)** | `W` | Pure Ruby port of Perl's `Excel::Writer::XLSX` to create files in modern Excel 2007+ format. | Creating complex spreadsheets requiring exact Excel feature parity. |
-| **[xlsxtream](https://rubygems.org/gems/xlsxtream)** | `W` | *"A streaming XLSX spreadsheet writer"* allowing very efficient writing of CSV-style data. | Ultra-fast, low-memory streaming exports of massive tabular datasets. |
-| **[fast_excel](https://rubygems.org/gems/fast_excel)** | `W` | *"Ultra Fast Excel Writer"* — C-extension wrapper for `libxlsxwriter` with constant memory mode. | Maximum-throughput spreadsheet generation when C-extensions are available. |
-| **[rubyXL](https://rubygems.org/gems/rubyXL)** | `RW` | *"Allows the parsing, creation, and manipulation of Microsoft Excel (.xlsx/.xlsm) Documents."* | Full document DOM inspection, in-memory cell modification, and template editing. |
-| **[xlsxrb](https://github.com/niku/xlsxrb)** | `RW` | Pure Ruby library unifying streaming read/write ($O(1)$ memory) and in-memory manipulation with native encryption. | Unified reading, writing, template modification, and password encryption in pure Ruby. |
-
-
----
-
-## Architectural Tradeoffs
-
-Spreadsheet libraries must balance multiple competing dimensions: memory consumption, execution speed, formatting capabilities, and strict specification compliance.
-
-### 1. Memory & Execution Model: Streaming vs. In-Memory
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│                      Execution Models                       │
-├──────────────────────────────┬──────────────────────────────┤
-│       Streaming Model        │       In-Memory Model        │
-├──────────────────────────────┼──────────────────────────────┤
-│ • Processes rows on-the-fly  │ • Builds complete DOM tree   │
-│ • O(1) constant RAM footprint│ • Enables random cell access │
-│ • Cannot seek backward       │ • High RAM on large datasets │
-│ • Ideal for batch exports/ETL│ • Ideal for templates/edits  │
-└──────────────────────────────┴──────────────────────────────┘
-```
-
-* **Streaming Model** (`xlsxrb`, `xlsxtream`, `simple_xlsx_reader`, `roo`, `creek`, `xsv`):
-  Rows and cells are processed sequentially and flushed/discarded immediately. This keeps memory usage completely flat and predictable, regardless of whether the file has 10 rows or 1,000,000 rows. However, random access (e.g., modifying `cell("A1")` after writing row 100) is not possible.
-* **In-Memory Model** (`xlsxrb`, `caxlsx`, `write_xlsx`, `rubyXL`):
-  The entire workbook structure is parsed into Ruby objects, providing complete flexibility to inspect, modify, insert, or reorder cells and worksheets. The tradeoff is that memory consumption scales with the number of cells.
-
----
-
-### 2. String Storage Architecture: Shared String Table (SST) vs. Inline Strings
-
-The OpenXML (ECMA-376) specification defines two ways to store text in cells:
-
-```xml
-<!-- 1. Shared String Table (SST): Deduplicated dictionary reference -->
-<c r="A1" t="s"><v>0</v></c>
-
-<!-- 2. Inline String: Raw text payload inside the cell -->
-<c r="A1" t="inlineStr"><is><t>Hello World</t></is></c>
-```
-
-#### Shared String Table (SST)
-* **How it works**: Strings across all worksheets are collected into a single central dictionary (`xl/sharedStrings.xml`). Cells only store numeric integer IDs pointing to dictionary entries.
-* **Strengths**:
-  * **Smaller file footprint**: Deduplication significantly reduces the uncompressed XML size (typically 50% to 80% smaller for business datasets with repetitive categories, statuses, dates, and labels).
-  * **Standard Microsoft Excel behavior**: Excel defaults to SST. Opening SST-based spreadsheets in Excel consumes less memory and renders faster.
-  * **Rich Text & Shared Styles**: Supports rich text formatting within strings.
-* **Tradeoff**:
-  * Writing requires managing a string table dictionary or making a multi-pass serialization, adding slight CPU overhead during generation.
-
-#### Inline Strings
-* **How it works**: Text is written directly into each `<c>` element (`<is><t>...</t></is>`) as the stream proceeds.
-* **Strengths**:
-  * **Raw Throughput**: Bypassing string deduplication allows immediate row-by-row flushing with minimal CPU overhead (as demonstrated by `xlsxtream`).
-* **Tradeoff**:
-  * Produces significantly larger raw XML files when strings repeat, and some third-party spreadsheet viewers or legacy tools have limited support for inline strings compared to SST.
-
----
-
-## Detailed Benchmark Results
-
-The following benchmarks evaluate processing **1,000,000 cells** (100,000 rows × 10 columns) containing standard business data (integers, strings, floats, booleans, and dates) across 3 isolated subprocess runs.
-
-### Write Performance (1,000,000 cells)
-
-| Library | Version | Model | String Storage | Time (Median) | Time (Mean) | Peak Memory | GC Count |
-| :--- | :--- | :--- | :--- | :--- | :--- | :--- | :--- |
-| **xlsxrb (Streaming)** | - | Streaming | SST (Shared) | **0.95 s** | **0.95 s** | 67.6 MB | **34.0** |
-| **xlsxtream** | 3.1.0 | Streaming | Inline String | 1.16 s | 1.17 s | **17.0 MB** | 323.0 |
-| **fast_excel** | 0.5.0 | Streaming | SST (Shared) | 2.02 s | 2.14 s | 148.3 MB | 210.0 |
-| **xlsxrb (In-Memory)** | - | In-Memory | SST (Shared) | 2.42 s | 2.57 s | 209.0 MB | 16.0 |
-| **write_xlsx** | 1.15.0 | In-Memory | SST (Shared) | 4.39 s | 4.42 s | 217.4 MB | 25.0 |
-| **caxlsx** | 4.5.0 | In-Memory | Inline String | 5.28 s | 5.28 s | 177.4 MB | 24.0 |
-| **rubyXL** | 3.4.38 | In-Memory | Inline String | 43.13 s | 43.65 s | 2167.2 MB | 101.0 |
-
-### Read Performance (1,000,000 cells)
-
-| Library | Version | Model | Time (Median) | Time (Mean) | Peak Memory | GC Count |
-| :--- | :--- | :--- | :--- | :--- | :--- | :--- |
-| **xlsxrb (Streaming)** | - | Streaming | **1.73 s** | **1.72 s** | 136.2 MB | **45.0** |
-| **xlsxrb (In-Memory)** | - | In-Memory | 4.33 s | 4.46 s | 304.3 MB | 77.0 |
-| **simple_xlsx_reader** | 5.1.0 | Streaming | 4.38 s | 4.41 s | **32.8 MB** | 918.0 |
-| **creek** | 2.6.3 | Streaming | 7.12 s | 7.05 s | 840.1 MB | 419.0 |
-| **roo** | 3.0.0 | Streaming | 10.95 s | 10.33 s | 123.4 MB | 196.0 |
-| **xsv** | 1.4.1 | Streaming | 14.56 s | 14.59 s | 73.6 MB | 2028.0 |
-| **rubyXL** | 3.4.38 | In-Memory | 30.74 s | 30.78 s | 2289.6 MB | 146.0 |
-
----
-
-## Reproducing Benchmarks Locally
-
-The benchmark suite leverages [`bundler/inline`](https://bundler.io/v2.5/guides/bundler_in_a_single_file_ruby_script.html) to run each library in an isolated subprocess (`Bundler.with_unbundled_env`), eliminating cross-gem pollution and ensuring accurate memory measurements.
-
-To run the suite on your machine:
-
-```bash
-ruby benchmark.rb 100000 10
-```

data/docs/QUALITY_ASSURANCE.md

@@ -1,25 +0,0 @@
-# Quality Assurance (QA) & Testing Architecture
-
-`xlsxrb` is designed to be an enterprise-grade, highly reliable, and highly performant library for reading and writing Excel spreadsheets. To achieve and maintain this standard, we have implemented a comprehensive Quality Assurance matrix that covers everything from static code analysis and dynamic runtime validation to performance benchmarking and visual regression testing.
-
-Below is an overview of the inspection mechanisms, when they run, the quality attributes they guarantee, and the specific bugs they prevent.
-
-## QA Matrix
-
-| Inspection Mechanism / Tool | Execution Command / Mechanism | Local | CI (PR/Push) | Scheduled (Weekly) | Target Quality Attribute | Validation Method | Prevented Bugs / Issues |
-| :--- | :--- | :---: | :---: | :---: | :--- | :--- | :--- |
-| **RuboCop** | `rake rubocop` | ⭕ | ⭕ | - | Readability / Maintainability | Static Analysis (Syntax/Linting) | Overly complex methods, non-standard syntax, unused variables. |
-| **Steep & RBS** | `rake typecheck` | ⭕ | ⭕ | - | Type Safety (Static) | Static Analysis (Type Check) | `NoMethodError`, passing incorrect arguments, method typo bugs. |
-| **Bundler Audit** | `rake audit` | - | ⭕ | - | Security | Dependency Scanning | Inclusion of external gems with known vulnerabilities (CVEs). |
-| **Dependabot** | `.github/dependabot.yml` | - | - | ⭕ | Currency / Maintenance | Repository Monitoring | Outdated dependencies or CI actions. |
-| **Unit & Contract Tests** | `rake test:unit test:contract` | ⭕ | ⭕ | - | Accuracy / Functional Reqs | Dynamic Analysis (Assertions) | Method specification violations, unexpected return values, edge-case failures. |
-| **Runtime Type Validation (RBS::Test)** | `rake test:rbs` | △ (Opt-in) | ⭕ | - | Type Safety (Dynamic) | Dynamic Analysis (Runtime Hooks) | Type errors slipping past static checks, divergence between RBS docs and implementation. |
-| **Property-Based Testing (PBT)** | `rake test:pbt` | ⭕ | ⭕ | - | Robustness / Exhaustiveness | Automated Random Generation | Crashes caused by "unexpected inputs" (e.g., empty strings, huge numbers, special symbols like `=`). |
-| **Security Validation (DoS Protection)** | Included in `rake test:unit` | ⭕ | ⭕ | - | Availability / Safety | Dynamic Analysis (Malicious Input) | Memory/disk exhaustion from ZIP bombs, infinite parsing loops from malformed files. |
-| **Concurrency Validation (Thread/Ractor)** | Included in `rake test:unit` | ⭕ | ⭕ | - | Thread Safety | Dynamic Analysis (Parallel Execution) | Global variable pollution, data mixing during concurrent request processing. |
-| **XSD Schema Validation** | Included in `rake test:unit` | ⭕ | ⭕ | - | Compatibility / Compliance | Structural Validation | "We found a problem with some content in it" errors when opening in Excel. |
-| **E2E Interoperability Tests** | `rake test:e2e` | △ (Opt-in) | ⭕ | - | Compatibility (Real-world) | 3rd-party SDK Execution | Structural defects so severe that the official .NET SDK cannot read them. |
-| **Memory & Performance Tests** | `rake test:perf` / Action: `performance.yml` | ⭕ | ⭕ | - | Performance / Stability | Continuous Profiling (10k+ rows) | Out of Memory (OOM) leaks or unbounded memory retention in streaming mode. |
-| **Ecosystem Benchmarks** | `ruby benchmark.rb` | ⭕ | - | - | Performance Comparison | Multi-Gem Isolated Profiling (1M cells) | Throughput and allocation comparison against competing libraries. |
-| **Visual Regression Testing (VRT)** | `rake test:visual` | - | ⭕ | - | Visual Accuracy (UI/UX) | Headless Rendering / Pixel Diff | Visual bugs like "cell background colors dropping" or "chart layouts breaking" after code changes. |
-

data/docs/SPEC_SOURCES.md

@@ -1,48 +0,0 @@
-# Specification Reference Policy
-
-This document defines the specification reference policy for `xlsxrb`.
-
-## Canonical Specification (Normative)
-The primary reference for this library is **ECMA-376 (Office Open XML File Formats)**.
-Specifically, `xlsxrb` targets the **Transitional** version of the specification (Part 4) to ensure maximum compatibility with existing applications such as Microsoft Excel, LibreOffice, and Google Sheets.
-
-Local copies of the ECMA-376 specifications are located in the `vendor/docs/` directory:
-- [Part 1: Fundamentals And Markup Language Reference](file:///workspaces/xlsxrb/vendor/docs/ECMA-376-Part1/Ecma%20Office%20Open%20XML%20Part%201%20-%20Fundamentals%20And%20Markup%20Language%20Reference.pdf)
-- [Part 2: Open Packaging Conventions](file:///workspaces/xlsxrb/vendor/docs/ECMA-376-Part2/ECMA-376-2_5th_edition_december_2021.pdf)
-- [Part 3: Markup Compatibility and Extensibility](file:///workspaces/xlsxrb/vendor/docs/ECMA-376-Part3/Ecma%20Office%20Open%20XML%20Part%203%20-%20Markup%20Compatibility%20and%20Extensibility.pdf)
-- [Part 4: Transitional Migration Features](file:///workspaces/xlsxrb/vendor/docs/ECMA-376-Part4/Ecma%20Office%20Open%20XML%20Part%204%20-%20Transitional%20Migration%20Features.pdf)
-
-## Supplementary Specifications (Excel Real-world Behavior)
-To address gaps between the official ECMA standard and actual implementations in Microsoft Excel, the following Microsoft Open Specifications are used. Note that these files are not bundled in the repository to avoid licensing/redistribution issues; instead, they are referenced via online links and versioned here:
-
-1. **[[MS-XLSX]: Excel Extensions to OOXML SpreadsheetML Structure](https://learn.microsoft.com/en-us/openspecs/office_standards/ms-xlsx/)**
-   - **Role:** Explains Excel-specific extensions, default attributes, and schema extensions.
-   - **Referenced Version:** July 2024 / Version 12.0 (or current release).
-2. **[[MS-OI29500]: Office Implementation Information for ISO/IEC 29500](https://learn.microsoft.com/en-us/openspecs/office_standards/ms-oi29500/)**
-   - **Role:** Identifies how Excel actually reads/writes files, including deviations and compatibility behaviors.
-   - **Referenced Version:** July 2024 / Version 12.0 (or current release).
-3. **[[MS-OFFCRYPTO]: Office Document Cryptography Structure](https://learn.microsoft.com/en-us/openspecs/office_standards/ms-offcrypto/)**
-   - **Role:** Provides details on encryption, passwords, and hashing algorithms used for document/sheet protection (Agile Encryption and Standard Encryption).
-   - **Referenced Version:** July 2024 / Version 12.0 (or current release).
-4. **[[MS-CFB]: Compound File Binary File Format](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-cfb/)**
-   - **Role:** Container format (OLE structured storage) wrapping encrypted Office documents (`EncryptionInfo` and `EncryptedPackage` streams).
-   - **Referenced Version:** July 2024 / Version 14.0 (or current release).
-
-### ISO/IEC 29500 Note
-ISO/IEC 29500 is contents-wise equivalent to ECMA-376. However, ISO/IEC 29500 requires paid purchase in general, whereas ECMA-376 is freely available. Therefore, we primarily cite ECMA-376 sections.
-
-## Source Attribution Policy
-When implementing features or fixing bugs that depend on specific behaviors defined in these specifications, developers should:
-1. Reference the specific part, section, or page number in code comments (e.g., `# Reference: ECMA-376 Part 1, Section 18.3.1.73`).
-2. Update the mapping table below to maintain a central registry of implemented standard behaviors.
-
-## Implementation Specification Mapping Table
-| Feature | Primary Standard | Specification Section | Notes |
-| :--- | :--- | :--- | :--- |
-| Cell Value Types | ECMA-376 Part 1 | §18.18.11 (ST_CellType) | Defines cell data types (boolean, number, string, formula, etc.) |
-| Shared Strings | ECMA-376 Part 1 | §18.4 (Shared String Table) | Handling of `<sst>` and `<si>` for cell value reuse |
-| Styles & Formatting | ECMA-376 Part 1 | §18.8 (Styles) | Cell style XF indexes, font, fill, border mappings |
-| Hyperlinks | ECMA-376 Part 1 | §18.3.1.48 (hyperlink) | Worksheet hyperlinks referencing external URLs or internal targets |
-| Document Encryption (Agile) | [MS-OFFCRYPTO] | §2.3.4 (Agile Encryption) | AES-256-CBC, PBKDF2/SHA-512, HMAC-SHA512 data integrity |
-| Document Encryption (Standard) | [MS-OFFCRYPTO] | §2.3.6 (Standard Encryption) | AES-128-ECB, SHA-1 with CryptoAPI 50,000-spin key derivation |
-| Encryption Container | [MS-CFB] | §2 (Compound File Structure) | Mini Stream, FAT/MiniFAT sectors, and Red-Black tree directory |

data/docs/assets/benchmark_results.svg

@@ -1,144 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 960 480" width="100%" height="100%">
-  <defs>
-    <linearGradient id="bg-grad" x1="0%" y1="0%" x2="100%" y2="100%">
-      <stop offset="0%" stop-color="#161b22"/>
-      <stop offset="100%" stop-color="#0d1117"/>
-    </linearGradient>
-  </defs>
-
-  <style>
-    .card { fill: #161b22; stroke: #30363d; stroke-width: 1px; rx: 8px; }
-    .title { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif; font-size: 18px; font-weight: 700; fill: #f0f6fc; }
-    .subtitle { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif; font-size: 12px; fill: #8b949e; }
-    .section-title { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif; font-size: 14px; font-weight: 700; fill: #e6edf3; }
-    .label { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif; font-size: 12px; fill: #c9d1d9; }
-    .label-accent { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif; font-size: 12px; font-weight: 700; fill: #58a6ff; }
-    .value { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif; font-size: 11px; font-weight: 600; fill: #ffffff; }
-    .grid { stroke: #21262d; stroke-width: 1px; stroke-dasharray: 4 4; }
-    .footer { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif; font-size: 11px; fill: #8b949e; }
-  </style>
-
-  <!-- Container -->
-  <rect width="960" height="480" rx="12" fill="url(#bg-grad)" stroke="#30363d" stroke-width="1"/>
-
-  <!-- Main Header -->
-  <text x="480" y="38" text-anchor="middle" class="title">Ruby XLSX Performance Benchmarks (1,000,000 Cells)</text>
-  <text x="480" y="58" text-anchor="middle" class="subtitle">100,000 rows × 10 cols • Mixed business data • Linear time scale (0s – 40s)</text>
-
-  <!-- Left: Write Performance -->
-  <g transform="translate(35, 75)">
-    <rect width="430" height="350" class="card"/>
-    <text x="20" y="30" class="section-title">Write Execution Time</text>
-    <text x="20" y="46" font-family="sans-serif" font-size="10" fill="#8b949e">Time to generate 1M cells (Lower is faster)</text>
-    
-    <line x1="160.0" y1="65" x2="160.0" y2="320" class="grid"/>
-    <text x="160.0" y="335" font-family="sans-serif" font-size="10" fill="#64748b" text-anchor="middle">0s</text>
-
-    <line x1="215.0" y1="65" x2="215.0" y2="320" class="grid"/>
-    <text x="215.0" y="335" font-family="sans-serif" font-size="10" fill="#64748b" text-anchor="middle">10s</text>
-
-    <line x1="270.0" y1="65" x2="270.0" y2="320" class="grid"/>
-    <text x="270.0" y="335" font-family="sans-serif" font-size="10" fill="#64748b" text-anchor="middle">20s</text>
-
-    <line x1="325.0" y1="65" x2="325.0" y2="320" class="grid"/>
-    <text x="325.0" y="335" font-family="sans-serif" font-size="10" fill="#64748b" text-anchor="middle">30s</text>
-
-    <line x1="380.0" y1="65" x2="380.0" y2="320" class="grid"/>
-    <text x="380.0" y="335" font-family="sans-serif" font-size="10" fill="#64748b" text-anchor="middle">40s</text>
-    
-    <!-- xlsxrb (Streaming): 0.95s -->
-    <text x="150" y="85" text-anchor="end" class="label-accent">xlsxrb (Streaming)</text>
-    <rect x="160" y="72" width="5.2" height="18" rx="3" fill="#3b82f6"/>
-    <text x="173.2" y="85" class="value">0.95 s</text>
-
-    <!-- xlsxtream 3.1.0: 1.16s -->
-    <text x="150" y="120" text-anchor="end" class="label">xlsxtream 3.1.0</text>
-    <rect x="160" y="107" width="6.4" height="18" rx="3" fill="#64748b"/>
-    <text x="174.4" y="120" class="value">1.16 s</text>
-
-    <!-- fast_excel 0.5.0: 2.02s -->
-    <text x="150" y="155" text-anchor="end" class="label">fast_excel 0.5.0</text>
-    <rect x="160" y="142" width="11.1" height="18" rx="3" fill="#64748b"/>
-    <text x="179.1" y="155" class="value">2.02 s</text>
-
-    <!-- xlsxrb (In-Memory): 2.42s -->
-    <text x="150" y="190" text-anchor="end" class="label-accent">xlsxrb (In-Memory)</text>
-    <rect x="160" y="177" width="13.3" height="18" rx="3" fill="#3b82f6"/>
-    <text x="181.3" y="190" class="value">2.42 s</text>
-
-    <!-- write_xlsx 1.15.0: 4.39s -->
-    <text x="150" y="225" text-anchor="end" class="label">write_xlsx 1.15.0</text>
-    <rect x="160" y="212" width="24.1" height="18" rx="3" fill="#64748b"/>
-    <text x="192.1" y="225" class="value">4.39 s</text>
-
-    <!-- caxlsx 4.5.0: 5.28s -->
-    <text x="150" y="260" text-anchor="end" class="label">caxlsx 4.5.0</text>
-    <rect x="160" y="247" width="29.0" height="18" rx="3" fill="#64748b"/>
-    <text x="197.0" y="260" class="value">5.28 s</text>
-
-    <!-- rubyXL 3.4.38: 43.13s -->
-    <text x="150" y="295" text-anchor="end" class="label">rubyXL 3.4.38</text>
-    <rect x="160" y="282" width="220.0" height="18" rx="3" fill="#64748b"/>
-    <text x="388.0" y="295" class="value">43.13 s</text>
-  </g>
-
-  <!-- Right: Read Performance -->
-  <g transform="translate(495, 75)">
-    <rect width="430" height="350" class="card"/>
-    <text x="20" y="30" class="section-title">Read Execution Time</text>
-    <text x="20" y="46" font-family="sans-serif" font-size="10" fill="#8b949e">Time to parse 1M cells (Lower is faster)</text>
-    
-    <line x1="160.0" y1="65" x2="160.0" y2="320" class="grid"/>
-    <text x="160.0" y="335" font-family="sans-serif" font-size="10" fill="#64748b" text-anchor="middle">0s</text>
-
-    <line x1="215.0" y1="65" x2="215.0" y2="320" class="grid"/>
-    <text x="215.0" y="335" font-family="sans-serif" font-size="10" fill="#64748b" text-anchor="middle">10s</text>
-
-    <line x1="270.0" y1="65" x2="270.0" y2="320" class="grid"/>
-    <text x="270.0" y="335" font-family="sans-serif" font-size="10" fill="#64748b" text-anchor="middle">20s</text>
-
-    <line x1="325.0" y1="65" x2="325.0" y2="320" class="grid"/>
-    <text x="325.0" y="335" font-family="sans-serif" font-size="10" fill="#64748b" text-anchor="middle">30s</text>
-
-    <line x1="380.0" y1="65" x2="380.0" y2="320" class="grid"/>
-    <text x="380.0" y="335" font-family="sans-serif" font-size="10" fill="#64748b" text-anchor="middle">40s</text>
-    
-    <!-- xlsxrb (Streaming): 1.73s -->
-    <text x="150" y="85" text-anchor="end" class="label-accent">xlsxrb (Streaming)</text>
-    <rect x="160" y="72" width="9.5" height="18" rx="3" fill="#3b82f6"/>
-    <text x="177.5" y="85" class="value">1.73 s</text>
-
-    <!-- xlsxrb (In-Memory): 4.33s -->
-    <text x="150" y="120" text-anchor="end" class="label-accent">xlsxrb (In-Memory)</text>
-    <rect x="160" y="107" width="23.8" height="18" rx="3" fill="#3b82f6"/>
-    <text x="191.8" y="120" class="value">4.33 s</text>
-
-    <!-- simple_xlsx_reader: 4.38s -->
-    <text x="150" y="155" text-anchor="end" class="label">simple_xlsx_reader</text>
-    <rect x="160" y="142" width="24.1" height="18" rx="3" fill="#64748b"/>
-    <text x="192.1" y="155" class="value">4.38 s</text>
-
-    <!-- creek 2.6.3: 7.12s -->
-    <text x="150" y="190" text-anchor="end" class="label">creek 2.6.3</text>
-    <rect x="160" y="177" width="39.2" height="18" rx="3" fill="#64748b"/>
-    <text x="207.2" y="190" class="value">7.12 s</text>
-
-    <!-- roo 3.0.0: 10.95s -->
-    <text x="150" y="225" text-anchor="end" class="label">roo 3.0.0</text>
-    <rect x="160" y="212" width="60.2" height="18" rx="3" fill="#64748b"/>
-    <text x="228.2" y="225" class="value">10.95 s</text>
-
-    <!-- xsv 1.4.1: 14.56s -->
-    <text x="150" y="260" text-anchor="end" class="label">xsv 1.4.1</text>
-    <rect x="160" y="247" width="80.1" height="18" rx="3" fill="#64748b"/>
-    <text x="248.1" y="260" class="value">14.56 s</text>
-
-    <!-- rubyXL 3.4.38: 30.74s -->
-    <text x="150" y="295" text-anchor="end" class="label">rubyXL 3.4.38</text>
-    <rect x="160" y="282" width="169.1" height="18" rx="3" fill="#64748b"/>
-    <text x="337.1" y="295" class="value">30.74 s</text>
-  </g>
-
-  <!-- Footer -->
-  <text x="480" y="455" text-anchor="middle" class="footer">Tested on Ruby 4.0+ in isolated subprocesses • Full GC and peak memory metrics in docs/PEER_LIBRARIES.md</text>
-</svg>

data/docs/coi-serviceworker.js

@@ -1,82 +0,0 @@
-/*! coi-serviceworker v0.1.7 - Guido Zuidhof and contributors, licensed under MIT */
-// Source: https://github.com/gzguidoti/coi-serviceworker
-// Purpose: Allows running WebAssembly with SharedArrayBuffer on browsers by setting COOP and COEP headers via Service Worker.
-let coepCredentialless = false;
-if (typeof window === 'undefined') {
-    self.addEventListener("install", () => self.skipWaiting());
-    self.addEventListener("activate", (event) => event.waitUntil(self.clients.claim()));
-
-    self.addEventListener("message", (ev) => {
-        if (!ev.data) {
-            return;
-        } else if (ev.data.type === "deregister") {
-            self.registration
-                .unregister()
-                .then(() => {
-                    return self.clients.matchAll();
-                })
-                .then(clients => {
-                    clients.forEach((client) => client.navigate(client.url));
-                });
-        } else if (ev.data.type === "coepCredentialless") {
-            coepCredentialless = ev.data.value;
-        }
-    });
-
-    self.addEventListener("fetch", function (event) {
-        const r = event.request;
-        if (r.cache === "only-if-cached" && r.mode !== "same-origin") {
-            return;
-        }
-
-        const request = (coepCredentialless && r.mode === "no-cors")
-            ? new Request(r, { credentials: "omit" })
-            : r;
-        event.respondWith(
-            fetch(request)
-                .then((response) => {
-                    if (response.status === 0) {
-                        return response;
-                    }
-
-                    const newHeaders = new Headers(response.headers);
-                    newHeaders.set("Cross-Origin-Embedder-Policy",
-                        coepCredentialless ? "credentialless" : "require-corp"
-                    );
-                    if (!coepCredentialless) {
-                        newHeaders.set("Cross-Origin-Resource-Policy", "cross-origin");
-                    }
-                    newHeaders.set("Cross-Origin-Opener-Policy", "same-origin");
-
-                    return new Response(response.body, {
-                        status: response.status,
-                        statusText: response.statusText,
-                        headers: newHeaders,
-                    });
-                })
-                .catch((e) => console.error(e))
-        );
-    });
-} else {
-    (() => {
-        const reloaded = sessionStorage.getItem("coiReloaded");
-        const isSecureContext = window.isSecureContext;
-        if (!isSecureContext) return;
-
-        if (navigator.serviceWorker) {
-            navigator.serviceWorker.register(window.document.currentScript.src).then(
-                (registration) => {
-                    registration.addEventListener("updatefound", () => {
-                        sessionStorage.setItem("coiReloaded", "true");
-                        window.location.reload();
-                    });
-                    if (registration.active && !navigator.serviceWorker.controller) {
-                        sessionStorage.setItem("coiReloaded", "true");
-                        window.location.reload();
-                    }
-                },
-                (err) => console.error("COI registration failed: ", err)
-            );
-        }
-    })();
-}

data/docs/office_thread.js

@@ -1,77 +0,0 @@
-/* -*- Mode: JS; tab-width: 2; indent-tabs-mode: nil; js-indent-level: 2; fill-column: 100 -*- */
-// SPDX-License-Identifier: MIT
-// Source: Derived from ZetaOffice WebAssembly example (https://github.com/zetaoffice/zeta-wasm-examples)
-// Purpose: Runs WebAssembly-based LibreOffice (Calc) in a separate Web Worker thread.
-
-// Debugging note:
-// Switch the web worker in the browsers debug tab to debug this code.
-// It's the "em-pthread" web worker with the most memory usage, where "zetajs" is defined.
-
-'use strict';
-
-
-// global variables - zetajs environment:
-let zetajs, css;
-
-// = global variables (some are global for easier debugging) =
-// common variables:
-let context, desktop, xModel, ctrl;
-
-
-function demo() {
-  context = zetajs.getUnoComponentContext();
-  const bean_overwrite = new css.beans.PropertyValue({Name: 'Overwrite', Value: true});
-  const bean_odt_export = new css.beans.PropertyValue({Name: 'FilterName', Value: 'writer8'});
-  desktop = css.frame.Desktop.create(context);
-
-  zetajs.mainPort.onmessage = function (e) {
-    switch (e.data.cmd) {
-    case 'upload':
-      loadFile(e.data.filename);
-      break;
-    case 'download':
-      xModel.store();
-      zetajs.mainPort.postMessage({cmd: 'download', id: e.data.id});
-      break;
-    default:
-      throw Error('Unknown message command: ' + e.data.cmd);
-    }
-  }
-  zetajs.mainPort.postMessage({cmd: 'thr_running'});
-}
-
-function loadFile(filename) {
-  if (xModel) {
-    try {
-      const xCloseable = css.util.XCloseable.query(xModel);
-      if (xCloseable) {
-        xCloseable.close(true);
-      } else {
-        xModel.dispose();
-      }
-    } catch (e) {
-      console.warn("xCloseable.close failed, trying dispose:", e);
-      try {
-        xModel.dispose();
-      } catch (e2) {
-        console.error("Failed to dispose old xModel:", e2);
-      }
-    }
-    xModel = null;
-  }
-
-  const in_path = 'file:///tmp/office/' + filename;
-  xModel = desktop.loadComponentFromURL(in_path, '_default', 0, []);
-  ctrl = xModel.getCurrentController();
-  ctrl.getFrame().getContainerWindow().FullScreen = true;
-  zetajs.mainPort.postMessage({cmd: 'ui_ready'});
-}
-
-Module.zetajs.then(function(pZetajs) {
-  // initializing zetajs environment:
-  zetajs = pZetajs;
-  css = zetajs.uno.com.sun.star;
-  demo();  // launching demo
-});
-
-/* vim:set shiftwidth=2 softtabstop=2 expandtab cinoptions=b1,g0,N-s cinkeys+=0=break: */