ooxml.js 4.3.0 → 4.4.0

package/dist/typed/xlsx/drawings.js

@@ -0,0 +1,169 @@
+import { attr, childrenWithTag, elementsWithTag, resolveRelationships, rootElement } from "../util.js";
+import { readCoreProperties } from "../shared/metadata.js";
+import { emuToPt } from "../shared/units.js";
+import { readChartTable } from "../pptx/chart.js";
+import { readPrintSettings } from "./print-settings.js";
+import { columnWidthCharsToPt } from "./units.js";
+//#region src/typed/xlsx/drawings.ts
+const CHART_GRAPHIC_URI = "http://schemas.openxmlformats.org/drawingml/2006/chart";
+const DRAWING_REL_SUFFIX = "/drawing";
+var SheetGridGeometry = class {
+	columns = [];
+	rowHeights = /* @__PURE__ */ new Map();
+	defaultRowHeightPt;
+	constructor(worksheet) {
+		const cols = childrenWithTag(worksheet, "cols")[0];
+		if (cols !== void 0) for (const col of childrenWithTag(cols, "col")) {
+			const min = Number.parseInt(attr(col, "min") ?? "", 10);
+			const max = Number.parseInt(attr(col, "max") ?? "", 10);
+			const widthRaw = attr(col, "width");
+			const widthPt = widthRaw === void 0 ? void 0 : columnWidthCharsToPt(Number(widthRaw));
+			if (Number.isInteger(min) && Number.isInteger(max) && min >= 1 && max >= min) this.columns.push({
+				min: min - 1,
+				max: max - 1,
+				widthPt: Number.isFinite(widthPt) ? widthPt : void 0
+			});
+		}
+		const sheetFormatPr = childrenWithTag(worksheet, "sheetFormatPr")[0];
+		const defaultRaw = sheetFormatPr === void 0 ? void 0 : attr(sheetFormatPr, "defaultRowHeight");
+		const parsed = defaultRaw === void 0 ? NaN : Number(defaultRaw);
+		this.defaultRowHeightPt = Number.isFinite(parsed) ? parsed : 15;
+		const sheetData = childrenWithTag(worksheet, "sheetData")[0];
+		if (sheetData !== void 0) for (const row of childrenWithTag(sheetData, "row")) {
+			const r = Number.parseInt(attr(row, "r") ?? "", 10);
+			const htRaw = attr(row, "ht");
+			const ht = htRaw === void 0 ? NaN : Number(htRaw);
+			if (Number.isInteger(r) && r >= 1 && Number.isFinite(ht)) this.rowHeights.set(r - 1, ht);
+		}
+	}
+	columnWidthPt(index) {
+		return this.columns.find((column) => index >= column.min && index <= column.max && column.widthPt !== void 0)?.widthPt ?? columnWidthCharsToPt(8.43);
+	}
+	rowHeightPt(index) {
+		return this.rowHeights.get(index) ?? this.defaultRowHeightPt;
+	}
+	xPt(column, colOffEmu) {
+		let xPt = emuToPt(colOffEmu);
+		for (let index = 0; index < column; index++) xPt += this.columnWidthPt(index);
+		return xPt;
+	}
+	yPt(row, rowOffEmu) {
+		let yPt = emuToPt(rowOffEmu);
+		for (let index = 0; index < row; index++) yPt += this.rowHeightPt(index);
+		return yPt;
+	}
+};
+function readAnchorChild(marker, tag) {
+	const child = childrenWithTag(marker, tag)[0];
+	const text = child === void 0 ? void 0 : child.children.map((node) => node.type === "text" ? node.value : "").join("");
+	const parsed = text === void 0 || text === "" ? NaN : Number(text);
+	return Number.isFinite(parsed) ? parsed : 0;
+}
+function readAnchorMarker(parent, tag) {
+	const marker = childrenWithTag(parent, tag)[0];
+	if (marker === void 0) return;
+	return {
+		column: readAnchorChild(marker, "xdr:col"),
+		colOffEmu: readAnchorChild(marker, "xdr:colOff"),
+		row: readAnchorChild(marker, "xdr:row"),
+		rowOffEmu: readAnchorChild(marker, "xdr:rowOff")
+	};
+}
+function emptyWorksheet() {
+	return {
+		type: "element",
+		tag: "worksheet",
+		attributes: [],
+		children: []
+	};
+}
+function chartCells(chartRoot, frame) {
+	const table = readChartTable(chartRoot, frame);
+	if (table === void 0) return [];
+	const cells = [];
+	table.rows.forEach((row, rowIndex) => {
+		row.cells.forEach((cell, columnIndex) => {
+			const text = cell.blocks.map((block) => block.kind === "paragraph" ? block.runs.map((run) => run.text).join("") : "").join("");
+			if (text !== "") cells.push({
+				row: rowIndex,
+				column: columnIndex,
+				value: {
+					kind: "string",
+					value: text
+				},
+				displayText: text
+			});
+		});
+	});
+	return cells;
+}
+function readSheetEmbeddedObjects(pkg, worksheetPath, worksheet) {
+	let drawingPath;
+	for (const rel of resolveRelationships(pkg, worksheetPath).values()) if (rel.type.endsWith(DRAWING_REL_SUFFIX)) {
+		drawingPath = rel.target;
+		break;
+	}
+	const drawingRoot = drawingPath === void 0 ? void 0 : rootElement(pkg.parts[drawingPath]);
+	if (drawingRoot === void 0) return;
+	const drawingRels = drawingPath === void 0 ? void 0 : resolveRelationships(pkg, drawingPath);
+	const geometry = new SheetGridGeometry(worksheet);
+	const objects = [];
+	for (const anchor of childrenWithTag(drawingRoot, "xdr:twoCellAnchor")) {
+		const from = readAnchorMarker(anchor, "xdr:from");
+		const to = readAnchorMarker(anchor, "xdr:to");
+		if (from === void 0 || to === void 0) continue;
+		for (const frame of elementsWithTag([anchor], "xdr:graphicFrame")) {
+			const chart = readChartFrame(pkg, frame, drawingRels);
+			if (chart === void 0) continue;
+			const xPt = geometry.xPt(from.column, from.colOffEmu);
+			const yPt = geometry.yPt(from.row, from.rowOffEmu);
+			const frameBox = {
+				xPt,
+				yPt,
+				widthPt: geometry.xPt(to.column, to.colOffEmu) - xPt,
+				heightPt: geometry.yPt(to.row, to.rowOffEmu) - yPt
+			};
+			objects.push({
+				objectKind: "chart",
+				document: chartDocument(pkg, chart.root, frameBox, chart.name),
+				frame: frameBox,
+				anchorRow: from.row,
+				anchorColumn: from.column,
+				offsetXPt: emuToPt(from.colOffEmu),
+				offsetYPt: emuToPt(from.rowOffEmu)
+			});
+		}
+	}
+	return objects.length === 0 ? void 0 : objects;
+}
+function readChartFrame(pkg, frame, drawingRels) {
+	const graphic = childrenWithTag(frame, "a:graphic")[0];
+	const graphicData = graphic === void 0 ? void 0 : childrenWithTag(graphic, "a:graphicData")[0];
+	if (graphicData === void 0 || attr(graphicData, "uri") !== CHART_GRAPHIC_URI) return;
+	const chartRef = childrenWithTag(graphicData, "c:chart")[0];
+	const rId = chartRef === void 0 ? void 0 : attr(chartRef, "r:id");
+	const target = rId === void 0 ? void 0 : drawingRels?.get(rId)?.target;
+	const chartRoot = target === void 0 ? void 0 : rootElement(pkg.parts[target]);
+	if (chartRoot === void 0) return;
+	const cNvPr = elementsWithTag([frame], "xdr:cNvPr")[0];
+	return {
+		root: chartRoot,
+		name: cNvPr === void 0 ? "Chart" : attr(cNvPr, "name") ?? "Chart"
+	};
+}
+function chartDocument(pkg, chartRoot, frame, name) {
+	return {
+		kind: "spreadsheet",
+		metadata: readCoreProperties(pkg),
+		sheets: [{
+			name,
+			cells: chartCells(chartRoot, frame),
+			columns: [],
+			rows: [],
+			images: [],
+			printSettings: readPrintSettings(emptyWorksheet(), 0, /* @__PURE__ */ new Map())
+		}]
+	};
+}
+//#endregion
+export { readSheetEmbeddedObjects };

