odf.js 1.6.0 → 1.7.0

package/dist/index.cjs

@@ -1421,6 +1421,25 @@ function cellReference(columnIndex, rowIndex) {
 	if (!Number.isInteger(rowIndex) || rowIndex < 0) throw new Error(`cellReference: rowIndex must be a non-negative integer, got ${rowIndex}`);
 	return `${columnIndexToLetters(columnIndex)}${rowIndex + 1}`;
 }
+function columnLettersToIndex(letters) {
+	if (!/^[A-Z]+$/.test(letters)) return;
+	let index = 0;
+	for (const char of letters) index = index * ALPHABET_SIZE + (char.charCodeAt(0) - ALPHABET_START_CODE + 1);
+	return index - 1;
+}
+function parseCellReference(reference) {
+	const match = /^([A-Z]+)(\d+)$/.exec(reference);
+	if (match === null) return;
+	const [, letters, digits] = match;
+	if (letters === void 0 || digits === void 0) return;
+	const column = columnLettersToIndex(letters);
+	const row = Number.parseInt(digits, 10) - 1;
+	if (column === void 0 || row < 0) return;
+	return {
+		column,
+		row
+	};
+}
 function validateRepeatCount(repeatCount, caller) {
 	if (!Number.isInteger(repeatCount) || repeatCount < 1) throw new Error(`${caller}: repeatCount must be a positive integer, got ${repeatCount}`);
 }
@@ -1702,7 +1721,7 @@ function readOdfParagraph(pElement, pkg) {
 }
 //#endregion
 //#region src/typed/shared/table.ts
