ooxml-core 1.24.2 → 1.25.0

package/dist/pptx/chunks/{smart-art-ENMMEbmW.d.ts → smart-art-BEEl0l8X.d.ts}

@@ -311,6 +311,405 @@ interface PptxCustomPathProperties {
   customGeometryTextRect?: CustomGeometryTextRect;
 }
 //#endregion
+//#region drawingml/types.d.ts
+/** A theme-independent DrawingML colour as written in a part. */
+interface DrawingColor {
+  kind: 'srgb' | 'scheme' | 'system' | 'preset' | 'scrgb' | 'hsl';
+  /** Hex for `srgb`, the scheme/preset/system name, or the serialized channels for `scrgb`/`hsl`. */
+  value: string;
+  /** Colour transforms in document order (`alpha`, `lumMod`, `shade`...), raw attribute values. */
+  transforms: {
+    name: string;
+    value: string;
+  }[];
+  /** `lastClr` of a system colour: the value the producer saw. */
+  fallback?: string;
+}
+/** A DrawingML fill (`a:noFill`, `a:solidFill`, `a:gradFill`, `a:pattFill`, `a:blipFill`). */
+type DrawingFill = {
+  kind: 'none';
+} | {
+  kind: 'solid';
+  color: DrawingColor;
+} | {
+  kind: 'gradient';
+  /** Original gradient XML, retaining flags and unsupported properties for editing. */
+  sourceXml?: string;
+  stops: {
+    position: number;
+    color: DrawingColor;
+  }[];
+  /** Linear angle in degrees, when `a:lin` is present. */
+  angle?: number;
+  /** Whether the linear vector scales with the shape's bounding box. */
+  scaled?: boolean;
+  path?: string;
+  /** DrawingML path-gradient focus rectangle, as fractions of the shape box. */
+  fillToRect?: {
+    l: number;
+    t: number;
+    r: number;
+    b: number;
+  };
+  /** Gradient tile insets; corner directions can extend beyond the shape box. */
+  tileRect?: {
+    l: number;
+    t: number;
+    r: number;
+    b: number;
+  };
+} | {
+  kind: 'pattern';
+  preset: string;
+  foreground?: DrawingColor;
+  background?: DrawingColor;
+} | {
+  kind: 'picture';
+  relId?: string;
+} | {
+  kind: 'unsupported';
+  element: string;
+};
+/** A DrawingML outline (`a:ln`). */
+interface DrawingLine {
+  /** Width in EMU. */
+  widthEmu?: number;
+  fill?: DrawingFill;
+  dash?: string;
+  cap?: string;
+}
+/** DrawingML spacing, retaining absolute points or a fractional percentage. */
+interface DrawingTextSpacing {
+  unit: 'points' | 'percent';
+  value: number;
+}
+//#endregion
+//#region drawingml/text-model.d.ts
+/** A `CT_TextFont` slot (`a:latin`, `a:ea`, `a:cs`, `a:sym`, `a:buFont`). */
+interface DrawingFont {
+  typeface: string;
+  panose?: string;
+  pitchFamily?: number;
+  charset?: number;
+}
+/** `a:hlinkClick` / `a:hlinkMouseOver` (CT_Hyperlink); the target stays a relationship id. */
+interface DrawingHyperlink {
+  relId?: string;
+  tooltip?: string;
+  action?: string;
+  invalidUrl?: string;
+  targetFrame?: string;
+  history?: boolean;
+  highlightClick?: boolean;
+  endSound?: boolean;
+  /** Children such as `a:snd` and `a:extLst`, kept verbatim. */
+  extraXml?: string[];
+}
+/** Run properties (`CT_TextCharacterProperties`). */
+interface DrawingRunProperties {
+  /** `sz` in points (the file stores hundredths). */
+  sizePt?: number;
+  bold?: boolean;
+  italic?: boolean;
+  /** `u`: `sng`, `dbl`, `none`, ... as written. */
+  underline?: string;
+  /** `strike`: `noStrike`, `sngStrike`, `dblStrike`. */
+  strike?: string;
+  /** `cap`: `none`, `small`, `all`. */
+  caps?: string;
+  /** `baseline` as a fraction of the font size (0.3 = 30% superscript). */
+  baseline?: number;
+  /** `spc` character spacing in points. */
+  spacingPt?: number;
+  /** `kern` minimum font size for kerning, in points. */
+  kernPt?: number;
+  language?: string;
+  altLanguage?: string;
+  kumimoji?: boolean;
+  normalizeHeight?: boolean;
+  noProof?: boolean;
+  dirty?: boolean;
+  spellingError?: boolean;
+  smartTagClean?: boolean;
+  smartTagId?: number;
+  bookmark?: string;
+  /** Text outline (`a:ln`); `lineSourceXml` keeps join, compound and arrow children. */
+  line?: DrawingLine;
+  lineSourceXml?: string;
+  /** Text fill (`a:solidFill`, `a:gradFill`, `a:noFill`...). */
+  fill?: DrawingFill;
+  highlight?: DrawingColor;
+  /** `a:uLnTx` (true) or nothing; an explicit underline line is kept in `underlineLineXml`. */
+  underlineLineFollowsText?: boolean;
+  underlineLineXml?: string;
+  /** `a:uFillTx` (true) or nothing; an explicit underline fill is `underlineFill`. */
+  underlineFillFollowsText?: boolean;
+  underlineFill?: DrawingFill;
+  latin?: DrawingFont;
+  eastAsian?: DrawingFont;
+  complexScript?: DrawingFont;
+  symbol?: DrawingFont;
+  hyperlinkClick?: DrawingHyperlink;
+  hyperlinkMouseOver?: DrawingHyperlink;
+  /** `a:rtl` child element (not an attribute on runs). */
+  rightToLeft?: boolean;
+  /** Children the model does not cover (`a:effectLst`, `a:extLst`...), verbatim. */
+  extraXml?: string[];
+}
+/** One `a:tab` of a `a:tabLst`. */
+interface DrawingTabStop {
+  /** Position in EMU. */
+  positionEmu?: number;
+  /** `l`, `ctr`, `r`, `dec`. */
+  align?: string;
+}
+/** The bullet of a paragraph (`a:buNone`, `a:buChar`, `a:buAutoNum`, `a:buBlip`). */
+type DrawingBullet = {
+  kind: 'none';
+} | {
+  kind: 'char';
+  char: string;
+} | {
+  kind: 'autoNumber';
+  scheme: string;
+  startAt?: number;
+} | {
+  kind: 'picture';
+  xml: string;
+};
+/** Paragraph properties (`CT_TextParagraphProperties`). */
+interface DrawingParagraphProperties {
+  /** `lvl` (0-8). */
+  level?: number;
+  /** `algn`: `l`, `ctr`, `r`, `just`, `justLow`, `dist`, `thaiDist`. */
+  align?: string;
+  /** `marL`, `marR` and `indent` in EMU. */
+  marginLeftEmu?: number;
+  marginRightEmu?: number;
+  indentEmu?: number;
+  /** `defTabSz` in EMU. */
+  defaultTabSizeEmu?: number;
+  rightToLeft?: boolean;
+  eastAsianLineBreak?: boolean;
+  latinLineBreak?: boolean;
+  hangingPunctuation?: boolean;
+  /** `fontAlgn`: `auto`, `t`, `ctr`, `base`, `b`. */
+  fontAlign?: string;
+  lineSpacing?: DrawingTextSpacing;
+  spaceBefore?: DrawingTextSpacing;
+  spaceAfter?: DrawingTextSpacing;
+  /** `a:buClrTx` is `'text'`. */
+  bulletColor?: DrawingColor | 'text';
+  /** `a:buSzTx` is `'text'`; `a:buSzPct` a fraction; `a:buSzPts` points. */
+  bulletSize?: 'text' | {
+    unit: 'percent' | 'points';
+    value: number;
+  };
+  /** `a:buFontTx` is `'text'`. */
+  bulletFont?: DrawingFont | 'text';
+  bullet?: DrawingBullet;
+  tabStops?: DrawingTabStop[];
+  defaultRunProperties?: DrawingRunProperties;
+  extraXml?: string[];
+}
+//#endregion
+//#region diagram/model/node.d.ts
+/**
+ * A single run of text inside a SmartArt node, capturing the run text and the
+ * raw `a:rPr` run-properties object verbatim so per-run formatting (bold,
+ * colour, size, etc.) survives a load -> edit -> save round-trip instead of
+ * collapsing to a single unstyled run.
+ *
+ * @example
+ * ```ts
+ * const run: DiagramNodeTextRun = {
+ *   text: "Bold",
+ *   rPr: { "@_b": "1", "@_lang": "en-US" },
+ * };
+ * // => satisfies DiagramNodeTextRun
+ * ```
+ */
+interface DiagramNodeTextRun<S = unknown> {
+  /** Run text content. */
+  text: string;
+  /**
+   * Raw parsed `a:rPr` run-properties object, preserved verbatim for
+   * round-trip. Untyped XML, hence the loose record shape.
+   */
+  rPr?: Record<string, unknown>;
+  /** Resolved standard shape-text style derived from {@link rPr}. */
+  style?: S;
+  /** Neutral run properties, set by readers on the shared DOM (`readDiagramNodeParagraphs`). */
+  properties?: DrawingRunProperties;
+  /** Raw run XML used to retain unmodelled extension children on save. */
+  rawXml?: Record<string, unknown>;
+  /** Original direct-child order, including unmodelled extension children. */
+  childOrder?: string[];
+}
+/** An ordered item within a SmartArt text paragraph. */
+type DiagramNodeTextParagraphItem<S = unknown> = {
+  kind: 'run';
+  run: DiagramNodeTextRun<S>;
+} | {
+  kind: 'break';
+  rPr?: Record<string, unknown>;
+  style?: S;
+  properties?: DrawingRunProperties;
+  rawXml?: Record<string, unknown>;
+  childOrder?: string[];
+} | {
+  kind: 'field';
+  id?: string;
+  fieldType?: string;
+  text: string;
+  rPr?: Record<string, unknown>;
+  style?: S;
+  pPr?: Record<string, unknown>;
+  properties?: DrawingRunProperties;
+  paragraphProperties?: DrawingParagraphProperties;
+  rawXml?: Record<string, unknown>;
+  childOrder?: string[];
+} | {
+  kind: 'tab';
+  rawXml?: Record<string, unknown>;
+  childOrder?: string[];
+} | {
+  kind: 'raw';
+  name: string;
+  value: unknown;
+};
+/** A complete `a:p` paragraph in a SmartArt data-model text body. */
+interface DiagramNodeTextParagraph<S = unknown> {
+  /** Paragraph properties (`a:pPr`) preserved verbatim. */
+  pPr?: Record<string, unknown>;
+  /** Text children in source order. */
+  items: DiagramNodeTextParagraphItem<S>[];
+  /** End-paragraph run properties (`a:endParaRPr`) preserved verbatim. */
+  endParaRPr?: Record<string, unknown>;
+  /** Resolved style for the paragraph terminator. */
+  endParaStyle?: S;
+  /** Neutral paragraph properties, set by readers on the shared DOM. */
+  properties?: DrawingParagraphProperties;
+  /** Neutral end-paragraph run properties, set by readers on the shared DOM. */
+  endProperties?: DrawingRunProperties;
+  /** Raw paragraph XML used to retain unmodelled extension children on save. */
+  rawXml?: Record<string, unknown>;
+}
+/**
+ * Per-node visual override for a SmartArt node.
+ *
+ * Captures the individual fill / line / font colour and the bold / italic
+ * emphasis a user has set on one specific node, independent of the diagram's
+ * colour scheme and quick style. All colours are hex strings (e.g. "#FF0000").
+ * Every field is optional: only the overridden aspects are carried, so an
+ * empty object means "no per-node override".
+ *
+ * The parser reads these from the data point's `spPr` solid fill / line colour
+ * and the first run's `rPr` (b / i / solidFill) when present, and the save path
+ * writes them back so the override survives a load -> edit -> save round-trip.
+ *
+ * @example
+ * ```ts
+ * const style: DiagramNodeStyle = {
+ *   fillColor: "#FF0000",
+ *   fontColor: "#FFFFFF",
+ *   bold: true,
+ * };
+ * // => satisfies DiagramNodeStyle
+ * ```
+ */
+interface DiagramNodeStyle {
+  /** Solid fill colour override (hex, e.g. "#4F81BD"). */
+  fillColor?: string;
+  /** Outline / line colour override (hex). */
+  lineColor?: string;
+  /** Text (font) colour override (hex). */
+  fontColor?: string;
+  /** Bold emphasis override for the node's runs. */
+  bold?: boolean;
+  /** Italic emphasis override for the node's runs. */
+  italic?: boolean;
+}
+/**
+ * A single node in the SmartArt data model.
+ *
+ * @example
+ * ```ts
+ * const node: DiagramNode = {
+ *   id: "1",
+ *   text: "CEO",
+ *   children: [
+ *     { id: "2", text: "VP Marketing", parentId: "1" },
+ *     { id: "3", text: "VP Engineering", parentId: "1" },
+ *   ],
+ * };
+ * // => satisfies DiagramNode
+ * ```
+ */
+interface DiagramNode<S = unknown> {
+  id: string;
+  text: string;
+  /** CT_Pt connection identifier, when the point references a connection. */
+  connectionId?: string | null;
+  parentId?: string | undefined;
+  children?: DiagramNode<S>[];
+  /** Node type from `@_type` attribute (e.g. "doc", "node", "asst", "pres"). */
+  nodeType?: string;
+  /**
+   * The node's own quick-style role (`dgm:prSet/@presStyleLbl` from its
+   * paired `type="pres"` presentation point, resolved via a `presOf`
+   * connection back to this content point). Structural names like `node1`,
+   * `asst2`, `bgShp`, `revTx`; distinct from {@link nodeType}, which is the
+   * data-model `@_type` ("node"/"asst"/...). Used to pick this node's own
+   * colour list from a colour transform's per-role palettes instead of the
+   * generic cycled palette (see `applySmartArtRoleColors`).
+   */
+  styleRole?: string;
+  /**
+   * `dgm:prSet/@coherent3DOff` (`CT_ElemPropSet`) resolved from the node's
+   * paired presentation point: when true, this node opts out of the
+   * diagram's overall coherent-3D scene rotation (a `dgm:scene3d`/`dgm:sp3d`
+   * quick-style variation) applied to every other node.
+   */
+  coherent3DOff?: boolean;
+  /**
+   * The layout variables PowerPoint recorded for each presentation node
+   * this point drives (`dgm:prSet/@presName` -> `dgm:presLayoutVars`
+   * variable -> `@val`), e.g. `{ hierRoot1: { hierBranch: 'l' } }` for an
+   * org-chart manager set to "Left Hanging". Read-only: the presentation
+   * points themselves round-trip verbatim.
+   */
+  presLayoutVarsByName?: Record<string, Record<string, string>>;
+  /**
+   * Per-run text + run-properties for the node's first paragraph, captured at
+   * parse time. When the joined run text still equals {@link text} (the node
+   * was not edited, or was edited only in ways that preserve the run split),
+   * the save path rebuilds the paragraph from these runs so per-run rich text
+   * is not flattened. When {@link text} diverges, the runs are ignored.
+   */
+  runs?: DiagramNodeTextRun<S>[];
+  /**
+   * Complete typed paragraph model. Unlike {@link runs}, this retains every
+   * paragraph and the ordered run, field, break, and tab children within it.
+   */
+  paragraphs?: DiagramNodeTextParagraph<S>[];
+  /**
+   * Optional per-node visual override (fill / line / font colour, bold /
+   * italic). Read at parse time from the point's `spPr` / first-run `rPr`, set
+   * by the editing op, honoured by the render path, and written back on save so
+   * it round-trips.
+   */
+  style?: DiagramNodeStyle;
+  /**
+   * Manual layout override read from the node's `dgm:prSet` `cust*`
+   * attributes (drag/resize/rotate/flip performed in PowerPoint's own diagram
+   * editor). Applied as a final transform after algorithmic layout by
+   * {@link module:smartart-layout-interpreter-custom} so it survives even
+   * when there is no cached `dsp:` drawing to fall back on.
+   */
+  customLayout?: DiagramNodeCustomLayout;
+}
+//#endregion
 //#region diagram/types.d.ts
 /** Resolved SmartArt layout family. */
 type DiagramLayoutType = 'list' | 'process' | 'cycle' | 'hierarchy' | 'relationship' | 'matrix' | 'pyramid' | 'funnel' | 'gear' | 'target' | 'timeline' | 'venn' | 'chevron' | 'bending' | 'unknown';
