documents.js 1.57.1 → 1.59.0

package/dist/edit/ods/print-settings.js

@@ -0,0 +1,88 @@
+import { PAGE_SIZE_A4 } from "../../model/geometry.js";
+import { el } from "../../xml/fragment.js";
+import { setAttr } from "../../xml/edit.js";
+import { nextStyleName } from "../odt/automatic-styles.js";
+import { attr } from "ooxml.js";
+import { findStyleElement, formatOdfLength, parseMargins, parsePageSize, resolvePageLayoutProperties } from "odf.js";
+//#region src/edit/ods/print-settings.ts
+const STYLES_PART_PATH = "styles.xml";
+const CONTENT_PART_PATH = "content.xml";
+function findRoot(pkg, partPath) {
+	const part = pkg.parts[partPath];
+	const root = part?.kind === "xml" ? part.nodes.find((n) => n.type === "element") : void 0;
+	if (root === void 0) throw new Error(`package has no root element at ${partPath}`);
+	return root;
+}
+function directChild(parent, tag) {
+	for (const child of parent.children) if (child.type === "element" && child.tag === tag) return child;
+}
+function findStylesAutomaticStyles(pkg) {
+	const found = directChild(findRoot(pkg, STYLES_PART_PATH), "office:automatic-styles");
+	if (found === void 0) throw new Error(`${STYLES_PART_PATH} has no office:automatic-styles element`);
+	return found;
+}
+function findMasterStyles(pkg) {
+	const found = directChild(findRoot(pkg, STYLES_PART_PATH), "office:master-styles");
+	if (found === void 0) throw new Error(`${STYLES_PART_PATH} has no office:master-styles element`);
+	return found;
+}
+function findContentAutomaticStyles(pkg) {
+	const found = directChild(findRoot(pkg, CONTENT_PART_PATH), "office:automatic-styles");
+	if (found === void 0) throw new Error(`${CONTENT_PART_PATH} has no office:automatic-styles element`);
+	return found;
+}
+const DEFAULT_MARGIN_PT = 56.69291338582677;
+const DEFAULT_MARGINS = {
+	topPt: DEFAULT_MARGIN_PT,
+	rightPt: DEFAULT_MARGIN_PT,
+	bottomPt: DEFAULT_MARGIN_PT,
+	leftPt: DEFAULT_MARGIN_PT
+};
+function readSheetPrintSettings(pkg, tableElement) {
+	const tableStyleName = attr(tableElement, "table:style-name");
+	const tableStyleElement = tableStyleName === void 0 ? void 0 : findStyleElement(tableStyleName, "table", pkg);
+	const masterPageName = tableStyleElement === void 0 ? void 0 : attr(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 : attr(layoutProperties, "style:print"))?.split(" ").filter((token) => token.length > 0) ?? []);
+	const pageOrder = (layoutProperties === void 0 ? void 0 : attr(layoutProperties, "style:print-page-order")) === "ltr" ? "overThenDown" : "downThenOver";
+	return {
+		pageSize: pageSize ?? PAGE_SIZE_A4,
+		margins: margins ?? DEFAULT_MARGINS,
+		gridlines: printTokens.has("grid"),
+		headers: printTokens.has("headers"),
+		pageOrder
+	};
+}
+function writeSheetPrintSettings(pkg, tableElement, settings) {
+	const stylesAutomaticStyles = findStylesAutomaticStyles(pkg);
+	const masterStyles = findMasterStyles(pkg);
+	const contentAutomaticStyles = findContentAutomaticStyles(pkg);
+	const printTokens = [settings.gridlines ? "grid" : void 0, settings.headers ? "headers" : void 0].filter((token) => token !== void 0);
+	const pageLayoutName = nextStyleName(stylesAutomaticStyles, "style:page-layout", "OdsPageLayout");
+	stylesAutomaticStyles.children.push(el("style:page-layout", { "style:name": pageLayoutName }, [el("style:page-layout-properties", {
+		"fo:page-width": formatOdfLength(settings.pageSize.widthPt),
+		"fo:page-height": formatOdfLength(settings.pageSize.heightPt),
+		"fo:margin-top": formatOdfLength(settings.margins.topPt),
+		"fo:margin-right": formatOdfLength(settings.margins.rightPt),
+		"fo:margin-bottom": formatOdfLength(settings.margins.bottomPt),
+		"fo:margin-left": formatOdfLength(settings.margins.leftPt),
+		...printTokens.length > 0 ? { "style:print": printTokens.join(" ") } : {},
+		"style:print-page-order": settings.pageOrder === "overThenDown" ? "ltr" : "ttb"
+	})]));
+	const masterPageName = nextStyleName(masterStyles, "style:master-page", "OdsMasterPage");
+	masterStyles.children.push(el("style:master-page", {
+		"style:name": masterPageName,
+		"style:page-layout-name": pageLayoutName
+	}));
+	const tableStyleName = nextStyleName(contentAutomaticStyles, "style:style", "OdsSheetPrint");
+	contentAutomaticStyles.children.push(el("style:style", {
+		"style:name": tableStyleName,
+		"style:family": "table",
+		"style:master-page-name": masterPageName
+	}));
+	setAttr(tableElement, "table:style-name", tableStyleName);
+}
+//#endregion
+export { readSheetPrintSettings, writeSheetPrintSettings };

