office-open 0.12.2 → 0.13.0

package/schemas/pptx.schema.json

@@ -1436,7 +1436,7 @@
           "$ref": "#/definitions/ShapeOptions/properties/description"
         },
         "ext": {
-          "$ref": "#/definitions/PictureOptions/properties/ext"
+          "$ref": "#/definitions/ShapeOptions/properties/ext"
         },
         "fileName": {
           "$ref": "#/definitions/VideoFrameOptions/properties/fileName"
@@ -2071,6 +2071,10 @@
           "$ref": "#/definitions/BlipEffectsOptions",
           "description": "Image adjustment effects (brightness, contrast, grayscale, etc.)"
         },
+        "compression": {
+          "$ref": "#/definitions/BlipCompression",
+          "description": "Compression state, lifted from the a:blip child's"
+        },
         "dpi": {
           "description": "DPI of the image",
           "type": "number"
@@ -2332,7 +2336,7 @@
           "$ref": "#/definitions/ChartSeriesData/properties/order"
         },
         "pictureOptions": {
-          "$ref": "#/definitions/PictureOptionsOptions",
+          "$ref": "#/definitions/ChartPictureOptions",
           "description": "Picture-fill options (c:pictureOptions, bar/area)."
         },
         "shape": {
@@ -2704,9 +2708,8 @@
           "description": "Hex color string sugar, or a full fill (scheme colors, gradients)."
         },
         "dashStyle": {
-          "description": "Dash pattern: \"lgDash\" long dashes, \"sysDot\"/\"sysDash\" system-defined dot/dash.",
-          "enum": ["solid", "dash", "dashDot", "lgDash", "sysDot", "sysDash"],
-          "type": "string"
+          "$ref": "#/definitions/PresetDash",
+          "description": "Dash pattern sugar — same value set as `OutlineOptions.dash`; \"solid\" = a continuous line."
         },
         "outline": {
           "$ref": "#/definitions/OutlineOptions",
@@ -3361,6 +3364,29 @@
       },
       "type": "object"
     },
+    "ChartPictureOptions": {
+      "additionalProperties": false,
+      "description": "Picture-fill options for bar/area series.",
+      "properties": {
+        "applyToEnd": {
+          "type": "boolean"
+        },
+        "applyToFront": {
+          "type": "boolean"
+        },
+        "applyToSides": {
+          "type": "boolean"
+        },
+        "pictureFormat": {
+          "$ref": "#/definitions/PictureFormat"
+        },
+        "pictureStackUnit": {
+          "description": "Stack unit (c:pictureStackUnit val).",
+          "type": "number"
+        }
+      },
+      "type": "object"
+    },
     "ChartPivotFormatOptions": {
       "additionalProperties": false,
       "description": "Per-series pivot format override.",
@@ -3436,7 +3462,7 @@
           "type": "number"
         },
         "pictureOptions": {
-          "$ref": "#/definitions/PictureOptionsOptions",
+          "$ref": "#/definitions/ChartPictureOptions",
           "description": "Picture-fill options (c:pictureOptions, bar/area)."
         },
         "shape": {
@@ -3981,11 +4007,6 @@
       "enum": ["single", "double", "thickThin", "thinThick", "triple"],
       "type": "string"
     },
