documents.js 1.57.1 → 1.59.0

package/dist/edit/docx/table.js

@@ -0,0 +1,95 @@
+import { el } from "../../xml/fragment.js";
+import { removeChild } from "../../xml/edit.js";
+import { DocxParagraph, buildParagraph } from "./paragraph.js";
+//#region src/edit/docx/table.ts
+const DEFAULT_TABLE_WIDTH_TWIPS = 9360;
+var DocxTableCell = class {
+	node;
+	constructor(node) {
+		this.node = node;
+	}
+	paragraphs() {
+		const out = [];
+		for (const child of this.node.children) if (child.type === "element" && child.tag === "w:p") out.push(new DocxParagraph(this.node.children, child));
+		return out;
+	}
+	appendParagraph(init) {
+		const paragraphElement = buildParagraph(init);
+		this.node.children.push(paragraphElement);
+		return new DocxParagraph(this.node.children, paragraphElement);
+	}
+	get text() {
+		return this.paragraphs().map((p) => p.text).join("\n");
+	}
+};
+var DocxTableRow = class {
+	node;
+	constructor(node) {
+		this.node = node;
+	}
+	cells() {
+		const out = [];
+		for (const child of this.node.children) if (child.type === "element" && child.tag === "w:tc") out.push(new DocxTableCell(child));
+		return out;
+	}
+};
+function buildCell() {
+	return el("w:tc", {}, [buildParagraph()]);
+}
+var DocxTable = class {
+	container;
+	node;
+	removed = false;
+	constructor(container, node) {
+		this.container = container;
+		this.node = node;
+	}
+	live() {
+		if (this.removed) throw new Error("this DocxTable has been removed and can no longer be used");
+		return this.node;
+	}
+	rows() {
+		const out = [];
+		for (const child of this.live().children) if (child.type === "element" && child.tag === "w:tr") out.push(new DocxTableRow(child));
+		return out;
+	}
+	cell(rowIndex, columnIndex) {
+		const row = this.rows()[rowIndex];
+		if (row === void 0) throw new Error(`row ${rowIndex} does not exist in this table`);
+		const cell = row.cells()[columnIndex];
+		if (cell === void 0) throw new Error(`column ${columnIndex} does not exist in row ${rowIndex}`);
+		return cell;
+	}
+	appendRow(columnCount) {
+		const node = this.live();
+		const cells = [];
+		for (let i = 0; i < columnCount; i++) cells.push(buildCell());
+		const row = el("w:tr", {}, cells);
+		node.children.push(row);
+		return new DocxTableRow(row);
+	}
+	remove() {
+		removeChild(this.container, this.live());
+		this.removed = true;
+	}
+};
+function buildTblGrid(columns, columnWidthsTwips) {
+	const defaultWidth = Math.floor(DEFAULT_TABLE_WIDTH_TWIPS / columns);
+	const cols = [];
+	for (let i = 0; i < columns; i++) {
+		const width = columnWidthsTwips?.[i] ?? defaultWidth;
+		cols.push(el("w:gridCol", { "w:w": String(width) }));
+	}
+	return el("w:tblGrid", {}, cols);
+}
+function buildTable(init) {
+	const rows = [];
+	for (let r = 0; r < init.rows; r++) {
+		const cells = [];
+		for (let c = 0; c < init.columns; c++) cells.push(buildCell());
+		rows.push(el("w:tr", {}, cells));
+	}
+	return el("w:tbl", {}, [buildTblGrid(init.columns, init.columnWidthsTwips), ...rows]);
+}
+//#endregion
+export { DocxTable, DocxTableCell, DocxTableRow, buildTable };

package/dist/edit/odg/content.cjs