package/dist/edit/ods/scaffold.cjs

@@ -0,0 +1,129 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_xml_fragment = require("../../xml/fragment.cjs");
+let odf_js = require("odf.js");
+let document_schema_js = require("document-schema.js");
+//#region src/edit/ods/scaffold.ts
+const CONTENT_NS_PREFIXES = [
+	"office",
+	"style",
+	"text",
+	"table",
+	"fo"
+];
+const STYLES_NS_PREFIXES = [
+	"office",
+	"style",
+	"table",
+	"fo"
+];
+const META_NS_PREFIXES = [
+	"office",
+	"meta",
+	"dc"
+];
+const OF_NAMESPACE_ATTR = { "xmlns:of": "urn:oasis:names:tc:opendocument:xmlns:of:1.2" };
+const ODF_VERSION = "1.3";
+const PAGE_LAYOUT_NAME = "PM1";
+const MASTER_PAGE_NAME = "Standard";
+const SHEET_TABLE_STYLE_NAME = "OdsTable";
+const DEFAULT_SHEET_NAME = "Sheet1";
+const DEFAULT_MARGIN = "2cm";
+function declaration() {
+	return {
+		type: "declaration",
+		attributes: [
+			{
+				name: "version",
+				value: "1.0"
+			},
+			{
+				name: "encoding",
+				value: "UTF-8"
+			},
+			{
+				name: "standalone",
+				value: "yes"
+			}
+		]
+	};
+}
+function buildPageLayout() {
+	return require_xml_fragment.el("style:page-layout", { "style:name": "PM1" }, [require_xml_fragment.el("style:page-layout-properties", {
+		"fo:page-width": `${document_schema_js.PAGE_SIZE_A4.widthPt}pt`,
+		"fo:page-height": `${document_schema_js.PAGE_SIZE_A4.heightPt}pt`,
+		"fo:margin-top": DEFAULT_MARGIN,
+		"fo:margin-right": DEFAULT_MARGIN,
+		"fo:margin-bottom": DEFAULT_MARGIN,
+		"fo:margin-left": DEFAULT_MARGIN
+	})]);
+}
+function buildStylesXml() {
+	return require_xml_fragment.el("office:document-styles", {
+		...(0, odf_js.xmlnsAttributes)([...STYLES_NS_PREFIXES]),
+		"office:version": ODF_VERSION
+	}, [
+		require_xml_fragment.el("office:styles"),
+		require_xml_fragment.el("office:automatic-styles", {}, [buildPageLayout()]),
+		require_xml_fragment.el("office:master-styles", {}, [require_xml_fragment.el("style:master-page", {
+			"style:name": MASTER_PAGE_NAME,
+			"style:page-layout-name": "PM1"
+		})])
+	]);
+}
+function buildSheetTableStyle() {
+	return require_xml_fragment.el("style:style", {
+		"style:name": SHEET_TABLE_STYLE_NAME,
+		"style:family": "table",
+		"style:master-page-name": MASTER_PAGE_NAME
+	});
+}
+function buildCalculationSettings() {
+	return require_xml_fragment.el("table:calculation-settings", {
+		"table:automatic-find-labels": "false",
+		"table:use-regular-expressions": "false",
+		"table:use-wildcards": "true",
+		"table:null-year": "1950"
+	});
+}
+function buildContentXml() {
+	const table = require_xml_fragment.el("table:table", {
+		"table:name": DEFAULT_SHEET_NAME,
+		"table:style-name": SHEET_TABLE_STYLE_NAME
+	});
+	return require_xml_fragment.el("office:document-content", {
+		...(0, odf_js.xmlnsAttributes)([...CONTENT_NS_PREFIXES]),
+		...OF_NAMESPACE_ATTR,
+		"office:version": ODF_VERSION
+	}, [require_xml_fragment.el("office:automatic-styles", {}, [buildSheetTableStyle()]), require_xml_fragment.el("office:body", {}, [require_xml_fragment.el("office:spreadsheet", {}, [buildCalculationSettings(), table])])]);
+}
+function buildMetaXml() {
+	return require_xml_fragment.el("office:document-meta", {
+		...(0, odf_js.xmlnsAttributes)([...META_NS_PREFIXES]),
+		"office:version": ODF_VERSION
+	}, [require_xml_fragment.el("office:meta")]);
+}
+function createEmptyOdsPackage() {
+	const pkg = { parts: {
+		"content.xml": {
+			kind: "xml",
+			nodes: [declaration(), buildContentXml()]
+		},
+		"styles.xml": {
+			kind: "xml",
+			nodes: [declaration(), buildStylesXml()]
+		},
+		"meta.xml": {
+			kind: "xml",
+			nodes: [declaration(), buildMetaXml()]
+		}
+	} };
+	(0, odf_js.setDocumentMediaType)(pkg, odf_js.ODF_MEDIA_TYPES.ods);
+	(0, odf_js.syncManifest)(pkg);
+	return pkg;
+}
+//#endregion
+exports.DEFAULT_SHEET_NAME = DEFAULT_SHEET_NAME;
+exports.MASTER_PAGE_NAME = MASTER_PAGE_NAME;
+exports.PAGE_LAYOUT_NAME = PAGE_LAYOUT_NAME;
+exports.SHEET_TABLE_STYLE_NAME = SHEET_TABLE_STYLE_NAME;
+exports.createEmptyOdsPackage = createEmptyOdsPackage;

