diff --git a/.changeset/builtin-codes-excel.md b/.changeset/pre/builtin-codes-excel.md similarity index 100% rename from .changeset/builtin-codes-excel.md rename to .changeset/pre/builtin-codes-excel.md diff --git a/.changeset/group-title-fill-right.md b/.changeset/pre/group-title-fill-right.md similarity index 100% rename from .changeset/group-title-fill-right.md rename to .changeset/pre/group-title-fill-right.md diff --git a/.changeset/sheet-names-code-points.md b/.changeset/pre/sheet-names-code-points.md similarity index 100% rename from .changeset/sheet-names-code-points.md rename to .changeset/pre/sheet-names-code-points.md diff --git a/.changeset/two-row-csv-headers.md b/.changeset/pre/two-row-csv-headers.md similarity index 100% rename from .changeset/two-row-csv-headers.md rename to .changeset/pre/two-row-csv-headers.md diff --git a/apps/playground/package.json b/apps/playground/package.json index 6a8d3c1..a2b81c2 100644 --- a/apps/playground/package.json +++ b/apps/playground/package.json @@ -11,7 +11,7 @@ "test": "vitest run" }, "dependencies": { - "javascript-excel": "2.0.0-beta.0" + "javascript-excel": "2.0.0-beta.1" }, "devDependencies": { "happy-dom": "21.0.4", diff --git a/examples/node/package.json b/examples/node/package.json index 790daf7..7e2f1a2 100644 --- a/examples/node/package.json +++ b/examples/node/package.json @@ -8,7 +8,7 @@ "check": "tsc -p tsconfig.json" }, "dependencies": { - "javascript-excel": "2.0.0-beta.0" + "javascript-excel": "2.0.0-beta.1" }, "devDependencies": { "@types/node": "22.20.5", diff --git a/examples/react/package.json b/examples/react/package.json index 496f6a5..8f55698 100644 --- a/examples/react/package.json +++ b/examples/react/package.json @@ -9,7 +9,7 @@ "check": "tsc -p tsconfig.json" }, "dependencies": { - "javascript-excel": "2.0.0-beta.0", + "javascript-excel": "2.0.0-beta.1", "react": "19.3.1", "react-dom": "19.3.1" }, diff --git a/examples/snippets/package.json b/examples/snippets/package.json index 99319ae..eb9bd64 100644 --- a/examples/snippets/package.json +++ b/examples/snippets/package.json @@ -7,7 +7,7 @@ "check": "tsc -p tsconfig.json" }, "dependencies": { - "javascript-excel": "2.0.0-beta.0" + "javascript-excel": "2.0.0-beta.1" }, "devDependencies": { "@types/node": "22.20.5", diff --git a/examples/vanilla/package.json b/examples/vanilla/package.json index 729f958..f090c9a 100644 --- a/examples/vanilla/package.json +++ b/examples/vanilla/package.json @@ -9,7 +9,7 @@ "check": "tsc -p tsconfig.json" }, "dependencies": { - "javascript-excel": "2.0.0-beta.0" + "javascript-excel": "2.0.0-beta.1" }, "devDependencies": { "typescript": "7.0.2", diff --git a/examples/vue/package.json b/examples/vue/package.json index 3e5a012..c0bfc74 100644 --- a/examples/vue/package.json +++ b/examples/vue/package.json @@ -9,7 +9,7 @@ "check": "tsc -p tsconfig.json" }, "dependencies": { - "javascript-excel": "2.0.0-beta.0", + "javascript-excel": "2.0.0-beta.1", "vue": "3.5.45" }, "devDependencies": { diff --git a/package-lock.json b/package-lock.json index 617a3e3..b24daa7 100644 --- a/package-lock.json +++ b/package-lock.json @@ -23,7 +23,7 @@ "name": "javascript-excel-playground", "version": "0.0.0", "dependencies": { - "javascript-excel": "2.0.0-beta.0" + "javascript-excel": "2.0.0-beta.1" }, "devDependencies": { "happy-dom": "21.0.4", @@ -35,7 +35,7 @@ "examples/node": { "name": "example-node", "dependencies": { - "javascript-excel": "2.0.0-beta.0" + "javascript-excel": "2.0.0-beta.1" }, "devDependencies": { "@types/node": "22.20.5", @@ -45,7 +45,7 @@ "examples/react": { "name": "example-react", "dependencies": { - "javascript-excel": "2.0.0-beta.0", + "javascript-excel": "2.0.0-beta.1", "react": "19.3.1", "react-dom": "19.3.1" }, @@ -59,7 +59,7 @@ "examples/snippets": { "name": "example-snippets", "dependencies": { - "javascript-excel": "2.0.0-beta.0" + "javascript-excel": "2.0.0-beta.1" }, "devDependencies": { "@types/node": "22.20.5", @@ -69,7 +69,7 @@ "examples/vanilla": { "name": "example-vanilla", "dependencies": { - "javascript-excel": "2.0.0-beta.0" + "javascript-excel": "2.0.0-beta.1" }, "devDependencies": { "typescript": "7.0.2", @@ -79,7 +79,7 @@ "examples/vue": { "name": "example-vue", "dependencies": { - "javascript-excel": "2.0.0-beta.0", + "javascript-excel": "2.0.0-beta.1", "vue": "3.5.45" }, "devDependencies": { @@ -3696,7 +3696,7 @@ } }, "packages/javascript-excel": { - "version": "2.0.0-beta.0", + "version": "2.0.0-beta.1", "license": "MIT", "devDependencies": { "@types/node": "22.20.5", diff --git a/packages/javascript-excel/CHANGELOG.md b/packages/javascript-excel/CHANGELOG.md index 693292a..d19f265 100644 --- a/packages/javascript-excel/CHANGELOG.md +++ b/packages/javascript-excel/CHANGELOG.md @@ -1,5 +1,20 @@ # javascript-excel +## 2.0.0-beta.1 + +The conformance corpus was checked by hand in **Excel for Mac** (2026-11-17): every file opens with no repair prompt. The results are in `docs/conformance.md`. Excel for Windows and Apple Numbers were not checked by hand; for them only the automated LibreOffice and openpyxl checks apply. What changes for users: + +- **Two-row headers without merges** (CSV) are detected by `header: 'auto'`, and a group title carries right over its sub-columns, so header groups written to CSV import back as `Q1 / Jan`, `Q1 / Feb`. +- **Built-in number formats 37–40 and 47** use the codes Excel shows, not the ECMA-376 ones. This affects `BUILTIN_NUM_FMTS` and the formatted text; written files are unchanged. +- **Sheet names** are limited to 31 characters counted as Excel counts them (code points), so a name with an emoji at the limit is no longer rejected. + +### Patch Changes + +- c100c46: Built-in number formats 37–40 and 47 now use the codes Excel itself shows, checked in Excel for Mac: `#,##0_);(#,##0)`, `#,##0_);[Red](#,##0)`, `#,##0.00_);(#,##0.00)`, `#,##0.00_);[Red](#,##0.00)` and `mm:ss.0`. The ECMA-376 table lists other codes. This changes `BUILTIN_NUM_FMTS` and what `formatValue`/`formatCell` show for those ids: positive numbers keep a trailing space where the `)` would be (`1,234.50 `), and 47 shows `31:00.0` instead of `3100.0`. Files are unaffected, because the writer writes only the id. +- 5020077: `toDataset` with `headerRows` (and `importDataset` with a multi-row header) now carries a group title right across the empty upper-row cells that follow it when there are no merges, as in CSV: `Name,Q1,` over `,Jan,Feb` gives `Name`, `Q1 / Jan`, `Q1 / Feb` instead of `Name`, `Q1 / Jan`, `Feb`. Merged cells still decide where they are present, and a column with no text in the lower header rows is not filled. +- 15f8238: Sheet names are limited to 31 code points, as in Excel, instead of 31 UTF-16 units. `validateSheetName`, the writer and `sanitizeSheetName` now accept a name such as 30 letters plus an emoji (Excel for Mac accepts it), and `sanitizeSheetName` cuts long names to 31 code points without splitting a surrogate pair. `History` stays reserved in any case (Excel refuses it), and `sanitizeSheetName` turns it into `Sheet`. +- f7e976d: `detectHeader` (and `importDataset` with `header: 'auto'`) now recognises a two-row header without merges, as CSV files have: a second all-text row whose text cells all sit on columns of typed data joins the header (`Region,Sales,Sales` over `,Q1,Q2` gives `Sales / Q1`, `Sales / Q2`). Two text rows that only fill the table together (`Name,Q1,` over `,Jan,Feb`) are also a two-row header. When the row under the header is all text but only partly fits, it stays data and the confidence is `'low'`. + ## 2.0.0-beta.0 First beta of 2.0.0, on the `next` dist-tag. The 2.0.0 feature set is complete: everything in the 2.0.0-alpha releases below. Changes before 2.0.0 should be limited to fixes found in testing, including the manual conformance check in Excel and Numbers. diff --git a/packages/javascript-excel/package.json b/packages/javascript-excel/package.json index 97fa813..15cfa83 100644 --- a/packages/javascript-excel/package.json +++ b/packages/javascript-excel/package.json @@ -1,6 +1,6 @@ { "name": "javascript-excel", - "version": "2.0.0-beta.0", + "version": "2.0.0-beta.1", "private": false, "description": "Read and write .xlsx and .csv files in browsers, Web Workers and Node. 2.0 is a from-scratch rewrite in progress.", "keywords": [ diff --git a/packages/javascript-excel/src/index.ts b/packages/javascript-excel/src/index.ts index 948c09c..a97024b 100644 --- a/packages/javascript-excel/src/index.ts +++ b/packages/javascript-excel/src/index.ts @@ -75,4 +75,4 @@ export { decodeCell, decodeCol, decodeRange, encodeCell, encodeCol, encodeRange, export type { CellAddress, RangeAddress } from "./address"; /** Package version. Set from package.json by `npm run version-packages` (scripts/sync-version.mjs); a unit test checks it. */ -export const VERSION = "2.0.0-beta.0"; +export const VERSION = "2.0.0-beta.1";