office-open 0.12.0 → 0.12.2

package/schemas/xlsx.schema.json

@@ -3,6 +3,23 @@
   "$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": [
         {
@@ -845,6 +862,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"
+    },
     "BlurEffectOptions": {
       "additionalProperties": false,
       "description": "Blur effect options.",
@@ -2531,7 +2575,8 @@
           "$ref": "#/definitions/WorksheetChartOptions/properties/upDownBarsGapWidth"
         },
         "userShapes": {
-          "$ref": "#/definitions/WorksheetChartOptions/properties/userShapes"
+          "$ref": "#/definitions/ChartUserShapesOptions",
+          "description": "User-drawn shapes layered over the chart (c:userShapes, after printSettings)."
         },
         "varyColors": {
           "$ref": "#/definitions/WorksheetChartOptions/properties/varyColors"
@@ -2620,6 +2665,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"
+    },
     "ChartsheetOptions": {
       "additionalProperties": false,
       "description": "A chart sheet (xl/chartsheets/sheetN.xml) — a full-sheet chart with its own view state.",
@@ -4344,9 +4415,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": {
@@ -6755,6 +6883,118 @@
       "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": {
@@ -7766,7 +8006,7 @@
       "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"
           },
@@ -7801,7 +8041,7 @@
           "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"
           },
@@ -7957,6 +8197,34 @@
       "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.",
@@ -11231,6 +11499,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"
+    },
     "RevisionAction": {
       "description": "Revision action for comments / custom views.",
       "enum": ["add", "delete"],
@@ -14123,7 +14408,7 @@
           "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"
           },
@@ -15225,6 +15510,62 @@
       ],
       "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.",
@@ -15326,6 +15667,252 @@
       "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.",
@@ -15820,6 +16407,7 @@
           "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"
           },
@@ -16791,8 +17379,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.",
@@ -16892,7 +17480,7 @@
           "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"
           },