reamkit 1.30.0 → 1.32.0

package/dist/esm/core/font/ttf-subset.d.ts

@@ -22,3 +22,22 @@ export declare function subsetTtf(parsed: ParsedTtf, usedGids: Iterable<number>)
  * @returns The closed set of glyph ids.
  */
 export declare function glyphClosure(parsed: ParsedTtf, usedGids: Iterable<number>): Set<number>;
+/**
+ * The sfnt table directory's binary-search fields for `numTables` tables.
+ *
+ * @param numTables How many tables the font holds.
+ * @returns `searchRange`, `entrySelector` and `rangeShift`, as the header states them.
+ */
+export declare function directoryGeometry(numTables: number): {
+    searchRange: number;
+    entrySelector: number;
+    rangeShift: number;
+};
+/**
+ * An sfnt table checksum: the sum of its big-endian 32-bit words, the last one
+ * padded with zeros.
+ *
+ * @param data The table's bytes (or the whole font's).
+ * @returns The checksum, as an unsigned 32-bit value.
+ */
+export declare function paddedChecksum(data: Uint8Array): number;

package/dist/esm/core/font/ttf-subset.js

@@ -193,6 +193,12 @@ function assembleSubsetTtf(parsed, newGlyf, newLoca) {
 	outView.setUint32(head.offset + HEAD_CHECKSUM_ADJUSTMENT_OFFSET, adjustment, false);
 	return out;
 }
+/**
+* The sfnt table directory's binary-search fields for `numTables` tables.
+*
+* @param numTables How many tables the font holds.
+* @returns `searchRange`, `entrySelector` and `rangeShift`, as the header states them.
+*/
 function directoryGeometry(numTables) {
 	let entrySelector = 0;
 	let pow2 = 1;
@@ -208,6 +214,13 @@ function directoryGeometry(numTables) {
 		rangeShift
 	};
 }
+/**
+* An sfnt table checksum: the sum of its big-endian 32-bit words, the last one
+* padded with zeros.
+*
+* @param data The table's bytes (or the whole font's).
+* @returns The checksum, as an unsigned 32-bit value.
+*/
 function paddedChecksum(data) {
 	let sum = 0;
 	const len = data.length;
@@ -244,4 +257,4 @@ function concatBytes(parts) {
 	return out;
 }
 //#endregion
-export { glyphClosure, subsetTtf };
+export { directoryGeometry, glyphClosure, paddedChecksum, subsetTtf };

package/dist/esm/core/fonts/families.js

@@ -28,8 +28,10 @@ function familiesInFlow(flow) {
 		for (const el of elements) if (el.kind === "paragraph") {
 			add(el.paragraph.properties.runProperties?.fontFamily?.ascii);
 			for (const run of el.paragraph.runs) add(run.properties.fontFamily?.ascii);
-		} else if (el.kind === "table") for (const row of el.table.rows) for (const cell of row.cells) visit(cell.content);
-		else if (el.kind === "shape") shapeText(el.shape);
+		} else if (el.kind === "table") {
+			for (const row of el.table.rows) for (const cell of row.cells) visit(cell.content);
+			visit(el.table.overlay?.drawings ?? []);
+		} else if (el.kind === "shape") shapeText(el.shape);
 	};
 	visit(flow.body);
 	for (const band of flow.headersFooters?.values() ?? []) visit(band);

package/dist/esm/core/fonts/provider.d.ts

