odf.js 1.12.0 → 1.13.0

package/dist/typed/ods/read.js

@@ -0,0 +1,317 @@
+import { parseOdfLength } from "../shared/units.js";
+import { attrValue, childrenWithTag, findChildElement, rootElement } from "../../xml/query.js";
+import { TableCursor, parseCellReference } from "../shared/a1.js";
+import { parseMargins, parsePageSize } from "../shared/geometry.js";
+import { findStyleElement } from "../shared/cascade.js";
+import { readOdfMetadata } from "../shared/metadata.js";
+import { readOdfParagraph } from "../shared/paragraph.js";
+import { resolvePageLayoutProperties } from "../shared/masterpage.js";
+import { PAGE_SIZE_A4 } from "document-schema.js";
+//#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_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(".");
+	const bareReference = dotIndex === -1 ? cellPart : cellPart.slice(dotIndex + 1);
+	return parseCellReference(bareReference);
+}
+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 { widthPt, manualBreak } = readColumnLayout(columnElement, pkg);
+		columns.push({
+			index: columnCursor,
+			widthPt,
+			hidden: isHidden(columnElement) ? true : void 0
+		});
+		if (manualBreak) manualBreakColumns.push(columnCursor);
+		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 masterPageName = tableStyleElement === void 0 ? void 0 : attrValue(tableStyleElement, "style:master-page-name");
+	const layoutProperties = resolvePageLayoutProperties(pkg, masterPageName);
+	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 ?? PAGE_SIZE_A4,
+		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 { readOds };

package/dist/typed/odt/read.cjs

