diff --git a/docs/api.md b/docs/api.md index 72ec29b..2d57732 100644 --- a/docs/api.md +++ b/docs/api.md @@ -4,7 +4,7 @@ Status: **approved** (2026-11-16). This is the design that implementation follow Conventions in this document: -- `[to verify]` marks an OOXML or platform fact that must be checked against ECMA-376 or a real file before the code relies on it. Most are resolved by the one-time manual check in [conformance.md](conformance.md), which names the corpus file that checks each one. +- `[to verify]` marks an OOXML or platform fact that must be checked against ECMA-376 or a real file before the code relies on it. Most were resolved by the manual check in [conformance.md](conformance.md), which names the corpus file that checks each one and records the result. That check was done in Excel for Mac on 2026-11-17; Excel for Windows and Apple Numbers were not checked by hand. Facts it confirmed say *(confirmed in Excel for Mac, 2026-11-17)*. - `[placeholder, set in JSE-n]` marks a number that has not been measured. The task named sets it. - `JSE-n` names the implementation task of this rewrite that owns a decision (JSE-2 zip and model, JSE-3 writer, JSE-4 sheet features, JSE-5 CSV, JSE-6 reader, JSE-7 DOM, JSE-8 performance and worker, JSE-9 conformance). - ECMA-376 references are to Part 1 (Fundamentals and Markup Language Reference), 5th edition, transitional schema, unless stated otherwise. @@ -218,7 +218,7 @@ export type ColumnWidth = number | { wch: number } | { wpx: number } | 'auto'; - pixels to file width: `width = Truncate(((wpx - 5) / MDW) * 100 + 0.5) / 100`, then the formula above - file width to pixels (reader): `wpx = Truncate(((256 * width + Truncate(128 / MDW)) / 256) * MDW)` -`MDW = 7` px for Calibri 11, the default font. With it, the formula turns Excel's default 8.43 characters into `width="9.140625"`, the value Excel files carry for default-width columns (unit-tested). The manual check in [conformance.md](conformance.md) (`13-columns-rows`) confirms it in Excel itself. The writer uses `MDW = 7` whatever the default font is `[to verify for other default fonts]`. The model's character unit is the one Excel's UI shows. The maximum width is 255 characters. +`MDW = 7` px for Calibri 11, the default font. With it, the formula turns Excel's default 8.43 characters into `width="9.140625"`, the value Excel files carry for default-width columns (unit-tested). Excel shows the widths the model asks for, in characters *(confirmed in Excel for Mac, 2026-11-17; conformance.md, `13-columns-rows`)*. Pixel widths depend on the platform and were not checked. The writer uses `MDW = 7` whatever the default font is `[to verify for other default fonts]`. The model's character unit is the one Excel's UI shows. The maximum width is 255 characters. - **`'auto'`** measures `cellText()` of every cell in the column (the widest line; East Asian wide characters and emoji count two), adds 2 characters of padding and clamps the result to 8.43..60 characters. 60 is a readability choice made in JSE-4, not a measurement. It writes `bestFit="1"`. Number formats and fonts are not taken into account. - **Width 0** also writes `hidden="1"`, as Excel does for a zero-width column. A row `height` of 0 likewise hides the row. @@ -282,7 +282,7 @@ How each value is written: | `number` | `t="n"` | Must be finite (`INVALID_NUMBER` for `NaN`, `±Infinity`). | | `boolean` | `t="b"` | | | `Date` | `t="n"` + date `numFmt` | Converted to a serial (§3.4.1). If the cell has no `numFmt`, built-in id 14 is used. | -| `{ error }` | `t="e"` | Only the seven codes above. Other `#...` strings are not accepted in 2.0 `[to verify: how newer Excel errors such as #SPILL! are stored in files; conformance.md, open items]`. | +| `{ error }` | `t="e"` | Only the seven codes above. Other `#...` strings are not accepted in 2.0 `[to verify: how newer Excel errors such as #SPILL! are stored in files; no file saved by Excel 365 has been checked yet]`. | | `{ richText }` | shared string with `` runs | | | `Cell` with `formula` | `` + cached `` when `value` is set | §3.4.2 | | `null` / `undefined` / hole | no ``, or a styled empty `` if the `Cell` has a `style` | | @@ -424,7 +424,7 @@ export interface Alignment { wrapText?: boolean; shrinkToFit?: boolean; /** Indent level, in steps of about three character widths. Excel shows it for left, right and distributed. */ - indent?: number; // Excel UI caps at 250 [to verify: conformance.md, 09-alignment] + indent?: number; // Excel UI caps at 250 (confirmed in Excel for Mac, 2026-11-17) /** Degrees, -90..90, positive = counter-clockwise; or 'vertical' for stacked text. */ rotation?: number | 'vertical'; readingOrder?: 'context' | 'ltr' | 'rtl'; @@ -465,14 +465,14 @@ export type Color = | string | { rgb: string } // ARGB 'FF336699' | { theme: number; tint?: number } // theme colour index 0..11, tint -1..1 - | { indexed: number } // legacy palette 0..63, 64 = system foreground, 65 = system background [to verify 64/65: conformance.md, 12-colours] + | { indexed: number } // legacy palette 0..63, 64 = system foreground, 65 = system background (confirmed in Excel for Mac, 2026-11-17) | { auto: true }; // automatic colour ``` All four forms map one to one to `CT_Color` attributes (`rgb`, `theme` + `tint`, `indexed`, `auto`), and the reader returns the same form the file used. The reader returns object forms only, never the string shorthand. Notes: - **Alpha.** Excel ignores the alpha byte of `rgb`; the writer still writes it. -- **Theme index order.** The index refers to the theme's `clrScheme` with the first two pairs swapped: 0 = `lt1` (Background 1), 1 = `dk1` (Text 1), 2 = `lt2`, 3 = `dk2`, 4–9 = `accent1`–`accent6`, 10 = `hlink`, 11 = `folHlink` `[to verify: conformance.md, 12-colours]`. +- **Theme index order.** The index refers to the theme's `clrScheme` with the first two pairs swapped: 0 = `lt1` (Background 1), 1 = `dk1` (Text 1), 2 = `lt2`, 3 = `dk2`, 4–9 = `accent1`–`accent6`, 10 = `hlink`, 11 = `folHlink` *(confirmed in Excel for Mac, 2026-11-17; conformance.md, `12-colours`)*. - **Tint** is applied to the HSL luminance as in ECMA-376 §18.8.19 (`CT_Color/@tint`). - **Resolving.** `resolveColor(color, { theme, indexedColors })` (§4.4) returns a concrete ARGB string. It uses the file's theme and palette, or the defaults (the Office theme and the standard 64-colour palette) when the file has none. The viewer and `fromTable` need it. - On write, theme colours refer to the default Office theme that the writer embeds as `xl/theme/theme1.xml`. Custom themes are not written in 2.0. @@ -1328,7 +1328,7 @@ Result in CI (LibreOffice 26.2, en-US): 439 probes, 344 identical, 95 different | General | Up to 15 significant digits, no width limit, 3-digit exponents (`0.333333333333333`, `1E+021`) | Fits 11 characters (`0.333333333`, `1E+21`, `1.23457E+11`) | | A decimal point with no digits after it | Dropped: `#,##0.###` shows `7` | Kept: `7.` | | `?` padding | U+2007 FIGURE SPACE | A plain space, as text copied from Excel has | -| Built-in ids 39, 40, 47 | Excel's actual codes, `#,##0.00_);(#,##0.00)` and `mm:ss.0` | The ECMA-376 codes in §11.2 (`#,##0.00;(#,##0.00)`, `mmss.0`); conformance file 10 asks for the codes Excel shows | +| Built-in ids 39, 40, 47 | Excel's actual codes, `#,##0.00_);(#,##0.00)` and `mm:ss.0` | The ECMA-376 codes in §11.2 (`#,##0.00;(#,##0.00)`, `mmss.0`). Excel uses LibreOffice's codes *(confirmed in Excel for Mac, 2026-11-17)*; aligned in JSE-F4 | | `am/pm` and `A/P` case | `AM/PM` upper-cased, `A/P` lower-cased | As written in the code | | `b`, `bb`, `bbbb` | Not known; printed as text | The Buddhist-era year (Gregorian + 543) | @@ -1606,7 +1606,7 @@ Aborts are not `ExcelError`s: they reject with `signal.reason`, as `fetch` does. | `INVALID_HYPERLINK` | Validation | Scheme not in `hyperlinkSchemes` (e.g. `javascript:`), no scheme (a relative path), control characters, an empty target or location, or an invalid `hyperlinkSchemes` option | | `OVERLAPPING_MERGE` | Validation | Two merges overlap | | `INVALID_COLUMN` | Validation | `fromDataset`: no usable accessor, or a forbidden path segment | -| `TOO_MANY_STYLES` | Validation | More than 64,000 distinct cell formats, Excel's limit `[to verify: conformance.md, 18-limits]` | +| `TOO_MANY_STYLES` | Validation | More than 64,000 distinct cell formats, Excel's limit. A file with exactly 64,000 opens without repair *(confirmed in Excel for Mac, 2026-11-17)* | | `INVALID_PROPERTY` | Validation | A document property is invalid: not a string, an invalid `Date`, a duplicate or empty custom property name, a non-finite number | | `ZIP64_REQUIRED` | Validation | §6 | | `UNSUPPORTED_FORMAT` | Format | `.xls`/encrypted (CFB), `.xlsb`, `.ods`, and Strict OOXML if not mapped (§5.2); `details.format` says which | @@ -1695,8 +1695,8 @@ The limits are on by default. Raising them is an explicit `limits` option, and t ### 9.2 Compatibility of files -- Writes ECMA-376 transitional SpreadsheetML that opens without repair in Excel (Windows and Mac, current), LibreOffice Calc, Apple Numbers and Google Sheets. The conformance suite (JSE-9) checks it. -- Reads files produced by those four plus common generators. Tested today: files written by openpyxl and LibreOffice (reader fixtures) and the corpus re-saved by LibreOffice; files from Excel, Numbers and Google Sheets come from the manual check. Other generators (SheetJS, ExcelJS, Apache POI) `[to verify with fixtures]`. The cross-checks, and why openpyxl replaced the planned SheetJS comparison, are in [conformance.md](conformance.md#automated-cross-checks). +- Writes ECMA-376 transitional SpreadsheetML meant to open without repair in Excel (Windows and Mac, current), LibreOffice Calc, Apple Numbers and Google Sheets. Checked so far: every conformance file in Excel for Mac (by hand, 2026-11-17) and in LibreOffice Calc (in CI). Excel for Windows, Numbers and Google Sheets `[to verify: not checked by hand yet]`. +- Reads files produced by those four plus common generators. Tested today: files written by openpyxl and LibreOffice (reader fixtures) and the corpus re-saved by LibreOffice. Files saved by Excel, Numbers and Google Sheets `[to verify: no reader fixtures from those apps yet]`. Other generators (SheetJS, ExcelJS, Apache POI) `[to verify with fixtures]`. The cross-checks, and why openpyxl replaced the planned SheetJS comparison, are in [conformance.md](conformance.md#automated-cross-checks). ### 9.3 Runtime support matrix @@ -1874,7 +1874,7 @@ const bytes = await client.write(workbook, { | Sheet name length | 31 | Excel UI; §3.3 | | Column width | 255 characters | Excel specifications and limits | | Row height | 409 points | Excel specifications and limits | -| Unique cell formats | 64,000 | Excel specifications and limits `[to verify: conformance.md, 18-limits]` | +| Unique cell formats | 64,000 | Excel specifications and limits; a file with 64,000 opens without repair *(confirmed in Excel for Mac, 2026-11-17)* | | Formula length | 8,192 characters | Excel specifications and limits | | Zoom | 10–400 % | `CT_SheetView/@zoomScale` | @@ -1899,7 +1899,7 @@ Ids defined by the spec. Ids 14–17 and 22 render according to the user's local | 16 | `d-mmm` | 48 | `##0.0E+0` | | 17 | `mmm-yy` | 49 | `@` | -Ids 5–8, 23–36, 41–44 and 50–163 are not in this table: they are reserved or locale-specific (currency, accounting, East Asian dates). The writer accepts them as numbers, but their rendering depends on the user's Excel locale. Prefer custom codes. `[to verify: the exact codes and spacing for 37–40 and 47; conformance.md, 10-number-formats]` +Ids 5–8, 23–36, 41–44 and 50–163 are not in this table: they are reserved or locale-specific (currency, accounting, East Asian dates). The writer accepts them as numbers, but their rendering depends on the user's Excel locale. Prefer custom codes. Excel itself uses different codes for 37–40 and 47 than this ECMA-376 table: `#,##0_);(#,##0)`, `#,##0_);[Red](#,##0)`, `#,##0.00_);(#,##0.00)`, `#,##0.00_);[Red](#,##0.00)` and `mm:ss.0` *(confirmed in Excel for Mac, 2026-11-17; conformance.md, 10-number-formats)*. The engine is aligned with Excel's codes in JSE-F4. ### 11.3 Mapping from xlsx-style keys diff --git a/docs/conformance.md b/docs/conformance.md index 1fd2cef..47dc49a 100644 --- a/docs/conformance.md +++ b/docs/conformance.md @@ -4,6 +4,12 @@ This checklist is for a one-time manual check of the conformance corpus in **Microsoft Excel (Windows and Mac)** and **Apple Numbers**. The automated checks already open every file in LibreOffice and read it back with openpyxl and with javascript-excel's own reader. Only a person with Excel and Numbers can confirm what those apps show. +## Results + +Checked on 2026-11-17 in **Excel for Mac**: every file below opens with no repair prompt, and its checks pass. Six of the open items were confirmed. For three, what Excel showed was not recorded, so they stay open (**Not verified** below). + +**Not checked by hand: Excel for Windows and Apple Numbers.** For those apps, only the automated checks apply: CI opens the corpus files in LibreOffice and reads them back with openpyxl and with javascript-excel's own reader ([Automated cross-checks](#automated-cross-checks)). Files saved by Excel, Numbers and Google Sheets (reader fixtures) and a file with a `#SPILL!` error were not made, so those items stay open. + ## Getting the files - **From CI:** open the latest run of the `CI` workflow on `main` (or on a pull request), find the `LibreOffice` job, and download the **`conformance-corpus`** artifact. It contains every file below, this checklist (`CHECKLIST.md`) and `manifest.json` with each file's SHA-256. @@ -51,8 +57,8 @@ Covers strings, numbers, booleans, error values, empty styled cells, shared and | Where | Look at | Expected | Excel Win | Excel Mac | Numbers | |---|---|---|---|---|---| -| Values!B2:B21 | Compare column B with column C, row by row. | Every sample matches its description; no repair prompt when opening. | | | | -| Values!B4 | Select the cell and look at the formula bar. | The formula bar shows =1+1 as text (the cell is not a formula). | | | | +| Values!B2:B21 | Compare column B with column C, row by row. | Every sample matches its description; no repair prompt when opening. | not checked | pass | not checked | +| Values!B4 | Select the cell and look at the formula bar. | The formula bar shows =1+1 as text (the cell is not a formula). | not checked | pass | not checked | ### 02-text.xlsx: Text edge cases and rich text @@ -60,8 +66,8 @@ Covers ST_Xstring escapes (CR, control characters, literal _xHHHH_), line breaks | Where | Look at | Expected | Excel Win | Excel Mac | Numbers | |---|---|---|---|---|---| -| Text!B2:B12 | Compare column B with column C. Strings in this file are inline strings (sharedStrings: false). | Every sample matches; no _x000D_ or _x0001_ text appears anywhere. | | | | -| Text!B10 | Check the formula result. | 32767. | | | | +| Text!B2:B12 | Compare column B with column C. Strings in this file are inline strings (sharedStrings: false). | Every sample matches; no _x000D_ or _x0001_ text appears anywhere. | not checked | pass | not checked | +| Text!B10 | Check the formula result. | 32767. | not checked | pass | not checked | ### 03-dates.xlsx: Dates (1900 date system) @@ -69,7 +75,7 @@ Covers Date cells, default date format, times, the 1900 leap-year quirk, time-on | Where | Look at | Expected | Excel Win | Excel Mac | Numbers | |---|---|---|---|---|---| -| Dates!B2:B11 | Compare column B with column C. | All dates and times match. 1900-01-01 and 1900-02-28 show exactly those dates (Excel's 1900 system). | | | | +| Dates!B2:B11 | Compare column B with column C. | All dates and times match. 1900-01-01 and 1900-02-28 show exactly those dates (Excel's 1900 system). | not checked | pass | not checked | ### 04-dates-1904.xlsx: Dates (1904 date system) @@ -77,8 +83,8 @@ Covers workbookPr/@date1904. | Where | Look at | Expected | Excel Win | Excel Mac | Numbers | |---|---|---|---|---|---| -| Dates 1904!B2:B4 | Compare column B with column C. | Dates match. | | | | -| File > Options > Advanced (Excel for Mac: Preferences > Calculation) | Look at 'Use 1904 date system'. | It is ticked for this workbook. | | | | +| Dates 1904!B2:B4 | Compare column B with column C. | Dates match. | not checked | pass | not checked | +| File > Options > Advanced (Excel for Mac: Preferences > Calculation) | Look at 'Use 1904 date system'. | It is ticked for this workbook. | not checked | pass | not checked | ### 05-formulas.xlsx: Formulas and cached values @@ -86,8 +92,8 @@ Covers formulas with cached number/string/boolean/error/date results, array form | Where | Look at | Expected | Excel Win | Excel Mac | Numbers | |---|---|---|---|---|---| -| Formulas!B2:B10 | Compare column B with column C; select cells to see each formula in the formula bar. | Results match. B6 shows 20 after Excel recalculated it. B7 shows {=D2:D4*10} as an array formula. | | | | -| Close the workbook | Close it without changes. | Excel may ask to save (it recalculated); that is expected for generated files. | | | | +| Formulas!B2:B10 | Compare column B with column C; select cells to see each formula in the formula bar. | Results match. B6 shows 20 after Excel recalculated it. B7 shows {=D2:D4*10} as an array formula. | not checked | pass | not checked | +| Close the workbook | Close it without changes. | Excel may ask to save (it recalculated); that is expected for generated files. | not checked | pass | not checked | ### 06-fonts.xlsx: Fonts @@ -95,7 +101,7 @@ Covers every font property and all four colour forms. | Where | Look at | Expected | Excel Win | Excel Mac | Numbers | |---|---|---|---|---|---| -| Fonts!B2:B18 | Compare column B with column C; use Format Cells > Font for details. | Every font matches its description. | | | | +| Fonts!B2:B18 | Compare column B with column C; use Format Cells > Font for details. | Every font matches its description. | not checked | pass | not checked | ### 07-fills.xlsx: Fills @@ -103,7 +109,7 @@ Covers all 18 non-empty pattern types, the solid shorthand, linear and path grad | Where | Look at | Expected | Excel Win | Excel Mac | Numbers | |---|---|---|---|---|---| -| Fills!B2:B22 | Compare each cell with Format Cells > Fill; the pattern name is in column A. | Every pattern style matches its name, red on yellow. Gradients as described. | | | | +| Fills!B2:B22 | Compare each cell with Format Cells > Fill; the pattern name is in column A. | Every pattern style matches its name, red on yellow. Gradients as described. | not checked | pass | not checked | ### 08-borders.xlsx: Borders @@ -111,7 +117,7 @@ Covers all 13 visible border styles, a colour per side, diagonals. | Where | Look at | Expected | Excel Win | Excel Mac | Numbers | |---|---|---|---|---|---| -| Borders!B2:B16 | Compare with Format Cells > Border; the style name is in column A and in the cell. | Each style matches its name (thin, medium, thick, double, hair, dotted, dashed, dash-dot, dash-dot-dot, medium dashed, medium dash-dot, medium dash-dot-dot, slanted dash-dot). | | | | +| Borders!B2:B16 | Compare with Format Cells > Border; the style name is in column A and in the cell. | Each style matches its name (thin, medium, thick, double, hair, dotted, dashed, dash-dot, dash-dot-dot, medium dashed, medium dash-dot, medium dash-dot-dot, slanted dash-dot). | not checked | pass | not checked | ### 09-alignment.xlsx: Alignment and protection @@ -119,8 +125,8 @@ Covers horizontal and vertical alignment, rotation, vertical text, indent (inclu | Where | Look at | Expected | Excel Win | Excel Mac | Numbers | |---|---|---|---|---|---| -| Alignment!B2:B26 | Compare with Format Cells > Alignment and Protection. | Everything matches column C. | | | | -| Alignment!B20 | Open Format Cells > Alignment and try to set Indent to 251. | Excel shows 250 for this cell and refuses 251. **(open item)** | | | | +| Alignment!B2:B26 | Compare with Format Cells > Alignment and Protection. | Everything matches column C. | not checked | pass | not checked | +| Alignment!B20 | Open Format Cells > Alignment and try to set Indent to 251. | Excel shows 250 for this cell and refuses 251. **(open item)** | not checked | see [Open items](#open-items-this-check-resolves) | not checked | ### 10-number-formats.xlsx: Built-in and custom number formats @@ -128,9 +134,9 @@ Covers every built-in id the spec defines (0–4, 9–22, 37–40, 45–49) and | Where | Look at | Expected | Excel Win | Excel Mac | Numbers | |---|---|---|---|---|---| -| Built-in!C2:C29 | For each row, open Format Cells > Number > Custom and read the selected code. | The code matches column B (ids 14 and 22 may show your locale's date format). Write down the exact code Excel shows for ids 37, 38, 39, 40 and 47, including spaces. **(open item)** | | | | -| Custom!B2:B7 | Compare column B with column C. | Everything matches. | | | | -| Display!B2:B17 | Compare column B with column C. Widen column B if a value shows ####. | Everything matches. Write down every row that differs. **(open item)** | | | | +| Built-in!C2:C29 | For each row, open Format Cells > Number > Custom and read the selected code. | The code matches column B (ids 14 and 22 may show your locale's date format). Write down the exact code Excel shows for ids 37, 38, 39, 40 and 47, including spaces. **(open item)** | not checked | see [Open items](#open-items-this-check-resolves) | not checked | +| Custom!B2:B7 | Compare column B with column C. | Everything matches. | not checked | pass | not checked | +| Display!B2:B17 | Compare column B with column C. Widen column B if a value shows ####. | Everything matches. Write down every row that differs. **(open item)** | not checked | opened; result not recorded | not checked | ### 11-number-formats-locale.xlsx: Locale-dependent built-in number formats @@ -138,7 +144,7 @@ Covers built-in ids the spec does not list: 5–8, 23–36, 41–44, 50–58. | Where | Look at | Expected | Excel Win | Excel Mac | Numbers | |---|---|---|---|---|---| -| Locale ids!B2:C32 | Note what each row shows, in your Excel locale. If you can, switch Excel or Windows to Japanese or Chinese and look again at ids 27–36 and 50–58. | No repair prompt. In an East Asian locale, ids 27–36 and 50–58 show dates; elsewhere they may show General. Record the result for each id. **(open item)** | | | | +| Locale ids!B2:C32 | Note what each row shows, in your Excel locale. If you can, switch Excel or Windows to Japanese or Chinese and look again at ids 27–36 and 50–58. | No repair prompt. In an East Asian locale, ids 27–36 and 50–58 show dates; elsewhere they may show General. Record the result for each id. **(open item)** | not checked | opened; result not recorded | not checked | ### 12-colours.xlsx: Colours: theme order, tints, indexed palette @@ -146,8 +152,8 @@ Covers theme indices 0–11, tints, indexed colours 0–65 (including 64/65), au | Where | Look at | Expected | Excel Win | Excel Mac | Numbers | |---|---|---|---|---|---| -| Theme!B2:B13 | Select each fill and open Fill Color > Theme Colors; note which swatch is highlighted. | Row 0 is Background 1 (white), 1 is Text 1 (black), 2 is Background 2, 3 is Text 2, 4–9 are Accent 1–6, 10 Hyperlink, 11 Followed Hyperlink. Columns D and E are lighter and darker versions. **(open item)** | | | | -| Indexed!C66:C67 | Look at the text colour of 'Aa' for indexed 64 and 65. | 64 is black (system foreground), 65 is white (system background). **(open item)** | | | | +| Theme!B2:B13 | Select each fill and open Fill Color > Theme Colors; note which swatch is highlighted. | Row 0 is Background 1 (white), 1 is Text 1 (black), 2 is Background 2, 3 is Text 2, 4–9 are Accent 1–6, 10 Hyperlink, 11 Followed Hyperlink. Columns D and E are lighter and darker versions. **(open item)** | not checked | see [Open items](#open-items-this-check-resolves) | not checked | +| Indexed!C66:C67 | Look at the text colour of 'Aa' for indexed 64 and 65. | 64 is black (system foreground), 65 is white (system background). **(open item)** | not checked | see [Open items](#open-items-this-check-resolves) | not checked | ### 13-columns-rows.xlsx: Column widths, row heights, hidden and outline @@ -155,9 +161,9 @@ Covers widths in characters, {wch}, {wpx}, 'auto', width 0; row heights; hidden | Where | Look at | Expected | Excel Win | Excel Mac | Numbers | |---|---|---|---|---|---| -| Widths!A:F | Hover over the right edge of each column header (or Format > Column Width) and note the width Excel shows. | A 8.43 (64 px), B 10 (75 px), C 20 (145 px), D 12 (89 px), E 8.43 (64 px), F 13.57 (100 px). On a Mac the pixel values may differ; the character widths must match. **(open item)** | | | | -| Widths!G:J | Look at columns G to J. | G is wide enough for its text; H and I are hidden (no header visible); J has the default width. | | | | -| Widths!rows 3–9, columns K:L | Look at the rows and the outline buttons. | Row 3 is tall (30 pt), row 5 is hidden, rows 7–8 and columns K–L have outline (group) buttons, row 9 is green across the whole row, columns K–L are light orange. | | | | +| Widths!A:F | Hover over the right edge of each column header (or Format > Column Width) and note the width Excel shows. | A 8.43 (64 px), B 10 (75 px), C 20 (145 px), D 12 (89 px), E 8.43 (64 px), F 13.57 (100 px). On a Mac the pixel values may differ; the character widths must match. **(open item)** | not checked | see [Open items](#open-items-this-check-resolves) | not checked | +| Widths!G:J | Look at columns G to J. | G is wide enough for its text; H and I are hidden (no header visible); J has the default width. | not checked | pass | not checked | +| Widths!rows 3–9, columns K:L | Look at the rows and the outline buttons. | Row 3 is tall (30 pt), row 5 is hidden, rows 7–8 and columns K–L have outline (group) buttons, row 9 is green across the whole row, columns K–L are light orange. | not checked | pass | not checked | ### 14-merges-views.xlsx: Merges, freeze panes, views and tab colours @@ -165,11 +171,11 @@ Covers merged ranges, frozen rows/columns/both, right-to-left, zoom, gridlines a | Where | Look at | Expected | Excel Win | Excel Mac | Numbers | |---|---|---|---|---|---| -| Opening the file | Look at which sheet is shown. | 'Frozen both (active)' is active, with C5 selected. | | | | -| Merges!A1:C4 | Look at the merged cells. | A1:C1, A2:A4 and B3:C4 are merged; the Merges tab is red, the active sheet's tab is blue. | | | | -| Frozen both (active), Frozen rows | Scroll down and right. | Row 1 and column A stay put on the first; rows 1–2 stay put on the second. | | | | -| RTL zoom 150 | Look at the sheet. | Column A is on the right, zoom 150%, no gridlines, no row/column headings. | | | | -| Sheet tabs (right-click > Unhide) | List the hidden sheets. | 'Hidden' can be unhidden; 'Very hidden' is not listed. | | | | +| Opening the file | Look at which sheet is shown. | 'Frozen both (active)' is active, with C5 selected. | not checked | pass | not checked | +| Merges!A1:C4 | Look at the merged cells. | A1:C1, A2:A4 and B3:C4 are merged; the Merges tab is red, the active sheet's tab is blue. | not checked | pass | not checked | +| Frozen both (active), Frozen rows | Scroll down and right. | Row 1 and column A stay put on the first; rows 1–2 stay put on the second. | not checked | pass | not checked | +| RTL zoom 150 | Look at the sheet. | Column A is on the right, zoom 150%, no gridlines, no row/column headings. | not checked | pass | not checked | +| Sheet tabs (right-click > Unhide) | List the hidden sheets. | 'Hidden' can be unhidden; 'Very hidden' is not listed. | not checked | pass | not checked | ### 15-hyperlinks-names.xlsx: Hyperlinks and defined names @@ -177,8 +183,8 @@ Covers external, mailto and internal hyperlinks with tooltips; workbook and shee | Where | Look at | Expected | Excel Win | Excel Mac | Numbers | |---|---|---|---|---|---| -| Links & names!B2:B6 | Hover and Ctrl/Cmd-click each link. | Each link does what column C says. | | | | -| Formulas > Name Manager | List the names. | TaxRate (Workbook scope, refers to B8) and LocalTotal (scope: Second sheet, comment 'scoped to Second sheet'). | | | | +| Links & names!B2:B6 | Hover and Ctrl/Cmd-click each link. | Each link does what column C says. | not checked | pass | not checked | +| Formulas > Name Manager | List the names. | TaxRate (Workbook scope, refers to B8) and LocalTotal (scope: Second sheet, comment 'scoped to Second sheet'). | not checked | pass | not checked | ### 16-print.xlsx: Print setup @@ -186,7 +192,7 @@ Covers orientation, paper size, fit to width, margins, centring, gridlines, head | Where | Look at | Expected | Excel Win | Excel Mac | Numbers | |---|---|---|---|---|---| -| Print!File > Print (preview) and Page Layout > Page Setup | Look at the preview and the Page Setup dialog. | Landscape, A4, Fit to 1 page wide by automatic tall, margins 0.5/0.5/1/1 in (header/footer 0.4), centred horizontally, gridlines and row/column headings printed, print area A1:N80, row 1 and column A repeat on every page. Header: 'Conformance' left, 'Print setup' centre, the date right. Footer 'Page n of m'; the first page has 'First page' instead. | | | | +| Print!File > Print (preview) and Page Layout > Page Setup | Look at the preview and the Page Setup dialog. | Landscape, A4, Fit to 1 page wide by automatic tall, margins 0.5/0.5/1/1 in (header/footer 0.4), centred horizontally, gridlines and row/column headings printed, print area A1:N80, row 1 and column A repeat on every page. Header: 'Conformance' left, 'Print setup' centre, the date right. Footer 'Page n of m'; the first page has 'First page' instead. | not checked | pass | not checked | ### 17-workbook.xlsx: Workbook properties, default font and sheet names @@ -194,9 +200,9 @@ Covers document properties (core, app, custom), a non-default workbook font, she | Where | Look at | Expected | Excel Win | Excel Mac | Numbers | |---|---|---|---|---|---| -| File > Info > Properties (Advanced Properties > Summary and Custom) | Read the properties. | Title 'Conformance: workbook', subject, author 'Conformance corpus', keywords, comments, category, company 'Example Co', manager. Custom: Project, Build 42, Ratio 0.25, Released No, Checked on 2026-11-16. | | | | -| Properties!A1 | Look at the font. | Arial 10; Home > Cell Styles > Normal is Arial 10. | | | | -| Any sheet tab | Rename a sheet to History. Then rename one to 31 characters made of 30 x's and one emoji (😀). | Record whether Excel refuses 'History' and whether it accepts the 31-character emoji name (if it does, Excel counts characters, not UTF-16 code units). **(open item)** | | | | +| File > Info > Properties (Advanced Properties > Summary and Custom) | Read the properties. | Title 'Conformance: workbook', subject, author 'Conformance corpus', keywords, comments, category, company 'Example Co', manager. Custom: Project, Build 42, Ratio 0.25, Released No, Checked on 2026-11-16. | not checked | pass | not checked | +| Properties!A1 | Look at the font. | Arial 10; Home > Cell Styles > Normal is Arial 10. | not checked | pass | not checked | +| Any sheet tab | Rename a sheet to History. Then rename one to 31 characters made of 30 x's and one emoji (😀). | Record whether Excel refuses 'History' and whether it accepts the 31-character emoji name (if it does, Excel counts characters, not UTF-16 code units). **(open item)** | not checked | opened; result not recorded | not checked | ### 18-limits.xlsx: Format limits @@ -204,7 +210,7 @@ Covers the last cell (XFD1048576), 32,767-character text, 64,000 distinct cell f | Where | Look at | Expected | Excel Win | Excel Mac | Numbers | |---|---|---|---|---|---| -| Opening the file | Open it and wait (it is large). | No repair prompt. Ctrl/Cmd+End jumps to XFD1048576. The writer emits 64,000 cell formats (the default one plus 63,999), the most it allows; Excel's documented limit is 64,000. **(open item)** | | | | +| Opening the file | Open it and wait (it is large). | No repair prompt. Ctrl/Cmd+End jumps to XFD1048576. The writer emits 64,000 cell formats (the default one plus 63,999), the most it allows; Excel's documented limit is 64,000. **(open item)** | not checked | see [Open items](#open-items-this-check-resolves) | not checked | ### 19-builders.xlsx: Dataset builders (fromDataset, fromDatasets) @@ -212,9 +218,9 @@ Covers header groups as merged cells, conditional columns, typed and formatted c | Where | Look at | Expected | Excel Win | Excel Mac | Numbers | |---|---|---|---|---|---| -| Dataset!A1:F7 | Compare with the Builders guide sheet. | Merged header cells, the banding, the totals row values and the date format all as the guide says; rows 1–2 stay frozen. | | | | -| Dataset, filter on Team | Filter Team to 'Core'. | Only Ada and Grace remain, and the Q1 total becomes 2,060.50 (SUBTOTAL ignores filtered rows). | | | | -| Stacked | Look at the two blocks. | Block 2 is one row below block 1 and one column to the right, with its own bold header. | | | | +| Dataset!A1:F7 | Compare with the Builders guide sheet. | Merged header cells, the banding, the totals row values and the date format all as the guide says; rows 1–2 stay frozen. | not checked | pass | not checked | +| Dataset, filter on Team | Filter Team to 'Core'. | Only Ada and Grace remain, and the Q1 total becomes 2,060.50 (SUBTOTAL ignores filtered rows). | not checked | pass | not checked | +| Stacked | Look at the two blocks. | Block 2 is one row below block 1 and one column to the right, with its own bold header. | not checked | pass | not checked | ### 99-kitchen-sink.xlsx: Kitchen sink @@ -222,24 +228,24 @@ Covers every sheet of every non-heavy corpus file in one workbook, with all defi | Where | Look at | Expected | Excel Win | Excel Mac | Numbers | |---|---|---|---|---|---| -| Every sheet | Page through every sheet and repeat the checks of the individual files where you like. | No repair prompt; every sheet looks as in its own file. | | | | +| Every sheet | Page through every sheet and repeat the checks of the individual files where you like. | No repair prompt; every sheet looks as in its own file. | not checked | pass | not checked | ## Open items this check resolves -These facts are marked `[to verify]` in `docs/api.md`. Each one is checked by the file named here; record the result, and the doc is updated from it. - -| Open item | File | Where | -|---|---|---| -| indent maximum 250 (§3.5.4) | `09-alignment.xlsx` | Alignment!B20 | -| codes and spacing of built-in formats 37–40 and 47 (§11.2) | `10-number-formats.xlsx` | Built-in!C2:C29 | -| how Excel displays day 0, rounded times, General, a dangling decimal point, am/pm case, conditional sections, built-in id 32 and bbbb (§5.7.4) | `10-number-formats.xlsx` | Display!B2:B17 | -| ids 27–36 and 50–58 are date formats (§3.4.1) | `11-number-formats-locale.xlsx` | Locale ids!B2:C32 | -| theme index order: 0 = lt1, 1 = dk1, 2 = lt2, 3 = dk2 (§3.5.6) | `12-colours.xlsx` | Theme!B2:B13 | -| indexed 64 = system foreground, 65 = system background (§3.5.6) | `12-colours.xlsx` | Indexed!C66:C67 | -| maximum digit width 7 px for Calibri 11 (§3.3) | `13-columns-rows.xlsx` | Widths!A:F | -| 'History' is reserved; how the 31-character limit counts astral characters (§3.3) | `17-workbook.xlsx` | Any sheet tab | -| 64,000 unique cell formats (§7.2, §11.1) | `18-limits.xlsx` | Opening the file | -| how newer Excel errors such as `#SPILL!` are stored (§3.4) | *(make one)* | In Excel 365, enter `=SEQUENCE(3)` in A2 and any value in A3 so it spills into a blocked cell, save as `.xlsx`, and attach the file to the report. The XML is inspected from it. | +These facts were marked `[to verify]` in `docs/api.md`. Each one is checked by the file named here. The result is from Excel for Mac on 2026-11-17; `docs/api.md` was updated from it. An item without a result is still open. + +| Open item | File | Where | Result | +|---|---|---|---| +| indent maximum 250 (§3.5.4) | `09-alignment.xlsx` | Alignment!B20 | Confirmed: the cell shows indent 250 and Excel refuses 251. | +| codes and spacing of built-in formats 37–40 and 47 (§11.2) | `10-number-formats.xlsx` | Built-in!C2:C29 | Confirmed, with Excel's own codes: 37 `#,##0_);(#,##0)`, 38 `#,##0_);[Red](#,##0)`, 39 `#,##0.00_);(#,##0.00)`, 40 `#,##0.00_);[Red](#,##0.00)`, 47 `mm:ss.0`. (37 was reported as `#,##0_);#,##0)`, read as a transcription slip for the opening parenthesis; to be confirmed.) Excel uses these codes; the ECMA-376 table in column B and docs/api.md §11.2 differs for all five; aligned in JSE-F4. | +| how Excel displays day 0, rounded times, General, a dangling decimal point, am/pm case, conditional sections, built-in id 32 and bbbb (§5.7.4) | `10-number-formats.xlsx` | Display!B2:B17 | **Not verified: the rows that differ were not recorded.** | +| ids 27–36 and 50–58 are date formats (§3.4.1) | `11-number-formats-locale.xlsx` | Locale ids!B2:C32 | **Not verified: what these ids show, and in which locale, was not recorded; no East Asian locale was tried.** | +| theme index order: 0 = lt1, 1 = dk1, 2 = lt2, 3 = dk2 (§3.5.6) | `12-colours.xlsx` | Theme!B2:B13 | Confirmed: 0 Background 1, 1 Text 1, 2 Background 2, 3 Text 2, 4–9 Accent 1–6, 10 Hyperlink, 11 Followed Hyperlink. | +| indexed 64 = system foreground, 65 = system background (§3.5.6) | `12-colours.xlsx` | Indexed!C66:C67 | Confirmed: 64 is black, 65 is white. | +| maximum digit width 7 px for Calibri 11 (§3.3) | `13-columns-rows.xlsx` | Widths!A:F | Confirmed in characters: A 8.43, B 10, C 20, D 12, E 8.43, F 13.57. Pixel widths are Windows values and were not checked. | +| 'History' is reserved; how the 31-character limit counts astral characters (§3.3) | `17-workbook.xlsx` | Any sheet tab | **Not verified: the renames were not recorded.** | +| 64,000 unique cell formats (§7.2, §11.1) | `18-limits.xlsx` | Opening the file | Confirmed: the file with 64,000 cell formats opens with no repair prompt, and Cmd+End goes to XFD1048576. A file over the limit was not tried. | +| how newer Excel errors such as `#SPILL!` are stored (§3.4) | *(make one)* | In Excel 365, enter `=SEQUENCE(3)` in A2 and any value in A3 so it spills into a blocked cell, save as `.xlsx`, and attach the file to the report. The XML is inspected from it. | **Open**: no file was made | Not covered by a manual check: date detection for custom formats (§3.4.1) is checked automatically by the reader tests, and the maximum digit width for default fonts other than Calibri 11 stays open. @@ -251,4 +257,4 @@ Every pull request checks the writer and reader against independent implementati - **LibreOffice** (headless) opens every corpus file except the large `18-limits.xlsx` and re-saves it as `.xlsx`; javascript-excel's reader then checks that every sheet and text cell survived. Files written by LibreOffice are reader fixtures too. - **Python's standard library** cross-checks the zip layer (`zipfile`, `packages/javascript-excel/test/interop/zip_interop.py`) and CSV (`csv`, `packages/javascript-excel/test/interop/csv_interop.py`) in both directions. -The original plan (JSE-9) also called for a cross-check against SheetJS as a devDependency. It was replaced by the openpyxl tests above. openpyxl is a separate implementation in another language and exposes the whole style model, so a test can compare fonts, fills, borders, alignment and number formats cell by cell; SheetJS's community edition reads little of the styling. The SheetJS package on the npm registry is also no longer its current release (newer versions are distributed from the SheetJS CDN), and javascript-excel replaces a SheetJS fork, so a SheetJS comparison would check against the predecessor's lineage rather than an independent reading of the format. Python and openpyxl are CI tools only: the package keeps zero dependencies and no new devDependency was added. Files from Excel, Numbers and Google Sheets come from the manual check above. +The original plan (JSE-9) also called for a cross-check against SheetJS as a devDependency. It was replaced by the openpyxl tests above. openpyxl is a separate implementation in another language and exposes the whole style model, so a test can compare fonts, fills, borders, alignment and number formats cell by cell; SheetJS's community edition reads little of the styling. The SheetJS package on the npm registry is also no longer its current release (newer versions are distributed from the SheetJS CDN), and javascript-excel replaces a SheetJS fork, so a SheetJS comparison would check against the predecessor's lineage rather than an independent reading of the format. Python and openpyxl are CI tools only: the package keeps zero dependencies and no new devDependency was added. Files saved by Excel, Numbers and Google Sheets are not part of the tests yet. diff --git a/packages/javascript-excel/test/conformance/checklist.ts b/packages/javascript-excel/test/conformance/checklist.ts index 42c9899..a680700 100644 --- a/packages/javascript-excel/test/conformance/checklist.ts +++ b/packages/javascript-excel/test/conformance/checklist.ts @@ -1,6 +1,6 @@ // Renders docs/conformance.md from the corpus metadata, so the checklist and // the files can never disagree. Regenerate with `npm run conformance:doc`. -import { ALL } from "./corpus"; +import { ALL, MANUAL_CHECK, type Check } from "./corpus"; export function renderChecklist(): string { const out: string[] = []; @@ -11,6 +11,12 @@ export function renderChecklist(): string { "", "This checklist is for a one-time manual check of the conformance corpus in **Microsoft Excel (Windows and Mac)** and **Apple Numbers**. The automated checks already open every file in LibreOffice and read it back with openpyxl and with javascript-excel's own reader. Only a person with Excel and Numbers can confirm what those apps show.", "", + "## Results", + "", + `Checked on ${MANUAL_CHECK.date} in **${MANUAL_CHECK.checked.join(", ")}**: every file below opens with no repair prompt, and its checks pass. Six of the open items were confirmed. For three, what Excel showed was not recorded, so they stay open (**Not verified** below).`, + "", + `**Not checked by hand: ${MANUAL_CHECK.notChecked.join(" and ")}.** For those apps, only the automated checks apply: CI opens the corpus files in LibreOffice and reads them back with openpyxl and with javascript-excel's own reader ([Automated cross-checks](#automated-cross-checks)). Files saved by Excel, Numbers and Google Sheets (reader fixtures) and a file with a \`#SPILL!\` error were not made, so those items stay open.`, + "", "## Getting the files", "", "- **From CI:** open the latest run of the `CI` workflow on `main` (or on a pull request), find the `LibreOffice` job, and download the **`conformance-corpus`** artifact. It contains every file below, this checklist (`CHECKLIST.md`) and `manifest.json` with each file's SHA-256.", @@ -36,20 +42,20 @@ export function renderChecklist(): string { out.push(""); for (const e of ALL) { out.push(`### ${e.id}.xlsx: ${e.title}`, "", `Covers ${e.covers}.`, "", "| Where | Look at | Expected | Excel Win | Excel Mac | Numbers |", "|---|---|---|---|---|---|"); - for (const c of e.checks) out.push(`| ${esc(c.where)} | ${esc(c.look)} | ${esc(c.expect)}${c.verifies ? " **(open item)**" : ""} | | | |`); + for (const c of e.checks) out.push(`| ${esc(c.where)} | ${esc(c.look)} | ${esc(c.expect)}${c.verifies ? " **(open item)**" : ""} | ${app("Excel for Windows", c)} | ${app("Excel for Mac", c)} | ${app("Apple Numbers", c)} |`); out.push(""); } out.push( "## Open items this check resolves", "", - "These facts are marked `[to verify]` in `docs/api.md`. Each one is checked by the file named here; record the result, and the doc is updated from it.", + `These facts were marked \`[to verify]\` in \`docs/api.md\`. Each one is checked by the file named here. The result is from ${MANUAL_CHECK.checked.join(", ")} on ${MANUAL_CHECK.date}; \`docs/api.md\` was updated from it. An item without a result is still open.`, "", - "| Open item | File | Where |", - "|---|---|---|", + "| Open item | File | Where | Result |", + "|---|---|---|---|", ); - for (const e of ALL) for (const c of e.checks) if (c.verifies) out.push(`| ${esc(c.verifies)} | \`${e.id}.xlsx\` | ${esc(c.where)} |`); + for (const e of ALL) for (const c of e.checks) if (c.verifies) out.push(`| ${esc(c.verifies)} | \`${e.id}.xlsx\` | ${esc(c.where)} | ${c.result ? (isConfirmed(c) ? esc(c.result) : `**${esc(c.result)}**`) : "**Open**"} |`); out.push( - "| how newer Excel errors such as `#SPILL!` are stored (§3.4) | *(make one)* | In Excel 365, enter `=SEQUENCE(3)` in A2 and any value in A3 so it spills into a blocked cell, save as `.xlsx`, and attach the file to the report. The XML is inspected from it. |", + "| how newer Excel errors such as `#SPILL!` are stored (§3.4) | *(make one)* | In Excel 365, enter `=SEQUENCE(3)` in A2 and any value in A3 so it spills into a blocked cell, save as `.xlsx`, and attach the file to the report. The XML is inspected from it. | **Open**: no file was made |", "", "Not covered by a manual check: date detection for custom formats (§3.4.1) is checked automatically by the reader tests, and the maximum digit width for default fonts other than Calibri 11 stays open.", "", @@ -61,12 +67,22 @@ export function renderChecklist(): string { "- **LibreOffice** (headless) opens every corpus file except the large `18-limits.xlsx` and re-saves it as `.xlsx`; javascript-excel's reader then checks that every sheet and text cell survived. Files written by LibreOffice are reader fixtures too.", "- **Python's standard library** cross-checks the zip layer (`zipfile`, `packages/javascript-excel/test/interop/zip_interop.py`) and CSV (`csv`, `packages/javascript-excel/test/interop/csv_interop.py`) in both directions.", "", - "The original plan (JSE-9) also called for a cross-check against SheetJS as a devDependency. It was replaced by the openpyxl tests above. openpyxl is a separate implementation in another language and exposes the whole style model, so a test can compare fonts, fills, borders, alignment and number formats cell by cell; SheetJS's community edition reads little of the styling. The SheetJS package on the npm registry is also no longer its current release (newer versions are distributed from the SheetJS CDN), and javascript-excel replaces a SheetJS fork, so a SheetJS comparison would check against the predecessor's lineage rather than an independent reading of the format. Python and openpyxl are CI tools only: the package keeps zero dependencies and no new devDependency was added. Files from Excel, Numbers and Google Sheets come from the manual check above.", + "The original plan (JSE-9) also called for a cross-check against SheetJS as a devDependency. It was replaced by the openpyxl tests above. openpyxl is a separate implementation in another language and exposes the whole style model, so a test can compare fonts, fills, borders, alignment and number formats cell by cell; SheetJS's community edition reads little of the styling. The SheetJS package on the npm registry is also no longer its current release (newer versions are distributed from the SheetJS CDN), and javascript-excel replaces a SheetJS fork, so a SheetJS comparison would check against the predecessor's lineage rather than an independent reading of the format. Python and openpyxl are CI tools only: the package keeps zero dependencies and no new devDependency was added. Files saved by Excel, Numbers and Google Sheets are not part of the tests yet.", "", ); return out.join("\n"); } +function app(name: string, c: Check): string { + if (!(MANUAL_CHECK.checked as readonly string[]).includes(name)) return "not checked"; + if (c.result === undefined) return "pass"; + return isConfirmed(c) ? "see [Open items](#open-items-this-check-resolves)" : "opened; result not recorded"; +} + +function isConfirmed(c: Check): boolean { + return c.result !== undefined && c.result.startsWith("Confirmed"); +} + function esc(s: string): string { return s.replace(/\|/g, "\\|").replace(/\n/g, " "); } diff --git a/packages/javascript-excel/test/conformance/corpus.ts b/packages/javascript-excel/test/conformance/corpus.ts index a44d6a7..139b4b8 100644 --- a/packages/javascript-excel/test/conformance/corpus.ts +++ b/packages/javascript-excel/test/conformance/corpus.ts @@ -17,8 +17,17 @@ export interface Check { expect: string; /** The docs/api.md `[to verify]` item this check resolves, if any. */ verifies?: string; + /** For an open item: what the manual check found (see MANUAL_CHECK). */ + result?: string; } +/** The manual check that was done: who, where and when. */ +export const MANUAL_CHECK = { + date: "2026-11-17", + checked: ["Excel for Mac"], + notChecked: ["Excel for Windows", "Apple Numbers"], +} as const; + export interface CorpusEntry { /** File name without extension. */ id: string; @@ -328,7 +337,7 @@ export const CORPUS: CorpusEntry[] = [ }, checks: [ { where: "Alignment!B2:B26", look: "Compare with Format Cells > Alignment and Protection.", expect: "Everything matches column C." }, - { where: "Alignment!B20", look: "Open Format Cells > Alignment and try to set Indent to 251.", expect: "Excel shows 250 for this cell and refuses 251.", verifies: "indent maximum 250 (§3.5.4)" }, + { where: "Alignment!B20", look: "Open Format Cells > Alignment and try to set Indent to 251.", expect: "Excel shows 250 for this cell and refuses 251.", verifies: "indent maximum 250 (§3.5.4)", result: "Confirmed: the cell shows indent 250 and Excel refuses 251." }, ], }, { @@ -377,9 +386,9 @@ export const CORPUS: CorpusEntry[] = [ ], }), checks: [ - { where: "Built-in!C2:C29", look: "For each row, open Format Cells > Number > Custom and read the selected code.", expect: "The code matches column B (ids 14 and 22 may show your locale's date format). Write down the exact code Excel shows for ids 37, 38, 39, 40 and 47, including spaces.", verifies: "codes and spacing of built-in formats 37–40 and 47 (§11.2)" }, + { where: "Built-in!C2:C29", look: "For each row, open Format Cells > Number > Custom and read the selected code.", expect: "The code matches column B (ids 14 and 22 may show your locale's date format). Write down the exact code Excel shows for ids 37, 38, 39, 40 and 47, including spaces.", verifies: "codes and spacing of built-in formats 37–40 and 47 (§11.2)", result: "Confirmed, with Excel's own codes: 37 `#,##0_);(#,##0)`, 38 `#,##0_);[Red](#,##0)`, 39 `#,##0.00_);(#,##0.00)`, 40 `#,##0.00_);[Red](#,##0.00)`, 47 `mm:ss.0`. (37 was reported as `#,##0_);#,##0)`, read as a transcription slip for the opening parenthesis; to be confirmed.) Excel uses these codes; the ECMA-376 table in column B and docs/api.md §11.2 differs for all five; aligned in JSE-F4." }, { where: "Custom!B2:B7", look: "Compare column B with column C.", expect: "Everything matches." }, - { where: "Display!B2:B17", look: "Compare column B with column C. Widen column B if a value shows ####.", expect: "Everything matches. Write down every row that differs.", verifies: "how Excel displays day 0, rounded times, General, a dangling decimal point, am/pm case, conditional sections, built-in id 32 and bbbb (§5.7.4)" }, + { where: "Display!B2:B17", look: "Compare column B with column C. Widen column B if a value shows ####.", expect: "Everything matches. Write down every row that differs.", verifies: "how Excel displays day 0, rounded times, General, a dangling decimal point, am/pm case, conditional sections, built-in id 32 and bbbb (§5.7.4)", result: "Not verified: the rows that differ were not recorded." }, ], }, { @@ -409,6 +418,7 @@ export const CORPUS: CorpusEntry[] = [ look: "Note what each row shows, in your Excel locale. If you can, switch Excel or Windows to Japanese or Chinese and look again at ids 27–36 and 50–58.", expect: "No repair prompt. In an East Asian locale, ids 27–36 and 50–58 show dates; elsewhere they may show General. Record the result for each id.", verifies: "ids 27–36 and 50–58 are date formats (§3.4.1)", + result: "Not verified: what these ids show, and in which locale, was not recorded; no East Asian locale was tried.", }, ], }, @@ -453,8 +463,9 @@ export const CORPUS: CorpusEntry[] = [ look: "Select each fill and open Fill Color > Theme Colors; note which swatch is highlighted.", expect: "Row 0 is Background 1 (white), 1 is Text 1 (black), 2 is Background 2, 3 is Text 2, 4–9 are Accent 1–6, 10 Hyperlink, 11 Followed Hyperlink. Columns D and E are lighter and darker versions.", verifies: "theme index order: 0 = lt1, 1 = dk1, 2 = lt2, 3 = dk2 (§3.5.6)", + result: "Confirmed: 0 Background 1, 1 Text 1, 2 Background 2, 3 Text 2, 4–9 Accent 1–6, 10 Hyperlink, 11 Followed Hyperlink.", }, - { where: "Indexed!C66:C67", look: "Look at the text colour of 'Aa' for indexed 64 and 65.", expect: "64 is black (system foreground), 65 is white (system background).", verifies: "indexed 64 = system foreground, 65 = system background (§3.5.6)" }, + { where: "Indexed!C66:C67", look: "Look at the text colour of 'Aa' for indexed 64 and 65.", expect: "64 is black (system foreground), 65 is white (system background).", verifies: "indexed 64 = system foreground, 65 = system background (§3.5.6)", result: "Confirmed: 64 is black, 65 is white." }, ], }, { @@ -502,6 +513,7 @@ export const CORPUS: CorpusEntry[] = [ look: "Hover over the right edge of each column header (or Format > Column Width) and note the width Excel shows.", expect: "A 8.43 (64 px), B 10 (75 px), C 20 (145 px), D 12 (89 px), E 8.43 (64 px), F 13.57 (100 px). On a Mac the pixel values may differ; the character widths must match.", verifies: "maximum digit width 7 px for Calibri 11 (§3.3)", + result: "Confirmed in characters: A 8.43, B 10, C 20, D 12, E 8.43, F 13.57. Pixel widths are Windows values and were not checked.", }, { where: "Widths!G:J", look: "Look at columns G to J.", expect: "G is wide enough for its text; H and I are hidden (no header visible); J has the default width." }, { where: "Widths!rows 3–9, columns K:L", look: "Look at the rows and the outline buttons.", expect: "Row 3 is tall (30 pt), row 5 is hidden, rows 7–8 and columns K–L have outline (group) buttons, row 9 is green across the whole row, columns K–L are light orange." }, @@ -645,6 +657,7 @@ export const CORPUS: CorpusEntry[] = [ look: "Rename a sheet to History. Then rename one to 31 characters made of 30 x's and one emoji (😀).", expect: "Record whether Excel refuses 'History' and whether it accepts the 31-character emoji name (if it does, Excel counts characters, not UTF-16 code units).", verifies: "'History' is reserved; how the 31-character limit counts astral characters (§3.3)", + result: "Not verified: the renames were not recorded.", }, ], }, @@ -670,6 +683,7 @@ export const CORPUS: CorpusEntry[] = [ look: "Open it and wait (it is large).", expect: "No repair prompt. Ctrl/Cmd+End jumps to XFD1048576. The writer emits 64,000 cell formats (the default one plus 63,999), the most it allows; Excel's documented limit is 64,000.", verifies: "64,000 unique cell formats (§7.2, §11.1)", + result: "Confirmed: the file with 64,000 cell formats opens with no repair prompt, and Cmd+End goes to XFD1048576. A file over the limit was not tried.", }, ], },