xls-codec 4.7.6 → 4.8.0

package/dist/workbook/drawing.cjs

@@ -0,0 +1,270 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("../biff/record-types.cjs");
+const require_units = require("../units.cjs");
+require("../drawing/escher-constants.cjs");
+const require_drawing_bytes = require("../drawing/bytes.cjs");
+const require_workbook_comments = require("./comments.cjs");
+const require_drawing_shapes = require("../drawing/shapes.cjs");
+const require_workbook_chart = require("./chart.cjs");
+let document_schema_js = require("document-schema.js");
+//#region src/workbook/drawing.ts
+/** [MS-XLS] "FtCmo" ot enumeration, the values this reader routes on. */
+const OBJECT_TYPE_CHART = 5;
+const OBJECT_TYPE_PICTURE = 8;
+/** The Note object type comments.ts's own Note/Obj/Txo reading already fully accounts for -- a comment's own callout box carries an MsoDrawing shape too, and pairing it here as well would emit a spurious, contentless 'drawing' embedded object for every cell comment on the sheet. */
+const OBJECT_TYPE_NOTE = 25;
+const GRID_UNITS_X = 1024;
+const GRID_UNITS_Y = 256;
+/** The worksheet grid geometry a cell anchor resolves against -- declared column widths/row heights with Excel's own Normal-style default beneath, mirroring ooxml.js's identical SheetGridGeometry for the xlsx case. */
+var SheetGridGeometry = class {
+	columnWidths = /* @__PURE__ */ new Map();
+	rowHeights = /* @__PURE__ */ new Map();
+	defaultColumnWidthPt = require_units.columnWidthToPoints(require_units.DEFAULT_COLUMN_WIDTH_CHARS * 256);
+	constructor(columns, rows) {
+		for (const column of columns) if (column.widthPt !== void 0) this.columnWidths.set(column.index, column.widthPt);
+		for (const row of rows) if (row.heightPt !== void 0) this.rowHeights.set(row.index, row.heightPt);
+	}
+	columnWidthPt(index) {
+		return this.columnWidths.get(index) ?? this.defaultColumnWidthPt;
+	}
+	rowHeightPt(index) {
+		return this.rowHeights.get(index) ?? 15;
+	}
+	/** The absolute page-space X of a given column's own left edge -- the cumulative width of every column before it. */
+	xPt(column) {
+		let x = 0;
+		for (let index = 0; index < column; index += 1) x += this.columnWidthPt(index);
+		return x;
+	}
+	yPt(row) {
+		let y = 0;
+		for (let index = 0; index < row; index += 1) y += this.rowHeightPt(index);
+		return y;
+	}
+};
+/** Resolves an OfficeArtClientAnchorSheet into the cell-relative placement ContentSheetImage/ContentEmbeddedObject both carry, plus the page-absolute frame box a Box's own xPt/yPt/widthPt/heightPt need -- dxL/dxR in 1/1024ths of the anchor cell's own width, dyT/dyB in 1/256ths of its own height ([MS-XLS] 2.5.163). */
+function resolveAnchorPlacement(anchor, geometry) {
+	const offsetXPt = geometry.columnWidthPt(anchor.colL) * anchor.dxL / GRID_UNITS_X;
+	const offsetYPt = geometry.rowHeightPt(anchor.rwT) * anchor.dyT / GRID_UNITS_Y;
+	const xPt = geometry.xPt(anchor.colL) + offsetXPt;
+	const yPt = geometry.yPt(anchor.rwT) + offsetYPt;
+	const rightPt = geometry.xPt(anchor.colR) + geometry.columnWidthPt(anchor.colR) * anchor.dxR / GRID_UNITS_X;
+	const bottomPt = geometry.yPt(anchor.rwB) + geometry.rowHeightPt(anchor.rwB) * anchor.dyB / GRID_UNITS_Y;
+	return {
+		xPt,
+		yPt,
+		widthPt: rightPt - xPt,
+		heightPt: bottomPt - yPt,
+		anchorRow: anchor.rwT,
+		anchorColumn: anchor.colL,
+		offsetXPt,
+		offsetYPt
+	};
+}
+/** Reads one worksheet's own drawing content: every MsoDrawing record's bytes concatenated into one Escher stream (drawing/shapes.ts), each of its real top-level shapes paired 1:1, in document order, with the non-Note Obj records the same substream carries. */
+function readSheetDrawing(worksheetRecords, context) {
+	const drawingChunks = [];
+	const objEntries = [];
+	for (let index = 0; index < worksheetRecords.length; index += 1) {
+		const record = worksheetRecords[index];
+		if (record === void 0) continue;
+		if (record.type === 236) {
+			const block = record.blocks[0];
+			if (block !== void 0) drawingChunks.push(block);
+			continue;
+		}
+		if (record.type === 93) {
+			const { ot } = require_workbook_comments.readObjTypeAndId(record);
+			const nextOffset = worksheetRecords[index + 1]?.offset ?? Number.POSITIVE_INFINITY;
+			objEntries.push({
+				ot,
+				offset: record.offset,
+				nextOffset
+			});
+		}
+	}
+	if (drawingChunks.length === 0) return {
+		images: [],
+		embeddedObjects: []
+	};
+	const drawingBytes = require_drawing_bytes.concatBytes(drawingChunks);
+	const shapes = require_drawing_shapes.readSheetShapes(drawingBytes);
+	const geometry = new SheetGridGeometry(context.columns, context.rows);
+	const images = [];
+	const embeddedObjects = [];
+	const pairCount = Math.min(shapes.length, objEntries.length);
+	for (let index = 0; index < pairCount; index += 1) {
+		const shape = shapes[index];
+		const obj = objEntries[index];
+		if (shape === void 0 || obj === void 0 || obj.ot === OBJECT_TYPE_NOTE) continue;
+		if (obj.ot === OBJECT_TYPE_PICTURE || shape.shapeType === 75) {
+			const image = imageFromShape(shape, context, geometry);
+			if (image !== void 0) images.push(image);
+			continue;
+		}
+		if (obj.ot === OBJECT_TYPE_CHART) {
+			const chart = chartFromShape(shape, obj.offset, obj.nextOffset, context, geometry);
+			if (chart !== void 0) embeddedObjects.push(chart);
+			continue;
+		}
+		const drawing = drawingObjectFromShape(shape, geometry);
+		if (drawing !== void 0) embeddedObjects.push(drawing);
+	}
+	return {
+		images,
+		embeddedObjects
+	};
+}
+function imageFromShape(shape, context, geometry) {
+	if (shape.blipIndex === void 0) return;
+	const blip = context.blipStore.get(shape.blipIndex);
+	if (blip === void 0) return;
+	const placement = resolveAnchorPlacement(shape.anchor, geometry);
+	if (placement.widthPt <= 0 || placement.heightPt <= 0) return;
+	return {
+		kind: "image",
+		format: blip.format,
+		base64: blip.base64,
+		widthPt: placement.widthPt,
+		heightPt: placement.heightPt,
+		anchorRow: placement.anchorRow,
+		anchorColumn: placement.anchorColumn,
+		offsetXPt: placement.offsetXPt,
+		offsetYPt: placement.offsetYPt
+	};
+}
+/** Locates the chart's own nested BOF(dt=chart)...EOF substream: the one whose own BOF offset falls strictly between this Obj record's offset and whichever worksheet record comes right after it in the ORIGINAL stream -- splitSubstreams' own nesting fix (biff/substreams.ts) pulls a nested chart's records out of the worksheet substream's own `records` array entirely and reports it as its own top-level Substream instead, so byte-offset containment, not array position, is what still ties the two together. */
+function chartFromShape(shape, objOffset, nextOffset, context, geometry) {
+	const chartSubstream = context.allSubstreams.find((candidate) => candidate.documentType === 32 && candidate.offset > objOffset && candidate.offset < nextOffset);
+	if (chartSubstream === void 0) return;
+	const placement = resolveAnchorPlacement(shape.anchor, geometry);
+	const rangeContext = {
+		formulaSheets: context.formulaSheets,
+		ownSheetIndex: context.ownSheetIndex,
+		ownSheetCells: context.ownSheetCells
+	};
+	const series = require_workbook_chart.readChartSeries(chartSubstream.records, rangeContext);
+	return {
+		objectKind: "chart",
+		document: {
+			kind: "spreadsheet",
+			metadata: context.metadata,
+			sheets: [{
+				name: "Chart",
+				cells: chartTableCells(series),
+				columns: [],
+				rows: [],
+				images: [],
+				printSettings: {
+					pageSize: document_schema_js.PAGE_SIZE_LETTER,
+					margins: {
+						topPt: 0,
+						rightPt: 0,
+						bottomPt: 0,
+						leftPt: 0
+					},
+					gridlines: false,
+					headers: false,
+					pageOrder: "downThenOver"
+				}
+			}]
+		},
+		frame: {
+			xPt: placement.xPt,
+			yPt: placement.yPt,
+			widthPt: placement.widthPt,
+			heightPt: placement.heightPt
+		},
+		anchorRow: placement.anchorRow,
+		anchorColumn: placement.anchorColumn,
+		offsetXPt: placement.offsetXPt,
+		offsetYPt: placement.offsetYPt
+	};
+}
+/** Lays a chart's own series out as ooxml.js's readChartTable does for the identical xlsx/pptx case: a header row of series names over the category column, then one row per category with each series' own value -- see workbook/chart.ts's own top comment for why this flattened shape, not a typed chart object, is what document-schema.js's 'chart' objectKind actually carries. */
+function chartTableCells(series) {
+	const cells = [];
+	series.forEach((entry, seriesIndex) => {
+		const name = entry.name ?? "";
+		if (name !== "") cells.push({
+			row: 0,
+			column: seriesIndex + 1,
+			value: {
+				kind: "string",
+				value: name
+			},
+			displayText: name
+		});
+		entry.values.forEach((value, pointIndex) => {
+			if (value === "") return;
+			cells.push({
+				row: pointIndex + 1,
+				column: seriesIndex + 1,
+				value: {
+					kind: "string",
+					value
+				},
+				displayText: value
+			});
+		});
+	});
+	const categories = /* @__PURE__ */ new Map();
+	for (const entry of series) entry.categories.forEach((category, pointIndex) => {
+		if (category !== "" && !categories.has(pointIndex)) categories.set(pointIndex, category);
+	});
+	for (const [pointIndex, category] of categories) cells.push({
+		row: pointIndex + 1,
+		column: 0,
+		value: {
+			kind: "string",
+			value: category
+		},
+		displayText: category
+	});
+	return cells;
+}
+/** A shape this reader recognises as neither a picture nor a chart -- an autoshape, a text box, a line, a group -- carried as a 'drawing' embedded object: a single-page ContentDocument holding one ContentShape sized and positioned at the shape's own anchor. Undefined for the patriarch/group-only case readSheetShapes already excludes, and for a shape whose own anchor collapses to zero size. */
+function drawingObjectFromShape(shape, geometry) {
+	const placement = resolveAnchorPlacement(shape.anchor, geometry);
+	if (placement.widthPt <= 0 || placement.heightPt <= 0) return;
+	return {
+		objectKind: "drawing",
+		document: {
+			kind: "drawing",
+			metadata: {},
+			pages: [{
+				size: {
+					widthPt: placement.widthPt,
+					heightPt: placement.heightPt
+				},
+				shapes: [{
+					frame: {
+						xPt: 0,
+						yPt: 0,
+						widthPt: placement.widthPt,
+						heightPt: placement.heightPt
+					},
+					insetLeftPt: 0,
+					insetTopPt: 0,
+					insetRightPt: 0,
+					insetBottomPt: 0,
+					blocks: []
+				}],
+				vectors: []
+			}]
+		},
+		frame: {
+			xPt: placement.xPt,
+			yPt: placement.yPt,
+			widthPt: placement.widthPt,
+			heightPt: placement.heightPt
+		},
+		anchorRow: placement.anchorRow,
+		anchorColumn: placement.anchorColumn,
+		offsetXPt: placement.offsetXPt,
+		offsetYPt: placement.offsetYPt
+	};
+}
+//#endregion
+exports.chartTableCells = chartTableCells;
+exports.readSheetDrawing = readSheetDrawing;