@@ -0,0 +1,65 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_edit_odt_content = require("../odt/content.cjs");
+const require_edit_odg_editor = require("./editor.cjs");
+let odf_js = require("odf.js");
+//#region src/edit/odg/content.ts
+function buildOdgPackage(content) {
+	if (content.kind !== "drawing") throw new Error("buildOdgPackage requires a drawing ContentDocument");
+	const editor = require_edit_odg_editor.createOdg();
+	const firstPage = content.pages[0];
+	if (firstPage !== void 0) editor.pageSize = firstPage.size;
+	for (const page of content.pages) {
+		const odgPage = editor.addPage();
+		for (const vector of page.vectors) appendVector(odgPage, vector);
+		for (const shape of page.shapes) appendShape(odgPage, shape);
+	}
+	return editor.toPackage();
+}
+function appendVector(page, vector) {
+	if (vector.kind === "rect") page.addRect({
+		frame: vector.frame,
+		fill: vector.fill,
+		stroke: vector.stroke
+	});
+	else if (vector.kind === "ellipse") page.addEllipse({
+		frame: vector.frame,
+		fill: vector.fill,
+		stroke: vector.stroke
+	});
+	else if (vector.kind === "line") page.addLine({
+		from: vector.from,
+		to: vector.to,
+		stroke: vector.stroke
+	});
+	else page.addPath({
+		frame: vector.frame,
+		subpaths: vector.subpaths,
+		fill: vector.fill,
+		stroke: vector.stroke
+	});
+}
+function appendShape(page, shape) {
+	const [onlyBlock] = shape.blocks;
+	if (shape.blocks.length === 1 && onlyBlock?.kind === "image") {
+		const imageShape = page.addImage({
+			frame: shape.frame,
+			format: onlyBlock.format,
+			bytes: (0, odf_js.base64ToBytes)(onlyBlock.base64),
+			altText: onlyBlock.altText
+		});
+		if (shape.rotationDeg !== void 0) imageShape.rotationDeg = shape.rotationDeg;
+		return;
+	}
+	const textShape = page.addTextBox({
+		frame: shape.frame,
+		text: ""
+	});
+	if (shape.rotationDeg !== void 0) textShape.rotationDeg = shape.rotationDeg;
+	textShape.paragraphs()[0]?.remove();
+	for (const block of shape.blocks) {
+		if (block.kind !== "paragraph") continue;
+		require_edit_odt_content.populateParagraph(textShape.appendParagraph(), block);
+	}
+}
+//#endregion
+exports.buildOdgPackage = buildOdgPackage;

package/dist/edit/odg/content.d.cts

@@ -0,0 +1,6 @@
+import { ContentDocument } from "../../model/content.cjs";
+import { Package } from "odf.js";
+//#region src/edit/odg/content.d.ts
+declare function buildOdgPackage(content: ContentDocument): Package;
+//#endregion
+export { buildOdgPackage };

package/dist/edit/odg/content.d.ts

@@ -0,0 +1,6 @@
+import { ContentDocument } from "../../model/content.js";
+import { Package } from "odf.js";
+//#region src/edit/odg/content.d.ts
+declare function buildOdgPackage(content: ContentDocument): Package;
+//#endregion
+export { buildOdgPackage };

package/dist/edit/odg/content.js

