Hypaxel / Changelog
Changelog
All notable changes to Hypaxel are recorded here. Versions apply to every package (Rust crates, Python, Node.js, .NET, Java, Go and PHP).
0.3.0 (unreleased)#
Added#
- Streaming XLSX reader (.NET, Rust, Python, Go, Java). Rows are read one at a time, with
memory bounded by the shared string table plus one row. Every implementation has its own
dependency-free parser and the same semantics.
- Rust:
XlsxReader::open/new/with_options,sheets()(name, visibility, kind),worksheet(name)/worksheet_at(index)→Rows::next_row()→Row(number,cells,get,values).Valuecovers strings, numbers, booleans, errors andExcelDateTimefor date, time and duration formats in both date systems, with chrono conversions.with_sourceshares the parsed workbook across handles;ReadOptionscaps the shared string table. - Python:
open_workbook/Reader(paths, bytes, binary file objects),iter_rows/read_rows,iter_records/read_recordsandread_dataframe(pandas or polars). Values arestr,int,float,bool,datetime,time,timedelta, error strings andNone. - .NET:
XlsxReader.Open/new XlsxReader(stream),OpenWorksheet(name or index)→WorksheetReader.Read()/Rowwith allocation-freeTryGet…accessors andExcelValuestructs;XlsxReadExceptionwithKindandPart. - Go:
OpenReader/NewReader(io.ReaderAt, size),Rows(name)/RowsAt(index)withNext/Row/ErrorRows.All()(iter.Seq2);ReadErrorwith sentinel errors. - Java:
XlsxReader.open(Path | SeekableByteChannel | byte[] | InputStream),worksheet(name or index)→SheetReader.nextRow(), iterator orstream();XlsxExceptiongains kinds and the failing part. - Accepts Strict Open XML, prefixed namespaces, cells without references, rich and inline text
and ISO 8601 dates. Rejects DTDs, oversized tokens and ZIP entries that do not match their
declared size or CRC. Names legacy
.xls, encrypted and non-spreadsheet files in the error.
- Rust:
- Browser support for the Node.js package (WebAssembly). The
hypaxelnpm package now runs in browsers and other runtimes without native modules on the Rust core compiled to WebAssembly (171 KB gzipped), with the same API as in Node.js. Bundlers pick the build through thebrowserexport condition;hypaxel/wasmselects it explicitly. Addsinit()/initSync()to load the module,toBlob()for downloads, and a pull-basedwebStream(). In Node.jsinit()is a no-op and nothing else changes. Both engines share one Rust crate (node/engine) and produce byte-identical files. Browser benchmarks against SheetJS and ExcelJS in headless Chrome. - Read benchmarks against each ecosystem’s readers: calamine (Rust); openpyxl, python-calamine, pandas and fastexcel (Python); Sylvan.Data.Excel, ExcelDataReader and MiniExcel (.NET); excelize, xlsxreader and tealeg/xlsx (Go); FastExcel and Apache POI (Java).
Fixed#
- Rust, .NET: with the 1904 date system, 9999-12-31 is written as a date instead of text.
0.2.0 (2026-11-19)#
Added#
- Excel tables:
Sheet::add_table(Rust),Worksheet.add_table(Python),addTable(Node.js, Java, PHP),Worksheet.AddTable(.NET) andSheet.AddTable(Go) turn a range into a named, styled table with filter buttons and banded rows. Built-in Light/Medium/Dark styles, optional header row, workbook-unique names, validation of names, column names and overlaps with other tables, merged cells and the worksheet auto filter. - Row outline levels (grouping):
RowOptionswith height, style, outline level 0–7, hidden and collapsed; the sheet declares its deepest level up front (row_outline_levels/RowOutlineLevels), andoutline_summary_aboveplaces group buttons above each group. - Auto-fit column widths:
SheetOptions::autofit_columns/autofit(AutoFit)and the equivalents in every binding. The sheet’s output is held back for a sample (default 1,000 rows, at most 8 MiB of XML), widths are estimated from text, number formats and font sizes, and streaming resumes. Memory stays bounded; explicit widths take precedence.
Changed#
- A row started explicitly with
begin_row*/BeginRowis filled by the next whole-row write (add_row,write_row, records, objects) instead of a new row being started after it. Rows that already contain cells are unaffected. - Python:
write_rowacceptsheight,outline_level,hiddenandcollapsed;begin_rowacceptsoutline_level,hiddenandcollapsed. - Node.js: the native
beginRowtakes an options object. - .NET:
BeginRowvalidates all arguments before ending the open row, and worksheet options are validated before the worksheet’s part is opened.sheet.BeginRow(null)with a literalnullno longer compiles because it is ambiguous with the newBeginRow(RowOptions)overload.
0.1.0 (2026-11-18)#
- First version: forward-only, constant-memory XLSX writer in Rust and .NET, with Python and Node.js packages built on the Rust core, and native Java, Go and PHP implementations.