reamkit 1.31.0 → 1.32.0

package/dist/esm/core/drawingml/colors.js

@@ -148,6 +148,25 @@ var DEFAULT_THEME_PALETTE = new Map([
 	["hlink", "0563C1"],
 	["folHlink", "954F72"]
 ]);
+/**
+* The Office 2023 theme's palette — what Excel colours a workbook that carries
+* no theme part with. Its own PDF of theme slots 0…9 in such a workbook
+* (2026-10-01) paints exactly these: accent1 is 156082, not 2013's 4472C4.
+*/
+var OFFICE_2023_THEME_PALETTE = new Map([
+	["dk1", "000000"],
+	["lt1", "FFFFFF"],
+	["dk2", "0E2841"],
+	["lt2", "E8E8E8"],
+	["accent1", "156082"],
+	["accent2", "E97132"],
+	["accent3", "196B24"],
+	["accent4", "0F9ED5"],
+	["accent5", "A02B93"],
+	["accent6", "4EA72E"],
+	["hlink", "467886"],
+	["folHlink", "96607D"]
+]);
 var DEFAULT_SCHEME_ALIAS = {
 	tx1: "dk1",
 	bg1: "lt1",
@@ -284,8 +303,9 @@ var SYSTEM_COLORS = new Map([
 function resolveColorNode(c, resolveColor) {
 	if (poIs(c, "a:sysClr")) {
 		const last = poAttr(c, "lastClr");
-		if (last && /^[0-9A-Fa-f]{6}$/.test(last)) return last.toUpperCase();
-		return SYSTEM_COLORS.get(poAttr(c, "val") ?? "");
+		const hex = last && /^[0-9A-Fa-f]{6}$/.test(last) ? last.toUpperCase() : SYSTEM_COLORS.get(poAttr(c, "val") ?? "");
+		const sysMods = readColorMods(c);
+		return hex !== void 0 && sysMods.length > 0 ? applyColorMods(hex, sysMods) : hex;
 	}
 	if (poIs(c, "a:prstClr")) {
 		const hex = PRESET_COLORS.get((poAttr(c, "val") ?? "").toLowerCase());
@@ -305,4 +325,4 @@ function resolveColorNode(c, resolveColor) {
 	} : raw);
 }
 //#endregion
-export { DEFAULT_SCHEME_ALIAS, DEFAULT_THEME_PALETTE, applyColorMods, defaultColorResolver, makeColorResolver, placeholderColors, readColorMods, resolveColorNode };
+export { DEFAULT_SCHEME_ALIAS, DEFAULT_THEME_PALETTE, OFFICE_2023_THEME_PALETTE, defaultColorResolver, makeColorResolver, placeholderColors, readColorMods, resolveColorNode };

package/dist/esm/core/drawingml/shape-render.d.ts

@@ -30,7 +30,9 @@ export declare function gradientToSolid(gradient: ShapeGradient): string;
  * An SVG `<linearGradient>` / `<radialGradient>` definition for a gradient fill
  * (EP16), shared by the SVG and HTML writers. The linear vector is expressed in
  * `objectBoundingBox` space; the angle is negated because the shape's own path
- * transform flips y (local y-up → page y-down).
+ * transform flips y (local y-up → page y-down) — and a radial centre, given in
+ * fractions down from the box's top, is measured up from its bottom for the
+ * same reason.
  *
  * @param id The gradient element id (referenced by `fill="url(#id)"`).
  * @param g  The gradient fill.

package/dist/esm/core/drawingml/shape-render.js

@@ -51,7 +51,9 @@ function gradientToSolid(gradient) {
 * An SVG `<linearGradient>` / `<radialGradient>` definition for a gradient fill
 * (EP16), shared by the SVG and HTML writers. The linear vector is expressed in
 * `objectBoundingBox` space; the angle is negated because the shape's own path
-* transform flips y (local y-up → page y-down).
+* transform flips y (local y-up → page y-down) — and a radial centre, given in
+* fractions down from the box's top, is measured up from its bottom for the
+* same reason.
 *
 * @param id The gradient element id (referenced by `fill="url(#id)"`).
 * @param g  The gradient fill.
@@ -64,7 +66,7 @@ function gradientSvgDef(id, g) {
 		const c = g.center;
 		if (!c) return `<radialGradient id="${id}">${stops}</radialGradient>`;
 		const r = Math.SQRT2 / 2;
-		return `<radialGradient id="${id}" cx="${n(c.x)}" cy="${n(c.y)}" r="${n(r)}">${stops}</radialGradient>`;
+		return `<radialGradient id="${id}" cx="${n(c.x)}" cy="${n(1 - c.y)}" r="${n(r)}">${stops}</radialGradient>`;
 	}
 	const rad = -(g.angle ?? 0) * Math.PI / 180;
 	const dx = Math.cos(rad) / 2;

package/dist/esm/core/font/measure.d.ts

@@ -29,6 +29,15 @@ export interface FontMeasure {
      * `[…] TJ` array when shaping moved a glyph off its own advance.
      */
     readonly showText: (text: string) => string;
+    /**
+     * The glyphs `text` is drawn with and the advance each one takes, in font
+     * units — exactly what {@link showText} shows, kerning and ligatures
+     * included — for a writer that places each glyph itself.
+     */
+    readonly glyphRun: (text: string) => {
+        readonly gids: ReadonlyArray<number>;
+        readonly advances: ReadonlyArray<number>;
+    };
 }
 /**
  * Build a {@link FontMeasure} over a parsed font.

package/dist/esm/core/font/measure.js

@@ -52,6 +52,13 @@ function createFontMeasure(parsed, kern = true) {
 		if (hex !== "") parts.push(`<${hex}>`);
 		return `[${parts.join(" ")}] TJ`;
 	};
+	const glyphRun = (text) => {
+		const shaped = shapeText(text, parsed.glyphForCodepoint, parsed.advanceWidths, parsed.ligatures, kerning, parsed.joiningForms);
+		return {
+			gids: shaped.gids,
+			advances: shaped.advances
+		};
+	};
 	const glyf = parsed.tables.get("glyf");
 	const glyphInk = (gid) => {
 		if (!glyf || gid < 0 || gid >= parsed.numGlyphs) return void 0;
@@ -92,7 +99,8 @@ function createFontMeasure(parsed, kern = true) {
 		textWidthPt,
 		textInkPt,
 		encodeTextAsCidHex,
-		showText
+		showText,
+		glyphRun
 	};
 }
 //#endregion

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/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

@@ -155,4 +155,10 @@ export interface FlowDoc {
      * 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/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>`

package/dist/esm/core/style-cascade/resolver.js

@@ -262,8 +262,10 @@ function resolveBodyStyles(body, sheet) {
 	};
 	const visit = (el) => {
 		if (el.kind === "paragraph") visitParagraph(el.paragraph);
-		else if (el.kind === "table") for (const row of el.table.rows) for (const cell of row.cells) for (const child of cell.content) visit(child);
-		else if (el.kind === "shape") {
+		else if (el.kind === "table") {
+			for (const row of el.table.rows) for (const cell of row.cells) for (const child of cell.content) visit(child);
+			for (const drawing of el.table.overlay?.drawings ?? []) visit(drawing);
+		} else if (el.kind === "shape") {
 			const shapeText = (sh) => {
 				for (const child of sh.text?.content ?? []) visit(child);
 				for (const member of sh.children ?? []) shapeText(member.shape);

package/dist/esm/excel/column-bands.d.ts

@@ -1,4 +1,21 @@
 import { BodyElement, TableProperties, TableRow } from '../core/document-model/index.js';
+/** §18.3.1.70 — the width of the row-number column, in twips. */
+export declare const HEADING_COL_TWIPS = 460;
+/**
+ * §18.3.1.70 — how the printed headings stand: the sheet's print scale shrinks
+ * them with it, as it shrinks everything else on the page.
+ */
+export interface HeadingBand {
+    /** How tall the letters row stands — exactly, so a drawing anchored to the
+     *  grid can be moved down by just as much. */
+    readonly lettersPt?: number;
+    /** The row-number column's width, in twips; {@link HEADING_COL_TWIPS} unscaled. */
+    readonly colTwips?: number;
+    /** The size the letters and numbers are set in; the sheet's default unscaled. */
+    readonly fontPt?: number;
+    /** The width of the boxes' lines; 0.5pt unscaled. */
+    readonly lineWidthPt?: number;
+}
 /**
  * Wrap a grid in its printed row and column headings (§18.3.1.70 `headings`):
  * the column letters across the top, the row numbers down the left, each in a
@@ -7,14 +24,23 @@ import { BodyElement, TableProperties, TableRow } from '../core/document-model/i
  *
  * @param rows       The band's rows.
  * @param widths     The band's column widths in twips.
- * @param colStart   The absolute index of the band's first column.
+ * @param columns    The absolute index of each of those columns — a hidden
+ *   one between them is skipped, and so is its letter.
  * @param rowNumbers The absolute 1-based row number of each row.
+ * @param band       How the headings stand, at the print scale.
  * @returns The rows and widths with the heading band added.
  */
-export declare function withHeadingBand(rows: ReadonlyArray<TableRow>, widths: ReadonlyArray<number>, colStart: number, rowNumbers: ReadonlyArray<number>): {
+export declare function withHeadingBand(rows: ReadonlyArray<TableRow>, widths: ReadonlyArray<number>, columns: ReadonlyArray<number>, rowNumbers: ReadonlyArray<number>, band?: HeadingBand): {
     rows: Array<TableRow>;
     widths: Array<number>;
 };
+/** Where a drawing lies on its sheet, in points from the sheet's top-left corner. */
+export interface DrawingBox {
+    readonly xPt: number;
+    readonly yPt: number;
+    readonly widthPt: number;
+    readonly heightPt: number;
+}
 /** A contiguous run of columns that prints together as one band (E-SHEET SE1). */
 export interface ColumnBand {
     /** First local column index (inclusive). */
@@ -50,12 +76,19 @@ export declare function computeColumnBands(columnWidths: ReadonlyArray<number>,
  * @param titleRowIndex The print-title row, or -1.
  * @param drawingReachTwips How far right the sheet's drawings reach (0 if none).
  * @param headings §18.3.1.70 — the printed row/column headings, when the sheet
- *   asks for them: the absolute index of the grid's first column and the sheet
- *   row number of each emitted row. Each band gets ITS OWN letters, which is
- *   what both references print across the top of a continuation page.
+ *   asks for them: the absolute index of each column and the sheet row number
+ *   of each emitted row. Each band gets ITS OWN letters, which is what both
+ *   references print across the top of a continuation page.
+ * @param sheet    §20.5 — where the grid's first column stands on the sheet and
+ *   where its printed drawings lie, at the print scale: each band is framed
+ *   for the drawings over it (TableOverlay) and keeps the rows they cover.
  * @returns One table body element per band, in band order.
  */
 export declare function bandedTables(rows: ReadonlyArray<TableRow>, columnWidths: ReadonlyArray<number>, bands: ReadonlyArray<ColumnBand>, properties: TableProperties, titleRowIndex?: number, drawingReachTwips?: number, headings?: {
-    readonly colStart: number;
+    readonly columns: ReadonlyArray<number>;
     readonly rowNumbers: ReadonlyArray<number>;
+    readonly band?: HeadingBand;
+}, sheet?: {
+    readonly sheetLeftPt: number;
+    readonly drawings: ReadonlyArray<DrawingBox>;
 }): Array<BodyElement>;