@@ -0,0 +1,64 @@
+import { populateParagraph } from "../odt/content.js";
+import { createOdg } from "./editor.js";
+import { base64ToBytes } from "odf.js";
+//#region src/edit/odg/content.ts
+function buildOdgPackage(content) {
+	if (content.kind !== "drawing") throw new Error("buildOdgPackage requires a drawing ContentDocument");
+	const editor = createOdg();
+	const firstPage = content.pages[0];
+	if (firstPage !== void 0) editor.pageSize = firstPage.size;
+	for (const page of content.pages) {
+		const odgPage = editor.addPage();
+		for (const vector of page.vectors) appendVector(odgPage, vector);
+		for (const shape of page.shapes) appendShape(odgPage, shape);
+	}
+	return editor.toPackage();
+}
+function appendVector(page, vector) {
+	if (vector.kind === "rect") page.addRect({
+		frame: vector.frame,
+		fill: vector.fill,
+		stroke: vector.stroke
+	});
+	else if (vector.kind === "ellipse") page.addEllipse({
+		frame: vector.frame,
+		fill: vector.fill,
+		stroke: vector.stroke
+	});
+	else if (vector.kind === "line") page.addLine({
+		from: vector.from,
+		to: vector.to,
+		stroke: vector.stroke
+	});
+	else page.addPath({
+		frame: vector.frame,
+		subpaths: vector.subpaths,
+		fill: vector.fill,
+		stroke: vector.stroke
+	});
+}
+function appendShape(page, shape) {
+	const [onlyBlock] = shape.blocks;
+	if (shape.blocks.length === 1 && onlyBlock?.kind === "image") {
+		const imageShape = page.addImage({
+			frame: shape.frame,
+			format: onlyBlock.format,
+			bytes: base64ToBytes(onlyBlock.base64),
+			altText: onlyBlock.altText
+		});
+		if (shape.rotationDeg !== void 0) imageShape.rotationDeg = shape.rotationDeg;
+		return;
+	}
+	const textShape = page.addTextBox({
+		frame: shape.frame,
+		text: ""
+	});
+	if (shape.rotationDeg !== void 0) textShape.rotationDeg = shape.rotationDeg;
+	textShape.paragraphs()[0]?.remove();
+	for (const block of shape.blocks) {
+		if (block.kind !== "paragraph") continue;
+		populateParagraph(textShape.appendParagraph(), block);
+	}
+}
+//#endregion
+export { buildOdgPackage };

package/dist/edit/odg/editor.cjs

@@ -0,0 +1,96 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_xml_fragment = require("../../xml/fragment.cjs");
+const require_edit_odg_scaffold = require("./scaffold.cjs");
+const require_edit_odg_page = require("./page.cjs");
+let ooxml_js = require("ooxml.js");
+let odf_js = require("odf.js");
+//#region src/edit/odg/editor.ts
+const CONTENT_PART_PATH = "content.xml";
+const STYLES_PART_PATH = "styles.xml";
+function directChild(parent, tag) {
+	for (const child of parent.children) if (child.type === "element" && child.tag === tag) return child;
+}
+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 findOfficeDrawing(pkg) {
+	const body = directChild(findRoot(pkg, CONTENT_PART_PATH), "office:body");
+	const drawing = body === void 0 ? void 0 : directChild(body, "office:drawing");
+	if (drawing === void 0) throw new Error(`${CONTENT_PART_PATH} has no office:body/office:drawing element`);
+	return drawing;
+}
+function findPageLayoutProperties(pkg) {
+	const pageLayout = directChild(findRoot(pkg, STYLES_PART_PATH), "office:automatic-styles")?.children.find((c) => c.type === "element" && c.tag === "style:page-layout" && (0, ooxml_js.attr)(c, "style:name") === "PM1");
+	const properties = pageLayout === void 0 ? void 0 : directChild(pageLayout, "style:page-layout-properties");
+	if (properties === void 0) throw new Error(`${STYLES_PART_PATH} has no style:page-layout[style:name="PM1"]/style:page-layout-properties element`);
+	return properties;
+}
+var OdgEditor = class {
+	pkg;
+	constructor(pkg) {
+		this.pkg = pkg;
+	}
+	pages() {
+		const drawing = findOfficeDrawing(this.pkg);
+		const out = [];
+		for (const child of drawing.children) if (child.type === "element" && child.tag === "draw:page") {
+			const context = { pkg: this.pkg };
+			out.push(new require_edit_odg_page.OdgPage(drawing.children, child, context));
+		}
+		return out;
+	}
+	addPage() {
+		const drawing = findOfficeDrawing(this.pkg);
+		const pageElement = require_xml_fragment.el("draw:page", { "draw:master-page-name": require_edit_odg_scaffold.MASTER_PAGE_NAME });
+		drawing.children.push(pageElement);
+		const context = { pkg: this.pkg };
+		return new require_edit_odg_page.OdgPage(drawing.children, pageElement, context);
+	}
+	removePageAt(index) {
+		const drawing = findOfficeDrawing(this.pkg);
+		const target = drawing.children.filter((c) => c.type === "element" && c.tag === "draw:page")[index];
+		if (target === void 0) throw new Error(`page index ${index} does not exist`);
+		const listIndex = drawing.children.indexOf(target);
+		drawing.children.splice(listIndex, 1);
+	}
+	get pageSize() {
+		const properties = findPageLayoutProperties(this.pkg);
+		const widthValue = (0, ooxml_js.attr)(properties, "fo:page-width");
+		const heightValue = (0, ooxml_js.attr)(properties, "fo:page-height");
+		const widthPt = widthValue === void 0 ? void 0 : (0, odf_js.parseOdfLength)(widthValue);
+		const heightPt = heightValue === void 0 ? void 0 : (0, odf_js.parseOdfLength)(heightValue);
+		return {
+			widthPt: widthPt ?? 0,
+			heightPt: heightPt ?? 0
+		};
+	}
+	set pageSize(size) {
+		const properties = findPageLayoutProperties(this.pkg);
+		properties.attributes = [{
+			name: "fo:page-width",
+			value: (0, odf_js.formatOdfLength)(size.widthPt)
+		}, {
+			name: "fo:page-height",
+			value: (0, odf_js.formatOdfLength)(size.heightPt)
+		}];
+	}
+	toPackage() {
+		return this.pkg;
+	}
+	toBytes() {
+		return (0, odf_js.encodePackage)(this.pkg);
+	}
+};
+function openOdg(bytes) {
+	return new OdgEditor((0, odf_js.decodePackage)(bytes));
+}
+function createOdg() {
+	return new OdgEditor(require_edit_odg_scaffold.createEmptyOdgPackage());
+}
+//#endregion
+exports.OdgEditor = OdgEditor;
+exports.createOdg = createOdg;
+exports.openOdg = openOdg;