package/dist/edit/ods/scaffold.d.cts

@@ -0,0 +1,9 @@
+import { Package } from "odf.js";
+//#region src/edit/ods/scaffold.d.ts
+declare const PAGE_LAYOUT_NAME = "PM1";
+declare const MASTER_PAGE_NAME = "Standard";
+declare const SHEET_TABLE_STYLE_NAME = "OdsTable";
+declare const DEFAULT_SHEET_NAME = "Sheet1";
+declare function createEmptyOdsPackage(): Package;
+//#endregion
+export { DEFAULT_SHEET_NAME, MASTER_PAGE_NAME, PAGE_LAYOUT_NAME, SHEET_TABLE_STYLE_NAME, createEmptyOdsPackage };

package/dist/edit/ods/scaffold.d.ts

@@ -0,0 +1,9 @@
+import { Package } from "odf.js";
+//#region src/edit/ods/scaffold.d.ts
+declare const PAGE_LAYOUT_NAME = "PM1";
+declare const MASTER_PAGE_NAME = "Standard";
+declare const SHEET_TABLE_STYLE_NAME = "OdsTable";
+declare const DEFAULT_SHEET_NAME = "Sheet1";
+declare function createEmptyOdsPackage(): Package;
+//#endregion
+export { DEFAULT_SHEET_NAME, MASTER_PAGE_NAME, PAGE_LAYOUT_NAME, SHEET_TABLE_STYLE_NAME, createEmptyOdsPackage };

