Type Alias: CommonObjectDescriptor

CommonObjectDescriptor = { image: ImageProps; } | { line: ShapeProps; } | { rect: ShapeProps; } | { roundRect: ShapeProps; } | { shape: { options?: ShapeProps; type: SHAPE_NAME; }; } | { text: { options?: TextPropsOptions; text: string | number | TextProps[]; }; }

The object descriptors a slide master and a group child both accept.

Both surfaces take a key-tagged descriptor — one key naming the object kind, its value the options for that kind — and both accepted the same six. They were written out twice, and the doc on GroupChildProps said as much in as many words: "Uses the same key-tagged descriptor shape as SlideMasterObject". That coupling was real and maintained by hand, which meant a seventh descriptor added to one was silently missing from the other.

Each union is now this plus what is genuinely its own — a master adds chart and placeholder, a group child adds group — so the difference between them is the part you read, and the shared vocabulary is stated once.

Union Members

Type Literal

{ image: ImageProps; }

---

Type Literal

{ line: ShapeProps; }

---

Type Literal

{ rect: ShapeProps; }

---

Type Literal

{ roundRect: ShapeProps; }

---

Type Literal

{ shape: { options?: ShapeProps; type: SHAPE_NAME; }; }

Any preset shape, addressed by SHAPE_NAME (e.g. ShapeType.ellipse). Generalizes the line/rect/roundRect shortcuts to every preset the addShape() serializer supports (ellipse, triangle, chevron, …).

A union member's comment cannot carry block tags, so this stands in for @example: { shape: { type: 'ellipse', options: { x: 1, y: 1, w: 2, h: 2, fill: { color: 'FF0000' } } } }

---

Type Literal

{ text: { options?: TextPropsOptions; text: string | number | TextProps[]; }; }