package/dist/edit/odg/editor.d.cts

@@ -0,0 +1,19 @@
+import { s as PageSize } from "../../geometry-DvwdrIij.cjs";
+import { OdgPage } from "./page.cjs";
+import { Package } from "odf.js";
+//#region src/edit/odg/editor.d.ts
+declare class OdgEditor {
+  private readonly pkg;
+  constructor(pkg: Package);
+  pages(): OdgPage[];
+  addPage(): OdgPage;
+  removePageAt(index: number): void;
+  get pageSize(): PageSize;
+  set pageSize(size: PageSize);
+  toPackage(): Package;
+  toBytes(): Uint8Array<ArrayBuffer>;
+}
+declare function openOdg(bytes: Uint8Array<ArrayBuffer>): OdgEditor;
+declare function createOdg(): OdgEditor;
+//#endregion
+export { OdgEditor, createOdg, openOdg };

package/dist/edit/odg/editor.d.ts

@@ -0,0 +1,19 @@
+import { s as PageSize } from "../../geometry-DvwdrIij.js";
+import { OdgPage } from "./page.js";
+import { Package } from "odf.js";
+//#region src/edit/odg/editor.d.ts
+declare class OdgEditor {
+  private readonly pkg;
+  constructor(pkg: Package);
+  pages(): OdgPage[];
+  addPage(): OdgPage;
+  removePageAt(index: number): void;
+  get pageSize(): PageSize;
+  set pageSize(size: PageSize);
+  toPackage(): Package;
+  toBytes(): Uint8Array<ArrayBuffer>;
+}
+declare function openOdg(bytes: Uint8Array<ArrayBuffer>): OdgEditor;
+declare function createOdg(): OdgEditor;
+//#endregion
+export { OdgEditor, createOdg, openOdg };

package/dist/edit/odg/editor.js