package/dist/edit/ods/scaffold.js

@@ -0,0 +1,124 @@
+import { PAGE_SIZE_A4 } from "../../model/geometry.js";
+import { el } from "../../xml/fragment.js";
+import { ODF_MEDIA_TYPES, setDocumentMediaType, syncManifest, xmlnsAttributes } from "odf.js";
+//#region src/edit/ods/scaffold.ts
+const CONTENT_NS_PREFIXES = [
+	"office",
+	"style",
+	"text",
+	"table",
+	"fo"
+];
+const STYLES_NS_PREFIXES = [
+	"office",
+	"style",
+	"table",
+	"fo"
+];
+const META_NS_PREFIXES = [
+	"office",
+	"meta",
+	"dc"
+];
+const OF_NAMESPACE_ATTR = { "xmlns:of": "urn:oasis:names:tc:opendocument:xmlns:of:1.2" };
+const ODF_VERSION = "1.3";
+const PAGE_LAYOUT_NAME = "PM1";
+const MASTER_PAGE_NAME = "Standard";
+const SHEET_TABLE_STYLE_NAME = "OdsTable";
+const DEFAULT_SHEET_NAME = "Sheet1";
+const DEFAULT_MARGIN = "2cm";
+function declaration() {
+	return {
+		type: "declaration",
+		attributes: [
+			{
+				name: "version",
+				value: "1.0"
+			},
+			{
+				name: "encoding",
+				value: "UTF-8"
+			},
+			{
+				name: "standalone",
+				value: "yes"
+			}
+		]
+	};
+}
+function buildPageLayout() {
+	return el("style:page-layout", { "style:name": "PM1" }, [el("style:page-layout-properties", {
+		"fo:page-width": `${PAGE_SIZE_A4.widthPt}pt`,
+		"fo:page-height": `${PAGE_SIZE_A4.heightPt}pt`,
+		"fo:margin-top": DEFAULT_MARGIN,
+		"fo:margin-right": DEFAULT_MARGIN,
+		"fo:margin-bottom": DEFAULT_MARGIN,
+		"fo:margin-left": DEFAULT_MARGIN
+	})]);
+}
+function buildStylesXml() {
+	return el("office:document-styles", {
+		...xmlnsAttributes([...STYLES_NS_PREFIXES]),
+		"office:version": ODF_VERSION
+	}, [
+		el("office:styles"),
+		el("office:automatic-styles", {}, [buildPageLayout()]),
+		el("office:master-styles", {}, [el("style:master-page", {
+			"style:name": MASTER_PAGE_NAME,
+			"style:page-layout-name": "PM1"
+		})])
+	]);
+}
+function buildSheetTableStyle() {
+	return el("style:style", {
+		"style:name": SHEET_TABLE_STYLE_NAME,
+		"style:family": "table",
+		"style:master-page-name": MASTER_PAGE_NAME
+	});
+}
+function buildCalculationSettings() {
+	return el("table:calculation-settings", {
+		"table:automatic-find-labels": "false",
+		"table:use-regular-expressions": "false",
+		"table:use-wildcards": "true",
+		"table:null-year": "1950"
+	});
+}
+function buildContentXml() {
+	const table = el("table:table", {
+		"table:name": DEFAULT_SHEET_NAME,
+		"table:style-name": SHEET_TABLE_STYLE_NAME
+	});
+	return el("office:document-content", {
+		...xmlnsAttributes([...CONTENT_NS_PREFIXES]),
+		...OF_NAMESPACE_ATTR,
+		"office:version": ODF_VERSION
+	}, [el("office:automatic-styles", {}, [buildSheetTableStyle()]), el("office:body", {}, [el("office:spreadsheet", {}, [buildCalculationSettings(), table])])]);
+}
+function buildMetaXml() {
+	return el("office:document-meta", {
+		...xmlnsAttributes([...META_NS_PREFIXES]),
+		"office:version": ODF_VERSION
+	}, [el("office:meta")]);
+}
+function createEmptyOdsPackage() {
+	const pkg = { parts: {
+		"content.xml": {
+			kind: "xml",
+			nodes: [declaration(), buildContentXml()]
+		},
+		"styles.xml": {
+			kind: "xml",
+			nodes: [declaration(), buildStylesXml()]
+		},
+		"meta.xml": {
+			kind: "xml",
+			nodes: [declaration(), buildMetaXml()]
+		}
+	} };
+	setDocumentMediaType(pkg, ODF_MEDIA_TYPES.ods);
+	syncManifest(pkg);
+	return pkg;
+}
+//#endregion
+export { DEFAULT_SHEET_NAME, MASTER_PAGE_NAME, PAGE_LAYOUT_NAME, SHEET_TABLE_STYLE_NAME, createEmptyOdsPackage };