@@ -877,202 +1276,14 @@ interface DiagramQuickStyle<Scene = unknown, Shape = unknown, Text = unknown> ex
   scene3d?: Scene;
 }
 //#endregion
-//#region diagram/model/node.d.ts
+//#region diagram/model/data.d.ts
 /**
- * A single run of text inside a SmartArt node, capturing the run text and the
- * raw `a:rPr` run-properties object verbatim so per-run formatting (bold,
- * colour, size, etc.) survives a load -> edit -> save round-trip instead of
- * collapsing to a single unstyled run.
+ * Named SmartArt layout presets for creation (subset of the built-in layouts).
  *
  * @example
  * ```ts
- * const run: DiagramNodeTextRun = {
- *   text: "Bold",
- *   rPr: { "@_b": "1", "@_lang": "en-US" },
- * };
- * // => satisfies DiagramNodeTextRun
- * ```
- */
-interface DiagramNodeTextRun<S = unknown> {
-  /** Run text content. */
-  text: string;
-  /**
-   * Raw parsed `a:rPr` run-properties object, preserved verbatim for
-   * round-trip. Untyped XML, hence the loose record shape.
-   */
-  rPr?: Record<string, unknown>;
-  /** Resolved standard shape-text style derived from {@link rPr}. */
-  style?: S;
-  /** Raw run XML used to retain unmodelled extension children on save. */
-  rawXml?: Record<string, unknown>;
-  /** Original direct-child order, including unmodelled extension children. */
-  childOrder?: string[];
-}
-/** An ordered item within a SmartArt text paragraph. */
-type DiagramNodeTextParagraphItem<S = unknown> = {
-  kind: 'run';
-  run: DiagramNodeTextRun<S>;
-} | {
-  kind: 'break';
-  rPr?: Record<string, unknown>;
-  style?: S;
-  rawXml?: Record<string, unknown>;
-  childOrder?: string[];
-} | {
-  kind: 'field';
-  id?: string;
-  fieldType?: string;
-  text: string;
-  rPr?: Record<string, unknown>;
-  style?: S;
-  pPr?: Record<string, unknown>;
-  rawXml?: Record<string, unknown>;
-  childOrder?: string[];
-} | {
-  kind: 'tab';
-  rawXml?: Record<string, unknown>;
-  childOrder?: string[];
-} | {
-  kind: 'raw';
-  name: string;
-  value: unknown;
-};
-/** A complete `a:p` paragraph in a SmartArt data-model text body. */
-interface DiagramNodeTextParagraph<S = unknown> {
-  /** Paragraph properties (`a:pPr`) preserved verbatim. */
-  pPr?: Record<string, unknown>;
-  /** Text children in source order. */
-  items: DiagramNodeTextParagraphItem<S>[];
-  /** End-paragraph run properties (`a:endParaRPr`) preserved verbatim. */
-  endParaRPr?: Record<string, unknown>;
-  /** Resolved style for the paragraph terminator. */
-  endParaStyle?: S;
-  /** Raw paragraph XML used to retain unmodelled extension children on save. */
-  rawXml?: Record<string, unknown>;
-}
-/**
- * Per-node visual override for a SmartArt node.
- *
- * Captures the individual fill / line / font colour and the bold / italic
- * emphasis a user has set on one specific node, independent of the diagram's
- * colour scheme and quick style. All colours are hex strings (e.g. "#FF0000").
- * Every field is optional: only the overridden aspects are carried, so an
- * empty object means "no per-node override".
- *
- * The parser reads these from the data point's `spPr` solid fill / line colour
- * and the first run's `rPr` (b / i / solidFill) when present, and the save path
- * writes them back so the override survives a load -> edit -> save round-trip.
- *
- * @example
- * ```ts
- * const style: DiagramNodeStyle = {
- *   fillColor: "#FF0000",
- *   fontColor: "#FFFFFF",
- *   bold: true,
- * };
- * // => satisfies DiagramNodeStyle
- * ```
- */
-interface DiagramNodeStyle {
-  /** Solid fill colour override (hex, e.g. "#4F81BD"). */
-  fillColor?: string;
-  /** Outline / line colour override (hex). */
-  lineColor?: string;
-  /** Text (font) colour override (hex). */
-  fontColor?: string;
-  /** Bold emphasis override for the node's runs. */
-  bold?: boolean;
-  /** Italic emphasis override for the node's runs. */
-  italic?: boolean;
-}
-/**
- * A single node in the SmartArt data model.
- *
- * @example
- * ```ts
- * const node: DiagramNode = {
- *   id: "1",
- *   text: "CEO",
- *   children: [
- *     { id: "2", text: "VP Marketing", parentId: "1" },
- *     { id: "3", text: "VP Engineering", parentId: "1" },
- *   ],
- * };
- * // => satisfies DiagramNode
- * ```
- */
-interface DiagramNode<S = unknown> {
-  id: string;
-  text: string;
-  /** CT_Pt connection identifier, when the point references a connection. */
-  connectionId?: string | null;
-  parentId?: string | undefined;
-  children?: DiagramNode<S>[];
-  /** Node type from `@_type` attribute (e.g. "doc", "node", "asst", "pres"). */
-  nodeType?: string;
-  /**
-   * The node's own quick-style role (`dgm:prSet/@presStyleLbl` from its
-   * paired `type="pres"` presentation point, resolved via a `presOf`
-   * connection back to this content point). Structural names like `node1`,
-   * `asst2`, `bgShp`, `revTx`; distinct from {@link nodeType}, which is the
-   * data-model `@_type` ("node"/"asst"/...). Used to pick this node's own
-   * colour list from a colour transform's per-role palettes instead of the
-   * generic cycled palette (see `applySmartArtRoleColors`).
-   */
-  styleRole?: string;
-  /**
-   * `dgm:prSet/@coherent3DOff` (`CT_ElemPropSet`) resolved from the node's
-   * paired presentation point: when true, this node opts out of the
-   * diagram's overall coherent-3D scene rotation (a `dgm:scene3d`/`dgm:sp3d`
-   * quick-style variation) applied to every other node.
-   */
-  coherent3DOff?: boolean;
-  /**
-   * The layout variables PowerPoint recorded for each presentation node
-   * this point drives (`dgm:prSet/@presName` -> `dgm:presLayoutVars`
-   * variable -> `@val`), e.g. `{ hierRoot1: { hierBranch: 'l' } }` for an
-   * org-chart manager set to "Left Hanging". Read-only: the presentation
-   * points themselves round-trip verbatim.
-   */
-  presLayoutVarsByName?: Record<string, Record<string, string>>;
-  /**
-   * Per-run text + run-properties for the node's first paragraph, captured at
-   * parse time. When the joined run text still equals {@link text} (the node
-   * was not edited, or was edited only in ways that preserve the run split),
-   * the save path rebuilds the paragraph from these runs so per-run rich text
-   * is not flattened. When {@link text} diverges, the runs are ignored.
-   */
-  runs?: DiagramNodeTextRun<S>[];
-  /**
-   * Complete typed paragraph model. Unlike {@link runs}, this retains every
-   * paragraph and the ordered run, field, break, and tab children within it.
-   */
-  paragraphs?: DiagramNodeTextParagraph<S>[];
-  /**
-   * Optional per-node visual override (fill / line / font colour, bold /
-   * italic). Read at parse time from the point's `spPr` / first-run `rPr`, set
-   * by the editing op, honoured by the render path, and written back on save so
-   * it round-trips.
-   */
-  style?: DiagramNodeStyle;
-  /**
-   * Manual layout override read from the node's `dgm:prSet` `cust*`
-   * attributes (drag/resize/rotate/flip performed in PowerPoint's own diagram
-   * editor). Applied as a final transform after algorithmic layout by
-   * {@link module:smartart-layout-interpreter-custom} so it survives even
-   * when there is no cached `dsp:` drawing to fall back on.
-   */
-  customLayout?: DiagramNodeCustomLayout;
-}
-//#endregion
-//#region diagram/model/data.d.ts
-/**
- * Named SmartArt layout presets for creation (subset of the built-in layouts).
- *
- * @example
- * ```ts
- * const layout: DiagramLayoutPreset = "hierarchy";
- * // => "hierarchy" - one of: "basicBlockList" | "alternatingHexagons" | "hierarchy" | ...
+ * const layout: DiagramLayoutPreset = "hierarchy";
+ * // => "hierarchy" - one of: "basicBlockList" | "alternatingHexagons" | "hierarchy" | ...
  * ```
  */
 type DiagramLayoutPreset = 'basicBlockList' | 'alternatingHexagons' | 'basicChevronProcess' | 'basicCycle' | 'basicPie' | 'basicRadial' | 'basicVenn' | 'continuousBlockProcess' | 'convergingRadial' | 'hierarchy' | 'horizontalBulletList' | 'linearVenn' | 'segmentedProcess' | 'stackedList' | 'tableList' | 'trapezoidList' | 'upwardArrow' | 'basicFunnel' | 'basicTarget' | 'interlockingGears' | 'basicTimeline' | 'basicMatrix' | 'basicPyramid' | 'invertedPyramid' | 'bendingProcess' | 'stepDownProcess' | 'alternatingFlow' | 'descendingProcess' | 'pictureAccentList' | 'verticalBlockList' | 'groupedList' | 'pyramidList' | 'horizontalPictureList' | 'accentProcess' | 'verticalChevronList';