@@ -0,0 +1,93 @@
+import { el } from "../../xml/fragment.js";
+import { MASTER_PAGE_NAME, createEmptyOdgPackage } from "./scaffold.js";
+import { OdgPage } from "./page.js";
+import { attr } from "ooxml.js";
+import { decodePackage as decodePackage$1, encodePackage as encodePackage$1, formatOdfLength, parseOdfLength } from "odf.js";
+//#region src/edit/odg/editor.ts
+const CONTENT_PART_PATH = "content.xml";
+const STYLES_PART_PATH = "styles.xml";
+function directChild(parent, tag) {
+	for (const child of parent.children) if (child.type === "element" && child.tag === tag) return child;
+}
+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 findOfficeDrawing(pkg) {
+	const body = directChild(findRoot(pkg, CONTENT_PART_PATH), "office:body");
+	const drawing = body === void 0 ? void 0 : directChild(body, "office:drawing");
+	if (drawing === void 0) throw new Error(`${CONTENT_PART_PATH} has no office:body/office:drawing element`);
+	return drawing;
+}
+function findPageLayoutProperties(pkg) {
+	const pageLayout = directChild(findRoot(pkg, STYLES_PART_PATH), "office:automatic-styles")?.children.find((c) => c.type === "element" && c.tag === "style:page-layout" && attr(c, "style:name") === "PM1");
+	const properties = pageLayout === void 0 ? void 0 : directChild(pageLayout, "style:page-layout-properties");
+	if (properties === void 0) throw new Error(`${STYLES_PART_PATH} has no style:page-layout[style:name="PM1"]/style:page-layout-properties element`);
+	return properties;
+}
+var OdgEditor = class {
+	pkg;
+	constructor(pkg) {
+		this.pkg = pkg;
+	}
+	pages() {
+		const drawing = findOfficeDrawing(this.pkg);
+		const out = [];
+		for (const child of drawing.children) if (child.type === "element" && child.tag === "draw:page") {
+			const context = { pkg: this.pkg };
+			out.push(new OdgPage(drawing.children, child, context));
+		}
+		return out;
+	}
+	addPage() {
+		const drawing = findOfficeDrawing(this.pkg);
+		const pageElement = el("draw:page", { "draw:master-page-name": MASTER_PAGE_NAME });
+		drawing.children.push(pageElement);
+		const context = { pkg: this.pkg };
+		return new OdgPage(drawing.children, pageElement, context);
+	}
+	removePageAt(index) {
+		const drawing = findOfficeDrawing(this.pkg);
+		const target = drawing.children.filter((c) => c.type === "element" && c.tag === "draw:page")[index];
+		if (target === void 0) throw new Error(`page index ${index} does not exist`);
+		const listIndex = drawing.children.indexOf(target);
+		drawing.children.splice(listIndex, 1);
+	}
+	get pageSize() {
+		const properties = findPageLayoutProperties(this.pkg);
+		const widthValue = attr(properties, "fo:page-width");
+		const heightValue = attr(properties, "fo:page-height");
+		const widthPt = widthValue === void 0 ? void 0 : parseOdfLength(widthValue);
+		const heightPt = heightValue === void 0 ? void 0 : parseOdfLength(heightValue);
+		return {
+			widthPt: widthPt ?? 0,
+			heightPt: heightPt ?? 0
+		};
+	}
+	set pageSize(size) {
+		const properties = findPageLayoutProperties(this.pkg);
+		properties.attributes = [{
+			name: "fo:page-width",
+			value: formatOdfLength(size.widthPt)
+		}, {
+			name: "fo:page-height",
+			value: formatOdfLength(size.heightPt)
+		}];
+	}
+	toPackage() {
+		return this.pkg;
+	}
+	toBytes() {
+		return encodePackage$1(this.pkg);
+	}
+};
+function openOdg(bytes) {
+	return new OdgEditor(decodePackage$1(bytes));
+}
+function createOdg() {
+	return new OdgEditor(createEmptyOdgPackage());
+}
+//#endregion
+export { OdgEditor, createOdg, openOdg };

package/dist/edit/odg/page.cjs