package/dist/edit/ods/sheet.cjs

@@ -0,0 +1,77 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_xml_edit = require("../../xml/edit.cjs");
+const require_edit_ods_address = require("./address.cjs");
+const require_edit_ods_cell = require("./cell.cjs");
+const require_edit_ods_column_row = require("./column-row.cjs");
+const require_edit_ods_print_settings = require("./print-settings.cjs");
+let ooxml_js = require("ooxml.js");
+let odf_js = require("odf.js");
+//#region src/edit/ods/sheet.ts
+const NAME_ATTR = "table:name";
+var OdsSheet = class {
+	container;
+	node;
+	pkg;
+	removed = false;
+	constructor(container, node, pkg) {
+		this.container = container;
+		this.node = node;
+		this.pkg = pkg;
+	}
+	live() {
+		if (this.removed) throw new Error("this OdsSheet has been removed from the spreadsheet and can no longer be used");
+		return this.node;
+	}
+	get name() {
+		const value = (0, ooxml_js.attr)(this.live(), NAME_ATTR);
+		if (value === void 0) throw new Error("this table:table element has no table:name attribute");
+		return value;
+	}
+	set name(value) {
+		require_xml_edit.setAttr(this.live(), NAME_ATTR, value);
+	}
+	get printSettings() {
+		return require_edit_ods_print_settings.readSheetPrintSettings(this.pkg, this.live());
+	}
+	set printSettings(value) {
+		require_edit_ods_print_settings.writeSheetPrintSettings(this.pkg, this.live(), value);
+	}
+	setColumnWidth(index, widthPt) {
+		require_edit_ods_column_row.writeColumnWidth(this.pkg, this.live(), index, widthPt);
+	}
+	setRowHeight(index, heightPt) {
+		require_edit_ods_column_row.writeRowHeight(this.pkg, this.live(), index, heightPt);
+	}
+	cell(row, column) {
+		const node = require_edit_ods_address.resolveCellNode(this.live(), row, column);
+		if (node.tag === "table:covered-table-cell") throw new Error(`cell (${row}, ${column}) is covered by a merged range -- address the merge's own anchor cell instead`);
+		return new require_edit_ods_cell.OdsCell(node, this.pkg);
+	}
+	cellAt(reference) {
+		const parsed = (0, odf_js.parseCellReference)(reference);
+		if (parsed === void 0) throw new Error(`cellAt: "${reference}" is not a valid A1-style cell reference`);
+		return this.cell(parsed.row, parsed.column);
+	}
+	mergeCells(startRow, startColumn, rowSpan, colSpan) {
+		if (!Number.isInteger(rowSpan) || rowSpan < 1 || !Number.isInteger(colSpan) || colSpan < 1) throw new Error(`mergeCells: rowSpan and colSpan must be positive integers, got rowSpan=${rowSpan}, colSpan=${colSpan}`);
+		const tableElement = this.live();
+		const anchorNode = require_edit_ods_address.resolveCellNode(tableElement, startRow, startColumn);
+		if (anchorNode.tag === "table:covered-table-cell") throw new Error(`mergeCells: (${startRow}, ${startColumn}) is already covered by another merged range`);
+		if (rowSpan > 1) require_xml_edit.setAttr(anchorNode, "table:number-rows-spanned", String(rowSpan));
+		if (colSpan > 1) require_xml_edit.setAttr(anchorNode, "table:number-columns-spanned", String(colSpan));
+		for (let rowOffset = 0; rowOffset < rowSpan; rowOffset++) for (let columnOffset = 0; columnOffset < colSpan; columnOffset++) {
+			if (rowOffset === 0 && columnOffset === 0) continue;
+			const coveredNode = require_edit_ods_address.resolveCellNode(tableElement, startRow + rowOffset, startColumn + columnOffset);
+			coveredNode.tag = require_edit_ods_address.COVERED_CELL_TAG;
+			coveredNode.attributes = [];
+			coveredNode.children = [];
+		}
+		return new require_edit_ods_cell.OdsCell(anchorNode, this.pkg);
+	}
+	remove() {
+		require_xml_edit.removeChild(this.container, this.live());
+		this.removed = true;
+	}
+};
+//#endregion
+exports.OdsSheet = OdsSheet;