package/dist/workbook/drawing.d.cts

@@ -0,0 +1,31 @@
+import { r as FormulaSheetContext } from "../ptg-CCBbJLZJ.cjs";
+import { n as Substream, t as RecordGroup } from "../substreams-XDNgDvRJ.cjs";
+import { BlipImage } from "../drawing/blips.cjs";
+import { RawColumn, RawRow } from "./sheet.cjs";
+import { ContentEmbeddedObject, ContentSheetCell, ContentSheetImage, LayoutMetadata } from "document-schema.js";
+//#region src/workbook/drawing.d.ts
+interface SheetDrawing {
+  readonly images: readonly ContentSheetImage[];
+  readonly embeddedObjects: readonly ContentEmbeddedObject[];
+}
+interface SheetDrawingContext {
+  readonly blipStore: ReadonlyMap<number, BlipImage>;
+  readonly columns: readonly RawColumn[];
+  readonly rows: readonly RawRow[];
+  readonly ownSheetIndex: number;
+  readonly formulaSheets: FormulaSheetContext;
+  readonly ownSheetCells: readonly ContentSheetCell[];
+  readonly metadata: LayoutMetadata;
+  /** Every substream the workbook stream carries -- searched for the chart substream a Chart-type Obj record's own nested BOF...EOF produced (splitSubstreams reports it as its own entry, positioned by byte offset rather than nested inside the worksheet's own `records`; see biff/substreams.ts's own top comment for why). */
+  readonly allSubstreams: readonly Substream[];
+}
+/** Reads one worksheet's own drawing content: every MsoDrawing record's bytes concatenated into one Escher stream (drawing/shapes.ts), each of its real top-level shapes paired 1:1, in document order, with the non-Note Obj records the same substream carries. */
+declare function readSheetDrawing(worksheetRecords: readonly RecordGroup[], context: SheetDrawingContext): SheetDrawing;
+/** Lays a chart's own series out as ooxml.js's readChartTable does for the identical xlsx/pptx case: a header row of series names over the category column, then one row per category with each series' own value -- see workbook/chart.ts's own top comment for why this flattened shape, not a typed chart object, is what document-schema.js's 'chart' objectKind actually carries. */
+declare function chartTableCells(series: readonly {
+  readonly name: string | undefined;
+  readonly categories: readonly string[];
+  readonly values: readonly string[];
+}[]): ContentSheetCell[];
+//#endregion
+export { SheetDrawing, SheetDrawingContext, chartTableCells, readSheetDrawing };

