office-open 0.12.2 → 0.13.0

package/schemas/docx.schema.json

@@ -963,7 +963,7 @@
           "description": "Raw image data: Uint8Array, ArrayBuffer, or a base64 data URL."
         },
         "fileName": {
-          "description": "Placeholder key matching the `{fileName}` token in  {@link  rawXml  } .",
+          "description": "Placeholder key matching the `{fileName}` token inside the raw background XML.",
           "type": "string"
         },
         "type": {
@@ -1156,6 +1156,11 @@
       },
       "type": "object"
     },
+    "BlipCompression": {
+      "description": "Blip compression states (, the a:blip",
+      "enum": ["email", "screen", "print", "hqprint", "none"],
+      "type": "string"
+    },
     "BlipEffectsOptions": {
       "additionalProperties": false,
       "description": "All blip image adjustment effects.",
@@ -1231,6 +1236,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"
@@ -1530,36 +1539,7 @@
           "type": "number"
         },
         "style": {
-          "description": "Border pattern. Token jargon: \"wave\"/\"doubleWave\" wavy, \"inset\"/\"outset\" pseudo-3D, \"thickThin*\"/\"thinThickThin*\" compound lines, \"pctN\" dotted density, \"nil\" none.",
-          "enum": [
-            "single",
-            "dashDotStroked",
-            "dashed",
-            "dashSmallGap",
-            "dotDash",
-            "dotDotDash",
-            "dotted",
-            "double",
-            "doubleWave",
-            "inset",
-            "nil",
-            "none",
-            "outset",
-            "thick",
-            "thickThinLargeGap",
-            "thickThinMediumGap",
-            "thickThinSmallGap",
-            "thinThickLargeGap",
-            "thinThickMediumGap",
-            "thinThickSmallGap",
-            "thinThickThinLargeGap",
-            "thinThickThinMediumGap",
-            "thinThickThinSmallGap",
-            "threeDEmboss",
-            "threeDEngrave",
-            "triple",
-            "wave"
-          ],
+          "description": "Border pattern. Token jargon: \"wave\"/\"doubleWave\" wavy, \"inset\"/\"outset\" pseudo-3D, \"thickThin*\"/\"thinThickThin*\" compound lines, \"nil\"/\"none\" no border. Accepts any token — the BorderStyle const lists the common line styles; Word also defines ~165 artistic and pattern tokens (apples, weavingBraid, …) that round-trip as-is.",
           "type": "string"
         },
         "themeColor": {
@@ -1686,7 +1666,7 @@
           "$ref": "#/definitions/ChartSeriesData/properties/order"
         },
         "pictureOptions": {
-          "$ref": "#/definitions/PictureOptionsOptions",
+          "$ref": "#/definitions/ChartPictureOptions",
           "description": "Picture-fill options (c:pictureOptions, bar/area)."
         },
         "shape": {
@@ -2772,6 +2752,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.",
@@ -2847,7 +2850,7 @@
           "type": "number"
         },
         "pictureOptions": {
-          "$ref": "#/definitions/PictureOptionsOptions",
+          "$ref": "#/definitions/ChartPictureOptions",
           "description": "Picture-fill options (c:pictureOptions, bar/area)."
         },
         "shape": {
@@ -3278,34 +3281,6 @@
       },
       "type": "object"
     },
-    "ChildExtent": {
-      "additionalProperties": false,
-      "description": "Child coordinate extent.",
-      "properties": {
-        "cx": {
-          "type": "number"
-        },
-        "cy": {
-          "type": "number"
-        }
-      },
-      "required": ["cx", "cy"],
-      "type": "object"
-    },
-    "ChildOffset": {
-      "additionalProperties": false,
-      "description": "Child coordinate offset.",
-      "properties": {
-        "x": {
-          "type": "number"
-        },
-        "y": {
-          "type": "number"
-        }
-      },
-      "required": ["x", "y"],
-      "type": "object"
-    },
     "ChildOrder": {
       "description": "(dgm:layoutNode `@chOrder`).",
       "enum": ["b", "t"],
@@ -4674,14 +4649,14 @@
           },
           "type": "array"
         },
