@nowline/export-xlsx

@nowline/export-xlsx

Five-sheet Excel workbook export for Nowline roadmaps. Built on exceljs; tuned for determinism and filter/sort-friendly column shapes.

License: Apache 2.0 Part of: lolay/nowline monorepo Spec: specs/handoffs/m2c.md § 7 + specs/rendering.md § XLSX Export

Install

pnpm add @nowline/export-xlsx @nowline/export-core

Usage

import { exportXlsx } from '@nowline/export-xlsx';

const xlsx = await exportXlsx(inputs, {
    author: 'Roadmap Bot',
    generated: new Date('2026-01-01T00:00:00Z'),
});

// `xlsx` is a Uint8Array — a zip-formatted Office Open XML workbook.

Sheet layout

Sheet	Columns	Notes
Roadmap	Title, Author, Generated, Source path	Workbook overview.
Items	id, title, swimlane, group, parallel, status, owner, after, before, duration (working days), duration (text), labels, description	One row per item. The numeric duration column is in working days for SUM and filters; the text column preserves the original DSL literal (2w, 1m, etc.).
Milestones	id, title, after / before, date	One row per milestone.
Anchors	id, title, date	One row per anchor.
People & Teams	id, name, type (person|team)	Ownership references.

Conditional formatting on Items.status highlights done, in-progress, blocked, and any custom statuses defined in the AST.

Determinism

• workbook.created = inputs.today (UTC midnight) — never new Date() in the default code path.
• Sheet 1's "Generated" cell takes the same today.
• Style ids and column orders are explicit so ExcelJS's id allocator emits the same numbers across runs.
• ExcelJS version is pinned in package.json. If the upstream library ever introduces zip-level non-determinism, the package's writer re-emits content streams in deterministic order before zipping (m2c Resolution 8).
• Hash tests in test/export-xlsx.test.ts confirm byte stability.

Options

Option	Default	Notes
author	'Nowline'	Workbook Author, also the Roadmap-sheet "Author" cell.
generated	inputs.today	Workbook created, also the Roadmap-sheet "Generated" cell.

License

Apache-2.0. Bundles exceljs (MIT).