package/dist/workbook/drawing.d.ts

@@ -0,0 +1,31 @@
+import { r as FormulaSheetContext } from "../ptg-CCBbJLZJ.js";
+import { n as Substream, t as RecordGroup } from "../substreams-CgTHx5kX.js";
+import { BlipImage } from "../drawing/blips.js";
+import { RawColumn, RawRow } from "./sheet.js";
+import { ContentEmbeddedObject, ContentSheetCell, ContentSheetImage, LayoutMetadata } from "document-schema.js";
+//#region src/workbook/drawing.d.ts
+interface SheetDrawing {
+  readonly images: readonly ContentSheetImage[];
+  readonly embeddedObjects: readonly ContentEmbeddedObject[];
+}
+interface SheetDrawingContext {
+  readonly blipStore: ReadonlyMap<number, BlipImage>;
+  readonly columns: readonly RawColumn[];
+  readonly rows: readonly RawRow[];
+  readonly ownSheetIndex: number;
+  readonly formulaSheets: FormulaSheetContext;
+  readonly ownSheetCells: readonly ContentSheetCell[];
+  readonly metadata: LayoutMetadata;
+  /** Every substream the workbook stream carries -- searched for the chart substream a Chart-type Obj record's own nested BOF...EOF produced (splitSubstreams reports it as its own entry, positioned by byte offset rather than nested inside the worksheet's own `records`; see biff/substreams.ts's own top comment for why). */
+  readonly allSubstreams: readonly Substream[];
+}
+/** Reads one worksheet's own drawing content: every MsoDrawing record's bytes concatenated into one Escher stream (drawing/shapes.ts), each of its real top-level shapes paired 1:1, in document order, with the non-Note Obj records the same substream carries. */
+declare function readSheetDrawing(worksheetRecords: readonly RecordGroup[], context: SheetDrawingContext): SheetDrawing;
+/** Lays a chart's own series out as ooxml.js's readChartTable does for the identical xlsx/pptx case: a header row of series names over the category column, then one row per category with each series' own value -- see workbook/chart.ts's own top comment for why this flattened shape, not a typed chart object, is what document-schema.js's 'chart' objectKind actually carries. */
+declare function chartTableCells(series: readonly {
+  readonly name: string | undefined;
+  readonly categories: readonly string[];
+  readonly values: readonly string[];
+}[]): ContentSheetCell[];
+//#endregion
+export { SheetDrawing, SheetDrawingContext, chartTableCells, readSheetDrawing };