-    "CompoundLineType": {
-      "description": "Compound line type (,",
-      "enum": ["single", "double", "thickThin", "thinThick", "triple"],
-      "type": "string"
-    },
     "ConditionFunction": {
       "description": "(dgm:if `@func`).",
       "enum": ["cnt", "pos", "revPos", "posEven", "posOdd", "var", "depth", "maxDepth"],
@@ -4016,7 +4037,7 @@
     },
     "ConnectorOptions": {
       "additionalProperties": false,
-      "description": "Connector options for pptx slides (p:cxnSp). The cNvPr + locking + endpoint connection fields come from `BaseConnectorOptions`; the rest is the pptx two-endpoint positioning model plus line fill/outline.",
+      "description": "Connector options for pptx slides (p:cxnSp). The cNvPr + locking + endpoint connection fields come from `BaseConnectorOptions`; the rest is the pptx two-endpoint positioning model plus the connector paint.",
       "properties": {
         "creationId": {
           "$ref": "#/definitions/Guid",
@@ -4025,30 +4046,12 @@
         "description": {
           "$ref": "#/definitions/ShapeOptions/properties/description"
         },
-        "effects": {
-          "$ref": "#/definitions/EffectListOptions",
-          "description": "Effect list (a:effectLst) inside spPr. An empty object emits the bare element."
-        },
         "endConnection": {
           "$ref": "#/definitions/EndpointConnectionOptions",
           "description": "a:endCxn — end endpoint glued to a shape connection site."
         },
         "ext": {
-          "$ref": "#/definitions/PictureOptions/properties/ext"
-        },
-        "fill": {
-          "$ref": "#/definitions/FillOptions"
-        },
-        "geometry": {
-          "anyOf": [
-            {
-              "$ref": "#/definitions/ShapeType"
-            },
-            {
-              "$ref": "#/definitions/PresetGeometryOptions"
-            }
-          ],
-          "description": "Connector preset geometry (a:prstGeom"
+          "$ref": "#/definitions/ShapeOptions/properties/ext"
         },
         "hidden": {
           "description": "XSD `@hidden` (default false); emitted as \"1\" only when true.",
@@ -4064,16 +4067,9 @@
         "name": {
           "$ref": "#/definitions/ShapeOptions/properties/name"
         },
-        "outline": {
-          "$ref": "#/definitions/OutlineOptions"
-        },
-        "scene3d": {
-          "$ref": "#/definitions/Scene3DOptions",
-          "description": "3D scene (a:scene3d) inside spPr."
-        },
-        "shape3d": {
-          "$ref": "#/definitions/Shape3DOptions",
-          "description": "3D shape properties (a:sp3d) inside spPr."
+        "properties": {
+          "$ref": "#/definitions/ConnectorShapeProperties",
+          "description": "Connector paint (a:spPr children): geometry/fill/outline/effects/3D. The endpoint model defaults to \"line\"; source connectors often use bentConnector/elbowConnector forms with adjusted values. Endpoints stay top-level."
         },
         "startConnection": {
           "$ref": "#/definitions/EndpointConnectionOptions",
@@ -4130,6 +4126,46 @@
       },
       "type": "object"
     },
+    "ConnectorShapeProperties": {
+      "additionalProperties": false,
+      "description": "Connector paint adds the preset geometry to the shared endpoint paint.",
+      "properties": {
+        "effects": {
+          "$ref": "#/definitions/EffectListOptions"
+        },
+        "fill": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FillOptions"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "geometry": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/ShapeType"
+            },
+            {
+              "$ref": "#/definitions/PresetGeometryOptions"
+            }
+          ],
+          "description": "Connector preset geometry (a:prstGeom"
+        },
+        "outline": {
+          "$ref": "#/definitions/OutlineOptions"
+        },
+        "scene3d": {
+          "$ref": "#/definitions/Scene3DOptions"
+        },
+        "shape3d": {
+          "$ref": "#/definitions/Shape3DOptions"
+        }
+      },
+      "type": "object"
+    },
     "ConstraintOperator": {
       "description": "(dgm:constr `@op`).",
       "enum": ["none", "equ", "gte", "lte"],
@@ -4704,7 +4740,7 @@
           "$ref": "#/definitions/MarkerOptions"
         },
         "pictureOptions": {
-          "$ref": "#/definitions/PictureOptionsOptions"
+          "$ref": "#/definitions/ChartPictureOptions"
         },
         "shapeProperties": {
           "$ref": "#/definitions/ShapePropertiesOptions",
@@ -5269,6 +5305,35 @@
       "required": ["id", "index"],
       "type": "object"
     },
+    "EndpointShapeProperties": {
+      "additionalProperties": false,
+      "description": "spPr paint children carried by endpoint-model shapes (p:sp line, p:cxnSp).",
+      "properties": {
+        "effects": {
+          "$ref": "#/definitions/EffectListOptions"
+        },
+        "fill": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FillOptions"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "outline": {
+          "$ref": "#/definitions/OutlineOptions"
+        },
+        "scene3d": {
+          "$ref": "#/definitions/Scene3DOptions"
+        },
+        "shape3d": {
+          "$ref": "#/definitions/Shape3DOptions"
+        }
+      },
+      "type": "object"
+    },
     "ErrorBarDirection": {
       "description": "Which axes the error bars span: both, x only, or y only.",
       "enum": ["x", "y"],
@@ -5497,6 +5562,10 @@
               "$ref": "#/definitions/BlipEffectsOptions",
               "description": "Image adjustment effects (brightness, contrast, grayscale, etc.)"
             },
+            "compression": {
+              "$ref": "#/definitions/BlipCompression",
+              "description": "Compression state (a:blip"
+            },
             "data": {
               "$ref": "#/definitions/DataType",
               "description": "Image data: raw bytes, ArrayBuffer, or a base64 data URL string."
@@ -5845,9 +5914,9 @@
           "description": "Shade type (linear or path)"
         },
         "stops": {
-          "description": "Gradient color stops (minimum 2)",
+          "description": "Gradient color stops (minimum 2); color accepts a hex string or SolidFillOptions",
           "items": {
-            "$ref": "#/definitions/GradientStop"
+            "$ref": "#/definitions/GradientStopOptions"
           },
           "type": "array"
         },
@@ -5870,22 +5939,6 @@
       ],
       "description": "Gradient shade options (linear or path)."
     },