@@ -0,0 +1,112 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_typed_shared_units = require("../shared/units.cjs");
+const require_xml_query = require("../../xml/query.cjs");
+const require_typed_shared_geometry = require("../shared/geometry.cjs");
+const require_typed_shared_metadata = require("../shared/metadata.cjs");
+const require_typed_shared_paragraph = require("../shared/paragraph.cjs");
+const require_typed_shared_table = require("../shared/table.cjs");
+let document_schema_js = require("document-schema.js");
+//#region src/typed/odt/read.ts
+const CONTENT_PART = "content.xml";
+const STYLES_PART = "styles.xml";
+const AUTOMATIC_STYLE_PARTS = [CONTENT_PART, STYLES_PART];
+function readOutlineLevel(headingElement) {
+	const raw = require_xml_query.attrValue(headingElement, "text:outline-level");
+	if (raw === void 0) return 1;
+	const parsed = Number.parseInt(raw, 10);
+	return Number.isInteger(parsed) && parsed > 0 ? parsed : 1;
+}
+function readParagraphOrHeading(element, pkg, list) {
+	const paragraph = require_typed_shared_paragraph.readOdfParagraph(element, pkg);
+	if (element.tag === "text:h") paragraph.styleId = `Heading${readOutlineLevel(element)}`;
+	if (list !== void 0) paragraph.list = list;
+	return paragraph;
+}
+function readListItems(listElement, context, pkg, blocks) {
+	for (const item of listElement.children) {
+		if (item.type !== "element" || item.tag !== "text:list-item") continue;
+		for (const itemChild of item.children) {
+			if (itemChild.type !== "element") continue;
+			if (itemChild.tag === "text:p" || itemChild.tag === "text:h") blocks.push(readParagraphOrHeading(itemChild, pkg, context));
+			else if (itemChild.tag === "text:list") readListItems(itemChild, {
+				numId: context.numId,
+				level: context.level + 1
+			}, pkg, blocks);
+		}
+	}
+}
+function readBlocks(nodes, pkg, listIdState) {
+	const blocks = [];
+	for (const node of nodes) {
+		if (node.type !== "element") continue;
+		if (node.tag === "text:p" || node.tag === "text:h") blocks.push(readParagraphOrHeading(node, pkg, void 0));
+		else if (node.tag === "text:list") {
+			const numId = `list${listIdState.next}`;
+			listIdState.next += 1;
+			readListItems(node, {
+				numId,
+				level: 0
+			}, pkg, blocks);
+		} else if (node.tag === "table:table") blocks.push(require_typed_shared_table.readOdfTable(node, pkg));
+		else if (node.tag === "text:section") blocks.push(...readBlocks(node.children, pkg, listIdState));
+	}
+	return blocks;
+}
+function parseKnownOdfLength(value) {
+	const parsed = require_typed_shared_units.parseOdfLength(value);
+	if (parsed === void 0) throw new Error(`readOdt: internal error -- "${value}" is not a valid ODF length literal`);
+	return parsed;
+}
+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 findPageLayoutElement(pkg, pageLayoutName) {
+	if (pageLayoutName === void 0) return;
+	for (const partPath of AUTOMATIC_STYLE_PARTS) {
+		const part = pkg.parts[partPath];
+		if (part?.kind !== "xml") continue;
+		const root = require_xml_query.rootElement(part.nodes);
+		const automaticStyles = root === void 0 ? void 0 : require_xml_query.findChildElement(root.children, "office:automatic-styles");
+		if (automaticStyles === void 0) continue;
+		const found = require_xml_query.childrenWithTag(automaticStyles, "style:page-layout").find((element) => require_xml_query.attrValue(element, "style:name") === pageLayoutName);
+		if (found !== void 0) return found;
+	}
+}
+function readFirstMasterPageGeometry(pkg) {
+	const stylesPart = pkg.parts[STYLES_PART];
+	const stylesRoot = stylesPart?.kind === "xml" ? require_xml_query.rootElement(stylesPart.nodes) : void 0;
+	const masterStyles = stylesRoot === void 0 ? void 0 : require_xml_query.findChildElement(stylesRoot.children, "office:master-styles");
+	const masterPage = masterStyles === void 0 ? void 0 : require_xml_query.findChildElement(masterStyles.children, "style:master-page");
+	const layout = findPageLayoutElement(pkg, masterPage === void 0 ? void 0 : require_xml_query.attrValue(masterPage, "style:page-layout-name"));
+	const properties = layout === void 0 ? void 0 : require_xml_query.findChildElement(layout.children, "style:page-layout-properties");
+	const pageSize = properties === void 0 ? void 0 : require_typed_shared_geometry.parsePageSize(properties);
+	const margins = properties === void 0 ? void 0 : require_typed_shared_geometry.parseMargins(properties);
+	return {
+		pageSize: pageSize ?? document_schema_js.PAGE_SIZE_A4,
+		margins: margins ?? DEFAULT_MARGINS
+	};
+}
+function readOdt(pkg) {
+	const contentPart = pkg.parts[CONTENT_PART];
+	if (contentPart?.kind !== "xml") throw new Error(`readOdt: package has no ${CONTENT_PART} part`);
+	const contentRoot = require_xml_query.rootElement(contentPart.nodes);
+	const body = contentRoot === void 0 ? void 0 : require_xml_query.findChildElement(contentRoot.children, "office:body");
+	const textElement = body === void 0 ? void 0 : require_xml_query.findChildElement(body.children, "office:text");
+	if (textElement === void 0) throw new Error(`readOdt: ${CONTENT_PART} has no office:body/office:text element`);
+	const metadata = require_typed_shared_metadata.readOdfMetadata(pkg);
+	const { pageSize, margins } = readFirstMasterPageGeometry(pkg);
+	return {
+		metadata,
+		sections: [{
+			pageSize,
+			margins,
+			blocks: readBlocks(textElement.children, pkg, { next: 1 })
+		}]
+	};
+}
+//#endregion
+exports.readOdt = readOdt;

package/dist/typed/odt/read.d.cts

@@ -0,0 +1,10 @@
+import { Package } from "../../model/package.cjs";
+import { ContentSection, LayoutMetadata } from "document-schema.js";
+//#region src/typed/odt/read.d.ts
+interface OdtDocument {
+  metadata: LayoutMetadata;
+  sections: ContentSection[];
+}
+declare function readOdt(pkg: Package): OdtDocument;
+//#endregion
+export { OdtDocument, readOdt };

package/dist/typed/odt/read.d.ts