-function readRepeatCount(element, attrName) {
+function readRepeatCount$1(element, attrName) {
 	const raw = attrValue(element, attrName);
 	if (raw === void 0) return 1;
 	const parsed = Number.parseInt(raw, 10);
@@ -1745,11 +1764,11 @@ function readTableRow(rowElement, pkg) {
 	for (const child of rowElement.children) {
 		if (child.type !== "element") continue;
 		if (child.tag === "table:covered-table-cell") {
-			const repeat = readRepeatCount(child, "table:number-columns-repeated");
+			const repeat = readRepeatCount$1(child, "table:number-columns-repeated");
 			for (let i = 0; i < repeat; i++) cells.push({ blocks: [] });
 		} else if (child.tag === "table:table-cell") {
 			const cell = readTableCell(child, pkg);
-			const repeat = readRepeatCount(child, "table:number-columns-repeated");
+			const repeat = readRepeatCount$1(child, "table:number-columns-repeated");
 			for (let i = 0; i < repeat; i++) cells.push(cell);
 		}
 	}
@@ -1762,13 +1781,13 @@ function readOdfTable(tableElement, pkg) {
 	const columnWidthsPt = [];
 	for (const column of childrenWithTag(tableElement, "table:table-column")) {
 		const widthPt = resolveColumnWidthPt(column, pkg);
-		const repeat = readRepeatCount(column, "table:number-columns-repeated");
+		const repeat = readRepeatCount$1(column, "table:number-columns-repeated");
 		for (let i = 0; i < repeat; i++) columnWidthsPt.push(widthPt);
 	}
 	const rows = [];
 	for (const rowElement of childrenWithTag(tableElement, "table:table-row")) {
 		const row = readTableRow(rowElement, pkg);
-		const repeat = readRepeatCount(rowElement, "table:number-rows-repeated");
+		const repeat = readRepeatCount$1(rowElement, "table:number-rows-repeated");
 		for (let i = 0; i < repeat; i++) rows.push(row);
 	}
 	return {
@@ -1905,10 +1924,13 @@ function findPageLayoutElement$1(pkg, pageLayoutName) {
 		if (found !== void 0) return found;
 	}
 }
-function resolveDrawPageSize(page, pkg) {
-	const masterPage = findMasterPageElement(pkg, attrValue(page, "draw:master-page-name"));
+function resolvePageLayoutProperties(pkg, masterPageName) {
+	const masterPage = findMasterPageElement(pkg, masterPageName);
 	const pageLayout = findPageLayoutElement$1(pkg, masterPage === void 0 ? void 0 : attrValue(masterPage, "style:page-layout-name"));
-	const properties = pageLayout === void 0 ? void 0 : childrenWithTag(pageLayout, "style:page-layout-properties")[0];
+	return pageLayout === void 0 ? void 0 : childrenWithTag(pageLayout, "style:page-layout-properties")[0];
+}
+function resolveDrawPageSize(page, pkg) {
+	const properties = resolvePageLayoutProperties(pkg, attrValue(page, "draw:master-page-name"));
 	return properties === void 0 ? void 0 : parsePageSize(properties);
 }
 //#endregion
@@ -2462,7 +2484,7 @@ function readDrawPageContent(children, pkg) {
 }
 //#endregion
 //#region src/typed/odp/read.ts
-const CONTENT_PART$2 = "content.xml";
+const CONTENT_PART$3 = "content.xml";
 function readSlideSize(page, pkg) {
 	return resolveDrawPageSize(page, pkg) ?? document_content_model.SLIDE_SIZE_WIDESCREEN;
 }
@@ -2481,7 +2503,7 @@ function readSlide(page, pkg) {
 	};
 }
 function readOdp(pkg) {
-	const contentPart = pkg.parts[CONTENT_PART$2];
+	const contentPart = pkg.parts[CONTENT_PART$3];
 	const root = contentPart?.kind === "xml" ? rootElement(contentPart.nodes) : void 0;
 	const body = root === void 0 ? void 0 : findChildElement(root.children, "office:body");
 	const presentation = body === void 0 ? void 0 : findChildElement(body.children, "office:presentation");
@@ -2493,9 +2515,9 @@ function readOdp(pkg) {
 }
 //#endregion
 //#region src/typed/odt/read.ts
-const CONTENT_PART$1 = "content.xml";
+const CONTENT_PART$2 = "content.xml";
 const STYLES_PART = "styles.xml";
-const AUTOMATIC_STYLE_PARTS = [CONTENT_PART$1, STYLES_PART];
+const AUTOMATIC_STYLE_PARTS = [CONTENT_PART$2, STYLES_PART];
 function readOutlineLevel(headingElement) {
 	const raw = attrValue(headingElement, "text:outline-level");
 	if (raw === void 0) return 1;
@@ -2538,18 +2560,18 @@ function readBlocks(nodes, pkg, listIdState) {
 	}
 	return blocks;
 }
-function parseKnownOdfLength(value) {
+function parseKnownOdfLength$1(value) {
 	const parsed = parseOdfLength(value);
 	if (parsed === void 0) throw new Error(`readOdt: internal error -- "${value}" is not a valid ODF length literal`);
 	return parsed;
 }
-const DEFAULT_PAGE_SIZE$1 = document_content_model.PAGE_SIZE_A4;
-const DEFAULT_MARGIN_PT = parseKnownOdfLength("2cm");
-const DEFAULT_MARGINS = {
-	topPt: DEFAULT_MARGIN_PT,
-	rightPt: DEFAULT_MARGIN_PT,
-	bottomPt: DEFAULT_MARGIN_PT,
-	leftPt: DEFAULT_MARGIN_PT
+const DEFAULT_PAGE_SIZE$2 = document_content_model.PAGE_SIZE_A4;
+const DEFAULT_MARGIN_PT$1 = parseKnownOdfLength$1("2cm");
+const DEFAULT_MARGINS$1 = {
+	topPt: DEFAULT_MARGIN_PT$1,
+	rightPt: DEFAULT_MARGIN_PT$1,
+	bottomPt: DEFAULT_MARGIN_PT$1,
+	leftPt: DEFAULT_MARGIN_PT$1
 };
 function findPageLayoutElement(pkg, pageLayoutName) {
 	if (pageLayoutName === void 0) return;
@@ -2573,17 +2595,17 @@ function readFirstMasterPageGeometry(pkg) {
 	const pageSize = properties === void 0 ? void 0 : parsePageSize(properties);
 	const margins = properties === void 0 ? void 0 : parseMargins(properties);
 	return {
-		pageSize: pageSize ?? DEFAULT_PAGE_SIZE$1,
-		margins: margins ?? DEFAULT_MARGINS
+		pageSize: pageSize ?? DEFAULT_PAGE_SIZE$2,
+		margins: margins ?? DEFAULT_MARGINS$1
 	};
 }
 function readOdt(pkg) {
-	const contentPart = pkg.parts[CONTENT_PART$1];
-	if (contentPart?.kind !== "xml") throw new Error(`readOdt: package has no ${CONTENT_PART$1} part`);
+	const contentPart = pkg.parts[CONTENT_PART$2];
+	if (contentPart?.kind !== "xml") throw new Error(`readOdt: package has no ${CONTENT_PART$2} part`);
 	const contentRoot = rootElement(contentPart.nodes);
 	const body = contentRoot === void 0 ? void 0 : findChildElement(contentRoot.children, "office:body");
 	const textElement = body === void 0 ? void 0 : findChildElement(body.children, "office:text");
-	if (textElement === void 0) throw new Error(`readOdt: ${CONTENT_PART$1} has no office:body/office:text element`);
+	if (textElement === void 0) throw new Error(`readOdt: ${CONTENT_PART$2} has no office:body/office:text element`);
 	const metadata = readOdfMetadata(pkg);
 	const { pageSize, margins } = readFirstMasterPageGeometry(pkg);
 	return {
@@ -2597,10 +2619,10 @@ function readOdt(pkg) {
 }
 //#endregion
 //#region src/typed/odg/read.ts
-const CONTENT_PART = "content.xml";
-const DEFAULT_PAGE_SIZE = document_content_model.PAGE_SIZE_A4;
+const CONTENT_PART$1 = "content.xml";
+const DEFAULT_PAGE_SIZE$1 = document_content_model.PAGE_SIZE_A4;
 function readPage(page, pkg) {
-	const size = resolveDrawPageSize(page, pkg) ?? DEFAULT_PAGE_SIZE;
+	const size = resolveDrawPageSize(page, pkg) ?? DEFAULT_PAGE_SIZE$1;
 	const { shapes, vectors } = readDrawPageContent(page.children, pkg);
 	return {
 		size,
@@ -2609,7 +2631,7 @@ function readPage(page, pkg) {
 	};
 }
 function readOdg(pkg) {
-	const contentPart = pkg.parts[CONTENT_PART];
+	const contentPart = pkg.parts[CONTENT_PART$1];
 	const root = contentPart?.kind === "xml" ? rootElement(contentPart.nodes) : void 0;
 	const body = root === void 0 ? void 0 : findChildElement(root.children, "office:body");
 	const drawing = body === void 0 ? void 0 : findChildElement(body.children, "office:drawing");
@@ -2620,6 +2642,313 @@ function readOdg(pkg) {
 	};
 }
 //#endregion
+//#region src/typed/ods/read.ts
+const CONTENT_PART = "content.xml";
+function parseKnownOdfLength(value) {
+	const parsed = parseOdfLength(value);
+	if (parsed === void 0) throw new Error(`readOds: internal error -- "${value}" is not a valid ODF length literal`);
+	return parsed;
+}
+const DEFAULT_PAGE_SIZE = document_content_model.PAGE_SIZE_A4;
+const DEFAULT_MARGIN_PT = parseKnownOdfLength("2cm");
+const DEFAULT_MARGINS = {
+	topPt: DEFAULT_MARGIN_PT,
+	rightPt: DEFAULT_MARGIN_PT,
+	bottomPt: DEFAULT_MARGIN_PT,
+	leftPt: DEFAULT_MARGIN_PT
+};
+function readRepeatCount(element, attrName) {
+	const raw = attrValue(element, attrName);
+	if (raw === void 0) return 1;
+	const parsed = Number.parseInt(raw, 10);
+	return Number.isInteger(parsed) && parsed > 0 ? parsed : 1;
+}
+function isHidden(element) {
+	return attrValue(element, "table:visibility") === "collapse";
+}
+function readColumnLayout(columnElement, pkg) {
+	const styleName = attrValue(columnElement, "table:style-name");
+	const styleElement = styleName === void 0 ? void 0 : findStyleElement(styleName, "table-column", pkg);
+	const properties = styleElement === void 0 ? void 0 : childrenWithTag(styleElement, "style:table-column-properties")[0];
+	const widthValue = properties === void 0 ? void 0 : attrValue(properties, "style:column-width");
+	return {
+		widthPt: widthValue === void 0 ? 0 : parseOdfLength(widthValue) ?? 0,
+		manualBreak: (properties === void 0 ? void 0 : attrValue(properties, "fo:break-before")) === "page"
+	};
+}
+function readRowLayout(rowElement, pkg) {
+	const styleName = attrValue(rowElement, "table:style-name");
+	const styleElement = styleName === void 0 ? void 0 : findStyleElement(styleName, "table-row", pkg);
+	const properties = styleElement === void 0 ? void 0 : childrenWithTag(styleElement, "style:table-row-properties")[0];
+	const heightValue = properties === void 0 ? void 0 : attrValue(properties, "style:row-height");
+	return {
+		heightPt: heightValue === void 0 ? 0 : parseOdfLength(heightValue) ?? 0,
+		manualBreak: (properties === void 0 ? void 0 : attrValue(properties, "fo:break-before")) === "page"
+	};
+}
+function readCellText(cellElement, pkg) {
+	const paragraphs = childrenWithTag(cellElement, "text:p");
+	const runs = [];
+	paragraphs.forEach((paragraph, index) => {
+		if (index > 0) runs.push({ text: "\n" });
+		runs.push(...readOdfParagraph(paragraph, pkg).runs);
+	});
+	return {
+		runs,
+		displayText: runs.map((run) => run.text).join("")
+	};
+}
+function readCellValue(cellElement, displayText) {
+	const valueType = attrValue(cellElement, "office:value-type");
+	const stringFallback = {
+		kind: "string",
+		value: displayText
+	};
+	switch (valueType) {
+		case "float": {
+			const value = parseRequiredNumber(attrValue(cellElement, "office:value"));
+			return value === void 0 ? stringFallback : {
+				kind: "number",
+				value
+			};
+		}
+		case "percentage": {
+			const value = parseRequiredNumber(attrValue(cellElement, "office:value"));
+			return value === void 0 ? stringFallback : {
+				kind: "percentage",
+				value
+			};
+		}
+		case "currency": {
+			const value = parseRequiredNumber(attrValue(cellElement, "office:value"));
+			if (value === void 0) return stringFallback;
+			const currency = attrValue(cellElement, "office:currency");
+			return currency === void 0 ? {
+				kind: "currency",
+				value
+			} : {
+				kind: "currency",
+				value,
+				currency
+			};
+		}
+		case "boolean": {
+			const raw = attrValue(cellElement, "office:boolean-value");
+			return raw === void 0 ? stringFallback : {
+				kind: "boolean",
+				value: raw === "true"
+			};
+		}
+		case "date": return {
+			kind: "date",
+			value: attrValue(cellElement, "office:date-value") ?? displayText
+		};
+		case "time": return {
+			kind: "time",
+			value: attrValue(cellElement, "office:time-value") ?? displayText
+		};
+		case "string": return {
+			kind: "string",
+			value: attrValue(cellElement, "office:string-value") ?? displayText
+		};
+		default: return { kind: "empty" };
+	}
+}
+function parseRequiredNumber(raw) {
+	if (raw === void 0) return;
+	const value = Number(raw);
+	return Number.isNaN(value) ? void 0 : value;
+}
+function parsePrintRanges(value) {
+	const first = value.split(" ").find((part) => part.length > 0);
+	if (first === void 0) return;
+	const separatorIndex = first.indexOf(":");
+	if (separatorIndex === -1) return;
+	const start = parseA1WithOptionalSheetPrefix(first.slice(0, separatorIndex));
+	const end = parseA1WithOptionalSheetPrefix(first.slice(separatorIndex + 1));
+	if (start === void 0 || end === void 0) return;
+	return {
+		startRow: start.row,
+		startColumn: start.column,
+		endRow: end.row,
+		endColumn: end.column
+	};
+}
+function parseA1WithOptionalSheetPrefix(cellPart) {
+	const dotIndex = cellPart.lastIndexOf(".");
+	return parseCellReference(dotIndex === -1 ? cellPart : cellPart.slice(dotIndex + 1));
+}
+function parseScalePercentage(value) {
+	const match = /^(\d+(?:\.\d+)?)%$/.exec(value);
+	if (match === null) return;
+	const numeric = match[1];
+	return numeric === void 0 ? void 0 : Number(numeric);
+}
+function parseNonNegativeInteger(value) {
+	if (value === void 0) return;
+	const parsed = Number.parseInt(value, 10);
+	return Number.isInteger(parsed) && parsed >= 0 ? parsed : void 0;
+}
+function readTable(tableElement, pkg) {
+	const columns = [];
+	const rows = [];
+	const cells = [];
+	const manualBreakRows = [];
+	const manualBreakColumns = [];
+	let repeatColumns;
+	let repeatRows;
+	let columnCursor = 0;
+	const cursor = new TableCursor();
+	function processColumn(columnElement) {
+		const startIndex = columnCursor;
+		const { widthPt, manualBreak } = readColumnLayout(columnElement, pkg);
+		columns.push({
+			index: startIndex,
+			widthPt,
+			hidden: isHidden(columnElement) ? true : void 0
+		});
+		if (manualBreak) manualBreakColumns.push(startIndex);
+		columnCursor += readRepeatCount(columnElement, "table:number-columns-repeated");
+	}
+	function processRowCells(rowElement) {
+		for (const child of rowElement.children) {
+			if (child.type !== "element") continue;
+			if (child.tag === "table:covered-table-cell") cursor.nextCell(readRepeatCount(child, "table:number-columns-repeated"));
+			else if (child.tag === "table:table-cell") {
+				const columnIndex = cursor.columnIndex;
+				const rowIndex = cursor.rowIndex;
+				cursor.nextCell(readRepeatCount(child, "table:number-columns-repeated"));
+				const formula = attrValue(child, "table:formula");
+				const { runs, displayText } = readCellText(child, pkg);
+				if (!(attrValue(child, "office:value-type") !== void 0) && formula === void 0 && displayText.length === 0) continue;
+				const value = readCellValue(child, displayText);
+				const colSpan = parseNonNegativeInteger(attrValue(child, "table:number-columns-spanned"));
+				const rowSpan = parseNonNegativeInteger(attrValue(child, "table:number-rows-spanned"));
+				const cell = {
+					row: rowIndex,
+					column: columnIndex,
+					value,
+					displayText
+				};
+				if (formula !== void 0) cell.formula = formula;
+				if (runs.length > 0) cell.runs = runs;
+				if (colSpan !== void 0) cell.colSpan = colSpan;
+				if (rowSpan !== void 0) cell.rowSpan = rowSpan;
+				cells.push(cell);
+			}
+		}
+	}
+	function processRow(rowElement) {
+		const startIndex = cursor.rowIndex;
+		processRowCells(rowElement);
+		const { heightPt, manualBreak } = readRowLayout(rowElement, pkg);
+		rows.push({
+			index: startIndex,
+			heightPt,
+			hidden: isHidden(rowElement) ? true : void 0
+		});
+		if (manualBreak) manualBreakRows.push(startIndex);
+		cursor.nextRow(readRepeatCount(rowElement, "table:number-rows-repeated"));
+	}
+	for (const child of tableElement.children) {
+		if (child.type !== "element") continue;
+		if (child.tag === "table:table-column") processColumn(child);
+		else if (child.tag === "table:table-header-columns") {
+			const startIndex = columnCursor;
+			for (const headerChild of child.children) if (headerChild.type === "element" && headerChild.tag === "table:table-column") processColumn(headerChild);
+			if (columnCursor > startIndex) repeatColumns = {
+				start: startIndex,
+				end: columnCursor - 1
+			};
+		} else if (child.tag === "table:table-row") processRow(child);
+		else if (child.tag === "table:table-header-rows") {
+			const startIndex = cursor.rowIndex;
+			for (const headerChild of child.children) if (headerChild.type === "element" && headerChild.tag === "table:table-row") processRow(headerChild);
+			if (cursor.rowIndex > startIndex) repeatRows = {
+				start: startIndex,
+				end: cursor.rowIndex - 1
+			};
+		}
+	}
+	return {
+		columns,
+		rows,
+		cells,
+		repeatColumns,
+		repeatRows,
+		manualBreakRows,
+		manualBreakColumns
+	};
+}
+function readPrintSettings(tableElement, pkg, repeatColumns, repeatRows, manualBreakRows, manualBreakColumns) {
+	const tableStyleName = attrValue(tableElement, "table:style-name");
+	const tableStyleElement = tableStyleName === void 0 ? void 0 : findStyleElement(tableStyleName, "table", pkg);
+	const layoutProperties = resolvePageLayoutProperties(pkg, tableStyleElement === void 0 ? void 0 : attrValue(tableStyleElement, "style:master-page-name"));
+	const pageSize = layoutProperties === void 0 ? void 0 : parsePageSize(layoutProperties);
+	const margins = layoutProperties === void 0 ? void 0 : parseMargins(layoutProperties);
+	const printTokens = new Set((layoutProperties === void 0 ? void 0 : attrValue(layoutProperties, "style:print"))?.split(" ").filter((token) => token.length > 0));
+	const pageOrder = (layoutProperties === void 0 ? void 0 : attrValue(layoutProperties, "style:print-page-order")) === "ltr" ? "overThenDown" : "downThenOver";
+	const scaleToRaw = layoutProperties === void 0 ? void 0 : attrValue(layoutProperties, "style:scale-to");
+	const scale = scaleToRaw === void 0 ? void 0 : parseScalePercentage(scaleToRaw);
+	const scaleToXRaw = layoutProperties === void 0 ? void 0 : attrValue(layoutProperties, "style:scale-to-X");
+	const scaleToYRaw = layoutProperties === void 0 ? void 0 : attrValue(layoutProperties, "style:scale-to-Y");
+	const fitWidth = parseNonNegativeInteger(scaleToXRaw);
+	const fitHeight = parseNonNegativeInteger(scaleToYRaw);
+	const fitToPages = fitWidth === void 0 || fitHeight === void 0 ? void 0 : {
+		width: fitWidth,
+		height: fitHeight
+	};
+	const printRangesRaw = attrValue(tableElement, "table:print-ranges");
+	const printRange = printRangesRaw === void 0 ? void 0 : parsePrintRanges(printRangesRaw);
+	const manualBreaks = manualBreakRows.length > 0 || manualBreakColumns.length > 0 ? {
+		rows: manualBreakRows,
+		columns: manualBreakColumns
+	} : void 0;
+	const settings = {
+		pageSize: pageSize ?? DEFAULT_PAGE_SIZE,
+		margins: margins ?? DEFAULT_MARGINS,
+		gridlines: printTokens.has("grid"),
+		headers: printTokens.has("headers"),
+		pageOrder
+	};
+	if (printRange !== void 0) settings.printRange = printRange;
+	if (scale !== void 0) settings.scale = scale;
+	if (fitToPages !== void 0) settings.fitToPages = fitToPages;
+	if (repeatRows !== void 0) settings.repeatRows = repeatRows;
+	if (repeatColumns !== void 0) settings.repeatColumns = repeatColumns;
+	if (manualBreaks !== void 0) settings.manualBreaks = manualBreaks;
+	return settings;
+}
+function readSheet(tableElement, pkg) {
+	const name = attrValue(tableElement, "table:name");
+	if (name === void 0) return;
+	const { columns, rows, cells, repeatColumns, repeatRows, manualBreakRows, manualBreakColumns } = readTable(tableElement, pkg);
+	return {
+		name,
+		cells,
+		columns,
+		rows,
+		images: [],
+		printSettings: readPrintSettings(tableElement, pkg, repeatColumns, repeatRows, manualBreakRows, manualBreakColumns)
+	};
+}
+function readOds(pkg) {
+	const contentPart = pkg.parts[CONTENT_PART];
+	const root = contentPart?.kind === "xml" ? rootElement(contentPart.nodes) : void 0;
+	const body = root === void 0 ? void 0 : findChildElement(root.children, "office:body");
+	const spreadsheet = body === void 0 ? void 0 : findChildElement(body.children, "office:spreadsheet");
+	const tables = spreadsheet === void 0 ? [] : childrenWithTag(spreadsheet, "table:table");
+	const sheets = [];
+	for (const table of tables) {
+		const sheet = readSheet(table, pkg);
+		if (sheet !== void 0) sheets.push(sheet);
+	}
+	return {
+		metadata: readOdfMetadata(pkg),
+		sheets
+	};
+}
+//#endregion
 Object.defineProperty(exports, "AlignmentSchema", {
 	enumerable: true,
 	get: function() {
@@ -2662,6 +2991,7 @@ exports.canonicalPropertiesString = canonicalPropertiesString;
 exports.cellReference = cellReference;
 exports.childrenWithTag = childrenWithTag;
 exports.columnIndexToLetters = columnIndexToLetters;
+exports.columnLettersToIndex = columnLettersToIndex;
 exports.composeOdfGroupTransform = composeOdfGroupTransform;
 exports.decodeOdfText = decodeOdfText;
 exports.decodePackage = decodePackage;
@@ -2686,6 +3016,7 @@ exports.netRotationDeg = netRotationDeg;
 exports.packageCodec = packageCodec;
 exports.paragraphPropertiesToAttributes = paragraphPropertiesToAttributes;
 exports.parseBox = parseBox;
+exports.parseCellReference = parseCellReference;
 exports.parseLength = parseLength;
 exports.parseLinePoints = parseLinePoints;
 exports.parseMargins = parseMargins;
@@ -2711,9 +3042,11 @@ exports.readOdfParagraph = readOdfParagraph;
 exports.readOdfTable = readOdfTable;
 exports.readOdg = readOdg;
 exports.readOdp = readOdp;
+exports.readOds = readOds;
 exports.readOdt = readOdt;
 exports.resolveDrawPageSize = resolveDrawPageSize;
 exports.resolveOdfShapeGeometry = resolveOdfShapeGeometry;
+exports.resolvePageLayoutProperties = resolvePageLayoutProperties;
 exports.resolveStyle = resolveStyle;
 exports.resolveStyleElementChain = resolveStyleElementChain;
 exports.rootElement = rootElement;

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { Alignment, AlignmentSchema, Box, Color, ContentDrawPage, ContentParagraph, ContentPathPoint, ContentSection, ContentShape, ContentSlide, ContentSubpath, ContentTable, ContentVector, LayoutMetadata, Margins, PageSize } from "document-content-model";
+import { Alignment, AlignmentSchema, Box, Color, ContentDrawPage, ContentParagraph, ContentPathPoint, ContentSection, ContentShape, ContentSheet, ContentSlide, ContentSubpath, ContentTable, ContentVector, LayoutMetadata, Margins, PageSize } from "document-content-model";
 //#region src/model/node.d.ts
 declare const AttributeSchema: z.ZodObject<{
   name: z.ZodString;
@@ -486,6 +486,11 @@ declare function attrValue(element: XmlElement, name: string): string | undefine
 //#region src/typed/shared/a1.d.ts
 declare function columnIndexToLetters(index: number): string;
 declare function cellReference(columnIndex: number, rowIndex: number): string;
+declare function columnLettersToIndex(letters: string): number | undefined;
+declare function parseCellReference(reference: string): {
+  column: number;
+  row: number;
+} | undefined;
 declare class TableCursor {
   private columnCursor;
   private rowCursor;
@@ -565,6 +570,7 @@ declare function resolveOdfShapeGeometry(element: XmlElement): OdfShapeGeometry
 declare function composeOdfGroupTransform(groupFunctions: readonly OdfTransformFunction[], child: OdfShapeGeometry): OdfShapeGeometry;
 //#endregion
 //#region src/typed/shared/masterpage.d.ts
+declare function resolvePageLayoutProperties(pkg: Package, masterPageName: string | undefined): XmlElement | undefined;
 declare function resolveDrawPageSize(page: XmlElement, pkg: Package): PageSize | undefined;
 //#endregion
 //#region src/typed/shared/path.d.ts
@@ -629,4 +635,11 @@ interface OdgDocument {
 }
 declare function readOdg(pkg: Package): OdgDocument;
 //#endregion
-export { type Alignment, AlignmentSchema, type Attribute, AttributeSchema, type BinaryPart, BinaryPartSchema, type BuildManifestOptions, type CascadeDiagnostic, type DrawPageContent, type ImageFormat, type InternRequest, type LengthUnit, MANIFEST_PART, META_PART, MIMETYPE_PART, type Manifest, type ManifestEntry, ManifestEntrySchema, type ManifestProblem, ManifestProblemSchema, ManifestSchema, ODF_MEDIA_TYPES, ODF_NAMESPACES, type OdfExtension, type OdfNamespacePrefix, type OdfPoint, type OdfRawPoint, type OdfRawSegment, type OdfRawSubpath, type OdfShapeGeometry, type OdfTransformFunction, type OdfViewBox, type OdgDocument, type OdpDocument, type OdtDocument, type OtherPartRef, type Package, PackageSchema, type ParsedProperties, type Part, PartSchema, STYLE_FAMILIES, type StyleCascadeResult, type StyleElementChainResult, type StyleFamily, type StyleProperties, StylePropertiesSchema, StyleRegistry, type StyleRegistryOptions, TableCursor, type XmlCdata, XmlCdataSchema, type XmlComment, XmlCommentSchema, type XmlDeclaration, XmlDeclarationSchema, type XmlElement, XmlElementSchema, type XmlNode, XmlNodeSchema, type XmlPart, XmlPartSchema, type XmlPi, XmlPiSchema, type XmlText, XmlTextSchema, type ZipEntry, applyOdfTransform, attrValue, base64ToBytes, buildManifest, buildOdfSubpaths, buildStylePropertyElements, buildXml, bytesToBase64, canonicalPropertiesString, cellReference, childrenWithTag, columnIndexToLetters, composeOdfGroupTransform, decodeOdfText, decodePackage, decodeXmlText, el, elementsWithTag, encodePackage, encodeXmlText, ensureSpan, findChildElement, findStyleElement, formatOdfColor, formatOdfLength, formatPercentageMultiplier, formatPt, getOdfSpaceCount, isStyleFamily, isXmlNode, measureOdfNodeLength, mediaTypeForExtension, netRotationDeg, packageCodec, paragraphPropertiesToAttributes, parseBox, parseLength, parseLinePoints, parseMargins, parseOdfColor, parseOdfLength, parseOdfPathData, parseOdfPointsList, parseOdfTransform, parseOdfViewBox, parsePackage, parsePageSize, parseParagraphProperties, parseStyleElementProperties, parseTextProperties, parseXml, rawSubpathFromPoints, readDrawFrame, readDrawPageContent, readManifest, readMimetype, readOdfMetadata, readOdfParagraph, readOdfTable, readOdg, readOdp, readOdt, resolveDrawPageSize, resolveOdfShapeGeometry, resolveStyle, resolveStyleElementChain, rootElement, scaleOdfRawPoint, serializePackage, setDocumentMediaType, sniffImageFormat, sumOdfNodeLength, syncManifest, textPropertiesToAttributes, txt, unzipPackage, validateManifest, walkDrawShapes, writeManifest, writeMimetype, xmlCodec, xmlnsAttributes, zipPackage };
+//#region src/typed/ods/read.d.ts
+interface OdsDocument {
+  metadata: LayoutMetadata;
+  sheets: ContentSheet[];
+}
+declare function readOds(pkg: Package): OdsDocument;
+//#endregion
+export { type Alignment, AlignmentSchema, type Attribute, AttributeSchema, type BinaryPart, BinaryPartSchema, type BuildManifestOptions, type CascadeDiagnostic, type DrawPageContent, type ImageFormat, type InternRequest, type LengthUnit, MANIFEST_PART, META_PART, MIMETYPE_PART, type Manifest, type ManifestEntry, ManifestEntrySchema, type ManifestProblem, ManifestProblemSchema, ManifestSchema, ODF_MEDIA_TYPES, ODF_NAMESPACES, type OdfExtension, type OdfNamespacePrefix, type OdfPoint, type OdfRawPoint, type OdfRawSegment, type OdfRawSubpath, type OdfShapeGeometry, type OdfTransformFunction, type OdfViewBox, type OdgDocument, type OdpDocument, type OdsDocument, type OdtDocument, type OtherPartRef, type Package, PackageSchema, type ParsedProperties, type Part, PartSchema, STYLE_FAMILIES, type StyleCascadeResult, type StyleElementChainResult, type StyleFamily, type StyleProperties, StylePropertiesSchema, StyleRegistry, type StyleRegistryOptions, TableCursor, type XmlCdata, XmlCdataSchema, type XmlComment, XmlCommentSchema, type XmlDeclaration, XmlDeclarationSchema, type XmlElement, XmlElementSchema, type XmlNode, XmlNodeSchema, type XmlPart, XmlPartSchema, type XmlPi, XmlPiSchema, type XmlText, XmlTextSchema, type ZipEntry, applyOdfTransform, attrValue, base64ToBytes, buildManifest, buildOdfSubpaths, buildStylePropertyElements, buildXml, bytesToBase64, canonicalPropertiesString, cellReference, childrenWithTag, columnIndexToLetters, columnLettersToIndex, composeOdfGroupTransform, decodeOdfText, decodePackage, decodeXmlText, el, elementsWithTag, encodePackage, encodeXmlText, ensureSpan, findChildElement, findStyleElement, formatOdfColor, formatOdfLength, formatPercentageMultiplier, formatPt, getOdfSpaceCount, isStyleFamily, isXmlNode, measureOdfNodeLength, mediaTypeForExtension, netRotationDeg, packageCodec, paragraphPropertiesToAttributes, parseBox, parseCellReference, parseLength, parseLinePoints, parseMargins, parseOdfColor, parseOdfLength, parseOdfPathData, parseOdfPointsList, parseOdfTransform, parseOdfViewBox, parsePackage, parsePageSize, parseParagraphProperties, parseStyleElementProperties, parseTextProperties, parseXml, rawSubpathFromPoints, readDrawFrame, readDrawPageContent, readManifest, readMimetype, readOdfMetadata, readOdfParagraph, readOdfTable, readOdg, readOdp, readOds, readOdt, resolveDrawPageSize, resolveOdfShapeGeometry, resolvePageLayoutProperties, resolveStyle, resolveStyleElementChain, rootElement, scaleOdfRawPoint, serializePackage, setDocumentMediaType, sniffImageFormat, sumOdfNodeLength, syncManifest, textPropertiesToAttributes, txt, unzipPackage, validateManifest, walkDrawShapes, writeManifest, writeMimetype, xmlCodec, xmlnsAttributes, zipPackage };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { Alignment, AlignmentSchema, Box, Color, ContentDrawPage, ContentParagraph, ContentPathPoint, ContentSection, ContentShape, ContentSlide, ContentSubpath, ContentTable, ContentVector, LayoutMetadata, Margins, PageSize } from "document-content-model";
+import { Alignment, AlignmentSchema, Box, Color, ContentDrawPage, ContentParagraph, ContentPathPoint, ContentSection, ContentShape, ContentSheet, ContentSlide, ContentSubpath, ContentTable, ContentVector, LayoutMetadata, Margins, PageSize } from "document-content-model";
 //#region src/model/node.d.ts
 declare const AttributeSchema: z.ZodObject<{
   name: z.ZodString;
@@ -486,6 +486,11 @@ declare function attrValue(element: XmlElement, name: string): string | undefine
 //#region src/typed/shared/a1.d.ts
 declare function columnIndexToLetters(index: number): string;
 declare function cellReference(columnIndex: number, rowIndex: number): string;
+declare function columnLettersToIndex(letters: string): number | undefined;
+declare function parseCellReference(reference: string): {
+  column: number;
+  row: number;
+} | undefined;
 declare class TableCursor {
   private columnCursor;
   private rowCursor;
@@ -565,6 +570,7 @@ declare function resolveOdfShapeGeometry(element: XmlElement): OdfShapeGeometry
 declare function composeOdfGroupTransform(groupFunctions: readonly OdfTransformFunction[], child: OdfShapeGeometry): OdfShapeGeometry;
 //#endregion
 //#region src/typed/shared/masterpage.d.ts
+declare function resolvePageLayoutProperties(pkg: Package, masterPageName: string | undefined): XmlElement | undefined;
 declare function resolveDrawPageSize(page: XmlElement, pkg: Package): PageSize | undefined;
 //#endregion
 //#region src/typed/shared/path.d.ts
@@ -629,4 +635,11 @@ interface OdgDocument {
 }
 declare function readOdg(pkg: Package): OdgDocument;
 //#endregion
-export { type Alignment, AlignmentSchema, type Attribute, AttributeSchema, type BinaryPart, BinaryPartSchema, type BuildManifestOptions, type CascadeDiagnostic, type DrawPageContent, type ImageFormat, type InternRequest, type LengthUnit, MANIFEST_PART, META_PART, MIMETYPE_PART, type Manifest, type ManifestEntry, ManifestEntrySchema, type ManifestProblem, ManifestProblemSchema, ManifestSchema, ODF_MEDIA_TYPES, ODF_NAMESPACES, type OdfExtension, type OdfNamespacePrefix, type OdfPoint, type OdfRawPoint, type OdfRawSegment, type OdfRawSubpath, type OdfShapeGeometry, type OdfTransformFunction, type OdfViewBox, type OdgDocument, type OdpDocument, type OdtDocument, type OtherPartRef, type Package, PackageSchema, type ParsedProperties, type Part, PartSchema, STYLE_FAMILIES, type StyleCascadeResult, type StyleElementChainResult, type StyleFamily, type StyleProperties, StylePropertiesSchema, StyleRegistry, type StyleRegistryOptions, TableCursor, type XmlCdata, XmlCdataSchema, type XmlComment, XmlCommentSchema, type XmlDeclaration, XmlDeclarationSchema, type XmlElement, XmlElementSchema, type XmlNode, XmlNodeSchema, type XmlPart, XmlPartSchema, type XmlPi, XmlPiSchema, type XmlText, XmlTextSchema, type ZipEntry, applyOdfTransform, attrValue, base64ToBytes, buildManifest, buildOdfSubpaths, buildStylePropertyElements, buildXml, bytesToBase64, canonicalPropertiesString, cellReference, childrenWithTag, columnIndexToLetters, composeOdfGroupTransform, decodeOdfText, decodePackage, decodeXmlText, el, elementsWithTag, encodePackage, encodeXmlText, ensureSpan, findChildElement, findStyleElement, formatOdfColor, formatOdfLength, formatPercentageMultiplier, formatPt, getOdfSpaceCount, isStyleFamily, isXmlNode, measureOdfNodeLength, mediaTypeForExtension, netRotationDeg, packageCodec, paragraphPropertiesToAttributes, parseBox, parseLength, parseLinePoints, parseMargins, parseOdfColor, parseOdfLength, parseOdfPathData, parseOdfPointsList, parseOdfTransform, parseOdfViewBox, parsePackage, parsePageSize, parseParagraphProperties, parseStyleElementProperties, parseTextProperties, parseXml, rawSubpathFromPoints, readDrawFrame, readDrawPageContent, readManifest, readMimetype, readOdfMetadata, readOdfParagraph, readOdfTable, readOdg, readOdp, readOdt, resolveDrawPageSize, resolveOdfShapeGeometry, resolveStyle, resolveStyleElementChain, rootElement, scaleOdfRawPoint, serializePackage, setDocumentMediaType, sniffImageFormat, sumOdfNodeLength, syncManifest, textPropertiesToAttributes, txt, unzipPackage, validateManifest, walkDrawShapes, writeManifest, writeMimetype, xmlCodec, xmlnsAttributes, zipPackage };
+//#region src/typed/ods/read.d.ts
+interface OdsDocument {
+  metadata: LayoutMetadata;
+  sheets: ContentSheet[];
+}
+declare function readOds(pkg: Package): OdsDocument;
+//#endregion
+export { type Alignment, AlignmentSchema, type Attribute, AttributeSchema, type BinaryPart, BinaryPartSchema, type BuildManifestOptions, type CascadeDiagnostic, type DrawPageContent, type ImageFormat, type InternRequest, type LengthUnit, MANIFEST_PART, META_PART, MIMETYPE_PART, type Manifest, type ManifestEntry, ManifestEntrySchema, type ManifestProblem, ManifestProblemSchema, ManifestSchema, ODF_MEDIA_TYPES, ODF_NAMESPACES, type OdfExtension, type OdfNamespacePrefix, type OdfPoint, type OdfRawPoint, type OdfRawSegment, type OdfRawSubpath, type OdfShapeGeometry, type OdfTransformFunction, type OdfViewBox, type OdgDocument, type OdpDocument, type OdsDocument, type OdtDocument, type OtherPartRef, type Package, PackageSchema, type ParsedProperties, type Part, PartSchema, STYLE_FAMILIES, type StyleCascadeResult, type StyleElementChainResult, type StyleFamily, type StyleProperties, StylePropertiesSchema, StyleRegistry, type StyleRegistryOptions, TableCursor, type XmlCdata, XmlCdataSchema, type XmlComment, XmlCommentSchema, type XmlDeclaration, XmlDeclarationSchema, type XmlElement, XmlElementSchema, type XmlNode, XmlNodeSchema, type XmlPart, XmlPartSchema, type XmlPi, XmlPiSchema, type XmlText, XmlTextSchema, type ZipEntry, applyOdfTransform, attrValue, base64ToBytes, buildManifest, buildOdfSubpaths, buildStylePropertyElements, buildXml, bytesToBase64, canonicalPropertiesString, cellReference, childrenWithTag, columnIndexToLetters, columnLettersToIndex, composeOdfGroupTransform, decodeOdfText, decodePackage, decodeXmlText, el, elementsWithTag, encodePackage, encodeXmlText, ensureSpan, findChildElement, findStyleElement, formatOdfColor, formatOdfLength, formatPercentageMultiplier, formatPt, getOdfSpaceCount, isStyleFamily, isXmlNode, measureOdfNodeLength, mediaTypeForExtension, netRotationDeg, packageCodec, paragraphPropertiesToAttributes, parseBox, parseCellReference, parseLength, parseLinePoints, parseMargins, parseOdfColor, parseOdfLength, parseOdfPathData, parseOdfPointsList, parseOdfTransform, parseOdfViewBox, parsePackage, parsePageSize, parseParagraphProperties, parseStyleElementProperties, parseTextProperties, parseXml, rawSubpathFromPoints, readDrawFrame, readDrawPageContent, readManifest, readMimetype, readOdfMetadata, readOdfParagraph, readOdfTable, readOdg, readOdp, readOds, readOdt, resolveDrawPageSize, resolveOdfShapeGeometry, resolvePageLayoutProperties, resolveStyle, resolveStyleElementChain, rootElement, scaleOdfRawPoint, serializePackage, setDocumentMediaType, sniffImageFormat, sumOdfNodeLength, syncManifest, textPropertiesToAttributes, txt, unzipPackage, validateManifest, walkDrawShapes, writeManifest, writeMimetype, xmlCodec, xmlnsAttributes, zipPackage };

package/dist/index.js

@@ -1420,6 +1420,25 @@ function cellReference(columnIndex, rowIndex) {
 	if (!Number.isInteger(rowIndex) || rowIndex < 0) throw new Error(`cellReference: rowIndex must be a non-negative integer, got ${rowIndex}`);
 	return `${columnIndexToLetters(columnIndex)}${rowIndex + 1}`;
 }
+function columnLettersToIndex(letters) {
+	if (!/^[A-Z]+$/.test(letters)) return;
+	let index = 0;
+	for (const char of letters) index = index * ALPHABET_SIZE + (char.charCodeAt(0) - ALPHABET_START_CODE + 1);
+	return index - 1;
+}
+function parseCellReference(reference) {
+	const match = /^([A-Z]+)(\d+)$/.exec(reference);
+	if (match === null) return;
+	const [, letters, digits] = match;
+	if (letters === void 0 || digits === void 0) return;
+	const column = columnLettersToIndex(letters);
+	const row = Number.parseInt(digits, 10) - 1;
+	if (column === void 0 || row < 0) return;
+	return {
+		column,
+		row
+	};
+}
 function validateRepeatCount(repeatCount, caller) {
 	if (!Number.isInteger(repeatCount) || repeatCount < 1) throw new Error(`${caller}: repeatCount must be a positive integer, got ${repeatCount}`);
 }
@@ -1701,7 +1720,7 @@ function readOdfParagraph(pElement, pkg) {
 }
 //#endregion
 //#region src/typed/shared/table.ts
-function readRepeatCount(element, attrName) {
+function readRepeatCount$1(element, attrName) {
 	const raw = attrValue(element, attrName);
 	if (raw === void 0) return 1;
 	const parsed = Number.parseInt(raw, 10);
@@ -1744,11 +1763,11 @@ function readTableRow(rowElement, pkg) {
 	for (const child of rowElement.children) {
 		if (child.type !== "element") continue;
 		if (child.tag === "table:covered-table-cell") {
-			const repeat = readRepeatCount(child, "table:number-columns-repeated");
+			const repeat = readRepeatCount$1(child, "table:number-columns-repeated");
 			for (let i = 0; i < repeat; i++) cells.push({ blocks: [] });
 		} else if (child.tag === "table:table-cell") {
 			const cell = readTableCell(child, pkg);
-			const repeat = readRepeatCount(child, "table:number-columns-repeated");
+			const repeat = readRepeatCount$1(child, "table:number-columns-repeated");
 			for (let i = 0; i < repeat; i++) cells.push(cell);
 		}
 	}
@@ -1761,13 +1780,13 @@ function readOdfTable(tableElement, pkg) {
 	const columnWidthsPt = [];
 	for (const column of childrenWithTag(tableElement, "table:table-column")) {
 		const widthPt = resolveColumnWidthPt(column, pkg);
-		const repeat = readRepeatCount(column, "table:number-columns-repeated");
+		const repeat = readRepeatCount$1(column, "table:number-columns-repeated");
 		for (let i = 0; i < repeat; i++) columnWidthsPt.push(widthPt);
 	}
 	const rows = [];
 	for (const rowElement of childrenWithTag(tableElement, "table:table-row")) {
 		const row = readTableRow(rowElement, pkg);
-		const repeat = readRepeatCount(rowElement, "table:number-rows-repeated");
+		const repeat = readRepeatCount$1(rowElement, "table:number-rows-repeated");
 		for (let i = 0; i < repeat; i++) rows.push(row);
 	}
 	return {
@@ -1904,10 +1923,13 @@ function findPageLayoutElement$1(pkg, pageLayoutName) {
 		if (found !== void 0) return found;
 	}
 }
-function resolveDrawPageSize(page, pkg) {
-	const masterPage = findMasterPageElement(pkg, attrValue(page, "draw:master-page-name"));
+function resolvePageLayoutProperties(pkg, masterPageName) {
+	const masterPage = findMasterPageElement(pkg, masterPageName);
 	const pageLayout = findPageLayoutElement$1(pkg, masterPage === void 0 ? void 0 : attrValue(masterPage, "style:page-layout-name"));
-	const properties = pageLayout === void 0 ? void 0 : childrenWithTag(pageLayout, "style:page-layout-properties")[0];
+	return pageLayout === void 0 ? void 0 : childrenWithTag(pageLayout, "style:page-layout-properties")[0];
+}
+function resolveDrawPageSize(page, pkg) {
+	const properties = resolvePageLayoutProperties(pkg, attrValue(page, "draw:master-page-name"));
 	return properties === void 0 ? void 0 : parsePageSize(properties);
 }
 //#endregion
@@ -2461,7 +2483,7 @@ function readDrawPageContent(children, pkg) {
 }
 //#endregion
 //#region src/typed/odp/read.ts
-const CONTENT_PART$2 = "content.xml";
+const CONTENT_PART$3 = "content.xml";
 function readSlideSize(page, pkg) {
 	return resolveDrawPageSize(page, pkg) ?? SLIDE_SIZE_WIDESCREEN;
 }
@@ -2480,7 +2502,7 @@ function readSlide(page, pkg) {
 	};
 }
 function readOdp(pkg) {
-	const contentPart = pkg.parts[CONTENT_PART$2];
+	const contentPart = pkg.parts[CONTENT_PART$3];
 	const root = contentPart?.kind === "xml" ? rootElement(contentPart.nodes) : void 0;
 	const body = root === void 0 ? void 0 : findChildElement(root.children, "office:body");
 	const presentation = body === void 0 ? void 0 : findChildElement(body.children, "office:presentation");
@@ -2492,9 +2514,9 @@ function readOdp(pkg) {
 }
 //#endregion
 //#region src/typed/odt/read.ts
-const CONTENT_PART$1 = "content.xml";
+const CONTENT_PART$2 = "content.xml";
 const STYLES_PART = "styles.xml";
-const AUTOMATIC_STYLE_PARTS = [CONTENT_PART$1, STYLES_PART];
+const AUTOMATIC_STYLE_PARTS = [CONTENT_PART$2, STYLES_PART];
 function readOutlineLevel(headingElement) {
 	const raw = attrValue(headingElement, "text:outline-level");
 	if (raw === void 0) return 1;
@@ -2537,18 +2559,18 @@ function readBlocks(nodes, pkg, listIdState) {
 	}
 	return blocks;
 }
-function parseKnownOdfLength(value) {
+function parseKnownOdfLength$1(value) {
 	const parsed = parseOdfLength(value);
 	if (parsed === void 0) throw new Error(`readOdt: internal error -- "${value}" is not a valid ODF length literal`);
 	return parsed;
 }
-const DEFAULT_PAGE_SIZE$1 = PAGE_SIZE_A4;
-const DEFAULT_MARGIN_PT = parseKnownOdfLength("2cm");
-const DEFAULT_MARGINS = {
-	topPt: DEFAULT_MARGIN_PT,
-	rightPt: DEFAULT_MARGIN_PT,
-	bottomPt: DEFAULT_MARGIN_PT,
-	leftPt: DEFAULT_MARGIN_PT
+const DEFAULT_PAGE_SIZE$2 = PAGE_SIZE_A4;
+const DEFAULT_MARGIN_PT$1 = parseKnownOdfLength$1("2cm");
+const DEFAULT_MARGINS$1 = {
+	topPt: DEFAULT_MARGIN_PT$1,
+	rightPt: DEFAULT_MARGIN_PT$1,
+	bottomPt: DEFAULT_MARGIN_PT$1,
+	leftPt: DEFAULT_MARGIN_PT$1
 };
 function findPageLayoutElement(pkg, pageLayoutName) {
 	if (pageLayoutName === void 0) return;
@@ -2572,17 +2594,17 @@ function readFirstMasterPageGeometry(pkg) {
 	const pageSize = properties === void 0 ? void 0 : parsePageSize(properties);
 	const margins = properties === void 0 ? void 0 : parseMargins(properties);
 	return {
-		pageSize: pageSize ?? DEFAULT_PAGE_SIZE$1,
-		margins: margins ?? DEFAULT_MARGINS
+		pageSize: pageSize ?? DEFAULT_PAGE_SIZE$2,
+		margins: margins ?? DEFAULT_MARGINS$1
 	};
 }
 function readOdt(pkg) {
-	const contentPart = pkg.parts[CONTENT_PART$1];
-	if (contentPart?.kind !== "xml") throw new Error(`readOdt: package has no ${CONTENT_PART$1} part`);
+	const contentPart = pkg.parts[CONTENT_PART$2];
+	if (contentPart?.kind !== "xml") throw new Error(`readOdt: package has no ${CONTENT_PART$2} part`);
 	const contentRoot = rootElement(contentPart.nodes);
 	const body = contentRoot === void 0 ? void 0 : findChildElement(contentRoot.children, "office:body");
 	const textElement = body === void 0 ? void 0 : findChildElement(body.children, "office:text");
-	if (textElement === void 0) throw new Error(`readOdt: ${CONTENT_PART$1} has no office:body/office:text element`);
+	if (textElement === void 0) throw new Error(`readOdt: ${CONTENT_PART$2} has no office:body/office:text element`);
 	const metadata = readOdfMetadata(pkg);
 	const { pageSize, margins } = readFirstMasterPageGeometry(pkg);
 	return {
@@ -2596,10 +2618,10 @@ function readOdt(pkg) {
 }
 //#endregion
 //#region src/typed/odg/read.ts
-const CONTENT_PART = "content.xml";
-const DEFAULT_PAGE_SIZE = PAGE_SIZE_A4;
+const CONTENT_PART$1 = "content.xml";
+const DEFAULT_PAGE_SIZE$1 = PAGE_SIZE_A4;
 function readPage(page, pkg) {
-	const size = resolveDrawPageSize(page, pkg) ?? DEFAULT_PAGE_SIZE;
+	const size = resolveDrawPageSize(page, pkg) ?? DEFAULT_PAGE_SIZE$1;
 	const { shapes, vectors } = readDrawPageContent(page.children, pkg);
 	return {
 		size,
@@ -2608,7 +2630,7 @@ function readPage(page, pkg) {
 	};
 }
 function readOdg(pkg) {
-	const contentPart = pkg.parts[CONTENT_PART];
+	const contentPart = pkg.parts[CONTENT_PART$1];
 	const root = contentPart?.kind === "xml" ? rootElement(contentPart.nodes) : void 0;
 	const body = root === void 0 ? void 0 : findChildElement(root.children, "office:body");
 	const drawing = body === void 0 ? void 0 : findChildElement(body.children, "office:drawing");
@@ -2619,4 +2641,311 @@ function readOdg(pkg) {
 	};
 }
 //#endregion
-export { AlignmentSchema, AttributeSchema, BinaryPartSchema, MANIFEST_PART, META_PART, MIMETYPE_PART, ManifestEntrySchema, ManifestProblemSchema, ManifestSchema, ODF_MEDIA_TYPES, ODF_NAMESPACES, PackageSchema, PartSchema, STYLE_FAMILIES, StylePropertiesSchema, StyleRegistry, TableCursor, XmlCdataSchema, XmlCommentSchema, XmlDeclarationSchema, XmlElementSchema, XmlNodeSchema, XmlPartSchema, XmlPiSchema, XmlTextSchema, applyOdfTransform, attrValue, base64ToBytes, buildManifest, buildOdfSubpaths, buildStylePropertyElements, buildXml, bytesToBase64, canonicalPropertiesString, cellReference, childrenWithTag, columnIndexToLetters, composeOdfGroupTransform, decodeOdfText, decodePackage, decodeXmlText, el, elementsWithTag, encodePackage, encodeXmlText, ensureSpan, findChildElement, findStyleElement, formatOdfColor, formatOdfLength, formatPercentageMultiplier, formatPt, getOdfSpaceCount, isStyleFamily, isXmlNode, measureOdfNodeLength, mediaTypeForExtension, netRotationDeg, packageCodec, paragraphPropertiesToAttributes, parseBox, parseLength, parseLinePoints, parseMargins, parseOdfColor, parseOdfLength, parseOdfPathData, parseOdfPointsList, parseOdfTransform, parseOdfViewBox, parsePackage, parsePageSize, parseParagraphProperties, parseStyleElementProperties, parseTextProperties, parseXml, rawSubpathFromPoints, readDrawFrame, readDrawPageContent, readManifest, readMimetype, readOdfMetadata, readOdfParagraph, readOdfTable, readOdg, readOdp, readOdt, resolveDrawPageSize, resolveOdfShapeGeometry, resolveStyle, resolveStyleElementChain, rootElement, scaleOdfRawPoint, serializePackage, setDocumentMediaType, sniffImageFormat, sumOdfNodeLength, syncManifest, textPropertiesToAttributes, txt, unzipPackage, validateManifest, walkDrawShapes, writeManifest, writeMimetype, xmlCodec, xmlnsAttributes, zipPackage };
+//#region src/typed/ods/read.ts
+const CONTENT_PART = "content.xml";
+function parseKnownOdfLength(value) {
+	const parsed = parseOdfLength(value);
+	if (parsed === void 0) throw new Error(`readOds: internal error -- "${value}" is not a valid ODF length literal`);
+	return parsed;
+}
+const DEFAULT_PAGE_SIZE = PAGE_SIZE_A4;
+const DEFAULT_MARGIN_PT = parseKnownOdfLength("2cm");
+const DEFAULT_MARGINS = {
+	topPt: DEFAULT_MARGIN_PT,
+	rightPt: DEFAULT_MARGIN_PT,
+	bottomPt: DEFAULT_MARGIN_PT,
+	leftPt: DEFAULT_MARGIN_PT
+};
+function readRepeatCount(element, attrName) {
+	const raw = attrValue(element, attrName);
+	if (raw === void 0) return 1;
+	const parsed = Number.parseInt(raw, 10);
+	return Number.isInteger(parsed) && parsed > 0 ? parsed : 1;
+}
+function isHidden(element) {
+	return attrValue(element, "table:visibility") === "collapse";
+}
+function readColumnLayout(columnElement, pkg) {
+	const styleName = attrValue(columnElement, "table:style-name");
+	const styleElement = styleName === void 0 ? void 0 : findStyleElement(styleName, "table-column", pkg);
+	const properties = styleElement === void 0 ? void 0 : childrenWithTag(styleElement, "style:table-column-properties")[0];
+	const widthValue = properties === void 0 ? void 0 : attrValue(properties, "style:column-width");
+	return {
+		widthPt: widthValue === void 0 ? 0 : parseOdfLength(widthValue) ?? 0,
+		manualBreak: (properties === void 0 ? void 0 : attrValue(properties, "fo:break-before")) === "page"
+	};
+}
+function readRowLayout(rowElement, pkg) {
+	const styleName = attrValue(rowElement, "table:style-name");
+	const styleElement = styleName === void 0 ? void 0 : findStyleElement(styleName, "table-row", pkg);
+	const properties = styleElement === void 0 ? void 0 : childrenWithTag(styleElement, "style:table-row-properties")[0];
+	const heightValue = properties === void 0 ? void 0 : attrValue(properties, "style:row-height");
+	return {
+		heightPt: heightValue === void 0 ? 0 : parseOdfLength(heightValue) ?? 0,
+		manualBreak: (properties === void 0 ? void 0 : attrValue(properties, "fo:break-before")) === "page"
+	};
+}
+function readCellText(cellElement, pkg) {
+	const paragraphs = childrenWithTag(cellElement, "text:p");
+	const runs = [];
+	paragraphs.forEach((paragraph, index) => {
+		if (index > 0) runs.push({ text: "\n" });
+		runs.push(...readOdfParagraph(paragraph, pkg).runs);
+	});
+	return {
+		runs,
+		displayText: runs.map((run) => run.text).join("")
+	};
+}
+function readCellValue(cellElement, displayText) {
+	const valueType = attrValue(cellElement, "office:value-type");
+	const stringFallback = {
+		kind: "string",
+		value: displayText
+	};
+	switch (valueType) {
+		case "float": {
+			const value = parseRequiredNumber(attrValue(cellElement, "office:value"));
+			return value === void 0 ? stringFallback : {
+				kind: "number",
+				value
+			};
+		}
+		case "percentage": {
+			const value = parseRequiredNumber(attrValue(cellElement, "office:value"));
+			return value === void 0 ? stringFallback : {
+				kind: "percentage",
+				value
+			};
+		}
+		case "currency": {
+			const value = parseRequiredNumber(attrValue(cellElement, "office:value"));
+			if (value === void 0) return stringFallback;
+			const currency = attrValue(cellElement, "office:currency");
+			return currency === void 0 ? {
+				kind: "currency",
+				value
+			} : {
+				kind: "currency",
+				value,
+				currency
+			};
+		}
+		case "boolean": {
+			const raw = attrValue(cellElement, "office:boolean-value");
+			return raw === void 0 ? stringFallback : {
+				kind: "boolean",
+				value: raw === "true"
+			};
+		}
+		case "date": return {
+			kind: "date",
+			value: attrValue(cellElement, "office:date-value") ?? displayText
+		};
+		case "time": return {
+			kind: "time",
+			value: attrValue(cellElement, "office:time-value") ?? displayText
+		};
+		case "string": return {
+			kind: "string",
+			value: attrValue(cellElement, "office:string-value") ?? displayText
+		};
+		default: return { kind: "empty" };
+	}
+}
+function parseRequiredNumber(raw) {
+	if (raw === void 0) return;
+	const value = Number(raw);
+	return Number.isNaN(value) ? void 0 : value;
+}
+function parsePrintRanges(value) {
+	const first = value.split(" ").find((part) => part.length > 0);
+	if (first === void 0) return;
+	const separatorIndex = first.indexOf(":");
+	if (separatorIndex === -1) return;
+	const start = parseA1WithOptionalSheetPrefix(first.slice(0, separatorIndex));
+	const end = parseA1WithOptionalSheetPrefix(first.slice(separatorIndex + 1));
+	if (start === void 0 || end === void 0) return;
+	return {
+		startRow: start.row,
+		startColumn: start.column,
+		endRow: end.row,
+		endColumn: end.column
+	};
+}
+function parseA1WithOptionalSheetPrefix(cellPart) {
+	const dotIndex = cellPart.lastIndexOf(".");
+	return parseCellReference(dotIndex === -1 ? cellPart : cellPart.slice(dotIndex + 1));
+}
+function parseScalePercentage(value) {
+	const match = /^(\d+(?:\.\d+)?)%$/.exec(value);
+	if (match === null) return;
+	const numeric = match[1];
+	return numeric === void 0 ? void 0 : Number(numeric);
+}
+function parseNonNegativeInteger(value) {
+	if (value === void 0) return;
+	const parsed = Number.parseInt(value, 10);
+	return Number.isInteger(parsed) && parsed >= 0 ? parsed : void 0;
+}
+function readTable(tableElement, pkg) {
+	const columns = [];
+	const rows = [];
+	const cells = [];
+	const manualBreakRows = [];
+	const manualBreakColumns = [];
+	let repeatColumns;
+	let repeatRows;
+	let columnCursor = 0;
+	const cursor = new TableCursor();
+	function processColumn(columnElement) {
+		const startIndex = columnCursor;
+		const { widthPt, manualBreak } = readColumnLayout(columnElement, pkg);
+		columns.push({
+			index: startIndex,
+			widthPt,
+			hidden: isHidden(columnElement) ? true : void 0
+		});
+		if (manualBreak) manualBreakColumns.push(startIndex);
+		columnCursor += readRepeatCount(columnElement, "table:number-columns-repeated");
+	}
+	function processRowCells(rowElement) {
+		for (const child of rowElement.children) {
+			if (child.type !== "element") continue;
+			if (child.tag === "table:covered-table-cell") cursor.nextCell(readRepeatCount(child, "table:number-columns-repeated"));
+			else if (child.tag === "table:table-cell") {
+				const columnIndex = cursor.columnIndex;
+				const rowIndex = cursor.rowIndex;
+				cursor.nextCell(readRepeatCount(child, "table:number-columns-repeated"));
+				const formula = attrValue(child, "table:formula");
+				const { runs, displayText } = readCellText(child, pkg);
+				if (!(attrValue(child, "office:value-type") !== void 0) && formula === void 0 && displayText.length === 0) continue;
+				const value = readCellValue(child, displayText);
+				const colSpan = parseNonNegativeInteger(attrValue(child, "table:number-columns-spanned"));
+				const rowSpan = parseNonNegativeInteger(attrValue(child, "table:number-rows-spanned"));
+				const cell = {
+					row: rowIndex,
+					column: columnIndex,
+					value,
+					displayText
+				};
+				if (formula !== void 0) cell.formula = formula;
+				if (runs.length > 0) cell.runs = runs;
+				if (colSpan !== void 0) cell.colSpan = colSpan;
+				if (rowSpan !== void 0) cell.rowSpan = rowSpan;
+				cells.push(cell);
+			}
+		}
+	}
+	function processRow(rowElement) {
+		const startIndex = cursor.rowIndex;
+		processRowCells(rowElement);
+		const { heightPt, manualBreak } = readRowLayout(rowElement, pkg);
+		rows.push({
+			index: startIndex,
+			heightPt,
+			hidden: isHidden(rowElement) ? true : void 0
+		});
+		if (manualBreak) manualBreakRows.push(startIndex);
+		cursor.nextRow(readRepeatCount(rowElement, "table:number-rows-repeated"));
+	}
+	for (const child of tableElement.children) {
+		if (child.type !== "element") continue;
+		if (child.tag === "table:table-column") processColumn(child);
+		else if (child.tag === "table:table-header-columns") {
+			const startIndex = columnCursor;
+			for (const headerChild of child.children) if (headerChild.type === "element" && headerChild.tag === "table:table-column") processColumn(headerChild);
+			if (columnCursor > startIndex) repeatColumns = {
+				start: startIndex,
+				end: columnCursor - 1
+			};
+		} else if (child.tag === "table:table-row") processRow(child);
+		else if (child.tag === "table:table-header-rows") {
+			const startIndex = cursor.rowIndex;
+			for (const headerChild of child.children) if (headerChild.type === "element" && headerChild.tag === "table:table-row") processRow(headerChild);
+			if (cursor.rowIndex > startIndex) repeatRows = {
+				start: startIndex,
+				end: cursor.rowIndex - 1
+			};
+		}
+	}
+	return {
+		columns,
+		rows,
+		cells,
+		repeatColumns,
+		repeatRows,
+		manualBreakRows,
+		manualBreakColumns
+	};
+}
+function readPrintSettings(tableElement, pkg, repeatColumns, repeatRows, manualBreakRows, manualBreakColumns) {
+	const tableStyleName = attrValue(tableElement, "table:style-name");
+	const tableStyleElement = tableStyleName === void 0 ? void 0 : findStyleElement(tableStyleName, "table", pkg);
+	const layoutProperties = resolvePageLayoutProperties(pkg, tableStyleElement === void 0 ? void 0 : attrValue(tableStyleElement, "style:master-page-name"));
+	const pageSize = layoutProperties === void 0 ? void 0 : parsePageSize(layoutProperties);
+	const margins = layoutProperties === void 0 ? void 0 : parseMargins(layoutProperties);
+	const printTokens = new Set((layoutProperties === void 0 ? void 0 : attrValue(layoutProperties, "style:print"))?.split(" ").filter((token) => token.length > 0));
+	const pageOrder = (layoutProperties === void 0 ? void 0 : attrValue(layoutProperties, "style:print-page-order")) === "ltr" ? "overThenDown" : "downThenOver";
+	const scaleToRaw = layoutProperties === void 0 ? void 0 : attrValue(layoutProperties, "style:scale-to");
+	const scale = scaleToRaw === void 0 ? void 0 : parseScalePercentage(scaleToRaw);
+	const scaleToXRaw = layoutProperties === void 0 ? void 0 : attrValue(layoutProperties, "style:scale-to-X");
+	const scaleToYRaw = layoutProperties === void 0 ? void 0 : attrValue(layoutProperties, "style:scale-to-Y");
+	const fitWidth = parseNonNegativeInteger(scaleToXRaw);
+	const fitHeight = parseNonNegativeInteger(scaleToYRaw);
+	const fitToPages = fitWidth === void 0 || fitHeight === void 0 ? void 0 : {
+		width: fitWidth,
+		height: fitHeight
+	};
+	const printRangesRaw = attrValue(tableElement, "table:print-ranges");
+	const printRange = printRangesRaw === void 0 ? void 0 : parsePrintRanges(printRangesRaw);
+	const manualBreaks = manualBreakRows.length > 0 || manualBreakColumns.length > 0 ? {
+		rows: manualBreakRows,
+		columns: manualBreakColumns
+	} : void 0;
+	const settings = {
+		pageSize: pageSize ?? DEFAULT_PAGE_SIZE,
+		margins: margins ?? DEFAULT_MARGINS,
+		gridlines: printTokens.has("grid"),
+		headers: printTokens.has("headers"),
+		pageOrder
+	};
+	if (printRange !== void 0) settings.printRange = printRange;
+	if (scale !== void 0) settings.scale = scale;
+	if (fitToPages !== void 0) settings.fitToPages = fitToPages;
+	if (repeatRows !== void 0) settings.repeatRows = repeatRows;
+	if (repeatColumns !== void 0) settings.repeatColumns = repeatColumns;
+	if (manualBreaks !== void 0) settings.manualBreaks = manualBreaks;
+	return settings;
+}
+function readSheet(tableElement, pkg) {
+	const name = attrValue(tableElement, "table:name");
+	if (name === void 0) return;
+	const { columns, rows, cells, repeatColumns, repeatRows, manualBreakRows, manualBreakColumns } = readTable(tableElement, pkg);
+	return {
+		name,
+		cells,
+		columns,
+		rows,
+		images: [],
+		printSettings: readPrintSettings(tableElement, pkg, repeatColumns, repeatRows, manualBreakRows, manualBreakColumns)
+	};
+}
+function readOds(pkg) {
+	const contentPart = pkg.parts[CONTENT_PART];
+	const root = contentPart?.kind === "xml" ? rootElement(contentPart.nodes) : void 0;
+	const body = root === void 0 ? void 0 : findChildElement(root.children, "office:body");
+	const spreadsheet = body === void 0 ? void 0 : findChildElement(body.children, "office:spreadsheet");
+	const tables = spreadsheet === void 0 ? [] : childrenWithTag(spreadsheet, "table:table");
+	const sheets = [];
+	for (const table of tables) {
+		const sheet = readSheet(table, pkg);
+		if (sheet !== void 0) sheets.push(sheet);
+	}
+	return {
+		metadata: readOdfMetadata(pkg),
+		sheets
+	};
+}
+//#endregion
+export { AlignmentSchema, AttributeSchema, BinaryPartSchema, MANIFEST_PART, META_PART, MIMETYPE_PART, ManifestEntrySchema, ManifestProblemSchema, ManifestSchema, ODF_MEDIA_TYPES, ODF_NAMESPACES, PackageSchema, PartSchema, STYLE_FAMILIES, StylePropertiesSchema, StyleRegistry, TableCursor, XmlCdataSchema, XmlCommentSchema, XmlDeclarationSchema, XmlElementSchema, XmlNodeSchema, XmlPartSchema, XmlPiSchema, XmlTextSchema, applyOdfTransform, attrValue, base64ToBytes, buildManifest, buildOdfSubpaths, buildStylePropertyElements, buildXml, bytesToBase64, canonicalPropertiesString, cellReference, childrenWithTag, columnIndexToLetters, columnLettersToIndex, composeOdfGroupTransform, decodeOdfText, decodePackage, decodeXmlText, el, elementsWithTag, encodePackage, encodeXmlText, ensureSpan, findChildElement, findStyleElement, formatOdfColor, formatOdfLength, formatPercentageMultiplier, formatPt, getOdfSpaceCount, isStyleFamily, isXmlNode, measureOdfNodeLength, mediaTypeForExtension, netRotationDeg, packageCodec, paragraphPropertiesToAttributes, parseBox, parseCellReference, parseLength, parseLinePoints, parseMargins, parseOdfColor, parseOdfLength, parseOdfPathData, parseOdfPointsList, parseOdfTransform, parseOdfViewBox, parsePackage, parsePageSize, parseParagraphProperties, parseStyleElementProperties, parseTextProperties, parseXml, rawSubpathFromPoints, readDrawFrame, readDrawPageContent, readManifest, readMimetype, readOdfMetadata, readOdfParagraph, readOdfTable, readOdg, readOdp, readOds, readOdt, resolveDrawPageSize, resolveOdfShapeGeometry, resolvePageLayoutProperties, resolveStyle, resolveStyleElementChain, rootElement, scaleOdfRawPoint, serializePackage, setDocumentMediaType, sniffImageFormat, sumOdfNodeLength, syncManifest, textPropertiesToAttributes, txt, unzipPackage, validateManifest, walkDrawShapes, writeManifest, writeMimetype, xmlCodec, xmlnsAttributes, zipPackage };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "odf.js",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "description": "Type-safe, lossless round-trip conversion between OpenDocument Format packages (odt, ods, odp) and JSON, hand-written and dependency-minimal, built on Zod 4 codecs.",
   "type": "module",
   "repository": {