office-open 0.12.2 → 0.13.0

package/README.md

@@ -9,7 +9,7 @@
 ## Features
 
 - **One Install** — Import from `office-open/docx`, `office-open/pptx`, `office-open/xlsx`; no Microsoft Office required
-- **AI SDK Tools** — Vercel AI SDK compatible tools for `generate-docx`, `generate-pptx`, `generate-xlsx`, ready for AI agents and chatbots
+- **AI SDK Tools** — Vercel AI SDK compatible tools for `generate-docx`, `generate-pptx`, `generate-xlsx`, with schema-validated retries
 - **JSON Schemas** — Draft-07 input validation for all document types, with on-demand schema slicing for LLM context budgets
 - **CLI** — Generate files from JSON via `npx office-open`
 - **Generate Function** — Type-agnostic `generate()` for dynamic document creation
@@ -58,7 +58,7 @@ npx office-open docx document.json "output.docx"
 npx office-open pptx slides.json "output.pptx"
 npx office-open xlsx spreadsheet.json "output.xlsx"
 
-# Consult the JSON schemas (for AI agents and humans)
+# Inspect the option schemas on demand
 npx office-open schema index docx                        # indexed lookup entries by domain
 npx office-open schema index docx --all                   # every definition name
 npx office-open schema slice docx ParagraphOptions RunOptions   # sub-schema for those types
