reamkit 1.1.0 → 1.3.0

package/README.md

@@ -85,7 +85,9 @@ are always used first — glyph-exact, no substitution.
 ### Archival PDF/A + embedded source
 
 The whole PDF/A family is supported (1a/1b, 2a/2b/2u, 3a/3b/3u —
-veraPDF-validated). PDF/A-3 can carry the source document inside the PDF:
+veraPDF-validated), plus accessible **PDF/UA-1** (`pdfUA: true`, also
+veraPDF-validated and combinable with PDF/A in one file). PDF/A-3 can carry
+the source document inside the PDF:
 
 ```ts
 const { bytes: pdfa, losses } = await doc.convertWithReport('pdf', {
@@ -157,14 +159,18 @@ automatically from the document's `docProps/core.xml`), `attachments`
 
 ## Scope
 
-Implemented: WordprocessingML text/styles/tables/lists/multi-section
-layout/headers-footers/images/tracked changes, SpreadsheetML grids,
+Implemented: WordprocessingML text/styles/tables (incl. table styles)/lists/
+multi-section and multi-column layout/headers-footers (incl. PAGE/NUMPAGES
+fields)/footnotes and endnotes/hyperlinks and bookmarks/floating drawings/
+images/tracked changes, SpreadsheetML grids,
 number formats and the print model (gridlines, print area, fit-to-page,
 repeated titles, page breaks), DrawingML shapes and charts, OMML math,
 Type0+CIDFontType2 embedding with subsetting, Knuth-Plass line breaking,
 Liang hyphenation, OpenType ligatures/kerning + Arabic cursive joining,
-BiDi (UAX #9), tagged PDF, PDF/A-1/2/3 (a/b/u), digital signatures
-(PKCS#7/ECDSA/PAdES/RFC 3161), SVG page preview, flowed HTML export.
+BiDi (UAX #9), hyperlinks (PDF link annotations + HTML anchors,
+scheme-allowlisted), tagged PDF, PDF/A-1/2/3 (a/b/u), PDF/UA-1, AES-256
+encryption, digital signatures (PKCS#7/ECDSA/PAdES/RFC 3161), SVG page
+preview, flowed HTML export. Reads OOXML Transitional and Strict.
 
 See `handoff.md` for the full feature matrix and known limitations.
 

package/dist/esm/{layout → core}/arc-to-bezier.d.ts

@@ -1,4 +1,4 @@
-import { PathSegment } from '../core/vector.js';
+import { PathSegment } from './vector.js';
 export declare function arcPoint(cx: number, cy: number, rx: number, ry: number, angleRad: number): readonly [number, number];
 export declare function arcToBeziers(cx: number, cy: number, rx: number, ry: number, startAngleRad: number, sweepAngleRad: number): Array<PathSegment>;
 export declare function ellipseSegments(w: number, h: number): ReadonlyArray<PathSegment>;

package/dist/esm/{layout → core}/arc-to-bezier.js

@@ -1,5 +1,5 @@
-import { PathBuilder } from "../core/vector.js";
-//#region src/layout/arc-to-bezier.ts
+import { PathBuilder } from "./vector.js";
+//#region src/core/arc-to-bezier.ts
 function arcPoint(cx, cy, rx, ry, angleRad) {
 	return [cx + rx * Math.cos(angleRad), cy + ry * Math.sin(angleRad)];
 }

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

@@ -7,6 +7,8 @@ function flowRenderOptions(flow) {
 		...flow.sections.length > 0 ? { sections: flow.sections } : {},
 		...flow.section ? { section: flow.section } : {},
 		...flow.headersFooters ? { headersFooters: flow.headersFooters } : {},
+		...flow.footnotes ? { footnotes: flow.footnotes } : {},
+		...flow.endnotes ? { endnotes: flow.endnotes } : {},
 		resources: flow.resources,
 		...flow.charts ? { charts: flow.charts } : {},
 		...flow.embeddedFonts ? { embeddedFonts: flow.embeddedFonts } : {},

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

@@ -3,7 +3,7 @@ import { FontRegistry } from "../font/font-registry.js";
 import { ConversionLossError } from "../ir/loss.js";
 import { layoutStyledDocument } from "../../layout/styled-layout.js";
 import { signPdf } from "../../pdf/signature.js";
-import { renderStyledPdf } from "../../pdf/styled-page-renderer.js";
+import { renderStyledPdf, renderStyledPdfEncrypted } from "../../pdf/styled-page-renderer.js";
 import "../../pdf/index.js";
 import { flowRenderOptions } from "./project.js";
 import { writeHtml } from "../../html/html-writer.js";
@@ -73,7 +73,7 @@ var Ream = class Ream {
 			relationship: "Source",
 			description: "Source document"
 		});
-		let pdf = renderStyledPdf(this.flow.body, {
+		const styled = {
 			registry,
 			...registriesByFamily ? { registriesByFamily } : {},
 			...flowRenderOptions(this.flow),
@@ -81,7 +81,8 @@ var Ream = class Ream {
 			...attachments.length > 0 ? { attachments } : {},
 			...signature ? { signaturePlaceholder: signature } : {},
 			...renderOptions
-		});
+		};
+		let pdf = styled.encrypt ? await renderStyledPdfEncrypted(this.flow.body, styled) : renderStyledPdf(this.flow.body, styled);
 		if (signature) pdf = await signPdf(pdf, signature);
 		this.enforceStrict(options, losses);
 		return {

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

@@ -1 +1 @@
-export type { AbstractNumbering, Alignment, Border, BorderStyle, BodyElement, CellBorders, CellMerge, DocumentInfo, CellMargins, CellProperties, CellShading, 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, SectionProperties, ShapeBlock, ShapeDash, ShapeFill, ShapeFillKind, ShapeGeometry, ShapeLine, ShapeTextBody, ShapeTransform, Style, StyleSheet, StyleType, Table, TableCell, TableProperties, TableRow, UnderlineStyle, VerticalAlign, } from './types.js';
+export type { AbstractNumbering, Alignment, Border, BorderStyle, BodyElement, CellBorders, CellMerge, DocumentInfo, CellMargins, CellProperties, CellShading, 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

@@ -126,6 +126,13 @@ export interface Run {
     readonly native?: NativeBag;
     readonly text: string;
     readonly properties: RunProperties;
+    readonly href?: string;
+    readonly field?: 'PAGE' | 'NUMPAGES';
+    readonly anchor?: string;
+    readonly footnoteRef?: string;
+    readonly endnoteRef?: string;
+    readonly noteNumber?: true;
+    readonly listMarker?: true;
     readonly inlineImage?: InlineImage;
     readonly math?: MathNode;
     readonly pageBreak?: boolean;
@@ -134,6 +141,7 @@ export interface Paragraph {
     readonly native?: NativeBag;
     readonly properties: ParagraphProperties;
     readonly runs: ReadonlyArray<Run>;
+    readonly bookmarks?: ReadonlyArray<string>;
 }
 export type NumberingFormat = 'decimal' | 'lowerLetter' | 'upperLetter' | 'lowerRoman' | 'upperRoman' | 'bullet' | 'none';
 export interface NumberingReference {
@@ -161,6 +169,18 @@ export interface Numbering {
     readonly numInstances: ReadonlyMap<string, NumberingInstance>;
 }
 export type StyleType = 'paragraph' | 'character' | 'table' | 'numbering';
+export interface TableStyleLayer {
+    readonly borders?: CellBorders;
+    readonly cellMargins?: CellMargins;
+    readonly shading?: CellShading;
+    readonly runProperties?: RunProperties;
+    readonly paragraphProperties?: ParagraphProperties;
+}
+export type TableStyleConditionType = 'wholeTable' | 'band1Vert' | 'band2Vert' | 'band1Horz' | 'band2Horz' | 'firstCol' | 'lastCol' | 'firstRow' | 'lastRow' | 'nwCell' | 'neCell' | 'swCell' | 'seCell';
+export interface TableStyleCondition {
+    readonly type: TableStyleConditionType;
+    readonly layer: TableStyleLayer;
+}
 export interface Style {
     readonly id: string;
     readonly type: StyleType;
@@ -168,6 +188,10 @@ export interface Style {
     readonly isDefault: boolean;
     readonly runProperties: RunProperties;
     readonly paragraphProperties: ParagraphProperties;
+    readonly tableLayer?: TableStyleLayer;
+    readonly tableConditions?: ReadonlyArray<TableStyleCondition>;
+    readonly rowBandSize?: number;
+    readonly colBandSize?: number;
 }
 export interface StyleSheet {
     readonly defaultRunProperties: RunProperties;
@@ -213,7 +237,17 @@ export interface RowProperties {
     readonly isHeader?: boolean;
     readonly pageBreakBefore?: boolean;
 }
+export interface TableLook {
+    readonly firstRow?: boolean;
+    readonly lastRow?: boolean;
+    readonly firstColumn?: boolean;
+    readonly lastColumn?: boolean;
+    readonly noHBand?: boolean;
+    readonly noVBand?: boolean;
+}
 export interface TableProperties {
+    readonly styleId?: string;
+    readonly look?: TableLook;
     readonly widthPt?: Pt;
     readonly widthFraction?: number;
     readonly widthType?: 'auto' | 'dxa' | 'pct' | 'nil';
@@ -237,6 +271,7 @@ export interface Table {
     readonly rows: ReadonlyArray<TableRow>;
 }
 export interface ImageBlock {
+    readonly float?: FloatAnchor;
     readonly resource?: ResourceId;
     readonly width: Pt;
     readonly height: Pt;
@@ -312,6 +347,7 @@ export interface ShapeTextBody {
     readonly anchor?: 't' | 'ctr' | 'b';
 }
 export interface ShapeBlock {
+    readonly float?: FloatAnchor;
     readonly width: Pt;
     readonly height: Pt;
     readonly geometry: ShapeGeometry;
@@ -347,8 +383,10 @@ export interface Chart {
     readonly showValues?: boolean;
     readonly catAxisTitle?: string;
     readonly valAxisTitle?: string;
+    readonly seriesColorCycle?: ReadonlyArray<string>;
 }
 export interface ChartBlock {
+    readonly float?: FloatAnchor;
     readonly chartRelId: string;
     readonly width: Pt;
     readonly height: Pt;
@@ -396,6 +434,28 @@ export interface SectionProperties {
     readonly footers: ReadonlyArray<HeaderFooterReference>;
     readonly titlePg?: boolean;
     readonly evenAndOddHeaders?: boolean;
+    readonly columns?: SectionColumns;
+}
+export interface FloatAnchor {
+    readonly wrap: 'none' | 'square' | 'tight' | 'through' | 'topAndBottom';
+    readonly behind?: boolean;
+    readonly posH?: {
+        readonly relativeFrom: 'margin' | 'page' | 'column';
+        readonly offsetPt?: Pt;
+        readonly align?: 'left' | 'center' | 'right';
+    };
+    readonly posV?: {
+        readonly relativeFrom: 'margin' | 'page' | 'paragraph' | 'line';
+        readonly offsetPt?: Pt;
+    };
+}
+export interface SectionColumns {
+    readonly count: number;
+    readonly spacePt: number;
+    readonly explicit?: ReadonlyArray<{
+        readonly widthPt: number;
+        readonly spacePt: number;
+    }>;
 }
 export interface Section {
     readonly properties: SectionProperties;

package/dist/esm/{layout → core/drawingml}/chart-geometry.d.ts

@@ -1,4 +1,4 @@
-import { Chart, ChartSeries } from '../core/document-model/index.js';
+import { Chart, ChartSeries } from '../document-model/index.js';
 export interface ChartRect {
     readonly x: number;
     readonly y: number;
@@ -48,7 +48,7 @@ export type MeasureText = (text: string, sizePt: number) => number;
 export declare const CHART_LABEL_PT = 9;
 export declare const CHART_TITLE_PT = 13;
 export declare const SERIES_COLORS: string[];
-export declare const seriesColor: (s: ChartSeries, i: number) => string;
+export declare const seriesColor: (s: ChartSeries, i: number, cycle?: ReadonlyArray<string>) => string;
 export interface Scale {
     readonly min: number;
     readonly max: number;

package/dist/esm/{layout → core/drawingml}/chart-geometry.js

@@ -10,7 +10,7 @@ var SERIES_COLORS = [
 	"5B9BD5",
 	"70AD47"
 ];
-var seriesColor = (s, i) => s.colorHex ?? SERIES_COLORS[i % SERIES_COLORS.length];
+var seriesColor = (s, i, cycle) => s.colorHex ?? (cycle && cycle.length > 0 ? cycle[i % cycle.length] : SERIES_COLORS[i % SERIES_COLORS.length]);
 function niceNum(range, round) {
 	const exp = Math.floor(Math.log10(range));
 	const f = range / 10 ** exp;
@@ -40,6 +40,68 @@ var ticks = (s) => {
 	for (let v = s.min; v <= s.max + 1e-9; v += s.step) out.push(Math.abs(v) < 1e-9 ? 0 : v);
 	return out;
 };
+function pushChartTitle(labels, chart, wPt, hPt) {
+	if (!chart.title) return;
+	labels.push({
+		text: chart.title,
+		x: wPt / 2,
+		y: hPt - 4 - 13,
+		sizePt: 13,
+		colorHex: TITLE_COLOR,
+		align: "center"
+	});
+}
+function buildLegendBlock(chart, wPt, hPt, measure) {
+	return layoutLegend(chart.series.map((s, i) => ({
+		name: s.name ?? "",
+		colorHex: seriesColor(s, i, chart.seriesColorCycle)
+	})).filter((e) => e.name !== ""), chart.hasLegend, chart.legendPos ?? "b", wPt, hPt, measure);
+}
+function pushGridTicks(polylines, labels, tickVals, fmt, axis, at, x0, y0, plotW, plotH) {
+	for (const v of tickVals) if (axis === "x") {
+		const gx = at(v);
+		polylines.push({
+			points: [[gx, y0], [gx, y0 + plotH]],
+			strokeHex: GRID_COLOR,
+			widthPt: .75
+		});
+		labels.push({
+			text: fmt(v),
+			x: gx,
+			y: y0 - 9,
+			sizePt: 9,
+			colorHex: LABEL_COLOR,
+			align: "center"
+		});
+	} else {
+		const gy = at(v);
+		polylines.push({
+			points: [[x0, gy], [x0 + plotW, gy]],
+			strokeHex: GRID_COLOR,
+			widthPt: .75
+		});
+		labels.push({
+			text: fmt(v),
+			x: x0 - 3,
+			y: gy - 9 / 3,
+			sizePt: 9,
+			colorHex: LABEL_COLOR,
+			align: "right"
+		});
+	}
+}
+function pushAxisLines(polylines, x0, y0, plotW, plotH) {
+	polylines.push({
+		points: [[x0, y0], [x0, y0 + plotH]],
+		strokeHex: AXIS_COLOR,
+		widthPt: 1
+	});
+	polylines.push({
+		points: [[x0, y0], [x0 + plotW, y0]],
+		strokeHex: AXIS_COLOR,
+		widthPt: 1
+	});
+}
 function buildFrame(chart, wPt, hPt, measure, horizontal, opts = {}) {
 	const rects = [];
 	const polylines = [];
@@ -53,10 +115,7 @@ function buildFrame(chart, wPt, hPt, measure, horizontal, opts = {}) {
 	let top = 4;
 	if (chart.title) top += 13 * 1.6;
 	if (chart.valAxisTitle) top += 9 * 1.4;
-	const legend = layoutLegend(chart.series.map((s, i) => ({
-		name: s.name ?? "",
-		colorHex: seriesColor(s, i)
-	})).filter((e) => e.name !== ""), chart.hasLegend, chart.legendPos ?? "b", wPt, hPt, measure);
+	const legend = buildLegendBlock(chart, wPt, hPt, measure);
 	const plotRight = wPt - 4 - legend.rightWidth;
 	const tickLabelW = Math.max(0, ...tickVals.map((v) => measure(fmtVal(v), 9))) + 4;
 	const catLabelH = 9 * 1.6;
@@ -67,14 +126,7 @@ function buildFrame(chart, wPt, hPt, measure, horizontal, opts = {}) {
 	const plotH = Math.max(1, hPt - top - y0);
 	const valueOffset = (v) => (v - scale.min) / (scale.max - scale.min) * (horizontal ? plotW : plotH);
 	const zeroOffset = valueOffset(0);
-	if (chart.title) labels.push({
-		text: chart.title,
-		x: wPt / 2,
-		y: hPt - 4 - 13,
-		sizePt: 13,
-		colorHex: TITLE_COLOR,
-		align: "center"
-	});
+	pushChartTitle(labels, chart, wPt, hPt);
 	if (chart.valAxisTitle) labels.push({
 		text: chart.valAxisTitle,
 		x: x0,
@@ -91,40 +143,8 @@ function buildFrame(chart, wPt, hPt, measure, horizontal, opts = {}) {
 		colorHex: LABEL_COLOR,
 		align: "center"
 	});
-	for (const v of tickVals) {
-		const off = valueOffset(v);
-		if (horizontal) {
-			const gx = x0 + off;
-			polylines.push({
-				points: [[gx, y0], [gx, y0 + plotH]],
-				strokeHex: GRID_COLOR,
-				widthPt: .75
-			});
-			labels.push({
-				text: fmtVal(v),
-				x: gx,
-				y: y0 - 9,
-				sizePt: 9,
-				colorHex: LABEL_COLOR,
-				align: "center"
-			});
-		} else {
-			const gy = y0 + off;
-			polylines.push({
-				points: [[x0, gy], [x0 + plotW, gy]],
-				strokeHex: GRID_COLOR,
-				widthPt: .75
-			});
-			labels.push({
-				text: fmtVal(v),
-				x: x0 - 3,
-				y: gy - 9 / 3,
-				sizePt: 9,
-				colorHex: LABEL_COLOR,
-				align: "right"
-			});
-		}
-	}
+	if (horizontal) pushGridTicks(polylines, labels, tickVals, fmtVal, "x", (v) => x0 + valueOffset(v), x0, y0, plotW, plotH);
+	else pushGridTicks(polylines, labels, tickVals, fmtVal, "y", (v) => y0 + valueOffset(v), x0, y0, plotW, plotH);
 	const slot = (horizontal ? plotH : plotW) / nCats;
 	for (let c = 0; c < nCats; c++) {
 		const cat = chart.categories[c] ?? "";
@@ -147,16 +167,7 @@ function buildFrame(chart, wPt, hPt, measure, horizontal, opts = {}) {
 			align: "center"
 		});
 	}
-	polylines.push({
-		points: [[x0, y0], [x0, y0 + plotH]],
-		strokeHex: AXIS_COLOR,
-		widthPt: 1
-	});
-	polylines.push({
-		points: [[x0, y0], [x0 + plotW, y0]],
-		strokeHex: AXIS_COLOR,
-		widthPt: 1
-	});
+	pushAxisLines(polylines, x0, y0, plotW, plotH);
 	legend.emit(rects, labels);
 	return {
 		x0,
@@ -232,7 +243,7 @@ function buildBarScene(chart, wPt, hPt, measure) {
 				const o1 = f.valueOffset(top);
 				const lo = Math.min(o0, o1);
 				const span = Math.abs(o1 - o0);
-				const color = pointColor(series, c) ?? seriesColor(series, s);
+				const color = pointColor(series, c) ?? seriesColor(series, s, chart.seriesColorCycle);
 				if (horizontal) f.rects.push({
 					x: f.x0 + lo,
 					y: along,
@@ -271,7 +282,7 @@ function buildBarScene(chart, wPt, hPt, measure) {
 		for (let s = 0; s < chart.series.length; s++) {
 			const series = chart.series[s];
 			const len = f.valueOffset(series.values[c] ?? 0) - f.zeroOffset;
-			const color = pointColor(series, c) ?? seriesColor(series, s);
+			const color = pointColor(series, c) ?? seriesColor(series, s, chart.seriesColorCycle);
 			const along = slotStart + s * barW;
 			if (horizontal) {
 				const bx = f.x0 + f.zeroOffset + Math.min(0, len);
@@ -356,7 +367,7 @@ function buildAreaScene(chart, wPt, hPt, measure) {
 				const denom = percent ? chart.series.reduce((a, ss) => a + Math.abs(ss.values[c] ?? 0), 0) || 1 : 1;
 				return b + (series.values[c] ?? 0) / denom;
 			});
-			polygons.push(areaBand(top, base, f, xAt, seriesColor(series, s)));
+			polygons.push(areaBand(top, base, f, xAt, seriesColor(series, s, chart.seriesColorCycle)));
 			for (let c = 0; c < nCats; c++) cum[c] = top[c];
 		}
 	} else {
@@ -364,7 +375,7 @@ function buildAreaScene(chart, wPt, hPt, measure) {
 		for (let s = chart.series.length - 1; s >= 0; s--) {
 			const series = chart.series[s];
 			const top = Array.from({ length: nCats }, (_, c) => series.values[c] ?? 0);
-			polygons.push(areaBand(top, base, f, xAt, seriesColor(series, s)));
+			polygons.push(areaBand(top, base, f, xAt, seriesColor(series, s, chart.seriesColorCycle)));
 		}
 	}
 	return {
@@ -397,69 +408,20 @@ function buildScatterScene(chart, wPt, hPt, measure) {
 	const yTicks = ticks(yScale);
 	let top = 4;
 	if (chart.title) top += 13 * 1.6;
-	const legend = layoutLegend(chart.series.map((s, i) => ({
-		name: s.name ?? "",
-		colorHex: seriesColor(s, i)
-	})).filter((e) => e.name !== ""), chart.hasLegend, chart.legendPos ?? "b", wPt, hPt, measure);
+	const legend = buildLegendBlock(chart, wPt, hPt, measure);
 	const x0 = 4 + (Math.max(0, ...yTicks.map((v) => measure(formatTick(v, yScale.step), 9))) + 4);
 	const y0 = 4 + legend.bottomHeight + 9 * 1.6;
 	const plotW = Math.max(1, wPt - 4 - legend.rightWidth - x0);
 	const plotH = Math.max(1, hPt - top - y0);
 	const xAt = (v) => x0 + (v - xScale.min) / (xScale.max - xScale.min) * plotW;
 	const yAt = (v) => y0 + (v - yScale.min) / (yScale.max - yScale.min) * plotH;
-	if (chart.title) labels.push({
-		text: chart.title,
-		x: wPt / 2,
-		y: hPt - 4 - 13,
-		sizePt: 13,
-		colorHex: TITLE_COLOR,
-		align: "center"
-	});
-	for (const v of yTicks) {
-		const gy = yAt(v);
-		polylines.push({
-			points: [[x0, gy], [x0 + plotW, gy]],
-			strokeHex: GRID_COLOR,
-			widthPt: .75
-		});
-		labels.push({
-			text: formatTick(v, yScale.step),
-			x: x0 - 3,
-			y: gy - 9 / 3,
-			sizePt: 9,
-			colorHex: LABEL_COLOR,
-			align: "right"
-		});
-	}
-	for (const v of xTicks) {
-		const gx = xAt(v);
-		polylines.push({
-			points: [[gx, y0], [gx, y0 + plotH]],
-			strokeHex: GRID_COLOR,
-			widthPt: .75
-		});
-		labels.push({
-			text: formatTick(v, xScale.step),
-			x: gx,
-			y: y0 - 9,
-			sizePt: 9,
-			colorHex: LABEL_COLOR,
-			align: "center"
-		});
-	}
-	polylines.push({
-		points: [[x0, y0], [x0, y0 + plotH]],
-		strokeHex: AXIS_COLOR,
-		widthPt: 1
-	});
-	polylines.push({
-		points: [[x0, y0], [x0 + plotW, y0]],
-		strokeHex: AXIS_COLOR,
-		widthPt: 1
-	});
+	pushChartTitle(labels, chart, wPt, hPt);
+	pushGridTicks(polylines, labels, yTicks, (v) => formatTick(v, yScale.step), "y", yAt, x0, y0, plotW, plotH);
+	pushGridTicks(polylines, labels, xTicks, (v) => formatTick(v, xScale.step), "x", xAt, x0, y0, plotW, plotH);
+	pushAxisLines(polylines, x0, y0, plotW, plotH);
 	for (let s = 0; s < chart.series.length; s++) {
 		const series = chart.series[s];
-		const color = seriesColor(series, s);
+		const color = seriesColor(series, s, chart.seriesColorCycle);
 		for (let i = 0; i < series.values.length; i++) {
 			const px = xAt(series.xValues?.[i] ?? i);
 			const py = yAt(series.values[i] ?? 0);
@@ -485,7 +447,7 @@ function buildLineScene(chart, wPt, hPt, measure) {
 	const f = buildFrame(chart, wPt, hPt, measure, false, { dataRange: allVals.length > 0 ? [Math.min(...allVals), Math.max(...allVals)] : [0, 1] });
 	for (let s = 0; s < chart.series.length; s++) {
 		const series = chart.series[s];
-		const color = seriesColor(series, s);
+		const color = seriesColor(series, s, chart.seriesColorCycle);
 		const pts = [];
 		for (let c = 0; c < f.nCats; c++) {
 			const x = f.x0 + c * f.slot + f.slot / 2;

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

@@ -1,3 +1,6 @@
 import { Chart } from '../document-model/index.js';
+import { OpcPackage } from '../opc/index.js';
 import { ColorResolver } from './colors.js';
 export declare function parseChart(chartXml: Uint8Array, resolveColor: ColorResolver): Chart | null;
+export declare function parseChartColorStyle(colorsXml: Uint8Array, resolveColor: ColorResolver): Array<string>;
+export declare function withChartColorStyle(chart: Chart, pkg: OpcPackage, chartPartPath: string, resolveColor: ColorResolver): Chart;

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

@@ -191,5 +191,32 @@ function isLegendPos(v) {
 function isGrouping(v) {
 	return v === "clustered" || v === "stacked" || v === "percentStacked" || v === "standard";
 }
+function parseChartColorStyle(colorsXml, resolveColor) {
+	const root = parser.parse(new TextDecoder().decode(colorsXml)).find((n) => {
+		const tag = Object.keys(n).find((k) => k !== ":@" && k !== "#text");
+		return tag !== void 0 && tag.endsWith("colorStyle");
+	});
+	if (!root) return [];
+	const out = [];
+	for (const child of poChildren(root)) {
+		const hex = resolveColorNode(child, resolveColor);
+		if (hex !== void 0) out.push(hex);
+	}
+	return out;
+}
+function withChartColorStyle(chart, pkg, chartPartPath, resolveColor) {
+	for (const rel of pkg.getPartRelationships(chartPartPath)) {
+		if (rel.type !== REL_CHART_COLOR_STYLE) continue;
+		const resolved = pkg.resolveRelatedPart(chartPartPath, rel);
+		if (!resolved) continue;
+		const cycle = parseChartColorStyle(resolved.data, resolveColor);
+		if (cycle.length > 0) return {
+			...chart,
+			seriesColorCycle: cycle
+		};
+	}
+	return chart;
+}
+var REL_CHART_COLOR_STYLE = "http://schemas.microsoft.com/office/2011/relationships/chartColorStyle";
 //#endregion
-export { parseChart };
+export { parseChart, withChartColorStyle };

package/dist/esm/{layout → core/drawingml}/preset-geometry.d.ts

@@ -1,5 +1,5 @@
-import { CustomGeometry } from '../core/document-model/index.js';
-import { PathSegment, VectorPath } from '../core/vector.js';
+import { CustomGeometry } from '../document-model/index.js';
+import { PathSegment, VectorPath } from '../vector.js';
 export declare function rectSegments(w: number, h: number): ReadonlyArray<PathSegment>;
 export declare function rectPath(w: number, h: number): VectorPath;
 export declare function presetPaths(preset: string, w: number, h: number, adjust: ReadonlyMap<string, number>): Array<VectorPath> | null;

package/dist/esm/{layout → core/drawingml}/preset-geometry.js

@@ -1,6 +1,6 @@
-import { PathBuilder } from "../core/vector.js";
-import { arcToBeziers, ellipseSegments, roundRectSegments } from "./arc-to-bezier.js";
-//#region src/layout/preset-geometry.ts
+import { PathBuilder } from "../vector.js";
+import { arcToBeziers, ellipseSegments, roundRectSegments } from "../arc-to-bezier.js";
+//#region src/core/drawingml/preset-geometry.ts
 function rectSegments(w, h) {
 	return new PathBuilder().moveTo(0, 0).lineTo(w, 0).lineTo(w, h).lineTo(0, h).close().build().segments;
 }

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

@@ -0,0 +1,8 @@
+import { ShapeGeometry, ShapeLine } from '../document-model/index.js';
+import { 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 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

@@ -0,0 +1,71 @@
+import { customPaths, presetPaths, rectPath } from "./preset-geometry.js";
+//#region src/core/drawingml/shape-render.ts
+var EMU_PER_PT = 12700;
+var DEFAULT_LINE_WIDTH_EMU = 9525;
+var DEFAULT_INSET_LR_PT = 91440 / EMU_PER_PT;
+var DEFAULT_INSET_TB_PT = 45720 / EMU_PER_PT;
+function buildShapePaths(geometry, widthPt, heightPt) {
+	if (geometry.kind === "preset") return presetPaths(geometry.preset ?? "rect", widthPt, heightPt, geometry.adjust ?? /* @__PURE__ */ new Map()) ?? [rectPath(widthPt, heightPt)];
+	if (geometry.custom) return customPaths(geometry.custom, widthPt, heightPt);
+	return [rectPath(widthPt, heightPt)];
+}
+function buildStroke(line) {
+	if (!line || line.fill === "none") return void 0;
+	const widthPt = line.width ?? DEFAULT_LINE_WIDTH_EMU / 12700;
+	const dash = line.dash && line.dash !== "solid" ? dashPattern(line.dash, widthPt) : void 0;
+	const cap = line.cap === "flat" ? "butt" : line.cap;
+	return {
+		colorHex: line.colorHex ?? "000000",
+		widthPt,
+		...dash ? { dash } : {},
+		...cap ? { cap } : {}
+	};
+}
+function dashPattern(dash, w) {
+	const u = Math.max(w, .1);
+	switch (dash) {
+		case "solid": return;
+		case "dot": return [u, 2 * u];
+		case "dash": return [4 * u, 3 * u];
+		case "dashDot": return [
+			4 * u,
+			3 * u,
+			u,
+			3 * u
+		];
+		case "lgDash": return [8 * u, 3 * u];
+		case "lgDashDot": return [
+			8 * u,
+			3 * u,
+			u,
+			3 * u
+		];
+		case "sysDash": return [3 * u, u];
+		case "sysDot": return [u, u];
+	}
+}
+function buildShapeTransform(pageX, pageY, widthPt, heightPt, rotation60k, flipH, flipV) {
+	const theta = -rotation60k / 6e4 * (Math.PI / 180);
+	const sx = flipH ? -1 : 1;
+	const sy = flipV ? -1 : 1;
+	const cos = Math.cos(theta);
+	const sin = Math.sin(theta);
+	const a = sx * cos;
+	const b = sx * sin;
+	const c = -sy * sin;
+	const d = sy * cos;
+	const cxL = widthPt / 2;
+	const cyL = heightPt / 2;
+	const centerX = pageX + cxL;
+	const centerY = pageY + cyL;
+	return [
+		a,
+		b,
+		c,
+		d,
+		centerX - (a * cxL + c * cyL),
+		centerY - (b * cxL + d * cyL)
+	];
+}
+//#endregion
+export { DEFAULT_INSET_LR_PT, DEFAULT_INSET_TB_PT, buildShapePaths, buildShapeTransform, buildStroke };

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

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