@@ -0,0 +1,10 @@
+import { Package } from "../../model/package.js";
+import { ContentSection, LayoutMetadata } from "document-schema.js";
+//#region src/typed/odt/read.d.ts
+interface OdtDocument {
+  metadata: LayoutMetadata;
+  sections: ContentSection[];
+}
+declare function readOdt(pkg: Package): OdtDocument;
+//#endregion
+export { OdtDocument, readOdt };

package/dist/typed/odt/read.js

@@ -0,0 +1,111 @@
+import { parseOdfLength } from "../shared/units.js";
+import { attrValue, childrenWithTag, findChildElement, rootElement } from "../../xml/query.js";
+import { parseMargins, parsePageSize } from "../shared/geometry.js";
+import { readOdfMetadata } from "../shared/metadata.js";
+import { readOdfParagraph } from "../shared/paragraph.js";
+import { readOdfTable } from "../shared/table.js";
+import { PAGE_SIZE_A4 } from "document-schema.js";
+//#region src/typed/odt/read.ts
+const CONTENT_PART = "content.xml";
+const STYLES_PART = "styles.xml";
+const AUTOMATIC_STYLE_PARTS = [CONTENT_PART, STYLES_PART];
+function readOutlineLevel(headingElement) {
+	const raw = attrValue(headingElement, "text:outline-level");
+	if (raw === void 0) return 1;
+	const parsed = Number.parseInt(raw, 10);
+	return Number.isInteger(parsed) && parsed > 0 ? parsed : 1;
+}
+function readParagraphOrHeading(element, pkg, list) {
+	const paragraph = readOdfParagraph(element, pkg);
+	if (element.tag === "text:h") paragraph.styleId = `Heading${readOutlineLevel(element)}`;
+	if (list !== void 0) paragraph.list = list;
+	return paragraph;
+}
+function readListItems(listElement, context, pkg, blocks) {
+	for (const item of listElement.children) {
+		if (item.type !== "element" || item.tag !== "text:list-item") continue;
+		for (const itemChild of item.children) {
+			if (itemChild.type !== "element") continue;
+			if (itemChild.tag === "text:p" || itemChild.tag === "text:h") blocks.push(readParagraphOrHeading(itemChild, pkg, context));
+			else if (itemChild.tag === "text:list") readListItems(itemChild, {
+				numId: context.numId,
+				level: context.level + 1
+			}, pkg, blocks);
+		}
+	}
+}
+function readBlocks(nodes, pkg, listIdState) {
+	const blocks = [];
+	for (const node of nodes) {
+		if (node.type !== "element") continue;
+		if (node.tag === "text:p" || node.tag === "text:h") blocks.push(readParagraphOrHeading(node, pkg, void 0));
+		else if (node.tag === "text:list") {
+			const numId = `list${listIdState.next}`;
+			listIdState.next += 1;
+			readListItems(node, {
+				numId,
+				level: 0
+			}, pkg, blocks);
+		} else if (node.tag === "table:table") blocks.push(readOdfTable(node, pkg));
+		else if (node.tag === "text:section") blocks.push(...readBlocks(node.children, pkg, listIdState));
+	}
+	return blocks;
+}
+function parseKnownOdfLength(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_MARGIN_PT = parseKnownOdfLength("2cm");
+const DEFAULT_MARGINS = {
+	topPt: DEFAULT_MARGIN_PT,
+	rightPt: DEFAULT_MARGIN_PT,
+	bottomPt: DEFAULT_MARGIN_PT,
+	leftPt: DEFAULT_MARGIN_PT
+};
+function findPageLayoutElement(pkg, pageLayoutName) {
+	if (pageLayoutName === void 0) return;
+	for (const partPath of AUTOMATIC_STYLE_PARTS) {
+		const part = pkg.parts[partPath];
+		if (part?.kind !== "xml") continue;
+		const root = rootElement(part.nodes);
+		const automaticStyles = root === void 0 ? void 0 : findChildElement(root.children, "office:automatic-styles");
+		if (automaticStyles === void 0) continue;
+		const found = childrenWithTag(automaticStyles, "style:page-layout").find((element) => attrValue(element, "style:name") === pageLayoutName);
+		if (found !== void 0) return found;
+	}
+}
+function readFirstMasterPageGeometry(pkg) {
+	const stylesPart = pkg.parts[STYLES_PART];
+	const stylesRoot = stylesPart?.kind === "xml" ? rootElement(stylesPart.nodes) : void 0;
+	const masterStyles = stylesRoot === void 0 ? void 0 : findChildElement(stylesRoot.children, "office:master-styles");
+	const masterPage = masterStyles === void 0 ? void 0 : findChildElement(masterStyles.children, "style:master-page");
+	const layout = findPageLayoutElement(pkg, masterPage === void 0 ? void 0 : attrValue(masterPage, "style:page-layout-name"));
+	const properties = layout === void 0 ? void 0 : findChildElement(layout.children, "style:page-layout-properties");
+	const pageSize = properties === void 0 ? void 0 : parsePageSize(properties);
+	const margins = properties === void 0 ? void 0 : parseMargins(properties);
+	return {
+		pageSize: pageSize ?? PAGE_SIZE_A4,
+		margins: margins ?? DEFAULT_MARGINS
+	};
+}
+function readOdt(pkg) {
+	const contentPart = pkg.parts[CONTENT_PART];
+	if (contentPart?.kind !== "xml") throw new Error(`readOdt: package has no ${CONTENT_PART} 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} has no office:body/office:text element`);
+	const metadata = readOdfMetadata(pkg);
+	const { pageSize, margins } = readFirstMasterPageGeometry(pkg);
+	return {
+		metadata,
+		sections: [{
+			pageSize,
+			margins,
+			blocks: readBlocks(textElement.children, pkg, { next: 1 })
+		}]
+	};
+}
+//#endregion
+export { readOdt };

package/dist/typed/shared/a1.cjs

@@ -0,0 +1,68 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/typed/shared/a1.ts
+const ALPHABET_SIZE = 26;
+const ALPHABET_START_CODE = "A".charCodeAt(0);
+function columnIndexToLetters(index) {
+	if (!Number.isInteger(index) || index < 0) throw new Error(`columnIndexToLetters: index must be a non-negative integer, got ${index}`);
+	let remaining = index + 1;
+	let letters = "";
+	while (remaining > 0) {
+		const digit = (remaining - 1) % ALPHABET_SIZE;
+		letters = String.fromCharCode(ALPHABET_START_CODE + digit) + letters;
+		remaining = Math.floor((remaining - 1) / ALPHABET_SIZE);
+	}
+	return letters;
+}
+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}`);
+}
+var TableCursor = class {
+	columnCursor = 0;
+	rowCursor = 0;
+	get columnIndex() {
+		return this.columnCursor;
+	}
+	get rowIndex() {
+		return this.rowCursor;
+	}
+	nextCell(repeatCount = 1) {
+		validateRepeatCount(repeatCount, "TableCursor.nextCell");
+		const reference = cellReference(this.columnCursor, this.rowCursor);
+		this.columnCursor += repeatCount;
+		return reference;
+	}
+	nextRow(repeatCount = 1) {
+		validateRepeatCount(repeatCount, "TableCursor.nextRow");
+		this.rowCursor += repeatCount;
+		this.columnCursor = 0;
+	}
+};
+//#endregion
+exports.TableCursor = TableCursor;
+exports.cellReference = cellReference;
+exports.columnIndexToLetters = columnIndexToLetters;
+exports.columnLettersToIndex = columnLettersToIndex;
+exports.parseCellReference = parseCellReference;

package/dist/typed/shared/a1.d.cts

@@ -0,0 +1,18 @@
+//#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;
+  get columnIndex(): number;
+  get rowIndex(): number;
+  nextCell(repeatCount?: number): string;
+  nextRow(repeatCount?: number): void;
+}
+//#endregion
+export { TableCursor, cellReference, columnIndexToLetters, columnLettersToIndex, parseCellReference };

package/dist/typed/shared/a1.d.ts

@@ -0,0 +1,18 @@
+//#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;
+  get columnIndex(): number;
+  get rowIndex(): number;
+  nextCell(repeatCount?: number): string;
+  nextRow(repeatCount?: number): void;
+}
+//#endregion
+export { TableCursor, cellReference, columnIndexToLetters, columnLettersToIndex, parseCellReference };