package/dist/edit/ods/sheet.d.cts

@@ -0,0 +1,24 @@
+import { t as OdsCell } from "../../cell-CNHPsDEk.cjs";
+import { ContentSheetPrintSettings } from "document-schema.js";
+import { Package, XmlElement, XmlNode } from "odf.js";
+//#region src/edit/ods/sheet.d.ts
+declare class OdsSheet {
+  private readonly container;
+  private readonly node;
+  private readonly pkg;
+  private removed;
+  constructor(container: XmlNode[], node: XmlElement, pkg: Package);
+  private live;
+  get name(): string;
+  set name(value: string);
+  get printSettings(): ContentSheetPrintSettings;
+  set printSettings(value: ContentSheetPrintSettings);
+  setColumnWidth(index: number, widthPt: number): void;
+  setRowHeight(index: number, heightPt: number): void;
+  cell(row: number, column: number): OdsCell;
+  cellAt(reference: string): OdsCell;
+  mergeCells(startRow: number, startColumn: number, rowSpan: number, colSpan: number): OdsCell;
+  remove(): void;
+}
+//#endregion
+export { OdsSheet };

package/dist/edit/ods/sheet.d.ts

@@ -0,0 +1,24 @@
+import { t as OdsCell } from "../../cell-CNHPsDEk.js";
+import { ContentSheetPrintSettings } from "document-schema.js";
+import { Package, XmlElement, XmlNode } from "odf.js";
+//#region src/edit/ods/sheet.d.ts
+declare class OdsSheet {
+  private readonly container;
+  private readonly node;
+  private readonly pkg;
+  private removed;
+  constructor(container: XmlNode[], node: XmlElement, pkg: Package);
+  private live;
+  get name(): string;
+  set name(value: string);
+  get printSettings(): ContentSheetPrintSettings;
+  set printSettings(value: ContentSheetPrintSettings);
+  setColumnWidth(index: number, widthPt: number): void;
+  setRowHeight(index: number, heightPt: number): void;
+  cell(row: number, column: number): OdsCell;
+  cellAt(reference: string): OdsCell;
+  mergeCells(startRow: number, startColumn: number, rowSpan: number, colSpan: number): OdsCell;
+  remove(): void;
+}
+//#endregion
+export { OdsSheet };

package/dist/edit/ods/sheet.js