-    "GradientStop": {
-      "additionalProperties": false,
-      "description": "Gradient stop position as integer percent (0-100).",
-      "properties": {
-        "color": {
-          "$ref": "#/definitions/SolidFillOptions",
-          "description": "Color at this stop"
-        },
-        "position": {
-          "description": "Position of the color stop as integer percent (0-100).",
-          "type": "number"
-        }
-      },
-      "required": ["position", "color"],
-      "type": "object"
-    },
     "GradientStopOptions": {
       "additionalProperties": false,
       "description": "Gradient stop options (simplified API). Position is 0-100 (percentage), color is a hex string or SolidFillOptions.",
@@ -5960,67 +6013,23 @@
     },
     "GroupOptions": {
       "additionalProperties": false,
-      "description": "Group shape (p:grpSp) for pptx slides. cNvPr fields from BaseGroupOptions; the rest is the pptx flat positioning model plus the group's children.",
+      "description": "Group shape (p:grpSp) for pptx slides. cNvPr fields from BaseGroupOptions; transform fields (incl. the child coordinate system, a:chOff/a:chExt) from GroupTransform2DOptions — an unset chOff/chExt stringifies to the group offset/extent. The rest is the group-level paint plus the children.",
       "properties": {
         "blackWhiteMode": {
           "$ref": "#/definitions/BlackWhiteMode",
           "description": "`@bwMode` on `p:grpSpPr` — how the group renders in black-and-white mode."
         },
-        "childExtent": {
-          "additionalProperties": false,
-          "description": "Child coordinate system extent (a:chExt). Defaults to {width,height} when omitted.",
-          "properties": {
-            "cx": {
-              "anyOf": [
-                {
-                  "type": "number"
-                },
-                {
-                  "$ref": "#/definitions/UniversalMeasure"
-                }
-              ]
-            },
-            "cy": {
-              "anyOf": [
-                {
-                  "type": "number"
-                },
-                {
-                  "$ref": "#/definitions/UniversalMeasure"
-                }
-              ]
-            }
-          },
-          "required": ["cx", "cy"],
-          "type": "object"
+        "childExtentHeight": {
+          "$ref": "#/definitions/GroupShapePropertiesOptions/properties/childExtentHeight"
         },
-        "childOffset": {
-          "additionalProperties": false,
-          "description": "Child coordinate system offset (a:chOff). Defaults to {x,y} when omitted.",
-          "properties": {
-            "x": {
-              "anyOf": [
-                {
-                  "type": "number"
-                },
-                {
-                  "$ref": "#/definitions/UniversalMeasure"
-                }
-              ]
-            },
-            "y": {
-              "anyOf": [
-                {
-                  "type": "number"
-                },
-                {
-                  "$ref": "#/definitions/UniversalMeasure"
-                }
-              ]
-            }
-          },
-          "required": ["x", "y"],
-          "type": "object"
+        "childExtentWidth": {
+          "$ref": "#/definitions/GroupShapePropertiesOptions/properties/childExtentWidth"
+        },
+        "childOffsetX": {
+          "$ref": "#/definitions/GroupShapePropertiesOptions/properties/childOffsetX"
+        },
+        "childOffsetY": {
+          "$ref": "#/definitions/GroupShapePropertiesOptions/properties/childOffsetY"
         },
         "children": {
           "items": {
@@ -6040,7 +6049,7 @@
           "description": "Group-level effects (EG_EffectProperties on grpSpPr)."
         },
         "ext": {
-          "$ref": "#/definitions/PictureOptions/properties/ext"
+          "$ref": "#/definitions/ShapeOptions/properties/ext"
         },
         "fill": {
           "$ref": "#/definitions/FillOptions",
@@ -6050,7 +6059,6 @@
           "type": "boolean"
         },
         "flipVertical": {
-          "description": "Flip vertically (a:xfrm `@flipV`).",
           "type": "boolean"
         },
         "height": {
@@ -6129,7 +6137,7 @@
     },
     "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).",
+      "description": "Group shape properties. Transform fields serialize as one a:xfrm group transform; container-only `@bwMode` and the wrapping tag are the caller's responsibility.",
       "properties": {
         "childExtentHeight": {
           "anyOf": [
@@ -6139,7 +6147,8 @@
             {
               "$ref": "#/definitions/UniversalMeasure"
             }
-          ]
+          ],
+          "description": "Child coordinate system extent height (a:chExt"
         },
         "childExtentWidth": {
           "anyOf": [
@@ -6149,7 +6158,8 @@
             {
               "$ref": "#/definitions/UniversalMeasure"
             }
-          ]
+          ],
+          "description": "Child coordinate system extent width (a:chExt"
         },
         "childOffsetX": {
           "anyOf": [
@@ -6159,7 +6169,8 @@
             {
               "$ref": "#/definitions/UniversalMeasure"
             }
-          ]
+          ],
+          "description": "Child coordinate system offset X (a:chOff"
         },
         "childOffsetY": {
           "anyOf": [
@@ -6169,7 +6180,8 @@
             {
               "$ref": "#/definitions/UniversalMeasure"
             }
-          ]
+          ],
+          "description": "Child coordinate system offset Y (a:chOff"
         },
         "effectDag": {
           "$ref": "#/definitions/EffectDagOptions"
@@ -6795,95 +6807,26 @@
       "type": "object"
     },
     "LayoutPlaceholderOptions": {
+      "$ref": "#/definitions/PlaceholderMapOptions",
+      "description": "Placeholder slot map — `false` hides the slot, a definition overrides its position and facets, omitted shows the default. Same value shape as `MasterPlaceholderOptions`."
+    },
+    "LayoutRuleOptions": {
       "additionalProperties": false,
-      "description": "Placeholder slot map — `false` hides the slot, a definition overrides its position and facets, omitted shows the default. Same value shape as `MasterPlaceholderOptions`.",
+      "description": "dgm:rule.",
       "properties": {
-        "body": {
-          "anyOf": [
-            {
-              "$ref": "#/definitions/PlaceholderDefinition"
-            },
-            {
-              "const": false,
-              "type": "boolean"
-            }
-          ]
+        "factor": {
+          "description": "Multiplied factor (dgm:rule `@fact`).",
+          "type": "number"
         },
-        "date": {
-          "anyOf": [
-            {
-              "$ref": "#/definitions/PlaceholderDefinition"
-            },
-            {
-              "const": false,
-              "type": "boolean"
-            }
-          ]
+        "for": {
+          "$ref": "#/definitions/ConstraintRelationship"
         },
-        "footer": {
-          "anyOf": [
-            {
-              "$ref": "#/definitions/PlaceholderDefinition"
-            },
-            {
-              "const": false,
-              "type": "boolean"
-            }
-          ]
+        "forName": {
+          "type": "string"
         },
-        "slideNumber": {
-          "anyOf": [
-            {
-              "$ref": "#/definitions/PlaceholderDefinition"
-            },
-            {
-              "const": false,
-              "type": "boolean"
-            }
-          ]
-        },
-        "subtitle": {
-          "anyOf": [
-            {
-              "$ref": "#/definitions/PlaceholderDefinition"
-            },
-            {
-              "const": false,
-              "type": "boolean"
-            }
-          ]
-        },
-        "title": {
-          "anyOf": [
-            {
-              "$ref": "#/definitions/PlaceholderDefinition"
-            },
-            {
-              "const": false,
-              "type": "boolean"
-            }
-          ]
-        }
-      },
-      "type": "object"
-    },
-    "LayoutRuleOptions": {
-      "additionalProperties": false,
-      "description": "dgm:rule.",
-      "properties": {
-        "factor": {
-          "description": "Multiplied factor (dgm:rule `@fact`).",
-          "type": "number"
-        },
-        "for": {
-          "$ref": "#/definitions/ConstraintRelationship"
-        },
-        "forName": {
-          "type": "string"
-        },
-        "maximum": {
-          "description": "Upper bound (dgm:rule `@max`).",
-          "type": "number"
+        "maximum": {
+          "description": "Upper bound (dgm:rule `@max`).",
+          "type": "number"
         },
         "pointType": {
           "type": "string"
@@ -7104,15 +7047,8 @@
         "description": {
           "$ref": "#/definitions/ShapeOptions/properties/description"
         },
-        "effects": {
-          "$ref": "#/definitions/EffectListOptions",
-          "description": "Effect list (a:effectLst) inside spPr. An empty object emits the bare element."
-        },
         "ext": {
-          "$ref": "#/definitions/PictureOptions/properties/ext"
-        },
-        "fill": {
-          "$ref": "#/definitions/FillOptions"
+          "$ref": "#/definitions/ShapeOptions/properties/ext"
         },
         "hidden": {
           "description": "XSD `@hidden` (default false); emitted as \"1\" only when true.",
@@ -7128,16 +7064,9 @@
         "name": {
           "$ref": "#/definitions/ShapeOptions/properties/name"
         },
-        "outline": {
-          "$ref": "#/definitions/OutlineOptions"
-        },
-        "scene3d": {
-          "$ref": "#/definitions/Scene3DOptions",
-          "description": "3D scene (a:scene3d) inside spPr."
-        },
-        "shape3d": {
-          "$ref": "#/definitions/Shape3DOptions",
-          "description": "3D shape properties (a:sp3d) inside spPr."
+        "properties": {
+          "$ref": "#/definitions/EndpointShapeProperties",
+          "description": "Line paint (a:spPr children): fill/outline/effects/3D. Endpoints stay top-level — direction is encoded as xfrm flip, not an owner transform."
         },
         "style": {
           "$ref": "#/definitions/ShapeStyleOptions",
@@ -7227,7 +7156,7 @@
           "$ref": "#/definitions/ShapeOptions/properties/description"
         },
         "ext": {
-          "$ref": "#/definitions/PictureOptions/properties/ext"
+          "$ref": "#/definitions/ShapeOptions/properties/ext"
         },
         "hasCustomPrompt": {
           "type": "boolean"
@@ -7334,13 +7263,20 @@
           "$ref": "#/definitions/EffectListOptions"
         },
         "ext": {
-          "$ref": "#/definitions/ShapePropertiesOptions/properties/ext"
+          "$ref": "#/definitions/ShapeOptions/properties/properties/properties/ext"
         },
         "extensions": {
-          "$ref": "#/definitions/ShapePropertiesOptions/properties/extensions"
+          "$ref": "#/definitions/ShapeOptions/properties/properties/properties/extensions"
         },
         "fill": {
-          "$ref": "#/definitions/FillOptions"
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FillOptions"
+            },
+            {
+              "type": "null"
+            }
+          ]
         },
         "flipHorizontal": {
           "type": "boolean"
@@ -7626,65 +7562,7 @@
       "type": "object"
     },
     "MasterPlaceholderOptions": {
-      "additionalProperties": false,
-      "properties": {
-        "body": {
-          "anyOf": [
-            {
-              "$ref": "#/definitions/PlaceholderDefinition"
-            },
-            {
-              "const": false,
-              "type": "boolean"
-            }
-          ]
-        },
-        "date": {
-          "anyOf": [
-            {
-              "$ref": "#/definitions/PlaceholderDefinition"
-            },
-            {
-              "const": false,
-              "type": "boolean"
-            }
-          ]
-        },
-        "footer": {
-          "anyOf": [
-            {
-              "$ref": "#/definitions/PlaceholderDefinition"
-            },
-            {
-              "const": false,
-              "type": "boolean"
-            }
-          ]
-        },
-        "slideNumber": {
-          "anyOf": [
-            {
-              "$ref": "#/definitions/PlaceholderDefinition"
-            },
-            {
-              "const": false,
-              "type": "boolean"
-            }
-          ]
-        },
-        "title": {
-          "anyOf": [
-            {
-              "$ref": "#/definitions/PlaceholderDefinition"
-            },
-            {
-              "const": false,
-              "type": "boolean"
-            }
-          ]
-        }
-      },
-      "type": "object"
+      "$ref": "#/definitions/PlaceholderMapOptions"
     },
     "MediaAnimationType": {
       "description": "Media playback action: playAudio, playVideo, or \"play\" (media-type-agnostic).",
@@ -7848,7 +7726,7 @@
           "$ref": "#/definitions/ShapeOptions/properties/description"
         },
         "ext": {
-          "$ref": "#/definitions/PictureOptions/properties/ext"
+          "$ref": "#/definitions/ShapeOptions/properties/ext"
         },
         "hidden": {
           "description": "XSD `@hidden` (default false); emitted as \"1\" only when true.",
@@ -8151,7 +8029,7 @@
           "description": "Embedded OLE object (binary registered as ppt/embeddings/oleObjectN.bin). Mutually exclusive with `link` — p:oleObj's content model is a required choice between p:embed and p:link."
         },
         "ext": {
-          "$ref": "#/definitions/PictureOptions/properties/ext"
+          "$ref": "#/definitions/ShapeOptions/properties/ext"
         },
         "hasCustomPrompt": {
           "type": "boolean"
@@ -8817,8 +8695,7 @@
           "description": "Shape-level effects on p:spPr (e.g. shadow/reflection)."
         },
         "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/ShapeOptions/properties/ext"
         },
         "fileName": {
           "description": "Media file name inside the package (ppt/media/<fileName>). Round-trip keeps the source name; fresh generation derives it from the shape name.",
@@ -8954,178 +8831,334 @@
           "description": "p:nvPr `@userDrawn`.",
           "type": "boolean"
         },
-        "width": {
+        "width": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/UniversalMeasure"
+            }
+          ]
+        },
+        "x": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/UniversalMeasure"
+            }
+          ]
+        },
+        "y": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/UniversalMeasure"
+            }
+          ]
+        }
+      },
+      "required": ["type"],
+      "type": "object"
+    },
+    "PivotSourceOptions": {
+      "additionalProperties": false,
+      "description": "Pivot chart source.",
+      "properties": {
+        "formatId": {
+          "type": "number"
+        },
+        "name": {
+          "type": "string"
+        }
+      },
+      "required": ["name", "formatId"],
+      "type": "object"
+    },
+    "PlaceholderDefinition": {
+      "additionalProperties": false,
+      "description": "Complete placeholder template on a master/layout: position, inheritable facets, and cNvPr fields (a16:creationId) so a re-emitted placeholder keeps its identity. Accepts the old flat x/y/width/height shape.",
+      "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."
+        },
+        "customGeometry": {
+          "$ref": "#/definitions/CustomGeometryOptions"
+        },
+        "description": {
+          "$ref": "#/definitions/ShapeOptions/properties/description"
+        },
+        "effects": {
+          "$ref": "#/definitions/EffectListOptions"
+        },
+        "ext": {
+          "$ref": "#/definitions/ShapeOptions/properties/ext"
+        },
+        "fill": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FillOptions"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "geometry": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/ShapeType"
+            },
+            {
+              "$ref": "#/definitions/PresetGeometryOptions"
+            }
+          ]
+        },
+        "height": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/UniversalMeasure"
+            }
+          ]
+        },
+        "hidden": {
+          "description": "XSD `@hidden` (default false); emitted as \"1\" only when true.",
+          "type": "boolean"
+        },
+        "name": {
+          "$ref": "#/definitions/ShapeOptions/properties/name"
+        },
+        "outline": {
+          "$ref": "#/definitions/OutlineOptions"
+        },
+        "scene3d": {
+          "$ref": "#/definitions/Scene3DOptions"
+        },
+        "shape3d": {
+          "$ref": "#/definitions/Shape3DOptions"
+        },
+        "style": {
+          "$ref": "#/definitions/ShapeStyleOptions"
+        },
+        "textBody": {
+          "$ref": "#/definitions/TextBodyOptions"
+        },
+        "title": {
+          "description": "XSD `@title`.",
+          "type": "string"
+        },
+        "width": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/UniversalMeasure"
+            }
+          ]
+        },
+        "x": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/UniversalMeasure"
+            }
+          ]
+        },
+        "y": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/UniversalMeasure"
+            }
+          ]
+        }
+      },
+      "required": ["height", "width", "x", "y"],
+      "type": "object"
+    },
+    "PlaceholderMapOptions": {
+      "additionalProperties": false,
+      "description": "Placeholder slot map keyed by `p:ph/@type`: `false` hides the slot, a definition overrides its position and facets, omitted shows the default. Layouts and masters share the same key set — both public maps are aliases of this type.",
+      "properties": {
+        "body": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/PlaceholderDefinition"
+            },
+            {
+              "const": false,
+              "type": "boolean"
+            }
+          ]
+        },
+        "chart": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/PlaceholderDefinition"
+            },
+            {
+              "const": false,
+              "type": "boolean"
+            }
+          ]
+        },
+        "clipArt": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/PlaceholderDefinition"
+            },
+            {
+              "const": false,
+              "type": "boolean"
+            }
+          ]
+        },
+        "date": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/PlaceholderDefinition"
+            },
+            {
+              "const": false,
+              "type": "boolean"
+            }
+          ]
+        },
+        "diagram": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/PlaceholderDefinition"
+            },
+            {
+              "const": false,
+              "type": "boolean"
+            }
+          ]
+        },
+        "footer": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/PlaceholderDefinition"
+            },
+            {
+              "const": false,
+              "type": "boolean"
+            }
+          ]
+        },
+        "header": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/PlaceholderDefinition"
+            },
+            {
+              "const": false,
+              "type": "boolean"
+            }
+          ]
+        },
+        "media": {
           "anyOf": [
             {
-              "type": "number"
+              "$ref": "#/definitions/PlaceholderDefinition"
             },
             {
-              "$ref": "#/definitions/UniversalMeasure"
+              "const": false,
+              "type": "boolean"
             }
           ]
         },