@@ -0,0 +1,70 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_xml_edit = require("../../xml/edit.cjs");
+const require_edit_odp_shape = require("../odp/shape.cjs");
+const require_edit_odp_image = require("../odp/image.cjs");
+const require_edit_odg_vector = require("./vector.cjs");
+//#region src/edit/odg/page.ts
+var OdgPage = class {
+	container;
+	node;
+	context;
+	removed = false;
+	constructor(container, node, context) {
+		this.container = container;
+		this.node = node;
+		this.context = context;
+	}
+	live() {
+		if (this.removed) throw new Error("this OdgPage has been removed from the drawing and can no longer be used");
+		return this.node;
+	}
+	shapes() {
+		const node = this.live();
+		const out = [];
+		for (const child of node.children) if (child.type === "element" && child.tag === "draw:frame") out.push(new require_edit_odp_shape.OdpShape(node.children, child, this.context.pkg));
+		return out;
+	}
+	addTextBox(init) {
+		const node = this.live();
+		const frameElement = require_edit_odp_shape.buildTextBoxFrame(this.context.pkg, init.frame, init.text);
+		node.children.push(frameElement);
+		return new require_edit_odp_shape.OdpShape(node.children, frameElement, this.context.pkg);
+	}
+	addImage(init) {
+		const node = this.live();
+		const media = { pkg: this.context.pkg };
+		const frameElement = require_edit_odp_image.insertImageFrameMedia(media, init.frame, init);
+		node.children.push(frameElement);
+		return new require_edit_odp_shape.OdpShape(node.children, frameElement, this.context.pkg);
+	}
+	addRect(init) {
+		const node = this.live();
+		const element = require_edit_odg_vector.buildRectElement(this.context.pkg, init);
+		node.children.push(element);
+		return new require_edit_odg_vector.OdgBoxVector(node.children, element, this.context.pkg);
+	}
+	addEllipse(init) {
+		const node = this.live();
+		const element = require_edit_odg_vector.buildEllipseElement(this.context.pkg, init);
+		node.children.push(element);
+		return new require_edit_odg_vector.OdgBoxVector(node.children, element, this.context.pkg);
+	}
+	addLine(init) {
+		const node = this.live();
+		const element = require_edit_odg_vector.buildLineElement(this.context.pkg, init);
+		node.children.push(element);
+		return new require_edit_odg_vector.OdgLineVector(node.children, element, this.context.pkg);
+	}
+	addPath(init) {
+		const node = this.live();
+		const element = require_edit_odg_vector.buildPathElement(this.context.pkg, init);
+		node.children.push(element);
+		return new require_edit_odg_vector.OdgPathVector(node.children, element, this.context.pkg);
+	}
+	remove() {
+		require_xml_edit.removeChild(this.container, this.live());
+		this.removed = true;
+	}
+};
+//#endregion
+exports.OdgPage = OdgPage;

package/dist/edit/odg/page.d.cts

@@ -0,0 +1,34 @@
+import { t as ImageInit } from "../../image-DWX6cNOD.cjs";
+import { t as OdpShape } from "../../shape-CN2ycxOo.cjs";
+import { a as OdgLineVector, n as LineVectorInit, o as OdgPathVector, r as OdgBoxVector, s as PathVectorInit, t as BoxVectorInit } from "../../vector-ClohqsOe.cjs";
+import { Box } from "document-schema.js";
+import { Package, XmlElement, XmlNode } from "odf.js";
+//#region src/edit/odg/page.d.ts
+interface TextBoxInit {
+  readonly frame: Box;
+  readonly text: string;
+}
+interface PageImageInit extends ImageInit {
+  readonly frame: Box;
+}
+interface PageContext {
+  readonly pkg: Package;
+}
+declare class OdgPage {
+  private readonly container;
+  private readonly node;
+  private readonly context;
+  private removed;
+  constructor(container: XmlNode[], node: XmlElement, context: PageContext);
+  private live;
+  shapes(): OdpShape[];
+  addTextBox(init: TextBoxInit): OdpShape;
+  addImage(init: PageImageInit): OdpShape;
+  addRect(init: BoxVectorInit): OdgBoxVector;
+  addEllipse(init: BoxVectorInit): OdgBoxVector;
+  addLine(init: LineVectorInit): OdgLineVector;
+  addPath(init: PathVectorInit): OdgPathVector;
+  remove(): void;
+}
+//#endregion
+export { OdgPage, PageContext, PageImageInit, TextBoxInit };

package/dist/edit/odg/page.d.ts