@@ -0,0 +1,76 @@
+import { removeChild, setAttr } from "../../xml/edit.js";
+import { COVERED_CELL_TAG, resolveCellNode } from "./address.js";
+import { OdsCell } from "./cell.js";
+import { writeColumnWidth, writeRowHeight } from "./column-row.js";
+import { readSheetPrintSettings, writeSheetPrintSettings } from "./print-settings.js";
+import { attr } from "ooxml.js";
+import { parseCellReference } from "odf.js";
+//#region src/edit/ods/sheet.ts
+const NAME_ATTR = "table:name";
+var OdsSheet = class {
+	container;
+	node;
+	pkg;
+	removed = false;
+	constructor(container, node, pkg) {
+		this.container = container;
+		this.node = node;
+		this.pkg = pkg;
+	}
+	live() {
+		if (this.removed) throw new Error("this OdsSheet has been removed from the spreadsheet and can no longer be used");
+		return this.node;
+	}
+	get name() {
+		const value = attr(this.live(), NAME_ATTR);
+		if (value === void 0) throw new Error("this table:table element has no table:name attribute");
+		return value;
+	}
+	set name(value) {
+		setAttr(this.live(), NAME_ATTR, value);
+	}
+	get printSettings() {
+		return readSheetPrintSettings(this.pkg, this.live());
+	}
+	set printSettings(value) {
+		writeSheetPrintSettings(this.pkg, this.live(), value);
+	}
+	setColumnWidth(index, widthPt) {
+		writeColumnWidth(this.pkg, this.live(), index, widthPt);
+	}
+	setRowHeight(index, heightPt) {
+		writeRowHeight(this.pkg, this.live(), index, heightPt);
+	}
+	cell(row, column) {
+		const node = resolveCellNode(this.live(), row, column);
+		if (node.tag === "table:covered-table-cell") throw new Error(`cell (${row}, ${column}) is covered by a merged range -- address the merge's own anchor cell instead`);
+		return new OdsCell(node, this.pkg);
+	}
+	cellAt(reference) {
+		const parsed = parseCellReference(reference);
+		if (parsed === void 0) throw new Error(`cellAt: "${reference}" is not a valid A1-style cell reference`);
+		return this.cell(parsed.row, parsed.column);
+	}
+	mergeCells(startRow, startColumn, rowSpan, colSpan) {
+		if (!Number.isInteger(rowSpan) || rowSpan < 1 || !Number.isInteger(colSpan) || colSpan < 1) throw new Error(`mergeCells: rowSpan and colSpan must be positive integers, got rowSpan=${rowSpan}, colSpan=${colSpan}`);
+		const tableElement = this.live();
+		const anchorNode = resolveCellNode(tableElement, startRow, startColumn);
+		if (anchorNode.tag === "table:covered-table-cell") throw new Error(`mergeCells: (${startRow}, ${startColumn}) is already covered by another merged range`);
+		if (rowSpan > 1) setAttr(anchorNode, "table:number-rows-spanned", String(rowSpan));
+		if (colSpan > 1) setAttr(anchorNode, "table:number-columns-spanned", String(colSpan));
+		for (let rowOffset = 0; rowOffset < rowSpan; rowOffset++) for (let columnOffset = 0; columnOffset < colSpan; columnOffset++) {
+			if (rowOffset === 0 && columnOffset === 0) continue;
+			const coveredNode = resolveCellNode(tableElement, startRow + rowOffset, startColumn + columnOffset);
+			coveredNode.tag = COVERED_CELL_TAG;
+			coveredNode.attributes = [];
+			coveredNode.children = [];
+		}
+		return new OdsCell(anchorNode, this.pkg);
+	}
+	remove() {
+		removeChild(this.container, this.live());
+		this.removed = true;
+	}
+};
+//#endregion
+export { OdsSheet };

package/dist/edit/odt/automatic-styles.cjs