@@ -1163,6 +1374,111 @@ interface DiagramData {
   themeMinorFont?: string;
 }
 //#endregion
+//#region diagram/drawing-view.d.ts
+/** A gradient stop of a resolved fill. `position` is a percentage (0..100). */
+interface DiagramShapeGradientStop {
+  color: string;
+  position: number;
+  opacity?: number;
+}
+/** A SmartArt shape with resolved colours, in pixels (EMU / `emuPerPx`). */
+interface DiagramShapeView {
+  /** Shape id: the `dsp:sp/@modelId` presentation point, or `reflow-<kind>-<nodeId>`. */
+  id: string;
+  /** Preset geometry (`roundRect`, `ellipse`), or `custom`. */
+  shapeType?: string;
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+  /** Rotation in degrees. */
+  rotation?: number;
+  /** Horizontal/vertical mirrors declared on the cached drawing transform. */
+  flipHorizontal?: boolean;
+  flipVertical?: boolean;
+  /** Skew along the X axis in degrees. */
+  skewX?: number;
+  /** Skew along the Y axis in degrees. */
+  skewY?: number;
+  /** Preset-geometry adjustment values from `a:prstGeom/a:avLst`. */
+  shapeAdjustments?: Record<string, number>;
+  /**
+   * The cached shape declares `a:noFill`. Renderers must leave it unpainted rather than
+   * substituting a palette colour, because these shapes usually sit on top of a painted shape
+   * whose fill has to stay visible.
+   */
+  fillNone?: boolean;
+  /** Solid fill colour (hex). */
+  fillColor?: string;
+  /**
+   * Opacity (0..1) of the solid fill, from the colour's `a:alpha` (Basic Venn paints its circles
+   * at 50% so overlaps blend). Absent when opaque.
+   */
+  fillOpacity?: number;
+  /** Gradient fill stops when the cached shape uses `a:gradFill` (positions 0..100). */
+  fillGradientStops?: DiagramShapeGradientStop[];
+  /** Gradient geometry type (`linear` for `a:lin`, `radial` for `a:path`). */
+  fillGradientType?: 'linear' | 'radial';
+  /** Linear gradient angle in degrees (0..360). */
+  fillGradientAngle?: number;
+  /** Pattern fill preset name from `a:pattFill/@prst` (e.g. "pct50", "cross"). */
+  fillPatternPreset?: string;
+  /** Pattern fill foreground colour (hex) from `a:pattFill/a:fgClr`. */
+  fillPatternForegroundColor?: string;
+  /** Pattern fill background colour (hex) from `a:pattFill/a:bgClr`. */
+  fillPatternBackgroundColor?: string;
+  /** Relationship id of a picture (blip) fill's embedded image (`a:blip/@r:embed`). */
+  fillBlipEmbedId?: string;
+  /** Resolved data-URI/URL for a picture fill, when the host could resolve the image part. */
+  fillImageUrl?: string;
+  /** Whether the cached shape carries an outer-shadow effect (`a:effectLst`). */
+  hasShadow?: boolean;
+  /** Resolved outer-shadow colour (hex), when present. */
+  shadowColor?: string;
+  /** Stroke colour (hex). */
+  strokeColor?: string;
+  /** Stroke width in points. */
+  strokeWidth?: number;
+  /** Text content of the shape (paragraphs joined by a newline). */
+  text?: string;
+  /** Font size in CSS pixels. */
+  fontSize?: number;
+  /** Font colour (hex). */
+  fontColor?: string;
+  /** Authored font family from the first styled run. */
+  fontFamily?: string;
+  /** Authored font weight (400 or 700). */
+  fontWeight?: number;
+  /** Authored font style. */
+  fontStyle?: 'normal' | 'italic';
+  /** Absolute line height in CSS pixels from `a:spcPts`. */
+  lineHeight?: number;
+  /** Relative line height from `a:spcPct`. */
+  lineHeightRatio?: number;
+  /** Absolute spacing after a paragraph in CSS pixels. */
+  lineSpacingAfter?: number;
+  /** Relative spacing after a paragraph. */
+  lineSpacingAfterRatio?: number;
+  /** Text-body insets in CSS pixels. */
+  textInsetLeft?: number;
+  textInsetTop?: number;
+  textInsetRight?: number;
+  textInsetBottom?: number;
+  /** DiagramML text vertical anchor (`t`, `ctr`, or `b`). */
+  textVerticalAnchor?: string;
+  /** Independent DiagramML text-frame geometry from `dsp:txXfrm`. */
+  textFrameX?: number;
+  textFrameY?: number;
+  textFrameWidth?: number;
+  textFrameHeight?: number;
+  /**
+   * The presentation style label (`presStyleLbl`: `node1`, `revTx`, `sibTrans2D1`, ...) of the
+   * layout node a regenerated shape was laid out from, when the layout engine reports it;
+   * `undefined` on cached (parsed) shapes.
+   */
+  styleLabel?: string;
+}
+//#endregion
 //#region pptx/core/types/smart-art-chrome.d.ts
 /**
  * Background / outline extracted from `dgm:bg` and `dgm:whole`.
@@ -1299,7 +1615,9 @@ type SmartArtStyle = DiagramStyleIntensity;
  */
 type PptxSmartArtConnection = DiagramConnection;
 /**
- * A pre-computed shape from `ppt/diagrams/drawing*.xml`.
+ * A pre-computed shape from `ppt/diagrams/drawing*.xml`: the neutral
+ * {@link DiagramShapeView} (geometry in pixels, resolved colours, text style)
+ * plus the pptx rich-text segments, 3D and custom-geometry slots.
  *
  * @example
  * ```ts
@@ -1313,112 +1631,9 @@ type PptxSmartArtConnection = DiagramConnection;
  * // => satisfies PptxSmartArtDrawingShape
  * ```
  */
