office-open 0.12.0 → 0.12.2

package/dist/{schemas-DhCWsZ8v.mjs → schemas-B400scMm.mjs}

@@ -6,6 +6,21 @@ var docx_schema_default = {
 	$ref: "#/definitions/DocumentOptions",
 	$schema: "http://json-schema.org/draft-07/schema#",
 	definitions: {
+		"AbsoluteSizeAnchorOptions": {
+			"additionalProperties": false,
+			"description": "Absolute anchor (cdr:absSizeAnchor): fixed EMU size at the `from` marker.",
+			"properties": {
+				"extent": { "$ref": "#/definitions/UserShapeExtentOptions" },
+				"from": { "$ref": "#/definitions/UserShapeMarkerOptions" },
+				"object": { "$ref": "#/definitions/UserShapeObjectOptions" }
+			},
+			"required": [
+				"from",
+				"extent",
+				"object"
+			],
+			"type": "object"
+		},
 		"AbstractNumberingPropertiesOptions": {
 			"additionalProperties": false,
 			"description": "w:abstractNum attributes + child elements + w15 restart.",
@@ -1116,6 +1131,33 @@ var docx_schema_default = {
 			},
 			"type": "object"
 		},
+		"BlipFillOptions": {
+			"additionalProperties": false,
+			"description": "Options for blip fill properties.",
+			"properties": {
+				"blipEffects": {
+					"$ref": "#/definitions/BlipEffectsOptions",
+					"description": "Image adjustment effects (brightness, contrast, grayscale, etc.)"
+				},
+				"dpi": {
+					"description": "DPI of the image",
+					"type": "number"
+				},
+				"rotWithShape": {
+					"description": "Whether the fill rotates with the shape",
+					"type": "boolean"
+				},
+				"sourceRectangle": {
+					"$ref": "#/definitions/SourceRectangleOptions",
+					"description": "Source rectangle for cropping"
+				},
+				"tile": {
+					"$ref": "#/definitions/TileOptions",
+					"description": "Tile fill mode (if omitted, defaults to stretch)"
+				}
+			},
+			"type": "object"
+		},
 		"BlockContentChild": {
 			"$ref": "#/definitions/SectionChild",
 			"description": "SectionChild minus the body-only w:altChunk leg — the content model of customXml and sdt containers (EG_ContentBlockContent has no altChunk, unlike the body-level EG_BlockLevelElts and w:txbxContent)."
@@ -2223,8 +2265,8 @@ var docx_schema_default = {
 					"type": "number"
 				},
 				"userShapes": {
-					"description": "User-drawn shapes relationship id (c:userShapes r:id, after printSettings).",
-					"type": "string"
+					"$ref": "#/definitions/ChartUserShapesOptions",
+					"description": "User-drawn shapes layered over the chart (c:userShapes, after printSettings)."
 				},
 				"varyColors": {
 					"description": "Vary data-point colors (chart-group-level c:varyColors). Emitted only when set — the corpus is mixed and fresh output stays bare.",
@@ -2564,7 +2606,10 @@ var docx_schema_default = {
 					"type": "boolean"
 				},
 				"upDownBarsGapWidth": { "$ref": "#/definitions/ChartOptions/properties/upDownBarsGapWidth" },
-				"userShapes": { "$ref": "#/definitions/ChartOptions/properties/userShapes" },
+				"userShapes": {
+					"$ref": "#/definitions/ChartUserShapesOptions",
+					"description": "User-drawn shapes layered over the chart (c:userShapes, after printSettings)."
+				},
 				"varyColors": { "$ref": "#/definitions/ChartOptions/properties/varyColors" },
 				"view3D": { "$ref": "#/definitions/View3DOptions" },
 				"wireframe": {
@@ -2630,6 +2675,23 @@ var docx_schema_default = {
 			],
 			"type": "string"
 		},
+		"ChartUserShapesOptions": {
+			"additionalProperties": false,
+			"description": "User-drawn shapes layered over a chart: the c:userShapes reference on the chart space plus the companion part body the format compilers register.",
+			"properties": {
+				"anchors": {
+					"description": "Anchored shapes (the cdr:userShapes part body).",
+					"items": { "anyOf": [{ "$ref": "#/definitions/RelativeSizeAnchorOptions" }, { "$ref": "#/definitions/AbsoluteSizeAnchorOptions" }] },
+					"type": "array"
+				},
+				"relationshipId": {
+					"description": "Chart-part relationship id of the shapes part. Round-trips verbatim; fresh authoring omits it and the reference defaults to rId1 — set an unused id when the same chart also carries externalData.",
+					"type": "string"
+				}
+			},
+			"required": ["anchors"],
+			"type": "object"
+		},
 		"CheckBoxOptions": {
 			"additionalProperties": false,
 			"description": "Options for a checkbox form field.",
@@ -4049,9 +4111,30 @@ var docx_schema_default = {
 		},
 		"DataLabelsOptions": {
 			"additionalProperties": false,
+			"allOf": [{
+				"if": {
+					"properties": { "delete": { "const": true } },
+					"required": ["delete"]
+				},
+				"then": { "not": { "anyOf": [
+					{ "required": ["numberFormat"] },
+					{ "required": ["shapeProperties"] },
+					{ "required": ["textProperties"] },
+					{ "required": ["position"] },
+					{ "required": ["showLegendKey"] },
+					{ "required": ["showVal"] },
+					{ "required": ["showCatName"] },
+					{ "required": ["showSerName"] },
+					{ "required": ["showPercent"] },
+					{ "required": ["showBubbleSize"] },
+					{ "required": ["separator"] },
+					{ "required": ["showLeaderLines"] },
+					{ "required": ["leaderLines"] }
+				] } }
+			}],
 			"properties": {
 				"delete": {
-					"description": "Labels deleted at the group level (c:delete inside c:dLbls) — Office writes val=\"0\" explicitly to keep labels on; round-trips the attribute.",
+					"description": "Drop every label for this series (c:delete). Choice vs the shared settings below: `true` ignores them all; `false` keeps labels on and emits its element only when no setting is set (round-trip).",
 					"type": "boolean"
 				},
 				"labels": {
@@ -4589,14 +4672,8 @@ var docx_schema_default = {
 					"$ref": "#/definitions/Guid",
 					"description": "a16:creationId `@id` from the cNvPr/docPr extension list — Office's per-object creation stamp, the sole known cNvPr ext content."
 				},
-				"description": {
-					"description": "XSD `@descr` — alt text for accessibility; emitted only when present.",
-					"type": "string"
-				},
-				"ext": {
-					"description": "Verbatim `a:extLst` inner XML for extensions beyond creationId (a14 picture effects, useLocalDpi, …). Round-trip only: takes precedence over `creationId`, which it subsumes when the source list carries both.",
-					"type": "string"
-				},
+				"description": { "$ref": "#/definitions/NonVisualDrawingPropertiesOptions/properties/description" },
+				"ext": { "$ref": "#/definitions/NonVisualDrawingPropertiesOptions/properties/ext" },
 				"hidden": {
 					"description": "XSD `@hidden` (default false); emitted as \"1\" only when true.",
 					"type": "boolean"
@@ -6251,6 +6328,18 @@ var docx_schema_default = {
 			"required": ["position", "color"],
 			"type": "object"
 		},
+		"GraphicFrameLockingOptions": {
+			"additionalProperties": false,
+			"properties": {
+				"noChangeAspect": { "type": "boolean" },
+				"noDrilldown": { "type": "boolean" },
+				"noGrp": { "type": "boolean" },
+				"noMove": { "type": "boolean" },
+				"noResize": { "type": "boolean" },
+				"noSelect": { "type": "boolean" }
+			},
+			"type": "object"
+		},
 		"GraphicFrameLocksOptions": {
 			"additionalProperties": false,
 			"description": "Locking flags for wp:cNvGraphicFramePr.",
@@ -6495,14 +6584,14 @@ var docx_schema_default = {
 								"$ref": "#/definitions/Guid",
 								"description": "a16:creationId `@id` from the cNvPr/docPr extension list — Office's per-object creation stamp, the sole known cNvPr ext content."
 							},
-							"description": { "$ref": "#/definitions/DocPropertiesOptions/properties/description" },
-							"ext": { "$ref": "#/definitions/DocPropertiesOptions/properties/ext" },
+							"description": { "$ref": "#/definitions/NonVisualDrawingPropertiesOptions/properties/description" },
+							"ext": { "$ref": "#/definitions/NonVisualDrawingPropertiesOptions/properties/ext" },
 							"hidden": {
 								"description": "XSD `@hidden` (default false); emitted as \"1\" only when true.",
 								"type": "boolean"
 							},
 							"id": { "type": "number" },
-							"name": { "$ref": "#/definitions/NonVisualPropertiesOptions/properties/name" },
+							"name": { "$ref": "#/definitions/NonVisualDrawingPropertiesOptions/properties/name" },
 							"pictureLocks": { "$ref": "#/definitions/NonVisualPropertiesOptions/properties/pictureLocks" },
 							"preferRelativeResize": { "$ref": "#/definitions/NonVisualPropertiesOptions/properties/preferRelativeResize" },
 							"title": {
@@ -6595,6 +6684,40 @@ var docx_schema_default = {
 			},
 			"type": "object"
 		},
+		"GroupShapePropertiesOptions": {
+			"additionalProperties": false,
+			"description": "Group shape properties. Field order follows the XSD content model. The transform fields come from {@link GroupTransform2DOptions } (flat x/y/width/height/flip/rotation/childOffset/childExtent); the serializer emits them as a single a:xfrm group transform. The container-only `@bwMode` attribute and the wrapping tag are the caller's responsibility (mirrors shapePropertiesDesc).",
+			"properties": {
+				"childExtentHeight": { "anyOf": [{ "type": "number" }, { "$ref": "#/definitions/UniversalMeasure" }] },
+				"childExtentWidth": { "anyOf": [{ "type": "number" }, { "$ref": "#/definitions/UniversalMeasure" }] },
+				"childOffsetX": { "anyOf": [{ "type": "number" }, { "$ref": "#/definitions/UniversalMeasure" }] },
+				"childOffsetY": { "anyOf": [{ "type": "number" }, { "$ref": "#/definitions/UniversalMeasure" }] },
+				"effectDag": { "$ref": "#/definitions/EffectDagOptions" },
+				"effects": {
+					"$ref": "#/definitions/EffectListOptions",
+					"description": "EG_EffectProperties (choice: a:effectDag | a:effectLst)."
+				},
+				"fill": {
+					"$ref": "#/definitions/FillOptions",
+					"description": "EG_FillProperties."
+				},
+				"flipHorizontal": { "type": "boolean" },
+				"flipVertical": { "type": "boolean" },
+				"height": { "anyOf": [{ "type": "number" }, { "$ref": "#/definitions/UniversalMeasure" }] },
+				"rotation": {
+					"description": "Rotation angle in degrees (e.g., 45 = 45°).",
+					"type": "number"
+				},
+				"scene3d": {
+					"$ref": "#/definitions/Scene3DOptions",
+					"description": "a:scene3d."
+				},
+				"width": { "anyOf": [{ "type": "number" }, { "$ref": "#/definitions/UniversalMeasure" }] },
+				"x": { "anyOf": [{ "type": "number" }, { "$ref": "#/definitions/UniversalMeasure" }] },
+				"y": { "anyOf": [{ "type": "number" }, { "$ref": "#/definitions/UniversalMeasure" }] }
+			},
+			"type": "object"
+		},
 		"Guid": {
 			"description": "GUID in braced upper-case form (ST_Guid).",
 			"examples": ["{1DF903F5-8FC7-4C6A-9DF9-2AB1D10E6D84}"],
@@ -9076,25 +9199,53 @@ var docx_schema_default = {
 			},
 			"type": "object"
 		},
-		"NonVisualPropertiesOptions": {
+		"NonVisualDrawingPropertiesOptions": {
 			"additionalProperties": false,
-			"description": "Round-trip of `pic:cNvPr` — the picture non-visual id/name/description. All fields optional to mirror the source element: `description` is omitted when absent rather than emitted as an empty attribute (Word never writes it empty).",
+			"description": "Mirrors a: — name/descr/title/hidden. id is runtime; hyperlinks stay package-side.",
 			"properties": {
 				"creationId": {
 					"$ref": "#/definitions/Guid",
 					"description": "a16:creationId `@id` from the cNvPr/docPr extension list — Office's per-object creation stamp, the sole known cNvPr ext content."
 				},
-				"description": { "$ref": "#/definitions/DocPropertiesOptions/properties/description" },
-				"ext": { "$ref": "#/definitions/DocPropertiesOptions/properties/ext" },
+				"description": {
+					"description": "XSD `@descr` — alt text for accessibility; emitted only when present.",
+					"type": "string"
+				},
+				"ext": {
+					"description": "Verbatim `a:extLst` inner XML for extensions beyond creationId (a14 picture effects, useLocalDpi, …). Round-trip only: takes precedence over `creationId`, which it subsumes when the source list carries both.",
+					"type": "string"
+				},
 				"hidden": {
 					"description": "XSD `@hidden` (default false); emitted as \"1\" only when true.",
 					"type": "boolean"
 				},
-				"id": { "type": "number" },
 				"name": {
 					"description": "XSD `@name` (required in XML); API-optional, the descriptor synthesizes a fallback.",
 					"type": "string"
 				},
+				"title": {
+					"description": "XSD `@title`.",
+					"type": "string"
+				}
+			},
+			"type": "object"
+		},
+		"NonVisualPropertiesOptions": {
+			"additionalProperties": false,
+			"description": "Round-trip of `pic:cNvPr` — the picture non-visual id/name/description. All fields optional to mirror the source element: `description` is omitted when absent rather than emitted as an empty attribute (Word never writes it empty).",
+			"properties": {
+				"creationId": {
+					"$ref": "#/definitions/Guid",
+					"description": "a16:creationId `@id` from the cNvPr/docPr extension list — Office's per-object creation stamp, the sole known cNvPr ext content."
+				},
+				"description": { "$ref": "#/definitions/NonVisualDrawingPropertiesOptions/properties/description" },
+				"ext": { "$ref": "#/definitions/NonVisualDrawingPropertiesOptions/properties/ext" },
+				"hidden": {
+					"description": "XSD `@hidden` (default false); emitted as \"1\" only when true.",
+					"type": "boolean"
+				},
+				"id": { "type": "number" },
+				"name": { "$ref": "#/definitions/NonVisualDrawingPropertiesOptions/properties/name" },
 				"pictureLocks": {
 					"anyOf": [{ "$ref": "#/definitions/PictureLockingOptions" }, { "type": "null" }],
 					"description": "Picture locks from pic:cNvPicPr/a:picLocks. `null` = source carried none (round-trips as a bare pic:cNvPicPr); omitted = authoring default (noChangeAspect=\"1\", matching Word's fresh-insert behavior); an object = explicit lock flags."
@@ -12519,6 +12670,21 @@ var docx_schema_default = {
 			},
 			"type": "object"
 		},
+		"RelativeSizeAnchorOptions": {
+			"additionalProperties": false,
+			"description": "Relative anchor (cdr:relSizeAnchor): the object spans from `from` to `to`.",
+			"properties": {
+				"from": { "$ref": "#/definitions/UserShapeMarkerOptions" },
+				"object": { "$ref": "#/definitions/UserShapeObjectOptions" },
+				"to": { "$ref": "#/definitions/UserShapeMarkerOptions" }
+			},
+			"required": [
+				"from",
+				"to",
+				"object"
+			],
+			"type": "object"
+		},
 		"RelativeSizeOptions": {
 			"additionalProperties": false,
 			"description": "Options for sizing a floating drawing relative to a page base.",
@@ -18277,6 +18443,22 @@ var docx_schema_default = {
 			],
 			"description": "Children allowed inside a track-change wrapper (w:ins/w:del/w:moveFrom/ w:moveTo) — runs, the comment range markers Word anchors directly inside the wrapper, complete field chains, and nested same-type wrappers."
 		},
+		"Transform2DOptions": {
+			"additionalProperties": false,
+			"properties": {
+				"flipHorizontal": { "type": "boolean" },
+				"flipVertical": { "type": "boolean" },
+				"height": { "anyOf": [{ "type": "number" }, { "$ref": "#/definitions/UniversalMeasure" }] },
+				"rotation": {
+					"description": "Rotation angle in degrees (e.g., 45 = 45°).",
+					"type": "number"
+				},
+				"width": { "anyOf": [{ "type": "number" }, { "$ref": "#/definitions/UniversalMeasure" }] },
+				"x": { "anyOf": [{ "type": "number" }, { "$ref": "#/definitions/UniversalMeasure" }] },
+				"y": { "anyOf": [{ "type": "number" }, { "$ref": "#/definitions/UniversalMeasure" }] }
+			},
+			"type": "object"
+		},
 		"TransformEffectOptions": {
 			"additionalProperties": false,
 			"description": "Transform effect — scale, skew, translate.",
@@ -18373,6 +18555,220 @@ var docx_schema_default = {
 			"pattern": "^-?(\\d+(\\.\\d+)?|\\.\\d+)(mm|cm|in|pt|pc|pi|px)$",
 			"type": "string"
 		},
+		"UserShapeConnectorOptions": {
+			"additionalProperties": false,
+			"properties": {
+				"id": {
+					"description": "cNvPr drawing id (schema-required)",
+					"type": "number"
+				},
+				"macro": {
+					"description": "Macro reference (`@macro`)",
+					"type": "string"
+				},
+				"nonVisualProperties": { "$ref": "#/definitions/NonVisualDrawingPropertiesOptions" },
+				"published": {
+					"description": "Published as a server-side shape (`@fPublished`, default false)",
+					"type": "boolean"
+				},
+				"shapeProperties": { "$ref": "#/definitions/ShapePropertiesOptions" },
+				"style": { "$ref": "#/definitions/DefaultShapeStyleOptions" },
+				"type": {
+					"const": "connector",
+					"type": "string"
+				}
+			},
+			"required": [
+				"id",
+				"shapeProperties",
+				"type"
+			],
+			"type": "object"
+		},
+		"UserShapeExtentOptions": {
+			"additionalProperties": false,
+			"description": "Anchor extent (a:ext): width/height in EMU.",
+			"properties": {
+				"height": { "type": "number" },
+				"width": { "type": "number" }
+			},
+			"required": ["width", "height"],
+			"type": "object"
+		},
+		"UserShapeGraphicFrameOptions": {
+			"additionalProperties": false,
+			"properties": {
+				"graphic": {
+					"description": "Verbatim a:graphic XML payload. The graphic contents (chart/table references) are package-wired; the part body carries them unchanged.",
+					"type": "string"
+				},
+				"graphicFrameLocks": {
+					"anyOf": [{ "$ref": "#/definitions/GraphicFrameLockingOptions" }, { "type": "null" }],
+					"description": "Frame locking flags (cdr:cNvGraphicFramePr)"
+				},
+				"id": {
+					"description": "cNvPr drawing id (schema-required)",
+					"type": "number"
+				},
+				"macro": {
+					"description": "Macro reference (`@macro`)",
+					"type": "string"
+				},
+				"nonVisualProperties": { "$ref": "#/definitions/NonVisualDrawingPropertiesOptions" },
+				"published": {
+					"description": "Published as a server-side shape (`@fPublished`, default false)",
+					"type": "boolean"
+				},
+				"transform": {
+					"$ref": "#/definitions/Transform2DOptions",
+					"description": "Placement transform (cdr:xfrm)"
+				},
+				"type": {
+					"const": "graphicFrame",
+					"type": "string"
+				}
+			},
+			"required": [
+				"graphic",
+				"id",
+				"transform",
+				"type"
+			],
+			"type": "object"
+		},
+		"UserShapeGroupOptions": {
+			"additionalProperties": false,
+			"properties": {
+				"children": {
+					"items": { "$ref": "#/definitions/UserShapeObjectOptions" },
+					"type": "array"
+				},
+				"groupShapeProperties": { "$ref": "#/definitions/GroupShapePropertiesOptions" },
+				"id": {
+					"description": "cNvPr drawing id (schema-required)",
+					"type": "number"
+				},
+				"macro": {
+					"description": "Macro reference (`@macro`)",
+					"type": "string"
+				},
+				"nonVisualProperties": { "$ref": "#/definitions/NonVisualDrawingPropertiesOptions" },
+				"published": {
+					"description": "Published as a server-side shape (`@fPublished`, default false)",
+					"type": "boolean"
+				},
+				"type": {
+					"const": "group",
+					"type": "string"
+				}
+			},
+			"required": [
+				"children",
+				"groupShapeProperties",
+				"id",
+				"type"
+			],
+			"type": "object"
+		},
+		"UserShapeMarkerOptions": {
+			"additionalProperties": false,
+			"description": "Anchor marker: x/y as 0.0–1.0 fractions of the chart area.",
+			"properties": {
+				"x": { "type": "number" },
+				"y": { "type": "number" }
+			},
+			"required": ["x", "y"],
+			"type": "object"
+		},
+		"UserShapeObjectOptions": { "anyOf": [
+			{ "$ref": "#/definitions/UserShapeShapeOptions" },
+			{ "$ref": "#/definitions/UserShapeConnectorOptions" },
+			{ "$ref": "#/definitions/UserShapePictureOptions" },
+			{ "$ref": "#/definitions/UserShapeGraphicFrameOptions" },
+			{ "$ref": "#/definitions/UserShapeGroupOptions" }
+		] },
+		"UserShapePictureOptions": {
+			"additionalProperties": false,
+			"properties": {
+				"blipFill": { "$ref": "#/definitions/BlipFillOptions" },
+				"id": {
+					"description": "cNvPr drawing id (schema-required)",
+					"type": "number"
+				},
+				"macro": {
+					"description": "Macro reference (`@macro`)",
+					"type": "string"
+				},
+				"nonVisualProperties": { "$ref": "#/definitions/NonVisualDrawingPropertiesOptions" },
+				"published": {
+					"description": "Published as a server-side shape (`@fPublished`, default false)",
+					"type": "boolean"
+				},
+				"referenceId": {
+					"description": "Image reference key (a:blip r:embed via the relationship placeholder)",
+					"type": "string"
+				},
+				"shapeProperties": { "$ref": "#/definitions/ShapePropertiesOptions" },
+				"style": { "$ref": "#/definitions/DefaultShapeStyleOptions" },
+				"type": {
+					"const": "picture",
+					"type": "string"
+				}
+			},
+			"required": [
+				"id",
+				"referenceId",
+				"shapeProperties",
+				"type"
+			],
+			"type": "object"
+		},
+		"UserShapeShapeOptions": {
+			"additionalProperties": false,
+			"properties": {
+				"id": {
+					"description": "cNvPr drawing id (schema-required)",
+					"type": "number"
+				},
+				"locksText": {
+					"description": "Text locking (`@fLocksText`, default true)",
+					"type": "boolean"
+				},
+				"macro": {
+					"description": "Macro reference (`@macro`)",
+					"type": "string"
+				},
+				"nonVisualProperties": {
+					"$ref": "#/definitions/NonVisualDrawingPropertiesOptions",
+					"description": "cNvPr — id is required by the schema"
+				},
+				"published": {
+					"description": "Published as a server-side shape (`@fPublished`, default false)",
+					"type": "boolean"
+				},
+				"shapeProperties": { "$ref": "#/definitions/ShapePropertiesOptions" },
+				"style": { "$ref": "#/definitions/DefaultShapeStyleOptions" },
+				"textBody": { "$ref": "#/definitions/TextBodyOptions" },
+				"textBox": {
+					"description": "Text-box marker (cdr:cNvSpPr `@txBox`)",
+					"type": "boolean"
+				},
+				"textLink": {
+					"description": "Formula linking the text to a cell (`@textlink`)",
+					"type": "string"
+				},
+				"type": {
+					"const": "shape",
+					"type": "string"
+				}
+			},
+			"required": [
+				"id",
+				"shapeProperties",
+				"type"
+			],
+			"type": "object"
+		},
 		"VariableListOptions": {
 			"additionalProperties": false,
 			"description": "dgm:varLst.",
@@ -21780,6 +22176,21 @@ var pptx_schema_default = {
 	$ref: "#/definitions/PresentationOptions",
 	$schema: "http://json-schema.org/draft-07/schema#",
 	definitions: {
+		"AbsoluteSizeAnchorOptions": {
+			"additionalProperties": false,
+			"description": "Absolute anchor (cdr:absSizeAnchor): fixed EMU size at the `from` marker.",
+			"properties": {
+				"extent": { "$ref": "#/definitions/UserShapeExtentOptions" },
+				"from": { "$ref": "#/definitions/UserShapeMarkerOptions" },
+				"object": { "$ref": "#/definitions/UserShapeObjectOptions" }
+			},
+			"required": [
+				"from",
+				"extent",
+				"object"
+			],
+			"type": "object"
+		},
 		"AdjustHandle": {
 			"anyOf": [{ "$ref": "#/definitions/XYAdjustHandle" }, { "$ref": "#/definitions/PolarAdjustHandle" }],
 			"description": "An adjust handle (XY or Polar)."
@@ -23564,6 +23975,33 @@ var pptx_schema_default = {
 			},
 			"type": "object"
 		},
+		"BlipFillOptions": {
+			"additionalProperties": false,
+			"description": "Options for blip fill properties.",
+			"properties": {
+				"blipEffects": {
+					"$ref": "#/definitions/BlipEffectsOptions",
+					"description": "Image adjustment effects (brightness, contrast, grayscale, etc.)"
+				},
+				"dpi": {
+					"description": "DPI of the image",
+					"type": "number"
+				},
+				"rotWithShape": {
+					"description": "Whether the fill rotates with the shape",
+					"type": "boolean"
+				},
+				"sourceRectangle": {
+					"$ref": "#/definitions/SourceRectangleOptions",
+					"description": "Source rectangle for cropping"
+				},
+				"tile": {
+					"$ref": "#/definitions/TileOptions",
+					"description": "Tile fill mode (if omitted, defaults to stretch)"
+				}
+			},
+			"type": "object"
+		},
 		"BlurEffectOptions": {
 			"additionalProperties": false,
 			"description": "Blur effect options.",
@@ -24404,8 +24842,8 @@ var pptx_schema_default = {
 					"type": "boolean"
 				},
 				"userShapes": {
-					"description": "User-drawn shapes relationship id (c:userShapes r:id, after printSettings).",
-					"type": "string"
+					"$ref": "#/definitions/ChartUserShapesOptions",
+					"description": "User-drawn shapes layered over the chart (c:userShapes, after printSettings)."
 				},
 				"varyColors": {
 					"description": "Vary data-point colors (chart-group-level c:varyColors). Emitted only when set — the corpus is mixed and fresh output stays bare.",
@@ -24615,6 +25053,23 @@ var pptx_schema_default = {
 			],
 			"type": "string"
 		},
+		"ChartUserShapesOptions": {
+			"additionalProperties": false,
+			"description": "User-drawn shapes layered over a chart: the c:userShapes reference on the chart space plus the companion part body the format compilers register.",
+			"properties": {
+				"anchors": {
+					"description": "Anchored shapes (the cdr:userShapes part body).",
+					"items": { "anyOf": [{ "$ref": "#/definitions/RelativeSizeAnchorOptions" }, { "$ref": "#/definitions/AbsoluteSizeAnchorOptions" }] },
+					"type": "array"
+				},
+				"relationshipId": {
+					"description": "Chart-part relationship id of the shapes part. Round-trips verbatim; fresh authoring omits it and the reference defaults to rId1 — set an unused id when the same chart also carries externalData.",
+					"type": "string"
+				}
+			},
+			"required": ["anchors"],
+			"type": "object"
+		},
 		"ChildOrder": {
 			"description": "(dgm:layoutNode `@chOrder`).",
 			"enum": ["b", "t"],
@@ -25440,9 +25895,30 @@ var pptx_schema_default = {
 		},
 		"DataLabelsOptions": {
 			"additionalProperties": false,
+			"allOf": [{
+				"if": {
+					"properties": { "delete": { "const": true } },
+					"required": ["delete"]
+				},
+				"then": { "not": { "anyOf": [
+					{ "required": ["numberFormat"] },
+					{ "required": ["shapeProperties"] },
+					{ "required": ["textProperties"] },
+					{ "required": ["position"] },
+					{ "required": ["showLegendKey"] },
+					{ "required": ["showVal"] },
+					{ "required": ["showCatName"] },
+					{ "required": ["showSerName"] },
+					{ "required": ["showPercent"] },
+					{ "required": ["showBubbleSize"] },
+					{ "required": ["separator"] },
+					{ "required": ["showLeaderLines"] },
+					{ "required": ["leaderLines"] }
+				] } }
+			}],
 			"properties": {
 				"delete": {
-					"description": "Labels deleted at the group level (c:delete inside c:dLbls) — Office writes val=\"0\" explicitly to keep labels on; round-trips the attribute.",
+					"description": "Drop every label for this series (c:delete). Choice vs the shared settings below: `true` ignores them all; `false` keeps labels on and emits its element only when no setting is set (round-trip).",
 					"type": "boolean"
 				},
 				"labels": {
@@ -26606,6 +27082,40 @@ var pptx_schema_default = {
 			"required": ["children"],
 			"type": "object"
 		},
+		"GroupShapePropertiesOptions": {
+			"additionalProperties": false,
+			"description": "Group shape properties. Field order follows the XSD content model. The transform fields come from {@link GroupTransform2DOptions } (flat x/y/width/height/flip/rotation/childOffset/childExtent); the serializer emits them as a single a:xfrm group transform. The container-only `@bwMode` attribute and the wrapping tag are the caller's responsibility (mirrors shapePropertiesDesc).",
+			"properties": {
+				"childExtentHeight": { "anyOf": [{ "type": "number" }, { "$ref": "#/definitions/UniversalMeasure" }] },
+				"childExtentWidth": { "anyOf": [{ "type": "number" }, { "$ref": "#/definitions/UniversalMeasure" }] },
+				"childOffsetX": { "anyOf": [{ "type": "number" }, { "$ref": "#/definitions/UniversalMeasure" }] },
+				"childOffsetY": { "anyOf": [{ "type": "number" }, { "$ref": "#/definitions/UniversalMeasure" }] },
+				"effectDag": { "$ref": "#/definitions/EffectDagOptions" },
+				"effects": {
+					"$ref": "#/definitions/EffectListOptions",
+					"description": "EG_EffectProperties (choice: a:effectDag | a:effectLst)."
+				},
+				"fill": {
+					"$ref": "#/definitions/FillOptions",
+					"description": "EG_FillProperties."
+				},
+				"flipHorizontal": { "type": "boolean" },
+				"flipVertical": { "type": "boolean" },
+				"height": { "anyOf": [{ "type": "number" }, { "$ref": "#/definitions/UniversalMeasure" }] },
+				"rotation": {
+					"description": "Rotation angle in degrees (e.g., 45 = 45°).",
+					"type": "number"
+				},
+				"scene3d": {
+					"$ref": "#/definitions/Scene3DOptions",
+					"description": "a:scene3d."
+				},
+				"width": { "anyOf": [{ "type": "number" }, { "$ref": "#/definitions/UniversalMeasure" }] },
+				"x": { "anyOf": [{ "type": "number" }, { "$ref": "#/definitions/UniversalMeasure" }] },
+				"y": { "anyOf": [{ "type": "number" }, { "$ref": "#/definitions/UniversalMeasure" }] }
+			},
+			"type": "object"
+		},
 		"Guid": {
 			"description": "GUID in braced upper-case form (ST_Guid).",
 			"examples": ["{1DF903F5-8FC7-4C6A-9DF9-2AB1D10E6D84}"],
@@ -27763,6 +28273,28 @@ var pptx_schema_default = {
 			},
 			"type": "object"
 		},
+		"NonVisualDrawingPropertiesOptions": {
+			"additionalProperties": false,
+			"description": "Mirrors a: — name/descr/title/hidden. id is runtime; hyperlinks stay package-side.",
+			"properties": {
+				"creationId": {
+					"$ref": "#/definitions/Guid",
+					"description": "a16:creationId `@id` from the cNvPr/docPr extension list — Office's per-object creation stamp, the sole known cNvPr ext content."
+				},
+				"description": { "$ref": "#/definitions/ShapeOptions/properties/description" },
+				"ext": { "$ref": "#/definitions/PictureOptions/properties/ext" },
+				"hidden": {
+					"description": "XSD `@hidden` (default false); emitted as \"1\" only when true.",
+					"type": "boolean"
+				},
+				"name": { "$ref": "#/definitions/ShapeOptions/properties/name" },
+				"title": {
+					"description": "XSD `@title`.",
+					"type": "string"
+				}
+			},
+			"type": "object"
+		},
 		"NormalAutofitOptions": {
 			"additionalProperties": false,
 			"description": "Normal autofit options.",
@@ -29648,6 +30180,21 @@ var pptx_schema_default = {
 			},
 			"type": "object"
 		},
+		"RelativeSizeAnchorOptions": {
+			"additionalProperties": false,
+			"description": "Relative anchor (cdr:relSizeAnchor): the object spans from `from` to `to`.",
+			"properties": {
+				"from": { "$ref": "#/definitions/UserShapeMarkerOptions" },
+				"object": { "$ref": "#/definitions/UserShapeObjectOptions" },
+				"to": { "$ref": "#/definitions/UserShapeMarkerOptions" }
+			},
+			"required": [
+				"from",
+				"to",
+				"object"
+			],
+			"type": "object"
+		},
 		"ResizeHandles": {
 			"description": "(dgm:resizeHandles `@val`).",
 			"enum": ["exact", "relative"],
@@ -32041,6 +32588,22 @@ var pptx_schema_default = {
 			},
 			"type": "object"
 		},
+		"Transform2DOptions": {
+			"additionalProperties": false,
+			"properties": {
+				"flipHorizontal": { "type": "boolean" },
+				"flipVertical": { "type": "boolean" },
+				"height": { "anyOf": [{ "type": "number" }, { "$ref": "#/definitions/UniversalMeasure" }] },
+				"rotation": {
+					"description": "Rotation angle in degrees (e.g., 45 = 45°).",
+					"type": "number"
+				},
+				"width": { "anyOf": [{ "type": "number" }, { "$ref": "#/definitions/UniversalMeasure" }] },
+				"x": { "anyOf": [{ "type": "number" }, { "$ref": "#/definitions/UniversalMeasure" }] },
+				"y": { "anyOf": [{ "type": "number" }, { "$ref": "#/definitions/UniversalMeasure" }] }
+			},
+			"type": "object"
+		},
 		"TransformEffectOptions": {
 			"additionalProperties": false,
 			"description": "Transform effect — scale, skew, translate.",
@@ -32242,6 +32805,220 @@ var pptx_schema_default = {
 			"pattern": "^-?(\\d+(\\.\\d+)?|\\.\\d+)(mm|cm|in|pt|pc|pi|px)$",
 			"type": "string"
 		},
+		"UserShapeConnectorOptions": {
+			"additionalProperties": false,
+			"properties": {
+				"id": {
+					"description": "cNvPr drawing id (schema-required)",
+					"type": "number"
+				},
+				"macro": {
+					"description": "Macro reference (`@macro`)",
+					"type": "string"
+				},
+				"nonVisualProperties": { "$ref": "#/definitions/NonVisualDrawingPropertiesOptions" },
+				"published": {
+					"description": "Published as a server-side shape (`@fPublished`, default false)",
+					"type": "boolean"
+				},
+				"shapeProperties": { "$ref": "#/definitions/ShapePropertiesOptions" },
+				"style": { "$ref": "#/definitions/DefaultShapeStyleOptions" },
+				"type": {
+					"const": "connector",
+					"type": "string"
+				}
+			},
+			"required": [
+				"id",
+				"shapeProperties",
+				"type"
+			],
+			"type": "object"
+		},
+		"UserShapeExtentOptions": {
+			"additionalProperties": false,
+			"description": "Anchor extent (a:ext): width/height in EMU.",
+			"properties": {
+				"height": { "type": "number" },
+				"width": { "type": "number" }
+			},
+			"required": ["width", "height"],
+			"type": "object"
+		},
+		"UserShapeGraphicFrameOptions": {
+			"additionalProperties": false,
+			"properties": {
+				"graphic": {
+					"description": "Verbatim a:graphic XML payload. The graphic contents (chart/table references) are package-wired; the part body carries them unchanged.",
+					"type": "string"
+				},
+				"graphicFrameLocks": {
+					"anyOf": [{ "$ref": "#/definitions/GraphicFrameLockingOptions" }, { "type": "null" }],
+					"description": "Frame locking flags (cdr:cNvGraphicFramePr)"
+				},
+				"id": {
+					"description": "cNvPr drawing id (schema-required)",
+					"type": "number"
+				},
+				"macro": {
+					"description": "Macro reference (`@macro`)",
+					"type": "string"
+				},
+				"nonVisualProperties": { "$ref": "#/definitions/NonVisualDrawingPropertiesOptions" },
+				"published": {
+					"description": "Published as a server-side shape (`@fPublished`, default false)",
+					"type": "boolean"
+				},
+				"transform": {
+					"$ref": "#/definitions/Transform2DOptions",
+					"description": "Placement transform (cdr:xfrm)"
+				},
+				"type": {
+					"const": "graphicFrame",
+					"type": "string"
+				}
+			},
+			"required": [
+				"graphic",
+				"id",
+				"transform",
+				"type"
+			],
+			"type": "object"
+		},
+		"UserShapeGroupOptions": {
+			"additionalProperties": false,
+			"properties": {
+				"children": {
+					"items": { "$ref": "#/definitions/UserShapeObjectOptions" },
+					"type": "array"
+				},
+				"groupShapeProperties": { "$ref": "#/definitions/GroupShapePropertiesOptions" },
+				"id": {
+					"description": "cNvPr drawing id (schema-required)",
+					"type": "number"
+				},
+				"macro": {
+					"description": "Macro reference (`@macro`)",
+					"type": "string"
+				},
+				"nonVisualProperties": { "$ref": "#/definitions/NonVisualDrawingPropertiesOptions" },
+				"published": {
+					"description": "Published as a server-side shape (`@fPublished`, default false)",
+					"type": "boolean"
+				},
+				"type": {
+					"const": "group",
+					"type": "string"
+				}
+			},
+			"required": [
+				"children",
+				"groupShapeProperties",
+				"id",
+				"type"
+			],
+			"type": "object"
+		},
+		"UserShapeMarkerOptions": {
+			"additionalProperties": false,
+			"description": "Anchor marker: x/y as 0.0–1.0 fractions of the chart area.",
+			"properties": {
+				"x": { "type": "number" },
+				"y": { "type": "number" }
+			},
+			"required": ["x", "y"],
+			"type": "object"
+		},
+		"UserShapeObjectOptions": { "anyOf": [
+			{ "$ref": "#/definitions/UserShapeShapeOptions" },
+			{ "$ref": "#/definitions/UserShapeConnectorOptions" },
+			{ "$ref": "#/definitions/UserShapePictureOptions" },
+			{ "$ref": "#/definitions/UserShapeGraphicFrameOptions" },
+			{ "$ref": "#/definitions/UserShapeGroupOptions" }
+		] },
+		"UserShapePictureOptions": {
+			"additionalProperties": false,
+			"properties": {
+				"blipFill": { "$ref": "#/definitions/BlipFillOptions" },
+				"id": {
+					"description": "cNvPr drawing id (schema-required)",
+					"type": "number"
+				},
+				"macro": {
+					"description": "Macro reference (`@macro`)",
+					"type": "string"
+				},
+				"nonVisualProperties": { "$ref": "#/definitions/NonVisualDrawingPropertiesOptions" },
+				"published": {
+					"description": "Published as a server-side shape (`@fPublished`, default false)",
+					"type": "boolean"
+				},
+				"referenceId": {
+					"description": "Image reference key (a:blip r:embed via the relationship placeholder)",
+					"type": "string"
+				},
+				"shapeProperties": { "$ref": "#/definitions/ShapePropertiesOptions" },
+				"style": { "$ref": "#/definitions/DefaultShapeStyleOptions" },
+				"type": {
+					"const": "picture",
+					"type": "string"
+				}
+			},
+			"required": [
+				"id",
+				"referenceId",
+				"shapeProperties",
+				"type"
+			],
+			"type": "object"
+		},
+		"UserShapeShapeOptions": {
+			"additionalProperties": false,
+			"properties": {
+				"id": {
+					"description": "cNvPr drawing id (schema-required)",
+					"type": "number"
+				},
+				"locksText": {
+					"description": "Text locking (`@fLocksText`, default true)",
+					"type": "boolean"
+				},
+				"macro": {
+					"description": "Macro reference (`@macro`)",
+					"type": "string"
+				},
+				"nonVisualProperties": {
+					"$ref": "#/definitions/NonVisualDrawingPropertiesOptions",
+					"description": "cNvPr — id is required by the schema"
+				},
+				"published": {
+					"description": "Published as a server-side shape (`@fPublished`, default false)",
+					"type": "boolean"
+				},
+				"shapeProperties": { "$ref": "#/definitions/ShapePropertiesOptions" },
+				"style": { "$ref": "#/definitions/DefaultShapeStyleOptions" },
+				"textBody": { "$ref": "#/definitions/TextBodyOptions" },
+				"textBox": {
+					"description": "Text-box marker (cdr:cNvSpPr `@txBox`)",
+					"type": "boolean"
+				},
+				"textLink": {
+					"description": "Formula linking the text to a cell (`@textlink`)",
+					"type": "string"
+				},
+				"type": {
+					"const": "shape",
+					"type": "string"
+				}
+			},
+			"required": [
+				"id",
+				"shapeProperties",
+				"type"
+			],
+			"type": "object"
+		},
 		"VariableListOptions": {
 			"additionalProperties": false,
 			"description": "dgm:varLst.",
@@ -32620,6 +33397,21 @@ var xlsx_schema_default = {
 	$ref: "#/definitions/WorkbookOptions",
 	$schema: "http://json-schema.org/draft-07/schema#",
 	definitions: {
+		"AbsoluteSizeAnchorOptions": {
+			"additionalProperties": false,
+			"description": "Absolute anchor (cdr:absSizeAnchor): fixed EMU size at the `from` marker.",
+			"properties": {
+				"extent": { "$ref": "#/definitions/UserShapeExtentOptions" },
+				"from": { "$ref": "#/definitions/UserShapeMarkerOptions" },
+				"object": { "$ref": "#/definitions/UserShapeObjectOptions" }
+			},
+			"required": [
+				"from",
+				"extent",
+				"object"
+			],
+			"type": "object"
+		},
 		"AdjustHandle": {
 			"anyOf": [{ "$ref": "#/definitions/XYAdjustHandle" }, { "$ref": "#/definitions/PolarAdjustHandle" }],
 			"description": "An adjust handle (XY or Polar)."
@@ -33390,6 +34182,33 @@ var xlsx_schema_default = {
 			},
 			"type": "object"
 		},
+		"BlipFillOptions": {
+			"additionalProperties": false,
+			"description": "Options for blip fill properties.",
+			"properties": {
+				"blipEffects": {
+					"$ref": "#/definitions/BlipEffectsOptions",
+					"description": "Image adjustment effects (brightness, contrast, grayscale, etc.)"
+				},
+				"dpi": {
+					"description": "DPI of the image",
+					"type": "number"
+				},
+				"rotWithShape": {
+					"description": "Whether the fill rotates with the shape",
+					"type": "boolean"
+				},
+				"sourceRectangle": {
+					"$ref": "#/definitions/SourceRectangleOptions",
+					"description": "Source rectangle for cropping"
+				},
+				"tile": {
+					"$ref": "#/definitions/TileOptions",
+					"description": "Tile fill mode (if omitted, defaults to stretch)"
+				}
+			},
+			"type": "object"
+		},
 		"BlurEffectOptions": {
 			"additionalProperties": false,
 			"description": "Blur effect options.",
@@ -34693,7 +35512,10 @@ var xlsx_schema_default = {
 					"type": "boolean"
 				},
 				"upDownBarsGapWidth": { "$ref": "#/definitions/WorksheetChartOptions/properties/upDownBarsGapWidth" },
-				"userShapes": { "$ref": "#/definitions/WorksheetChartOptions/properties/userShapes" },
+				"userShapes": {
+					"$ref": "#/definitions/ChartUserShapesOptions",
+					"description": "User-drawn shapes layered over the chart (c:userShapes, after printSettings)."
+				},
 				"varyColors": { "$ref": "#/definitions/WorksheetChartOptions/properties/varyColors" },
 				"view3D": { "$ref": "#/definitions/View3DOptions" },
 				"wireframe": {
@@ -34759,6 +35581,23 @@ var xlsx_schema_default = {
 			],
 			"type": "string"
 		},
+		"ChartUserShapesOptions": {
+			"additionalProperties": false,
+			"description": "User-drawn shapes layered over a chart: the c:userShapes reference on the chart space plus the companion part body the format compilers register.",
+			"properties": {
+				"anchors": {
+					"description": "Anchored shapes (the cdr:userShapes part body).",
+					"items": { "anyOf": [{ "$ref": "#/definitions/RelativeSizeAnchorOptions" }, { "$ref": "#/definitions/AbsoluteSizeAnchorOptions" }] },
+					"type": "array"
+				},
+				"relationshipId": {
+					"description": "Chart-part relationship id of the shapes part. Round-trips verbatim; fresh authoring omits it and the reference defaults to rId1 — set an unused id when the same chart also carries externalData.",
+					"type": "string"
+				}
+			},
+			"required": ["anchors"],
+			"type": "object"
+		},
 		"ChartsheetOptions": {
 			"additionalProperties": false,
 			"description": "A chart sheet (xl/chartsheets/sheetN.xml) — a full-sheet chart with its own view state.",
@@ -36354,9 +37193,30 @@ var xlsx_schema_default = {
 		},
 		"DataLabelsOptions": {
 			"additionalProperties": false,
+			"allOf": [{
+				"if": {
+					"properties": { "delete": { "const": true } },
+					"required": ["delete"]
+				},
+				"then": { "not": { "anyOf": [
+					{ "required": ["numberFormat"] },
+					{ "required": ["shapeProperties"] },
+					{ "required": ["textProperties"] },
+					{ "required": ["position"] },
+					{ "required": ["showLegendKey"] },
+					{ "required": ["showVal"] },
+					{ "required": ["showCatName"] },
+					{ "required": ["showSerName"] },
+					{ "required": ["showPercent"] },
+					{ "required": ["showBubbleSize"] },
+					{ "required": ["separator"] },
+					{ "required": ["showLeaderLines"] },
+					{ "required": ["leaderLines"] }
+				] } }
+			}],
 			"properties": {
 				"delete": {
-					"description": "Labels deleted at the group level (c:delete inside c:dLbls) — Office writes val=\"0\" explicitly to keep labels on; round-trips the attribute.",
+					"description": "Drop every label for this series (c:delete). Choice vs the shared settings below: `true` ignores them all; `false` keeps labels on and emits its element only when no setting is set (round-trip).",
 					"type": "boolean"
 				},
 				"labels": {
@@ -38435,6 +39295,40 @@ var xlsx_schema_default = {
 			"required": ["spPr"],
 			"type": "object"
 		},
+		"GroupShapePropertiesOptions": {
+			"additionalProperties": false,
+			"description": "Group shape properties. Field order follows the XSD content model. The transform fields come from {@link GroupTransform2DOptions } (flat x/y/width/height/flip/rotation/childOffset/childExtent); the serializer emits them as a single a:xfrm group transform. The container-only `@bwMode` attribute and the wrapping tag are the caller's responsibility (mirrors shapePropertiesDesc).",
+			"properties": {
+				"childExtentHeight": { "anyOf": [{ "type": "number" }, { "$ref": "#/definitions/UniversalMeasure" }] },
+				"childExtentWidth": { "anyOf": [{ "type": "number" }, { "$ref": "#/definitions/UniversalMeasure" }] },
+				"childOffsetX": { "anyOf": [{ "type": "number" }, { "$ref": "#/definitions/UniversalMeasure" }] },
+				"childOffsetY": { "anyOf": [{ "type": "number" }, { "$ref": "#/definitions/UniversalMeasure" }] },
+				"effectDag": { "$ref": "#/definitions/EffectDagOptions" },
+				"effects": {
+					"$ref": "#/definitions/EffectListOptions",
+					"description": "EG_EffectProperties (choice: a:effectDag | a:effectLst)."
+				},
+				"fill": {
+					"$ref": "#/definitions/FillOptions",
+					"description": "EG_FillProperties."
+				},
+				"flipHorizontal": { "type": "boolean" },
+				"flipVertical": { "type": "boolean" },
+				"height": { "anyOf": [{ "type": "number" }, { "$ref": "#/definitions/UniversalMeasure" }] },
+				"rotation": {
+					"description": "Rotation angle in degrees (e.g., 45 = 45°).",
+					"type": "number"
+				},
+				"scene3d": {
+					"$ref": "#/definitions/Scene3DOptions",
+					"description": "a:scene3d."
+				},
+				"width": { "anyOf": [{ "type": "number" }, { "$ref": "#/definitions/UniversalMeasure" }] },
+				"x": { "anyOf": [{ "type": "number" }, { "$ref": "#/definitions/UniversalMeasure" }] },
+				"y": { "anyOf": [{ "type": "number" }, { "$ref": "#/definitions/UniversalMeasure" }] }
+			},
+			"type": "object"
+		},
 		"GroupTransform2DOptions": {
 			"additionalProperties": false,
 			"properties": {
@@ -39311,7 +40205,7 @@ var xlsx_schema_default = {
 			"description": "Options for xl/metadata.xml.",
 			"properties": {
 				"cellMetadata": {
-					"description": "Cell metadata blocks (cellMetadata)",
+					"description": "Cell metadata blocks (cellMetadata). Round-trip only — Excel 365 refuses files carrying these fresh, with or without cell references.",
 					"items": { "$ref": "#/definitions/MetadataBlockOptions" },
 					"type": "array"
 				},
@@ -39336,7 +40230,7 @@ var xlsx_schema_default = {
 					"type": "array"
 				},
 				"valueMetadata": {
-					"description": "Value metadata blocks (valueMetadata)",
+					"description": "Value metadata blocks (valueMetadata). Round-trip only — Excel 365 refuses files carrying these fresh, with or without cell references.",
 					"items": { "$ref": "#/definitions/MetadataBlockOptions" },
 					"type": "array"
 				}
@@ -39454,6 +40348,28 @@ var xlsx_schema_default = {
 			"required": ["name", "minSupportedVersion"],
 			"type": "object"
 		},
+		"NonVisualDrawingPropertiesOptions": {
+			"additionalProperties": false,
+			"description": "Mirrors a: — name/descr/title/hidden. id is runtime; hyperlinks stay package-side.",
+			"properties": {
+				"creationId": {
+					"$ref": "#/definitions/Guid",
+					"description": "a16:creationId `@id` from the cNvPr/docPr extension list — Office's per-object creation stamp, the sole known cNvPr ext content."
+				},
+				"description": { "$ref": "#/definitions/PictureOptions/properties/description" },
+				"ext": { "$ref": "#/definitions/PictureOptions/properties/ext" },
+				"hidden": {
+					"description": "XSD `@hidden` (default false); emitted as \"1\" only when true.",
+					"type": "boolean"
+				},
+				"name": { "$ref": "#/definitions/PictureOptions/properties/name" },
+				"title": {
+					"description": "XSD `@title`.",
+					"type": "string"
+				}
+			},
+			"type": "object"
+		},
 		"NormalAutofitOptions": {
 			"additionalProperties": false,
 			"description": "Normal autofit options.",
@@ -42395,6 +43311,21 @@ var xlsx_schema_default = {
 			},
 			"type": "object"
 		},
+		"RelativeSizeAnchorOptions": {
+			"additionalProperties": false,
+			"description": "Relative anchor (cdr:relSizeAnchor): the object spans from `from` to `to`.",
+			"properties": {
+				"from": { "$ref": "#/definitions/UserShapeMarkerOptions" },
+				"object": { "$ref": "#/definitions/UserShapeObjectOptions" },
+				"to": { "$ref": "#/definitions/UserShapeMarkerOptions" }
+			},
+			"required": [
+				"from",
+				"to",
+				"object"
+			],
+			"type": "object"
+		},
 		"RevisionAction": {
 			"description": "Revision action for comments / custom views.",
 			"enum": ["add", "delete"],
@@ -45064,7 +45995,7 @@ var xlsx_schema_default = {
 					"description": "Auto-filter (ref shorthand or structured filter columns/sort state)"
 				},
 				"columns": {
-					"description": "Column definitions",
+					"description": "Column definitions. Excel requires one per column spanned by `ref`; missing ones auto-fill with default ColumnN names, extras are dropped.",
 					"items": { "$ref": "#/definitions/TableColumnOptions" },
 					"type": "array"
 				},
@@ -45959,6 +46890,22 @@ var xlsx_schema_default = {
 			],
 			"type": "string"
 		},
+		"Transform2DOptions": {
+			"additionalProperties": false,
+			"properties": {
+				"flipHorizontal": { "type": "boolean" },
+				"flipVertical": { "type": "boolean" },
+				"height": { "anyOf": [{ "type": "number" }, { "$ref": "#/definitions/UniversalMeasure" }] },
+				"rotation": {
+					"description": "Rotation angle in degrees (e.g., 45 = 45°).",
+					"type": "number"
+				},
+				"width": { "anyOf": [{ "type": "number" }, { "$ref": "#/definitions/UniversalMeasure" }] },
+				"x": { "anyOf": [{ "type": "number" }, { "$ref": "#/definitions/UniversalMeasure" }] },
+				"y": { "anyOf": [{ "type": "number" }, { "$ref": "#/definitions/UniversalMeasure" }] }
+			},
+			"type": "object"
+		},
 		"TransformEffectOptions": {
 			"additionalProperties": false,
 			"description": "Transform effect — scale, skew, translate.",
@@ -46055,6 +47002,220 @@ var xlsx_schema_default = {
 			"pattern": "^[0-9A-Fa-f]{4}$",
 			"type": "string"
 		},
+		"UserShapeConnectorOptions": {
+			"additionalProperties": false,
+			"properties": {
+				"id": {
+					"description": "cNvPr drawing id (schema-required)",
+					"type": "number"
+				},
+				"macro": {
+					"description": "Macro reference (`@macro`)",
+					"type": "string"
+				},
+				"nonVisualProperties": { "$ref": "#/definitions/NonVisualDrawingPropertiesOptions" },
+				"published": {
+					"description": "Published as a server-side shape (`@fPublished`, default false)",
+					"type": "boolean"
+				},
+				"shapeProperties": { "$ref": "#/definitions/ShapePropertiesOptions" },
+				"style": { "$ref": "#/definitions/DefaultShapeStyleOptions" },
+				"type": {
+					"const": "connector",
+					"type": "string"
+				}
+			},
+			"required": [
+				"id",
+				"shapeProperties",
+				"type"
+			],
+			"type": "object"
+		},
+		"UserShapeExtentOptions": {
+			"additionalProperties": false,
+			"description": "Anchor extent (a:ext): width/height in EMU.",
+			"properties": {
+				"height": { "type": "number" },
+				"width": { "type": "number" }
+			},
+			"required": ["width", "height"],
+			"type": "object"
+		},
+		"UserShapeGraphicFrameOptions": {
+			"additionalProperties": false,
+			"properties": {
+				"graphic": {
+					"description": "Verbatim a:graphic XML payload. The graphic contents (chart/table references) are package-wired; the part body carries them unchanged.",
+					"type": "string"
+				},
+				"graphicFrameLocks": {
+					"anyOf": [{ "$ref": "#/definitions/GraphicFrameLockingOptions" }, { "type": "null" }],
+					"description": "Frame locking flags (cdr:cNvGraphicFramePr)"
+				},
+				"id": {
+					"description": "cNvPr drawing id (schema-required)",
+					"type": "number"
+				},
+				"macro": {
+					"description": "Macro reference (`@macro`)",
+					"type": "string"
+				},
+				"nonVisualProperties": { "$ref": "#/definitions/NonVisualDrawingPropertiesOptions" },
+				"published": {
+					"description": "Published as a server-side shape (`@fPublished`, default false)",
+					"type": "boolean"
+				},
+				"transform": {
+					"$ref": "#/definitions/Transform2DOptions",
+					"description": "Placement transform (cdr:xfrm)"
+				},
+				"type": {
+					"const": "graphicFrame",
+					"type": "string"
+				}
+			},
+			"required": [
+				"graphic",
+				"id",
+				"transform",
+				"type"
+			],
+			"type": "object"
+		},
+		"UserShapeGroupOptions": {
+			"additionalProperties": false,
+			"properties": {
+				"children": {
+					"items": { "$ref": "#/definitions/UserShapeObjectOptions" },
+					"type": "array"
+				},
+				"groupShapeProperties": { "$ref": "#/definitions/GroupShapePropertiesOptions" },
+				"id": {
+					"description": "cNvPr drawing id (schema-required)",
+					"type": "number"
+				},
+				"macro": {
+					"description": "Macro reference (`@macro`)",
+					"type": "string"
+				},
+				"nonVisualProperties": { "$ref": "#/definitions/NonVisualDrawingPropertiesOptions" },
+				"published": {
+					"description": "Published as a server-side shape (`@fPublished`, default false)",
+					"type": "boolean"
+				},
+				"type": {
+					"const": "group",
+					"type": "string"
+				}
+			},
+			"required": [
+				"children",
+				"groupShapeProperties",
+				"id",
+				"type"
+			],
+			"type": "object"
+		},
+		"UserShapeMarkerOptions": {
+			"additionalProperties": false,
+			"description": "Anchor marker: x/y as 0.0–1.0 fractions of the chart area.",
+			"properties": {
+				"x": { "type": "number" },
+				"y": { "type": "number" }
+			},
+			"required": ["x", "y"],
+			"type": "object"
+		},
+		"UserShapeObjectOptions": { "anyOf": [
+			{ "$ref": "#/definitions/UserShapeShapeOptions" },
+			{ "$ref": "#/definitions/UserShapeConnectorOptions" },
+			{ "$ref": "#/definitions/UserShapePictureOptions" },
+			{ "$ref": "#/definitions/UserShapeGraphicFrameOptions" },
+			{ "$ref": "#/definitions/UserShapeGroupOptions" }
+		] },
+		"UserShapePictureOptions": {
+			"additionalProperties": false,
+			"properties": {
+				"blipFill": { "$ref": "#/definitions/BlipFillOptions" },
+				"id": {
+					"description": "cNvPr drawing id (schema-required)",
+					"type": "number"
+				},
+				"macro": {
+					"description": "Macro reference (`@macro`)",
+					"type": "string"
+				},
+				"nonVisualProperties": { "$ref": "#/definitions/NonVisualDrawingPropertiesOptions" },
+				"published": {
+					"description": "Published as a server-side shape (`@fPublished`, default false)",
+					"type": "boolean"
+				},
+				"referenceId": {
+					"description": "Image reference key (a:blip r:embed via the relationship placeholder)",
+					"type": "string"
+				},
+				"shapeProperties": { "$ref": "#/definitions/ShapePropertiesOptions" },
+				"style": { "$ref": "#/definitions/DefaultShapeStyleOptions" },
+				"type": {
+					"const": "picture",
+					"type": "string"
+				}
+			},
+			"required": [
+				"id",
+				"referenceId",
+				"shapeProperties",
+				"type"
+			],
+			"type": "object"
+		},
+		"UserShapeShapeOptions": {
+			"additionalProperties": false,
+			"properties": {
+				"id": {
+					"description": "cNvPr drawing id (schema-required)",
+					"type": "number"
+				},
+				"locksText": {
+					"description": "Text locking (`@fLocksText`, default true)",
+					"type": "boolean"
+				},
+				"macro": {
+					"description": "Macro reference (`@macro`)",
+					"type": "string"
+				},
+				"nonVisualProperties": {
+					"$ref": "#/definitions/NonVisualDrawingPropertiesOptions",
+					"description": "cNvPr — id is required by the schema"
+				},
+				"published": {
+					"description": "Published as a server-side shape (`@fPublished`, default false)",
+					"type": "boolean"
+				},
+				"shapeProperties": { "$ref": "#/definitions/ShapePropertiesOptions" },
+				"style": { "$ref": "#/definitions/DefaultShapeStyleOptions" },
+				"textBody": { "$ref": "#/definitions/TextBodyOptions" },
+				"textBox": {
+					"description": "Text-box marker (cdr:cNvSpPr `@txBox`)",
+					"type": "boolean"
+				},
+				"textLink": {
+					"description": "Formula linking the text to a cell (`@textlink`)",
+					"type": "string"
+				},
+				"type": {
+					"const": "shape",
+					"type": "string"
+				}
+			},
+			"required": [
+				"id",
+				"shapeProperties",
+				"type"
+			],
+			"type": "object"
+		},
 		"UsersOptions": {
 			"additionalProperties": false,
 			"description": "Options for xl/users.xml.",
@@ -46512,6 +47673,7 @@ var xlsx_schema_default = {
 					"type": "array"
 				},
 				"customWorkbookViews": {
+					"description": "Workbook-level custom view snapshots. Excel requires one entry per sheet-level customSheetViews guid (matched by guid).",
 					"items": { "$ref": "#/definitions/CustomWorkbookViewOptions" },
 					"type": "array"
 				},
@@ -47308,8 +48470,8 @@ var xlsx_schema_default = {
 					"type": "number"
 				},
 				"userShapes": {
-					"description": "User-drawn shapes relationship id (c:userShapes r:id, after printSettings).",
-					"type": "string"
+					"$ref": "#/definitions/ChartUserShapesOptions",
+					"description": "User-drawn shapes layered over the chart (c:userShapes, after printSettings)."
 				},
 				"varyColors": {
 					"description": "Vary data-point colors (chart-group-level c:varyColors). Emitted only when set — the corpus is mixed and fresh output stays bare.",
@@ -47387,7 +48549,7 @@ var xlsx_schema_default = {
 					"type": "array"
 				},
 				"customSheetViews": {
-					"description": "Custom sheet views",
+					"description": "Custom sheet views. Each guid needs a same-guid workbook-level customWorkbookViews entry — Excel refuses orphans.",
 					"items": { "$ref": "#/definitions/CustomSheetViewOptions" },
 					"type": "array"
 				},
@@ -48946,4 +50108,4 @@ function renderSliceTypeText(format, requested, slice) {
 //#endregion
 export { xlsxSchema as _, sliceDocumentSchema as a, pointerHost as c, SCHEMA_ROOTS as d, entryNames as f, validateDocumentInput as g, pptxSchema as h, assertKnownDefinitions as i, resolvePointer as l, docxSchema as m, getSkeletonSchema as n, sliceSchema as o, SCHEMAS as p, UnknownDefinitionError as r, isPropertyPointer as s, renderSliceTypeText as t, SCHEMA_ENTRIES as u };
 
-//# sourceMappingURL=schemas-DhCWsZ8v.mjs.map
+//# sourceMappingURL=schemas-B400scMm.mjs.map