reamkit 1.10.0 → 1.12.0

package/README.md

@@ -20,9 +20,9 @@ Runtime dependencies are minimal: `fflate` (ZIP/Deflate) and `fast-xml-parser`.
 
 Parse once into the format-neutral interlayer, convert to any target. The
 format (docx/xlsx) is sniffed from the bytes; no fonts to wire up — an open
-substitute font (Roboto for sans, Tinos for serif, Cousine for monospace — the
-same families LibreOffice substitutes) is fetched automatically based on the
-document's referenced fonts:
+metric-compatible substitute font (Arimo for sans, Tinos for serif, Cousine for
+monospace, plus Carlito/Caladea for Calibri/Cambria — the same families LibreOffice
+substitutes) is fetched automatically based on the document's referenced fonts:
 
 ```ts
 import { Ream } from 'reamkit';

package/dist/esm/core/converter/facade.js

@@ -2,6 +2,7 @@ import { FontRegistry } from "../font/font-registry.js";
 import { FEATURES } from "../ir/features.js";
 import { ConversionLossError } from "../ir/loss.js";
 import { layoutStyledDocument } from "../../layout/styled-layout.js";
+import { pptxReader } from "../../pptx/pptx-reader.js";
 import { docxReader } from "../../word/docx-reader.js";
 import { projectSheetDoc } from "../../excel/sheet-to-flow.js";
 import { xlsxReader } from "../../excel/xlsx-reader.js";
@@ -13,7 +14,6 @@ import { writeHtml } from "../../html/html-writer.js";
 import { writeSvg } from "../../svg/svg-writer.js";
 import { convertDocxToPdf } from "../../word/docx-to-pdf.js";
 import { convertXlsxToPdf } from "../../excel/xlsx-to-pdf.js";
-import { pptxReader } from "../../pptx/pptx-reader.js";
 import { pdfReader } from "../../pdf-reader/reader.js";
 //#region src/core/converter/facade.ts
 function toFlowDoc(doc) {

package/dist/esm/core/converter/project.js

@@ -9,6 +9,7 @@ function flowRenderOptions(flow) {
 		...flow.headersFooters ? { headersFooters: flow.headersFooters } : {},
 		...flow.footnotes ? { footnotes: flow.footnotes } : {},
 		...flow.endnotes ? { endnotes: flow.endnotes } : {},
+		...flow.comments ? { comments: flow.comments } : {},
 		resources: flow.resources,
 		...flow.charts ? { charts: flow.charts } : {},
 		...flow.embeddedFonts ? { embeddedFonts: flow.embeddedFonts } : {},

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

@@ -1 +1 @@
-export type { AbstractNumbering, Alignment, Border, BorderStyle, BodyElement, CellBorders, CellMerge, DocumentInfo, CellMargins, CellProperties, CellShading, CellDataBar, CellIcon, CellIconShape, CellSparkline, Chart, ChartBlock, ChartDataPoint, ChartSeries, ChartType, CustomGeometry, CustomPathCmd, DocumentModel, FontFamilyMap, HeaderFooterReference, HeaderFooterType, ImageBlock, InlineImage, MathAccent, MathBar, MathDelimiter, MathEqArray, MathFraction, MathFunc, MathGroupChr, MathLimit, MathMatrix, MathNary, MathNode, MathRadical, MathRow, MathRun, MathScript, Numbering, NumberingFormat, NumberingInstance, NumberingLevel, NumberingReference, PageMargins, PageSize, Paragraph, ParagraphProperties, Run, RunProperties, RowProperties, Section, FloatAnchor, SectionColumns, SectionProperties, ShapeBlock, ShapeDash, ShapeFill, ShapeFillKind, ShapeGeometry, ShapeLine, ShapeTextBody, ShapeTransform, Style, StyleSheet, StyleType, Table, TableCell, TableLook, TableProperties, TableStyleCondition, TableStyleConditionType, TableStyleLayer, TableRow, UnderlineStyle, VerticalAlign, } from './types.js';
+export type { AbstractNumbering, Alignment, Border, BorderStyle, BodyElement, Comment, CellBorders, CellMerge, DocumentInfo, CellMargins, CellProperties, CellShading, CellDataBar, CellIcon, CellIconShape, CellSparkline, Chart, ChartBlock, ChartDataPoint, ChartSeries, ChartType, CustomGeometry, CustomPathCmd, DocumentModel, FontFamilyMap, HeaderFooterReference, HeaderFooterType, ImageBlock, InlineImage, MathAccent, MathBar, MathDelimiter, MathEqArray, MathFraction, MathFunc, MathGroupChr, MathLimit, MathMatrix, MathNary, MathNode, MathRadical, MathRow, MathRun, MathScript, Numbering, NumberingFormat, NumberingInstance, NumberingLevel, NumberingReference, PageMargins, PageSize, Paragraph, ParagraphProperties, Run, RunProperties, RowProperties, Section, FloatAnchor, SectionColumns, SectionProperties, ShapeBlock, ShapeDash, ShapeFill, ShapeFillKind, ShapeGeometry, ShapeLine, ShapeTextBody, ShapeTransform, Style, StyleSheet, StyleType, Table, TableCell, TableLook, TableProperties, TableStyleCondition, TableStyleConditionType, TableStyleLayer, TableRow, UnderlineStyle, VerticalAlign, } from './types.js';

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

@@ -132,6 +132,8 @@ export interface Run {
     readonly anchor?: string;
     readonly footnoteRef?: string;
     readonly endnoteRef?: string;
+    readonly commentRef?: string;
+    readonly commentRangeRefs?: ReadonlyArray<string>;
     readonly noteNumber?: true;
     readonly listMarker?: true;
     readonly inlineImage?: InlineImage;
@@ -144,6 +146,27 @@ export interface Paragraph {
     readonly runs: ReadonlyArray<Run>;
     readonly bookmarks?: ReadonlyArray<string>;
 }
+export interface Comment {
+    readonly content: ReadonlyArray<BodyElement>;
+    readonly author?: string;
+    readonly initials?: string;
+    /** Raw w:date timestamp (ISO 8601), as authored — not reformatted. */
+    readonly date?: string;
+    /**
+     * The author's resolved identity (usually an email) from word/people.xml
+     * (`w15:person` → `w15:presenceInfo/@w15:userId`), matched on the author name.
+     * Absent when the file ships no people part or the author is not listed.
+     */
+    readonly authorId?: string;
+    /**
+     * Microsoft commentsExtended (w15) — the id of the comment this one replies
+     * to, forming a thread. Set only when word/commentsExtended.xml links this
+     * comment's paragraph to a parent (w15:paraIdParent). Top-level comments omit it.
+     */
+    readonly parentId?: string;
+    /** w15:done — the comment thread was marked resolved. */
+    readonly done?: boolean;
+}
 export type NumberingFormat = 'decimal' | 'lowerLetter' | 'upperLetter' | 'lowerRoman' | 'upperRoman' | 'bullet' | 'none';
 export interface NumberingReference {
     readonly numId: string;

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

@@ -4,4 +4,4 @@ export interface FontMeasure {
     readonly textWidthPt: (text: string, fontSize: number) => number;
     readonly encodeTextAsCidHex: (text: string) => string;
 }
-export declare function createFontMeasure(parsed: ParsedTtf): FontMeasure;
+export declare function createFontMeasure(parsed: ParsedTtf, kern?: boolean): FontMeasure;

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

@@ -1,7 +1,9 @@
 import { shapeText } from "./opentype-layout.js";
 //#region src/core/font/measure.ts
-function createFontMeasure(parsed) {
+var EMPTY_KERNING = /* @__PURE__ */ new Map();
+function createFontMeasure(parsed, kern = true) {
 	const scale = 1e3 / parsed.unitsPerEm;
+	const kerning = kern ? parsed.kerning : EMPTY_KERNING;
 	const widths = new Array(parsed.numGlyphs);
 	for (let i = 0; i < parsed.numGlyphs; i++) widths[i] = Math.round((parsed.advanceWidths[i] ?? 0) * scale);
 	const pdfWidthForGid = (gid) => {
@@ -9,13 +11,13 @@ function createFontMeasure(parsed) {
 		return widths[gid];
 	};
 	const textWidthPt = (text, fontSize) => {
-		const shaped = shapeText(text, parsed.glyphForCodepoint, parsed.advanceWidths, parsed.ligatures, parsed.kerning, parsed.joiningForms);
+		const shaped = shapeText(text, parsed.glyphForCodepoint, parsed.advanceWidths, parsed.ligatures, kerning, parsed.joiningForms);
 		let totalEm = 0;
 		for (const a of shaped.advances) totalEm += a;
 		return totalEm * fontSize / parsed.unitsPerEm;
 	};
 	const encodeTextAsCidHex = (text) => {
-		const shaped = shapeText(text, parsed.glyphForCodepoint, parsed.advanceWidths, parsed.ligatures, parsed.kerning, parsed.joiningForms);
+		const shaped = shapeText(text, parsed.glyphForCodepoint, parsed.advanceWidths, parsed.ligatures, kerning, parsed.joiningForms);
 		let out = "";
 		for (const gid of shaped.gids) out += gid.toString(16).padStart(4, "0").toUpperCase();
 		return out;

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

@@ -12,8 +12,17 @@ export interface ParsedTtf {
     readonly fontBBox: readonly [number, number, number, number];
     readonly ascender: number;
     readonly descender: number;
+    readonly lineGap: number;
     readonly capHeight: number;
     readonly xHeight: number;
+    readonly vmetrics: {
+        readonly typoAscent: number;
+        readonly typoDescent: number;
+        readonly typoLineGap: number;
+        readonly winAscent: number;
+        readonly winDescent: number;
+        readonly useTypoMetrics: boolean;
+    };
     readonly italicAngle: number;
     readonly stemV: number;
     readonly flags: number;

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

@@ -41,7 +41,7 @@ function parseTtf(raw) {
 	r.seek(hhea.offset + 4);
 	const ascender = r.i16();
 	const descender = r.i16();
-	r.skip(2);
+	const lineGap = r.i16();
 	r.skip(24);
 	const numberOfHMetrics = r.u16();
 	const maxp = require("maxp");
@@ -74,6 +74,12 @@ function parseTtf(raw) {
 	let xHeight = 0;
 	let isItalic = false;
 	let usWeightClass = 400;
+	let typoAscent = ascender;
+	let typoDescent = descender;
+	let typoLineGap = lineGap;
+	let winAscent = Math.abs(ascender);
+	let winDescent = Math.abs(descender);
+	let useTypoMetrics = false;
 	const os2 = tables.get("OS/2");
 	if (os2) {
 		r.seek(os2.offset);
@@ -81,7 +87,17 @@ function parseTtf(raw) {
 		r.skip(2);
 		usWeightClass = r.u16();
 		r.seek(os2.offset + 62);
-		isItalic = (r.u16() & 1) !== 0;
+		const fsSelection = r.u16();
+		isItalic = (fsSelection & 1) !== 0;
+		useTypoMetrics = (fsSelection & 128) !== 0;
+		if (os2.length >= 78) {
+			r.seek(os2.offset + 68);
+			typoAscent = r.i16();
+			typoDescent = r.i16();
+			typoLineGap = r.i16();
+			winAscent = r.u16();
+			winDescent = r.u16();
+		}
 		if (os2Version >= 2 && os2.length >= 90) {
 			r.seek(os2.offset + 86);
 			xHeight = r.i16();
@@ -113,8 +129,17 @@ function parseTtf(raw) {
 		],
 		ascender,
 		descender,
+		lineGap,
 		capHeight,
 		xHeight,
+		vmetrics: {
+			typoAscent,
+			typoDescent,
+			typoLineGap,
+			winAscent,
+			winDescent,
+			useTypoMetrics
+		},
 		italicAngle,
 		stemV,
 		flags,

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

@@ -35,7 +35,8 @@ export declare function callerFontProvider(fonts: FontBytesByVariant): FontProvi
  */
 export declare function embeddedDocFontProvider(embedded: ReadonlyMap<string, FontRegistry>): FontProvider;
 /**
- * Open CDN substitutes (Roboto / Tinos / Cousine — the LibreOffice mapping).
+ * Open CDN substitutes (Arimo / Tinos / Cousine / Carlito / Caladea — the
+ * LibreOffice metric-compatible mapping).
  * Always answers; the chain reports it as a substitution.
  */
 export declare function remoteFontProvider(options?: {

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

@@ -62,7 +62,8 @@ function embeddedDocFontProvider(embedded) {
 	};
 }
 /**
-* Open CDN substitutes (Roboto / Tinos / Cousine — the LibreOffice mapping).
+* Open CDN substitutes (Arimo / Tinos / Cousine / Carlito / Caladea — the
+* LibreOffice metric-compatible mapping).
 * Always answers; the chain reports it as a substitution.
 */
 function remoteFontProvider(options = {}) {

package/dist/esm/core/fonts/remote-fonts.d.ts

@@ -1,5 +1,5 @@
 import { FontBytesByVariant } from '../font/index.js';
-export type FamilyKey = 'roboto' | 'tinos' | 'cousine';
+export type FamilyKey = 'arimo' | 'tinos' | 'cousine' | 'carlito' | 'caladea';
 export declare function resolveFamilyKey(name: string | undefined): FamilyKey;
 export type FetchLike = (url: string) => Promise<{
     ok: boolean;

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

@@ -7,9 +7,9 @@ var VARIANT_SUFFIX = {
 	boldItalic: "700Bold_Italic"
 };
 var FAMILIES = {
-	roboto: {
-		pkg: "roboto",
-		file: "Roboto"
+	arimo: {
+		pkg: "arimo",
+		file: "Arimo"
 	},
 	tinos: {
 		pkg: "tinos",
@@ -18,13 +18,32 @@ var FAMILIES = {
 	cousine: {
 		pkg: "cousine",
 		file: "Cousine"
+	},
+	carlito: {
+		pkg: "carlito",
+		file: "Carlito",
+		nested: true
+	},
+	caladea: {
+		pkg: "caladea",
+		file: "Caladea"
 	}
 };
+var EXACT = {
+	calibri: "carlito",
+	cambria: "caladea",
+	arial: "arimo",
+	helvetica: "arimo",
+	"liberation sans": "arimo",
+	"times new roman": "tinos",
+	times: "tinos",
+	"liberation serif": "tinos",
+	"courier new": "cousine",
+	courier: "cousine",
+	"liberation mono": "cousine"
+};
 var SERIF = new Set([
-	"times",
-	"times new roman",
 	"georgia",
-	"cambria",
 	"garamond",
 	"book antiqua",
 	"palatino",
@@ -33,8 +52,6 @@ var SERIF = new Set([
 	"serif"
 ]);
 var MONO = new Set([
-	"courier",
-	"courier new",
 	"consolas",
 	"monaco",
 	"menlo",
@@ -43,14 +60,18 @@ var MONO = new Set([
 	"monospace"
 ]);
 function resolveFamilyKey(name) {
-	if (!name) return "roboto";
+	if (!name) return "arimo";
 	const n = name.trim().toLowerCase();
+	const exact = EXACT[n];
+	if (exact) return exact;
 	if (MONO.has(n)) return "cousine";
 	if (SERIF.has(n)) return "tinos";
-	return "roboto";
+	return "arimo";
 }
 function fontUrl(family, variant) {
-	return `${CDN_BASE}/${family.pkg}/${family.file}_${VARIANT_SUFFIX[variant]}.ttf`;
+	const suffix = VARIANT_SUFFIX[variant];
+	const leaf = `${family.file}_${suffix}.ttf`;
+	return family.nested ? `${CDN_BASE}/${family.pkg}/${suffix}/${leaf}` : `${CDN_BASE}/${family.pkg}/${leaf}`;
 }
 var cache = /* @__PURE__ */ new Map();
 async function fetchTtf(url, fetchImpl, required) {

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

@@ -10,6 +10,7 @@ export declare const FEATURES: {
     readonly imagesJp2: "images.jp2";
     readonly hyperlinks: "hyperlinks";
     readonly shapes: "shapes";
+    readonly smartArt: "shapes.smartArt";
     readonly charts: "charts";
     readonly math: "math";
     readonly rtl: "rtl";

package/dist/esm/core/ir/features.js

@@ -10,6 +10,7 @@ var FEATURES = {
 	imagesJp2: "images.jp2",
 	hyperlinks: "hyperlinks",
 	shapes: "shapes",
+	smartArt: "shapes.smartArt",
 	charts: "charts",
 	math: "math",
 	rtl: "rtl",

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

@@ -1,4 +1,4 @@
-import { BodyElement, Chart, DocumentInfo, Numbering, Section, SectionProperties, StyleSheet } from '../document-model/index.js';
+import { BodyElement, Chart, Comment, DocumentInfo, Numbering, Section, SectionProperties, StyleSheet } from '../document-model/index.js';
 import { FontRegistry } from '../font/index.js';
 import { ResourceStore } from './resources.js';
 export interface FlowDoc {
@@ -14,6 +14,8 @@ export interface FlowDoc {
     /** §17.11 footnotes/endnotes content by id (separator stubs excluded). */
     readonly footnotes?: ReadonlyMap<string, ReadonlyArray<BodyElement>>;
     readonly endnotes?: ReadonlyMap<string, ReadonlyArray<BodyElement>>;
+    /** §17.13.4 review comments by id, anchored from a run's `commentRef`. */
+    readonly comments?: ReadonlyMap<string, Comment>;
     /** Parsed charts keyed by relationship id (ChartBlock.chartRelId). */
     readonly charts?: ReadonlyMap<string, Chart>;
     /** Content-addressed binary resources (images). */

package/dist/esm/core/line-breaker/greedy.d.ts

@@ -0,0 +1,2 @@
+import { Item } from './knuth-plass.js';
+export declare function greedyBreakLines(items: ReadonlyArray<Item>, lineWidths: number | ReadonlyArray<number>): ReadonlyArray<number>;

package/dist/esm/core/line-breaker/greedy.js

@@ -0,0 +1,67 @@
+import { FORBIDDEN_BREAK } from "./knuth-plass.js";
+//#region src/core/line-breaker/greedy.ts
+function greedyBreakLines(items, lineWidths) {
+	if (items.length === 0) return [];
+	const widthFor = (line) => typeof lineWidths === "number" ? lineWidths : lineWidths[Math.min(line, lineWidths.length - 1)];
+	const widthBefore = new Array(items.length + 1);
+	widthBefore[0] = 0;
+	for (let i = 0; i < items.length; i++) {
+		const it = items[i];
+		widthBefore[i + 1] = widthBefore[i] + (it.type === "penalty" ? 0 : it.width);
+	}
+	const lineWidth = (start, b) => {
+		let w = widthBefore[b] - widthBefore[start];
+		const item = items[b];
+		if (item.type === "penalty") w += item.width;
+		return w;
+	};
+	const isFeasible = (i) => {
+		const item = items[i];
+		if (item.type === "penalty") return item.penalty < FORBIDDEN_BREAK;
+		if (item.type === "glue") {
+			const prev = items[i - 1];
+			return !!prev && prev.type === "box";
+		}
+		return false;
+	};
+	const breaks = [];
+	let lineStart = 0;
+	let lineNo = 0;
+	let lastGood = -1;
+	let i = 0;
+	while (i < items.length) {
+		if (!isFeasible(i)) {
+			i++;
+			continue;
+		}
+		const item = items[i];
+		const forced = item.type === "penalty" && item.penalty <= -1e4;
+		const fits = lineWidth(lineStart, i) <= widthFor(lineNo);
+		if (!fits && lastGood >= 0) {
+			breaks.push(lastGood);
+			lineStart = lastGood + 1;
+			lineNo++;
+			lastGood = -1;
+			continue;
+		}
+		if (forced) {
+			breaks.push(i);
+			lineStart = i + 1;
+			lineNo++;
+			lastGood = -1;
+			i++;
+			continue;
+		}
+		if (fits) lastGood = i;
+		else {
+			breaks.push(i);
+			lineStart = i + 1;
+			lineNo++;
+			lastGood = -1;
+		}
+		i++;
+	}
+	return breaks;
+}
+//#endregion
+export { greedyBreakLines };

package/dist/esm/core/line-breaker/index.d.ts

@@ -1,2 +1,3 @@
 export { FORCED_BREAK, breakLines } from './knuth-plass.js';
+export { greedyBreakLines } from './greedy.js';
 export type { Item, BoxItem, GlueItem, PenaltyItem, BreakResult, } from './knuth-plass.js';

package/dist/esm/core/line-breaker/knuth-plass.d.ts

@@ -20,6 +20,7 @@ export interface BreakResult {
     readonly ratios: ReadonlyArray<number>;
 }
 export declare const FORCED_BREAK = -10000;
+export declare const FORBIDDEN_BREAK = 10000;
 /**
  * Break a paragraph into lines using the Knuth-Plass total-fit algorithm.
  *

package/dist/esm/core/line-breaker/knuth-plass.js

@@ -47,7 +47,7 @@ function breakLines(items, lineWidths) {
 	let active = [startNode];
 	const isFeasibleBreakpoint = (i) => {
 		const item = items[i];
-		if (item.type === "penalty" && item.penalty < FORBIDDEN_BREAK) return true;
+		if (item.type === "penalty" && item.penalty < 1e4) return true;
 		if (item.type === "glue") {
 			const prev = items[i - 1];
 			return !!prev && prev.type === "box";
@@ -90,7 +90,7 @@ function breakLines(items, lineWidths) {
 	const lineDemerits = (r, penaltyAtBreak, lastItemPenalty) => {
 		const badness = 100 * Math.pow(Math.abs(r), 3);
 		let d;
-		if (penaltyAtBreak >= 0 && penaltyAtBreak < FORBIDDEN_BREAK) d = Math.pow(LINE_PENALTY + badness + penaltyAtBreak, 2);
+		if (penaltyAtBreak >= 0 && penaltyAtBreak < 1e4) d = Math.pow(LINE_PENALTY + badness + penaltyAtBreak, 2);
 		else if (penaltyAtBreak > -1e4 && penaltyAtBreak < 0) d = Math.pow(LINE_PENALTY + badness, 2) - penaltyAtBreak * penaltyAtBreak;
 		else d = Math.pow(LINE_PENALTY + badness, 2);
 		return d;
@@ -169,4 +169,4 @@ function breakLines(items, lineWidths) {
 	};
 }
 //#endregion
-export { FORCED_BREAK, breakLines };
+export { FORBIDDEN_BREAK, FORCED_BREAK, breakLines };

package/dist/esm/core/po-helpers.d.ts

@@ -6,6 +6,8 @@ export declare function poChildren(node: PoNode | undefined): ReadonlyArray<PoNo
 export declare function poChildrenWith(node: PoNode | undefined, tag: string): Array<PoNode>;
 export declare function poFirstChild(node: PoNode | undefined, tag: string): PoNode | undefined;
 export declare function poAttr(node: PoNode | undefined, name: string): string | undefined;
+export declare function poAttrLocal(node: PoNode | undefined, name: string): string | undefined;
+export declare function poIsLocal(node: PoNode | undefined, name: string): boolean;
 export declare function poIntAttr(node: PoNode | undefined, name: string): number | undefined;
 export declare function poVal(node: PoNode | undefined): string | undefined;
 export declare function poToggle(node: PoNode | undefined): boolean | undefined;

package/dist/esm/core/po-helpers.js

@@ -28,6 +28,19 @@ function poAttr(node, name) {
 	const v = a[`@_w:${name}`] ?? a[`@_r:${name}`] ?? a[`@_m:${name}`] ?? a[`@_xml:${name}`] ?? a[`@_${name}`];
 	return typeof v === "string" ? v : void 0;
 }
+function poAttrLocal(node, name) {
+	if (!node || typeof node !== "object") return void 0;
+	const attrs = node[ATTRS_KEY];
+	if (!attrs || typeof attrs !== "object") return void 0;
+	for (const [k, v] of Object.entries(attrs)) {
+		if (!k.startsWith("@_")) continue;
+		if (k.slice(2).split(":").pop() === name && typeof v === "string") return v;
+	}
+}
+function poIsLocal(node, name) {
+	const tag = poTag(node);
+	return tag !== void 0 && (tag === name || tag.split(":").pop() === name);
+}
 function poIntAttr(node, name) {
 	const v = poAttr(node, name);
 	if (v === void 0) return void 0;
@@ -73,4 +86,4 @@ function poFindDescendant(node, tag) {
 	}
 }
 //#endregion
-export { poAttr, poChildren, poChildrenWith, poFindByPath, poFindDescendant, poFirstChild, poIntAttr, poIs, poTag, poText, poToggle, poVal };
+export { poAttr, poAttrLocal, poChildren, poChildrenWith, poFindByPath, poFindDescendant, poFirstChild, poIntAttr, poIs, poIsLocal, poTag, poText, poToggle, poVal };

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

@@ -1 +1 @@
-export type { CellType, WorksheetCell, ColumnWidth, MergedRange, RowHeight, XlsxPageMargins, XlsxPageSetup, XlsxPrintOptions, ParsedWorksheet, XlsxFont, XlsxFill, XlsxBorderStyleName, XlsxBorderEdge, XlsxBorder, XlsxHorizontalAlign, XlsxVerticalAlign, XlsxCellAlignment, XlsxCellXf, XlsxStyles, DefinedName, Dxf, CfOperator, CfRuleCellIs, CfvoType, Cfvo, CfRuleColorScale, CfRuleDataBar, CfRuleIconSet, CfRule, ConditionalFormat, SparklineKind, ParsedSparkline, ExcelTable, SheetPane, } from './types.js';
+export type { CellType, WorksheetCell, ColumnWidth, MergedRange, RowHeight, XlsxPageMargins, XlsxPageSetup, XlsxPrintOptions, ParsedWorksheet, XlsxFont, XlsxFill, XlsxBorderStyleName, XlsxBorderEdge, XlsxBorder, XlsxHorizontalAlign, XlsxVerticalAlign, XlsxCellAlignment, XlsxCellXf, XlsxStyles, DefinedName, Dxf, CfOperator, CfRuleCellIs, CfvoType, Cfvo, CfRuleColorScale, CfRuleDataBar, CfRuleIconSet, CfRule, ConditionalFormat, SparklineKind, ParsedSparkline, ExcelTable, PivotTable, SheetPane, } from './types.js';

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

@@ -61,6 +61,7 @@ export interface ParsedWorksheet {
     readonly sparklines?: ReadonlyArray<ParsedSparkline>;
     readonly tablePartRelIds?: ReadonlyArray<string>;
     readonly tables?: ReadonlyArray<ExcelTable>;
+    readonly pivotTables?: ReadonlyArray<PivotTable>;
     readonly pane?: SheetPane;
 }
 export interface SheetPane {
@@ -81,6 +82,21 @@ export interface ExcelTable {
     readonly bandHex?: string;
     readonly headerTextHex?: string;
 }
+export interface PivotTable {
+    readonly ref: MergedRange;
+    readonly name?: string;
+    readonly styleName?: string;
+    readonly firstHeaderRow: number;
+    readonly firstDataRow: number;
+    readonly firstDataCol: number;
+    readonly showRowStripes: boolean;
+    readonly showColStripes: boolean;
+    readonly rowItemTypes?: ReadonlyArray<string | undefined>;
+    readonly colItemTypes?: ReadonlyArray<string | undefined>;
+    readonly headerHex?: string;
+    readonly bandHex?: string;
+    readonly headerTextHex?: string;
+}
 export type SparklineKind = 'line' | 'column' | 'winLoss';
 export interface ParsedSparkline {
     readonly kind: SparklineKind;

package/dist/esm/excel/pivot-table-parser.d.ts

@@ -0,0 +1,2 @@
+import { PivotTable } from '../core/spreadsheet-model/index.js';
+export declare function parsePivotTablePart(data: Uint8Array): PivotTable | undefined;

package/dist/esm/excel/pivot-table-parser.js

@@ -0,0 +1,68 @@
+import { parseAreaRef } from "./defined-name-ref.js";
+import { XMLParser } from "fast-xml-parser";
+//#region src/excel/pivot-table-parser.ts
+var decoder = new TextDecoder("utf-8");
+var parser = new XMLParser({
+	ignoreAttributes: false,
+	attributeNamePrefix: "@_",
+	parseAttributeValue: false,
+	parseTagValue: false,
+	removeNSPrefix: true
+});
+function parsePivotTablePart(data) {
+	const def = asObj(parser.parse(decoder.decode(data))["pivotTableDefinition"]);
+	if (!def) return void 0;
+	const loc = asObj(def["location"]);
+	const refStr = loc ? strAttr(loc, "ref") : void 0;
+	const ref = refStr ? parseAreaRef(refStr) : void 0;
+	if (!ref) return void 0;
+	const si = asObj(def["pivotTableStyleInfo"]);
+	const name = strAttr(def, "name");
+	const styleName = si ? strAttr(si, "name") : void 0;
+	const rowItemTypes = itemTypes(asObj(def["rowItems"]));
+	const colItemTypes = itemTypes(asObj(def["colItems"]));
+	const hasRowTotals = rowItemTypes?.some((t) => t !== void 0) ?? false;
+	const hasColTotals = colItemTypes?.some((t) => t !== void 0) ?? false;
+	return {
+		ref,
+		...name ? { name } : {},
+		...styleName ? { styleName } : {},
+		firstHeaderRow: (loc ? numAttr(loc, "firstHeaderRow") : void 0) ?? 1,
+		firstDataRow: (loc ? numAttr(loc, "firstDataRow") : void 0) ?? 1,
+		firstDataCol: (loc ? numAttr(loc, "firstDataCol") : void 0) ?? 0,
+		showRowStripes: si ? boolAttr(si, "showRowStripes") : false,
+		showColStripes: si ? boolAttr(si, "showColStripes") : false,
+		...hasRowTotals && rowItemTypes ? { rowItemTypes } : {},
+		...hasColTotals && colItemTypes ? { colItemTypes } : {}
+	};
+}
+function itemTypes(node) {
+	if (!node) return void 0;
+	return toArray(node["i"]).map((i) => {
+		const o = asObj(i);
+		return o ? strAttr(o, "t") : void 0;
+	});
+}
+function toArray(v) {
+	if (v === void 0 || v === null) return [];
+	return Array.isArray(v) ? v : [v];
+}
+function asObj(v) {
+	return v && typeof v === "object" && !Array.isArray(v) ? v : void 0;
+}
+function strAttr(obj, name) {
+	const v = obj[`@_${name}`];
+	return typeof v === "string" ? v : void 0;
+}
+function numAttr(obj, name) {
+	const v = strAttr(obj, name);
+	if (v === void 0) return void 0;
+	const n = Number(v);
+	return Number.isFinite(n) ? n : void 0;
+}
+function boolAttr(obj, name) {
+	const v = strAttr(obj, name);
+	return v === "1" || v === "true";
+}
+//#endregion
+export { parsePivotTablePart };

package/dist/esm/excel/print-model.js

@@ -525,18 +525,23 @@ function collectSeriesValues(cells, area) {
 	for (let r = area.startRow; r <= area.endRow; r++) for (let col = area.startColumn; col <= area.endColumn; col++) out.push(byKey.get(key(r, col)) ?? null);
 	return out;
 }
+function isPivotTotal(t) {
+	return t !== void 0 && t !== "data" && t !== "blank";
+}
 function buildTableFormatLookup(worksheet) {
 	const out = /* @__PURE__ */ new Map();
-	for (const t of worksheet.tables ?? []) {
-		const { ref } = t;
-		const firstDataRow = ref.startRow + t.headerRowCount;
+	const band = (ref, headerRows, style, isTotalRow) => {
+		const firstDataRow = ref.startRow + headerRows;
 		for (let r = ref.startRow; r <= ref.endRow; r++) {
 			let colorHex;
 			let fontColorHex;
 			if (r < firstDataRow) {
-				colorHex = t.headerHex;
-				fontColorHex = t.headerTextHex;
-			} else if (t.showRowStripes && t.bandHex) colorHex = (r - firstDataRow) % 2 === 1 ? t.bandHex : void 0;
+				colorHex = style.headerHex;
+				fontColorHex = style.headerTextHex;
+			} else if (isTotalRow?.(r - firstDataRow)) {
+				colorHex = style.headerHex;
+				fontColorHex = style.headerTextHex;
+			} else if (style.showRowStripes && style.bandHex) colorHex = (r - firstDataRow) % 2 === 1 ? style.bandHex : void 0;
 			if (!colorHex && !fontColorHex) continue;
 			const fmt = {
 				...colorHex ? { shading: { colorHex } } : {},
@@ -544,6 +549,23 @@ function buildTableFormatLookup(worksheet) {
 			};
 			for (let c = ref.startColumn; c <= ref.endColumn; c++) out.set(key(r, c), fmt);
 		}
+	};
+	for (const t of worksheet.tables ?? []) band(t.ref, t.headerRowCount, t);
+	for (const p of worksheet.pivotTables ?? []) band(p.ref, p.firstDataRow, p, (off) => isPivotTotal(p.rowItemTypes?.[off]));
+	for (const p of worksheet.pivotTables ?? []) {
+		if (!p.colItemTypes || p.headerHex === void 0) continue;
+		const firstDataRow = p.ref.startRow + p.firstDataRow;
+		const firstDataCol = p.ref.startColumn + p.firstDataCol;
+		const totalFmt = {
+			shading: { colorHex: p.headerHex },
+			...p.headerTextHex ? { fontColorHex: p.headerTextHex } : {}
+		};
+		for (let i = 0; i < p.colItemTypes.length; i++) {
+			if (!isPivotTotal(p.colItemTypes[i])) continue;
+			const c = firstDataCol + i;
+			if (c > p.ref.endColumn) continue;
+			for (let r = firstDataRow; r <= p.ref.endRow; r++) out.set(key(r, c), totalFmt);
+		}
 	}
 	return out;
 }