package/dist/typed/xlsx/units.cjs

@@ -4,6 +4,7 @@ require("../shared/units.cjs");
 const PIXELS_PER_INCH = 96;
 const MAX_DIGIT_WIDTH_PX = 7;
 const DEFAULT_ROW_HEIGHT_PT = 15;
+const DEFAULT_COLUMN_WIDTH_CHARS = 8.43;
 function columnWidthCharsToPt(width) {
 	const digitWidthAllowance = Math.trunc(128 / 7);
 	return Math.trunc((256 * width + digitWidthAllowance) / 256 * 7) / 96 * 72;
@@ -14,6 +15,7 @@ function ptToColumnWidthChars(widthPt) {
 	return pixels / 7 - digitWidthAllowance / 256;
 }
 //#endregion
+exports.DEFAULT_COLUMN_WIDTH_CHARS = DEFAULT_COLUMN_WIDTH_CHARS;
 exports.DEFAULT_ROW_HEIGHT_PT = DEFAULT_ROW_HEIGHT_PT;
 exports.MAX_DIGIT_WIDTH_PX = MAX_DIGIT_WIDTH_PX;
 exports.PIXELS_PER_INCH = PIXELS_PER_INCH;

package/dist/typed/xlsx/units.d.cts

@@ -2,7 +2,8 @@
 declare const PIXELS_PER_INCH = 96;
 declare const MAX_DIGIT_WIDTH_PX = 7;
 declare const DEFAULT_ROW_HEIGHT_PT = 15;
+declare const DEFAULT_COLUMN_WIDTH_CHARS = 8.43;
 declare function columnWidthCharsToPt(width: number): number;
 declare function ptToColumnWidthChars(widthPt: number): number;
 //#endregion
-export { DEFAULT_ROW_HEIGHT_PT, MAX_DIGIT_WIDTH_PX, PIXELS_PER_INCH, columnWidthCharsToPt, ptToColumnWidthChars };
+export { DEFAULT_COLUMN_WIDTH_CHARS, DEFAULT_ROW_HEIGHT_PT, MAX_DIGIT_WIDTH_PX, PIXELS_PER_INCH, columnWidthCharsToPt, ptToColumnWidthChars };

package/dist/typed/xlsx/units.d.ts

@@ -2,7 +2,8 @@
 declare const PIXELS_PER_INCH = 96;
 declare const MAX_DIGIT_WIDTH_PX = 7;
 declare const DEFAULT_ROW_HEIGHT_PT = 15;
+declare const DEFAULT_COLUMN_WIDTH_CHARS = 8.43;
 declare function columnWidthCharsToPt(width: number): number;
 declare function ptToColumnWidthChars(widthPt: number): number;
 //#endregion
-export { DEFAULT_ROW_HEIGHT_PT, MAX_DIGIT_WIDTH_PX, PIXELS_PER_INCH, columnWidthCharsToPt, ptToColumnWidthChars };
+export { DEFAULT_COLUMN_WIDTH_CHARS, DEFAULT_ROW_HEIGHT_PT, MAX_DIGIT_WIDTH_PX, PIXELS_PER_INCH, columnWidthCharsToPt, ptToColumnWidthChars };

package/dist/typed/xlsx/units.js

@@ -3,6 +3,7 @@ import "../shared/units.js";
 const PIXELS_PER_INCH = 96;
 const MAX_DIGIT_WIDTH_PX = 7;
 const DEFAULT_ROW_HEIGHT_PT = 15;
+const DEFAULT_COLUMN_WIDTH_CHARS = 8.43;
 function columnWidthCharsToPt(width) {
 	const digitWidthAllowance = Math.trunc(128 / 7);
 	return Math.trunc((256 * width + digitWidthAllowance) / 256 * 7) / 96 * 72;
@@ -13,4 +14,4 @@ function ptToColumnWidthChars(widthPt) {
 	return pixels / 7 - digitWidthAllowance / 256;
 }
 //#endregion
-export { DEFAULT_ROW_HEIGHT_PT, MAX_DIGIT_WIDTH_PX, PIXELS_PER_INCH, columnWidthCharsToPt, ptToColumnWidthChars };
+export { DEFAULT_COLUMN_WIDTH_CHARS, DEFAULT_ROW_HEIGHT_PT, MAX_DIGIT_WIDTH_PX, PIXELS_PER_INCH, columnWidthCharsToPt, ptToColumnWidthChars };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ooxml.js",
-  "version": "4.3.0",
+  "version": "4.4.0",
   "description": "Type-safe, lossless round-trip conversion between OOXML packages (docx, pptx, xlsx) and JSON, built on Zod 4 codecs.",
   "type": "module",
   "repository": {
@@ -81,7 +81,7 @@
   "packageManager": "pnpm@11.6.0",
   "dependencies": {
     "archive-codec": "^1.1.0",
-    "document-schema.js": "^4.5.0",
+    "document-schema.js": "^4.6.0",
     "fast-xml-parser": "^5.10.1",
     "fflate": "^0.8.3",
     "zod": "^4.4.3"