package/dist/workbook/drawing.js

@@ -0,0 +1,268 @@
+import "../biff/record-types.js";
+import { DEFAULT_COLUMN_WIDTH_CHARS, columnWidthToPoints } from "../units.js";
+import "../drawing/escher-constants.js";
+import { concatBytes } from "../drawing/bytes.js";
+import { readObjTypeAndId } from "./comments.js";
+import { readSheetShapes } from "../drawing/shapes.js";
+import { readChartSeries } from "./chart.js";
+import { PAGE_SIZE_LETTER } from "document-schema.js";
+//#region src/workbook/drawing.ts
+/** [MS-XLS] "FtCmo" ot enumeration, the values this reader routes on. */
+const OBJECT_TYPE_CHART = 5;
+const OBJECT_TYPE_PICTURE = 8;
+/** The Note object type comments.ts's own Note/Obj/Txo reading already fully accounts for -- a comment's own callout box carries an MsoDrawing shape too, and pairing it here as well would emit a spurious, contentless 'drawing' embedded object for every cell comment on the sheet. */
+const OBJECT_TYPE_NOTE = 25;
+const GRID_UNITS_X = 1024;
+const GRID_UNITS_Y = 256;
+/** The worksheet grid geometry a cell anchor resolves against -- declared column widths/row heights with Excel's own Normal-style default beneath, mirroring ooxml.js's identical SheetGridGeometry for the xlsx case. */
+var SheetGridGeometry = class {
+	columnWidths = /* @__PURE__ */ new Map();
+	rowHeights = /* @__PURE__ */ new Map();
+	defaultColumnWidthPt = columnWidthToPoints(DEFAULT_COLUMN_WIDTH_CHARS * 256);
+	constructor(columns, rows) {
+		for (const column of columns) if (column.widthPt !== void 0) this.columnWidths.set(column.index, column.widthPt);
+		for (const row of rows) if (row.heightPt !== void 0) this.rowHeights.set(row.index, row.heightPt);
+	}
+	columnWidthPt(index) {
+		return this.columnWidths.get(index) ?? this.defaultColumnWidthPt;
+	}
+	rowHeightPt(index) {
+		return this.rowHeights.get(index) ?? 15;
+	}
+	/** The absolute page-space X of a given column's own left edge -- the cumulative width of every column before it. */
+	xPt(column) {
+		let x = 0;
+		for (let index = 0; index < column; index += 1) x += this.columnWidthPt(index);
+		return x;
+	}
+	yPt(row) {
+		let y = 0;
+		for (let index = 0; index < row; index += 1) y += this.rowHeightPt(index);
+		return y;
+	}
+};
+/** Resolves an OfficeArtClientAnchorSheet into the cell-relative placement ContentSheetImage/ContentEmbeddedObject both carry, plus the page-absolute frame box a Box's own xPt/yPt/widthPt/heightPt need -- dxL/dxR in 1/1024ths of the anchor cell's own width, dyT/dyB in 1/256ths of its own height ([MS-XLS] 2.5.163). */
+function resolveAnchorPlacement(anchor, geometry) {
+	const offsetXPt = geometry.columnWidthPt(anchor.colL) * anchor.dxL / GRID_UNITS_X;
+	const offsetYPt = geometry.rowHeightPt(anchor.rwT) * anchor.dyT / GRID_UNITS_Y;
+	const xPt = geometry.xPt(anchor.colL) + offsetXPt;
+	const yPt = geometry.yPt(anchor.rwT) + offsetYPt;
+	const rightPt = geometry.xPt(anchor.colR) + geometry.columnWidthPt(anchor.colR) * anchor.dxR / GRID_UNITS_X;
+	const bottomPt = geometry.yPt(anchor.rwB) + geometry.rowHeightPt(anchor.rwB) * anchor.dyB / GRID_UNITS_Y;
+	return {
+		xPt,
+		yPt,
+		widthPt: rightPt - xPt,
+		heightPt: bottomPt - yPt,
+		anchorRow: anchor.rwT,
+		anchorColumn: anchor.colL,
+		offsetXPt,
+		offsetYPt
+	};
+}
+/** Reads one worksheet's own drawing content: every MsoDrawing record's bytes concatenated into one Escher stream (drawing/shapes.ts), each of its real top-level shapes paired 1:1, in document order, with the non-Note Obj records the same substream carries. */
+function readSheetDrawing(worksheetRecords, context) {
+	const drawingChunks = [];
+	const objEntries = [];
+	for (let index = 0; index < worksheetRecords.length; index += 1) {
+		const record = worksheetRecords[index];
+		if (record === void 0) continue;
+		if (record.type === 236) {
+			const block = record.blocks[0];
+			if (block !== void 0) drawingChunks.push(block);
+			continue;
+		}
+		if (record.type === 93) {
+			const { ot } = readObjTypeAndId(record);
+			const nextOffset = worksheetRecords[index + 1]?.offset ?? Number.POSITIVE_INFINITY;
+			objEntries.push({
+				ot,
+				offset: record.offset,
+				nextOffset
+			});
+		}
+	}
+	if (drawingChunks.length === 0) return {
+		images: [],
+		embeddedObjects: []
+	};
+	const drawingBytes = concatBytes(drawingChunks);
+	const shapes = readSheetShapes(drawingBytes);
+	const geometry = new SheetGridGeometry(context.columns, context.rows);
+	const images = [];
+	const embeddedObjects = [];
+	const pairCount = Math.min(shapes.length, objEntries.length);
+	for (let index = 0; index < pairCount; index += 1) {
+		const shape = shapes[index];
+		const obj = objEntries[index];
+		if (shape === void 0 || obj === void 0 || obj.ot === OBJECT_TYPE_NOTE) continue;
+		if (obj.ot === OBJECT_TYPE_PICTURE || shape.shapeType === 75) {
+			const image = imageFromShape(shape, context, geometry);
+			if (image !== void 0) images.push(image);
+			continue;
+		}
+		if (obj.ot === OBJECT_TYPE_CHART) {
+			const chart = chartFromShape(shape, obj.offset, obj.nextOffset, context, geometry);
+			if (chart !== void 0) embeddedObjects.push(chart);
+			continue;
+		}
+		const drawing = drawingObjectFromShape(shape, geometry);
+		if (drawing !== void 0) embeddedObjects.push(drawing);
+	}
+	return {
+		images,
+		embeddedObjects
+	};
+}
+function imageFromShape(shape, context, geometry) {
+	if (shape.blipIndex === void 0) return;
+	const blip = context.blipStore.get(shape.blipIndex);
+	if (blip === void 0) return;
+	const placement = resolveAnchorPlacement(shape.anchor, geometry);
+	if (placement.widthPt <= 0 || placement.heightPt <= 0) return;
+	return {
+		kind: "image",
+		format: blip.format,
+		base64: blip.base64,
+		widthPt: placement.widthPt,
+		heightPt: placement.heightPt,
+		anchorRow: placement.anchorRow,
+		anchorColumn: placement.anchorColumn,
+		offsetXPt: placement.offsetXPt,
+		offsetYPt: placement.offsetYPt
+	};
+}
+/** Locates the chart's own nested BOF(dt=chart)...EOF substream: the one whose own BOF offset falls strictly between this Obj record's offset and whichever worksheet record comes right after it in the ORIGINAL stream -- splitSubstreams' own nesting fix (biff/substreams.ts) pulls a nested chart's records out of the worksheet substream's own `records` array entirely and reports it as its own top-level Substream instead, so byte-offset containment, not array position, is what still ties the two together. */
+function chartFromShape(shape, objOffset, nextOffset, context, geometry) {
+	const chartSubstream = context.allSubstreams.find((candidate) => candidate.documentType === 32 && candidate.offset > objOffset && candidate.offset < nextOffset);
+	if (chartSubstream === void 0) return;
+	const placement = resolveAnchorPlacement(shape.anchor, geometry);
+	const rangeContext = {
+		formulaSheets: context.formulaSheets,
+		ownSheetIndex: context.ownSheetIndex,
+		ownSheetCells: context.ownSheetCells
+	};
+	const series = readChartSeries(chartSubstream.records, rangeContext);
+	return {
+		objectKind: "chart",
+		document: {
+			kind: "spreadsheet",
+			metadata: context.metadata,
+			sheets: [{
+				name: "Chart",
+				cells: chartTableCells(series),
+				columns: [],
+				rows: [],
+				images: [],
+				printSettings: {
+					pageSize: PAGE_SIZE_LETTER,
+					margins: {
+						topPt: 0,
+						rightPt: 0,
+						bottomPt: 0,
+						leftPt: 0
+					},
+					gridlines: false,
+					headers: false,
+					pageOrder: "downThenOver"
+				}
+			}]
+		},
+		frame: {
+			xPt: placement.xPt,
+			yPt: placement.yPt,
+			widthPt: placement.widthPt,
+			heightPt: placement.heightPt
+		},
+		anchorRow: placement.anchorRow,
+		anchorColumn: placement.anchorColumn,
+		offsetXPt: placement.offsetXPt,
+		offsetYPt: placement.offsetYPt
+	};
+}
+/** Lays a chart's own series out as ooxml.js's readChartTable does for the identical xlsx/pptx case: a header row of series names over the category column, then one row per category with each series' own value -- see workbook/chart.ts's own top comment for why this flattened shape, not a typed chart object, is what document-schema.js's 'chart' objectKind actually carries. */
+function chartTableCells(series) {
+	const cells = [];
+	series.forEach((entry, seriesIndex) => {
+		const name = entry.name ?? "";
+		if (name !== "") cells.push({
+			row: 0,
+			column: seriesIndex + 1,
+			value: {
+				kind: "string",
+				value: name
+			},
+			displayText: name
+		});
+		entry.values.forEach((value, pointIndex) => {
+			if (value === "") return;
+			cells.push({
+				row: pointIndex + 1,
+				column: seriesIndex + 1,
+				value: {
+					kind: "string",
+					value
+				},
+				displayText: value
+			});
+		});
+	});
+	const categories = /* @__PURE__ */ new Map();
+	for (const entry of series) entry.categories.forEach((category, pointIndex) => {
+		if (category !== "" && !categories.has(pointIndex)) categories.set(pointIndex, category);
+	});
+	for (const [pointIndex, category] of categories) cells.push({
+		row: pointIndex + 1,
+		column: 0,
+		value: {
+			kind: "string",
+			value: category
+		},
+		displayText: category
+	});
+	return cells;
+}
+/** A shape this reader recognises as neither a picture nor a chart -- an autoshape, a text box, a line, a group -- carried as a 'drawing' embedded object: a single-page ContentDocument holding one ContentShape sized and positioned at the shape's own anchor. Undefined for the patriarch/group-only case readSheetShapes already excludes, and for a shape whose own anchor collapses to zero size. */
+function drawingObjectFromShape(shape, geometry) {
+	const placement = resolveAnchorPlacement(shape.anchor, geometry);
+	if (placement.widthPt <= 0 || placement.heightPt <= 0) return;
+	return {
+		objectKind: "drawing",
+		document: {
+			kind: "drawing",
+			metadata: {},
+			pages: [{
+				size: {
+					widthPt: placement.widthPt,
+					heightPt: placement.heightPt
+				},
+				shapes: [{
+					frame: {
+						xPt: 0,
+						yPt: 0,
+						widthPt: placement.widthPt,
+						heightPt: placement.heightPt
+					},
+					insetLeftPt: 0,
+					insetTopPt: 0,
+					insetRightPt: 0,
+					insetBottomPt: 0,
+					blocks: []
+				}],
+				vectors: []
+			}]
+		},
+		frame: {
+			xPt: placement.xPt,
+			yPt: placement.yPt,
+			widthPt: placement.widthPt,
+			heightPt: placement.heightPt
+		},
+		anchorRow: placement.anchorRow,
+		anchorColumn: placement.anchorColumn,
+		offsetXPt: placement.offsetXPt,
+		offsetYPt: placement.offsetYPt
+	};
+}
+//#endregion
+export { chartTableCells, readSheetDrawing };