-        "x": {
+        "object": {
           "anyOf": [
             {
-              "type": "number"
+              "$ref": "#/definitions/PlaceholderDefinition"
             },
             {
-              "$ref": "#/definitions/UniversalMeasure"
+              "const": false,
+              "type": "boolean"
             }
           ]
         },
-        "y": {
+        "picture": {
           "anyOf": [
             {
-              "type": "number"
+              "$ref": "#/definitions/PlaceholderDefinition"
             },
             {
-              "$ref": "#/definitions/UniversalMeasure"
+              "const": false,
+              "type": "boolean"
             }
           ]
-        }
-      },
-      "required": ["type"],
-      "type": "object"
-    },
-    "PictureOptionsOptions": {
-      "additionalProperties": false,
-      "description": "Picture-fill options for bar/area series.",
-      "properties": {
-        "applyToEnd": {
-          "type": "boolean"
-        },
-        "applyToFront": {
-          "type": "boolean"
-        },
-        "applyToSides": {
-          "type": "boolean"
-        },
-        "pictureFormat": {
-          "$ref": "#/definitions/PictureFormat"
-        },
-        "pictureStackUnit": {
-          "description": "Stack unit (c:pictureStackUnit val).",
-          "type": "number"
-        }
-      },
-      "type": "object"
-    },
-    "PivotSourceOptions": {
-      "additionalProperties": false,
-      "description": "Pivot chart source.",
-      "properties": {
-        "formatId": {
-          "type": "number"
-        },
-        "name": {
-          "type": "string"
-        }
-      },
-      "required": ["name", "formatId"],
-      "type": "object"
-    },
-    "PlaceholderDefinition": {
-      "additionalProperties": false,
-      "description": "Complete placeholder template on a master/layout: position, inheritable facets, and cNvPr fields (a16:creationId) so a re-emitted placeholder keeps its identity. Accepts the old flat x/y/width/height shape.",
-      "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."
-        },
-        "customGeometry": {
-          "$ref": "#/definitions/CustomGeometryOptions"
-        },
-        "description": {
-          "$ref": "#/definitions/ShapeOptions/properties/description"
-        },
-        "effects": {
-          "$ref": "#/definitions/EffectListOptions"
-        },
-        "ext": {
-          "$ref": "#/definitions/PictureOptions/properties/ext"
         },