@@ -45,6 +45,23 @@ export declare function embeddedDocFontProvider(embedded: ReadonlyMap<string, Fo
  * Open CDN substitutes (Arimo / Tinos / Cousine / Carlito / Caladea — the
  * LibreOffice metric-compatible mapping).
  * Always answers; the chain reports it as a substitution.
+ *
+ * A family's set is shared by every request for it, those made while the
+ * download is in flight included, and a whole set is downloaded once per
+ * provider. A set whose regular face cannot be downloaded rejects `resolve`
+ * with {@link fetchFontSet}'s error rather than answering {@link NO_FONT}: this
+ * is the chain's last resort, and a chain that answers none sends the
+ * conversion to the auto-download path, which records no substitution. The
+ * failed set is not kept, so the next request asks the network again.
+ *
+ * Nor is a set kept that came without a bold or italic face. The requests that
+ * waited on it fall back to the faces it has, and the next request assembles
+ * the set anew: a face the network lost is asked for again, and one the CDN
+ * answered with an HTTP error is not, since the download cache beneath
+ * {@link fetchFontSet} remembers it as missing.
+ *
+ * @param options An injectable `fetch` (defaults to the global one).
+ * @returns The `'remote'` provider.
  */
 export declare function remoteFontProvider(options?: {
     readonly fetch?: FetchLike;

package/dist/esm/core/fonts/provider.js

@@ -66,6 +66,23 @@ function embeddedDocFontProvider(embedded) {
 * Open CDN substitutes (Arimo / Tinos / Cousine / Carlito / Caladea — the
 * LibreOffice metric-compatible mapping).
 * Always answers; the chain reports it as a substitution.
+*
+* A family's set is shared by every request for it, those made while the
+* download is in flight included, and a whole set is downloaded once per
+* provider. A set whose regular face cannot be downloaded rejects `resolve`
+* with {@link fetchFontSet}'s error rather than answering {@link NO_FONT}: this
+* is the chain's last resort, and a chain that answers none sends the
+* conversion to the auto-download path, which records no substitution. The
+* failed set is not kept, so the next request asks the network again.
+*
+* Nor is a set kept that came without a bold or italic face. The requests that
+* waited on it fall back to the faces it has, and the next request assembles
+* the set anew: a face the network lost is asked for again, and one the CDN
+* answered with an HTTP error is not, since the download cache beneath
+* {@link fetchFontSet} remembers it as missing.
+*
+* @param options An injectable `fetch` (defaults to the global one).
+* @returns The `'remote'` provider.
 */
 function remoteFontProvider(options = {}) {
 	const cache = /* @__PURE__ */ new Map();
@@ -81,10 +98,18 @@ function remoteFontProvider(options = {}) {
 				});
 				cache.set(family, set);
 			}
-			const fonts = await set;
+			let fonts;
+			try {
+				fonts = await set;
+			} catch (error) {
+				if (cache.get(family) === set) cache.delete(family);
+				throw error;
+			}
+			if ((fonts.bold === void 0 || fonts.italic === void 0 || fonts.boldItalic === void 0) && cache.get(family) === set) cache.delete(family);
+			const picked = pickVariant((x) => fonts[x] !== void 0, req.bold, req.italic) ?? "regular";
 			return {
 				kind: "bytes",
-				bytes: fonts[pickVariant((x) => fonts[x] !== void 0, req.bold, req.italic) ?? "regular"] ?? fonts.regular,
+				bytes: fonts[picked] ?? fonts.regular,
 				faceName: family,
 				providerId: "remote"
 			};

package/dist/esm/core/fonts/remote-fonts.js

@@ -330,7 +330,14 @@ async function fetchTtf(url, fetchImpl, required) {
 		})();
 		cache.set(url, pending);
 	}
-	const result = await pending;
+	let result;
+	try {
+		result = await pending;
+	} catch (cause) {
+		if (cache.get(url) === pending) cache.delete(url);
+		if (!required) return void 0;
+		throw new Error(`Failed to download font from ${url}`, { cause });
+	}
 	if (!result && required) {
 		cache.delete(url);
 		throw new Error(`Failed to download font from ${url}`);

package/dist/esm/core/fonts/scripts.js

@@ -163,8 +163,10 @@ function scriptsInFlow(flow) {
 	};
 	const visit = (elements) => {
 		for (const el of elements) if (el.kind === "paragraph") for (const run of el.paragraph.runs) read(run.text);
-		else if (el.kind === "table") for (const row of el.table.rows) for (const cell of row.cells) visit(cell.content);
-		else if (el.kind === "shape") shapeText(el.shape);
+		else if (el.kind === "table") {
+			for (const row of el.table.rows) for (const cell of row.cells) visit(cell.content);
+			visit(el.table.overlay?.drawings ?? []);
+		} else if (el.kind === "shape") shapeText(el.shape);
 	};
 	visit(flow.body);
 	for (const band of flow.headersFooters?.values() ?? []) visit(band);

package/dist/esm/core/ir/flow.d.ts

@@ -1,5 +1,5 @@
 import { BodyElement, Chart, Comment, DocumentInfo, Numbering, Section, SectionProperties, ShapeFill, StyleSheet } from '../document-model/index.js';
-import { FontRegistry } from '../font/index.js';
+import { FontRegistry, GlyphSeg } from '../font/index.js';
 import { ResourceStore } from './resources.js';
 /**
  * A face's family as a word processor names it (ECMA-376 §17.8.3.9 `w:font`).
@@ -10,6 +10,55 @@ export interface FaceFamily {
     /** §17.8.3.10 `w:family` — the kind of face, for a reader that has to substitute. */
     readonly generic: 'roman' | 'swiss' | 'modern';
 }
+/**
+ * The outlines a face drew a document's characters with — what a writer needs
+ * to EMBED the face, so a reader that lacks it sets the text in the face the
+ * source was set in instead of a substitute (ECMA-376 §17.8.1).
+ */
+export interface FaceOutlines {
+    /** Each character (one code point) the document shows in the face → its glyph. */
+    readonly glyphs: ReadonlyMap<string, FaceGlyph>;
+    /**
+     * The pairs the source KERNED the face by: two characters → the adjustment
+     * to the first one's advance, in thousandths of an em (negative tightens).
+     */
+    readonly kerning?: ReadonlyMap<string, number>;
+    /**
+     * The ligatures the source drew in the face: the letters one glyph stands
+     * for ("fi", "ffl") → that glyph.
+     */
+    readonly ligatures?: ReadonlyMap<string, FaceGlyph>;
+    /**
+     * OS/2 `fsType` — the embedding the face's licence allows, as its program
+     * states it; absent where the program states nothing.
+     */
+    readonly fsType?: number;
+    /** The style the face IS, which is the slot a family embeds it in. */
+    readonly bold: boolean;
+    readonly italic: boolean;
+    /** The program's own name for the face, without a subset tag. */
+    readonly postScriptName: string;
+    /**
+     * The line to set the face in, above and below the baseline, in thousandths
+     * of an em — `descent` negative. A reader that reconstructs a page gives the
+     * line it measured the page against, so a paragraph set in the face's single
+     * spacing lands where the page put it.
+     */
+    readonly ascent: number;
+    readonly descent: number;
+    readonly capHeight?: number;
+    readonly xHeight?: number;
+    /** Degrees counterclockwise from the vertical; a face slanted right is negative. */
+    readonly italicAngle: number;
+    readonly fixedPitch: boolean;
+}
+/** One glyph of a {@link FaceOutlines}: what it draws and how far it advances. */
+export interface FaceGlyph {
+    /** Its contours in a one-unit em, y up, filled by the nonzero rule; empty when blank. */
+    readonly outline: ReadonlyArray<GlyphSeg>;
+    /** How far the pen moves after it, in thousandths of an em. */
+    readonly advance: number;
+}
 /**
  * The semantic IR tree (ir-design §5): everything a reader extracts from the
  * document bytes, format-neutrally — the flow `body` plus its document-scoped
@@ -59,6 +108,11 @@ export interface FlowDoc {
      * to another program names the family, which is the name that program knows.
      */
     readonly faceFamilies?: ReadonlyMap<string, FaceFamily>;
+    /**
+     * The outlines of the faces a run names, keyed as {@link faceFamilies} is —
+     * for a writer that embeds them (see {@link FaceOutlines}).
+     */
+    readonly faceOutlines?: ReadonlyMap<string, FaceOutlines>;
     /** Document metadata from docProps/core.xml. */
     readonly info?: DocumentInfo;
     /** Document natural language hint (BCP-47), e.g. for tagged-PDF /Lang. */
@@ -85,4 +139,26 @@ export interface FlowDoc {
      * @w:gutter` reserves belongs to the TOP margin rather than the left.
      */
     readonly gutterAtTop?: boolean;
+    /**
+     * [MS-DOCX] `w:compatSetting` `compatibilityMode` — the version of Word
+     * whose layout the document asks for: 15 is Word 2013's, which every Word
+     * since sets a new document by. Word opens a document that states none in
+     * Compatibility Mode, and forms there none of the OpenType ligatures its
+     * faces carry.
+     */
+    readonly compatibilityMode?: number;
+    /**
+     * The application whose rules the document is set by: `'word'` for one Word
+     * sets — lines as tall as the faces on them make them (§17.3.1.33), table
+     * rows as tall as their borders make them (§17.4.38); see the layout's
+     * `TypesetBy`. Absent, the layout's flat 1.2× lines and borders that take no
+     * room.
+     */
+    readonly typesetBy?: 'word';
+    /**
+     * The document's front floats cover the text under them, as a spreadsheet's
+     * drawings cover its cells: a note's box hides the value beside its cell,
+     * and a chart the figures it sits on. Absent, the text is painted over them.
+     */
+    readonly floatsOverText?: true;
 }

package/dist/esm/core/ir/sheet.d.ts

@@ -13,6 +13,11 @@ export interface SheetChartRef {
     /** Where the anchor puts it, in points from the grid's top-left. */
     readonly xPt?: number;
     readonly yPt?: number;
+    /**
+     * §20.5.2.3 `fPrintsWithSheet="0"` — on the sheet, not on its paper: a
+     * window shows it, a print leaves it out.
+     */
+    readonly screenOnly?: true;
 }
 /**
  * §20.5.2.1 xdr:pic — a picture anchored over a sheet's grid, sized from its
@@ -26,6 +31,11 @@ export interface SheetImageRef {
     /** Where the anchor puts it, in points from the grid's top-left. */
     readonly xPt?: number;
     readonly yPt?: number;
+    /**
+     * §20.5.2.3 `fPrintsWithSheet="0"` — on the sheet, not on its paper: a
+     * window shows it, a print leaves it out.
+     */
+    readonly screenOnly?: true;
 }
 /** One item (label + selection state) in a {@link SheetSlicer}. */
 export interface SheetSlicerItem {
@@ -70,7 +80,35 @@ export interface SheetComment {
     readonly ref: string;
     readonly author?: string;
     readonly text: string;
+    /** The note as written, run by run with each run's own font — the bold "Author:" line included. */
+    readonly runs?: ReadonlyArray<SheetRichRun>;
     readonly threaded: boolean;
+    /**
+     * The note's box, when its legacy VML shape SHOWS it (`<x:Visible/>`):
+     * Excel draws a shown note on the sheet beside its cell, with a line to the
+     * cell's corner, and prints it there when `<pageSetup cellComments>` is
+     * `asDisplayed`. Absent ⇒ the note is only flagged in its cell.
+     */
+    readonly shown?: SheetNoteBox;
+}
+/**
+ * Where a shown note stands and how it is painted. Distances are in points
+ * from the sheet's top-left corner, measured in the file's own column order —
+ * a sheet that reads from the right mirrors them with everything else.
+ */
+export interface SheetNoteBox {
+    readonly xPt: number;
+    readonly yPt: number;
+    readonly widthPt: number;
+    readonly heightPt: number;
+    /** The top-right corner of the cell (or merge) the note belongs to — its line ends there. */
+    readonly cornerXPt: number;
+    readonly cornerYPt: number;
+    readonly fillHex: string;
+    readonly lineHex: string;
+    readonly shadow: boolean;
+    /** The side the note's text is set to; absent ⇒ its start. */
+    readonly textAlign?: 'left' | 'center' | 'right';
 }
 /**
  * A form control resolved against its ctrlProp part (E-SHEET W8): the display
@@ -150,6 +188,11 @@ export interface Sheet {
     readonly images?: ReadonlyArray<SheetImageRef>;
     /** Drawing shapes on this sheet (E-SHEET W2), fully resolved + anchor-ordered. */
     readonly shapes?: ReadonlyArray<ShapeBlock>;
+    /**
+     * The indexes into {@link shapes} of those that do not print with the sheet
+     * (§20.5.2.3 `fPrintsWithSheet="0"`): a window shows them, paper does not.
+     */
+    readonly screenOnlyShapes?: ReadonlySet<number>;
     /**
      * Cell hyperlinks resolved to external URLs (E-SHEET W3); the projection sets
      * `run.href` on covered cells. In-workbook (location-only) links are not carried.

package/dist/esm/core/number-format.js

@@ -713,20 +713,25 @@ function applyNumericSection(value, format, negativeSection) {
 	if (isPercent) magnitude *= 100;
 	const { intFormat, decFormat, literalPrefix, literalSuffix, scaleCommas } = splitNumberFormat(cleaned);
 	if (scaleCommas > 0) magnitude /= 1e3 ** scaleCommas;
-	let decimals = 0;
-	for (const c of decFormat) if (c === "0" || c === "#") decimals++;
+	const decPlaceholders = [...decFormat].filter((c) => c === "0" || c === "#" || c === "?");
+	const decimals = decPlaceholders.length;
 	const [intRaw, decRaw] = toFixedDecimal(magnitude, decimals).split(".");
-	const intStr = /,(?=\d)/.test(intFormat) || /[0#],[0#]/.test(intFormat) ? intRaw.replace(/\B(?=(\d{3})+(?!\d))/g, ",") : intRaw;
-	let numberPart = intRaw === "0" && !/[0?]/.test(intFormat) ? "" : intStr;
+	const useThousands = /,(?=\d)/.test(intFormat) || /[0#?],[0#?]/.test(intFormat);
+	const intPlaceholders = [...intFormat].filter((c) => c === "0" || c === "#" || c === "?");
+	const significant = intRaw === "0" && !intFormat.includes("0") ? "" : intRaw;
+	let zeros = "";
+	let spaces = "";
+	for (let i = 0; i < intPlaceholders.length - significant.length; i++) if (intPlaceholders[i] === "0") zeros += "0";
+	else if (intPlaceholders[i] === "?") spaces += " ";
+	const intDigits = zeros + significant;
+	let numberPart = spaces + (useThousands ? intDigits.replace(/\B(?=(\d{3})+(?!\d))/g, ",") : intDigits);
 	if (decimals > 0) {
 		let dec = decRaw ?? "".padEnd(decimals, "0");
 		if (dec.length < decimals) dec = dec.padEnd(decimals, "0");
-		let kept = "";
-		for (let i = 0; i < decFormat.length; i++) {
-			const placeholder = decFormat[i];
-			if (placeholder === "0" || placeholder === "#") kept += dec[i] ?? "0";
-		}
-		for (let i = kept.length - 1; i >= 0 && kept[i] === "0" && decFormat[i] === "#"; i--) kept = kept.substring(0, i);
+		let kept = dec.substring(0, decimals);
+		for (let i = kept.length - 1; i >= 0 && kept[i] === "0"; i--) if (decPlaceholders[i] === "#") kept = kept.substring(0, i);
+		else if (decPlaceholders[i] === "?") kept = `${kept.substring(0, i)} ${kept.substring(i + 1)}`;
+		else break;
 		if (kept.length > 0) numberPart += "." + kept;
 		else if (decFormat.includes("0")) numberPart += "." + dec;
 	}
@@ -739,7 +744,7 @@ function splitNumberFormat(cleaned) {
 	let lastDigit = -1;
 	for (let i = 0; i < cleaned.length; i++) {
 		const ch = cleaned[i];
-		if (ch === "0" || ch === "#") {
+		if (ch === "0" || ch === "#" || ch === "?") {
 			if (firstDigit < 0) firstDigit = i;
 			lastDigit = i;
 		}

package/dist/esm/core/numbering/index.d.ts

@@ -1,2 +1,2 @@
-export { NumberingState, formatLevelMarker } from './state.js';
+export { NumberingState, formatCounter, formatLevelMarker } from './state.js';
 export { applyNumbering, applyNumberingToHeadersFooters } from './apply.js';

package/dist/esm/core/numbering/state.d.ts

@@ -1,4 +1,4 @@
-import { AbstractNumbering, Numbering, NumberingInstance, NumberingLevel, NumberingReference } from '../document-model/index.js';
+import { AbstractNumbering, Numbering, NumberingFormat, NumberingInstance, NumberingLevel, NumberingReference } from '../document-model/index.js';
 /**
  * §17.9.27 — the levels an INSTANCE actually numbers by: its abstract
  * definition's, with any `w:lvlOverride/w:lvl` shadowing them. Cached per
@@ -31,3 +31,13 @@ export declare class NumberingState {
     resolveMarker(numbering: Numbering, ref: NumberingReference): string | null;
 }
 export declare function formatLevelMarker(abstractNum: AbstractNumbering, currentLevel: NumberingLevel, counters: ReadonlyArray<number>): string;
+/**
+ * A counter in the numerals a §17.18.59 format names: `lowerRoman` 4 is "iv".
+ * A format with no numeral for the number — a letter or a roman zero — gives
+ * the empty string.
+ *
+ * @param format The number format.
+ * @param n      The counter's value.
+ * @returns The counter as that format writes it.
+ */
+export declare function formatCounter(format: NumberingFormat, n: number): string;

package/dist/esm/core/numbering/state.js

@@ -77,6 +77,15 @@ function formatLevelMarker(abstractNum, currentLevel, counters) {
 		return formatCounter(currentLevel.isLegal === true && lvlIdx !== currentLevel.ilvl ? "decimal" : level?.format ?? "decimal", counter);
 	});
 }
+/**
+* A counter in the numerals a §17.18.59 format names: `lowerRoman` 4 is "iv".
+* A format with no numeral for the number — a letter or a roman zero — gives
+* the empty string.
+*
+* @param format The number format.
+* @param n      The counter's value.
+* @returns The counter as that format writes it.
+*/
 function formatCounter(format, n) {
 	if (n < 0) return "";
 	switch (format) {
@@ -336,4 +345,4 @@ function normalizeBullet(lvlText) {
 	return lvlText;
 }
 //#endregion
-export { NumberingState, effectiveAbstract, formatLevelMarker };
+export { NumberingState, effectiveAbstract, formatCounter, formatLevelMarker };

package/dist/esm/core/spreadsheet-model/index.d.ts

@@ -1 +1 @@
-export type { CellType, WorksheetCell, ColumnStyle, ColumnWidth, MergedRange, RowHeight, RowStyle, XlsxPageMargins, XlsxPageSetup, XlsxPrintOptions, ParsedWorksheet, XlsxFont, XlsxFill, XlsxBorderStyleName, XlsxBorderEdge, XlsxBorder, XlsxHorizontalAlign, XlsxVerticalAlign, XlsxCellAlignment, XlsxCellXf, XlsxStyles, DefinedName, Dxf, CfOperator, CfRuleCellIs, CfvoType, Cfvo, CfRuleColorScale, CfRuleDataBar, CfRuleIconSet, CfRuleTop10, CfRuleAboveAverage, CfRuleDupUnique, CfRuleText, CfRuleExpression, CfRuleTimePeriod, TimePeriodKind, CfRule, ConditionalFormat, DataValidationType, DataValidation, HyperlinkRef, HeaderFooter, FormControlRef, OleObjectRef, SheetRichRun, SparklineKind, ParsedSparkline, ExcelTable, PivotTable, SheetPane, } from './types.js';
+export type { CellType, WorksheetCell, ColumnStyle, ColumnWidth, MergedRange, RowHeight, RowStyle, XlsxPageMargins, XlsxPageSetup, XlsxPrintOptions, ParsedWorksheet, XlsxFont, XlsxFill, XlsxBorderStyleName, XlsxBorderEdge, XlsxBorder, XlsxHorizontalAlign, XlsxVerticalAlign, XlsxCellAlignment, XlsxCellXf, XlsxStyles, DefinedName, Dxf, CfOperator, CfRuleCellIs, CfvoType, Cfvo, CfRuleColorScale, CfRuleDataBar, CfRuleIconSet, CfRuleTop10, CfRuleAboveAverage, CfRuleDupUnique, CfRuleText, CfRuleExpression, CfRuleTimePeriod, TimePeriodKind, CfRule, ConditionalFormat, DataValidationType, DataValidation, HyperlinkRef, HeaderFooter, FormControlRef, OleObjectRef, SheetRichRun, SparklineKind, ParsedSparkline, ExcelTable, TableStyleElementType, TableStyleRegion, TableStyleFormat, XlsxTableStyle, PivotTable, SheetPane, } from './types.js';

package/dist/esm/core/spreadsheet-model/types.d.ts

@@ -171,6 +171,12 @@ export interface ParsedWorksheet {
     readonly colBreaks?: ReadonlyArray<number>;
     /** §18.3.1.36 `<drawing r:id>` — the sheet's drawing part (charts/shapes). */
     readonly drawingRelId?: string;
+    /**
+     * §18.3.1.99 — the sheet is a `<chartsheet>`: nothing but a chart, which
+     * prints filling the page, and on a landscape one unless the sheet says
+     * otherwise.
+     */
+    readonly chartSheet?: boolean;
     /**
      * §18.3.1.36 `<legacyDrawing r:id>` — the relationship to the sheet's VML
      * drawing part. A form control put on the sheet by Excel's Forms toolbar is
@@ -226,6 +232,22 @@ export interface ParsedWorksheet {
      * (E-SHEET SE2/SE3).
      */
     readonly pane?: SheetPane;
+    /**
+     * ECMA-376 §18.3.1.87 `<sheetView showGridLines>` — whether the sheet's
+     * window draws the cell gridlines. A VIEW setting, like the pane: what
+     * prints is `<printOptions gridLines>`. Carried for a screen projection and
+     * the round trip; absent ⇒ shown, the default.
+     */
+    readonly showGridLines?: boolean;
+    /**
+     * ECMA-376 §18.3.1.87 `<sheetView rightToLeft>` — the sheet reads from the
+     * right: column A stands at the right edge and the columns run leftward,
+     * and each cell's left and right borders cross over with it. What a cell's
+     * text does is unchanged — it keeps the side its alignment names. Unlike
+     * the pane and the gridlines this one prints: Excel puts the sheet on the
+     * paper the way the window shows it. Absent ⇒ left to right.
+     */
+    readonly rightToLeft?: boolean;
 }
 /**
  * A frozen pane: the count of leading rows / columns frozen in the worksheet
@@ -236,6 +258,28 @@ export interface SheetPane {
     readonly frozenRows: number;
     readonly frozenCols: number;
 }
+/**
+ * §18.18.77 ST_TableStyleType — the regions of a table a table style formats,
+ * in the order they apply (§18.8.41): a later region's format wins where both
+ * say something.
+ */
+export type TableStyleElementType = 'wholeTable' | 'firstColumnStripe' | 'secondColumnStripe' | 'firstRowStripe' | 'secondRowStripe' | 'lastColumn' | 'firstColumn' | 'headerRow' | 'totalRow' | 'firstHeaderCell' | 'lastHeaderCell' | 'firstTotalCell' | 'lastTotalCell';
+/** §18.8.40 — one region's format in a table style: its dxf, and a stripe's band size. */
+export interface TableStyleRegion {
+    readonly dxf: Dxf;
+    /** §18.8.41 `size` — rows (or columns) in one band of a stripe; default 1. */
+    readonly size?: number;
+}
+/** §18.8.40 — a table style, region by region, its colours resolved. */
+export type TableStyleFormat = Partial<Record<TableStyleElementType, TableStyleRegion>>;
+/** §18.8.40 `<tableStyle>` — a style a workbook defines itself: each region's dxf. */
+export interface XlsxTableStyle {
+    readonly elements: ReadonlyArray<{
+        readonly type: TableStyleElementType;
+        readonly dxfId: number;
+        readonly size?: number;
+    }>;
+}
 /**
  * ECMA-376 §18.5.1.2 `<table>` — a structured table over a cell range with a
  * banded style. The raw parse carries the range, header rows and style flags;
@@ -247,6 +291,13 @@ export interface ExcelTable {
     readonly name?: string;
     readonly styleName?: string;
     readonly headerRowCount: number;
+    /** §18.5.1.2 `totalsRowCount` — the totals rows at the foot of the table (default 0). */
+    readonly totalsRowCount?: number;
+    /**
+     * §18.5.1.3 `<tableColumn name>` — the columns' names, left to right: what a
+     * structured reference (`tblIncome[Amount]`) names a column by.
+     */
+    readonly columns?: ReadonlyArray<string>;
     readonly showRowStripes: boolean;
     readonly showColumnStripes: boolean;
     readonly showFirstColumn: boolean;
@@ -259,6 +310,12 @@ export interface ExcelTable {
     readonly headerHex?: string;
     readonly bandHex?: string;
     readonly headerTextHex?: string;
+    /**
+     * §18.8.40 — the style the table names, region by region: one Excel builds
+     * in (TableStyleMedium2) or one the workbook defines, its colours resolved
+     * against the workbook's theme.
+     */
+    readonly style?: TableStyleFormat;
 }
 /**
  * ECMA-376 §18.10.1.73 `<pivotTableDefinition>` — a pivot table. Its OUTPUT
@@ -314,6 +371,14 @@ export interface XlsxFont {
     /** §18.8.37 `<strike/>` — the font is struck through. */
     readonly strike?: boolean;
     readonly colorHex?: string;
+    /**
+     * §18.8.3 — how the `<color>` names the colour, not what it comes to:
+     * `theme:1:0`, `rgb:FF000000`, `indexed:8`, `auto`; undefined for a font with
+     * no `<color>`. Excel lets a table style colour a cell's text only where the
+     * cell names its colour as the Normal style does — `theme="1"` black takes
+     * the style's white, `rgb="FF000000"` black keeps its own.
+     */
+    readonly colorRef?: string;
     readonly name?: string;
 }
 /** §18.8.20 `<fill>` — one fill record: pattern type plus foreground/background colours. */
@@ -343,6 +408,13 @@ export interface XlsxBorder {
     readonly diagonal?: XlsxBorderEdge;
     readonly diagonalUp?: boolean;
     readonly diagonalDown?: boolean;
+    /**
+     * §18.8.4 `<vertical>`/`<horizontal>` — the lines BETWEEN the cells of a range
+     * a differential format covers: a table style's rules between its columns
+     * and between its rows. A cell's own border has no use for them.
+     */
+    readonly vertical?: XlsxBorderEdge;
+    readonly horizontal?: XlsxBorderEdge;
 }
 /** §18.18.40 ST_HorizontalAlignment — `<alignment horizontal>`. */
 export type XlsxHorizontalAlign = 'left' | 'center' | 'right' | 'fill' | 'justify' | 'centerContinuous' | 'distributed';
@@ -362,6 +434,12 @@ export interface XlsxCellAlignment {
     readonly textRotation?: number;
     /** §18.8.1 `shrinkToFit` — scale the text down so it fits the cell on one line (W6). */
     readonly shrinkToFit?: boolean;
+    /**
+     * §18.8.1 `readingOrder` — `1` left to right, `2` right to left. Absent (or
+     * `0`) is "context": the direction of the text's first strong character,
+     * which is also what a General cell aligns its text by.
+     */
+    readonly readingOrder?: 'ltr' | 'rtl';
 }
 /**
  * §18.8.45 `<xf>` — one cell format record: indices into the font/fill/border/
@@ -395,6 +473,11 @@ export interface XlsxStyles {
      * rules (E-SHEET SC1); only the properties a dxf sets override the base.
      */
     readonly dxfs?: ReadonlyArray<Dxf>;
+    /**
+     * §18.8.42 `<tableStyles>` — the table styles the workbook defines itself,
+     * by name; their regions point into {@link XlsxStyles.dxfs}.
+     */
+    readonly tableStyles?: ReadonlyMap<string, XlsxTableStyle>;
 }
 /** §18.8.14 `<dxf>` — a differential (override) format a `cfRule` applies on match. */
 export interface Dxf {
@@ -489,6 +572,11 @@ export interface CfRuleDataBar {
      * figure does not sit on top of its own gauge.
      */
     readonly showValue?: boolean;
+    /**
+     * The 2009 extension's `<x14:dataBar gradient>` — false paints the bar in
+     * one solid colour, where Excel's default fades it from the axis.
+     */
+    readonly gradient?: boolean;
 }
 /**
  * §18.3.1.49 `<cfRule type="iconSet">` — picks one glyph per cell from a named
@@ -501,6 +589,12 @@ export interface CfRuleIconSet {
     readonly iconSet: string;
     readonly cfvos: ReadonlyArray<Cfvo>;
     readonly reverse?: boolean;
+    /**
+     * §18.3.1.49 `showValue` — false means the cell shows its ICON ONLY, as a
+     * status column of ticks and crosses does: the figure is what the icon
+     * already says.
+     */
+    readonly showValue?: boolean;
 }
 /**
  * §18.3.1.10 `<cfRule type="top10">` — the top (or `bottom`) N values of the
@@ -708,6 +802,8 @@ export interface SheetRichRun {
     readonly sizePt?: number;
     /** §18.4.2 `<vertAlign>` — superscript / subscript within the cell text. */
     readonly vertAlign?: 'superscript' | 'subscript';
+    /** §18.4.5 `<rFont>` — the run's typeface, where the producer names one. */
+    readonly fontName?: string;
 }
 /**
  * §18.18.18 ST_DataValidationType — the constraint a `<dataValidation>`