Skip to content

v0.1.0

Choose a tag to compare

@github-actions github-actions released this 25 Jul 11:17

Added

  • Bounded .xlsx package inspection and reading from paths, byte slices, and Read + Seek
    streams, with ZIP, XML, workbook, formula, text, relationship, and allocation limits.
  • Immutable sparse workbook snapshots with typed values, formulas, saved results, shared and array
    metadata, defined names, sheet visibility, date systems, number formats, diagnostics,
    and provenance.
  • Package-backed .xlsx and .xlsm documents with exact SHA-256 source identity that preserve
    unknown and unchanged parts without executing macros, following external links, or reading
    host-time inputs.
  • Static formula capability scans and deterministic recalculation into a separate owned result
    snapshot, including direct formula cells, legacy-array regions, and dynamic-spill regions.
  • A catalog of 278 official Excel-facing function names, comprising 265 official calculation
    kernels and 13 compatibility aliases, plus one non-official OOXML dummy-function marker,
    workbook function-demand reports, and stable sample locations.
  • Explicit deterministic inputs for TODAY() and NOW(), bounded calculation work, stable
    per-formula issue codes, and spreadsheet error values kept distinct from unsupported engine
    capabilities.
  • Formula parsing and evaluation for scalar, range, lookup, logical, aggregate, math,
    trigonometric, combinatoric, engineering, information, text, date/time, dynamic-array,
    statistical, and financial function groups.
  • Excel-compatible INDEX zero row/column references, including scalar implicit intersection,
    reference composition, incremental dependencies, and row, column, or full-rectangle array
    materialization.
  • Capability detection for unsupported external, 3-D, structured, spill-postfix, data-table, and
    other statically recognizable out-of-scope formula forms.
  • Verified recalculation writing that binds results to the exact source, updates typed caches,
    removes stale calculation chains, preserves unrelated package content, and supports strict or
    explicit cache-invalidation policy.
  • Canonical workbook creation with dynamic-formula authoring, plus preservation-aware
    WorkbookDraft editing for typed cells, normal formulas, sheets, defined names, number formats,
    date systems, and calculation properties. Existing document-backed dynamic formulas can be
    recalculated and cache-rewritten, while adding or replacing them fails closed.
  • Atomic typed edit batches with semantic revisions, complete rollback on validation failure,
    no-op revision and calculation preservation, and Save As path writes that refuse implicit
    destination replacement.
  • SpreadsheetML phonetic annotation inspection and authoring, row/column phonetic-visibility
    handling, and default frozen-pane inspection and authoring under separate presentation revisions.
  • Persistent WorkbookCalculationSession state with incremental recalculation, conservative full
    fallback, optimistic revision checks, request-owned cooperative cancellation, stale-result
    rejection, and bounded paged result deltas.
  • Typed Python 3.10–3.14 bindings built with PyO3 and maturin.
  • Typed Node.js 22+ CommonJS and ESM bindings built with napi-rs and exact-version native platform
    packages.
  • Explicit, idempotent native-session cleanup through Python context managers and Python/Node.js
    close(), including cooperative cancellation of active calculation and stable closed-session
    errors.
  • A local stdio-only MCP server with 11 high-level workbook tools, explicit approved roots,
    bounded TTL/LRU sessions, capability-bound bounded input reads, byte-bounded responses and
    resource pagination, cooperative cancellation, and capability-bound atomic Save As behavior.
  • Stable validation, read, write, calculation, session, diagnostic, and spreadsheet-value error
    boundaries with machine-readable codes, including a core-owned ValidationErrorCode covering
    every current ValidationError variant.
  • Runnable examples for inspection, capability scanning, error handling, saved-versus-calculated
    values, calculation, canonical authoring, recalculation Save As, dynamic arrays, phonetic
    inspection, and phonetic authoring.
  • Generated workbook integration tests, binding conformance tests, MCP protocol tests, fuzz
    targets, MSRV checks, dependency-policy checks, package-consumer verification, and
    cross-platform CI.

Known limitations

  • Public CI uses generated, redistributable workbook fixtures. The private external formula corpus,
    user workbook corpus, and native-producer evidence used during development are not distributed
    with 0.1.0 and are not represented as release gates.