-        "fill": {
-          "$ref": "#/definitions/FillOptions"
-        },
-        "geometry": {
+        "slideImage": {
           "anyOf": [
             {
-              "$ref": "#/definitions/ShapeType"
+              "$ref": "#/definitions/PlaceholderDefinition"
             },
             {
-              "$ref": "#/definitions/PresetGeometryOptions"
+              "const": false,
+              "type": "boolean"
             }
           ]
         },
-        "height": {
+        "slideNumber": {
           "anyOf": [
             {
-              "type": "number"
+              "$ref": "#/definitions/PlaceholderDefinition"
             },
             {
-              "$ref": "#/definitions/UniversalMeasure"
+              "const": false,
+              "type": "boolean"
             }
           ]
         },
-        "hidden": {
-          "description": "XSD `@hidden` (default false); emitted as \"1\" only when true.",
-          "type": "boolean"
-        },
-        "name": {
-          "$ref": "#/definitions/ShapeOptions/properties/name"
-        },
-        "outline": {
-          "$ref": "#/definitions/OutlineOptions"
-        },
-        "scene3d": {
-          "$ref": "#/definitions/Scene3DOptions"
-        },
-        "shape3d": {
-          "$ref": "#/definitions/Shape3DOptions"
-        },
-        "style": {
-          "$ref": "#/definitions/ShapeStyleOptions"
-        },
-        "textBody": {
-          "$ref": "#/definitions/TextBodyOptions"
-        },
-        "title": {
-          "description": "XSD `@title`.",
-          "type": "string"
-        },
-        "width": {
+        "subtitle": {
           "anyOf": [
             {
-              "type": "number"
+              "$ref": "#/definitions/PlaceholderDefinition"
             },
             {
-              "$ref": "#/definitions/UniversalMeasure"
+              "const": false,
+              "type": "boolean"
             }
           ]
         },
-        "x": {
+        "table": {
           "anyOf": [
             {
-              "type": "number"
+              "$ref": "#/definitions/PlaceholderDefinition"
             },
             {
-              "$ref": "#/definitions/UniversalMeasure"
+              "const": false,
+              "type": "boolean"
             }
           ]
         },
-        "y": {
+        "title": {
           "anyOf": [
             {
-              "type": "number"
+              "$ref": "#/definitions/PlaceholderDefinition"
             },
             {
-              "$ref": "#/definitions/UniversalMeasure"
+              "const": false,
+              "type": "boolean"
             }
           ]
         }
       },
-      "required": ["height", "width", "x", "y"],
       "type": "object"
     },
     "PlaceholderOrientation": {
@@ -9484,7 +9517,7 @@
           "type": "array"
         },
         "modified": {
-          "description": "Last modified timestamp (W3CDTF); same null/undefined semantics as  {@link  created } .",
+          "description": "Last modified timestamp (W3CDTF); same null/undefined semantics as the created field.",
           "type": ["string", "null"]
         },
         "modifyVerifier": {
@@ -10335,7 +10368,7 @@
           "$ref": "#/definitions/ChartSeriesData/properties/order"
         },
         "pictureOptions": {
-          "$ref": "#/definitions/PictureOptionsOptions",
+          "$ref": "#/definitions/ChartPictureOptions",
           "description": "Picture-fill options (c:pictureOptions, bar/area)."
         },
         "shape": {
@@ -10643,56 +10676,20 @@
           "$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."
         },
-        "customGeometry": {
-          "$ref": "#/definitions/CustomGeometryOptions"
-        },
         "description": {
           "description": "XSD `@descr` — alt text for accessibility; emitted only when present.",
           "type": "string"
         },
-        "effects": {
-          "$ref": "#/definitions/EffectListOptions"
-        },
         "ext": {
-          "description": "Raw a:extLst inner XML — verbatim round-trip for unmodeled extensions.",
+          "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"
         },
-        "extensions": {
-          "description": "Shape-property extensions (p:spPr/a:extLst/a:ext).",
-          "items": {
-            "$ref": "#/definitions/ShapePropertiesExtensionOptions"
-          },
-          "type": "array"
-        },
-        "fill": {
-          "anyOf": [
-            {
-              "$ref": "#/definitions/FillOptions"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "description": "`null` marks a source spPr with no fill child — absence is the fidelity (the shape inherits its fill), so stringify emits nothing instead of the fresh-authoring noFill default."
-        },
         "flipHorizontal": {
           "type": "boolean"
         },
         "flipVertical": {
-          "description": "Flip vertically (a:xfrm `@flipV`).",
           "type": "boolean"
         },
-        "geometry": {
-          "anyOf": [
-            {
-              "$ref": "#/definitions/ShapeType"
-            },
-            {
-              "$ref": "#/definitions/PresetGeometryOptions"
-            }
-          ],
-          "description": "Preset geometry token or full geometry (a:prstGeom `@prst`)"
-        },
         "hasCustomPrompt": {
           "type": "boolean"
         },
@@ -10727,9 +10724,6 @@
           "description": "XSD `@name` (required in XML); API-optional, the descriptor synthesizes a fallback.",
           "type": "string"
         },
-        "outline": {
-          "$ref": "#/definitions/OutlineOptions"
-        },
         "placeholder": {
           "$ref": "#/definitions/PlaceholderType",
           "description": "`@type` —."
@@ -10747,16 +10741,66 @@
           "enum": ["full", "half", "quarter"],
           "type": "string"
         },
+        "properties": {
+          "additionalProperties": false,
+          "description": "Shape properties (a:spPr children): geometry/fill/outline/effects/3D and the spPr extension list. Transform fields stay top-level on the shape. `fill: null` marks a source spPr with no fill child — absence is the fidelity (the shape inherits its fill), so stringify emits nothing instead of the fresh-authoring noFill default.",
+          "properties": {
+            "customGeometry": {
+              "$ref": "#/definitions/CustomGeometryOptions"
+            },
+            "effectDag": {
+              "$ref": "#/definitions/EffectDagOptions"
+            },
+            "effects": {
+              "$ref": "#/definitions/EffectListOptions"
+            },
+            "ext": {
+              "description": "Raw a:extLst inner XML. Prefer `extensions` for structured shape-property extensions; retained for existing callers and unmodeled payloads.",
+              "type": "string"
+            },
+            "extensions": {
+              "description": "Shape-property extensions (a:extLst/a:ext).",
+              "items": {
+                "$ref": "#/definitions/ShapePropertiesExtensionOptions"
+              },
+              "type": "array"
+            },
+            "fill": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/FillOptions"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "geometry": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/ShapeType"
+                },
+                {
+                  "$ref": "#/definitions/PresetGeometryOptions"
+                }
+              ]
+            },
+            "outline": {
+              "$ref": "#/definitions/OutlineOptions"
+            },
+            "scene3d": {
+              "$ref": "#/definitions/Scene3DOptions"
+            },
+            "shape3d": {
+              "$ref": "#/definitions/Shape3DOptions"
+            }
+          },
+          "type": "object"
+        },
         "rotation": {
           "description": "Rotation angle in degrees (e.g., 45 = 45°).",
           "type": "number"
         },
-        "scene3d": {
-          "$ref": "#/definitions/Scene3DOptions"
-        },
-        "shape3d": {
-          "$ref": "#/definitions/Shape3DOptions"
-        },
         "style": {
           "$ref": "#/definitions/ShapeStyleOptions"
         },
@@ -10837,18 +10881,20 @@
           "$ref": "#/definitions/EffectListOptions"
         },
         "ext": {
-          "description": "Raw a:extLst inner XML. Prefer `extensions` for structured shape-property extensions; retained for existing callers and unmodeled payloads.",
-          "type": "string"
+          "$ref": "#/definitions/ShapeOptions/properties/properties/properties/ext"
         },
         "extensions": {
-          "description": "Shape-property extensions (a:extLst/a:ext).",
-          "items": {
-            "$ref": "#/definitions/ShapePropertiesExtensionOptions"
-          },
-          "type": "array"
+          "$ref": "#/definitions/ShapeOptions/properties/properties/properties/extensions"
         },
         "fill": {
-          "$ref": "#/definitions/FillOptions"
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FillOptions"
+            },
+            {
+              "type": "null"
+            }
+          ]
         },
         "flipHorizontal": {
           "type": "boolean"
@@ -11677,7 +11723,7 @@
           "$ref": "#/definitions/ShapeOptions/properties/description"
         },
         "ext": {
-          "$ref": "#/definitions/PictureOptions/properties/ext"
+          "$ref": "#/definitions/ShapeOptions/properties/ext"
         },
         "hasCustomPrompt": {
           "type": "boolean"
@@ -12230,11 +12276,11 @@
           "type": "string"
         },
         "vertical": {
-          "$ref": "#/definitions/TextVerticalType",
+          "$ref": "#/definitions/TextVertical",
           "description": "`@vert` — text direction."
         },
         "verticalAlign": {
-          "$ref": "#/definitions/VerticalAlignment"
+          "$ref": "#/definitions/VerticalAnchor"
         },
         "verticalMerge": {
           "description": "Vertical merge: \"restart\" first cell of the merge, \"continue\" cell absorbed into it.",
@@ -12339,7 +12385,7 @@
           "$ref": "#/definitions/ShapeOptions/properties/description"
         },
         "ext": {
-          "$ref": "#/definitions/PictureOptions/properties/ext"
+          "$ref": "#/definitions/ShapeOptions/properties/ext"
         },
         "firstCol": {
           "type": "boolean"
@@ -12622,8 +12668,16 @@
       "type": "object"
     },
     "TextAlignment": {
-      "description": "Paragraph alignment; \"justify\" stretches lines to full width.",
-      "enum": ["left", "center", "right", "justify"],
+      "description": "Paragraph alignment; \"justify\" stretches lines to full width, \"distribute\" justifies including the last line, \"lowJustification\" aligns to a low baseline, \"thaiDistributed\" is Thai-style distribution.",
+      "enum": [
+        "left",
+        "center",
+        "right",
+        "justify",
+        "lowJustification",
+        "distribute",
+        "thaiDistributed"
+      ],
       "type": "string"
     },
     "TextBodyOptions": {
@@ -13337,17 +13391,6 @@
       ],
       "type": "string"
     },
