reamkit 1.32.1 → 1.33.0

package/README.md

@@ -213,10 +213,11 @@ own PDF: columns in the Normal font's digit as Excel counts it, a table in the
 style it names, a theme colour's tint to the digit, a sheet that reads from the
 right turned round, the notes it shows beside their cells, its drawings over
 the cells and cut where its pages are, a chart's axes scaled and crossed where
-Excel puts them. As HTML a workbook comes out as Excel's window shows it —
-every tab, its gridlines, a noted cell flagged with the note on hover — and as
-SVG as pictures of its sheets, each whole, its text drawn from the faces' own
-outlines.
+Excel puts them, its text in the face Excel sets it in, its 3-D bars and pies
+standing in three dimensions. As HTML a workbook comes out as Excel's window
+shows it — every tab, its gridlines, a noted cell flagged with the note on
+hover — and as SVG as pictures of its sheets, each whole, its text drawn from
+the faces' own outlines.
 
 **Reads PDF, too.** `Ream.parse` accepts a PDF and reconstructs a `FlowDoc` — a
 tagged PDF from its structure tree (headings, tables, lists, reading order), an

package/dist/esm/core/bidi/algorithm.js

@@ -268,7 +268,7 @@ function resolveWeakTypes(types, seq) {
 		else if (t === "EN" && lastStrong === "L") types[i] = "L";
 	}
 }