package/dist/workbook/globals-writer.d.cts

@@ -1,5 +1,5 @@
 import { E as XfDecorationFields } from "../xf-colors-mqerVt2O.cjs";
-import { t as PrintNamePlanEntry } from "../print-names-CCwUHAoL.cjs";
+import { t as PrintNamePlanEntry } from "../print-names-B2OR0fvs.cjs";
 import { Alignment, Color } from "document-schema.js";
 //#region src/workbook/globals-writer.d.ts
 /** [MS-XLS] 2.1.7.20.3's own XFS production requires at least sixteen XF records before any cell can reference one: BUILTIN_STYLES.length built-in cell styles, then at least one cell XF -- the "General, no declared format" one every workbook needs unconditionally, written immediately after them. Derived from BUILTIN_STYLES's own length rather than restated as a literal, so the two can never drift apart. */

package/dist/workbook/globals-writer.d.ts

@@ -1,5 +1,5 @@
 import { E as XfDecorationFields } from "../xf-colors-d3OvRw76.js";
-import { t as PrintNamePlanEntry } from "../print-names-CxAbgcjB.js";
+import { t as PrintNamePlanEntry } from "../print-names-BXcmmwVi.js";
 import { Alignment, Color } from "document-schema.js";
 //#region src/workbook/globals-writer.d.ts
 /** [MS-XLS] 2.1.7.20.3's own XFS production requires at least sixteen XF records before any cell can reference one: BUILTIN_STYLES.length built-in cell styles, then at least one cell XF -- the "General, no declared format" one every workbook needs unconditionally, written immediately after them. Derived from BUILTIN_STYLES's own length rather than restated as a literal, so the two can never drift apart. */