@@ -0,0 +1,49 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_xml_fragment = require("../../xml/fragment.cjs");
+let ooxml_js = require("ooxml.js");
+//#region src/edit/odt/automatic-styles.ts
+const CONTENT_PART_PATH = "content.xml";
+function ensureAutomaticStyles(pkg) {
+	const part = pkg.parts[CONTENT_PART_PATH];
+	if (part?.kind !== "xml") throw new Error(`ensureAutomaticStyles: package has no ${CONTENT_PART_PATH} part`);
+	const root = part.nodes.find((n) => n.type === "element");
+	if (root === void 0) throw new Error(`ensureAutomaticStyles: ${CONTENT_PART_PATH} has no root element`);
+	for (const child of root.children) if (child.type === "element" && child.tag === "office:automatic-styles") return child;
+	const created = require_xml_fragment.el("office:automatic-styles");
+	const insertBeforeTags = /* @__PURE__ */ new Set([
+		"office:body",
+		"office:master-styles",
+		"office:settings"
+	]);
+	const insertIndex = root.children.findIndex((n) => n.type === "element" && insertBeforeTags.has(n.tag));
+	if (insertIndex === -1) root.children.push(created);
+	else root.children.splice(insertIndex, 0, created);
+	return created;
+}
+function nextStyleName(automaticStyles, tag, prefix) {
+	let max = 0;
+	for (const child of automaticStyles.children) {
+		if (child.type !== "element" || child.tag !== tag) continue;
+		const name = (0, ooxml_js.attr)(child, "style:name");
+		if (!name?.startsWith(prefix)) continue;
+		const rest = name.slice(prefix.length);
+		const n = Number.parseInt(rest, 10);
+		if (!Number.isNaN(n) && String(n) === rest && n > max) max = n;
+	}
+	return `${prefix}${max + 1}`;
+}
+const PAGE_BREAK_STYLE_NAME = "OdtPageBreak";
+function ensurePageBreakStyleName(pkg) {
+	const automaticStyles = ensureAutomaticStyles(pkg);
+	if (automaticStyles.children.find((c) => c.type === "element" && c.tag === "style:style" && (0, ooxml_js.attr)(c, "style:name") === PAGE_BREAK_STYLE_NAME) !== void 0) return PAGE_BREAK_STYLE_NAME;
+	automaticStyles.children.push(require_xml_fragment.el("style:style", {
+		"style:name": PAGE_BREAK_STYLE_NAME,
+		"style:family": "paragraph"
+	}, [require_xml_fragment.el("style:paragraph-properties", { "fo:break-before": "page" })]));
+	return PAGE_BREAK_STYLE_NAME;
+}
+//#endregion
+exports.CONTENT_PART_PATH = CONTENT_PART_PATH;
+exports.ensureAutomaticStyles = ensureAutomaticStyles;
+exports.ensurePageBreakStyleName = ensurePageBreakStyleName;
+exports.nextStyleName = nextStyleName;

package/dist/edit/odt/automatic-styles.d.cts

@@ -0,0 +1,8 @@
+import { Package, XmlElement } from "odf.js";
+//#region src/edit/odt/automatic-styles.d.ts
+declare const CONTENT_PART_PATH = "content.xml";
+declare function ensureAutomaticStyles(pkg: Package): XmlElement;
+declare function nextStyleName(automaticStyles: XmlElement, tag: string, prefix: string): string;
+declare function ensurePageBreakStyleName(pkg: Package): string;
+//#endregion
+export { CONTENT_PART_PATH, ensureAutomaticStyles, ensurePageBreakStyleName, nextStyleName };

package/dist/edit/odt/automatic-styles.d.ts

@@ -0,0 +1,8 @@
+import { Package, XmlElement } from "odf.js";
+//#region src/edit/odt/automatic-styles.d.ts
+declare const CONTENT_PART_PATH = "content.xml";
+declare function ensureAutomaticStyles(pkg: Package): XmlElement;
+declare function nextStyleName(automaticStyles: XmlElement, tag: string, prefix: string): string;
+declare function ensurePageBreakStyleName(pkg: Package): string;
+//#endregion
+export { CONTENT_PART_PATH, ensureAutomaticStyles, ensurePageBreakStyleName, nextStyleName };