-var BRACKET_OPEN_TO_CLOSE = new Map([
+var BRACKET_OPEN_TO_CLOSE = /* @__PURE__ */ new Map([
 	[40, 41],
 	[91, 93],
 	[123, 125],
@@ -447,7 +447,7 @@ function reorderVisual(levels) {
 	const order = Array.from({ length: n }, (_, i) => i);
 	if (n === 0) return order;
 	let highest = 0;
-	let lowestOdd = MAX_DEPTH + 1;
+	let lowestOdd = 126;
 	for (const lvl of levels) {
 		if (lvl > highest) highest = lvl;
 		if (lvl % 2 === 1 && lvl < lowestOdd) lowestOdd = lvl;

package/dist/esm/core/bidi/char-types.js

@@ -1,5 +1,5 @@
 //#region src/core/bidi/char-types.ts
-var SINGLE = new Map([
+var SINGLE = /* @__PURE__ */ new Map([
 	[9, "S"],
 	[10, "B"],
 	[11, "S"],

package/dist/esm/core/bidi/index.js

@@ -1,6 +1,6 @@
 import { bidiClass } from "./char-types.js";
-import { computeBidi } from "./algorithm.js";
-import "./segments.js";
+import { computeBidi, reorderVisual } from "./algorithm.js";
+import { segmentLevels } from "./segments.js";
 //#region src/core/bidi/index.ts
 /**
 * Run the UAX #9 algorithm over a string, returning per-code-point embedding
@@ -66,4 +66,4 @@ function reverseByCodePoint(text) {
 	return [...text].reverse().join("");
 }
 //#endregion
-export { analyzeString, firstStrongDirection, hasBidiCharacters, reverseByCodePoint };
+export { analyzeString, bidiClass, firstStrongDirection, hasBidiCharacters, reorderVisual, reverseByCodePoint, segmentLevels };

package/dist/esm/core/bytes.js

@@ -104,4 +104,4 @@ function bytesInclude(haystack, needle) {
 	return false;
 }
 //#endregion
-export { bytesInclude, packageHasPart, toBase64 };
+export { bytesInclude, bytesIncludePartName, packageHasPart, toBase64 };

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

@@ -129,10 +129,11 @@ function createConverter(opts = {}) {
 			if (!fonts) throw new Error("to: 'svg' requires options.fonts/fontBytes or fontProviders");
 			const { doc } = reader.read(bytes);
 			const registry = FontRegistry.fromBytes(fonts);
-			const svg = writeSvg(doc.kind === "sheet" ? layoutSheetImages(doc, { registry }, rest.now ? { now: rest.now } : {}) : layoutStyledDocument(doc.body, {
+			const laid = doc.kind === "sheet" ? layoutSheetImages(doc, { registry }, rest.now ? { now: rest.now } : {}) : layoutStyledDocument(doc.body, {
 				registry,
 				...flowRenderOptions(doc)
-			}));
+			});
+			const svg = writeSvg(laid);
 			losses.push(...svg.losses);
 			if (strict && losses.length > 0) throw new ConversionLossError(losses[0]);
 			return {

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

@@ -53,6 +53,11 @@ var SOURCE_MIME = {
 * substitute-font auto-detection and PDF/A-3 `embedSource`.
 */
 var Ream = class Ream {
+	flow;
+	sheet;
+	losses;
+	source;
+	readerId;
 	/**
 	* @param flow     The interlayer — the parsed, format-neutral document tree.
 	* @param sheet    The native SpreadsheetML tree when the source is a spreadsheet
@@ -142,11 +147,12 @@ var Ream = class Ream {
 			};
 		}
 		if (to === "md") {
-			const markdown = writeMarkdown(this.sheet && options.sheetNames !== false ? projectSheetDoc(this.sheet, {
+			const source = this.sheet && options.sheetNames !== false ? projectSheetDoc(this.sheet, {
 				...options.now ? { now: options.now } : {},
 				...options.fileName ? { fileName: options.fileName } : {},
 				sheetHeadings: true
-			}) : flow, {
+			}) : flow;
+			const markdown = writeMarkdown(source, {
 				...options.images ? { images: options.images } : {},
 				...options.pageBreaks ? { pageBreaks: options.pageBreaks } : {}
 			});
@@ -189,11 +195,12 @@ var Ream = class Ream {
 				registry,
 				...registriesByFamily ? { registriesByFamily } : {}
 			};
-			const svg = writeSvg(this.sheet ? layoutSheetImages(this.sheet, faces, sheetOptions, renderOptions) : layoutStyledDocument(flow.body, {
+			const laid = this.sheet ? layoutSheetImages(this.sheet, faces, sheetOptions, renderOptions) : layoutStyledDocument(flow.body, {
 				...faces,
 				...flowRenderOptions(flow),
 				...renderOptions
-			}));
+			});
+			const svg = writeSvg(laid);
 			losses.push(...svg.losses);
 			this.enforceStrict(options, losses);
 			return {
@@ -250,7 +257,7 @@ var Ream = class Ream {
 			if (fonts) return { fonts };
 		}
 		const fetchOpt = options.fontFetch ? { fetch: options.fontFetch } : {};
-		const keys = options.fontFamily ? new Set([resolveFamilyKey(options.fontFamily)]) : familiesInFlow(flow);
+		const keys = options.fontFamily ? /* @__PURE__ */ new Set([resolveFamilyKey(options.fontFamily)]) : familiesInFlow(flow);
 		if (keys.size <= 1 && scriptsInFlow(flow).scripts.size === 0) {
 			const family = keys.values().next().value;
 			return { fonts: await fetchFontSet({

package/dist/esm/core/crypto/asn1.js

@@ -49,7 +49,7 @@ var set = (...items) => tlv(49, concat(items));
 /** OCTET STRING (tag `0x04`) wrapping raw `bytes`. */
 var octetString = (bytes) => tlv(4, bytes);
 /** NULL (tag `0x05`, empty content). */
-var nullValue = () => tlv(5, new Uint8Array(0));
+var nullValue = () => tlv(5, /* @__PURE__ */ new Uint8Array(0));
 /** `[n]` context-tag, constructed (EXPLICIT or IMPLICIT-over-constructed). */
 var explicit = (tagNum, content) => tlv(160 | tagNum, content);
 function base128(v) {
@@ -185,4 +185,4 @@ function certIssuerAndSerial(cert) {
 	};
 }
 //#endregion
-export { certIssuerAndSerial, cmsTime, concat, explicit, integer, nullValue, octetString, oid, seq, set, setOfBody, tlv };
+export { certIssuerAndSerial, cmsTime, concat, explicit, integer, nullValue, octetString, oid, readTlv, seq, set, setOfBody, tlv };

package/dist/esm/core/crypto/cms.js

@@ -24,17 +24,19 @@ var attribute = (oidStr, value) => seq(oid(oidStr), set(value));
 */
 async function buildPkcs7Detached(params) {
 	const { issuer, serial } = certIssuerAndSerial(params.certificate);
-	const attrsBody = setOfBody([
+	const attrs = [
 		attribute(OID.contentType, oid(OID.idData)),
 		attribute(OID.messageDigest, octetString(params.messageDigest)),
 		attribute(OID.signingTime, cmsTime(params.signingTime))
-	]);
+	];
+	const attrsBody = setOfBody(attrs);
 	const signedAttrsForSigning = tlv(49, attrsBody);
 	const signedAttrsTagged = tlv(160, attrsBody);
 	const signature = await params.sign(signedAttrsForSigning);
 	const sigAlgId = params.signatureAlgorithm === "ecdsa" ? ecdsaAlgId() : rsaAlgId();
 	const signerInfo = seq(integer(1), seq(issuer, serial), sha256AlgId(), signedAttrsTagged, sigAlgId, octetString(signature));
-	const certificates = tlv(160, concat([params.certificate, ...params.extraCertificates ?? []]));
+	const certBlobs = [params.certificate, ...params.extraCertificates ?? []];
+	const certificates = tlv(160, concat(certBlobs));
 	const signedData = seq(integer(1), set(sha256AlgId()), seq(oid(OID.idData)), certificates, set(signerInfo));
 	return seq(oid(OID.idSignedData), explicit(0, signedData));
 }

package/dist/esm/core/crypto/index.js

@@ -1 +1,2 @@
-import "./cms.js";
+import { buildPkcs7Detached } from "./cms.js";
+export { buildPkcs7Detached };

package/dist/esm/core/crypto/offcrypto.js

@@ -69,16 +69,16 @@ function standard(info, payload, password) {
 }
 function standardKey(password, salt, keyLength) {
 	let h = sha1(concat(salt, utf16le(password)));
-	const counter = new Uint8Array(4);
+	const counter = /* @__PURE__ */ new Uint8Array(4);
 	for (let i = 0; i < 5e4; i++) {
 		new DataView(counter.buffer).setUint32(0, i, true);
 		h = sha1(concat(counter, h));
 	}
-	h = sha1(concat(h, new Uint8Array(4)));
+	h = sha1(concat(h, /* @__PURE__ */ new Uint8Array(4)));
 	return concat(sha1(padded(h, 54)), sha1(padded(h, 92))).subarray(0, keyLength);
 }
 function padded(h, byte) {
-	const buf = new Uint8Array(64).fill(byte);
+	const buf = (/* @__PURE__ */ new Uint8Array(64)).fill(byte);
 	for (let i = 0; i < h.length && i < 64; i++) buf[i] = buf[i] ^ h[i];
 	return buf;
 }
@@ -104,7 +104,7 @@ function agile(info, payload, password) {
 	const packageKey = decryptAgile(keyFor(BLOCK_KEY_VALUE), enc.saltValue, encryptedKeyValue, enc.cbc).subarray(0, keyData.keyBits / 8);
 	const cipher = payload.subarray(8);
 	const out = new Uint8Array(cipher.length);
-	const counter = new Uint8Array(4);
+	const counter = /* @__PURE__ */ new Uint8Array(4);
 	for (let i = 0; i * SEGMENT < cipher.length; i++) {
 		new DataView(counter.buffer).setUint32(0, i, true);
 		const iv = keyData.hash(concat(keyData.saltValue, counter)).subarray(0, keyData.blockSize || 16);
@@ -115,7 +115,7 @@ function agile(info, payload, password) {
 }
 function agileSpin(password, enc, spinCount) {
 	let h = enc.hash(concat(enc.saltValue, utf16le(password)));
-	const counter = new Uint8Array(4);
+	const counter = /* @__PURE__ */ new Uint8Array(4);
 	for (let i = 0; i < spinCount; i++) {
 		new DataView(counter.buffer).setUint32(0, i, true);
 		h = enc.hash(concat(counter, h));
@@ -132,9 +132,10 @@ function agileBlockKey(spun, enc, block) {
 }
 function decryptAgile(key, iv, data, cbc) {
 	if (!cbc) return aesEcbDecrypt(key, data);
-	return aesCbcDecrypt(key, iv.length >= 16 ? iv.subarray(0, 16) : concat(iv, new Uint8Array(16 - iv.length)), data, false);
+	const block = iv.length >= 16 ? iv.subarray(0, 16) : concat(iv, new Uint8Array(16 - iv.length));
+	return aesCbcDecrypt(key, block, data, false);
 }
-var HASHES = new Map([
+var HASHES = /* @__PURE__ */ new Map([
 	["sha1", sha1],
 	["sha-1", sha1],
 	["sha256", sha256],

package/dist/esm/core/crypto/primitives.js

@@ -4,7 +4,7 @@
 * decrypts; used by the legacy V1/V2/V4 Standard security handlers.
 */
 function rc4(key, data) {
-	const s = new Uint8Array(256);
+	const s = /* @__PURE__ */ new Uint8Array(256);
 	for (let i = 0; i < 256; i++) s[i] = i;
 	let j = 0;
 	for (let i = 0; i < 256; i++) {
@@ -137,7 +137,7 @@ function md5(input) {
 		c0 = c0 + c | 0;
 		d0 = d0 + d | 0;
 	}
-	const out = new Uint8Array(16);
+	const out = /* @__PURE__ */ new Uint8Array(16);
 	[
 		a0,
 		b0,
@@ -234,7 +234,7 @@ function sha1(input) {
 	let h2 = 2562383102;
 	let h3 = 271733878;
 	let h4 = 3285377520;
-	const w = new Uint32Array(80);
+	const w = /* @__PURE__ */ new Uint32Array(80);
 	for (let off = 0; off < withPad.length; off += 64) {
 		for (let i = 0; i < 16; i++) w[i] = view.getUint32(off + i * 4, false);
 		for (let i = 16; i < 80; i++) {
@@ -261,7 +261,7 @@ function sha1(input) {
 		h3 = h3 + d >>> 0;
 		h4 = h4 + e >>> 0;
 	}
-	const out = new Uint8Array(20);
+	const out = /* @__PURE__ */ new Uint8Array(20);
 	new DataView(out.buffer).setUint32(0, h0, false);
 	new DataView(out.buffer).setUint32(4, h1, false);
 	new DataView(out.buffer).setUint32(8, h2, false);
@@ -322,7 +322,7 @@ function sha256(input) {
 		h[6] = h[6] + g | 0;
 		h[7] = h[7] + hh | 0;
 	}
-	const out = new Uint8Array(32);
+	const out = /* @__PURE__ */ new Uint8Array(32);
 	new DataView(out.buffer).setUint32(0, h[0] >>> 0);
 	for (let i = 0; i < 8; i++) new DataView(out.buffer).setUint32(i * 4, h[i] >>> 0);
 	return out;
@@ -409,15 +409,15 @@ var SHA512_K = [
 	6902733635092675308n,
 	7801388544844847127n
 ];
-var SHA512_KH = new Int32Array(80);
-var SHA512_KL = new Int32Array(80);
+var SHA512_KH = /* @__PURE__ */ new Int32Array(80);
+var SHA512_KL = /* @__PURE__ */ new Int32Array(80);
 for (let i = 0; i < 80; i++) {
 	SHA512_KH[i] = Number(SHA512_K[i] >> 32n & 4294967295n) | 0;
 	SHA512_KL[i] = Number(SHA512_K[i] & 4294967295n) | 0;
 }
 function sha512Core(iv, input, outLen) {
-	const hh = new Int32Array(8);
-	const hl = new Int32Array(8);
+	const hh = /* @__PURE__ */ new Int32Array(8);
+	const hl = /* @__PURE__ */ new Int32Array(8);
 	for (let i = 0; i < 8; i++) {
 		hh[i] = Number(iv[i] >> 32n & 4294967295n) | 0;
 		hl[i] = Number(iv[i] & 4294967295n) | 0;
@@ -431,8 +431,8 @@ function sha512Core(iv, input, outLen) {
 	const bits = len * 8;
 	view.setUint32(msg.length - 4, bits >>> 0, false);
 	view.setUint32(msg.length - 8, Math.floor(bits / 4294967296), false);
-	const wh = new Int32Array(80);
-	const wl = new Int32Array(80);
+	const wh = /* @__PURE__ */ new Int32Array(80);
+	const wl = /* @__PURE__ */ new Int32Array(80);
 	for (let off = 0; off < msg.length; off += 128) {
 		for (let i = 0; i < 16; i++) {
 			wh[i] = view.getInt32(off + i * 8, false);
@@ -527,7 +527,7 @@ function sha512Core(iv, input, outLen) {
 		add(6, gh, gl);
 		add(7, xh, xl);
 	}
-	const out = new Uint8Array(64);
+	const out = /* @__PURE__ */ new Uint8Array(64);
 	const ov = new DataView(out.buffer);
 	for (let i = 0; i < 8; i++) {
 		ov.setInt32(i * 8, hh[i], false);
@@ -561,8 +561,8 @@ function sha384(input) {
 }
 var AES = buildAesTables();
 function buildAesTables() {
-	const exp = new Uint8Array(256);
-	const log = new Uint8Array(256);
+	const exp = /* @__PURE__ */ new Uint8Array(256);
+	const log = /* @__PURE__ */ new Uint8Array(256);
 	let x = 1;
 	for (let i = 0; i < 255; i++) {
 		exp[i] = x;
@@ -570,8 +570,8 @@ function buildAesTables() {
 		x ^= x << 1 ^ (x & 128 ? 283 : 0);
 		x &= 255;
 	}
-	const sbox = new Uint8Array(256);
-	const inv = new Uint8Array(256);
+	const sbox = /* @__PURE__ */ new Uint8Array(256);
+	const inv = /* @__PURE__ */ new Uint8Array(256);
 	for (let i = 0; i < 256; i++) {
 		const invByte = i === 0 ? 0 : exp[(255 - log[i]) % 255];
 		let s = invByte;

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

@@ -5,4 +5,4 @@
  *
  * @packageDocumentation
  */
-export type { AbstractNumbering, Alignment, Border, BorderStyle, BodyElement, Comment, CellBorders, CellMerge, DocumentInfo, CellMargins, CellProperties, CellShading, CellDataBar, CellIcon, CellNoteFlag, CellIconShape, CellSparkline, Chart, ChartBlock, ChartDataPoint, ChartLineStyle, ChartMarker, ChartMarkerSymbol, ChartSeries, ChartType, CustomGeometry, CustomPathCmd, DocumentModel, FontFamilyMap, HeaderFooterReference, HeaderFooterType, ImageBlock, ImageCrop, InlineImage, MathAccent, MathBar, MathDelimiter, MathEqArray, MathFraction, MathFunc, MathGroupChr, MathLimit, MathMatrix, MathNary, MathNode, MathRadical, MathRow, MathRun, MathScript, Numbering, NumberingFormat, NumberingInstance, NumberingLevel, PictureBullet, PictureOutline, NumberingReference, PageMargins, PageSize, Paragraph, ParagraphProperties, FrameProperties, RelativeSize, TabStop, Run, RunProperties, TextOutline, Ligatures, RowConditionalFormat, RowProperties, Section, FloatAnchor, SectionColumns, SectionProperties, ShapeBlock, ShapeShadow, ShapeDash, ShapeFill, ShapeFillKind, ShapeGeometry, ShapeGroupChild, ShapeLine, LineEnd, ShapeTextBody, ShapeTransform, Style, StyleSheet, StyleType, Table, TableCell, TableLook, TableOverlay, 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, CellNoteFlag, CellIconShape, CellSparkline, Chart, ChartBlock, ChartDataLabels, ChartDataPoint, ChartLabelPosition, ChartLineStyle, ChartMarker, ChartMarkerSymbol, ChartSeries, ChartSurface, ChartTextStyle, ChartTextStyles, ChartType, CustomGeometry, CustomPathCmd, DocumentModel, FontFamilyMap, HeaderFooterReference, HeaderFooterType, ImageBlock, ImageCrop, InlineImage, MathAccent, MathBar, MathDelimiter, MathEqArray, MathFraction, MathFunc, MathGroupChr, MathLimit, MathMatrix, MathNary, MathNode, MathRadical, MathRow, MathRun, MathScript, Numbering, NumberingFormat, NumberingInstance, NumberingLevel, PictureBullet, PictureOutline, NumberingReference, PageMargins, PageSize, Paragraph, ParagraphProperties, FrameProperties, RelativeSize, TabStop, Run, RunProperties, TextOutline, Ligatures, RowConditionalFormat, RowProperties, Section, FloatAnchor, SectionColumns, SectionProperties, ShapeBlock, ShapeShadow, ShapeDash, ShapeFill, ShapeFillKind, ShapeGeometry, ShapeGroupChild, ShapeLine, LineEnd, ShapeTextBody, ShapeTransform, Style, StyleSheet, StyleType, Table, TableCell, TableLook, TableOverlay, TableProperties, TableStyleCondition, TableStyleConditionType, TableStyleLayer, TableRow, UnderlineStyle, VerticalAlign, } from './types.js';

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

@@ -1429,6 +1429,16 @@ export interface ChartSeries {
     readonly xValues?: ReadonlyArray<number>;
     readonly colorHex?: string;
     readonly pointColors?: ReadonlyArray<ChartDataPoint>;
+    /**
+     * §21.2.2.61 `c:explosion` — how far a pie's slices stand out from its
+     * centre, as a percentage of its radius: the series' own, and each point's
+     * (`c:dPt/c:explosion`) over it.
+     */
+    readonly explosion?: number;
+    readonly pointExplosions?: ReadonlyArray<{
+        readonly idx: number;
+        readonly percent: number;
+    }>;
     /**
      * §21.2.2.49 `c:dLbl/c:tx` — a data label the author typed rather than one
      * the chart computes, by point index. Excel and Calc print it verbatim: it
@@ -1440,6 +1450,19 @@ export interface ChartSeries {
         readonly idx: number;
         readonly text: string;
     }>;
+    /**
+     * §21.2.2.47 `c:dLbl` — where one point's label stands, when the point says:
+     * its own `c:dLblPos`, and the `c:layout/c:manualLayout` it was dragged to —
+     * `x` and `y` fractions of the chart, the label's own top-left corner where
+     * `edge`, else how far it moved from where the chart would set it.
+     */
+    readonly pointLabelPlacements?: ReadonlyArray<{
+        readonly idx: number;
+        readonly position?: ChartLabelPosition;
+        readonly x?: number;
+        readonly y?: number;
+        readonly edge?: boolean;
+    }>;
     /**
      * §21.2.2.59 `c:val/c:numRef/c:f` and §21.2.2.215 `c:tx/c:strRef/c:f` — where
      * the series reads its numbers and its name FROM, when the chart part carries
@@ -1489,10 +1512,76 @@ export interface ChartLineStyle {
     /** §20.1.10.49 `a:prstDash` — the rule's dash pattern, when it names one. */
     readonly dash?: ShapeDash;
 }
+/** A 3-D chart's wall or floor (§21.2.2.11, §21.2.2.69, §21.2.2.191): its fill and rule. */
+export interface ChartSurface {
+    /** `c:spPr/a:solidFill` — RRGGBB; absent, unfilled. */
+    readonly fillHex?: string;
+    /** `c:spPr/a:ln` — its rule, `{ none: true }` for `a:noFill`; absent, the default. */
+    readonly line?: ChartLineStyle;
+}
+/**
+ * §21.2.2.216 `c:txPr`, §21.2.2.156 `c:rich` — how one kind of a chart's text
+ * is set: the element's own run properties over the chart's (`c:chartSpace/
+ * c:txPr`) over the application's defaults, theme tokens resolved.
+ */
+export interface ChartTextStyle {
+    /** `a:latin@typeface` — the family, `+mn-lt`/`+mj-lt` already resolved. */
+    readonly family?: string;
+    /** `@sz`, in points. */
+    readonly sizePt?: number;
+    readonly bold?: boolean;
+    readonly italic?: boolean;
+    /** `a:solidFill` — the text colour as RRGGBB. */
+    readonly colorHex?: string;
+}
+/** A chart's text by role, each resolved through the cascade on its own. */
+export interface ChartTextStyles {
+    /** `c:chart/c:title`. */
+    readonly title?: ChartTextStyle;
+    /** `c:legend` — the entries. */
+    readonly legend?: ChartTextStyle;
+    /** The category axis's tick labels — a scatter's horizontal value axis. */
+    readonly catAxis?: ChartTextStyle;
+    /** The value axis's tick labels — a scatter's upright one. */
+    readonly valAxis?: ChartTextStyle;
+    /** The secondary value axis's tick labels. */
+    readonly secondaryValAxis?: ChartTextStyle;
+    readonly catAxisTitle?: ChartTextStyle;
+    readonly valAxisTitle?: ChartTextStyle;
+    readonly secondaryValAxisTitle?: ChartTextStyle;
+    /** `c:dLbls` — the values and labels printed on the data. */
+    readonly dataLabels?: ChartTextStyle;
+}
+/** §21.2.2.48 ST_DLblPos — where a data label stands against its point. */
+export type ChartLabelPosition = 'bestFit' | 'b' | 'ctr' | 'inBase' | 'inEnd' | 'l' | 'outEnd' | 'r' | 't';
+/**
+ * §21.2.2.49 `c:dLbls` — what a chart's data labels show and how their parts
+ * are joined: the chart group's switches, the first series' own over them.
+ */
+export interface ChartDataLabels {
+    readonly showVal?: boolean;
+    readonly showCatName?: boolean;
+    readonly showSerName?: boolean;
+    readonly showPercent?: boolean;
+    /** §21.2.2.166 `c:separator` — between the parts; absent, Excel's ", ". */
+    readonly separator?: string;
+    /** `c:dLbls/c:numFmt@formatCode`, when the labels have their own. */
+    readonly numberFormat?: string;
+    /** §21.2.2.48 `c:dLblPos` — where the labels stand. */
+    readonly position?: ChartLabelPosition;
+    /** §21.2.2.183 `c:showLeaderLines` — a label set off its slice is tied back to it. */
+    readonly showLeaderLines?: boolean;
+}
 /** A parsed chart (§21.2): its type, title, categories, series and rendering options. */
 export interface Chart {
     readonly type: ChartType;
     readonly title?: string;
+    /**
+     * The chart's text, role by role, as its application sets it. Absent when
+     * the reader resolves none: the renderer then keeps its own sizes and greys
+     * in the document's base face.
+     */
+    readonly text?: ChartTextStyles;
     readonly categories: ReadonlyArray<string>;
     /** §21.2.2.24 `c:cat/…/c:f` — where the categories live, when uncached. */
     readonly categoriesRef?: string;
@@ -1512,12 +1601,72 @@ export interface Chart {
     readonly barDir?: 'col' | 'bar';
     readonly grouping?: 'clustered' | 'stacked' | 'percentStacked' | 'standard';
     readonly doughnut?: boolean;
+    /**
+     * §21.2.2.140 `c:pie3DChart` with §21.2.2.228 `c:view3D` — a pie drawn as a
+     * tilted disc: `rotX` the elevation in degrees (90 looks straight down),
+     * `rotY` how far its first slice is turned clockwise from twelve o'clock.
+     */
+    readonly pie3D?: {
+        readonly rotX: number;
+        readonly rotY: number;
+    };
+    /**
+     * §21.2.2.15 `c:bar3DChart` with §21.2.2.228 `c:view3D` — bars drawn as
+     * boxes standing in a box of walls and a floor, seen at an angle with the
+     * axes kept square: `rotX` the elevation and `rotY` the turn in degrees,
+     * `depthPercent` a bar's depth as a percentage of its width, `gapDepth` the
+     * room before and behind it as a percentage of its depth.
+     */
+    readonly bar3D?: {
+        readonly rotX: number;
+        readonly rotY: number;
+        readonly depthPercent: number;
+        readonly gapDepth: number;
+    };
+    /**
+     * §21.2.2.69 `c:floor` — a 3-D chart's floor, the wall its bars stand on:
+     * its fill and its rule. Absent, it is unfilled and ruled in light grey.
+     */
+    readonly floor?: ChartSurface;
+    /** §21.2.2.11 `c:backWall` — the wall behind the bars; absent, nothing drawn. */
+    readonly backWall?: ChartSurface;
+    /** §21.2.2.191 `c:sideWall` — the wall beside them; absent, nothing drawn. */
+    readonly sideWall?: ChartSurface;
+    /** §21.2.2.68 `c:firstSliceAng` — a flat pie's first slice, degrees clockwise from twelve. */
+    readonly firstSliceAngle?: number;
+    /**
+     * §21.2.2.104 `c:plotArea/c:layout/c:manualLayout` in `edge` mode — the box
+     * the author sized the plot to, as fractions of the chart from its top
+     * left; a pie is fitted into it whole, keeping its shape.
+     */
+    readonly plotBox?: {
+        readonly x: number;
+        readonly y: number;
+        readonly w: number;
+        readonly h: number;
+        /**
+         * `c:layoutTarget` `inner` — the box is the plot's own rectangle, the
+         * axes' labels outside it; else (`outer`) it holds them too.
+         */
+        readonly inner?: boolean;
+    };
     readonly showValues?: boolean;
+    /**
+     * §21.2.2.49 — the data labels' switches, when the chart has a `c:dLbls` at
+     * all. Absent, it labels nothing.
+     */
+    readonly dataLabels?: ChartDataLabels;
     /**
      * §21.2.2.75 `c:gapWidth` — the gap between category slots as a percentage
      * of the bar width. Absent ⇒ the schema's 150.
      */
     readonly gapPercent?: number;
+    /**
+     * §21.2.2.131 `c:overlap` — how far the bars of one category's cluster lie
+     * over each other, as a percentage of a bar's width: −100 a bar's width
+     * apart … 100 one on the next. Absent ⇒ 0, bars side by side.
+     */
+    readonly overlapPercent?: number;
     readonly catAxisTitle?: string;
     /**
      * §21.2.2.134 `c:catAx/c:scaling/c:orientation` = `maxMin` — the category
@@ -1567,8 +1716,21 @@ export interface Chart {
     readonly valAxisLine?: ChartLineStyle;
     /** §21.2.2.196 — the secondary value axis's own rule. */
     readonly secondaryValAxisLine?: ChartLineStyle;
-    /** §21.2.2.87 `c:majorGridlines/c:spPr/a:ln` — the gridlines' own rule. */
+    /**
+     * §21.2.2.100 `c:majorGridlines` of the value axis (a scatter's upright one)
+     * — its own rule (§21.2.2.197 `c:spPr/a:ln`). An axis without the element
+     * rules nothing, which reads `{ none: true }`; absent, the default rule.
+     */
     readonly gridLine?: ChartLineStyle;
+    /** The same for a scatter's lying (x) axis. */
+    readonly xGridLine?: ChartLineStyle;
+    /**
+     * §21.2.2.40 `c:delete` — the author deleted the category axis (a scatter's
+     * x axis): neither its rule nor its labels are drawn, nor room kept for them.
+     */
+    readonly catAxisDeleted?: boolean;
+    /** §21.2.2.40 — …or the value axis (a scatter's upright one). */
+    readonly valAxisDeleted?: boolean;
     /**
      * §21.2.2.157 `c:valAx/c:scaling/c:min|c:max` — the value axis the AUTHOR
      * fixed. Absent means "auto", and only then is the range read off the data:
@@ -1578,10 +1740,20 @@ export interface Chart {
     readonly valAxisMin?: number;
     readonly valAxisMax?: number;
     /**
-     * §21.2.2.98 `c:valAx/c:majorUnit` — the step between the value axis's
+     * §21.2.2.103 `c:valAx/c:majorUnit` — the step between the value axis's
      * labels, when the author fixed it. Absent ⇒ the application's own choice.
      */
     readonly valAxisMajorUnit?: number;
+    /**
+     * §21.2.2.226 — a scatter's lying value axis, the x's: the ends and step the
+     * author fixed and its number format, as {@link Chart.valAxisMin},
+     * {@link Chart.valAxisMax}, {@link Chart.valAxisMajorUnit} and
+     * {@link Chart.numberFormat} are its upright one's.
+     */
+    readonly xAxisMin?: number;
+    readonly xAxisMax?: number;
+    readonly xAxisMajorUnit?: number;
+    readonly xNumberFormat?: string;
     /**
      * §21.2.2.198 `c:chartSpace/c:spPr` — the frame around the whole chart: its
      * background fill and its outline. Excel writes both on every chart it

package/dist/esm/core/drawingml/chart-geometry.d.ts

@@ -20,10 +20,14 @@ export interface ChartPolyline {
     readonly strokeHex: string;
     readonly widthPt: number;
 }
-/** A closed, filled polygon (area-chart bands). Drawn before strokes/labels. */
+/**
+ * A closed polygon: area-chart bands, the faces of 3-D bars, a 3-D chart's
+ * walls. Drawn before rectangles, strokes and labels; one without a fill is
+ * its outline alone.
+ */
 export interface ChartPolygon {
     readonly points: ReadonlyArray<readonly [number, number]>;
-    readonly fillHex: string;
+    readonly fillHex?: string;
     readonly strokeHex?: string;
     readonly widthPt?: number;
 }
@@ -44,7 +48,7 @@ export interface ChartWedge {
 /** How a {@link ChartLabel} sits horizontally relative to its anchor point. */
 export type LabelAlign = 'left' | 'center' | 'right';
 /** A text label (title, axis tick, category, data value, legend entry). */
-export interface ChartLabel {
+export interface ChartLabel extends ChartFont {
     readonly text: string;
     /** Anchor point; `align` says how text sits relative to it. */
     readonly x: number;
@@ -80,6 +84,11 @@ export interface ChartScene {
      * frame and under the gridlines.
      */
     readonly plotBackground?: ChartRect;
+    /**
+     * §21.2.2.69/§21.2.2.11/§21.2.2.191 — a 3-D chart's floor and walls, drawn
+     * over the plot's own fill and under its gridlines.
+     */
+    readonly walls?: ReadonlyArray<ChartPolygon>;
     /**
      * Major gridlines, drawn UNDER the plotted data. Kept apart from the other
      * polylines because z-order is the whole point: gridlines over the bars strip
@@ -88,12 +97,21 @@ export interface ChartScene {
      */
     readonly gridlines?: ReadonlyArray<ChartPolyline>;
 }
+/**
+ * The face a chart's text is set in beyond its size: the family the chart
+ * names (absent — the document's own) and its weight and slant.
+ */
+export interface ChartFont {
+    readonly family?: string;
+    readonly bold?: boolean;
+    readonly italic?: boolean;
+}
 /**
  * Injected text-width measurer: the rendered advance width (points) of `text` at
- * `sizePt`. Keeps this module free of any font/PDF dependency, so it is
- * unit-testable in isolation.
+ * `sizePt`, in `font` when the chart names one. Keeps this module free of any
+ * font/PDF dependency, so it is unit-testable in isolation.
  */
-export type MeasureText = (text: string, sizePt: number) => number;
+export type MeasureText = (text: string, sizePt: number, font?: ChartFont) => number;
 /** Font size (points) for axis ticks, category/data labels and legend text. */
 export declare const CHART_LABEL_PT = 9;
 /** Font size (points) for the chart title. */