@@ -155,6 +155,21 @@ import { parse, stringify } from "office-open/xml";
 }
 ```
 
+## Documentation
+
+- [Documentation](https://www.office-open.com) — getting started, per-format guides, and AI integration
+- [AI Integration Guide](https://www.office-open.com/en/getting-started/ai-integration) — MCP server, Agent Skill, and schema slicing
+- [Changelog](https://github.com/DemoMacro/office-open/releases) — release notes
+- [Report Issues](https://github.com/DemoMacro/office-open/issues) — bug reports and feature requests
+
+## Related Packages
+
+- [@office-open/docx](https://www.npmjs.com/package/@office-open/docx) — Word (.docx)
+- [@office-open/pptx](https://www.npmjs.com/package/@office-open/pptx) — PowerPoint (.pptx)
+- [@office-open/xlsx](https://www.npmjs.com/package/@office-open/xlsx) — Excel (.xlsx)
+- [@office-open/core](https://www.npmjs.com/package/@office-open/core) — shared OOXML infrastructure
+- [@office-open/xml](https://www.npmjs.com/package/@office-open/xml) — XML parsing and serialization
+
 ## License
 
-MIT
+- [MIT](https://github.com/DemoMacro/office-open/blob/main/LICENSE) © [Demo Macro](https://www.demomacro.com/)

package/dist/ai/index.mjs

@@ -1,5 +1,5 @@
 import { generate } from "../generate.mjs";
-import { a as sliceDocumentSchema, g as validateDocumentInput, n as getSkeletonSchema, r as UnknownDefinitionError, t as renderSliceTypeText } from "../schemas-B400scMm.mjs";
+import { a as sliceDocumentSchema, g as validateDocumentInput, n as getSkeletonSchema, r as UnknownDefinitionError, t as renderSliceTypeText } from "../schemas-LxuRToZl.mjs";
 import { lintWorkbookFormulas } from "@office-open/xlsx";
 import { PART_REGISTRIES, encodeBase64, unzipSync, validateOpcConsistency } from "@office-open/core";
 import { jsonSchema, tool } from "ai";

package/dist/cli.mjs

@@ -1,5 +1,5 @@
 import { generateToFile, parseInput } from "./generate.mjs";
-import { a as sliceDocumentSchema, g as validateDocumentInput, p as SCHEMAS, r as UnknownDefinitionError, t as renderSliceTypeText, u as SCHEMA_ENTRIES } from "./schemas-B400scMm.mjs";
+import { a as sliceDocumentSchema, g as validateDocumentInput, p as SCHEMAS, r as UnknownDefinitionError, t as renderSliceTypeText, u as SCHEMA_ENTRIES } from "./schemas-LxuRToZl.mjs";
 import { defineCommand, runMain } from "citty";
 //#region src/cli.ts
 const FORMATS = [

package/dist/convert/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/convert/picture.ts","../../src/convert/shape.ts","../../src/convert/position.ts","../../src/convert/connector.ts","../../src/convert/group.ts","../../src/convert/table.ts","../../src/convert/smartart.ts","../../src/convert/text.ts"],"mappings":";;;;;;iBAuHgB,cAAc,QAAQ,mBAAqB;iBAE3C,cAAc,QAAQ,mBAAqB;iBAuC3C,cAAc,QAAQ,iBAAqB;iBAE3C,cAAc,QAAQ,mBAAqB;iBAmC3C,cAAc,QAAQ,iBAAqB;iBAE3C,cAAc,QAAQ,mBAAqB;;;KClJ/C,mBAAmB;UAGd;EAEf,OAAO;EACP,UAAU;EACV,UAAU;EACV,YAAY;EACZ,UAAU;EACV,UAAU;;KAIP,gBAAgB,KAAK;EAA0B,OAAO;;iBAG3C,YAAY,UAAU,cAAc,QAAQ,IAAI;iBAehD,iBACd,GAAG,YAAY,oCACd;iBAQa,uBAAuB,UAAU,kBAAkB;iBAWnD,eACd,UAAU,iCACV,gBAAgB,oCACf;UAoCc;EACf,MAAM;EACN,gBAAgB;;iBA8BF,iBAAiB,QAAQ,iBAAmB,iBAAmB;iBA+C/D,YAAY,QAAQ,iBAAmB;iBAEvC,YAAY,QAAQ,iBAAmB;iBASvC,YAAY,QAAQ,mBAAmB;iBAEvC,YAAY,QAAQ,iBAAmB;iBA2CvC,YAAY,QAAQ,mBAAmB;iBAEvC,YAAY,QAAQ,iBAAmB;;;UCvPtC;EACf;EACA;EACA;EACA;EACA;EACA;EACA;;;;iBCdc,eACd,aAAa,8BACb,aAAa,8BACb,aAAa,8BACb,aAAa,+BACZ;iBAgBa,eAAe,KAAK;EAClC;EACA;EACA;EACA;;iBAiBc,gBAAgB,SAAS,mBAAuB;iBAQhD,gBAAgB,QAAQ,qBAAuB;iBA0B/C,gBAAgB,QAAQ,mBAAuB;;;iBCwG/C,YAAY,QAAQ,iBAAmB;iBAEvC,YAAY,QAAQ,iBAAmB;iBAsEvC,YAAY,QAAQ,eAAmB;iBAEvC,YAAY,QAAQ,iBAAmB;iBAgEvC,YAAY,QAAQ,eAAmB;iBAEvC,YAAY,QAAQ,iBAAmB;;;UCzRtC;EACf,MAAM;EACN,aAAa;EACb,UAAU;;iBAyMI,YAAY,QAAQ,iBAAmB;iBAEvC,YAAY,QAAQ,kBAAkB;iBA+EtC,YAAY,QAAQ,eAAmB;iBAEvC,YAAY,QAAQ,kBAAkB;iBA6DtC,YAAY,QAAQ,eAAmB;iBAEvC,YAAY,QAAQ,iBAAmB;;;iBClWvC,eAAe,QAAQ,oBAAe;iBAqBtC,eAAe,QAAQ,kBAAe;;;iBC2BtC,qBAAqB,SAAS,6BAA6B;iBA2H3D,mBAAmB,MAAM,mBAAmB"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/convert/picture.ts","../../src/convert/shape.ts","../../src/convert/position.ts","../../src/convert/connector.ts","../../src/convert/group.ts","../../src/convert/table.ts","../../src/convert/smartart.ts","../../src/convert/text.ts"],"mappings":";;;;;;iBAuHgB,cAAc,QAAQ,mBAAqB;iBAE3C,cAAc,QAAQ,mBAAqB;iBAuC3C,cAAc,QAAQ,iBAAqB;iBAE3C,cAAc,QAAQ,mBAAqB;iBAmC3C,cAAc,QAAQ,iBAAqB;iBAE3C,cAAc,QAAQ,mBAAqB;;;KClJ/C,mBAAmB;UAGd;EAEf,OAAO;EACP,UAAU;EACV,UAAU;EACV,YAAY;EACZ,UAAU;EACV,UAAU;;KAIP,gBAAgB,KAAK;EAA0B,OAAO;;iBAG3C,YAAY,UAAU,cAAc,QAAQ,IAAI;iBAehD,iBACd,GAAG,YAAY,oCACd;iBAQa,uBAAuB,UAAU,kBAAkB;iBAWnD,eACd,UAAU,iCACV,gBAAgB,oCACf;UAoCc;EACf,MAAM;EACN,gBAAgB;;iBA8BF,iBAAiB,QAAQ,iBAAmB,iBAAmB;iBAgD/D,YAAY,QAAQ,iBAAmB;iBAEvC,YAAY,QAAQ,iBAAmB;iBASvC,YAAY,QAAQ,mBAAmB;iBAEvC,YAAY,QAAQ,iBAAmB;iBA+CvC,YAAY,QAAQ,mBAAmB;iBAEvC,YAAY,QAAQ,iBAAmB;;;UC5PtC;EACf;EACA;EACA;EACA;EACA;EACA;EACA;;;;iBCdc,eACd,aAAa,8BACb,aAAa,8BACb,aAAa,8BACb,aAAa,+BACZ;iBAgBa,eAAe,KAAK;EAClC;EACA;EACA;EACA;;iBAiBc,gBAAgB,SAAS,mBAAuB;iBAQhD,gBAAgB,QAAQ,qBAAuB;iBAyB/C,gBAAgB,QAAQ,mBAAuB;;;iBC6G/C,YAAY,QAAQ,iBAAmB;iBAEvC,YAAY,QAAQ,iBAAmB;iBAsEvC,YAAY,QAAQ,eAAmB;iBAEvC,YAAY,QAAQ,iBAAmB;iBAgEvC,YAAY,QAAQ,eAAmB;iBAEvC,YAAY,QAAQ,iBAAmB;;;UC7RtC;EACf,MAAM;EACN,aAAa;EACb,UAAU;;iBAyMI,YAAY,QAAQ,iBAAmB;iBAEvC,YAAY,QAAQ,kBAAkB;iBA+EtC,YAAY,QAAQ,eAAmB;iBAEvC,YAAY,QAAQ,kBAAkB;iBA6DtC,YAAY,QAAQ,eAAmB;iBAEvC,YAAY,QAAQ,iBAAmB;;;iBClWvC,eAAe,QAAQ,oBAAe;iBAqBtC,eAAe,QAAQ,kBAAe;;;iBC2BtC,qBAAqB,SAAS,6BAA6B;iBA2H3D,mBAAmB,MAAM,mBAAmB"}

package/dist/convert/index.mjs

@@ -77,8 +77,8 @@ function boxFromDocx(transformation) {
 		width: toEmu(transformation.width),
 		height: toEmu(transformation.height),
 		...transformation.rotation !== void 0 ? { rotation: transformation.rotation } : {},
-		...transformation.flip?.horizontal ? { flipHorizontal: true } : {},
-		...transformation.flip?.vertical ? { flipVertical: true } : {}
+		...transformation.flipHorizontal ? { flipHorizontal: true } : {},
+		...transformation.flipVertical ? { flipVertical: true } : {}
 	};
 }
 /** Emit pptx top-level position fields from a box. */
@@ -125,10 +125,8 @@ function boxToDocx(box) {
 		width: box.width,
 		height: box.height,
 		...box.rotation !== void 0 ? { rotation: box.rotation } : {},
-		...box.flipHorizontal || box.flipVertical ? { flip: {
-			...box.flipHorizontal ? { horizontal: true } : {},
-			...box.flipVertical ? { vertical: true } : {}
-		} } : {}
+		...box.flipHorizontal ? { flipHorizontal: true } : {},
+		...box.flipVertical ? { flipVertical: true } : {}
 	};
 }
 //#endregion
@@ -766,7 +764,7 @@ function isRunChild(child) {
 *
 * docx shapes carry text as w:p paragraphs; pptx/xlsx carry it as a core
 * TextBody (a:p). bodyProperties (a:bodyPr) round-trips verbatim. Geometry
-* adapts to docx's stricter API (presetGeometry rejects the bare-string
+* adapts to docx's stricter API (geometry rejects the bare-string
 * shorthand pptx/xlsx accept).
 *
 * @module
@@ -829,8 +827,8 @@ const hasCnvPr$1 = (source) => {
 * full MediaDataTransformation; the caller runs it through createTransformation).
 */
 function toDocxShapeParts(source) {
-	if ("spPr" in source) {
-		const spPr = source.spPr;
+	if ("col" in source) {
+		const spPr = source.properties;
 		const box = boxFromXlsxAnchor(source, spPr.width, spPr.height, spPr.rotation, spPr.flipHorizontal, spPr.flipVertical);
 		const preset = toPresetGeometry(spPr.geometry);
 		return {
@@ -838,20 +836,21 @@ function toDocxShapeParts(source) {
 				children: source.textBody ? textBodyToDocxChildren(source.textBody) : [],
 				...pickContent(spPr),
 				...spPr.customGeometry !== void 0 ? { customGeometry: spPr.customGeometry } : {},
-				...preset !== void 0 ? { presetGeometry: preset } : {},
+				...preset !== void 0 ? { geometry: preset } : {},
 				...hasCnvPr$1(source) ? docxNonVisual(source) : {}
 			},
 			transformation: boxToDocx(box)
 		};
 	}
+	const spPr = source.properties ?? {};
 	const box = boxFromPptx(source.x, source.y, source.width, source.height, source.rotation, source.flipHorizontal);
-	const preset = toPresetGeometry(source.geometry);
+	const preset = toPresetGeometry(spPr.geometry);
 	return {
 		data: {
 			children: source.textBody ? textBodyToDocxChildren(source.textBody) : [],
-			...pickContent(source),
-			...source.customGeometry !== void 0 ? { customGeometry: source.customGeometry } : {},
-			...preset !== void 0 ? { presetGeometry: preset } : {},
+			...pickContent(spPr),
+			...spPr.customGeometry !== void 0 ? { customGeometry: spPr.customGeometry } : {},
+			...preset !== void 0 ? { geometry: preset } : {},
 			...hasCnvPr$1(source) ? docxNonVisual(source) : {}
 		},
 		transformation: boxToDocx(box)
@@ -865,13 +864,15 @@ function toDocxShape(source) {
 	};
 }
 function toPptxShape(source) {
-	if ("spPr" in source) {
-		const spPr = source.spPr;
+	if ("col" in source) {
+		const spPr = source.properties;
 		return {
 			...boxToPptx(boxFromXlsxAnchor(source, spPr.width, spPr.height, spPr.rotation, spPr.flipHorizontal, spPr.flipVertical)),
-			...pickContent(spPr),
-			...spPr.geometry !== void 0 ? { geometry: spPr.geometry } : {},
-			...spPr.customGeometry !== void 0 ? { customGeometry: spPr.customGeometry } : {},
+			properties: {
+				...pickContent(spPr),
+				...spPr.geometry !== void 0 ? { geometry: spPr.geometry } : {},
+				...spPr.customGeometry !== void 0 ? { customGeometry: spPr.customGeometry } : {}
+			},
 			...source.textBody ? { textBody: source.textBody } : {},
 			...pickNonVisualDrawingProperties(source)
 		};
@@ -880,8 +881,10 @@ function toPptxShape(source) {
 	const textBody = docxToTextBody(source.children, source.bodyProperties);
 	return {
 		...boxToPptx(box),
-		...pickContent(source),
-		...source.presetGeometry !== void 0 ? { geometry: source.presetGeometry } : source.customGeometry !== void 0 ? { customGeometry: source.customGeometry } : {},
+		properties: {
+			...pickContent(source),
+			...source.geometry !== void 0 ? { geometry: source.geometry } : source.customGeometry !== void 0 ? { customGeometry: source.customGeometry } : {}
+		},
 		...textBody ? { textBody } : {},
 		...pickNonVisualDrawingProperties(source.nonVisualProperties)
 	};
@@ -897,18 +900,19 @@ function toXlsxShape(source) {
 			width: box.width,
 			height: box.height,
 			...pickContent(source),
-			...source.presetGeometry !== void 0 ? { geometry: source.presetGeometry } : source.customGeometry !== void 0 ? { customGeometry: source.customGeometry } : {},
+			...source.geometry !== void 0 ? { geometry: source.geometry } : source.customGeometry !== void 0 ? { customGeometry: source.customGeometry } : {},
 			...box.rotation !== void 0 ? { rotation: box.rotation } : {},
 			...box.flipHorizontal ? { flipHorizontal: true } : {},
 			...box.flipVertical ? { flipVertical: true } : {}
 		};
 		return {
 			...pos.anchor,
-			spPr,
+			properties: spPr,
 			...textBody ? { textBody } : {},
 			...pickNonVisualDrawingProperties(source.nonVisualProperties)
 		};
 	}
+	const paint = source.properties ?? {};
 	const box = boxFromPptx(source.x, source.y, source.width, source.height, source.rotation, source.flipHorizontal);
 	const pos = boxToXlsx(box);
 	const spPr = {
@@ -916,15 +920,15 @@ function toXlsxShape(source) {
 		y: pos.xfrmY,
 		width: box.width,
 		height: box.height,
-		...pickContent(source),
-		...source.geometry !== void 0 ? { geometry: source.geometry } : {},
-		...source.customGeometry !== void 0 ? { customGeometry: source.customGeometry } : {},
+		...pickContent(paint),
+		...paint.geometry !== void 0 ? { geometry: paint.geometry } : {},
+		...paint.customGeometry !== void 0 ? { customGeometry: paint.customGeometry } : {},
 		...box.rotation !== void 0 ? { rotation: box.rotation } : {},
 		...box.flipHorizontal ? { flipHorizontal: true } : {}
 	};
 	return {
 		...pos.anchor,
-		spPr,
+		properties: spPr,
 		...source.textBody ? { textBody: source.textBody } : {},
 		...pickNonVisualDrawingProperties(source)
 	};
@@ -940,8 +944,7 @@ function toXlsxShape(source) {
 * fields (cNvPr name/description/title/hidden + locking + endpoint connections)
 * pass straight through via pickConnectorBase; only positioning (pptx two
 * endpoints ↔ xlsx cell-anchor bounding box, with flip flags encoding draw
-* direction) and the line fill/outline (pptx top-level convenience ↔ xlsx
-* nested in spPr) are adapted per leg.
+* direction) is adapted per leg — paint travels in `properties` on both sides.
 *
 * docx has no standalone connector element (Word embeds connectors as wps
 * shapes flagged with a connector marker), so converting a connector to docx
@@ -983,15 +986,14 @@ function toDocxConnector(_source) {
 }
 /** Convert an xlsx connector to a pptx connector. */
 function toPptxConnector(source) {
-	const spPr = source.spPr;
+	const spPr = source.properties;
 	const { x1, y1, x2, y2 } = boxToEndpoints(boxFromXlsxAnchor(source, spPr.width, spPr.height, spPr.rotation, spPr.flipHorizontal, spPr.flipVertical));
 	return {
 		x1,
 		y1,
 		x2,
 		y2,
-		...spPr.outline !== void 0 ? { outline: spPr.outline } : {},
-		...spPr.fill !== void 0 ? { fill: spPr.fill } : {},
+		properties: pickContent(spPr),
 		...pickConnectorBase(source)
 	};
 }
@@ -1005,14 +1007,13 @@ function toXlsxConnector(source) {
 		width: box.width,
 		height: box.height,
 		geometry: "line",
-		...source.outline !== void 0 ? { outline: source.outline } : {},
-		...source.fill !== void 0 ? { fill: source.fill } : {},
+		...pickContent(source.properties ?? {}),
 		...box.flipHorizontal ? { flipHorizontal: true } : {},
 		...box.flipVertical ? { flipVertical: true } : {}
 	};
 	return {
 		...pos.anchor,
-		spPr,
+		properties: spPr,
 		...pickConnectorBase(source)
 	};
 }
@@ -1071,12 +1072,13 @@ function docxChildMediaToBox(t) {
 		width: t.emus.x,
 		height: t.emus.y,
 		...t.rotation !== void 0 ? { rotation: parseAngle(t.rotation) } : {},
-		...t.flip?.horizontal ? { flipHorizontal: true } : {},
-		...t.flip?.vertical ? { flipVertical: true } : {}
+		...t.flipHorizontal ? { flipHorizontal: true } : {},
+		...t.flipVertical ? { flipVertical: true } : {}
 	};
 }
-/** pptx shape top-level → core spPr (group-child position is absolute). */
+/** pptx shape → core spPr (group-child position is absolute). */
 function pptxShapeToSpPr(shape) {
+	const paint = shape.properties ?? {};
 	return {
 		x: shape.x,
 		y: shape.y,
@@ -1084,12 +1086,12 @@ function pptxShapeToSpPr(shape) {
 		height: shape.height,
 		...shape.rotation !== void 0 ? { rotation: shape.rotation } : {},
 		...shape.flipHorizontal ? { flipHorizontal: true } : {},
-		...shape.geometry !== void 0 ? { geometry: shape.geometry } : {},
-		...shape.customGeometry !== void 0 ? { customGeometry: shape.customGeometry } : {},
-		...pickContent(shape)
+		...paint.geometry !== void 0 ? { geometry: paint.geometry } : {},
+		...paint.customGeometry !== void 0 ? { customGeometry: paint.customGeometry } : {},
+		...pickContent(paint)
 	};
 }
-/** core spPr → pptx shape top-level fields. */
+/** core spPr → pptx shape (transform top-level, paint nested in `properties`). */
 function spPrToPptxShape(spPr) {
 	return {
 		x: spPr.x,
@@ -1099,20 +1101,22 @@ function spPrToPptxShape(spPr) {
 		...spPr.rotation !== void 0 ? { rotation: spPr.rotation } : {},
 		...spPr.flipHorizontal ? { flipHorizontal: true } : {},
 		...spPr.flipVertical ? { flipVertical: true } : {},
-		...spPr.geometry !== void 0 ? { geometry: spPr.geometry } : {},
-		...spPr.customGeometry !== void 0 ? { customGeometry: spPr.customGeometry } : {},
-		...pickContent(spPr)
+		properties: {
+			...spPr.geometry !== void 0 ? { geometry: spPr.geometry } : {},
+			...spPr.customGeometry !== void 0 ? { customGeometry: spPr.customGeometry } : {},
+			...pickContent(spPr)
+		}
 	};
 }
 /** xlsx group child shape → docx wps core (position lives on the wpg child wrapper). */
 function xlsxShapeChildToDocxData(s) {
-	const preset = toPresetGeometry(s.spPr.geometry);
+	const preset = toPresetGeometry(s.properties.geometry);
 	const cnvPr = pickNonVisualDrawingProperties(s);
 	return {
 		children: s.textBody ? textBodyToDocxChildren(s.textBody) : [],
-		...pickContent(s.spPr),
-		...s.spPr.customGeometry !== void 0 ? { customGeometry: s.spPr.customGeometry } : {},
-		...preset !== void 0 ? { presetGeometry: preset } : {},
+		...pickContent(s.properties),
+		...s.properties.customGeometry !== void 0 ? { customGeometry: s.properties.customGeometry } : {},
+		...preset !== void 0 ? { geometry: preset } : {},
 		...hasCnvPr(cnvPr) ? docxNonVisualFromCnvPr(cnvPr, "Shape") : {}
 	};
 }
@@ -1128,20 +1132,19 @@ function docxChildToSpPr(data, box) {
 		...box.flipVertical ? { flipVertical: true } : {},
 		...pickContent(data)
 	};
-	if (data.presetGeometry !== void 0) out.geometry = data.presetGeometry;
+	if (data.geometry !== void 0) out.geometry = data.geometry;
 	else if (data.customGeometry !== void 0) out.customGeometry = data.customGeometry;
 	return out;
 }
 /** xlsx group connector child → pptx connector. */
 function xlsxConnectorChildToPptx(c) {
-	const { x1, y1, x2, y2 } = boxToEndpoints(boxFromSpPr(c.spPr));
+	const { x1, y1, x2, y2 } = boxToEndpoints(boxFromSpPr(c.properties));
 	return {
 		x1,
 		y1,
 		x2,
 		y2,
-		...c.spPr.outline !== void 0 ? { outline: c.spPr.outline } : {},
-		...c.spPr.fill !== void 0 ? { fill: c.spPr.fill } : {},
+		properties: pickContent(c.properties),
 		...c.locking ? { locking: c.locking } : {},
 		...c.startConnection ? { startConnection: c.startConnection } : {},
 		...c.endConnection ? { endConnection: c.endConnection } : {},
@@ -1151,8 +1154,8 @@ function xlsxConnectorChildToPptx(c) {
 function toDocxGroup(source) {
 	let box;
 	let children;
-	if ("grpSpPr" in source) {
-		const g = source.grpSpPr;
+	if ("properties" in source) {
+		const g = source.properties;
 		box = boxFromXlsxAnchor(source, g.width, g.height, g.rotation, g.flipHorizontal, g.flipVertical);
 		children = xlsxGroupChildrenToDocx(source.shapes, source.connectors);
 	} else {
@@ -1182,7 +1185,7 @@ function xlsxGroupChildrenToDocx(shapes, connectors) {
 	const out = [];
 	for (const s of shapes ?? []) out.push({
 		type: "wps",
-		transformation: createTransformation(boxToDocx(boxFromSpPr(s.spPr))),
+		transformation: createTransformation(boxToDocx(boxFromSpPr(s.properties))),
 		data: xlsxShapeChildToDocxData(s)
 	});
 	if (connectors?.length) console.warn("Connector in group → docx is unsupported; skipped.");
@@ -1192,8 +1195,8 @@ function toPptxGroup(source) {
 	let box;
 	let children;
 	const cnvPr = "transformation" in source ? pickNonVisualDrawingProperties(source.altText) : pickGroupBase(source);
-	if ("grpSpPr" in source) {
-		const g = source.grpSpPr;
+	if ("properties" in source) {
+		const g = source.properties;
 		box = boxFromXlsxAnchor(source, g.width, g.height, g.rotation, g.flipHorizontal, g.flipVertical);
 		children = xlsxGroupChildrenToPptx(source.shapes, source.connectors);
 	} else {
@@ -1209,7 +1212,7 @@ function toPptxGroup(source) {
 function xlsxGroupChildrenToPptx(shapes, connectors) {
 	const out = [];
 	for (const s of shapes ?? []) {
-		const shape = spPrToPptxShape(s.spPr);
+		const shape = spPrToPptxShape(s.properties);
 		if (s.textBody) shape.textBody = s.textBody;
 		Object.assign(shape, pickNonVisualDrawingProperties(s));
 		out.push({ shape });
@@ -1257,7 +1260,7 @@ function toXlsxGroup(source) {
 	};
 	return {
 		...pos.anchor,
-		grpSpPr,
+		properties: grpSpPr,
 		...shapes.length ? { shapes } : {},
 		...connectors.length ? { connectors } : {},
 		...cnvPr
@@ -1268,7 +1271,7 @@ function pptxGroupChildrenToXlsx(children) {
 	const connectors = [];
 	for (const child of children ?? []) if ("shape" in child) {
 		const s = {
-			spPr: pptxShapeToSpPr(child.shape),
+			properties: pptxShapeToSpPr(child.shape),
 			...child.shape.textBody ? { textBody: child.shape.textBody } : {},
 			...pickNonVisualDrawingProperties(child.shape)
 		};
@@ -1283,14 +1286,13 @@ function pptxGroupChildrenToXlsx(children) {
 function pptxConnectorToXlsxChild(c) {
 	const box = endpointsToBox(c.x1, c.y1, c.x2, c.y2);
 	return {
-		spPr: {
+		properties: {
 			x: box.x,
 			y: box.y,
 			width: box.width,
 			height: box.height,
 			geometry: "line",
-			...c.outline !== void 0 ? { outline: c.outline } : {},
-			...c.fill !== void 0 ? { fill: c.fill } : {},
+			...pickContent(c.properties ?? {}),
 			...box.flipHorizontal ? { flipHorizontal: true } : {},
 			...box.flipVertical ? { flipVertical: true } : {}
 		},
@@ -1308,7 +1310,7 @@ function docxGroupChildrenToXlsx(children) {
 		const spPr = docxChildToSpPr(child.data, box);
 		const textBody = docxToTextBody(child.data.children, child.data.bodyProperties);
 		shapes.push({
-			spPr,
+			properties: spPr,
 			...textBody ? { textBody } : {},
 			...pickNonVisualDrawingProperties(child.data.nonVisualProperties)
 		});