-        "customXmlPr": {
-          "$ref": "#/definitions/CustomXmlPropertiesOptions",
-          "description": "Properties (placeholder, data binding, attributes)"
-        },
         "element": {
           "description": "XML element name (required)",
           "type": "string"
         },
+        "properties": {
+          "$ref": "#/definitions/CustomXmlPropertiesOptions",
+          "description": "Properties (placeholder, data binding, attributes)"
+        },
         "uri": {
           "description": "Namespace URI",
           "type": "string"
@@ -4701,14 +4676,14 @@
           },
           "type": "array"
         },
-        "customXmlPr": {
-          "$ref": "#/definitions/CustomXmlPropertiesOptions",
-          "description": "Properties (placeholder, data binding, attributes)"
-        },
         "element": {
           "description": "XML element name (required)",
           "type": "string"
         },
+        "properties": {
+          "$ref": "#/definitions/CustomXmlPropertiesOptions",
+          "description": "Properties (placeholder, data binding, attributes)"
+        },
         "uri": {
           "description": "Namespace URI",
           "type": "string"
@@ -4746,14 +4721,14 @@
           },
           "type": "array"
         },
-        "customXmlPr": {
-          "$ref": "#/definitions/CustomXmlPropertiesOptions",
-          "description": "Properties (placeholder, data binding, attributes)"
-        },
         "element": {
           "description": "XML element name (required)",
           "type": "string"
         },
+        "properties": {
+          "$ref": "#/definitions/CustomXmlPropertiesOptions",
+          "description": "Properties (placeholder, data binding, attributes)"
+        },
         "uri": {
           "description": "Namespace URI",
           "type": "string"
@@ -5020,7 +4995,7 @@
           "$ref": "#/definitions/MarkerOptions"
         },
         "pictureOptions": {
-          "$ref": "#/definitions/PictureOptionsOptions"
+          "$ref": "#/definitions/ChartPictureOptions"
         },
         "shapeProperties": {
           "$ref": "#/definitions/ShapePropertiesOptions",
@@ -5451,7 +5426,7 @@
           "type": "number"
         },
         "type": {
-          "description": "Grid behavior — see  {@link  DocumentGridType }  values.",
+          "description": "Grid behavior.",
           "enum": ["default", "lines", "linesAndChars", "snapToChars"],
           "type": "string"
         }
@@ -5468,6 +5443,7 @@
       "description": "Gallery type for building blocks",
       "enum": [
         "placeholder",
+        "any",
         "default",
         "docParts",
         "coverPg",
@@ -5630,7 +5606,7 @@
     },
     "DocumentBackgroundOptions": {
       "additionalProperties": false,
-      "description": "Options for creating a document background.",
+      "description": "Options for the document background (w:background).",
       "properties": {
         "color": {
           "$ref": "#/definitions/HexColorOrAuto",
@@ -6004,7 +5980,7 @@
           "type": "string"
         },
         "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"]
         },
         "numbering": {
@@ -6802,6 +6778,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."
@@ -7466,9 +7446,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"
         },