-interface PptxSmartArtDrawingShape extends PptxCustomPathProperties {
-  /** Shape ID within the drawing. */
-  id: string;
-  /** Preset geometry type (e.g. "roundRect", "ellipse"). */
-  shapeType?: string;
-  /** Position and size in EMU-based pixels. */
-  x: number;
-  y: number;
-  width: number;
-  height: number;
-  /** Rotation in degrees. */
-  rotation?: number;
-  /** Horizontal/vertical mirrors declared on the cached drawing transform. */
-  flipHorizontal?: boolean;
-  flipVertical?: boolean;
-  /** Skew along the X axis in degrees. */
-  skewX?: number;
-  /** Skew along the Y axis in degrees. */
-  skewY?: number;
-  /** Preset-geometry adjustment values from `a:prstGeom/a:avLst`. */
-  shapeAdjustments?: Record<string, number>;
-  /**
-   * The cached shape declares `a:noFill`. Renderers must leave it unpainted
-   * rather than substituting a palette colour, because these shapes usually sit
-   * on top of a painted shape whose fill has to stay visible.
-   */
-  fillNone?: boolean;
-  /** Solid fill colour (hex). */
-  fillColor?: string;
-  /**
-   * Opacity (0..1) of the solid fill, from the colour's `a:alpha` (Basic Venn
-   * paints its circles at 50% so overlaps blend). Absent when opaque.
-   */
-  fillOpacity?: number;
-  /**
-   * Gradient fill stops when the cached shape uses `a:gradFill`. Positions are
-   * 0..100 (percent). Renderers emit an SVG/CSS gradient instead of a flat box.
-   */
-  fillGradientStops?: Array<{
-    color: string;
-    position: number;
-    opacity?: number;
-  }>;
-  /** Gradient geometry type (`linear` for `a:lin`, `radial` for `a:path`). */
-  fillGradientType?: 'linear' | 'radial';
-  /** Linear gradient angle in degrees (0..360). */
-  fillGradientAngle?: number;
-  /** Pattern fill preset name from `a:pattFill/@prst` (e.g. "pct50", "cross"). */
-  fillPatternPreset?: string;
-  /** Pattern fill foreground colour (hex) from `a:pattFill/a:fgClr`. */
-  fillPatternForegroundColor?: string;
-  /** Pattern fill background colour (hex) from `a:pattFill/a:bgClr`. */
-  fillPatternBackgroundColor?: string;
-  /**
-   * Relationship id of a picture (blip) fill's embedded image, from
-   * `a:blipFill/a:blip/@r:embed`. The image bytes are resolved separately; see
-   * {@link fillImageUrl}.
-   */
-  fillBlipEmbedId?: string;
-  /**
-   * Resolved data-URI/URL for a picture (blip) fill, when the embedded image
-   * part could be resolved. Absent when only {@link fillBlipEmbedId} is known.
-   */
-  fillImageUrl?: string;
-  /** Whether the cached shape carries an outer-shadow effect (`a:effectLst`). */
-  hasShadow?: boolean;
-  /** Resolved outer-shadow colour (hex), when present. */
-  shadowColor?: string;
-  /** Stroke colour (hex). */
-  strokeColor?: string;
-  /** Stroke width in points. */
-  strokeWidth?: number;
-  /** Text content of the shape. */
-  text?: string;
+interface PptxSmartArtDrawingShape extends DiagramShapeView, PptxCustomPathProperties {
   /** Standard rich-text segments projected from the associated SmartArt node. */
   textSegments?: TextSegment[];
-  /** Font size in CSS pixels. */
-  fontSize?: number;
-  /** Font colour (hex). */
-  fontColor?: string;
-  /** Authored font family from the first styled run. */
-  fontFamily?: string;
-  /** Authored font weight (400 or 700). */
-  fontWeight?: number;
-  /** Authored font style. */
-  fontStyle?: 'normal' | 'italic';
-  /** Absolute line height in CSS pixels from `a:spcPts`. */
-  lineHeight?: number;
-  /** Relative line height from `a:spcPct`. */
-  lineHeightRatio?: number;
-  /** Absolute spacing after a paragraph in CSS pixels. */
-  lineSpacingAfter?: number;
-  /** Relative spacing after a paragraph. */
-  lineSpacingAfterRatio?: number;
-  /** Text-body insets in CSS pixels. */
-  textInsetLeft?: number;
-  textInsetTop?: number;
-  textInsetRight?: number;
-  textInsetBottom?: number;
-  /** DiagramML text vertical anchor (`t`, `ctr`, or `b`). */
-  textVerticalAnchor?: string;
-  /** Independent DiagramML text-frame geometry from `dsp:txXfrm`. */
-  textFrameX?: number;
-  textFrameY?: number;
-  textFrameWidth?: number;
-  textFrameHeight?: number;
   /**
    * 3D scene (camera/light rig/backdrop) from `dsp:spPr/a:scene3d`, when this
    * cached shape carries its own per-shape camera. Bevel quick styles
@@ -1442,13 +1657,6 @@ interface PptxSmartArtDrawingShape extends PptxCustomPathProperties {
    * shape body.
    */
   text3d?: Text3DStyle;
-  /**
-   * The presentation style label (`presStyleLbl`: `node1`, `revTx`,
-   * `sibTrans2D1`, ...) of the layout node a REGENERATED shape was laid out
-   * from, when the layout engine reports it. Picks the quick-style label
-   * whose 3D the shape takes; `undefined` on cached (parsed) shapes.
-   */
-  styleLabel?: string;
 }
 /**
  * Complete parsed SmartArt data for a {@link SmartArtPptxElement}: the neutral
@@ -1508,5 +1716,5 @@ interface PptxSmartArtData extends DiagramData {
   drawingDirty?: boolean;
 }
 //#endregion
-export { DiagramNodeTextParagraphItem as $, PptxSmartArtNode as A, DiagramNumericRule as At, PptxSmartArtTextRun as B, CustomGeometryPoint as Bt, PptxSmartArtIteratorAttributes as C, DiagramShapeAdjustment as Ct, PptxSmartArtLayoutNode as D, DiagramConstraintPointType as Dt, PptxSmartArtLayoutDefinition as E, DiagramConstraintOperator as Et, PptxSmartArtQuickStyleLabel as F, DiagramStyleIntensity as Ft, PptxSmartArtChrome as G, PptxCustomPathProperties as Gt, SmartArtLayout as H, CustomGeometrySegment as Ht, PptxSmartArtResolvedStyleRef as I, AdjustHandlePolar as It, DiagramLayoutPreset as J, PptxSmartArtRawBackgroundFill as K, PptxSmartArtShapeAdjustment as L, AdjustHandleXY as Lt, PptxSmartArtNumericRule as M, DiagramConnection as Mt, PptxSmartArtPresLayoutVars as N, DiagramLayoutType as Nt, PptxSmartArtLayoutNodeShape as O, DiagramConstraintRelationship as Ot, PptxSmartArtQuickStyle as P, DiagramNodeCustomLayout as Pt, DiagramNodeTextParagraph as Q, PptxSmartArtTextParagraph as R, ConnectionSite as Rt, PptxSmartArtHueDirection as S, DiagramLocalizedText as St, PptxSmartArtLayoutCategory as T, DiagramConstraint as Tt, SmartArtNodeCustomLayout as U, CustomGeometryTextRect as Ut, PptxSmartArtWhen as V, CustomGeometryRawData as Vt, SmartArtRoleColorList as W, GeometryAdjustmentHandle as Wt, DiagramNode as X, DiagramPresLayoutVars as Y, DiagramNodeStyle as Z, PptxSmartArtConstraintTarget as _, DiagramForEach as _t, SmartArtLayoutType as a, DiagramDefinitionCategory as at, PptxSmartArtDefinitionText as b, DiagramLayoutCategory as bt, PptxSmartArtChoose as c, DiagramHueDirection as ct, PptxSmartArtColorStyleLabel as d, DiagramResolvedStyleRef as dt, DiagramNodeTextRun as et, PptxSmartArtColorTransform as f, DiagramRoleColorList as ft, PptxSmartArtConstraintRelationship as g, DiagramChoose as gt, PptxSmartArtConstraintPointType as h, DiagramAlgorithmParameter as ht, SmartArtColorScheme as i, DiagramColorTransformLabel as it, PptxSmartArtNodeStyle as j, DiagramColorScheme as jt, PptxSmartArtLocalizedText as k, DiagramConstraintTarget as kt, PptxSmartArtColorApplicationMethod as l, DiagramQuickStyle as lt, PptxSmartArtConstraintOperator as m, DiagramLayoutNode as mt, PptxSmartArtData as n, DiagramColorListMetadata as nt, SmartArtStyle as o, DiagramDefinitionMetadata as ot, PptxSmartArtConstraint as p, DiagramLayoutDefinition as pt, DiagramData as q, PptxSmartArtDrawingShape as r, DiagramColorTransform as rt, PptxSmartArtAlgorithmParameter as s, DiagramDefinitionText as st, PptxSmartArtConnection as t, DiagramColorApplicationMethod as tt, PptxSmartArtColorListMetadata as u, DiagramQuickStyleLabel as ut, PptxSmartArtDefinitionCategory as v, DiagramIteratorAttributes as vt, PptxSmartArtLayoutAlgorithm as w, DiagramWhen as wt, PptxSmartArtForEach as x, DiagramLayoutNodeShape as xt, PptxSmartArtDefinitionMetadata as y, DiagramLayoutAlgorithm as yt, PptxSmartArtTextParagraphItem as z, CustomGeometryPath as zt };
-//# sourceMappingURL=smart-art-ENMMEbmW.d.ts.map
+export { DiagramColorTransformLabel as $, PptxSmartArtNode as A, DiagramStyleIntensity as At, PptxSmartArtTextRun as B, CustomGeometryPoint as Bt, PptxSmartArtIteratorAttributes as C, DiagramConstraintRelationship as Ct, PptxSmartArtLayoutNode as D, DiagramConnection as Dt, PptxSmartArtLayoutDefinition as E, DiagramColorScheme as Et, PptxSmartArtQuickStyleLabel as F, DiagramNodeTextRun as Ft, PptxSmartArtChrome as G, PptxCustomPathProperties as Gt, SmartArtLayout as H, CustomGeometrySegment as Ht, PptxSmartArtResolvedStyleRef as I, AdjustHandlePolar as It, DiagramLayoutPreset as J, PptxSmartArtRawBackgroundFill as K, PptxSmartArtShapeAdjustment as L, AdjustHandleXY as Lt, PptxSmartArtNumericRule as M, DiagramNodeStyle as Mt, PptxSmartArtPresLayoutVars as N, DiagramNodeTextParagraph as Nt, PptxSmartArtLayoutNodeShape as O, DiagramLayoutType as Ot, PptxSmartArtQuickStyle as P, DiagramNodeTextParagraphItem as Pt, DiagramColorTransform as Q, PptxSmartArtTextParagraph as R, ConnectionSite as Rt, PptxSmartArtHueDirection as S, DiagramConstraintPointType as St, PptxSmartArtLayoutCategory as T, DiagramNumericRule as Tt, SmartArtNodeCustomLayout as U, CustomGeometryTextRect as Ut, PptxSmartArtWhen as V, CustomGeometryRawData as Vt, SmartArtRoleColorList as W, GeometryAdjustmentHandle as Wt, DiagramColorApplicationMethod as X, DiagramPresLayoutVars as Y, DiagramColorListMetadata as Z, PptxSmartArtConstraintTarget as _, DiagramLocalizedText as _t, SmartArtLayoutType as a, DiagramQuickStyleLabel as at, PptxSmartArtDefinitionText as b, DiagramConstraint as bt, PptxSmartArtChoose as c, DiagramLayoutDefinition as ct, PptxSmartArtColorStyleLabel as d, DiagramChoose as dt, DiagramDefinitionCategory as et, PptxSmartArtColorTransform as f, DiagramForEach as ft, PptxSmartArtConstraintRelationship as g, DiagramLayoutNodeShape as gt, PptxSmartArtConstraintPointType as h, DiagramLayoutCategory as ht, SmartArtColorScheme as i, DiagramQuickStyle as it, PptxSmartArtNodeStyle as j, DiagramNode as jt, PptxSmartArtLocalizedText as k, DiagramNodeCustomLayout as kt, PptxSmartArtColorApplicationMethod as l, DiagramLayoutNode as lt, PptxSmartArtConstraintOperator as m, DiagramLayoutAlgorithm as mt, PptxSmartArtData as n, DiagramDefinitionText as nt, SmartArtStyle as o, DiagramResolvedStyleRef as ot, PptxSmartArtConstraint as p, DiagramIteratorAttributes as pt, DiagramData as q, PptxSmartArtDrawingShape as r, DiagramHueDirection as rt, PptxSmartArtAlgorithmParameter as s, DiagramRoleColorList as st, PptxSmartArtConnection as t, DiagramDefinitionMetadata as tt, PptxSmartArtColorListMetadata as u, DiagramAlgorithmParameter as ut, PptxSmartArtDefinitionCategory as v, DiagramShapeAdjustment as vt, PptxSmartArtLayoutAlgorithm as w, DiagramConstraintTarget as wt, PptxSmartArtForEach as x, DiagramConstraintOperator as xt, PptxSmartArtDefinitionMetadata as y, DiagramWhen as yt, PptxSmartArtTextParagraphItem as z, CustomGeometryPath as zt };
+//# sourceMappingURL=smart-art-BEEl0l8X.d.ts.map