package/dist/workbook/globals.d.cts

@@ -1,7 +1,7 @@
 import { a as SheetRange, t as ExternalSheetLabel } from "../ptg-CCBbJLZJ.cjs";
-import { t as RecordGroup } from "../substreams-CHv3oWmn.cjs";
+import { t as RecordGroup } from "../substreams-XDNgDvRJ.cjs";
 import { E as XfDecorationFields, w as XfAlignmentFields } from "../xf-colors-mqerVt2O.cjs";
-import { n as SheetPrintNames } from "../print-names-CCwUHAoL.cjs";
+import { n as SheetPrintNames } from "../print-names-B2OR0fvs.cjs";
 import { Color } from "document-schema.js";
 //#region src/workbook/globals.d.ts
 /** One sheet, as its BoundSheet8 record describes it ([MS-XLS] 2.4.28). */

package/dist/workbook/globals.d.ts

@@ -1,7 +1,7 @@
 import { a as SheetRange, t as ExternalSheetLabel } from "../ptg-CCBbJLZJ.js";
-import { t as RecordGroup } from "../substreams-Dp5cZoUo.js";
+import { t as RecordGroup } from "../substreams-CgTHx5kX.js";
 import { E as XfDecorationFields, w as XfAlignmentFields } from "../xf-colors-d3OvRw76.js";