@@ -7491,22 +7471,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.",
@@ -7609,6 +7573,10 @@
         {
           "additionalProperties": false,
           "properties": {
+            "compression": {
+              "$ref": "#/definitions/BlipCompression",
+              "description": "Compression state (a:blip `@cstate`); absent = attribute omitted (schema default \"none\")."
+            },
             "data": {
               "$ref": "#/definitions/DataType"
             },
@@ -7653,6 +7621,10 @@
         {
           "additionalProperties": false,
           "properties": {
+            "compression": {
+              "$ref": "#/definitions/BlipCompression",
+              "description": "Compression state (a:blip `@cstate`); absent = attribute omitted (schema default \"none\")."
+            },
             "data": {
               "$ref": "#/definitions/DataType"
             },
@@ -7660,6 +7632,10 @@
               "additionalProperties": false,
               "description": "Fallback image for Word processors that do not support SVG. This ensures the document displays correctly in all viewers.",
               "properties": {
+                "compression": {
+                  "$ref": "#/definitions/BlipCompression",
+                  "description": "Compression state (a:blip `@cstate`); absent = attribute omitted (schema default \"none\")."
+                },
                 "data": {
                   "$ref": "#/definitions/DataType"
                 },
@@ -7732,13 +7708,21 @@
         {
           "additionalProperties": false,
           "properties": {
-            "childExtent": {
-              "$ref": "#/definitions/ChildExtent",
-              "description": "Child coordinate extent"
+            "childExtentHeight": {
+              "description": "Child coordinate system extent height (a:chExt",
+              "type": "number"
+            },
+            "childExtentWidth": {
+              "description": "Child coordinate system extent width (a:chExt",
+              "type": "number"
+            },
+            "childOffsetX": {
+              "description": "Child coordinate system offset X (a:chOff",
+              "type": "number"
             },
-            "childOffset": {
-              "$ref": "#/definitions/ChildOffset",
-              "description": "Child coordinate offset"
+            "childOffsetY": {
+              "description": "Child coordinate system offset Y (a:chOff",
+              "type": "number"
             },
             "children": {
               "items": {
@@ -7892,13 +7876,21 @@
         "altText": {
           "$ref": "#/definitions/DocPropertiesOptions"
         },
-        "childExtent": {
-          "$ref": "#/definitions/ChildExtent",
-          "description": "Child coordinate extent (chExt)"
+        "childExtentHeight": {
+          "description": "Child coordinate system extent height (a:chExt",
+          "type": "number"
         },
-        "childOffset": {
-          "$ref": "#/definitions/ChildOffset",
-          "description": "Child coordinate offset (chOff)"
+        "childExtentWidth": {
+          "description": "Child coordinate system extent width (a:chExt",
+          "type": "number"
+        },
+        "childOffsetX": {
+          "description": "Child coordinate system offset X (a:chOff",
+          "type": "number"
+        },
+        "childOffsetY": {
+          "description": "Child coordinate system offset Y (a:chOff",
+          "type": "number"
         },
         "children": {
           "items": {
@@ -7978,7 +7970,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": [
@@ -7988,7 +7980,8 @@
             {
               "$ref": "#/definitions/UniversalMeasure"
             }
-          ]
+          ],
+          "description": "Child coordinate system extent height (a:chExt"
         },
         "childExtentWidth": {
           "anyOf": [
@@ -7998,7 +7991,8 @@
             {
               "$ref": "#/definitions/UniversalMeasure"
             }
-          ]
+          ],
+          "description": "Child coordinate system extent width (a:chExt"
         },
         "childOffsetX": {
           "anyOf": [
@@ -8008,7 +8002,8 @@
             {
               "$ref": "#/definitions/UniversalMeasure"
             }
-          ]
+          ],
+          "description": "Child coordinate system offset X (a:chOff"
         },
         "childOffsetY": {
           "anyOf": [
@@ -8018,7 +8013,8 @@
             {
               "$ref": "#/definitions/UniversalMeasure"
             }
-          ]
+          ],
+          "description": "Child coordinate system offset Y (a:chOff"
         },
         "effectDag": {
           "$ref": "#/definitions/EffectDagOptions"
@@ -10627,8 +10623,13 @@
           "required": ["x", "y"],
           "type": "object"
         },
-        "flip": {
-          "$ref": "#/definitions/MediaTransformation/properties/flip"
+        "flipHorizontal": {
+          "description": "Whether to flip the image horizontally (a:xfrm",
+          "type": "boolean"
+        },
+        "flipVertical": {
+          "description": "Whether to flip the image vertically (a:xfrm",
+          "type": "boolean"
         },
         "offset": {
           "additionalProperties": false,
@@ -10700,20 +10701,13 @@
           "required": ["l", "t", "r", "b"],
           "type": "object"
         },
-        "flip": {
-          "additionalProperties": false,
-          "description": "Optional flip transformations",
-          "properties": {
-            "horizontal": {
-              "description": "Whether to flip the image horizontally",
-              "type": "boolean"
-            },
-            "vertical": {
-              "description": "Whether to flip the image vertically",
-              "type": "boolean"
-            }
-          },
-          "type": "object"
+        "flipHorizontal": {
+          "description": "Whether to flip the image horizontally (a:xfrm",
+          "type": "boolean"
+        },
+        "flipVertical": {
+          "description": "Whether to flip the image vertically (a:xfrm",
+          "type": "boolean"
         },
         "height": {
           "anyOf": [
@@ -12764,14 +12758,14 @@
                   },
                   "type": "array"
                 },
-                "customXmlPr": {
-                  "$ref": "#/definitions/CustomXmlPropertiesOptions",
-                  "description": "Properties (placeholder, data binding, attributes)"
-                },
                 "element": {
                   "description": "XML element name (required)",
                   "type": "string"
                 },
+                "properties": {
+                  "$ref": "#/definitions/CustomXmlPropertiesOptions",
+                  "description": "Properties (placeholder, data binding, attributes)"
+                },
                 "uri": {
                   "description": "Namespace URI",
                   "type": "string"
@@ -13587,7 +13581,7 @@
               "$ref": "#/definitions/FootnoteEndnoteReferenceOptions"
             }
           ],
-          "description": "Endnote reference as a top-level field (see  {@link  footnoteReference } )."
+          "description": "Endnote reference as a top-level field (sibling of footnoteReference)."
         },
         "fitText": {
           "type": "number"
@@ -13716,7 +13710,7 @@
           "type": "number"
         },
         "sizeComplexScript": {
-          "description": "Complex-script font size in points (w:szCs). Independent from  {@link  size } .",
+          "description": "Complex-script font size in points (w:szCs). Independent from the size field.",
           "type": "number"
         },
         "smallCaps": {
@@ -14385,6 +14379,10 @@
             "blipEffects": {
               "$ref": "#/definitions/BlipEffectsOptions"
             },
+            "compression": {
+              "$ref": "#/definitions/BlipCompression",
+              "description": "Compression state (a:blip `@cstate`); absent = attribute omitted (schema default \"none\")."
+            },
             "data": {
               "$ref": "#/definitions/DataType",
               "description": "Image binary. Absent on a linked-only picture (external sourceUrl, no bytes in the package) — the emitted a:blip carries r:link alone."
@@ -14470,6 +14468,10 @@
             "blipEffects": {
               "$ref": "#/definitions/BlipEffectsOptions"
             },
+            "compression": {
+              "$ref": "#/definitions/BlipCompression",
+              "description": "Compression state (a:blip `@cstate`); absent = attribute omitted (schema default \"none\")."
+            },
             "data": {
               "$ref": "#/definitions/DataType"
             },
@@ -14558,29 +14560,6 @@
       ],
       "description": "Options for an inline/anchored picture (pic:pic)."
     },
-    "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.",
@@ -15551,7 +15530,7 @@
     },
     "RunOptions": {
       "additionalProperties": false,
-      "description": "Options for creating a Run element.\n\nThe run element specifies a region of text with a common set of properties. The children property can contain various inline content elements.",
+      "description": "Options for creating a Run element (w:r).\n\nThe run element specifies a region of text with a common set of properties. The children property can contain various inline content elements.",
       "properties": {
         "additionRsid": {
           "$ref": "#/definitions/LongHexNumber",
@@ -16290,7 +16269,7 @@
           "$ref": "#/definitions/ChartSeriesData/properties/order"
         },
         "pictureOptions": {
-          "$ref": "#/definitions/PictureOptionsOptions",
+          "$ref": "#/definitions/ChartPictureOptions",
           "description": "Picture-fill options (c:pictureOptions, bar/area)."
         },
         "shape": {
@@ -18764,6 +18743,9 @@
         "fill": {
           "$ref": "#/definitions/FillOptions"
         },
+        "geometry": {
+          "$ref": "#/definitions/ShapeOptions/properties/geometry"
+        },
         "linkedTextBox": {
           "$ref": "#/definitions/ShapeOptions/properties/linkedTextBox"
         },
@@ -18776,9 +18758,6 @@
         "outline": {
           "$ref": "#/definitions/OutlineOptions"
         },
-        "presetGeometry": {
-          "$ref": "#/definitions/PresetGeometryOptions"
-        },
         "scene3d": {
           "$ref": "#/definitions/Scene3DOptions"
         },
@@ -18901,6 +18880,17 @@
         "floating": {
           "$ref": "#/definitions/Floating"
         },
+        "geometry": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/ShapeType"
+            },
+            {
+              "$ref": "#/definitions/PresetGeometryOptions"
+            }
+          ],
+          "description": "Preset geometry (a:prstGeom) — a bare string is shorthand for `{ preset: \"<name>\" }`."
+        },
         "graphicFrameLocks": {
           "$ref": "#/definitions/PictureOptions/anyOf/0/properties/graphicFrameLocks"
         },
@@ -18937,9 +18927,6 @@
         "outline": {
           "$ref": "#/definitions/OutlineOptions"
         },
-        "presetGeometry": {
-          "$ref": "#/definitions/PresetGeometryOptions"
-        },
         "runProperties": {
           "$ref": "#/definitions/RunPropertiesOptions",
           "description": "Structured run properties of the wrapping w:r (round-trip) — emitted before the drawing."
@@ -19018,7 +19005,14 @@
           "type": "array"
         },
         "fill": {
-          "$ref": "#/definitions/FillOptions"
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FillOptions"
+            },
+            {
+              "type": "null"
+            }
+          ]
         },
         "flipHorizontal": {
           "type": "boolean"
@@ -19103,7 +19097,19 @@
           "$ref": "#/definitions/ShapeStyleReferenceOptions"
         },
         "fontReference": {
-          "$ref": "#/definitions/ShapeStyleReferenceOptions"
+          "additionalProperties": false,
+          "description": "a:fontRef —",
+          "properties": {
+            "collection": {
+              "enum": ["major", "minor", "none"],
+              "type": "string"
+            },
+            "color": {
+              "$ref": "#/definitions/SolidFillOptions"
+            }
+          },
+          "required": ["collection"],
+          "type": "object"
         },
         "lineReference": {
           "$ref": "#/definitions/ShapeStyleReferenceOptions"
@@ -19113,18 +19119,18 @@
     },
     "ShapeStyleReferenceOptions": {
       "additionalProperties": false,
-      "description": "A style-matrix reference: an `idx` into the theme style matrix plus an optional color override.",
+      "description": "A style-matrix reference: an index into the theme style matrix plus an optional color override.",
       "properties": {
         "color": {
           "$ref": "#/definitions/SolidFillOptions",
           "description": "Color (EG_ColorChoice) — schemeClr/srgbClr/hslClr/sysClr/prstClr/scRgbClr."
         },
-        "idx": {
-          "description": "Style index (\"0\",\"1\",\"2\",…; or \"minor\"/\"major\" for font references).",
-          "type": "string"
+        "index": {
+          "description": "Index into the theme style matrix list (idx attribute).",
+          "type": "number"
         }
       },
-      "required": ["idx"],
+      "required": ["index"],
       "type": "object"
     },
     "ShapeTextBoxChild": {
@@ -21791,8 +21797,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": {