odf.js 6.3.0 → 6.4.1

package/dist/typed/draw/shapes.cjs

@@ -1,6 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_util_base64 = require("../../util/base64.cjs");
 const require_image_sniff = require("../../image/sniff.cjs");
+const require_xml_entities = require("../../xml/entities.cjs");
 const require_typed_shared_units = require("../shared/units.cjs");
 const require_typed_shared_color = require("../shared/color.cjs");
 const require_xml_query = require("../../xml/query.cjs");
@@ -40,6 +41,10 @@ function readFrameInsets(frame, pkg) {
 	}
 	return insets;
 }
+function readDrawName(element) {
+	const raw = require_xml_query.attrValue(element, "draw:name");
+	return raw === void 0 ? void 0 : require_xml_entities.decodeXmlText(raw);
+}
 function readFrameAltText(frame) {
 	const title = require_xml_query.childrenWithTag(frame, "svg:title")[0];
 	const decodedTitle = title === void 0 ? void 0 : require_typed_shared_text.decodeOdfText(title);
@@ -97,7 +102,7 @@ function readDrawFrame(frame, groupFunctions, pkg, listIdState = { next: 1 }, fl
 	if (ownGeometry === void 0) return;
 	const geometry = require_typed_shared_transform.composeOdfGroupTransform(groupFunctions, ownGeometry);
 	return {
-		name: require_xml_query.attrValue(frame, "draw:name"),
+		name: readDrawName(frame),
 		frame: geometry.frame,
 		rotationDeg: geometry.rotationDeg,
 		...readFrameInsets(frame, pkg),
@@ -287,7 +292,7 @@ function readCustomShapeAsTextShape(element, groupFunctions, pkg) {
 	const geometry = require_typed_shared_transform.composeOdfGroupTransform(groupFunctions, ownGeometry);
 	const enhancedGeometry = require_xml_query.childrenWithTag(element, "draw:enhanced-geometry")[0];
 	return {
-		name: require_xml_query.attrValue(element, "draw:name"),
+		name: readDrawName(element),
 		frame: geometry.frame,
 		rotationDeg: geometry.rotationDeg,
 		...readFrameInsets(element, pkg),

package/dist/typed/draw/shapes.d.cts

@@ -1,2 +1,2 @@
-import { a as walkDrawShapes, i as readDrawPageContent, n as readDrawFrame, r as readDrawImageBlock, t as DrawPageContent } from "../../shapes-BQhXAk0D.cjs";
+import { a as walkDrawShapes, i as readDrawPageContent, n as readDrawFrame, r as readDrawImageBlock, t as DrawPageContent } from "../../shapes-CbBc9t0y.cjs";
 export { DrawPageContent, readDrawFrame, readDrawImageBlock, readDrawPageContent, walkDrawShapes };

package/dist/typed/draw/shapes.d.ts

@@ -1,2 +1,2 @@
-import { a as walkDrawShapes, i as readDrawPageContent, n as readDrawFrame, r as readDrawImageBlock, t as DrawPageContent } from "../../shapes-DUzrrf7b.js";
+import { a as walkDrawShapes, i as readDrawPageContent, n as readDrawFrame, r as readDrawImageBlock, t as DrawPageContent } from "../../shapes-B6Ms7ibr.js";
 export { DrawPageContent, readDrawFrame, readDrawImageBlock, readDrawPageContent, walkDrawShapes };

package/dist/typed/draw/shapes.js

@@ -1,5 +1,6 @@
 import { base64ToBytes } from "../../util/base64.js";
 import { sniffImageFormat } from "../../image/sniff.js";
+import { decodeXmlText } from "../../xml/entities.js";
 import { parseOdfLength } from "../shared/units.js";
 import { parseOdfColor } from "../shared/color.js";
 import { attrValue, childrenWithTag, elementsWithTag } from "../../xml/query.js";
@@ -39,6 +40,10 @@ function readFrameInsets(frame, pkg) {
 	}
 	return insets;
 }
+function readDrawName(element) {
+	const raw = attrValue(element, "draw:name");
+	return raw === void 0 ? void 0 : decodeXmlText(raw);
+}
 function readFrameAltText(frame) {
 	const title = childrenWithTag(frame, "svg:title")[0];
 	const decodedTitle = title === void 0 ? void 0 : decodeOdfText(title);
@@ -96,7 +101,7 @@ function readDrawFrame(frame, groupFunctions, pkg, listIdState = { next: 1 }, fl
 	if (ownGeometry === void 0) return;
 	const geometry = composeOdfGroupTransform(groupFunctions, ownGeometry);
 	return {
-		name: attrValue(frame, "draw:name"),
+		name: readDrawName(frame),
 		frame: geometry.frame,
 		rotationDeg: geometry.rotationDeg,
 		...readFrameInsets(frame, pkg),
@@ -286,7 +291,7 @@ function readCustomShapeAsTextShape(element, groupFunctions, pkg) {
 	const geometry = composeOdfGroupTransform(groupFunctions, ownGeometry);
 	const enhancedGeometry = childrenWithTag(element, "draw:enhanced-geometry")[0];
 	return {
-		name: attrValue(element, "draw:name"),
+		name: readDrawName(element),
 		frame: geometry.frame,
 		rotationDeg: geometry.rotationDeg,
 		...readFrameInsets(element, pkg),

package/dist/typed/draw/write-shapes.cjs

@@ -0,0 +1,211 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_xml_fragment = require("../../xml/fragment.cjs");
+const require_xml_entities = require("../../xml/entities.cjs");
+const require_typed_shared_units = require("../shared/units.cjs");
+const require_typed_shared_list = require("../shared/list.cjs");
+const require_typed_shared_paragraph = require("../shared/paragraph.cjs");
+const require_typed_shared_table = require("../shared/table.cjs");
+const require_typed_shared_image = require("../shared/image.cjs");
+const require_typed_shared_canonicalise = require("../shared/canonicalise.cjs");
+//#region src/typed/draw/write-shapes.ts
+function unsupportedShapeContent(what) {
+	return /* @__PURE__ */ new Error(`writeDrawFrame: a shape carries ${what}, which this writer does not write yet -- refusing rather than producing a document that silently lost it. See ExaDev/documents.js for the tracked follow-up covering the fidelity constructs.`);
+}
+function planShapeContent(blocks, listState) {
+	require_typed_shared_list.closeListPlan(listState);
+	if (blocks.length === 1) {
+		const only = blocks[0];
+		if (only.kind === "table") return {
+			kind: "table",
+			table: only
+		};
+		if (only.kind === "image") return {
+			kind: "image",
+			image: only
+		};
+	}
+	const paragraphs = [];
+	for (const block of blocks) {
+		if (block.kind === "table") throw unsupportedShapeContent("a table alongside other content (a draw:frame's own content is exactly one of table:table/draw:text-box/draw:image, never a mix)");
+		if (block.kind === "image") throw unsupportedShapeContent("an image alongside other content (same reason)");
+		if (block.kind === "pageBreak") throw unsupportedShapeContent("a page break (no ODF spelling inside a shape's own text)");
+		if (block.kind === "embeddedObject") throw unsupportedShapeContent("an embedded object");
+		if (block.kind === "constructStart" || block.kind === "constructEnd") throw unsupportedShapeContent("a construct boundary marker");
+		if (block.constructs !== void 0 && block.constructs.length > 0) throw unsupportedShapeContent("a run-level construct extent (a field, bookmark, note, annotation, or tracked change)");
+		if (block.headingLevel !== void 0) throw unsupportedShapeContent("a heading (a shape's own draw:text-box has no text:h reading path)");
+		const canonicalId = require_typed_shared_list.planListMembership(block.list, listState);
+		paragraphs.push(canonicalId === void 0 ? {
+			...block,
+			list: void 0
+		} : {
+			...block,
+			list: {
+				numId: canonicalId,
+				level: block.list.level
+			}
+		});
+	}
+	return {
+		kind: "text",
+		paragraphs
+	};
+}
+function createDrawShapeWriteState(pkg, registry, contentAutomaticStyles) {
+	return {
+		pkg,
+		registry,
+		contentAutomaticStyles,
+		nextImage: 1,
+		nextTable: 1,
+		nextListStyle: 1,
+		listStyleByKind: /* @__PURE__ */ new Map()
+	};
+}
+function listStyleNameFor(kind, state) {
+	const existing = state.listStyleByKind.get(kind);
+	if (existing !== void 0) return existing;
+	const name = `SL${state.nextListStyle}`;
+	state.nextListStyle += 1;
+	state.listStyleByKind.set(kind, name);
+	state.contentAutomaticStyles.children.push(require_typed_shared_list.buildOdfListStyle(name, kind));
+	return name;
+}
+function frameGeometryAttrs(frame, rotationDeg) {
+	if (rotationDeg === void 0 || rotationDeg === 0) return {
+		"svg:x": require_typed_shared_units.formatOdfLength(frame.xPt),
+		"svg:y": require_typed_shared_units.formatOdfLength(frame.yPt),
+		"svg:width": require_typed_shared_units.formatOdfLength(frame.widthPt),
+		"svg:height": require_typed_shared_units.formatOdfLength(frame.heightPt)
+	};
+	const angleRad = -rotationDeg * Math.PI / 180;
+	const cos = Math.cos(angleRad);
+	const sin = Math.sin(angleRad);
+	const halfWidthPt = frame.widthPt / 2;
+	const halfHeightPt = frame.heightPt / 2;
+	const txPt = frame.xPt + halfWidthPt - halfWidthPt * cos - halfHeightPt * sin;
+	const tyPt = frame.yPt + halfHeightPt - halfHeightPt * cos + halfWidthPt * sin;
+	return {
+		"svg:width": require_typed_shared_units.formatOdfLength(frame.widthPt),
+		"svg:height": require_typed_shared_units.formatOdfLength(frame.heightPt),
+		"draw:transform": `rotate(${require_typed_shared_units.formatOdfNumber(angleRad)}) translate(${require_typed_shared_units.formatOdfLength(txPt)} ${require_typed_shared_units.formatOdfLength(tyPt)})`
+	};
+}
+function shapeGraphicStyleName(shape, state) {
+	const properties = {
+		"draw:fill": "none",
+		"draw:stroke": "none"
+	};
+	if (shape.insetLeftPt !== 0 || shape.insetTopPt !== 0 || shape.insetRightPt !== 0 || shape.insetBottomPt !== 0) {
+		properties["fo:padding-left"] = require_typed_shared_units.formatOdfLength(shape.insetLeftPt);
+		properties["fo:padding-top"] = require_typed_shared_units.formatOdfLength(shape.insetTopPt);
+		properties["fo:padding-right"] = require_typed_shared_units.formatOdfLength(shape.insetRightPt);
+		properties["fo:padding-bottom"] = require_typed_shared_units.formatOdfLength(shape.insetBottomPt);
+	}
+	return state.registry.intern({
+		properties: {},
+		family: "graphic",
+		propertyElements: [require_xml_fragment.el("style:graphic-properties", properties)]
+	});
+}
+function writeShapeTextBox(paragraphs, state) {
+	const out = [];
+	let openList;
+	const closeList = () => {
+		if (openList === void 0) return;
+		const kind = require_typed_shared_list.listKindOf(openList.numId);
+		const built = require_typed_shared_list.writeOdfList(openList.entries, kind === void 0 ? void 0 : listStyleNameFor(kind, state));
+		openList.element.attributes = built.attributes;
+		openList.element.children = built.children;
+		openList = void 0;
+	};
+	for (const paragraph of paragraphs) {
+		const element = require_typed_shared_paragraph.writeOdfParagraph(paragraph, state.registry);
+		const membership = paragraph.list;
+		if (membership?.numId === void 0) {
+			closeList();
+			out.push(element);
+			continue;
+		}
+		if (openList !== void 0 && openList.numId !== membership.numId) closeList();
+		if (openList === void 0) {
+			const listElement = require_xml_fragment.el("text:list");
+			openList = {
+				numId: membership.numId,
+				entries: [],
+				element: listElement
+			};
+			out.push(listElement);
+		}
+		openList.entries.push({
+			level: membership.level,
+			element
+		});
+	}
+	closeList();
+	return require_xml_fragment.el("draw:text-box", {}, out);
+}
+const PICTURES_DIRECTORY = "Pictures";
+function writeShapeImage(image, state) {
+	const extension = require_typed_shared_image.imageExtension(image.format);
+	const path = `${PICTURES_DIRECTORY}/image${state.nextImage}.${extension}`;
+	state.nextImage += 1;
+	state.pkg.parts[path] = {
+		kind: "binary",
+		base64: image.base64
+	};
+	const children = [require_xml_fragment.el("draw:image", {
+		"xlink:href": require_xml_entities.encodeXmlText(path),
+		"xlink:type": "simple",
+		"xlink:show": "embed",
+		"xlink:actuate": "onLoad"
+	})];
+	if (image.altText !== void 0) children.push(require_xml_fragment.el("svg:title", {}, [require_xml_fragment.txt(require_xml_entities.encodeXmlText(image.altText))]));
+	return children;
+}
+function odfZIndexOf(paintOrder) {
+	if (paintOrder === void 0 || !Number.isSafeInteger(paintOrder) || paintOrder < 0) return;
+	return paintOrder;
+}
+function writeDrawFrame(shape, listState, state, documentIndex) {
+	const zIndex = odfZIndexOf(shape.paintOrder) ?? documentIndex;
+	const attributes = {
+		"draw:z-index": String(zIndex),
+		...frameGeometryAttrs(shape.frame, shape.rotationDeg)
+	};
+	if (shape.name !== void 0) attributes["draw:name"] = require_xml_entities.encodeXmlText(shape.name);
+	attributes["draw:style-name"] = require_xml_entities.encodeXmlText(shapeGraphicStyleName(shape, state));
+	const content = planShapeContent(shape.blocks, listState);
+	const children = content.kind === "table" ? [require_typed_shared_table.writeOdfTable(content.table, state.registry, `DrawTable${state.nextTable++}`)] : content.kind === "image" ? writeShapeImage(content.image, state) : [writeShapeTextBox(content.paragraphs, state)];
+	return require_xml_fragment.el("draw:frame", attributes, children);
+}
+function canonicalDrawShape(shape, documentIndex, listState) {
+	const content = planShapeContent(shape.blocks, listState);
+	const blocks = content.kind === "table" ? [require_typed_shared_canonicalise.canonicalTable(content.table)] : content.kind === "image" ? [{
+		...require_typed_shared_canonicalise.canonicalImage(content.image),
+		widthPt: shape.frame.widthPt,
+		heightPt: shape.frame.heightPt
+	}] : content.paragraphs.map((paragraph) => require_typed_shared_canonicalise.canonicalParagraph(paragraph, paragraph.list?.numId));
+	const canonical = {
+		frame: shape.frame,
+		insetLeftPt: shape.insetLeftPt,
+		insetTopPt: shape.insetTopPt,
+		insetRightPt: shape.insetRightPt,
+		insetBottomPt: shape.insetBottomPt,
+		paintOrder: odfZIndexOf(shape.paintOrder) ?? documentIndex,
+		blocks
+	};
+	if (shape.name !== void 0) canonical.name = shape.name;
+	if (shape.rotationDeg !== void 0 && shape.rotationDeg !== 0) canonical.rotationDeg = shape.rotationDeg;
+	return canonical;
+}
+function writeDrawShapes(shapes, listState, state) {
+	return shapes.map((shape, index) => writeDrawFrame(shape, listState, state, index));
+}
+//#endregion
+exports.canonicalDrawShape = canonicalDrawShape;
+exports.createDrawShapeWriteState = createDrawShapeWriteState;
+exports.frameGeometryAttrs = frameGeometryAttrs;
+exports.odfZIndexOf = odfZIndexOf;
+exports.planShapeContent = planShapeContent;
+exports.writeDrawFrame = writeDrawFrame;
+exports.writeDrawShapes = writeDrawShapes;

package/dist/typed/draw/write-shapes.d.cts

@@ -0,0 +1,2 @@
+import { a as frameGeometryAttrs, c as writeDrawFrame, i as createDrawShapeWriteState, l as writeDrawShapes, n as ShapeContentPlan, o as odfZIndexOf, r as canonicalDrawShape, s as planShapeContent, t as DrawShapeWriteState } from "../../write-shapes-D4piGKf4.cjs";
+export { DrawShapeWriteState, ShapeContentPlan, canonicalDrawShape, createDrawShapeWriteState, frameGeometryAttrs, odfZIndexOf, planShapeContent, writeDrawFrame, writeDrawShapes };

package/dist/typed/draw/write-shapes.d.ts

@@ -0,0 +1,2 @@
+import { a as frameGeometryAttrs, c as writeDrawFrame, i as createDrawShapeWriteState, l as writeDrawShapes, n as ShapeContentPlan, o as odfZIndexOf, r as canonicalDrawShape, s as planShapeContent, t as DrawShapeWriteState } from "../../write-shapes-Co7BrmMZ.js";
+export { DrawShapeWriteState, ShapeContentPlan, canonicalDrawShape, createDrawShapeWriteState, frameGeometryAttrs, odfZIndexOf, planShapeContent, writeDrawFrame, writeDrawShapes };

package/dist/typed/draw/write-shapes.js

@@ -0,0 +1,204 @@
+import { el, txt } from "../../xml/fragment.js";
+import { encodeXmlText } from "../../xml/entities.js";
+import { formatOdfLength, formatOdfNumber } from "../shared/units.js";
+import { buildOdfListStyle, closeListPlan, listKindOf, planListMembership, writeOdfList } from "../shared/list.js";
+import { writeOdfParagraph } from "../shared/paragraph.js";
+import { writeOdfTable } from "../shared/table.js";
+import { imageExtension } from "../shared/image.js";
+import { canonicalImage, canonicalParagraph, canonicalTable } from "../shared/canonicalise.js";
+//#region src/typed/draw/write-shapes.ts
+function unsupportedShapeContent(what) {
+	return /* @__PURE__ */ new Error(`writeDrawFrame: a shape carries ${what}, which this writer does not write yet -- refusing rather than producing a document that silently lost it. See ExaDev/documents.js for the tracked follow-up covering the fidelity constructs.`);
+}
+function planShapeContent(blocks, listState) {
+	closeListPlan(listState);
+	if (blocks.length === 1) {
+		const only = blocks[0];
+		if (only.kind === "table") return {
+			kind: "table",
+			table: only
+		};
+		if (only.kind === "image") return {
+			kind: "image",
+			image: only
+		};
+	}
+	const paragraphs = [];
+	for (const block of blocks) {
+		if (block.kind === "table") throw unsupportedShapeContent("a table alongside other content (a draw:frame's own content is exactly one of table:table/draw:text-box/draw:image, never a mix)");
+		if (block.kind === "image") throw unsupportedShapeContent("an image alongside other content (same reason)");
+		if (block.kind === "pageBreak") throw unsupportedShapeContent("a page break (no ODF spelling inside a shape's own text)");
+		if (block.kind === "embeddedObject") throw unsupportedShapeContent("an embedded object");
+		if (block.kind === "constructStart" || block.kind === "constructEnd") throw unsupportedShapeContent("a construct boundary marker");
+		if (block.constructs !== void 0 && block.constructs.length > 0) throw unsupportedShapeContent("a run-level construct extent (a field, bookmark, note, annotation, or tracked change)");
+		if (block.headingLevel !== void 0) throw unsupportedShapeContent("a heading (a shape's own draw:text-box has no text:h reading path)");
+		const canonicalId = planListMembership(block.list, listState);
+		paragraphs.push(canonicalId === void 0 ? {
+			...block,
+			list: void 0
+		} : {
+			...block,
+			list: {
+				numId: canonicalId,
+				level: block.list.level
+			}
+		});
+	}
+	return {
+		kind: "text",
+		paragraphs
+	};
+}
+function createDrawShapeWriteState(pkg, registry, contentAutomaticStyles) {
+	return {
+		pkg,
+		registry,
+		contentAutomaticStyles,
+		nextImage: 1,
+		nextTable: 1,
+		nextListStyle: 1,
+		listStyleByKind: /* @__PURE__ */ new Map()
+	};
+}
+function listStyleNameFor(kind, state) {
+	const existing = state.listStyleByKind.get(kind);
+	if (existing !== void 0) return existing;
+	const name = `SL${state.nextListStyle}`;
+	state.nextListStyle += 1;
+	state.listStyleByKind.set(kind, name);
+	state.contentAutomaticStyles.children.push(buildOdfListStyle(name, kind));
+	return name;
+}
+function frameGeometryAttrs(frame, rotationDeg) {
+	if (rotationDeg === void 0 || rotationDeg === 0) return {
+		"svg:x": formatOdfLength(frame.xPt),
+		"svg:y": formatOdfLength(frame.yPt),
+		"svg:width": formatOdfLength(frame.widthPt),
+		"svg:height": formatOdfLength(frame.heightPt)
+	};
+	const angleRad = -rotationDeg * Math.PI / 180;
+	const cos = Math.cos(angleRad);
+	const sin = Math.sin(angleRad);
+	const halfWidthPt = frame.widthPt / 2;
+	const halfHeightPt = frame.heightPt / 2;
+	const txPt = frame.xPt + halfWidthPt - halfWidthPt * cos - halfHeightPt * sin;
+	const tyPt = frame.yPt + halfHeightPt - halfHeightPt * cos + halfWidthPt * sin;
+	return {
+		"svg:width": formatOdfLength(frame.widthPt),
+		"svg:height": formatOdfLength(frame.heightPt),
+		"draw:transform": `rotate(${formatOdfNumber(angleRad)}) translate(${formatOdfLength(txPt)} ${formatOdfLength(tyPt)})`
+	};
+}
+function shapeGraphicStyleName(shape, state) {
+	const properties = {
+		"draw:fill": "none",
+		"draw:stroke": "none"
+	};
+	if (shape.insetLeftPt !== 0 || shape.insetTopPt !== 0 || shape.insetRightPt !== 0 || shape.insetBottomPt !== 0) {
+		properties["fo:padding-left"] = formatOdfLength(shape.insetLeftPt);
+		properties["fo:padding-top"] = formatOdfLength(shape.insetTopPt);
+		properties["fo:padding-right"] = formatOdfLength(shape.insetRightPt);
+		properties["fo:padding-bottom"] = formatOdfLength(shape.insetBottomPt);
+	}
+	return state.registry.intern({
+		properties: {},
+		family: "graphic",
+		propertyElements: [el("style:graphic-properties", properties)]
+	});
+}
+function writeShapeTextBox(paragraphs, state) {
+	const out = [];
+	let openList;
+	const closeList = () => {
+		if (openList === void 0) return;
+		const kind = listKindOf(openList.numId);
+		const built = writeOdfList(openList.entries, kind === void 0 ? void 0 : listStyleNameFor(kind, state));
+		openList.element.attributes = built.attributes;
+		openList.element.children = built.children;
+		openList = void 0;
+	};
+	for (const paragraph of paragraphs) {
+		const element = writeOdfParagraph(paragraph, state.registry);
+		const membership = paragraph.list;
+		if (membership?.numId === void 0) {
+			closeList();
+			out.push(element);
+			continue;
+		}
+		if (openList !== void 0 && openList.numId !== membership.numId) closeList();
+		if (openList === void 0) {
+			const listElement = el("text:list");
+			openList = {
+				numId: membership.numId,
+				entries: [],
+				element: listElement
+			};
+			out.push(listElement);
+		}
+		openList.entries.push({
+			level: membership.level,
+			element
+		});
+	}
+	closeList();
+	return el("draw:text-box", {}, out);
+}
+const PICTURES_DIRECTORY = "Pictures";
+function writeShapeImage(image, state) {
+	const extension = imageExtension(image.format);
+	const path = `${PICTURES_DIRECTORY}/image${state.nextImage}.${extension}`;
+	state.nextImage += 1;
+	state.pkg.parts[path] = {
+		kind: "binary",
+		base64: image.base64
+	};
+	const children = [el("draw:image", {
+		"xlink:href": encodeXmlText(path),
+		"xlink:type": "simple",
+		"xlink:show": "embed",
+		"xlink:actuate": "onLoad"
+	})];
+	if (image.altText !== void 0) children.push(el("svg:title", {}, [txt(encodeXmlText(image.altText))]));
+	return children;
+}
+function odfZIndexOf(paintOrder) {
+	if (paintOrder === void 0 || !Number.isSafeInteger(paintOrder) || paintOrder < 0) return;
+	return paintOrder;
+}
+function writeDrawFrame(shape, listState, state, documentIndex) {
+	const zIndex = odfZIndexOf(shape.paintOrder) ?? documentIndex;
+	const attributes = {
+		"draw:z-index": String(zIndex),
+		...frameGeometryAttrs(shape.frame, shape.rotationDeg)
+	};
+	if (shape.name !== void 0) attributes["draw:name"] = encodeXmlText(shape.name);
+	attributes["draw:style-name"] = encodeXmlText(shapeGraphicStyleName(shape, state));
+	const content = planShapeContent(shape.blocks, listState);
+	const children = content.kind === "table" ? [writeOdfTable(content.table, state.registry, `DrawTable${state.nextTable++}`)] : content.kind === "image" ? writeShapeImage(content.image, state) : [writeShapeTextBox(content.paragraphs, state)];
+	return el("draw:frame", attributes, children);
+}
+function canonicalDrawShape(shape, documentIndex, listState) {
+	const content = planShapeContent(shape.blocks, listState);
+	const blocks = content.kind === "table" ? [canonicalTable(content.table)] : content.kind === "image" ? [{
+		...canonicalImage(content.image),
+		widthPt: shape.frame.widthPt,
+		heightPt: shape.frame.heightPt
+	}] : content.paragraphs.map((paragraph) => canonicalParagraph(paragraph, paragraph.list?.numId));
+	const canonical = {
+		frame: shape.frame,
+		insetLeftPt: shape.insetLeftPt,
+		insetTopPt: shape.insetTopPt,
+		insetRightPt: shape.insetRightPt,
+		insetBottomPt: shape.insetBottomPt,
+		paintOrder: odfZIndexOf(shape.paintOrder) ?? documentIndex,
+		blocks
+	};
+	if (shape.name !== void 0) canonical.name = shape.name;
+	if (shape.rotationDeg !== void 0 && shape.rotationDeg !== 0) canonical.rotationDeg = shape.rotationDeg;
+	return canonical;
+}
+function writeDrawShapes(shapes, listState, state) {
+	return shapes.map((shape, index) => writeDrawFrame(shape, listState, state, index));
+}
+//#endregion
+export { canonicalDrawShape, createDrawShapeWriteState, frameGeometryAttrs, odfZIndexOf, planShapeContent, writeDrawFrame, writeDrawShapes };

package/dist/typed/draw/write-vectors.cjs

@@ -0,0 +1,132 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_xml_fragment = require("../../xml/fragment.cjs");
+const require_xml_entities = require("../../xml/entities.cjs");
+const require_typed_shared_units = require("../shared/units.cjs");
+const require_typed_shared_color = require("../shared/color.cjs");
+const require_typed_shared_path = require("../shared/path.cjs");
+const require_typed_shared_canonicalise = require("../shared/canonicalise.cjs");
+const require_typed_draw_write_shapes = require("./write-shapes.cjs");
+//#region src/typed/draw/write-vectors.ts
+function unsupportedVector(what) {
+	return /* @__PURE__ */ new Error(`writeDrawVector: a vector carries ${what}, which ODF has no spelling for -- refusing rather than producing a document that silently lost it or renders differently. See ExaDev/documents.js for the tracked follow-up.`);
+}
+function odfStrokeMode(style) {
+	if (style === void 0 || style === "solid") return "solid";
+	if (style === "dashed") return "dash";
+	throw unsupportedVector(`a '${style}' stroke style (draw:stroke is enumerated to exactly none/solid/dash -- ODF's vector-stroke model has no dotted or double spelling)`);
+}
+function vectorGraphicStyleName(paint, state) {
+	const properties = {};
+	if (paint.fill === void 0) properties["draw:fill"] = "none";
+	else {
+		properties["draw:fill"] = "solid";
+		properties["draw:fill-color"] = require_typed_shared_color.formatOdfColor(paint.fill);
+	}
+	if (paint.fillRule !== void 0) properties["svg:fill-rule"] = paint.fillRule;
+	if (paint.stroke === void 0) properties["draw:stroke"] = "none";
+	else {
+		if (!(paint.stroke.widthPt > 0)) throw unsupportedVector(`a stroke of width ${paint.stroke.widthPt}pt (svg:stroke-width must be positive for a stroke to exist at all)`);
+		properties["draw:stroke"] = odfStrokeMode(paint.stroke.style);
+		properties["svg:stroke-color"] = require_typed_shared_color.formatOdfColor(paint.stroke.color);
+		properties["svg:stroke-width"] = require_typed_shared_units.formatOdfLength(paint.stroke.widthPt);
+	}
+	return state.registry.intern({
+		properties: {},
+		family: "graphic",
+		propertyElements: [require_xml_fragment.el("style:graphic-properties", properties)]
+	});
+}
+function zIndexAttrs(paintOrder, documentIndex) {
+	const zIndex = require_typed_draw_write_shapes.odfZIndexOf(paintOrder) ?? documentIndex;
+	return { "draw:z-index": String(zIndex) };
+}
+function writeDrawVector(vector, state, documentIndex) {
+	if (vector.kind === "line") {
+		const styleName = vectorGraphicStyleName({
+			fill: void 0,
+			fillRule: void 0,
+			stroke: vector.stroke
+		}, state);
+		return require_xml_fragment.el("draw:line", {
+			...zIndexAttrs(vector.paintOrder, documentIndex),
+			"svg:x1": require_typed_shared_units.formatOdfLength(vector.from.xPt),
+			"svg:y1": require_typed_shared_units.formatOdfLength(vector.from.yPt),
+			"svg:x2": require_typed_shared_units.formatOdfLength(vector.to.xPt),
+			"svg:y2": require_typed_shared_units.formatOdfLength(vector.to.yPt),
+			"draw:style-name": require_xml_entities.encodeXmlText(styleName)
+		});
+	}
+	if (vector.kind === "path") {
+		if (vector.subpaths.length === 0) throw unsupportedVector("no subpaths at all (an empty svg:d reads back as an element with no resolvable geometry, so the whole vector would vanish)");
+		if (!(vector.frame.widthPt > 0) || !(vector.frame.heightPt > 0)) throw unsupportedVector(`a frame of ${vector.frame.widthPt}pt x ${vector.frame.heightPt}pt (a path's svg:viewBox states the extent its own coordinates are scaled against, which cannot be zero or negative)`);
+		const styleName = vectorGraphicStyleName({
+			fill: vector.fill,
+			fillRule: vector.fillRule,
+			stroke: vector.stroke
+		}, state);
+		return require_xml_fragment.el("draw:path", {
+			...zIndexAttrs(vector.paintOrder, documentIndex),
+			...require_typed_draw_write_shapes.frameGeometryAttrs(vector.frame, vector.rotationDeg),
+			"svg:viewBox": require_typed_shared_path.formatOdfViewBox(vector.frame),
+			"svg:d": require_typed_shared_path.formatOdfPathData(vector.subpaths),
+			"draw:style-name": require_xml_entities.encodeXmlText(styleName)
+		});
+	}
+	const styleName = vectorGraphicStyleName({
+		fill: vector.fill,
+		fillRule: void 0,
+		stroke: vector.stroke
+	}, state);
+	return require_xml_fragment.el(vector.kind === "rect" ? "draw:rect" : "draw:ellipse", {
+		...zIndexAttrs(vector.paintOrder, documentIndex),
+		...require_typed_draw_write_shapes.frameGeometryAttrs(vector.frame, vector.rotationDeg),
+		"draw:style-name": require_xml_entities.encodeXmlText(styleName)
+	});
+}
+function writeDrawVectors(vectors, state, baseIndex) {
+	return vectors.map((vector, index) => writeDrawVector(vector, state, baseIndex + index));
+}
+function canonicalDrawVector(vector, documentIndex) {
+	const paintOrder = require_typed_draw_write_shapes.odfZIndexOf(vector.paintOrder) ?? documentIndex;
+	if (vector.kind === "line") return {
+		kind: "line",
+		from: vector.from,
+		to: vector.to,
+		stroke: canonicalStroke(vector.stroke),
+		paintOrder
+	};
+	const paint = {
+		...vector.rotationDeg !== void 0 && vector.rotationDeg !== 0 ? { rotationDeg: vector.rotationDeg } : {},
+		...vector.fill !== void 0 ? { fill: require_typed_shared_canonicalise.canonicalColor(vector.fill) } : {},
+		...vector.stroke !== void 0 ? { stroke: canonicalStroke(vector.stroke) } : {}
+	};
+	if (vector.kind === "path") return {
+		kind: "path",
+		frame: vector.frame,
+		subpaths: vector.subpaths.map((subpath) => ({
+			start: subpath.start,
+			segments: [...subpath.segments],
+			closed: subpath.closed
+		})),
+		...vector.fillRule !== void 0 ? { fillRule: vector.fillRule } : {},
+		...paint,
+		paintOrder
+	};
+	return {
+		kind: vector.kind,
+		frame: vector.frame,
+		...paint,
+		paintOrder
+	};
+}
+function canonicalStroke(stroke) {
+	return {
+		color: require_typed_shared_canonicalise.canonicalColor(stroke.color),
+		widthPt: stroke.widthPt,
+		style: stroke.style ?? "solid"
+	};
+}
+//#endregion
+exports.canonicalDrawVector = canonicalDrawVector;
+exports.writeDrawVector = writeDrawVector;
+exports.writeDrawVectors = writeDrawVectors;

package/dist/typed/draw/write-vectors.d.cts

@@ -0,0 +1,2 @@
+import { n as writeDrawVector, r as writeDrawVectors, t as canonicalDrawVector } from "../../write-vectors-B-RVHAKI.cjs";
+export { canonicalDrawVector, writeDrawVector, writeDrawVectors };

package/dist/typed/draw/write-vectors.d.ts

@@ -0,0 +1,2 @@
+import { n as writeDrawVector, r as writeDrawVectors, t as canonicalDrawVector } from "../../write-vectors-CYjZoVBW.js";
+export { canonicalDrawVector, writeDrawVector, writeDrawVectors };