Changelog

v1.13.3 (2026-01-14)

• Export types from package

v1.13.2 (2025-12-19)

• Fix a left-over issue in setColumnSize

v1.13.1 (2025-12-09)

• Fix StyleManager.get() to return Style | null
• Allow table style name to be null
• Include only required files in distributed package
• Bump @borgar/xlsx-convert from 3.6.0 to 3.6.1
• Dev dependency updates

v1.13.0 (2025-11-27)

• Use latest version of Cellatrix

v1.12.0 (2025-11-21)

• Updates to dependencies

v1.11.0 (2025-11-18)

• Publish package to the npmjs.com registry

v1.10.0 (2025-10-22)

• Remove dependence on Cellatrix types
• Use local coordinates to draw error mark
• Clip error mark drawing to small cell bounds
• Updates to dependencies

v1.9.1 (2025-10-09)

• Respect a workbook’s default style
• Apply viewport offset to non-merged cell rects

v1.9.0 (2025-10-08)

• Draw triangles in top-left of cells with errors
• Fix sheet bounds check for merged cells
• Tighten some types and type checks
• Update to use Cellatrix v1.2.1
• Add lint and typecheck jobs to CI workflow
• Updates to dependencies

v1.8.0 (2025-09-26)

Mondrian v1.8.0 now comes with an API for resizing columns and rows, an option to render formulas when calculated values are missing, support for rendering tables, and support for CSV/TSV data sources.

API for resizing columns and rows

Mondrian’s renderer now includes helper methods to get and set column widths and row heights.

const renderer = new Renderer();
renderer.setWorkbook(model.getWorkbook());
renderer.setSheet("Sheet1");

// Resize column D to 180px and row 11 to 32px
renderer.setColumnSize(3, 180);
renderer.setRowSize(10, 32);

Option to show formulas when calculated values are missing

When OpenPyXL (and other libraries without a full spreadsheet engine) creates cells with formulas, it will fail to include a calculated value in the cell. By default, those cells will render empty in the viewer. Now you can instantiate a renderer with showValuelessFormulas: true to render formulas instead of empty cells.

new Renderer({
  showValuelessFormulas: true,
});

Support for rendering table styles

Mondrian’s renderer now applies Excel table styles end-to-end: headers, banded rows, emphasised columns, and totals rows all inherit the colours and borders defined on each table.

Support for CSV and TSV files

Workbooks loaded via xlsx-converter can come from CSV/TSV sources.

import { readFile } from "node:fs/promises";
import { convertCSV } from "@borgar/xlsx-convert";
import { Model } from "@grid-is/cellatrix";
import { Renderer } from "@grid-is/mondrian";

const csv = await readFile("./data.csv", "utf8");
const jsf = convertCSV(csv, "data.csv");
const model = Model.fromJSF(jsf);

const renderer = new Renderer();
renderer.setWorkbook(model.getWorkbook());
renderer.setSheet("Sheet1");

v1.7.0 (2025-09-23)

• Add support for rendering tables
• Bump @borgar/xlsx-convert from 3.3.2 to 3.4.0
• Bump typescript-eslint from 8.44.0 to 8.44.1
• Bump skia-canvas from 3.0.6 to 3.0.7
• Bump @grid-is/cellatrix from 1.0.0-rc11 to 1.1.0
• Bump eslint from 9.35.0 to 9.36.0

v1.6.1 (2025-09-22)

• Point default export at built index.js

v1.6.0 (2025-09-18)

• Use color from number format if it exists
• Add GitHub Actions workflow for automatic releases

v1.5.1 (2025-09-18)

• Prevent failure when col/row default sizes are zero
• Support dragging-and-dropping workbooks onto browser viewer example
• Respect header spans in rectToRanges
• Improve render tests
• Run unit tests in a CI workflow
• Translate project to Typescript