-import { n as SheetPrintNames } from "../print-names-CxAbgcjB.js";
+import { n as SheetPrintNames } from "../print-names-BXcmmwVi.js";
 import { Color } from "document-schema.js";
 //#region src/workbook/globals.d.ts
 /** One sheet, as its BoundSheet8 record describes it ([MS-XLS] 2.4.28). */

package/dist/workbook/print-names.d.cts

@@ -1,2 +1,2 @@
-import { a as writePrintNameRecords, i as readPrintNames, n as SheetPrintNames, r as printNameEntriesFor, t as PrintNamePlanEntry } from "../print-names-CCwUHAoL.cjs";
+import { a as writePrintNameRecords, i as readPrintNames, n as SheetPrintNames, r as printNameEntriesFor, t as PrintNamePlanEntry } from "../print-names-B2OR0fvs.cjs";
 export { PrintNamePlanEntry, SheetPrintNames, printNameEntriesFor, readPrintNames, writePrintNameRecords };

package/dist/workbook/print-names.d.ts

@@ -1,2 +1,2 @@
-import { a as writePrintNameRecords, i as readPrintNames, n as SheetPrintNames, r as printNameEntriesFor, t as PrintNamePlanEntry } from "../print-names-CxAbgcjB.js";
+import { a as writePrintNameRecords, i as readPrintNames, n as SheetPrintNames, r as printNameEntriesFor, t as PrintNamePlanEntry } from "../print-names-BXcmmwVi.js";
 export { PrintNamePlanEntry, SheetPrintNames, printNameEntriesFor, readPrintNames, writePrintNameRecords };

package/dist/workbook/sheet-writer.cjs

@@ -2,11 +2,11 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_biff_record_types = require("../biff/record-types.cjs");
 const require_units = require("../units.cjs");
 const require_biff_print_setup = require("../biff/print-setup.cjs");
+const require_biff_errors = require("../biff/errors.cjs");
 const require_biff_write_errors = require("../biff/write-errors.cjs");
 const require_serial = require("../serial.cjs");
 const require_biff_builder = require("../biff/builder.cjs");
 const require_biff_record_writer = require("../biff/record-writer.cjs");
-const require_biff_errors = require("../biff/errors.cjs");
 const require_biff_bof_writer = require("../biff/bof-writer.cjs");
 const require_workbook_globals_writer = require("./globals-writer.cjs");
 const require_written_cells = require("../written-cells.cjs");