ooxml-core 1.1.0 → 1.2.0

package/dist/pptx/chunks/{smart-art-CO2jmJFf.d.ts → smart-art-Q2kZQtHh.d.ts}

@@ -1814,134 +1814,95 @@ interface DiagramNodeCustomLayout {
   hasCustomTransform?: boolean;
 }
 //#endregion
-//#region pptx/core/types/smart-art-chrome.d.ts
-/**
- * Background / outline extracted from `dgm:bg` and `dgm:whole`.
- *
- * @example
- * ```ts
- * const chrome: PptxSmartArtChrome = {
- *   backgroundColor: "#F0F0F0",
- *   outlineColor: "#333333",
- *   outlineWidth: 1,
- * };
- * // => satisfies PptxSmartArtChrome
- * ```
- */
-interface PptxSmartArtChrome {
-  /**
-   * Background fill colour (hex). When the real `dgm:bg` fill is a gradient
-   * or pattern (see {@link PptxSmartArtChrome.backgroundFillXml}), this is an
-   * APPROXIMATION (the gradient's first stop, or the pattern's foreground
-   * colour) for a consumer that only wants one display colour, not the full fill.
-   */
-  backgroundColor?: string;
-  /**
-   * Raw `dgm:bg` fill XML, present only when the background is a gradient or
-   * pattern fill (a solid fill is fully captured by {@link PptxSmartArtChrome.backgroundColor}
-   * alone). Round-trip only: `smartart-save-chrome.ts` re-emits this verbatim
-   * instead of flattening the fill to a solid colour on save.
-   */
-  backgroundFillXml?: PptxSmartArtRawBackgroundFill;
-  /** Outline stroke colour (hex). */
-  outlineColor?: string;
-  /** Outline stroke width in points. */
-  outlineWidth?: number;
-}
-/**
- * A `dgm:bg` fill this viewer doesn't fully model as first-class chrome
- * (gradient or pattern), preserved verbatim for round-trip. See
- * {@link PptxSmartArtChrome.backgroundFillXml}.
- */
-interface PptxSmartArtRawBackgroundFill {
-  /** Local element name of the fill under `dgm:bg` (`gradFill` or `pattFill`). */
-  localName: 'gradFill' | 'pattFill';
-  /** The fill element's own attributes/children, as parsed. */
-  xml: XmlObject;
-}
-//#endregion
-//#region pptx/core/types/smart-art-constraint-rules.d.ts
-type PptxSmartArtConstraintRelationship = 'self' | 'ch' | 'des';
-type PptxSmartArtConstraintOperator = 'none' | 'equ' | 'gte' | 'lte';
-type PptxSmartArtConstraintPointType = 'all' | 'doc' | 'node' | 'norm' | 'nonNorm' | 'asst' | 'nonAsst' | 'parTrans' | 'pres' | 'sibTrans';
-interface PptxSmartArtConstraintTarget {
-  for?: PptxSmartArtConstraintRelationship;
-  forName?: string;
-  pointType?: PptxSmartArtConstraintPointType;
+//#region diagram/model/constraint-rules.d.ts
+type DiagramConstraintRelationship = 'self' | 'ch' | 'des';
+type DiagramConstraintOperator = 'none' | 'equ' | 'gte' | 'lte';
+type DiagramConstraintPointType = 'all' | 'doc' | 'node' | 'norm' | 'nonNorm' | 'asst' | 'nonAsst' | 'parTrans' | 'pres' | 'sibTrans';
+interface DiagramConstraintTarget {
+  for?: DiagramConstraintRelationship | undefined;
+  forName?: string | undefined;
+  pointType?: DiagramConstraintPointType | undefined;
 }
 /** Editable DiagramML CT_Constraint. */
-interface PptxSmartArtConstraint extends PptxSmartArtConstraintTarget {
+interface DiagramConstraint<R = unknown> extends DiagramConstraintTarget {
   type: string;
-  referenceType?: string;
-  referenceFor?: PptxSmartArtConstraintRelationship;
-  referenceForName?: string;
-  referencePointType?: PptxSmartArtConstraintPointType;
-  operator?: PptxSmartArtConstraintOperator;
-  value?: number;
-  factor?: number;
+  referenceType?: string | undefined;
+  referenceFor?: DiagramConstraintRelationship | undefined;
+  referenceForName?: string | undefined;
+  referencePointType?: DiagramConstraintPointType | undefined;
+  operator?: DiagramConstraintOperator | undefined;
+  value?: number | undefined;
+  factor?: number | undefined;
   /** Original constraint retained for foreign attributes and extension content. */
-  rawXml?: XmlObject;
+  rawXml?: R | undefined;
 }
 /** Editable DiagramML CT_NumericRule. */
-interface PptxSmartArtNumericRule extends PptxSmartArtConstraintTarget {
+interface DiagramNumericRule<R = unknown> extends DiagramConstraintTarget {
   type: string;
-  value?: number;
-  factor?: number;
-  max?: number;
+  value?: number | undefined;
+  factor?: number | undefined;
+  max?: number | undefined;
   /** Original rule retained for foreign attributes and extension content. */
-  rawXml?: XmlObject;
+  rawXml?: R | undefined;
 }
 //#endregion
-//#region pptx/core/types/smart-art-layout-primitives.d.ts
-interface PptxSmartArtLocalizedText {
+//#region diagram/model/layout-primitives.d.ts
+/**
+ * Leaf DiagramML layout-definition types (localized text, categories,
+ * algorithm parameters, iterator/`dgm:forEach`/`dgm:when`/`dgm:choose`
+ * attributes, and `dgm:shape` metadata). `R` is the raw XML node a reader
+ * keeps for round-trip (pptx: its `XmlObject` tree). Moved from
+ * `pptx/core/types/smart-art-layout-primitives.ts`.
+ */
+interface DiagramLocalizedText {
   value: string;
   language?: string;
 }
-interface PptxSmartArtLayoutCategory {
+interface DiagramLayoutCategory {
   type: string;
   priority: number;
 }
-interface PptxSmartArtAlgorithmParameter {
+interface DiagramAlgorithmParameter {
   type: string;
-  value?: string;
+  value?: string | undefined;
 }
 /** Typed DiagramML CT_Algorithm data attached to a layout node. */
-interface PptxSmartArtLayoutAlgorithm {
+interface DiagramLayoutAlgorithm {
   type: string;
   revision?: number;
-  parameters?: PptxSmartArtAlgorithmParameter[];
-}
-interface PptxSmartArtIteratorAttributes {
-  name?: string;
-  reference?: string;
-  axis?: string[];
-  pointTypes?: string[];
-  hideLastTransition?: boolean[];
-  start?: number[];
-  count?: number[];
-  step?: number[];
-}
-interface PptxSmartArtForEach extends PptxSmartArtIteratorAttributes {
-  rawXml?: XmlObject;
-}
-interface PptxSmartArtWhen extends PptxSmartArtIteratorAttributes {
+  parameters?: DiagramAlgorithmParameter[];
+}
+interface DiagramIteratorAttributes {
+  name?: string | undefined;
+  reference?: string | undefined;
+  axis?: string[] | undefined;
+  pointTypes?: string[] | undefined;
+  hideLastTransition?: boolean[] | undefined;
+  start?: number[] | undefined;
+  count?: number[] | undefined;
+  step?: number[] | undefined;
+}
+interface DiagramForEach<R = unknown> extends DiagramIteratorAttributes {
+  rawXml?: R;
+}
+interface DiagramWhen<R = unknown> extends DiagramIteratorAttributes {
   function: string;
-  argument?: string;
+  argument?: string | undefined;
   operator: string;
   value: string;
-  rawXml?: XmlObject;
+  rawXml?: R;
 }
-interface PptxSmartArtChoose {
+interface DiagramChoose<R = unknown> {
   name?: string;
-  when: PptxSmartArtWhen[];
+  when: DiagramWhen<R>[];
   otherwise?: {
     name?: string;
-    rawXml?: XmlObject;
+    rawXml?: R;
   } | null;
-  rawXml?: XmlObject;
+  rawXml?: R;
 }
 /** A single `dgm:adj/@val` adjustment, keyed by its `@idx` (1-based, like `a:gd`). */
-interface PptxSmartArtShapeAdjustment {
+interface DiagramShapeAdjustment {
   index: number;
   value: number;
 }
@@ -1951,11 +1912,11 @@ interface PptxSmartArtShapeAdjustment {
  * definitions use so a layoutNode can be e.g. an ellipse or a chevron instead
  * of the arranger family's hardcoded default shape.
  */
-interface PptxSmartArtLayoutNodeShape {
+interface DiagramLayoutNodeShape {
   /** `dgm:shape/@type`: a preset geometry name (`roundRect`, `ellipse`, `chevron`, `conn`, ...). */
   presetGeometry?: string;
   /** `dgm:adjLst/dgm:adj` entries (adjustment index -> value, as authored). */
-  adjustments?: PptxSmartArtShapeAdjustment[];
+  adjustments?: DiagramShapeAdjustment[];
   /** `dgm:shape/@hideGeom`: the shape is present only to size text, never painted. */
   hideGeometry?: boolean;
   /**
@@ -1968,20 +1929,20 @@ interface PptxSmartArtLayoutNodeShape {
   lkTxEntry?: boolean;
 }
 //#endregion
-//#region pptx/core/types/smart-art-layout-definition.d.ts
+//#region diagram/model/layout-definition.d.ts
 /** Identity and ordering metadata from DiagramML CT_LayoutNode. */
-interface PptxSmartArtLayoutNode {
-  name?: string;
-  styleLabel?: string;
-  childOrder?: 'b' | 't';
-  moveWith?: string;
-  algorithm?: PptxSmartArtLayoutAlgorithm;
-  forEach?: PptxSmartArtForEach[];
-  choose?: PptxSmartArtChoose[];
-  constraints?: PptxSmartArtConstraint[];
-  rules?: PptxSmartArtNumericRule[];
+interface DiagramLayoutNode<R = unknown> {
+  name?: string | undefined;
+  styleLabel?: string | undefined;
+  childOrder?: 'b' | 't' | undefined;
+  moveWith?: string | undefined;
+  algorithm?: DiagramLayoutAlgorithm | undefined;
+  forEach?: DiagramForEach<R>[] | undefined;
+  choose?: DiagramChoose<R>[] | undefined;
+  constraints?: DiagramConstraint<R>[] | undefined;
+  rules?: DiagramNumericRule<R>[] | undefined;
   /** `dgm:shape`: this node's own preset geometry override, when present. */
-  shape?: PptxSmartArtLayoutNodeShape;
+  shape?: DiagramLayoutNodeShape | undefined;
   /**
    * `dgm:presOf` (CT_PresentationOf, same iterator shape as `dgm:forEach`):
    * which data-model point(s) this node's OWN text/geometry binds to -
@@ -1995,7 +1956,7 @@ interface PptxSmartArtLayoutNode {
    * layout's `roleText`/`bodyText`) apart from a same-generation sibling
    * that positions or decorates instead.
    */
-  presentationOf?: PptxSmartArtIteratorAttributes;
+  presentationOf?: DiagramIteratorAttributes | undefined;
   /**
    * EVERY `dgm:constr` reachable from this node, including ones declared
    * inside a `dgm:choose`/`dgm:if`/`dgm:else` that wraps THIS layoutNode's
@@ -2017,8 +1978,8 @@ interface PptxSmartArtLayoutNode {
    * `smartart-constraint-solver.ts`'s `buildConstraintIndex`, the only
    * consumer.
    */
-  allConstraints?: PptxSmartArtConstraint[];
-  children?: PptxSmartArtLayoutNode[];
+  allConstraints?: DiagramConstraint<R>[] | undefined;
+  children?: DiagramLayoutNode<R>[] | undefined;
   /**
    * The iterator attributes of the ENCLOSING `dgm:forEach` this node was
    * found through, when `nestedLayoutNodes` (`smartart-layout-definition
@@ -2045,7 +2006,7 @@ interface PptxSmartArtLayoutNode {
    * consumer. Read-only / interpretation-only, like `allConstraints`:
    * never round-tripped by `applySmartArtLayoutDefinition`.
    */
-  forEachOrigin?: PptxSmartArtIteratorAttributes;
+  forEachOrigin?: DiagramIteratorAttributes | undefined;
   /**
    * The conditions of EVERY enclosing `dgm:if` this node was found through,
    * outermost first, when `nestedLayoutNodes` (`smartart-layout-
@@ -2083,7 +2044,7 @@ interface PptxSmartArtLayoutNode {
    * guard already accumulated before it. Evaluate with `smartart-layout-
    * interpreter-when.ts`'s `evaluateWhen`, once per entry, ANDed.
    */
-  chooseGuard?: PptxSmartArtWhen[];
+  chooseGuard?: DiagramWhen<R>[] | undefined;
   /**
    * ROUND 42: the forEach iterator active WHEN EACH ENTRY of {@link
    * chooseGuard} was declared (index-parallel with it, `undefined` per
@@ -2107,7 +2068,7 @@ interface PptxSmartArtLayoutNode {
    * `undefined` whenever {@link chooseGuard} itself is (no enclosing
    * choose at all).
    */
-  chooseGuardOrigins?: (PptxSmartArtIteratorAttributes | undefined)[];
+  chooseGuardOrigins?: (DiagramIteratorAttributes | undefined)[] | undefined;
   /**
    * The chain of every enclosing `dgm:choose`'s own GROUP identity + this
    * node's ordinal position within it + THAT branch's own condition,
@@ -2155,9 +2116,9 @@ interface PptxSmartArtLayoutNode {
   chooseGroups?: {
     id: string;
     ordinal: number;
-    guard?: PptxSmartArtWhen;
-    origin?: PptxSmartArtIteratorAttributes;
-  }[];
+    guard?: DiagramWhen<R> | undefined;
+    origin?: DiagramIteratorAttributes | undefined;
+  }[] | undefined;
   /**
    * Every `dgm:presOf` candidate reachable through a `dgm:choose`/`dgm:if`/
    * `dgm:else` wrapping THIS node's OWN presOf (as opposed to
@@ -2179,9 +2140,9 @@ interface PptxSmartArtLayoutNode {
    * own runtime would, first-match-wins.
    */
   presentationOfCandidates?: {
-    guard: PptxSmartArtWhen[];
-    presentationOf: PptxSmartArtIteratorAttributes;
-  }[];
+    guard: DiagramWhen<R>[];
+    presentationOf: DiagramIteratorAttributes;
+  }[] | undefined;
   /**
    * SESSION 17: every `dgm:rule` reachable through a `dgm:choose`/`dgm:if`/
    * `dgm:else` wrapping THIS node's `ruleLst` (a genuinely count-gated rule
@@ -2195,9 +2156,9 @@ interface PptxSmartArtLayoutNode {
    * how the guard is evaluated against the real satellite count.
    */
   ruleCandidates?: {
-    guard: PptxSmartArtWhen[];
-    rule: PptxSmartArtNumericRule;
-  }[];
+    guard: DiagramWhen<R>[];
+    rule: DiagramNumericRule<R>;
+  }[] | undefined;
   /**
    * ROUND 39: every `dgm:constr` reachable through a `dgm:choose`/`dgm:if`/
    * `dgm:else` wrapping THIS node's `constrLst` (a genuinely count/position
@@ -2213,21 +2174,21 @@ interface PptxSmartArtLayoutNode {
    * pre-existing blind union of every branch is not enough on its own.
    */
   constraintCandidates?: {
-    guard: PptxSmartArtWhen[];
-    constraint: PptxSmartArtConstraint;
-  }[];
+    guard: DiagramWhen<R>[];
+    constraint: DiagramConstraint<R>;
+  }[] | undefined;
 }
 /** Metadata and root node from DiagramML CT_DiagramDefinition. */
-interface PptxSmartArtLayoutDefinition {
-  uniqueId?: string;
-  minimumVersion?: string;
-  defaultStyle?: string;
-  titles?: PptxSmartArtLocalizedText[];
-  descriptions?: PptxSmartArtLocalizedText[];
-  categories?: PptxSmartArtLayoutCategory[];
-  rootNode: PptxSmartArtLayoutNode;
+interface DiagramLayoutDefinition<R = unknown> {
+  uniqueId?: string | undefined;
+  minimumVersion?: string | undefined;
+  defaultStyle?: string | undefined;
+  titles?: DiagramLocalizedText[] | undefined;
+  descriptions?: DiagramLocalizedText[] | undefined;
+  categories?: DiagramLayoutCategory[] | undefined;
+  rootNode: DiagramLayoutNode<R>;
   /** Original definition retained for constraint evaluation and foreign rules. */
-  rawXml?: XmlObject;
+  rawXml?: R | undefined;
   /**
    * The un-parsed layout-definition part text (starting at `<dgm:layoutDef>`,
    * XML declaration included). `rawXml` above loses the document order of
@@ -2239,10 +2200,142 @@ interface PptxSmartArtLayoutDefinition {
    * `undefined` when the part could not be read (matches `rawXml`'s own
    * optionality); the engine falls back to the legacy interpreter then.
    */
-  rawXmlText?: string;
+  rawXmlText?: string | undefined;
+}
+//#endregion
+//#region diagram/model/style-definition.d.ts
+/** Editable metadata shared by DiagramML quick-style and color definitions. */
+interface DiagramDefinitionText {
+  value: string;
+  language?: string;
+}
+interface DiagramDefinitionCategory {
+  type: string;
+  priority: number;
+}
+type DiagramColorApplicationMethod = 'span' | 'cycle' | 'repeat';
+type DiagramHueDirection = 'cw' | 'ccw';
+/** CT_Colors application metadata. Color-choice children remain preserved XML. */
+interface DiagramColorListMetadata {
+  method?: DiagramColorApplicationMethod;
+  hueDirection?: DiagramHueDirection;
+}
+/**
+ * A quick-style label's `a:lnRef`/`a:fillRef`/`a:effectRef`/`a:fontRef`
+ * (`CT_ShapeStyle`, the same complex type an ordinary shape's `p:style`
+ * uses), resolved against the theme's `fmtScheme` at parse time instead of
+ * the coarse subtle/moderate/intense enum ({@link DiagramQuickStyle.effectIntensity}).
+ * Only populated when a theme format scheme was available when the quick
+ * style was parsed. See G13 in the 2026-09 diagram audit.
+ */
+interface DiagramResolvedStyleRef {
+  fillColor?: string;
+  fillMode?: 'solid' | 'gradient' | 'pattern' | 'none' | 'theme';
+  strokeColor?: string;
+  strokeWidth?: number;
+  /** `a:effectRef`'s theme-resolved outer shadow colour, when the style has one. */
+  shadowColor?: string;
+  /** `a:fontRef`'s theme-resolved typeface (`+mn-lt`/`+mj-lt` -> the theme's actual font). */
+  fontTypeface?: string;
+}
+/** CT_StyleLabel metadata from a quick-style definition. */
+interface DiagramQuickStyleLabel<Scene = unknown, Shape = unknown, Text = unknown> {
+  name: string;
+  /** Theme-resolved `dgm:style` refs for this label's role, when available. */
+  resolvedStyle?: DiagramResolvedStyleRef;
+  /**
+   * The label's own `dgm:scene3d` (per-shape camera + light rig). PowerPoint
+   * copies it onto a shape's cached `a:scene3d` unless it is the default
+   * front camera with a `threePt` light (see `applySmartArtQuickStyle3d`).
+   */
+  scene3d?: Scene;
+  /** The label's own `dgm:sp3d` (bevel / extrusion / contour / material); absent when empty. */
+  shape3d?: Shape;
+  /** The label's `dgm:txPr/a:sp3d` label-text extrusion (Bird's Eye Scene). */
+  text3d?: Text;
+}
+/** CT_CTStyleLabel metadata from a color-transform definition. */
+interface DiagramColorTransformLabel {
+  name: string;
+  fill?: DiagramColorListMetadata;
+  line?: DiagramColorListMetadata;
+  effect?: DiagramColorListMetadata;
+  textLine?: DiagramColorListMetadata;
+  textFill?: DiagramColorListMetadata;
+  textEffect?: DiagramColorListMetadata;
+}
+interface DiagramDefinitionMetadata {
+  uniqueId?: string;
+  minimumVersion?: string;
+  titles?: DiagramDefinitionText[];
+  descriptions?: DiagramDefinitionText[];
+  categories?: DiagramDefinitionCategory[];
+}
+/** Typed CT_ColorTransform metadata and the resolved legacy color palette. */
+interface DiagramColorTransform extends DiagramDefinitionMetadata {
+  /** Legacy resolved display name. */
+  name?: string;
+  /** Ordered resolved fill colors for rendering. */
+  fillColors: string[];
+  /** Ordered resolved line colors for rendering. */
+  lineColors: string[];
+  /** Ordered resolved text-fill colors (primary styleLbl `txFillClrLst`). */
+  textFillColors?: string[];
+  /** Ordered resolved text-line colors (primary styleLbl `txLinClrLst`). */
+  textLineColors?: string[];
+  /** Ordered resolved effect colors (primary styleLbl `effectClrLst`). */
+  effectColors?: string[];
+  /** Ordered resolved text-effect colors (primary styleLbl `txEffectClrLst`). */
+  textEffectColors?: string[];
+  /** Fill-list span/cycle + hue-direction interpolation of the primary styleLbl. */
+  fillInterpolation?: DiagramColorListMetadata;
+  /** Line-list span/cycle + hue-direction interpolation of the primary styleLbl. */
+  lineInterpolation?: DiagramColorListMetadata;
+  /** Ordered CT_CTStyleLabel metadata. */
+  labels?: DiagramColorTransformLabel[];
+  /**
+   * Every `styleLbl`'s own resolved fill/line colour list, keyed by name
+   * (e.g. `node1`, `asst0`, `bgShp`, `revTx`). Unlike {@link fillColors} /
+   * {@link lineColors} (which collapse to ONE "primary" node-role list),
+   * this keeps every role so a node can be coloured from its OWN role's
+   * palette (see `DiagramNode.styleRole` and `applySmartArtRoleColors`)
+   * instead of a generic cycled colour.
+   */
+  roleColors?: Record<string, DiagramRoleColorList>;
+}
+/** One colour-transform `styleLbl`'s resolved colour lists. */
+interface DiagramRoleColorList {
+  fill: string[];
+  line: string[];
+  /**
+   * `txFillClrLst`, when the label declares one (`revTx` -> `tx1`). A text
+   * node's colour comes from here; see `smartart-merged-text-label`.
+   */
+  textFill?: string[];
+}
+/** Typed CT_StyleDefinition metadata and legacy rendering hint. */
+interface DiagramQuickStyle<Scene = unknown, Shape = unknown, Text = unknown> extends DiagramDefinitionMetadata {
+  /** Legacy resolved display name. */
+  name?: string;
+  /** Legacy effect-intensity rendering hint. */
+  effectIntensity?: string;
+  /** Ordered CT_StyleLabel metadata. Complex style payload remains preserved XML. */
+  labels?: DiagramQuickStyleLabel<Scene, Shape, Text>[];
+  /**
+   * Whole-diagram 3D scene (camera preset/rotation/zoom/fov, light rig,
+   * backdrop) from the quick style's own `dgm:styleDef/dgm:scene3d`, present
+   * for the "Scene" quick styles (Brick, Flat, Metallic, Sunset, Bird's Eye
+   * Scene). One camera renders the whole diagram; per-shape `a:scene3d` is
+   * absent for those styles (see the cached drawing shape's own `scene3d`). Each
+   * `dgm:styleLbl` also carries its own per-label `dgm:scene3d`/`dgm:sp3d`
+   * ({@link DiagramQuickStyleLabel.scene3d} / `shape3d` / `text3d`),
+   * which PowerPoint bakes onto each cached shape; they are re-applied when a
+   * structural edit regenerates the shapes.
+   */
+  scene3d?: Scene;
 }
 //#endregion
-//#region pptx/core/types/smart-art-node.d.ts
+//#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,
@@ -2251,14 +2344,14 @@ interface PptxSmartArtLayoutDefinition {
  *
  * @example
  * ```ts
- * const run: PptxSmartArtTextRun = {
+ * const run: DiagramNodeTextRun = {
  *   text: "Bold",
  *   rPr: { "@_b": "1", "@_lang": "en-US" },
  * };
- * // => satisfies PptxSmartArtTextRun
+ * // => satisfies DiagramNodeTextRun
  * ```
  */
-interface PptxSmartArtTextRun {
+interface DiagramNodeTextRun<S = unknown> {
   /** Run text content. */
   text: string;
   /**
@@ -2267,20 +2360,20 @@ interface PptxSmartArtTextRun {
    */
   rPr?: Record<string, unknown>;
   /** Resolved standard shape-text style derived from {@link rPr}. */
-  style?: TextStyle;
+  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 PptxSmartArtTextParagraphItem = {
+type DiagramNodeTextParagraphItem<S = unknown> = {
   kind: 'run';
-  run: PptxSmartArtTextRun;
+  run: DiagramNodeTextRun<S>;
 } | {
   kind: 'break';
   rPr?: Record<string, unknown>;
-  style?: TextStyle;
+  style?: S;
   rawXml?: Record<string, unknown>;
   childOrder?: string[];
 } | {
@@ -2289,7 +2382,7 @@ type PptxSmartArtTextParagraphItem = {
   fieldType?: string;
   text: string;
   rPr?: Record<string, unknown>;
-  style?: TextStyle;
+  style?: S;
   pPr?: Record<string, unknown>;
   rawXml?: Record<string, unknown>;
   childOrder?: string[];
@@ -2303,15 +2396,15 @@ type PptxSmartArtTextParagraphItem = {
   value: unknown;
 };
 /** A complete `a:p` paragraph in a SmartArt data-model text body. */
-interface PptxSmartArtTextParagraph {
+interface DiagramNodeTextParagraph<S = unknown> {
   /** Paragraph properties (`a:pPr`) preserved verbatim. */
   pPr?: Record<string, unknown>;
   /** Text children in source order. */
-  items: PptxSmartArtTextParagraphItem[];
+  items: DiagramNodeTextParagraphItem<S>[];
   /** End-paragraph run properties (`a:endParaRPr`) preserved verbatim. */
   endParaRPr?: Record<string, unknown>;
   /** Resolved style for the paragraph terminator. */
-  endParaStyle?: TextStyle;
+  endParaStyle?: S;
   /** Raw paragraph XML used to retain unmodelled extension children on save. */
   rawXml?: Record<string, unknown>;
 }
@@ -2330,15 +2423,15 @@ interface PptxSmartArtTextParagraph {
  *
  * @example
  * ```ts
- * const style: PptxSmartArtNodeStyle = {
+ * const style: DiagramNodeStyle = {
  *   fillColor: "#FF0000",
  *   fontColor: "#FFFFFF",
  *   bold: true,
  * };
- * // => satisfies PptxSmartArtNodeStyle
+ * // => satisfies DiagramNodeStyle
  * ```
  */
-interface PptxSmartArtNodeStyle {
+interface DiagramNodeStyle {
   /** Solid fill colour override (hex, e.g. "#4F81BD"). */
   fillColor?: string;
   /** Outline / line colour override (hex). */
@@ -2350,32 +2443,12 @@ interface PptxSmartArtNodeStyle {
   /** Italic emphasis override for the node's runs. */
   italic?: boolean;
 }
-/**
- * Manual layout override for a `type="pres"` presentation point, read from its
- * `dgm:prSet` attributes. PowerPoint writes these when the user drags, resizes,
- * rotates, or flips a SmartArt node by hand in its own diagram editor; without
- * them the node silently reverts to its algorithmic position whenever there is
- * no cached `dsp:` drawing part to fall back on.
- *
- * Every field is optional: only the attributes actually present on `prSet` are
- * populated. Angle and scale/factor units are already normalised to degrees and
- * plain ratios (a `custScaleX="150000"` becomes `scaleX: 1.5`), so a consumer
- * never has to know the raw `60000ths-of-a-degree` / `100000ths-of-a-percent`
- * XML encodings.
- *
- * @example
- * ```ts
- * const custom: SmartArtNodeCustomLayout = { angle: 15, scaleX: 1.2 };
- * // => a node manually rotated 15 degrees and widened 20% in PowerPoint
- * ```
- */
-type SmartArtNodeCustomLayout = DiagramNodeCustomLayout;
 /**
  * A single node in the SmartArt data model.
  *
  * @example
  * ```ts
- * const node: PptxSmartArtNode = {
+ * const node: DiagramNode = {
  *   id: "1",
  *   text: "CEO",
  *   children: [
@@ -2383,16 +2456,16 @@ type SmartArtNodeCustomLayout = DiagramNodeCustomLayout;
  *     { id: "3", text: "VP Engineering", parentId: "1" },
  *   ],
  * };
- * // => satisfies PptxSmartArtNode
+ * // => satisfies DiagramNode
  * ```
  */
-interface PptxSmartArtNode {
+interface DiagramNode<S = unknown> {
   id: string;
   text: string;
   /** CT_Pt connection identifier, when the point references a connection. */
   connectionId?: string | null;
-  parentId?: string;
-  children?: PptxSmartArtNode[];
+  parentId?: string | undefined;
+  children?: DiagramNode<S>[];
   /** Node type from `@_type` attribute (e.g. "doc", "node", "asst", "pres"). */
   nodeType?: string;
   /**
@@ -2427,19 +2500,19 @@ interface PptxSmartArtNode {
    * 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?: PptxSmartArtTextRun[];
+  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?: PptxSmartArtTextParagraph[];
+  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?: PptxSmartArtNodeStyle;
+  style?: DiagramNodeStyle;
   /**
    * Manual layout override read from the node's `dgm:prSet` `cust*`
    * attributes (drag/resize/rotate/flip performed in PowerPoint's own diagram
@@ -2447,140 +2520,197 @@ interface PptxSmartArtNode {
    * {@link module:smartart-layout-interpreter-custom} so it survives even
    * when there is no cached `dsp:` drawing to fall back on.
    */
-  customLayout?: SmartArtNodeCustomLayout;
+  customLayout?: DiagramNodeCustomLayout;
 }
 //#endregion
-//#region pptx/core/types/smart-art-style-definition.d.ts
-interface PptxSmartArtDefinitionText {
-  value: string;
-  language?: string;
-}
-interface PptxSmartArtDefinitionCategory {
-  type: string;
-  priority: number;
-}
-type PptxSmartArtColorApplicationMethod = 'span' | 'cycle' | 'repeat';
-type PptxSmartArtHueDirection = 'cw' | 'ccw';
-/** CT_Colors application metadata. Color-choice children remain preserved XML. */
-interface PptxSmartArtColorListMetadata {
-  method?: PptxSmartArtColorApplicationMethod;
-  hueDirection?: PptxSmartArtHueDirection;
-}
+//#region diagram/model/data.d.ts
 /**
- * A quick-style label's `a:lnRef`/`a:fillRef`/`a:effectRef`/`a:fontRef`
- * (`CT_ShapeStyle`, the same complex type an ordinary shape's `p:style`
- * uses), resolved against the theme's `fmtScheme` at parse time instead of
- * the coarse subtle/moderate/intense enum ({@link PptxSmartArtQuickStyle.effectIntensity}).
- * Only populated when a theme format scheme was available when the quick
- * style was parsed. See G13 in the 2026-09 diagram audit.
+ * Named SmartArt layout presets for creation (subset of the built-in layouts).
+ *
+ * @example
+ * ```ts
+ * const layout: DiagramLayoutPreset = "hierarchy";
+ * // => "hierarchy" - one of: "basicBlockList" | "alternatingHexagons" | "hierarchy" | ...
+ * ```
  */
-interface PptxSmartArtResolvedStyleRef {
-  fillColor?: string;
-  fillMode?: 'solid' | 'gradient' | 'pattern' | 'none' | 'theme';
-  strokeColor?: string;
-  strokeWidth?: number;
-  /** `a:effectRef`'s theme-resolved outer shadow colour, when the style has one. */
-  shadowColor?: string;
-  /** `a:fontRef`'s theme-resolved typeface (`+mn-lt`/`+mj-lt` -> the theme's actual font). */
-  fontTypeface?: string;
+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';
+/**
+ * Presentation layout variables from `dgm:prSet/dgm:presLayoutVars` (data model)
+ * or `dgm:varLst` (layout definition defaults).
+ *
+ * These drive how the DiagramML layout interpreter arranges points: flow
+ * direction, hierarchy branch style, org-chart mode, and child count limits.
+ * The fallback layout engine can consult them for direction/org-chart hints.
+ *
+ * @example
+ * ```ts
+ * const vars: DiagramPresLayoutVars = { direction: "rev", orgChart: true };
+ * // => satisfies DiagramPresLayoutVars
+ * ```
+ */
+interface DiagramPresLayoutVars {
+  /** Flow direction (`dgm:dir`): "norm" (default) or "rev" (reversed/RTL). */
+  direction?: 'norm' | 'rev';
+  /** Hierarchy branch style (`dgm:hierBranch`): std/init/l/r/hang. */
+  hierarchyBranch?: 'std' | 'init' | 'l' | 'r' | 'hang';
+  /** Org-chart mode enabled (`dgm:orgChart`). */
+  orgChart?: boolean;
+  /** Maximum children per node (`dgm:chMax`, -1 = unbounded). */
+  childMax?: number;
+  /** Preferred children per node (`dgm:chPref`, -1 = unbounded). */
+  childPreferred?: number;
+  /** Whether bullets are enabled (`dgm:bulletEnabled`). */
+  bulletEnabled?: boolean;
+  /** Animation-by-level setting (`dgm:animLvl`). */
+  animationLevel?: string;
+  /** Animate-one setting (`dgm:animOne`). */
+  animateOne?: string;
+  /** Allowed resize handles (`dgm:resizeHandles`). */
+  resizeHandles?: string;
 }
-/** CT_StyleLabel metadata from a quick-style definition. */
-interface PptxSmartArtQuickStyleLabel {
-  name: string;
-  /** Theme-resolved `dgm:style` refs for this label's role, when available. */
-  resolvedStyle?: PptxSmartArtResolvedStyleRef;
+/**
+ * The format-neutral part of a parsed SmartArt graphic: everything the layout
+ * engine and interpreters read.
+ *
+ * @example
+ * ```ts
+ * const data: DiagramData = {
+ *   resolvedLayoutType: "hierarchy",
+ *   layout: "hierarchy",
+ *   colorScheme: "colorful1",
+ *   style: "moderate",
+ *   nodes: [
+ *     { id: "1", text: "CEO", children: [
+ *       { id: "2", text: "VP Marketing", parentId: "1" },
+ *     ]},
+ *   ],
+ * };
+ * // => satisfies DiagramData
+ * ```
+ */
+interface DiagramData {
+  layoutType?: string;
+  resolvedLayoutType?: DiagramLayoutType;
+  /** Named layout preset (used when creating new SmartArt). */
+  layout?: DiagramLayoutPreset;
+  /** Colour scheme for the SmartArt graphic. */
+  colorScheme?: DiagramColorScheme;
+  /** Visual style intensity. */
+  style?: DiagramStyleIntensity;
+  nodes: DiagramNode[];
+  /** Connections between data-model nodes. */
+  connections?: DiagramConnection[];
+  /** Colour transform from the diagram colours part. */
+  colorTransform?: DiagramColorTransform;
+  /** Quick style from the diagram quick-style part. */
+  quickStyle?: DiagramQuickStyle;
+  /** Editable metadata from the related DiagramML layout definition. */
+  layoutDefinition?: DiagramLayoutDefinition;
   /**
-   * The label's own `dgm:scene3d` (per-shape camera + light rig). PowerPoint
-   * copies it onto a shape's cached `a:scene3d` unless it is the default
-   * front camera with a `threePt` light (see `applySmartArtQuickStyle3d`).
+   * Presentation layout variables (direction, hierarchy branch, org-chart,
+   * child limits, bullets) from `dgm:presLayoutVars` / layout `dgm:varLst`.
+   * Consulted by the fallback layout engine for direction/org-chart hints.
    */
-  scene3d?: Pptx3DScene;
-  /** The label's own `dgm:sp3d` (bevel / extrusion / contour / material); absent when empty. */
-  shape3d?: Pptx3DShape;
-  /** The label's `dgm:txPr/a:sp3d` label-text extrusion (Bird's Eye Scene). */
-  text3d?: Text3DStyle;
-}
-/** CT_CTStyleLabel metadata from a color-transform definition. */
-interface PptxSmartArtColorStyleLabel {
-  name: string;
-  fill?: PptxSmartArtColorListMetadata;
-  line?: PptxSmartArtColorListMetadata;
-  effect?: PptxSmartArtColorListMetadata;
-  textLine?: PptxSmartArtColorListMetadata;
-  textFill?: PptxSmartArtColorListMetadata;
-  textEffect?: PptxSmartArtColorListMetadata;
-}
-interface PptxSmartArtDefinitionMetadata {
-  uniqueId?: string;
-  minimumVersion?: string;
-  titles?: PptxSmartArtDefinitionText[];
-  descriptions?: PptxSmartArtDefinitionText[];
-  categories?: PptxSmartArtDefinitionCategory[];
-}
-/** Typed CT_ColorTransform metadata and the resolved legacy color palette. */
-interface PptxSmartArtColorTransform extends PptxSmartArtDefinitionMetadata {
-  /** Legacy resolved display name. */
-  name?: string;
-  /** Ordered resolved fill colors for rendering. */
-  fillColors: string[];
-  /** Ordered resolved line colors for rendering. */
-  lineColors: string[];
-  /** Ordered resolved text-fill colors (primary styleLbl `txFillClrLst`). */
-  textFillColors?: string[];
-  /** Ordered resolved text-line colors (primary styleLbl `txLinClrLst`). */
-  textLineColors?: string[];
-  /** Ordered resolved effect colors (primary styleLbl `effectClrLst`). */
-  effectColors?: string[];
-  /** Ordered resolved text-effect colors (primary styleLbl `txEffectClrLst`). */
-  textEffectColors?: string[];
-  /** Fill-list span/cycle + hue-direction interpolation of the primary styleLbl. */
-  fillInterpolation?: PptxSmartArtColorListMetadata;
-  /** Line-list span/cycle + hue-direction interpolation of the primary styleLbl. */
-  lineInterpolation?: PptxSmartArtColorListMetadata;
-  /** Ordered CT_CTStyleLabel metadata. */
-  labels?: PptxSmartArtColorStyleLabel[];
+  presLayoutVars?: DiagramPresLayoutVars;
   /**
-   * Every `styleLbl`'s own resolved fill/line colour list, keyed by name
-   * (e.g. `node1`, `asst0`, `bgShp`, `revTx`). Unlike {@link fillColors} /
-   * {@link lineColors} (which collapse to ONE "primary" node-role list),
-   * this keeps every role so a node can be coloured from its OWN role's
-   * palette (see `PptxSmartArtNode.styleRole` and `applySmartArtRoleColors`)
-   * instead of a generic cycled colour.
+   * The document theme's minor-Latin font (`a:fontScheme/a:minorFont/a:latin/
+   * @typeface`): what SmartArt text actually renders in when no per-run
+   * `a:latin` override is present (the common case; the font-fit is the one
+   * consumer). Undefined when the theme carries no font scheme at all.
    */
-  roleColors?: Record<string, SmartArtRoleColorList>;
+  themeMinorFont?: string;
 }
-/** One colour-transform `styleLbl`'s resolved colour lists. */
-interface SmartArtRoleColorList {
-  fill: string[];
-  line: string[];
+//#endregion
+//#region pptx/core/types/smart-art-chrome.d.ts
+/**
+ * Background / outline extracted from `dgm:bg` and `dgm:whole`.
+ *
+ * @example
+ * ```ts
+ * const chrome: PptxSmartArtChrome = {
+ *   backgroundColor: "#F0F0F0",
+ *   outlineColor: "#333333",
+ *   outlineWidth: 1,
+ * };
+ * // => satisfies PptxSmartArtChrome
+ * ```
+ */
+interface PptxSmartArtChrome {
   /**
-   * `txFillClrLst`, when the label declares one (`revTx` -> `tx1`). A text
-   * node's colour comes from here; see `smartart-merged-text-label`.
+   * Background fill colour (hex). When the real `dgm:bg` fill is a gradient
+   * or pattern (see {@link PptxSmartArtChrome.backgroundFillXml}), this is an
+   * APPROXIMATION (the gradient's first stop, or the pattern's foreground
+   * colour) for a consumer that only wants one display colour, not the full fill.
    */
-  textFill?: string[];
-}
-/** Typed CT_StyleDefinition metadata and legacy rendering hint. */
-interface PptxSmartArtQuickStyle extends PptxSmartArtDefinitionMetadata {
-  /** Legacy resolved display name. */
-  name?: string;
-  /** Legacy effect-intensity rendering hint. */
-  effectIntensity?: string;
-  /** Ordered CT_StyleLabel metadata. Complex style payload remains preserved XML. */
-  labels?: PptxSmartArtQuickStyleLabel[];
+  backgroundColor?: string;
   /**
-   * Whole-diagram 3D scene (camera preset/rotation/zoom/fov, light rig,
-   * backdrop) from the quick style's own `dgm:styleDef/dgm:scene3d`, present
-   * for the "Scene" quick styles (Brick, Flat, Metallic, Sunset, Bird's Eye
-   * Scene). One camera renders the whole diagram; per-shape `a:scene3d` is
-   * absent for those styles (see `PptxSmartArtDrawingShape.scene3d`). Each
-   * `dgm:styleLbl` also carries its own per-label `dgm:scene3d`/`dgm:sp3d`
-   * ({@link PptxSmartArtQuickStyleLabel.scene3d} / `shape3d` / `text3d`),
-   * which PowerPoint bakes onto each cached shape; they are re-applied when a
-   * structural edit regenerates the shapes.
+   * Raw `dgm:bg` fill XML, present only when the background is a gradient or
+   * pattern fill (a solid fill is fully captured by {@link PptxSmartArtChrome.backgroundColor}
+   * alone). Round-trip only: `smartart-save-chrome.ts` re-emits this verbatim
+   * instead of flattening the fill to a solid colour on save.
    */
-  scene3d?: Pptx3DScene;
+  backgroundFillXml?: PptxSmartArtRawBackgroundFill;
+  /** Outline stroke colour (hex). */
+  outlineColor?: string;
+  /** Outline stroke width in points. */
+  outlineWidth?: number;
+}
+/**
+ * A `dgm:bg` fill this viewer doesn't fully model as first-class chrome
+ * (gradient or pattern), preserved verbatim for round-trip. See
+ * {@link PptxSmartArtChrome.backgroundFillXml}.
+ */
+interface PptxSmartArtRawBackgroundFill {
+  /** Local element name of the fill under `dgm:bg` (`gradFill` or `pattFill`). */
+  localName: 'gradFill' | 'pattFill';
+  /** The fill element's own attributes/children, as parsed. */
+  xml: XmlObject;
 }
 //#endregion
+//#region pptx/core/types/smart-art-model.d.ts
+type PptxSmartArtConstraintRelationship = DiagramConstraintRelationship;
+type PptxSmartArtConstraintOperator = DiagramConstraintOperator;
+type PptxSmartArtConstraintPointType = DiagramConstraintPointType;
+type PptxSmartArtConstraintTarget = DiagramConstraintTarget;
+type PptxSmartArtConstraint = DiagramConstraint<XmlObject>;
+type PptxSmartArtNumericRule = DiagramNumericRule<XmlObject>;
+type PptxSmartArtLocalizedText = DiagramLocalizedText;
+type PptxSmartArtLayoutCategory = DiagramLayoutCategory;
+type PptxSmartArtAlgorithmParameter = DiagramAlgorithmParameter;
+type PptxSmartArtLayoutAlgorithm = DiagramLayoutAlgorithm;
+type PptxSmartArtIteratorAttributes = DiagramIteratorAttributes;
+type PptxSmartArtForEach = DiagramForEach<XmlObject>;
+type PptxSmartArtWhen = DiagramWhen<XmlObject>;
+type PptxSmartArtChoose = DiagramChoose<XmlObject>;
+type PptxSmartArtShapeAdjustment = DiagramShapeAdjustment;
+type PptxSmartArtLayoutNodeShape = DiagramLayoutNodeShape;
+type PptxSmartArtLayoutNode = DiagramLayoutNode<XmlObject>;
+type PptxSmartArtLayoutDefinition = DiagramLayoutDefinition<XmlObject>;
+type PptxSmartArtDefinitionText = DiagramDefinitionText;
+type PptxSmartArtDefinitionCategory = DiagramDefinitionCategory;
+type PptxSmartArtColorApplicationMethod = DiagramColorApplicationMethod;
+type PptxSmartArtHueDirection = DiagramHueDirection;
+type PptxSmartArtColorListMetadata = DiagramColorListMetadata;
+type PptxSmartArtResolvedStyleRef = DiagramResolvedStyleRef;
+type PptxSmartArtQuickStyleLabel = DiagramQuickStyleLabel<Pptx3DScene, Pptx3DShape, Text3DStyle>;
+type PptxSmartArtColorStyleLabel = DiagramColorTransformLabel;
+type PptxSmartArtDefinitionMetadata = DiagramDefinitionMetadata;
+type PptxSmartArtColorTransform = DiagramColorTransform;
+type SmartArtRoleColorList = DiagramRoleColorList;
+type PptxSmartArtQuickStyle = DiagramQuickStyle<Pptx3DScene, Pptx3DShape, Text3DStyle>;
+type PptxSmartArtTextRun = DiagramNodeTextRun<TextStyle>;
+type PptxSmartArtTextParagraphItem = DiagramNodeTextParagraphItem<TextStyle>;
+type PptxSmartArtTextParagraph = DiagramNodeTextParagraph<TextStyle>;
+type PptxSmartArtNodeStyle = DiagramNodeStyle;
+type PptxSmartArtNode = DiagramNode<TextStyle>;
+/**
+ * Manual layout override for a `type="pres"` presentation point, read from its
+ * `dgm:prSet` `cust*` attributes (see `DiagramNodeCustomLayout`).
+ */
+type SmartArtNodeCustomLayout = DiagramNodeCustomLayout;
+type SmartArtLayout = DiagramLayoutPreset;
+type PptxSmartArtPresLayoutVars = DiagramPresLayoutVars;
+//#endregion
 //#region pptx/core/types/smart-art.d.ts
 /**
  * Resolved SmartArt layout category.
@@ -2592,16 +2722,6 @@ interface PptxSmartArtQuickStyle extends PptxSmartArtDefinitionMetadata {
  * ```
  */
 type SmartArtLayoutType = DiagramLayoutType;
-/**
- * Named SmartArt layout presets for creation (subset of PowerPoint layouts).
- *
- * @example
- * ```ts
- * const layout: SmartArtLayout = "hierarchy";
- * // => "hierarchy" — one of: "basicBlockList" | "alternatingHexagons" | "hierarchy" | …
- * ```
- */
-type SmartArtLayout = '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';
 /**
  * SmartArt colour scheme presets.
  *
@@ -2789,41 +2909,9 @@ interface PptxSmartArtDrawingShape extends PptxCustomPathProperties {
   styleLabel?: string;
 }
 /**
- * Presentation layout variables from `dgm:prSet/dgm:presLayoutVars` (data model)
- * or `dgm:varLst` (layout definition defaults).
- *
- * These drive how the DiagramML layout interpreter arranges points: flow
- * direction, hierarchy branch style, org-chart mode, and child count limits.
- * The fallback layout engine can consult them for direction/org-chart hints.
- *
- * @example
- * ```ts
- * const vars: PptxSmartArtPresLayoutVars = { direction: "rev", orgChart: true };
- * // => satisfies PptxSmartArtPresLayoutVars
- * ```
- */
-interface PptxSmartArtPresLayoutVars {
-  /** Flow direction (`dgm:dir`): "norm" (default) or "rev" (reversed/RTL). */
-  direction?: 'norm' | 'rev';
-  /** Hierarchy branch style (`dgm:hierBranch`): std/init/l/r/hang. */
-  hierarchyBranch?: 'std' | 'init' | 'l' | 'r' | 'hang';
-  /** Org-chart mode enabled (`dgm:orgChart`). */
-  orgChart?: boolean;
-  /** Maximum children per node (`dgm:chMax`, -1 = unbounded). */
-  childMax?: number;
-  /** Preferred children per node (`dgm:chPref`, -1 = unbounded). */
-  childPreferred?: number;
-  /** Whether bullets are enabled (`dgm:bulletEnabled`). */
-  bulletEnabled?: boolean;
-  /** Animation-by-level setting (`dgm:animLvl`). */
-  animationLevel?: string;
-  /** Animate-one setting (`dgm:animOne`). */
-  animateOne?: string;
-  /** Allowed resize handles (`dgm:resizeHandles`). */
-  resizeHandles?: string;
-}
-/**
- * Complete parsed SmartArt data for a {@link SmartArtPptxElement}.
+ * Complete parsed SmartArt data for a {@link SmartArtPptxElement}: the neutral
+ * {@link DiagramData} (bound to the pptx node, quick-style and layout-definition
+ * types) plus the package parts, cached drawing and save hints.
  *
  * @example
  * ```ts
@@ -2841,42 +2929,16 @@ interface PptxSmartArtPresLayoutVars {
  * // => satisfies PptxSmartArtData
  * ```
  */
-interface PptxSmartArtData {
-  layoutType?: string;
-  resolvedLayoutType?: SmartArtLayoutType;
-  /** Named layout preset (used when creating new SmartArt). */
-  layout?: SmartArtLayout;
-  /** Colour scheme for the SmartArt graphic. */
-  colorScheme?: SmartArtColorScheme;
-  /** Visual style intensity. */
-  style?: SmartArtStyle;
+interface PptxSmartArtData extends DiagramData {
   nodes: PptxSmartArtNode[];
-  /** Connections between data-model nodes. */
-  connections?: PptxSmartArtConnection[];
   /** Pre-computed shapes from `ppt/diagrams/drawing*.xml`. */
   drawingShapes?: PptxSmartArtDrawingShape[];
   /** Background and outline chrome from `dgm:bg` / `dgm:whole`. */
   chrome?: PptxSmartArtChrome;
-  /** Colour transform from `ppt/diagrams/colors*.xml`. */
-  colorTransform?: PptxSmartArtColorTransform;
   /** Quick style from `ppt/diagrams/quickStyles*.xml`. */
   quickStyle?: PptxSmartArtQuickStyle;
   /** Editable metadata from the related DiagramML layout definition. */
   layoutDefinition?: PptxSmartArtLayoutDefinition;
-  /**
-   * Presentation layout variables (direction, hierarchy branch, org-chart,
-   * child limits, bullets) from `dgm:presLayoutVars` / layout `dgm:varLst`.
-   * Consulted by the fallback layout engine for direction/org-chart hints.
-   */
-  presLayoutVars?: PptxSmartArtPresLayoutVars;
-  /**
-   * The deck's own theme minor-Latin font (`a:fontScheme/a:minorFont/a:latin/
-   * @typeface`): what SmartArt text actually renders in when no per-run
-   * `a:latin` override is present (the common case - see
-   * `smartart-layout-item-font-size.ts`'s font-fit, the one consumer).
-   * Undefined when the theme carries no font scheme at all.
-   */
-  themeMinorFont?: string;
   /** Relationship ID for the diagram data part (for round-trip save). */
   dataRelId?: string;
   /** Relationship ID for the diagram layout part. */
@@ -2904,5 +2966,5 @@ interface PptxSmartArtData {
   drawingDirty?: boolean;
 }
 //#endregion
-export { CustomGeometrySegment as $, PptxSmartArtChoose as A, UnderlineStyle as At, PptxSmartArtConstraintOperator as B, PptxSmartArtTextParagraph as C, Text3DStyle as Ct, PptxSmartArtLayoutDefinition as D, PptxShapeLocks as Dt, SmartArtNodeCustomLayout as E, PptxDrawingGuide as Et, PptxSmartArtLayoutNodeShape as F, PptxSmartArtChrome as G, PptxSmartArtConstraintRelationship as H, PptxSmartArtLocalizedText as I, AdjustHandleXY as J, PptxSmartArtRawBackgroundFill as K, PptxSmartArtShapeAdjustment as L, PptxSmartArtIteratorAttributes as M, PptxSmartArtLayoutAlgorithm as N, PptxSmartArtLayoutNode as O, ShadowEffect as Ot, PptxSmartArtLayoutCategory as P, CustomGeometryRawData as Q, PptxSmartArtWhen as R, PptxSmartArtNodeStyle as S, PptxTextWarpPreset as St, PptxSmartArtTextRun as T, ConnectorConnectionPoint as Tt, PptxSmartArtConstraintTarget as U, PptxSmartArtConstraintPointType as V, PptxSmartArtNumericRule as W, CustomGeometryPath as X, ConnectionSite as Y, CustomGeometryPoint as Z, PptxSmartArtQuickStyle as _, EffectDagXfrm as _t, SmartArtColorScheme as a, TextSegment as at, SmartArtRoleColorList as b, Pptx3DScene as bt, SmartArtStyle as c, EffectDagBlend as ct, PptxSmartArtColorStyleLabel as d, EffectDagContainer as dt, CustomGeometryTextRect as et, PptxSmartArtColorTransform as f, EffectDagContainerType as ft, PptxSmartArtHueDirection as g, EffectDagRelOff as gt, PptxSmartArtDefinitionText as h, EffectDagRawLeaf as ht, PptxSmartArtPresLayoutVars as i, TextOrientationMatrix as it, PptxSmartArtForEach as j, XmlObject as jt, PptxSmartArtAlgorithmParameter as k, StrokeDashType as kt, PptxSmartArtColorApplicationMethod as l, EffectDagBlendMode as lt, PptxSmartArtDefinitionMetadata as m, EffectDagPresetShadow as mt, PptxSmartArtData as n, PptxCustomPathProperties as nt, SmartArtLayout as o, TextStyle as ot, PptxSmartArtDefinitionCategory as p, EffectDagNode as pt, AdjustHandlePolar as q, PptxSmartArtDrawingShape as r, BulletInfo as rt, SmartArtLayoutType as s, EffectDagAlphaOutset as st, PptxSmartArtConnection as t, GeometryAdjustmentHandle as tt, PptxSmartArtColorListMetadata as u, EffectDagBlur as ut, PptxSmartArtQuickStyleLabel as v, BevelPresetType as vt, PptxSmartArtTextParagraphItem as w, ConnectorArrowType as wt, PptxSmartArtNode as x, Pptx3DShape as xt, PptxSmartArtResolvedStyleRef as y, MaterialPresetType as yt, PptxSmartArtConstraint as z };
-//# sourceMappingURL=smart-art-CO2jmJFf.d.ts.map
+export { DiagramNodeTextParagraphItem as $, EffectDagBlur as $t, 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, TextSegment as Jt, PptxSmartArtRawBackgroundFill as K, BulletInfo as Kt, 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, EffectDagBlendMode as Qt, 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, EffectDagAlphaOutset as Xt, DiagramPresLayoutVars as Y, TextStyle as Yt, DiagramNodeStyle as Z, EffectDagBlend as Zt, PptxSmartArtConstraintTarget as _, ShadowEffect as _n, DiagramForEach as _t, SmartArtLayoutType as a, EffectDagRelOff as an, DiagramDefinitionCategory as at, PptxSmartArtDefinitionText as b, XmlObject as bn, DiagramLayoutCategory as bt, PptxSmartArtChoose as c, MaterialPresetType as cn, DiagramHueDirection as ct, PptxSmartArtColorStyleLabel as d, PptxTextWarpPreset as dn, DiagramResolvedStyleRef as dt, EffectDagContainer as en, DiagramNodeTextRun as et, PptxSmartArtColorTransform as f, Text3DStyle as fn, DiagramRoleColorList as ft, PptxSmartArtConstraintRelationship as g, PptxShapeLocks as gn, DiagramChoose as gt, PptxSmartArtConstraintPointType as h, PptxDrawingGuide as hn, DiagramAlgorithmParameter as ht, SmartArtColorScheme as i, EffectDagRawLeaf as in, DiagramColorTransformLabel as it, PptxSmartArtNodeStyle as j, DiagramColorScheme as jt, PptxSmartArtLocalizedText as k, DiagramConstraintTarget as kt, PptxSmartArtColorApplicationMethod as l, Pptx3DScene as ln, DiagramQuickStyle as lt, PptxSmartArtConstraintOperator as m, ConnectorConnectionPoint as mn, DiagramLayoutNode as mt, PptxSmartArtData as n, EffectDagNode as nn, DiagramColorListMetadata as nt, SmartArtStyle as o, EffectDagXfrm as on, DiagramDefinitionMetadata as ot, PptxSmartArtConstraint as p, ConnectorArrowType as pn, DiagramLayoutDefinition as pt, DiagramData as q, TextOrientationMatrix as qt, PptxSmartArtDrawingShape as r, EffectDagPresetShadow as rn, DiagramColorTransform as rt, PptxSmartArtAlgorithmParameter as s, BevelPresetType as sn, DiagramDefinitionText as st, PptxSmartArtConnection as t, EffectDagContainerType as tn, DiagramColorApplicationMethod as tt, PptxSmartArtColorListMetadata as u, Pptx3DShape as un, DiagramQuickStyleLabel as ut, PptxSmartArtDefinitionCategory as v, StrokeDashType as vn, DiagramIteratorAttributes as vt, PptxSmartArtLayoutAlgorithm as w, DiagramWhen as wt, PptxSmartArtForEach as x, DiagramLayoutNodeShape as xt, PptxSmartArtDefinitionMetadata as y, UnderlineStyle as yn, DiagramLayoutAlgorithm as yt, PptxSmartArtTextParagraphItem as z, CustomGeometryPath as zt };
+//# sourceMappingURL=smart-art-Q2kZQtHh.d.ts.map