reamkit 1.6.0 → 1.9.0

package/README.md

@@ -177,7 +177,19 @@ encryption, digital signatures (PKCS#7/ECDSA/PAdES/RFC 3161), SVG page
 preview, flowed HTML export, and **docx + xlsx output** (write WordprocessingML
 / SpreadsheetML back out, incl. round-trips). Reads OOXML Transitional and Strict.
 
-See `handoff.md` for the full feature matrix and known limitations.
+**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
+untagged one heuristically from glyph positions (lines, paragraphs, headings,
+and a clean two-column split). It lifts back the text (via each font's
+`/ToUnicode`), raster images (JPEG verbatim; PNG/Flate/LZW/CCITT-fax decoded and
+re-encoded), `/Link` hyperlinks, form-XObject content, and filled / stroked /
+gradient vector shapes. It reads modern compressed files (cross-reference + object
+streams) and encrypted ones (RC4 / AES — the user password is passed to
+`Ream.parse(bytes, { password })`, defaulting to the permissions-only case).
+
+See [`CHANGELOG.md`](./CHANGELOG.md) for the release history; the docs
+[**Scope**](https://reamkit.dev/guides/scope/) guide has the full feature matrix
+and known limitations.
 
 ## License
 

package/dist/esm/core/converter/ream.d.ts

@@ -10,6 +10,7 @@ import { SignatureOptions, StyledRenderOptions } from '../../pdf/index.js';
 export type ReamTarget = 'pdf' | 'svg' | 'html' | 'docx' | 'xlsx';
 export interface ReamParseOptions {
     readonly readers?: ReadonlyArray<DocumentReader<SourceDoc>>;
+    readonly password?: string;
 }
 export interface ReamConvertOptions extends Omit<StyledRenderOptions, 'registry' | 'styles'> {
     readonly fonts?: FontBytesByVariant;

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

@@ -30,7 +30,7 @@ var Ream = class Ream {
 		const readers = options.readers ?? DEFAULT_READERS;
 		const reader = readers.find((r) => r.sniff(bytes));
 		if (!reader) throw new Error(`Unrecognized document format (readers: ${readers.map((r) => r.id).join(", ")})`);
-		const { doc, losses } = reader.read(bytes);
+		const { doc, losses } = reader.read(bytes, { password: options.password });
 		const sheet = doc.kind === "sheet" ? doc : void 0;
 		return new Ream(toFlowDoc(doc), sheet, losses, bytes, reader.id);
 	}

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

@@ -1,4 +1,5 @@
 import { NativeBag, Pt, ResourceId } from '../ir/index.js';
+import { ShapeGradient } from '../vector.js';
 export type Alignment = 'left' | 'right' | 'center' | 'both' | 'distribute';
 export type UnderlineStyle = 'none' | 'single' | 'double' | 'thick' | 'dotted' | 'dottedHeavy' | 'dash' | 'dashHeavy' | 'wave';
 export type VerticalAlign = 'baseline' | 'superscript' | 'subscript';
@@ -346,10 +347,11 @@ export interface ShapeGeometry {
     readonly adjust?: ReadonlyMap<string, number>;
     readonly custom?: CustomGeometry;
 }
-export type ShapeFillKind = 'none' | 'solid';
+export type ShapeFillKind = 'none' | 'solid' | 'gradient';
 export interface ShapeFill {
     readonly kind: ShapeFillKind;
     readonly colorHex?: string;
+    readonly gradient?: ShapeGradient;
 }
 export type ShapeDash = 'solid' | 'dot' | 'dash' | 'dashDot' | 'lgDash' | 'lgDashDot' | 'sysDash' | 'sysDot';
 export interface ShapeLine {

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

@@ -0,0 +1,2 @@
+import { Chart } from '../document-model/index.js';
+export declare function chartSpaceXml(chart: Chart): string;

package/dist/esm/core/drawingml/chart-serializer.js

@@ -0,0 +1,53 @@
+//#region src/core/drawingml/chart-serializer.ts
+var C_NS = "http://schemas.openxmlformats.org/drawingml/2006/chart";
+var A_NS = "http://schemas.openxmlformats.org/drawingml/2006/main";
+var R_NS = "http://schemas.openxmlformats.org/officeDocument/2006/relationships";
+var GROUP_TAG = {
+	bar: "c:barChart",
+	line: "c:lineChart",
+	pie: "c:pieChart",
+	area: "c:areaChart",
+	scatter: "c:scatterChart",
+	unknown: "c:barChart"
+};
+var CAT_AX_ID = 111111111;
+var VAL_AX_ID = 222222222;
+function chartSpaceXml(chart) {
+	const isScatter = chart.type === "scatter";
+	const isPie = chart.type === "pie" || chart.doughnut === true;
+	const groupTag = chart.doughnut ? "c:doughnutChart" : GROUP_TAG[chart.type] ?? "c:barChart";
+	const inner = (chart.type === "bar" ? `<c:barDir val="${chart.barDir ?? "col"}"/>` : "") + (chart.grouping ? `<c:grouping val="${chart.grouping}"/>` : "") + "<c:varyColors val=\"0\"/>" + chart.series.map((s, i) => seriesXml(s, i, isScatter, chart.categories)).join("") + (chart.showValues ? "<c:dLbls><c:showVal val=\"1\"/></c:dLbls>" : "") + (chart.doughnut ? "<c:holeSize val=\"50\"/>" : "") + (isPie ? "" : `<c:axId val="${CAT_AX_ID}"/><c:axId val="${VAL_AX_ID}"/>`);
+	const axes = isPie ? "" : isScatter ? valAx(CAT_AX_ID, "b", VAL_AX_ID, chart.catAxisTitle) + valAx(VAL_AX_ID, "l", CAT_AX_ID, chart.valAxisTitle) : catAx(CAT_AX_ID, VAL_AX_ID, chart.catAxisTitle) + valAx(VAL_AX_ID, "l", CAT_AX_ID, chart.valAxisTitle);
+	return `<?xml version="1.0" encoding="UTF-8" standalone="yes"?><c:chartSpace xmlns:c="${C_NS}" xmlns:a="${A_NS}" xmlns:r="${R_NS}"><c:chart>` + titleXml(chart.title) + `<c:autoTitleDeleted val="${chart.title ? 0 : 1}"/><c:plotArea><c:layout/><${groupTag}>${inner}</${groupTag}>${axes}</c:plotArea>` + (chart.hasLegend ? `<c:legend><c:legendPos val="${chart.legendPos ?? "r"}"/><c:overlay val="0"/></c:legend>` : "") + "<c:plotVisOnly val=\"1\"/></c:chart></c:chartSpace>";
+}
+function seriesXml(s, idx, isScatter, categories) {
+	const tx = s.name ? `<c:tx><c:strRef><c:f>Sheet1!$A$${idx + 1}</c:f><c:strCache><c:ptCount val="1"/><c:pt idx="0"><c:v>${esc(s.name)}</c:v></c:pt></c:strCache></c:strRef></c:tx>` : "";
+	const spPr = s.colorHex ? `<c:spPr><a:solidFill><a:srgbClr val="${s.colorHex}"/></a:solidFill></c:spPr>` : "";
+	const dPts = (s.pointColors ?? []).map((p) => `<c:dPt><c:idx val="${p.idx}"/><c:bubble3D val="0"/><c:spPr><a:solidFill><a:srgbClr val="${p.colorHex}"/></a:solidFill></c:spPr></c:dPt>`).join("");
+	const cat = isScatter ? `<c:xVal>${numRef("A", s.xValues ?? [])}</c:xVal>` : categories.length > 0 ? `<c:cat>${strRef(categories)}</c:cat>` : "";
+	const val = isScatter ? `<c:yVal>${numRef("B", s.values)}</c:yVal>` : `<c:val>${numRef("B", s.values)}</c:val>`;
+	return `<c:ser><c:idx val="${idx}"/><c:order val="${idx}"/>` + tx + spPr + dPts + cat + val + "</c:ser>";
+}
+function strRef(values) {
+	const pts = values.map((v, i) => `<c:pt idx="${i}"><c:v>${esc(v)}</c:v></c:pt>`).join("");
+	return `<c:strRef><c:f>Sheet1!\$A\$1</c:f><c:strCache><c:ptCount val="${values.length}"/>${pts}</c:strCache></c:strRef>`;
+}
+function numRef(col, values) {
+	const pts = values.map((v, i) => `<c:pt idx="${i}"><c:v>${v}</c:v></c:pt>`).join("");
+	return `<c:numRef><c:f>Sheet1!$${col}$1</c:f><c:numCache><c:formatCode>General</c:formatCode><c:ptCount val="${values.length}"/>${pts}</c:numCache></c:numRef>`;
+}
+function titleXml(title) {
+	if (!title) return "";
+	return `<c:title><c:tx><c:rich><a:bodyPr/><a:lstStyle/><a:p><a:r><a:t>${esc(title)}</a:t></a:r></a:p></c:rich></c:tx><c:overlay val="0"/></c:title>`;
+}
+function catAx(id, crossId, title) {
+	return `<c:catAx><c:axId val="${id}"/><c:scaling><c:orientation val="minMax"/></c:scaling><c:delete val="0"/><c:axPos val="b"/>${titleXml(title)}<c:crossAx val="${crossId}"/></c:catAx>`;
+}
+function valAx(id, pos, crossId, title) {
+	return `<c:valAx><c:axId val="${id}"/><c:scaling><c:orientation val="minMax"/></c:scaling><c:delete val="0"/><c:axPos val="${pos}"/>${titleXml(title)}<c:crossAx val="${crossId}"/></c:valAx>`;
+}
+function esc(s) {
+	return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+}
+//#endregion
+export { chartSpaceXml };

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

@@ -1,8 +1,10 @@
 import { ShapeGeometry, ShapeLine } from '../document-model/index.js';
-import { StrokeStyle, VectorPath } from '../vector.js';
+import { ShapeGradient, StrokeStyle, VectorPath } from '../vector.js';
 export declare const EMU_PER_PT = 12700;
 export declare const DEFAULT_INSET_LR_PT: number;
 export declare const DEFAULT_INSET_TB_PT: number;
 export declare function buildShapePaths(geometry: ShapeGeometry, widthPt: number, heightPt: number): Array<VectorPath>;
+export declare function gradientToSolid(gradient: ShapeGradient): string;
+export declare function gradientSvgDef(id: string, g: ShapeGradient): string;
 export declare function buildStroke(line: ShapeLine | undefined): StrokeStyle | undefined;
 export declare function buildShapeTransform(pageX: number, pageY: number, widthPt: number, heightPt: number, rotation60k: number, flipH: boolean, flipV: boolean): [number, number, number, number, number, number];

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

@@ -9,6 +9,32 @@ function buildShapePaths(geometry, widthPt, heightPt) {
 	if (geometry.custom) return customPaths(geometry.custom, widthPt, heightPt);
 	return [rectPath(widthPt, heightPt)];
 }
+function gradientToSolid(gradient) {
+	let r = 0;
+	let g = 0;
+	let b = 0;
+	let n = 0;
+	for (const stop of gradient.stops) {
+		const num = parseInt(stop.colorHex, 16);
+		if (Number.isNaN(num)) continue;
+		r += num >> 16 & 255;
+		g += num >> 8 & 255;
+		b += num & 255;
+		n++;
+	}
+	if (n === 0) return "000000";
+	const hx = (x) => Math.round(x / n).toString(16).padStart(2, "0");
+	return (hx(r) + hx(g) + hx(b)).toUpperCase();
+}
+function gradientSvgDef(id, g) {
+	const n = (x) => String(Math.round(x * 1e4) / 1e4);
+	const stops = g.stops.map((s) => `<stop offset="${n(s.offset)}" stop-color="#${s.colorHex}"/>`).join("");
+	if (g.kind === "radial") return `<radialGradient id="${id}">${stops}</radialGradient>`;
+	const rad = -(g.angle ?? 0) * Math.PI / 180;
+	const dx = Math.cos(rad) / 2;
+	const dy = Math.sin(rad) / 2;
+	return `<linearGradient id="${id}" x1="${n(.5 - dx)}" y1="${n(.5 - dy)}" x2="${n(.5 + dx)}" y2="${n(.5 + dy)}">${stops}</linearGradient>`;
+}
 function buildStroke(line) {
 	if (!line || line.fill === "none") return void 0;
 	const widthPt = line.width ?? DEFAULT_LINE_WIDTH_EMU / 12700;
@@ -68,4 +94,4 @@ function buildShapeTransform(pageX, pageY, widthPt, heightPt, rotation60k, flipH
 	];
 }
 //#endregion
-export { DEFAULT_INSET_LR_PT, DEFAULT_INSET_TB_PT, buildShapePaths, buildShapeTransform, buildStroke };
+export { DEFAULT_INSET_LR_PT, DEFAULT_INSET_TB_PT, buildShapePaths, buildShapeTransform, buildStroke, gradientSvgDef, gradientToSolid };

package/dist/esm/core/vector.d.ts

@@ -28,9 +28,19 @@ export interface StrokeStyle {
     readonly join?: 'miter' | 'round' | 'bevel';
     readonly dash?: ReadonlyArray<number>;
 }
+export interface GradientStop {
+    readonly offset: number;
+    readonly colorHex: string;
+}
+export interface ShapeGradient {
+    readonly kind: 'linear' | 'radial';
+    readonly angle?: number;
+    readonly stops: ReadonlyArray<GradientStop>;
+}
 export interface VectorShape {
     readonly paths: ReadonlyArray<VectorPath>;
     readonly fillColorHex?: string;
+    readonly fillGradient?: ShapeGradient;
     readonly stroke?: StrokeStyle;
     readonly transform: readonly [number, number, number, number, number, number];
 }

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

@@ -309,9 +309,12 @@ function worksheetToBody(worksheet, sharedStrings, styles, date1904, print) {
 		const local = brk - colStart;
 		if (local > 0 && local < colCount) colBreaksLocal.add(local);
 	}
-	if (!scaled && colCount > 1 && (totalGridTwips > contentWidthTwips || colBreaksLocal.size > 0)) {
-		const bands = computeColumnBands(columnWidths, contentWidthTwips, colBreaksLocal);
-		if (bands.length > 1) return bandedTables(rows, columnWidths, bands, tableProperties);
+	const fitWide = worksheet.fitToPage ? worksheet.pageSetup?.fitToWidth ?? 1 : 1;
+	const bandWidths = scaled ? columnWidths.map((w) => Math.max(1, Math.floor(w * printScale))) : columnWidths;
+	const bandTotal = bandWidths.reduce((sum, w) => sum + w, 0);
+	if (colCount > 1 && (!scaled || fitWide > 1) && (bandTotal > contentWidthTwips || colBreaksLocal.size > 0)) {
+		const bands = computeColumnBands(bandWidths, contentWidthTwips, colBreaksLocal);
+		if (bands.length > 1) return bandedTables(rows, bandWidths, bands, tableProperties);
 	}
 	const frozen = worksheet.pane && (worksheet.pane.frozenRows > 0 || worksheet.pane.frozenCols > 0) ? {
 		rows: worksheet.pane.frozenRows,

package/dist/esm/excel/xlsx-writer.js

@@ -1,13 +1,22 @@
 import { FEATURES } from "../core/ir/features.js";
 import { buildOpcPackage } from "../core/opc/opc-writer.js";
 import "../core/opc/index.js";
+import { chartSpaceXml } from "../core/drawingml/chart-serializer.js";
 //#region src/excel/xlsx-writer.ts
 var encoder = new TextEncoder();
+var EMU_PER_PT = 12700;
 var REL_OFFICE_DOCUMENT = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/officeDocument";
 var REL_WORKSHEET = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/worksheet";
 var REL_SHARED_STRINGS = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/sharedStrings";
 var REL_STYLES = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/styles";
 var REL_TABLE = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/table";
+var REL_DRAWING = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/drawing";
+var REL_CHART = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/chart";
+var CT_DRAWING = "application/vnd.openxmlformats-officedocument.drawing+xml";
+var CT_CHART = "application/vnd.openxmlformats-officedocument.drawingml.chart+xml";
+var XDR_NS = "http://schemas.openxmlformats.org/drawingml/2006/spreadsheetDrawing";
+var A_NS = "http://schemas.openxmlformats.org/drawingml/2006/main";
+var C_NS = "http://schemas.openxmlformats.org/drawingml/2006/chart";
 var CT_WORKBOOK = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet.main+xml";
 var CT_WORKSHEET = "application/vnd.openxmlformats-officedocument.spreadsheetml.worksheet+xml";
 var CT_SHARED_STRINGS = "application/vnd.openxmlformats-officedocument.spreadsheetml.sharedStrings+xml";
@@ -19,16 +28,20 @@ function writeXlsx(sheet) {
 	const losses = [];
 	const worksheetParts = [];
 	const tableParts = [];
+	const drawingParts = [];
 	const worksheetRels = [];
+	const drawingRels = [];
 	const sheetEntries = [];
 	const workbookRels = [];
 	let tableCounter = 0;
+	let drawingCounter = 0;
+	let chartCounter = 0;
 	sheet.sheets.forEach((s, i) => {
 		const idx = i + 1;
 		const rid = `rId${idx}`;
 		const wsPath = `xl/worksheets/sheet${idx}.xml`;
+		const wsRels = [];
 		const tableRelIds = [];
-		const wsTableRels = [];
 		for (const t of s.grid.tables ?? []) {
 			const tid = ++tableCounter;
 			const tRid = `rIdTbl${tid}`;
@@ -38,15 +51,23 @@ function writeXlsx(sheet) {
 				data: encoder.encode(tableXml(t, tid)),
 				contentType: CT_TABLE
 			});
-			wsTableRels.push(rel(tRid, REL_TABLE, `../tables/table${tid}.xml`));
+			wsRels.push(rel(tRid, REL_TABLE, `../tables/table${tid}.xml`));
 		}
-		if (wsTableRels.length > 0) worksheetRels.push({
+		const drawingRelId = emitSheetCharts(s, sheet, idx, {
+			drawingParts,
+			drawingRels,
+			wsRels,
+			nextDrawing: () => ++drawingCounter,
+			nextChart: () => ++chartCounter,
+			losses
+		});
+		if (wsRels.length > 0) worksheetRels.push({
 			sourcePart: wsPath,
-			relationships: wsTableRels
+			relationships: wsRels
 		});
 		worksheetParts.push({
 			path: wsPath,
-			data: encoder.encode(worksheetXml(s.grid, tableRelIds)),
+			data: encoder.encode(worksheetXml(s.grid, tableRelIds, drawingRelId)),
 			contentType: CT_WORKSHEET
 		});
 		workbookRels.push(rel(rid, REL_WORKSHEET, `worksheets/sheet${idx}.xml`));
@@ -55,7 +76,6 @@ function writeXlsx(sheet) {
 			sheetId: idx,
 			rid
 		});
-		recordSheetLosses(s, losses);
 	});
 	const sstRid = `rId${sheet.sheets.length + 1}`;
 	const stylesRid = `rId${sheet.sheets.length + 2}`;
@@ -71,6 +91,7 @@ function writeXlsx(sheet) {
 				},
 				...worksheetParts,
 				...tableParts,
+				...drawingParts,
 				{
 					path: "xl/sharedStrings.xml",
 					data: encoder.encode(sharedStringsXml(sheet.sharedStrings)),
@@ -83,10 +104,14 @@ function writeXlsx(sheet) {
 				}
 			],
 			rootRelationships: [rel("rId1", REL_OFFICE_DOCUMENT, "xl/workbook.xml")],
-			partRelationships: [{
-				sourcePart: "xl/workbook.xml",
-				relationships: workbookRels
-			}, ...worksheetRels]
+			partRelationships: [
+				{
+					sourcePart: "xl/workbook.xml",
+					relationships: workbookRels
+				},
+				...worksheetRels,
+				...drawingRels
+			]
 		}),
 		losses
 	};
@@ -100,19 +125,58 @@ function rel(id, type, target) {
 		targetMode: "Internal"
 	};
 }
-function recordSheetLosses(s, losses) {
-	if (s.charts && s.charts.length > 0) losses.push({
-		severity: "dropped",
-		feature: FEATURES.charts,
-		detail: `sheet "${s.name}": embedded charts not written back`
+function emitSheetCharts(s, doc, idx, ctx) {
+	const refs = s.charts ?? [];
+	if (refs.length === 0 || !doc.chartData) return void 0;
+	const did = ctx.nextDrawing();
+	const drawingPath = `xl/drawings/drawing${did}.xml`;
+	const anchors = [];
+	const dRels = [];
+	refs.forEach((ref, ci) => {
+		const chart = doc.chartData?.get(ref.chartPartPath);
+		if (!chart) {
+			ctx.losses.push({
+				severity: "dropped",
+				feature: FEATURES.charts,
+				detail: `sheet "${s.name}": a chart frame had no resolved data and was dropped`
+			});
+			return;
+		}
+		const cid = ctx.nextChart();
+		ctx.drawingParts.push({
+			path: `xl/charts/chart${cid}.xml`,
+			data: encoder.encode(chartSpaceXml(chart)),
+			contentType: CT_CHART
+		});
+		const cRel = `rIdChart${ci + 1}`;
+		dRels.push(rel(cRel, REL_CHART, `../charts/chart${cid}.xml`));
+		anchors.push(chartAnchorXml(ref, cRel, ci));
+	});
+	if (anchors.length === 0) return void 0;
+	ctx.drawingParts.push({
+		path: drawingPath,
+		data: encoder.encode(`${XML_DECL}<xdr:wsDr xmlns:xdr="${XDR_NS}" xmlns:a="${A_NS}">${anchors.join("")}</xdr:wsDr>`),
+		contentType: CT_DRAWING
 	});
+	ctx.drawingRels.push({
+		sourcePart: drawingPath,
+		relationships: dRels
+	});
+	const dRid = `rIdDraw${idx}`;
+	ctx.wsRels.push(rel(dRid, REL_DRAWING, `../drawings/drawing${did}.xml`));
+	return dRid;
+}
+function chartAnchorXml(ref, chartRelId, index) {
+	const cx = Math.round(ref.widthPt * EMU_PER_PT);
+	const cy = Math.round(ref.heightPt * EMU_PER_PT);
+	return `<xdr:oneCellAnchor><xdr:from><xdr:col>0</xdr:col><xdr:colOff>0</xdr:colOff><xdr:row>${index * 16}</xdr:row><xdr:rowOff>0</xdr:rowOff></xdr:from><xdr:ext cx="${cx}" cy="${cy}"/><xdr:graphicFrame macro=""><xdr:nvGraphicFramePr><xdr:cNvPr id="${index + 2}" name="Chart ${index + 1}"/><xdr:cNvGraphicFramePr/></xdr:nvGraphicFramePr><xdr:xfrm><a:off x="0" y="0"/><a:ext cx="${cx}" cy="${cy}"/></xdr:xfrm><a:graphic><a:graphicData uri="${C_NS}"><c:chart xmlns:c="${C_NS}" xmlns:r="${R_NS}" r:id="${chartRelId}"/></a:graphicData></a:graphic></xdr:graphicFrame><xdr:clientData/></xdr:oneCellAnchor>`;
 }
 function workbookXml(sheets, definedNames, date1904) {
 	const sheetTags = sheets.map((s) => `<sheet name="${escapeAttr(s.name)}" sheetId="${s.sheetId}" r:id="${s.rid}"/>`).join("");
 	const definedNamesXml = definedNames.length > 0 ? `<definedNames>${definedNames.map((d) => `<definedName name="${escapeAttr(d.name)}"${d.localSheetId !== void 0 ? ` localSheetId="${d.localSheetId}"` : ""}>${escapeText(d.value)}</definedName>`).join("")}</definedNames>` : "";
 	return XML_DECL + `<workbook xmlns="${MAIN_NS}" xmlns:r="${R_NS}">` + (date1904 ? "<workbookPr date1904=\"1\"/>" : "") + `<sheets>${sheetTags}</sheets>` + definedNamesXml + "</workbook>";
 }
-function worksheetXml(grid, tableRelIds = []) {
+function worksheetXml(grid, tableRelIds = [], drawingRelId) {
 	const dimension = grid.maxRow >= 0 && grid.maxColumn >= 0 ? `<dimension ref="A1:${cellRef(grid.maxRow, grid.maxColumn)}"/>` : "<dimension ref=\"A1\"/>";
 	const colsXml = grid.columns.length > 0 ? `<cols>${grid.columns.map((c) => `<col min="${c.min}" max="${c.max}" width="${c.widthChars}" customWidth="1"/>`).join("")}</cols>` : "";
 	const heightByRow = /* @__PURE__ */ new Map();
@@ -136,7 +200,7 @@ function worksheetXml(grid, tableRelIds = []) {
 		return `<row r="${r + 1}"${heightAttrs}>${cells.map(cellXml).join("")}</row>`;
 	}).join("");
 	const mergesXml = grid.merges.length > 0 ? `<mergeCells count="${grid.merges.length}">${grid.merges.map((m) => `<mergeCell ref="${cellRef(m.startRow, m.startColumn)}:${cellRef(m.endRow, m.endColumn)}"/>`).join("")}</mergeCells>` : "";
-	return XML_DECL + `<worksheet xmlns="${MAIN_NS}" xmlns:r="${R_NS}">` + (grid.fitToPage ? "<sheetPr><pageSetUpPr fitToPage=\"1\"/></sheetPr>" : "") + dimension + sheetViewsXml(grid.pane) + colsXml + `<sheetData>${rowsXml}</sheetData>` + mergesXml + conditionalFormattingXml(grid.conditionalFormats) + printOptionsXml(grid.printOptions) + pageMarginsXml(grid.pageMargins) + pageSetupXml(grid.pageSetup) + breaksXml("rowBreaks", grid.rowBreaks) + breaksXml("colBreaks", grid.colBreaks) + (tableRelIds.length > 0 ? `<tableParts count="${tableRelIds.length}">${tableRelIds.map((id) => `<tablePart r:id="${id}"/>`).join("")}</tableParts>` : "") + sparklineExtXml(grid.sparklines) + "</worksheet>";
+	return XML_DECL + `<worksheet xmlns="${MAIN_NS}" xmlns:r="${R_NS}">` + (grid.fitToPage ? "<sheetPr><pageSetUpPr fitToPage=\"1\"/></sheetPr>" : "") + dimension + sheetViewsXml(grid.pane) + colsXml + `<sheetData>${rowsXml}</sheetData>` + mergesXml + conditionalFormattingXml(grid.conditionalFormats) + printOptionsXml(grid.printOptions) + pageMarginsXml(grid.pageMargins) + pageSetupXml(grid.pageSetup) + breaksXml("rowBreaks", grid.rowBreaks) + breaksXml("colBreaks", grid.colBreaks) + (drawingRelId ? `<drawing r:id="${drawingRelId}"/>` : "") + (tableRelIds.length > 0 ? `<tableParts count="${tableRelIds.length}">${tableRelIds.map((id) => `<tablePart r:id="${id}"/>`).join("")}</tableParts>` : "") + sparklineExtXml(grid.sparklines) + "</worksheet>";
 }
 function sheetViewsXml(pane) {
 	if (!pane || pane.frozenRows <= 0 && pane.frozenCols <= 0) return "";

package/dist/esm/html/html-writer.js

@@ -6,7 +6,7 @@ import { PathBuilder, flipTransform, svgPathData } from "../core/vector.js";
 import { buildSparkline } from "../core/drawingml/sparkline-geometry.js";
 import { arcPoint, arcToBeziers } from "../core/arc-to-bezier.js";
 import { buildChartScene } from "../core/drawingml/chart-geometry.js";
-import { buildShapePaths, buildShapeTransform, buildStroke } from "../core/drawingml/shape-render.js";
+import { buildShapePaths, buildShapeTransform, buildStroke, gradientSvgDef } from "../core/drawingml/shape-render.js";
 import { sanitizeHref } from "../core/links.js";
 import { toBase64 } from "../core/bytes.js";
 //#region src/html/html-writer.ts
@@ -209,11 +209,13 @@ function emitShapeBlock(out, shape, ctx) {
 	const w = shape.width;
 	const h = shape.height;
 	const paths = buildShapePaths(shape.geometry, w, h);
-	const fill = shape.fill.kind === "solid" && shape.fill.colorHex ? `#${shape.fill.colorHex}` : "none";
+	const gradDef = shape.fill.kind === "gradient" && shape.fill.gradient ? gradientSvgDef("grad0", shape.fill.gradient) : void 0;
+	const fill = gradDef ? "url(#grad0)" : shape.fill.kind === "solid" && shape.fill.colorHex ? `#${shape.fill.colorHex}` : "none";
 	const stroke = strokeAttrs(buildStroke(shape.line));
 	const t = shape.transform;
 	const transform = ` transform="matrix(${flipTransform(buildShapeTransform(0, 0, w, h, t?.rotation60k ?? 0, t?.flipH ?? false, t?.flipV ?? false), h).map(fmt).join(" ")})"`;
 	const svg = [svgOpen(w, h, shape.altText)];
+	if (gradDef) svg.push(`<defs>${gradDef}</defs>`);
 	for (const path of paths) {
 		const rule = path.fillRule === "evenodd" ? " fill-rule=\"evenodd\"" : "";
 		svg.push(`<path d="${svgPathData(path.segments, fmt)}" fill="${fill}"${rule}${stroke}${transform}/>`);

package/dist/esm/layout/styled-layout.js

@@ -17,7 +17,7 @@ import { arcPoint, arcToBeziers } from "../core/arc-to-bezier.js";
 import { buildChartScene } from "../core/drawingml/chart-geometry.js";
 import { layoutMath, mathGlyphSegments, variantStyle } from "./math-layout.js";
 import { rectPath } from "../core/drawingml/preset-geometry.js";
-import { buildShapePaths, buildShapeTransform, buildStroke } from "../core/drawingml/shape-render.js";
+import { buildShapePaths, buildShapeTransform, buildStroke, gradientToSolid } from "../core/drawingml/shape-render.js";
 import { StructTreeBuilder } from "../pdf/struct-tree.js";
 //#region src/layout/styled-layout.ts
 function parsePdfAProfile(pdfA) {
@@ -454,7 +454,8 @@ function layoutShapeBlock(shape, options, fontResources, imageResources, content
 		heightPt = maxHeight;
 	}
 	const paths = buildShapePaths(shape.geometry, widthPt, heightPt);
-	const fillColorHex = shape.fill.kind === "solid" ? shape.fill.colorHex : void 0;
+	const fillGradient = shape.fill.kind === "gradient" ? shape.fill.gradient : void 0;
+	const fillColorHex = shape.fill.kind === "solid" ? shape.fill.colorHex : fillGradient ? gradientToSolid(fillGradient) : void 0;
 	const stroke = buildStroke(shape.line);
 	const t = shape.transform;
 	const pp = shape.paragraphProperties;
@@ -483,6 +484,7 @@ function layoutShapeBlock(shape, options, fontResources, imageResources, content
 		heightPt,
 		paths,
 		...fillColorHex ? { fillColorHex } : {},
+		...fillGradient ? { fillGradient } : {},
 		...stroke ? { stroke } : {},
 		rotation60k: t?.rotation60k ?? 0,
 		flipH: t?.flipH ?? false,
@@ -2013,6 +2015,7 @@ function paginateSections(blocks, sectionCtxs, builder, defaultLang = "en-US", n
 					shape: {
 						paths: block.paths,
 						...block.fillColorHex ? { fillColorHex: block.fillColorHex } : {},
+						...block.fillGradient ? { fillGradient: block.fillGradient } : {},
 						...block.stroke ? { stroke: block.stroke } : {},
 						transform
 					},

package/dist/esm/pdf/shading.d.ts

@@ -0,0 +1,12 @@
+import { ShapeGradient, VectorShape } from '../core/vector.js';
+import { PdfRef } from './objects.js';
+import { PdfDocument } from './writer.js';
+interface Bbox {
+    readonly minX: number;
+    readonly minY: number;
+    readonly maxX: number;
+    readonly maxY: number;
+}
+export declare function shapeBbox(shape: VectorShape): Bbox | undefined;
+export declare function buildGradientPattern(doc: PdfDocument, gradient: ShapeGradient, bbox: Bbox, ctm: readonly [number, number, number, number, number, number]): PdfRef;
+export {};

package/dist/esm/pdf/shading.js

@@ -0,0 +1,152 @@
+import { dict, name, ref } from "./objects.js";
+//#region src/pdf/shading.ts
+function shapeBbox(shape) {
+	let minX = Infinity;
+	let minY = Infinity;
+	let maxX = -Infinity;
+	let maxY = -Infinity;
+	const add = (x, y) => {
+		minX = Math.min(minX, x);
+		minY = Math.min(minY, y);
+		maxX = Math.max(maxX, x);
+		maxY = Math.max(maxY, y);
+	};
+	for (const path of shape.paths) for (const seg of path.segments) if (seg.op === "move" || seg.op === "line") add(seg.x, seg.y);
+	else if (seg.op === "cubic") {
+		add(seg.x1, seg.y1);
+		add(seg.x2, seg.y2);
+		add(seg.x, seg.y);
+	}
+	return Number.isFinite(minX) && maxX > minX && maxY > minY ? {
+		minX,
+		minY,
+		maxX,
+		maxY
+	} : void 0;
+}
+function buildGradientPattern(doc, gradient, bbox, ctm) {
+	const fnRef = doc.add(buildRamp(gradient.stops));
+	const shading = gradient.kind === "radial" ? radialShading(bbox, fnRef) : axialShading(gradient.angle ?? 0, bbox, fnRef);
+	return doc.add(dict({
+		Type: name("Pattern"),
+		PatternType: 2,
+		Shading: shading,
+		Matrix: [...ctm]
+	}));
+}
+function axialShading(angleDeg, b, fnRef) {
+	const rad = angleDeg * Math.PI / 180;
+	const dx = Math.cos(rad);
+	const dy = -Math.sin(rad);
+	const cx = (b.minX + b.maxX) / 2;
+	const cy = (b.minY + b.maxY) / 2;
+	const cproj = cx * dx + cy * dy;
+	let tmin = Infinity;
+	let tmax = -Infinity;
+	for (const [x, y] of [
+		[b.minX, b.minY],
+		[b.maxX, b.minY],
+		[b.minX, b.maxY],
+		[b.maxX, b.maxY]
+	]) {
+		const t = x * dx + y * dy;
+		tmin = Math.min(tmin, t);
+		tmax = Math.max(tmax, t);
+	}
+	return dict({
+		ShadingType: 2,
+		ColorSpace: name("DeviceRGB"),
+		Coords: [
+			cx + (tmin - cproj) * dx,
+			cy + (tmin - cproj) * dy,
+			cx + (tmax - cproj) * dx,
+			cy + (tmax - cproj) * dy
+		],
+		Function: ref(fnRef.id),
+		Extend: [true, true]
+	});
+}
+function radialShading(b, fnRef) {
+	const cx = (b.minX + b.maxX) / 2;
+	const cy = (b.minY + b.maxY) / 2;
+	const r = Math.hypot(b.maxX - b.minX, b.maxY - b.minY) / 2;
+	return dict({
+		ShadingType: 3,
+		ColorSpace: name("DeviceRGB"),
+		Coords: [
+			cx,
+			cy,
+			0,
+			cx,
+			cy,
+			r
+		],
+		Function: ref(fnRef.id),
+		Extend: [true, true]
+	});
+}
+function buildRamp(stopsIn) {
+	const stops = normalizeStops(stopsIn);
+	if (stops.length <= 2) return dict({
+		FunctionType: 2,
+		Domain: [0, 1],
+		C0: rgb01(stops[0].colorHex),
+		C1: rgb01(stops[stops.length - 1].colorHex),
+		N: 1
+	});
+	const functions = [];
+	const bounds = [];
+	const encode = [];
+	for (let i = 0; i < stops.length - 1; i++) {
+		functions.push(dict({
+			FunctionType: 2,
+			Domain: [0, 1],
+			C0: rgb01(stops[i].colorHex),
+			C1: rgb01(stops[i + 1].colorHex),
+			N: 1
+		}));
+		if (i > 0) bounds.push(stops[i].offset);
+		encode.push(0, 1);
+	}
+	return dict({
+		FunctionType: 3,
+		Domain: [0, 1],
+		Functions: functions,
+		Bounds: bounds,
+		Encode: encode
+	});
+}
+function normalizeStops(stops) {
+	const out = stops.map((s) => ({
+		offset: Math.max(0, Math.min(1, s.offset)),
+		colorHex: s.colorHex
+	})).sort((a, b) => a.offset - b.offset);
+	if (out.length === 0) return [{
+		offset: 0,
+		colorHex: "000000"
+	}];
+	out[0] = {
+		offset: 0,
+		colorHex: out[0].colorHex
+	};
+	out[out.length - 1] = {
+		offset: 1,
+		colorHex: out[out.length - 1].colorHex
+	};
+	return out;
+}
+function rgb01(hex) {
+	const n = parseInt(hex, 16);
+	if (Number.isNaN(n)) return [
+		0,
+		0,
+		0
+	];
+	return [
+		(n >> 16 & 255) / 255,
+		(n >> 8 & 255) / 255,
+		(n & 255) / 255
+	];
+}
+//#endregion
+export { buildGradientPattern, shapeBbox };