office-open 0.12.0 → 0.12.2

package/schemas/docx.schema.json

@@ -3,6 +3,23 @@
   "$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.",
@@ -1206,6 +1223,33 @@
       },
       "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)."
@@ -2643,8 +2687,8 @@
           "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.",
@@ -3095,7 +3139,8 @@
           "$ref": "#/definitions/ChartOptions/properties/upDownBarsGapWidth"
         },
         "userShapes": {
-          "$ref": "#/definitions/ChartOptions/properties/userShapes"
+          "$ref": "#/definitions/ChartUserShapesOptions",
+          "description": "User-drawn shapes layered over the chart (c:userShapes, after printSettings)."
         },
         "varyColors": {
           "$ref": "#/definitions/ChartOptions/properties/varyColors"
@@ -3184,6 +3229,32 @@
       ],
       "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.",
@@ -4792,9 +4863,66 @@
     },
     "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": {
@@ -5472,12 +5600,10 @@
           "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"
+          "$ref": "#/definitions/NonVisualDrawingPropertiesOptions/properties/description"
         },
         "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"
+          "$ref": "#/definitions/NonVisualDrawingPropertiesOptions/properties/ext"
         },
         "hidden": {
           "description": "XSD `@hidden` (default false); emitted as \"1\" only when true.",
@@ -7402,6 +7528,30 @@
       "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.",
@@ -7686,10 +7836,10 @@
                   "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"
+                  "$ref": "#/definitions/NonVisualDrawingPropertiesOptions/properties/description"
                 },
                 "ext": {
-                  "$ref": "#/definitions/DocPropertiesOptions/properties/ext"
+                  "$ref": "#/definitions/NonVisualDrawingPropertiesOptions/properties/ext"
                 },
                 "hidden": {
                   "description": "XSD `@hidden` (default false); emitted as \"1\" only when true.",
@@ -7699,7 +7849,7 @@
                   "type": "number"
                 },
                 "name": {
-                  "$ref": "#/definitions/NonVisualPropertiesOptions/properties/name"
+                  "$ref": "#/definitions/NonVisualDrawingPropertiesOptions/properties/name"
                 },
                 "pictureLocks": {
                   "$ref": "#/definitions/NonVisualPropertiesOptions/properties/pictureLocks"
@@ -7826,6 +7976,118 @@
       },
       "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}"],
@@ -10669,6 +10931,37 @@
       },
       "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": {
+          "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"
+        },
+        "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).",
@@ -10678,10 +10971,10 @@
           "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"
+          "$ref": "#/definitions/NonVisualDrawingPropertiesOptions/properties/description"
         },
         "ext": {
-          "$ref": "#/definitions/DocPropertiesOptions/properties/ext"
+          "$ref": "#/definitions/NonVisualDrawingPropertiesOptions/properties/ext"
         },
         "hidden": {
           "description": "XSD `@hidden` (default false); emitted as \"1\" only when true.",
@@ -10691,8 +10984,7 @@
           "type": "number"
         },
         "name": {
-          "description": "XSD `@name` (required in XML); API-optional, the descriptor synthesizes a fallback.",
-          "type": "string"
+          "$ref": "#/definitions/NonVisualDrawingPropertiesOptions/properties/name"
         },
         "pictureLocks": {
           "anyOf": [
@@ -15053,6 +15345,23 @@
       },
       "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.",
@@ -22509,6 +22818,62 @@
       ],
       "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.",
@@ -22610,6 +22975,252 @@
       "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.",