@@ -0,0 +1,34 @@
+import { t as ImageInit } from "../../image-CeqwL-Qs.js";
+import { t as OdpShape } from "../../shape-BfN3m52m.js";
+import { a as OdgLineVector, n as LineVectorInit, o as OdgPathVector, r as OdgBoxVector, s as PathVectorInit, t as BoxVectorInit } from "../../vector-ClohqsOe.js";
+import { Box } from "document-schema.js";
+import { Package, XmlElement, XmlNode } from "odf.js";
+//#region src/edit/odg/page.d.ts
+interface TextBoxInit {
+  readonly frame: Box;
+  readonly text: string;
+}
+interface PageImageInit extends ImageInit {
+  readonly frame: Box;
+}
+interface PageContext {
+  readonly pkg: Package;
+}
+declare class OdgPage {
+  private readonly container;
+  private readonly node;
+  private readonly context;
+  private removed;
+  constructor(container: XmlNode[], node: XmlElement, context: PageContext);
+  private live;
+  shapes(): OdpShape[];
+  addTextBox(init: TextBoxInit): OdpShape;
+  addImage(init: PageImageInit): OdpShape;
+  addRect(init: BoxVectorInit): OdgBoxVector;
+  addEllipse(init: BoxVectorInit): OdgBoxVector;
+  addLine(init: LineVectorInit): OdgLineVector;
+  addPath(init: PathVectorInit): OdgPathVector;
+  remove(): void;
+}
+//#endregion
+export { OdgPage, PageContext, PageImageInit, TextBoxInit };

package/dist/edit/odg/page.js

@@ -0,0 +1,69 @@
+import { removeChild } from "../../xml/edit.js";
+import { OdpShape, buildTextBoxFrame } from "../odp/shape.js";
+import { insertImageFrameMedia } from "../odp/image.js";
+import { OdgBoxVector, OdgLineVector, OdgPathVector, buildEllipseElement, buildLineElement, buildPathElement, buildRectElement } from "./vector.js";
+//#region src/edit/odg/page.ts
+var OdgPage = class {
+	container;
+	node;
+	context;
+	removed = false;
+	constructor(container, node, context) {
+		this.container = container;
+		this.node = node;
+		this.context = context;
+	}
+	live() {
+		if (this.removed) throw new Error("this OdgPage has been removed from the drawing and can no longer be used");
+		return this.node;
+	}
+	shapes() {
+		const node = this.live();
+		const out = [];
+		for (const child of node.children) if (child.type === "element" && child.tag === "draw:frame") out.push(new OdpShape(node.children, child, this.context.pkg));
+		return out;
+	}
+	addTextBox(init) {
+		const node = this.live();
+		const frameElement = buildTextBoxFrame(this.context.pkg, init.frame, init.text);
+		node.children.push(frameElement);
+		return new OdpShape(node.children, frameElement, this.context.pkg);
+	}
+	addImage(init) {
+		const node = this.live();
+		const media = { pkg: this.context.pkg };
+		const frameElement = insertImageFrameMedia(media, init.frame, init);
+		node.children.push(frameElement);
+		return new OdpShape(node.children, frameElement, this.context.pkg);
+	}
+	addRect(init) {
+		const node = this.live();
+		const element = buildRectElement(this.context.pkg, init);
+		node.children.push(element);
+		return new OdgBoxVector(node.children, element, this.context.pkg);
+	}
+	addEllipse(init) {
+		const node = this.live();
+		const element = buildEllipseElement(this.context.pkg, init);
+		node.children.push(element);
+		return new OdgBoxVector(node.children, element, this.context.pkg);
+	}
+	addLine(init) {
+		const node = this.live();
+		const element = buildLineElement(this.context.pkg, init);
+		node.children.push(element);
+		return new OdgLineVector(node.children, element, this.context.pkg);
+	}
+	addPath(init) {
+		const node = this.live();
+		const element = buildPathElement(this.context.pkg, init);
+		node.children.push(element);
+		return new OdgPathVector(node.children, element, this.context.pkg);
+	}
+	remove() {
+		removeChild(this.container, this.live());
+		this.removed = true;
+	}
+};
+//#endregion
+export { OdgPage };