-    "TextVerticalType": {
-      "description": "Text direction within a cell.",
-      "enum": [
-        "horizontal",
-        "vertical",
-        "vertical270",
-        "wordArtVertical",
-        "wordArtVerticalRightToLeft"
-      ],
-      "type": "string"
-    },
     "ThemeOptions": {
       "additionalProperties": false,
       "description": "Theme customization options (a:theme).",
@@ -13406,7 +13449,7 @@
           "type": "string"
         },
         "compound": {
-          "$ref": "#/definitions/CompoundLineType",
+          "$ref": "#/definitions/CompoundLine",
           "description": "Compound line type (@cmpd)"
         },
         "lineReference": {
@@ -14100,11 +14143,6 @@
       "required": ["dx", "dy", "dz"],
       "type": "object"
     },
-    "VerticalAlignment": {
-      "description": "Vertical alignment of cell content; \"distribute\" spreads lines evenly across the cell height.",
-      "enum": ["top", "center", "bottom", "justify", "distribute"],
-      "type": "string"
-    },
     "VerticalAnchor": {
       "description": "Text anchoring type.",
       "enum": ["top", "center", "bottom", "justify", "distribute"],
@@ -14128,7 +14166,7 @@
           "$ref": "#/definitions/ShapeOptions/properties/description"
         },
         "ext": {
-          "$ref": "#/definitions/PictureOptions/properties/ext"
+          "$ref": "#/definitions/ShapeOptions/properties/ext"
         },
         "fileName": {
           "description": "Media file name inside the package (ppt/media/<fileName>). Round-trip keeps the source name; fresh generation derives it from the frame name.",