pptx-react-viewer 1.1.5 → 1.1.7

package/node_modules/pptx-viewer-core/dist/{presentation-ArhfImJ5.d.ts → presentation-nZxgWvXq.d.ts}

@@ -98,7 +98,42 @@ interface ShadowEffect {
     /** Whether shadow rotates with shape. */
     rotateWithShape?: boolean;
 }
-type XmlObject = Record<string, any>;
+/**
+ * Strongly-typed parsed XML node from fast-xml-parser.
+ *
+ * The parser is configured with `attributeNamePrefix: '@_'`,
+ * `parseAttributeValue: false`, and `parseTagValue: false`, so attribute and
+ * text values are always strings at runtime. This type encodes that:
+ *
+ * - **Attributes** — keys matching `` `@_${string}` `` return
+ *   `string | undefined` directly.
+ * - **Text content** — `#text` returns `string | undefined`.
+ * - **Child elements** — any other string key returns
+ *   `XmlObject | XmlObject[] | string | undefined`. The union reflects that
+ *   fast-xml-parser may emit an object (single child), an array (repeated
+ *   children), or a bare string (text-only element collapsed by the parser).
+ *
+ * For traversal, prefer the helpers in {@link ./../utils/xml-access} —
+ * `xmlChild` / `xmlChildren` / `xmlAttr` / `xmlText` / `xmlPath` — which
+ * narrow the union and normalize the single-vs-array duality. Direct
+ * indexing works for attributes (typed as string) but chained child access
+ * (`obj['p:spPr']?.['a:xfrm']`) requires the helpers or a narrowing cast
+ * because TypeScript cannot index into the `XmlObject[] | string` part of
+ * the union.
+ */
+interface XmlObject {
+    /** Attributes (`@_`-prefixed keys) are always strings at runtime. */
+    [attr: `@_${string}`]: string | undefined;
+    /** Element text content surfaces under `#text` when present. */
+    '#text'?: string;
+    /**
+     * Child elements keyed by their (namespaced) tag name. fast-xml-parser
+     * emits a single object for unique elements, an array for repeated ones,
+     * and a bare string for elements collapsed to their text content. Use
+     * the helpers in `utils/xml-access` to narrow this union.
+     */
+    [child: string]: XmlObject | XmlObject[] | string | undefined;
+}
 /**
  * Discriminant values for the `type` field on {@link PptxElement}.
  *
@@ -191,7 +226,7 @@ type BevelPresetType = 'circle' | 'relaxedInset' | 'cross' | 'coolSlant' | 'angl
  * // => "plastic" — one of: "matte" | "warmMatte" | "plastic" | "metal" | "dkEdge" | …
  * ```
  */
-type MaterialPresetType = 'matte' | 'warmMatte' | 'plastic' | 'metal' | 'dkEdge' | 'softEdge' | 'flat' | 'softmetal' | 'clear' | 'powder' | 'translucentPowder';
+type MaterialPresetType = 'matte' | 'warmMatte' | 'plastic' | 'metal' | 'dkEdge' | 'softEdge' | 'flat' | 'softmetal' | 'clear' | 'powder' | 'translucentPowder' | 'legacyMatte' | 'legacyPlastic' | 'legacyMetal' | 'legacyWireframe';
 /**
  * 3D text body extrusion/bevel from `a:bodyPr/a:sp3d`.
  *
@@ -381,6 +416,38 @@ interface TextStyle {
     underlineStyle?: UnderlineStyle;
     /** Underline colour as hex string (`a:uFill` / `a:uLn`). When absent, inherits text colour. */
     underlineColor?: string;
+    /**
+     * When true, the source authored `<a:u val="none"/>` to explicitly suppress
+     * underline (rather than omitting the attribute entirely). Preserved so the
+     * writer can re-emit the explicit `none` token instead of dropping it.
+     */
+    underlineExplicitNone?: boolean;
+    /**
+     * Underline line properties parsed from `<a:rPr><a:uLn>` — width, dash
+     * preset, and end caps. Captured as a typed object so the writer can
+     * round-trip the line styling that previously was dropped (only the
+     * solidFill colour was carried before).
+     */
+    underlineLine?: {
+        /** Line width in EMU (raw OOXML) for `a:uLn/@w`. */
+        widthEmu?: number;
+        /** Compound line type (`a:uLn/@cmpd`). */
+        compound?: string;
+        /** Cap style (`a:uLn/@cap`). */
+        cap?: string;
+        /** Pen alignment (`a:uLn/@algn`). */
+        algn?: string;
+        /** Preset dash value (`a:uLn/a:prstDash/@val`). */
+        prstDash?: string;
+        /** Raw `a:uLn/a:headEnd` XML preserved verbatim. */
+        headEndXml?: XmlObject;
+        /** Raw `a:uLn/a:tailEnd` XML preserved verbatim. */
+        tailEndXml?: XmlObject;
+    };
+    /** When `<a:uLnTx/>` is present — underline line follows the text run line. */
+    underlineLineFollowsText?: boolean;
+    /** When `<a:uFillTx/>` is present — underline fill follows the text run fill. */
+    underlineFillFollowsText?: boolean;
     strikethrough?: boolean;
     /** Specific strike type: single or double from `a:rPr/@strike`. */
     strikeType?: 'sngStrike' | 'dblStrike';
@@ -497,6 +564,12 @@ interface TextStyle {
     textWarpAdj2?: number;
     /** Text capitalization style from `a:rPr/@cap`. */
     textCaps?: 'all' | 'small' | 'none';
+    /**
+     * When true, the source authored `<a:rPr cap="none"/>` explicitly. This
+     * differs from {@link textCaps} = `"none"` only because the writer must
+     * preserve the explicit token rather than collapse it to omission.
+     */
+    textCapsExplicitNone?: boolean;
     /** Symbol font family from `a:sym`. */
     symbolFont?: string;
     /** East Asian font family from `a:ea`. */
@@ -591,6 +664,14 @@ interface TextStyle {
     upright?: boolean;
     /** Compatible line spacing flag (`a:bodyPr/@compatLnSpc`). */
     compatibleLineSpacing?: boolean;
+    /**
+     * Text body rotation in **degrees** (`a:bodyPr/@rot`).
+     *
+     * OOXML stores the value as 60000ths of a degree. Positive values rotate
+     * the body clockwise. When undefined, the attribute is omitted on save
+     * (PowerPoint treats absent `rot` as inherit/none).
+     */
+    textBodyRotation?: number;
     /** Text shadow colour as hex string (`a:outerShdw`). */
     textShadowColor?: string;
     /** Text shadow blur radius in px. */
@@ -662,6 +743,33 @@ interface TextStyle {
     text3d?: Text3DStyle;
     /** 3D scene (camera + light rig) settings on the text body (`a:bodyPr/a:scene3d`). */
     textBodyScene3d?: Pptx3DScene;
+    /**
+     * Raw `<a:extLst>` subtree captured from `<a:bodyPr>`. Preserved verbatim so
+     * authored extensions (e.g. content placeholders, custom application data)
+     * survive a round-trip even though the engine doesn't interpret them.
+     */
+    bodyPropertiesExtLstXml?: XmlObject;
+    /**
+     * Raw `<a:extLst>` subtree captured from `<a:pPr>`. Only meaningful on the
+     * paragraph-level style (paragraphs propagate this via the first segment).
+     */
+    paragraphPropertiesExtLstXml?: XmlObject;
+    /**
+     * Raw `<a:extLst>` subtree captured from `<a:rPr>`. Persisted verbatim on
+     * save when present — covers run-level extensions the typed model doesn't
+     * model (e.g. `a14:hiddenFill` and similar).
+     */
+    runPropertiesExtLstXml?: XmlObject;
+    /**
+     * Raw `<a:defRPr>` XML node captured from `<a:pPr>`. The schema permits
+     * `defRPr` directly inside `pPr` so that paragraph defaults can specify the
+     * end-paragraph run formatting; previously this was dropped on save. We
+     * persist the parsed XML object so it round-trips verbatim.
+     *
+     * Only meaningful on the *first* segment of each paragraph (matches the
+     * convention used for {@link bulletInfo} / {@link endParaRunProperties}).
+     */
+    paragraphDefaultRunPropertiesXml?: XmlObject;
 }
 /**
  * Structured bullet metadata attached to the first {@link TextSegment}
@@ -702,12 +810,26 @@ interface BulletInfo {
     sizePts?: number;
     /** Bullet color as hex string from `a:buClr`. */
     color?: string;
+    /**
+     * Raw colour-choice XML captured from `<a:buClr>` so that themed bullets
+     * (`a:schemeClr`, `a:sysClr`, `a:prstClr`) round-trip with their original
+     * identity rather than being flattened to `<a:srgbClr/>` on save.
+     */
+    colorXml?: XmlObject;
     /** True when `a:buNone` explicitly suppresses bullets. */
     none?: boolean;
     /** Picture bullet: relationship ID from `a:buBlip` → `a:blip[@r:embed]`. */
     imageRelId?: string;
     /** Picture bullet: data URL of the embedded image. */
     imageDataUrl?: string;
+    /**
+     * Raw `<a:buBlip>` XML captured at parse time. Carries the full blipFill
+     * subtree (`a:tile`, `a:stretch`, `a:srcRect`, `a:blip > a:extLst`) so the
+     * writer can emit the complete original definition rather than the bare
+     * `a:blip[@r:embed]` mapping. When set, the writer prefers it over
+     * {@link imageRelId} for emission.
+     */
+    imageBlipFillXml?: XmlObject;
     /** When true, `<a:buFontTx/>` was specified — inherit the bullet font from
      *  the run text, not from a buFont declaration. */
     fontInherit?: boolean;
@@ -743,6 +865,20 @@ interface TextSegment {
     fieldType?: string;
     /** When this segment originated from an `a:fld` element, stores the field GUID. */
     fieldGuid?: string;
+    /**
+     * Original attribute name used to author the field GUID — `'uuid'` for the
+     * `a:fld/@uuid` form authored by some legacy producers, `'id'` for the
+     * canonical `a:fld/@id` form. Preserved so the writer round-trips whichever
+     * spelling the source used (PowerPoint accepts both). Defaults to `'id'`
+     * on save when undefined.
+     */
+    fieldGuidAttr?: 'uuid' | 'id';
+    /**
+     * Raw per-field paragraph properties (`a:fld > a:pPr`). The schema permits
+     * `pPr` inside an `a:fld` so the field can carry its own paragraph-level
+     * formatting; preserved verbatim on save when present.
+     */
+    fieldParagraphPropertiesXml?: XmlObject;
     /** Raw OMML XML node for equation segments (from `a14:m` / `m:oMathPara`). */
     equationXml?: Record<string, unknown>;
     /**
@@ -752,6 +888,21 @@ interface TextSegment {
     equationNumber?: string;
     /** Whether this segment represents a paragraph break rather than renderable text. */
     isParagraphBreak?: boolean;
+    /**
+     * Whether this segment represents a soft line break (`a:br`) rather than
+     * a paragraph terminator. Soft line breaks remain inside the same paragraph
+     * but force a line wrap and may carry their own run properties.
+     *
+     * The renderer should treat the segment text as `"\n"` when present.
+     */
+    isLineBreak?: true;
+    /**
+     * Raw `a:rPr` XML for an `a:br` (soft line break) segment, captured verbatim
+     * during parse so the writer can re-emit attributes/colours/fonts that the
+     * typed model doesn't represent. Only meaningful when {@link isLineBreak}
+     * is `true`.
+     */
+    breakRunProperties?: Record<string, unknown>;
     /** Structured bullet info for the first segment of a paragraph. */
     bulletInfo?: BulletInfo;
     /**
@@ -924,6 +1075,8 @@ interface ShapeStyle {
     lineCap?: 'flat' | 'rnd' | 'sq';
     /** Compound line type (`a:ln/@cmpd`). */
     compoundLine?: 'sng' | 'dbl' | 'thickThin' | 'thinThick' | 'tri';
+    /** Pen line alignment (`a:ln/@algn`): `ctr` (centre, default) or `in` (inside). */
+    lineAlignment?: 'ctr' | 'in';
     shadowColor?: string;
     shadowBlur?: number;
     shadowOffsetX?: number;
@@ -1091,6 +1244,101 @@ interface ShapeStyle {
  *
  * @module pptx-types/image
  */
+/**
+ * Blend mode for `a:blend` container nodes inside an `a:effectDag` (CT_BlendEffect).
+ *
+ * Per ECMA-376 §20.1.8.10, valid values are: `darken`, `lighten`, `mult`,
+ * `over`, `screen`.
+ */
+type EffectDagBlendMode = 'darken' | 'lighten' | 'mult' | 'over' | 'screen';
+/**
+ * Container node kind inside an `a:effectDag` (CT_EffectContainer @type).
+ *
+ * Per ECMA-376 §20.1.8.20, `sib` (sibling) draws each child independently
+ * over the same source; `tree` (tree) chains effects so each sees the output
+ * of its siblings.
+ */
+type EffectDagContainerType = 'sib' | 'tree';
+/**
+ * Typed model of the directed-acyclic effect graph stored in `a:effectDag`.
+ *
+ * The four "structural" container/transform nodes are typed; any other inner
+ * effect (e.g. `a:outerShdw`, `a:glow`, `a:alphaInv`) is preserved verbatim
+ * as a raw XML object via the {@link EffectDagRawLeaf} variant so we never
+ * have to recurse into the full effect taxonomy.
+ *
+ * @example
+ * ```ts
+ * // <a:effectDag>
+ * //   <a:cont type="sib">
+ * //     <a:blend blend="mult"><a:cont type="tree" /></a:blend>
+ * //   </a:cont>
+ * // </a:effectDag>
+ * const dag: EffectDagContainer = {
+ *   kind: "cont",
+ *   type: "sib",
+ *   children: [{
+ *     kind: "blend",
+ *     mode: "mult",
+ *     container: { kind: "cont", type: "tree", children: [] },
+ *   }],
+ * };
+ * ```
+ */
+type EffectDagNode = EffectDagContainer | EffectDagBlend | EffectDagXfrm | EffectDagRelOff | EffectDagRawLeaf;
+/** `a:cont` — CT_EffectContainer. Recursive; mirrors the top-level `effectDag`. */
+interface EffectDagContainer {
+    kind: 'cont';
+    /** `@type` — `sib` or `tree`. */
+    type: EffectDagContainerType;
+    /** Optional `@name` attribute. */
+    name?: string;
+    /** Ordered children. */
+    children: EffectDagNode[];
+}
+/** `a:blend` — CT_BlendEffect. Always wraps a single `a:cont` child. */
+interface EffectDagBlend {
+    kind: 'blend';
+    /** `@blend` attribute. */
+    mode: EffectDagBlendMode;
+    /** Required child `a:cont` container. */
+    container: EffectDagContainer;
+}
+/** `a:xfrmEffect` — CT_TransformEffect. Affine transform with no children. */
+interface EffectDagXfrm {
+    kind: 'xfrmEffect';
+    /** Horizontal scale, percentage * 1000 (e.g. 100000 = 100%). */
+    sx?: number;
+    /** Vertical scale, percentage * 1000. */
+    sy?: number;
+    /** Horizontal skew, degrees * 60000. */
+    kx?: number;
+    /** Vertical skew, degrees * 60000. */
+    ky?: number;
+    /** Horizontal translation in EMU. */
+    tx?: number;
+    /** Vertical translation in EMU. */
+    ty?: number;
+}
+/** `a:relOff` — CT_RelativeOffsetEffect. Relative offset in 1000ths of a percent. */
+interface EffectDagRelOff {
+    kind: 'relOff';
+    /** Horizontal offset, percentage * 1000. */
+    tx?: number;
+    /** Vertical offset, percentage * 1000. */
+    ty?: number;
+}
+/**
+ * Catch-all leaf preserving any non-container effect (e.g. `a:outerShdw`,
+ * `a:glow`, `a:alphaInv`) as raw XML. Re-emitted verbatim on save.
+ */
+interface EffectDagRawLeaf {
+    kind: 'raw';
+    /** Local element name without the `a:` prefix (e.g. `outerShdw`, `glow`). */
+    tag: string;
+    /** Raw XML object captured at load — preserved verbatim on save. */
+    xml: Record<string, unknown>;
+}
 /**
  * Image recolour/adjustment properties parsed from blip extensions.
  *
@@ -1141,6 +1389,71 @@ interface PptxImageEffects {
         /** Whether the target colour is fully transparent (alpha = 0). */
         clrToTransparent?: boolean;
     };
+    /**
+     * Alpha inverse effect (`a:alphaInv`). Inverts the alpha channel; an optional
+     * colour child shifts the inversion baseline.
+     */
+    alphaInv?: {
+        /** Optional baseline colour (hex). */
+        color?: string;
+    };
+    /** Alpha ceiling (`a:alphaCeiling`) — clamps any non-zero alpha to fully opaque. Boolean flag. */
+    alphaCeiling?: boolean;
+    /** Alpha floor (`a:alphaFloor`) — clamps any non-fully-opaque alpha to fully transparent. Boolean flag. */
+    alphaFloor?: boolean;
+    /**
+     * Alpha modulate (`a:alphaMod`). The schema requires a single `cont` (effect
+     * container) child; we preserve the inner XML opaquely for round-trip.
+     */
+    alphaMod?: {
+        /** Raw opaque XML for the `a:cont` child to preserve on save. */
+        contRawXml?: Record<string, unknown>;
+    };
+    /** Alpha replace (`a:alphaRepl`) — replaces alpha with the given fixed-percent value (0..100). */
+    alphaRepl?: number;
+    /** Alpha bi-level (`a:alphaBiLevel`) — threshold (0..100) above which alpha becomes fully opaque. */
+    alphaBiLevel?: number;
+    /**
+     * Colour replace (`a:clrRepl`) — replaces all colour information in an image
+     * with the given solid colour. Stores the raw colour child to preserve scheme
+     * colour references and modifiers.
+     */
+    clrRepl?: {
+        /** Resolved hex colour. */
+        color: string;
+        /** Raw opaque colour XML for round-trip. */
+        rawXml?: Record<string, unknown>;
+    };
+    /** Luminance modulation (`a:lum`) — bright/contrast as fixed percentages (0..100). */
+    lum?: {
+        bright?: number;
+        contrast?: number;
+    };
+    /** HSL modulation (`a:hsl`) — hue (0..360 degrees), saturation/luminance (-100..100). */
+    hsl?: {
+        hue?: number;
+        sat?: number;
+        lum?: number;
+    };
+    /** Image-effect tint (`a:tint` inside blip) — hue (0..360), amount (-100..100). */
+    tint?: {
+        hue?: number;
+        amt?: number;
+    };
+    /**
+     * Fill overlay (`a:fillOverlay`) — overlays a fill on top of the blip.
+     * Stores blend mode and the raw inner fill XML for round-trip.
+     */
+    fillOverlay?: {
+        blend: 'over' | 'mult' | 'screen' | 'darken' | 'lighten';
+        /** Raw opaque fill XML preserved for round-trip. */
+        fillRawXml?: Record<string, unknown>;
+    };
+    /** Blur (`a:blur`) — radius in EMU and grow flag. */
+    blur?: {
+        rad?: number;
+        grow?: boolean;
+    };
 }
 /**
  * Shape names used for crop-to-shape (CSS `clip-path` equivalent).
@@ -1205,6 +1518,36 @@ interface PptxImageProperties {
     /** Crop-to-shape — CSS clip-path shape name. */
     cropShape?: PptxCropShape;
 }
+declare module './text' {
+    interface TextStyle {
+        /**
+         * Raw `a:effectDag` XML node from `a:rPr`, preserved verbatim for
+         * round-trip serialisation. Mirrors the shape-level
+         * {@link import('./shape-style').ShapeStyle.effectDagXml} field.
+         */
+        textEffectDagXml?: XmlObject;
+        /**
+         * Typed effect graph parsed from `textEffectDagXml`. The four structural
+         * container nodes (`a:cont`, `a:blend`, `a:xfrmEffect`, `a:relOff`) are
+         * fully typed; any other leaf effect is captured as
+         * {@link EffectDagRawLeaf} so we never have to recurse into the full
+         * effect taxonomy.
+         */
+        textEffectDagTree?: EffectDagContainer;
+    }
+}
+declare module './shape-style' {
+    interface ShapeStyle {
+        /**
+         * Typed effect graph parsed from {@link ShapeStyle.effectDagXml}. The four
+         * structural container nodes (`a:cont`, `a:blend`, `a:xfrmEffect`,
+         * `a:relOff`) are fully typed; any other leaf effect (e.g. `a:outerShdw`,
+         * `a:glow`, `a:alphaInv`) is captured as {@link EffectDagRawLeaf} so we
+         * never have to recurse into the full effect taxonomy.
+         */
+        effectDagTree?: EffectDagContainer;
+    }
+}
 
 /**
  * Geometry types: adjustment handles, custom geometry points, segments,
@@ -1341,6 +1684,112 @@ interface CustomGeometryRawData {
     /** Raw `a:rect` XML content (text rectangle). */
     rectXml?: unknown;
 }
+/**
+ * XY-style adjustment handle (`a:ahXY`) on a custom geometry.
+ *
+ * Allows interactive editing of one or two guide values constrained to a
+ * rectangular range. Coordinates are formula references (e.g. `"adj1"`,
+ * `"w/2"`, `"0"`) preserved verbatim so they can re-emit unchanged.
+ *
+ * @example
+ * ```ts
+ * const handle: AdjustHandleXY = {
+ *   gdRefX: "adj1",
+ *   minX: "0",
+ *   maxX: "w",
+ *   posX: "adj1",
+ *   posY: "h/2",
+ * };
+ * // => satisfies AdjustHandleXY
+ * ```
+ */
+interface AdjustHandleXY {
+    /** Guide reference for the X axis (`@_gdRefX`). */
+    gdRefX?: string;
+    /** Guide reference for the Y axis (`@_gdRefY`). */
+    gdRefY?: string;
+    /** Minimum X value, as a formula reference (`@_minX`). */
+    minX?: string;
+    /** Maximum X value (`@_maxX`). */
+    maxX?: string;
+    /** Minimum Y value (`@_minY`). */
+    minY?: string;
+    /** Maximum Y value (`@_maxY`). */
+    maxY?: string;
+    /** Handle position X (formula or literal) from `a:pos/@_x`. */
+    posX?: string;
+    /** Handle position Y from `a:pos/@_y`. */
+    posY?: string;
+}
+/**
+ * Polar-style adjustment handle (`a:ahPolar`) on a custom geometry.
+ *
+ * Drives a guide via radial distance and angle rather than XY coordinates.
+ *
+ * @example
+ * ```ts
+ * const handle: AdjustHandlePolar = {
+ *   gdRefR: "adj1",
+ *   gdRefAng: "adj2",
+ *   posX: "wd2",
+ *   posY: "hd2",
+ * };
+ * // => satisfies AdjustHandlePolar
+ * ```
+ */
+interface AdjustHandlePolar {
+    /** Guide reference for the radial distance (`@_gdRefR`). */
+    gdRefR?: string;
+    /** Guide reference for the angle (`@_gdRefAng`). */
+    gdRefAng?: string;
+    /** Minimum radial value (`@_minR`). */
+    minR?: string;
+    /** Maximum radial value (`@_maxR`). */
+    maxR?: string;
+    /** Minimum angle (`@_minAng`). */
+    minAng?: string;
+    /** Maximum angle (`@_maxAng`). */
+    maxAng?: string;
+    /** Handle position X from `a:pos/@_x`. */
+    posX?: string;
+    /** Handle position Y from `a:pos/@_y`. */
+    posY?: string;
+}
+/**
+ * Connection site (`a:cxn`) on a custom geometry.
+ *
+ * Defines a point on a custom shape that connectors may snap to.
+ *
+ * @example
+ * ```ts
+ * const cxn: ConnectionSite = { ang: "0", posX: "0", posY: "hd2" };
+ * // => satisfies ConnectionSite
+ * ```
+ */
+interface ConnectionSite {
+    /** Approach angle (`@_ang`) — formula or literal degree-1/60000 value. */
+    ang?: string;
+    /** Site position X from `a:pos/@_x`. */
+    posX?: string;
+    /** Site position Y from `a:pos/@_y`. */
+    posY?: string;
+}
+/**
+ * Typed text rectangle (`a:rect`) on a custom geometry.
+ *
+ * Each edge is the formula or literal string preserved from the source XML
+ * (`"l"`, `"t"`, `"r"`, `"b"`, or any guide name / formula).
+ */
+interface CustomGeometryTextRect {
+    /** Left edge formula reference (`@_l`). */
+    l?: string;
+    /** Top edge (`@_t`). */
+    t?: string;
+    /** Right edge (`@_r`). */
+    r?: string;
+    /** Bottom edge (`@_b`). */
+    b?: string;
+}
 /**
  * Custom (non-preset) geometry path — only on shapes and pictures.
  *
@@ -1368,6 +1817,25 @@ interface PptxCustomPathProperties {
     customGeometryPaths?: CustomGeometryPath[];
     /** Raw a:gdLst/a:ahLst/a:cxnLst/a:rect XML preserved for round-trip serialization. */
     customGeometryRawData?: CustomGeometryRawData;
+    /**
+     * Typed XY adjustment handles parsed from `a:custGeom/a:ahLst/a:ahXY`.
+     * SDK-built shapes can populate this and the writer will emit `<a:ahXY>` entries
+     * even when no raw XML was preserved.
+     */
+    customGeometryAdjustHandlesXY?: AdjustHandleXY[];
+    /**
+     * Typed polar adjustment handles parsed from `a:custGeom/a:ahLst/a:ahPolar`.
+     */
+    customGeometryAdjustHandlesPolar?: AdjustHandlePolar[];
+    /**
+     * Typed connection sites parsed from `a:custGeom/a:cxnLst/a:cxn`.
+     */
+    customGeometryConnectionSites?: ConnectionSite[];
+    /**
+     * Typed text rectangle parsed from `a:custGeom/a:rect`. When present this is
+     * preferred over {@link customGeometryRawData}'s `rectXml` on save.
+     */
+    customGeometryTextRect?: CustomGeometryTextRect;
 }
 
 /**
@@ -1385,7 +1853,7 @@ interface PptxCustomPathProperties {
  * // => "bar" — one of: "bar" | "line" | "pie" | "doughnut" | "area" | "scatter" | …
  * ```
  */
-type PptxChartType = 'bar' | 'line' | 'pie' | 'doughnut' | 'area' | 'scatter' | 'bubble' | 'radar' | 'stock' | 'bar3D' | 'line3D' | 'pie3D' | 'area3D' | 'surface' | 'histogram' | 'waterfall' | 'funnel' | 'treemap' | 'sunburst' | 'boxWhisker' | 'regionMap' | 'combo' | 'unknown';
+type PptxChartType = 'bar' | 'line' | 'pie' | 'ofPie' | 'doughnut' | 'area' | 'scatter' | 'bubble' | 'radar' | 'stock' | 'bar3D' | 'line3D' | 'pie3D' | 'area3D' | 'surface' | 'histogram' | 'waterfall' | 'funnel' | 'treemap' | 'sunburst' | 'boxWhisker' | 'regionMap' | 'combo' | 'unknown';
 /**
  * Supported trendline regression types.
  *
@@ -1666,6 +2134,69 @@ interface PptxExternalData {
     /** Raw binary data of the embedded xlsx workbook (from ppt/embeddings/). */
     embeddedWorkbookData?: Uint8Array;
 }
+/**
+ * Options specific to the OOXML "Pie of Pie" / "Bar of Pie" chart
+ * (`c:ofPieChart`, ECMA-376 §21.2.2.126 / CT_OfPieChart).
+ *
+ * The primary discriminator is {@link ofPieType}: `"pie"` produces a
+ * pie-of-pie chart whose secondary plot is itself a pie, while `"bar"`
+ * produces a bar-of-pie chart whose secondary plot is a horizontal bar.
+ *
+ * - {@link splitType} chooses the split rule.
+ * - {@link splitPos} is the threshold value used by `pos`/`val`/`percent`.
+ * - {@link secondPieSize} controls the secondary plot's size (5–200%).
+ * - {@link serLines} toggles the leader lines connecting the plots.
+ * - {@link gapWidth} is the gap between the plots in percent (0–500).
+ */
+interface PptxChartOfPieOptions {
+    ofPieType: 'pie' | 'bar';
+    splitType?: 'auto' | 'cust' | 'percent' | 'pos' | 'val';
+    splitPos?: number;
+    custSplit?: number[];
+    secondPieSize?: number;
+    serLines?: boolean;
+    gapWidth?: number;
+}
+/**
+ * 3D viewing parameters for a chart (`c:view3D`, ECMA-376 §21.2.2.228 /
+ * CT_View3D).
+ *
+ * All fields are optional and round-trip verbatim.
+ *
+ * - {@link rotX} — X-axis rotation in degrees (-90…90).
+ * - {@link rotY} — Y-axis rotation in degrees (0…360).
+ * - {@link depthPercent} — chart depth as a percentage of base width.
+ * - {@link rAngAx} — `true` if axes meet at right angles.
+ * - {@link perspective} — perspective angle in degrees (0…240).
+ * - {@link hPercent} — height as a percentage of chart width.
+ */
+interface PptxChartView3D {
+    rotX?: number;
+    rotY?: number;
+    depthPercent?: number;
+    rAngAx?: boolean;
+    perspective?: number;
+    hPercent?: number;
+}
+/**
+ * Chart "chrome" flags from `c:chart` that round-trip cleanly even when
+ * rendering ignores them.
+ *
+ * - {@link autoTitleDeleted} — `c:autoTitleDeleted/@val`. Suppresses the
+ *   auto-generated title for single-series charts.
+ * - {@link dispBlanksAs} — `c:dispBlanksAs/@val`. How blank cells
+ *   render: `"gap"`, `"zero"`, or `"span"`.
+ * - {@link showDLblsOverMax} — `c:showDLblsOverMax/@val`. Keeps data
+ *   labels visible for points exceeding the value-axis maximum.
+ *
+ * `c:plotVisOnly` lives on {@link PptxChartData.plotVisibleOnly} and is
+ * intentionally not duplicated here.
+ */
+interface PptxChartChrome {
+    autoTitleDeleted?: boolean;
+    dispBlanksAs?: 'gap' | 'zero' | 'span';
+    showDLblsOverMax?: boolean;
+}
 /** Parsed data extracted from an embedded xlsx workbook. */
 interface PptxEmbeddedWorkbookData {
     /** Category labels from the first column/row. */
@@ -1759,6 +2290,52 @@ interface PptxChartData {
      * - `"acrossLinear"` — gradient across series
      */
     colorMethod?: 'cycle' | 'withinLinear' | 'acrossLinear';
+    /**
+     * Pie-of-pie / Bar-of-pie options (`c:ofPieChart`, CT_OfPieChart).
+     *
+     * Present only when {@link chartType} is `"ofPie"`. Carries the split
+     * configuration, secondary plot size, and serLines flag so that an
+     * `ofPieChart` element can be re-emitted on save with full fidelity.
+     */
+    ofPieOptions?: PptxChartOfPieOptions;
+    /**
+     * 3D viewing parameters (`c:view3D`, CT_View3D).
+     *
+     * Parsed from and emitted to `c:chart/c:view3D`. Absent when the
+     * chart XML has no `c:view3D` element.
+     */
+    view3D?: PptxChartView3D;
+    /**
+     * Top-level chart chrome flags (`c:autoTitleDeleted`,
+     * `c:dispBlanksAs`, `c:showDLblsOverMax`).
+     *
+     * Each flag is omitted from the emitted XML when absent on the
+     * source data, so absence does not produce empty `<c:…/>` placeholders.
+     */
+    chartChrome?: PptxChartChrome;
+    /**
+     * Raw `c:userShapes` XML subtree (a drawing tree) preserved verbatim.
+     *
+     * `c:userShapes` references a separate drawing part containing
+     * shapes drawn over the chart. The reference is preserved as-is so
+     * that round-trip save re-emits the original element without
+     * attempting to parse the nested drawing tree.
+     */
+    userShapesXml?: unknown;
+    /**
+     * Raw `c:pivotFmts` XML subtree preserved verbatim.
+     *
+     * `c:pivotFmts` carries a list of `c:pivotFmt` formatting overrides
+     * for charts whose data originates from a PivotTable. Preserved
+     * verbatim for round-trip fidelity.
+     */
+    pivotFmtsXml?: unknown;
+    /**
+     * Color-map override (`c:clrMapOvr`) carrying 12 attributes that
+     * remap theme colour roles for this chart only. Preserved as a flat
+     * `attribute → value` map for round-trip fidelity.
+     */
+    clrMapOvr?: Record<string, string>;
 }
 
 /**
@@ -2072,8 +2649,8 @@ interface PptxTableCellStyle {
     borderRightColor?: string;
     align?: 'left' | 'center' | 'right' | 'justify';
     vAlign?: 'top' | 'middle' | 'bottom';
-    /** Text direction from `a:tcPr/@vert`. */
-    textDirection?: 'vertical' | 'vertical270' | 'eaVert' | 'wordArtVert' | 'wordArtVertRtl' | 'mongolianVert';
+    /** Text direction from `a:tcPr/@vert` (spec values from CT_TextVerticalType). */
+    textDirection?: 'vert' | 'vert270' | 'eaVert' | 'wordArtVert' | 'wordArtVertRtl' | 'mongolianVert';
     /** Cell left margin in px (from a:tcPr > a:tcMar > a:marL). */
     marginLeft?: number;
     /** Cell right margin in px. */
@@ -2172,6 +2749,14 @@ interface PptxTableCell {
     vMerge?: boolean;
     /** Whether this cell is horizontally merged with the cell to the left (gridSpan continuation). */
     hMerge?: boolean;
+    /**
+     * Opaque round-trip storage for `a:tcPr` attributes that don't yet have
+     * typed equivalents on {@link PptxTableCellStyle} (e.g. `horzOverflow`,
+     * `anchorCtr`, `headers`, `hideSlicers`, `slicerCacheId`). Keys are the
+     * raw XML attribute names without the `@_` prefix used by
+     * fast-xml-parser. Re-emitted verbatim by the save writer when present.
+     */
+    extraAttributes?: Record<string, string>;
 }
 /**
  * A single table row with an optional height and an array of cells.
@@ -2235,6 +2820,8 @@ interface PptxTableData {
     bandRowCycle?: number;
     /** Number of columns per banding group (default 1). */
     bandColCycle?: number;
+    /** Right-to-left table layout from `a:tblPr/@rtl`. */
+    rtl?: boolean;
 }
 /**
  * A single fill reference within a table style section.
@@ -2288,11 +2875,26 @@ interface ParsedTableStyleText {
     /** Font colour shade (0-100 000). */
     fontShade?: number;
 }
+/**
+ * Table background style (CT_TableBackgroundStyle, ECMA-376 §21.1.3.7).
+ *
+ * Corresponds to the `<a:tblBg>` child of `<a:tblStyle>`. Currently
+ * captures only the resolved scheme-fill colour (verbatim XML for fill
+ * / effect references is preserved separately by the save path).
+ */
+interface ParsedTableBackground {
+    /** Solid fill (resolved from `a:fill > a:solidFill > a:schemeClr`). */
+    fill?: ParsedTableStyleFill;
+    /** Has an `a:effectLst` child that should be round-tripped. */
+    hasEffectLst?: boolean;
+}
 interface ParsedTableStyleEntry {
     styleId: string;
     styleName?: string;
     /** Dominant accent key derived from fills (e.g. `accent1`). */
     accentKey?: string;
+    /** Table-level background (`<a:tblBg>`). */
+    tableBackground?: ParsedTableBackground;
     wholeTblFill?: ParsedTableStyleFill;
     band1HFill?: ParsedTableStyleFill;
     band2HFill?: ParsedTableStyleFill;
@@ -2302,6 +2904,11 @@ interface ParsedTableStyleEntry {
     lastRowFill?: ParsedTableStyleFill;
     firstColFill?: ParsedTableStyleFill;
     lastColFill?: ParsedTableStyleFill;
+    /** Corner cell fills (`<a:seCell>`, `<a:swCell>`, `<a:neCell>`, `<a:nwCell>`). */
+    seCellFill?: ParsedTableStyleFill;
+    swCellFill?: ParsedTableStyleFill;
+    neCellFill?: ParsedTableStyleFill;
+    nwCellFill?: ParsedTableStyleFill;
     /** Per-role text styling from a:tcTxStyle. */
     wholeTblText?: ParsedTableStyleText;
     firstRowText?: ParsedTableStyleText;
@@ -2312,6 +2919,10 @@ interface ParsedTableStyleEntry {
     band2HText?: ParsedTableStyleText;
     band1VText?: ParsedTableStyleText;
     band2VText?: ParsedTableStyleText;
+    seCellText?: ParsedTableStyleText;
+    swCellText?: ParsedTableStyleText;
+    neCellText?: ParsedTableStyleText;
+    nwCellText?: ParsedTableStyleText;
 }
 /**
  * Map of GUID → table style entry.
@@ -2353,7 +2964,7 @@ type ParsedTableStyleMap = Record<string, ParsedTableStyleEntry>;
  * // => "morph" — one of 40+ transition effects
  * ```
  */
-type PptxTransitionType = 'none' | 'cut' | 'fade' | 'push' | 'wipe' | 'split' | 'randomBar' | 'blinds' | 'checker' | 'circle' | 'comb' | 'cover' | 'diamond' | 'dissolve' | 'plus' | 'pull' | 'random' | 'strips' | 'uncover' | 'wedge' | 'wheel' | 'zoom' | 'newsflash' | 'morph' | 'conveyor' | 'doors' | 'ferris' | 'flash' | 'flythrough' | 'gallery' | 'glitter' | 'honeycomb' | 'pan' | 'prism' | 'reveal' | 'ripple' | 'shred' | 'switch' | 'vortex' | 'warp' | 'wheelReverse' | 'window';
+type PptxTransitionType = 'none' | 'cut' | 'fade' | 'push' | 'wipe' | 'split' | 'randomBar' | 'blinds' | 'checker' | 'circle' | 'comb' | 'cover' | 'diamond' | 'dissolve' | 'plus' | 'pull' | 'random' | 'strips' | 'uncover' | 'wedge' | 'wheel' | 'zoom' | 'newsflash' | 'morph' | 'conveyor' | 'doors' | 'ferris' | 'flash' | 'flythrough' | 'gallery' | 'glitter' | 'honeycomb' | 'pan' | 'prism' | 'reveal' | 'ripple' | 'shred' | 'switch' | 'vortex' | 'warp' | 'wheelReverse' | 'window' | 'cube' | 'flip' | 'rotate' | 'orbit';
 /** Cardinal direction tokens from OOXML transition `@_dir`. */
 type PptxTransitionDirection4 = 'l' | 'r' | 'u' | 'd';
 /** 8-way direction tokens (cardinal + diagonal) for cover/uncover. */
@@ -2400,6 +3011,11 @@ interface PptxSlideTransition {
     soundPath?: string;
     /** Human-readable sound file name (extracted from soundPath). */
     soundFileName?: string;
+    /**
+     * When true, the transition stops the currently-playing sound (OOXML `p:sndAc/p:endSnd`).
+     * Mutually exclusive with `soundRId`/`soundPath` (which use `p:stSnd`).
+     */
+    stopSound?: boolean;
     /** Preserved sound-action XML node from `p:sndAc` for lossless round-trip. */
     rawSoundAction?: XmlObject;
     /** Preserved extension-list XML node from `p:extLst` within the transition for lossless round-trip. */
@@ -2429,6 +3045,13 @@ type PptxAnimationTimingCurve = 'ease' | 'ease-in' | 'ease-out' | 'linear';
 type PptxAnimationRepeatMode = 'untilNextClick' | 'untilEndOfSlide';
 /** Animation trigger type from OOXML `p:cTn`. */
 type PptxAnimationTrigger = 'onClick' | 'onShapeClick' | 'onHover' | 'afterPrevious' | 'withPrevious' | 'afterDelay';
+/**
+ * Native animation kind. The historic shape-targeted preset animations are
+ * implicitly the default kind (`undefined`). Media animations (`p:audio`,
+ * `p:video`) emit dedicated entries so playback order on the slide timeline
+ * is preserved alongside other animations.
+ */
+type PptxNativeAnimationKind = 'media';
 /**
  * Parsed native animation record from `p:timing / p:tnLst`.
  *
@@ -2470,12 +3093,32 @@ interface PptxNativeAnimation {
     motionOrigin?: string;
     /** Whether the element auto-rotates to follow the motion path tangent (`p:animMotion/@rAng` = "0"). */
     motionPathRotateAuto?: boolean;
-    /** Rotation angle in degrees for `p:animRot` (converted from 60000ths). */
+    /** Path edit mode from `p:animMotion/@pathEditMode` (e.g. "relative", "fixed"). */
+    motionPathEditMode?: string;
+    /** Comma-separated point-types string from `p:animMotion/@ptsTypes`. */
+    motionPtsTypes?: string;
+    /** Rotation angle in degrees for `p:animRot/@by` (converted from 60000ths). */
     rotationBy?: number;
-    /** X scale factor (percentage / 100) for `p:animScale`. */
+    /** Starting rotation angle in degrees for `p:animRot/@from` (converted from 60000ths). */
+    rotationFrom?: number;
+    /** Ending rotation angle in degrees for `p:animRot/@to` (converted from 60000ths). */
+    rotationTo?: number;
+    /** X scale factor (percentage / 100) for `p:animScale/p:by/@x`. */
     scaleByX?: number;
-    /** Y scale factor (percentage / 100) for `p:animScale`. */
+    /** Y scale factor (percentage / 100) for `p:animScale/p:by/@y`. */
     scaleByY?: number;
+    /** Starting X scale factor for `p:animScale/p:from/@x`. */
+    scaleFromX?: number;
+    /** Starting Y scale factor for `p:animScale/p:from/@y`. */
+    scaleFromY?: number;
+    /** Ending X scale factor for `p:animScale/p:to/@x`. */
+    scaleToX?: number;
+    /** Ending Y scale factor for `p:animScale/p:to/@y`. */
+    scaleToY?: number;
+    /** Whether `p:animScale/@zoomContents` was set ("1"/"true"). */
+    scaleZoomContents?: boolean;
+    /** Parsed `p:tav` keyframes from `p:tavLst` (CT_TLAnimVariantList). */
+    keyframes?: PptxAnimationKeyframe[];
     /** Repeat count (e.g. `2`, `Infinity` for indefinite). */
     repeatCount?: number;
     /** Whether the animation plays in reverse after completion. */
@@ -2510,6 +3153,73 @@ interface PptxNativeAnimation {
     commandString?: string;
     /** Iteration configuration from `p:iterate`. */
     iterate?: PptxAnimationIterate;
+    /**
+     * Discriminator for non-preset animation kinds. When `undefined`, the
+     * entry represents the default shape-effect animation. The `'media'`
+     * kind represents a `p:audio` / `p:video` timing node, captured here so
+     * playback order in the timeline is preserved alongside other animations.
+     */
+    kind?: PptxNativeAnimationKind;
+    /**
+     * For `kind === 'media'`, identifies whether this is an audio or video
+     * media node so writers know which OOXML element to re-emit.
+     */
+    mediaType?: 'audio' | 'video';
+    /**
+     * SmartArt build attribute (`p:bldDgm/@bld`) when this animation is
+     * associated with a SmartArt diagram build. Common values include
+     * `whole`, `one`, `lvlOne`, `lvlAtOnce`.
+     */
+    smartArtBuild?: string;
+    /**
+     * Graphic-frame build attribute (`p:bldGraphic/@bld`) when this animation
+     * is associated with a generic graphic frame build (charts, tables, etc.
+     * that aren't OLE charts).
+     */
+    graphicBuild?: string;
+    /**
+     * Opaque map of `p:cTn` attributes that don't have a typed home on this
+     * interface but must round-trip through parse → save. Keys are stored
+     * verbatim including the `@_` prefix used by the underlying XML parser
+     * (e.g. `@_evtFilter`, `@_display`, `@_masterRel`, `@_nodePh`,
+     * `@_endSync`, `@_progress`). The `subTnLst` child element is also
+     * preserved here under the literal key `p:subTnLst`. The `afterEffect`
+     * attribute is surfaced separately as a typed boolean ({@link afterEffect})
+     * because it changes write semantics for subsequent timing nodes.
+     */
+    cTnAttributes?: Record<string, unknown>;
+    /**
+     * Whether the OOXML `p:cTn/@afterEffect` flag is set. Indicates this node
+     * runs after the parent effect's main body has completed; affects how
+     * subsequent peer nodes are sequenced when serialised back to OOXML.
+     */
+    afterEffect?: boolean;
+}
+/**
+ * Single keyframe parsed from a `p:tav` element (CT_TLTimeAnimateValue).
+ *
+ * Each entry in a `p:tavLst` has a time fraction (`@_tm`, in 1000ths of the
+ * total duration; or the literal "indefinite" / "large") and a typed value
+ * child under `p:val/p:strVal|p:boolVal|p:intVal|p:fltVal|p:clrVal`.
+ *
+ * @see ECMA-376 §19.5.30 CT_TLAnimVariantList / §19.5.92 CT_TLTimeAnimateValue
+ */
+interface PptxAnimationKeyframe {
+    /**
+     * Time fraction. A finite number is the OOXML `@_tm` integer (0–100000
+     * for percentage, where 100000 = 100% of duration). A string preserves
+     * special tokens ("indefinite", "large").
+     */
+    tm: number | string;
+    /** Decoded keyframe value. */
+    value: string | boolean | number;
+    /** Discriminant indicating which `p:val` child carried the value. */
+    valueType: 'str' | 'bool' | 'int' | 'flt' | 'clr';
+    /**
+     * Optional formula carried on `p:tav/@_fmla`. Preserved for round-trip
+     * fidelity; consumers may use it to drive computed animation values.
+     */
+    fmla?: string;
 }
 /** Color animation data parsed from `p:animClr`. */
 interface PptxColorAnimation {
@@ -2517,11 +3227,22 @@ interface PptxColorAnimation {
     colorSpace: 'hsl' | 'rgb';
     /** Direction for HSL interpolation: "cw" (clockwise) or "ccw". */
     direction?: 'cw' | 'ccw';
+    /**
+     * Optional `p:animClr/@path` value preserved for round-trip. When set,
+     * the colour sweep follows a path-based interpolation rather than the
+     * straight cw/ccw arc. ECMA-376 §19.5.13 documents this attribute as a
+     * companion to `@dir` for HSL colour-space animations.
+     */
+    path?: string;
     /** Starting color as hex string. */
     fromColor?: string;
     /** Ending color as hex string. */
     toColor?: string;
-    /** Color delta (for "by" animations) as hex string. */
+    /**
+     * Color delta (for "by" animations) as hex string. For HSL colour-space
+     * animations the value encodes a delta over hue/sat/lum and is preserved
+     * verbatim from the source.
+     */
     byColor?: string;
     /**
      * Target attribute from `p:attrNameLst` (e.g. "fillcolor", "style.color",
@@ -2635,6 +3356,13 @@ interface PptxElementAnimation {
     afterAnimationColor?: string;
     /** SVG motion path string for custom motion path animations. */
     motionPath?: string;
+    /**
+     * Path edit mode for `p:animMotion/@pathEditMode`. Defaults to "relative"
+     * when emitted without an explicit value.
+     */
+    motionPathEditMode?: string;
+    /** Comma-separated point-types string for `p:animMotion/@ptsTypes`. */
+    motionPtsTypes?: string;
     /** Sound relationship ID to play when animation triggers (`p:stSnd`). */
     soundRId?: string;
     /** Resolved sound file path from relationship. */
@@ -3133,6 +3861,16 @@ interface PptxElementBase {
     actionHover?: PptxAction;
     /** Shape lock attributes parsed from `p:cNvSpPr/a:spLocks`. */
     locks?: PptxShapeLocks;
+    /**
+     * Opaque `<a:ext>` children captured from the shape's `<a:extLst>` whose
+     * URI is not recognised by a typed extractor (hidden fill/line, image
+     * effects, …). Preserved verbatim and re-emitted on save so unknown
+     * vendor extensions survive a round-trip.
+     *
+     * Mirrors the existing `effectDagXml` / `endParaRunProperties` raw-XML
+     * preservation pattern.
+     */
+    extLstXml?: XmlObject[];
 }
 /**
  * Text content mixin — present on text boxes and shapes.
@@ -3271,20 +4009,6 @@ interface PlaceholderDefaults {
     promptText?: string;
 }
 
-/**
- * Concrete element types (one per `type` discriminant) and the
- * {@link PptxElement} discriminated union.
- *
- * Narrow on `element.type` to access variant-specific properties:
- * ```ts
- * if (element.type === "image") {
- *   console.log(element.imageData); // ImagePptxElement-only
- * }
- * ```
- *
- * @module pptx-types/elements
- */
-
 /**
  * A text box — a plain rectangle containing text, typically with no
  * visible fill or stroke.
@@ -3369,6 +4093,21 @@ interface ImagePptxElement extends PptxElementBase, PptxShapeProperties, PptxCus
 interface PicturePptxElement extends PptxElementBase, PptxShapeProperties, PptxCustomPathProperties, PptxImageProperties {
     type: 'picture';
 }
+/**
+ * A single unrecognised `<a:graphicData>/<a:extLst>/<a:ext>` extension on a
+ * graphicFrame, captured verbatim so the round-trip can preserve future or
+ * vendor-specific markup that the parser doesn't yet understand.
+ *
+ * The XML is preserved as a fast-xml-parser object tree (the same shape as
+ * `rawXml` on other elements) so the save layer can re-emit it through the
+ * existing builder without lossy string manipulation.
+ */
+interface PptxGraphicFrameExtension {
+    /** The `@_uri` attribute identifying the extension (e.g. `{C3CD43...}`). */
+    uri: string;
+    /** Parsed XML payload of the extension, suitable for re-serialization. */
+    xml: XmlObject;
+}
 /**
  * A table embedded via a `<p:graphicFrame>`.
  *
@@ -3391,6 +4130,11 @@ interface TablePptxElement extends PptxElementBase {
     type: 'table';
     /** Parsed table cell data for editing. */
     tableData?: PptxTableData;
+    /**
+     * Unrecognised extensions captured from `a:graphicData/a:extLst` so they
+     * round-trip losslessly. See {@link PptxGraphicFrameExtension}.
+     */
+    extensionXml?: PptxGraphicFrameExtension[];
 }
 /**
  * A chart embedded via a `<p:graphicFrame>`.
@@ -3401,6 +4145,8 @@ interface TablePptxElement extends PptxElementBase {
 interface ChartPptxElement extends PptxElementBase {
     type: 'chart';
     chartData?: PptxChartData;
+    /** Unrecognised graphicFrame extLst extensions, captured verbatim for round-trip. */
+    extensionXml?: PptxGraphicFrameExtension[];
 }
 /**
  * A SmartArt diagram embedded via a `<p:graphicFrame>`.
@@ -3411,6 +4157,8 @@ interface ChartPptxElement extends PptxElementBase {
 interface SmartArtPptxElement extends PptxElementBase {
     type: 'smartArt';
     smartArtData?: PptxSmartArtData;
+    /** Unrecognised graphicFrame extLst extensions, captured verbatim for round-trip. */
+    extensionXml?: PptxGraphicFrameExtension[];
 }
 /**
  * Recognised OLE object application types derived from `progId` / `clsId`.
@@ -3458,6 +4206,14 @@ interface OlePptxElement extends PptxElementBase {
     previewImage?: string;
     /** Decoded preview image as a data-URL. */
     previewImageData?: string;
+    /** Whether the OLE object is shown as an icon (`p:oleObj/@showAsIcon`). */
+    oleShowAsIcon?: boolean;
+    /** Authored display width of the OLE object preview, in EMU (`@imgW`). */
+    oleImgW?: number;
+    /** Authored display height of the OLE object preview, in EMU (`@imgH`). */
+    oleImgH?: number;
+    /** Unrecognised graphicFrame extLst extensions, captured verbatim for round-trip. */
+    extensionXml?: PptxGraphicFrameExtension[];
 }
 /**
  * An audio or video media element.
@@ -3519,6 +4275,13 @@ interface MediaPptxElement extends PptxElementBase {
     captionTracks?: MediaCaptionTrack[];
     /** Whether the media source is missing/broken (file not found in archive). */
     mediaMissing?: boolean;
+    /**
+     * Whether the media is linked (external `r:link`) rather than embedded
+     * (`r:embed`). Defaults to embedded when undefined.
+     */
+    isLinked?: boolean;
+    /** Unrecognised graphicFrame extLst extensions, captured verbatim for round-trip. */
+    extensionXml?: PptxGraphicFrameExtension[];
 }
 /**
  * A group container that holds child elements.
@@ -3570,6 +4333,8 @@ interface InkPptxElement extends PptxElementBase {
      * variable-width strokes that reflect stylus/pen pressure.
      */
     inkPointPressures?: number[][];
+    /** Unrecognised graphicFrame extLst extensions, captured verbatim for round-trip. */
+    extensionXml?: PptxGraphicFrameExtension[];
 }
 /**
  * A single ink stroke within a {@link ContentPartPptxElement}.
@@ -3641,10 +4406,14 @@ interface Model3DPptxElement extends PptxElementBase, PptxImageProperties {
     modelMimeType?: string;
     /** Poster/preview image shown when 3D rendering is unavailable. */
     posterImage?: string;
+    /** Unrecognised graphicFrame extLst extensions, captured verbatim for round-trip. */
+    extensionXml?: PptxGraphicFrameExtension[];
 }
 /** An element whose type is not recognised by the parser. */
 interface UnknownPptxElement extends PptxElementBase {
     type: 'unknown';
+    /** Unrecognised graphicFrame extLst extensions, captured verbatim for round-trip. */
+    extensionXml?: PptxGraphicFrameExtension[];
 }
 /**
  * A single element on a PPTX slide.
@@ -3785,8 +4554,14 @@ interface PptxThemeFontScheme {
  * ```
  */
 interface PptxThemeFillStyle {
-    /** Discriminator for the fill type. */
-    kind: 'solid' | 'gradient' | 'pattern' | 'none';
+    /**
+     * Discriminator for the fill type.
+     *
+     * `'group'` corresponds to `<a:grpFill/>` — a fill that inherits the
+     * containing group shape's fill at render time. Captured for round-trip
+     * preservation in `fmtScheme/fillStyleLst`.
+     */
+    kind: 'solid' | 'gradient' | 'pattern' | 'none' | 'group';
     /** Pre-resolved colour (may be `undefined` when `phClr`-dependent). */
     color?: string;
     opacity?: number;
@@ -3993,6 +4768,8 @@ interface PptxNotesMaster {
     elements?: PptxElement[];
     /** Header/footer flags from `<p:hf>` on the notes master (P-H3). */
     headerFooter?: PptxHeaderFooterFlags;
+    /** Colour map from `<p:clrMap>` (12 alias attributes). Applied at save time. */
+    clrMap?: Record<string, string>;
 }
 /**
  * Parsed handout master from `ppt/handoutMasters/handoutMaster1.xml`.
@@ -4024,6 +4801,8 @@ interface PptxHandoutMaster {
     slidesPerPage?: number;
     /** Header/footer flags from `<p:hf>` on the handout master (P-H3). */
     headerFooter?: PptxHeaderFooterFlags;
+    /** Colour map from `<p:clrMap>` (12 alias attributes). Applied at save time. */
+    clrMap?: Record<string, string>;
 }
 /**
  * Active tab within the master view sidebar.
@@ -4075,6 +4854,11 @@ interface PptxSlideMaster {
     txStyles?: PptxMasterTextStyles;
     /** Header/footer flags from `<p:hf>` on this master (P-H3). */
     headerFooter?: PptxHeaderFooterFlags;
+    /**
+     * Colour map from `<p:clrMap>` (12 alias attributes: bg1/tx1/bg2/tx2,
+     * accent1-6, hlink, folHlink). Applied at save time when present.
+     */
+    clrMap?: Record<string, string>;
 }
 /**
  * Per-level paragraph properties for a text style category.
@@ -4301,6 +5085,32 @@ interface PptxActiveXControl {
     /** Raw XML for round-trip preservation. */
     rawXml?: XmlObject;
 }
+/**
+ * Pattern fill on a slide background.
+ *
+ * Mirrors the `<a:pattFill>` choice inside `<p:bgPr>`. Renderers should
+ * draw a 2-colour preset pattern (e.g. `dkDnDiag`, `pct50`).
+ *
+ * ECMA-376 §20.1.8.47.
+ *
+ * @example
+ * ```ts
+ * const pattern: PptxSlideBackgroundPattern = {
+ *   preset: "ltDnDiag",
+ *   fgColor: "#4472C4",
+ *   bgColor: "#FFFFFF",
+ * };
+ * // => satisfies PptxSlideBackgroundPattern
+ * ```
+ */
+interface PptxSlideBackgroundPattern {
+    /** DrawingML preset pattern token (`@_prst`). */
+    preset: string;
+    /** Foreground colour resolved to `#RRGGBB`. */
+    fgColor?: string;
+    /** Background colour resolved to `#RRGGBB`. */
+    bgColor?: string;
+}
 /**
  * A single slide in a parsed PPTX presentation.
  *
@@ -4324,6 +5134,8 @@ interface PptxSlide {
     id: string;
     rId: string;
     sourceSlideId?: string;
+    /** Optional author-supplied slide name (set via `SlideBuilder.setName`). */
+    name?: string;
     layoutPath?: string;
     layoutName?: string;
     slideNumber: number;
@@ -4334,6 +5146,26 @@ interface PptxSlide {
     backgroundColor?: string;
     backgroundImage?: string;
     backgroundGradient?: string;
+    /**
+     * Pattern fill on the slide background (`<a:pattFill>` inside `<p:bgPr>`).
+     *
+     * When present, renderers should draw a real two-colour pattern using
+     * the named DrawingML preset (e.g. `"ltDnDiag"`, `"pct50"`). The flat
+     * `backgroundColor` field is left set to the foreground colour for
+     * fallback rendering paths that don't understand patterns.
+     *
+     * ECMA-376 §20.1.8.47.
+     */
+    backgroundPattern?: PptxSlideBackgroundPattern;
+    /**
+     * `<p:bgPr/@shadeToTitle>` — boolean flag instructing the renderer to
+     * shade the background toward the title placeholder colour. Captured
+     * for lossless round-trip; the React renderer currently treats it as
+     * a passthrough hint.
+     *
+     * ECMA-376 §19.3.1.2 (CT_BackgroundProperties).
+     */
+    backgroundShadeToTitle?: boolean;
     transition?: PptxSlideTransition;
     animations?: PptxElementAnimation[];
     /** Native OOXML animation data parsed from `p:timing`. */
@@ -4343,6 +5175,20 @@ interface PptxSlide {
     notes?: string;
     /** Rich text segments for the slide notes (preserves formatting). */
     notesSegments?: TextSegment[];
+    /**
+     * Parsed shapes from the notes slide's `<p:cSld>/<p:spTree>` so the full
+     * notes-page shape tree can be inspected and mutated, not just the body
+     * placeholder text. When undefined, the existing notes XML is left
+     * untouched on save and only `notes` / `notesSegments` are written.
+     */
+    notesShapes?: PptxElement[];
+    /**
+     * Per-notes-slide colour map override parsed from `<p:notes>/<p:clrMapOvr>`.
+     * Captured for lossless round-trip of the notes-slide's colour scheme.
+     */
+    notesClrMapOverride?: Record<string, string>;
+    /** Optional `<p:cSld @name>` value of the notes slide, for round-trip. */
+    notesCSldName?: string;
     comments?: PptxComment[];
     warnings?: PptxCompatibilityWarning[];
     rawXml?: XmlObject;
@@ -4382,6 +5228,8 @@ interface PptxLayoutOption {
     name: string;
     /** Standard layout type from `p:sldLayout/@type` (e.g. "obj", "twoColTx", "blank"). */
     type?: string;
+    /** ZIP path of the slide master this layout belongs to. */
+    masterPath?: string;
 }
 /**
  * Header, footer, date-time, and slide-number placeholders.
@@ -4794,4 +5642,4 @@ interface PptxEmbeddedFont {
     originalPartBytes?: Uint8Array;
 }
 
-export { type OleObjectType as $, type PptxTagCollection as A, type PptxPhotoAlbum as B, type ConnectorPptxElement as C, type PptxKinsoku as D, type PptxModifyVerifier as E, type PptxViewProperties as F, type PptxEmbeddedFont as G, type PptxExportOptions as H, type InkPptxElement as I, type PptxThemeFormatScheme as J, type TextSegment as K, type PptxComment as L, type PptxSlideTransition as M, type PptxElementAnimation as N, type PptxNativeAnimation as O, type PptxElement as P, type PptxCustomerData as Q, type PptxActiveXControl as R, type ShapePptxElement as S, type TextPptxElement as T, type AnimationCondition as U, type ShapeStyle as V, type TextStyle as W, type XmlObject as X, type ElementAction as Y, type ZoomPptxElement as Z, type PptxAction as _, type PptxElementWithShapeStyle as a, type MaterialPresetType as a$, type PptxSmartArtNode as a0, type SmartArtLayoutType as a1, type PptxSmartArtDrawingShape as a2, type PptxChartDataTable as a3, type PptxChartLineStyle as a4, type PptxChartErrBars as a5, type PptxChartTrendline as a6, type PptxChartMarker as a7, type PptxChartDataLabel as a8, type PptxChartDataPoint as a9, type PptxChartSeries as aA, type SmartArtPptxElement as aB, type GeometryAdjustmentHandle as aC, type CustomGeometryRawData as aD, type CustomGeometryPath as aE, type BulletInfo as aF, type PptxShapeLocks as aG, type PptxTextStyleLevels as aH, type PptxThemeFillStyle as aI, type PptxThemeLineStyle as aJ, type PptxThemeEffectStyle as aK, type PptxSmartArtChrome as aL, type PptxSmartArtColorTransform as aM, type PptxSmartArtQuickStyle as aN, type PptxExternalData as aO, type CustomGeometryPoint as aP, type ChartPptxElement as aQ, type ImagePptxElement as aR, type ActionButtonPreset as aS, type AnimationConditionEvent as aT, type BevelPresetType as aU, type ConnectorConnectionPoint as aV, type ContentPartInkStroke as aW, type ContentPartPptxElement as aX, type CustomGeometrySegment as aY, type ElementActionType as aZ, type MasterViewTab as a_, type PptxChartShapeProps as aa, type PptxChart3DSurface as ab, type PptxChartAxisFormatting as ac, type PptxEmbeddedWorkbookData as ad, type PptxDrawingGuide as ae, type PptxTableCellStyle as af, type PptxCustomXmlPart as ag, type PptxCommentAuthor as ah, type MediaPptxElement as ai, type PptxTableData as aj, type PptxTheme as ak, type ParsedTableStyleMap as al, type PptxSlideMaster as am, type PptxThemeOption as an, type PlaceholderDefaults as ao, type PptxMasterTextStyles as ap, type PptxThemeObjectDefaults as aq, type ParsedTableStyleFill as ar, type ParsedTableStyleText as as, type PptxImageEffects as at, type MediaBookmark as au, type PptxChartStyle as av, type TablePptxElement as aw, type OlePptxElement as ax, type GroupPptxElement as ay, type PlaceholderTextLevelStyle as az, type PptxElementWithText as b, type MediaCaptionTrack as b0, type MediaMetadata as b1, type Model3DPptxElement as b2, type ParsedTableStyleEntry as b3, type PicturePptxElement as b4, type Pptx3DScene as b5, type Pptx3DShape as b6, type PptxAfterAnimationAction as b7, type PptxAnimationDirection as b8, type PptxAnimationIterate as b9, type PptxStripDirection as bA, type PptxTableCell as bB, type PptxTableRow as bC, type PptxTag as bD, type PptxTextAnimationTarget as bE, type PptxTextBuildType as bF, type PptxTextProperties as bG, type PptxTextWarpPreset as bH, type PptxThemeFontGroup as bI, type PptxTransitionDirection4 as bJ, type PptxTransitionDirection8 as bK, type PptxViewOrigin as bL, type PptxViewScale as bM, type ShadowEffect as bN, type SmartArtColorScheme as bO, type SmartArtLayout as bP, type SmartArtStyle as bQ, THEME_COLOR_SCHEME_KEYS as bR, TRANSITION_VALID_DIRECTIONS as bS, type Text3DStyle as bT, type UnderlineStyle as bU, type UnknownPptxElement as bV, type PptxAnimationRepeatMode as ba, type PptxAnimationSequence as bb, type PptxAnimationTimingCurve as bc, type PptxChartAxisNumFmt as bd, type PptxChartErrBarDir as be, type PptxChartErrBarType as bf, type PptxChartErrValType as bg, type PptxChartMarkerSymbol as bh, type PptxChartTrendlineType as bi, type PptxColorAnimation as bj, type PptxCommonSlideViewProperties as bk, type PptxCropShape as bl, type PptxCustomPathProperties as bm, type PptxElementBase as bn, type PptxElementType as bo, type PptxExportFormat as bp, type PptxHeaderFooterFlags as bq, type PptxImageProperties as br, type PptxMediaType as bs, type PptxNormalViewProperties as bt, type PptxRestoredRegion as bu, type PptxShapeProperties as bv, type PptxSlideLayout as bw, type PptxSmartArtConnection as bx, type PptxSplitDirection as by, type PptxSplitOrientation as bz, type PptxImageLikeElement as c, type PptxThemeColorScheme as d, type PptxThemeFontScheme as e, type PptxAnimationPreset as f, type PptxAnimationTrigger as g, type StrokeDashType as h, type ConnectorArrowType as i, type PptxTransitionType as j, type PptxChartType as k, type PptxSlide as l, type PptxData as m, type PptxCompatibilityWarning as n, type PptxLayoutOption as o, type PptxChartData as p, type PptxSmartArtData as q, type PptxHeaderFooter as r, type PptxPresentationProperties as s, type PptxCustomShow as t, type PptxSection as u, type PptxCoreProperties as v, type PptxAppProperties as w, type PptxCustomProperty as x, type PptxNotesMaster as y, type PptxHandoutMaster as z };
+export { type ShapeStyle as $, type PptxSlideMaster as A, type PptxSlideLayout as B, type ConnectorPptxElement as C, type PptxTagCollection as D, type PptxPhotoAlbum as E, type PptxKinsoku as F, type PptxModifyVerifier as G, type PptxViewProperties as H, type InkPptxElement as I, type ParsedTableStyleMap as J, type PptxEmbeddedFont as K, type PptxExportOptions as L, type PptxThemeFormatScheme as M, type TextSegment as N, type PptxComment as O, type PptxElement as P, type PptxSlideBackgroundPattern as Q, type PptxSlideTransition as R, type ShapePptxElement as S, type TextPptxElement as T, type PptxElementAnimation as U, type PptxNativeAnimation as V, type PptxCustomerData as W, type XmlObject as X, type PptxActiveXControl as Y, type ZoomPptxElement as Z, type AnimationCondition as _, type PptxElementWithShapeStyle as a, type ImagePptxElement as a$, type TextStyle as a0, type ElementAction as a1, type PptxAction as a2, type OleObjectType as a3, type PptxSmartArtNode as a4, type SmartArtLayoutType as a5, type PptxSmartArtDrawingShape as a6, type PptxChartDataTable as a7, type PptxChartLineStyle as a8, type PptxChartErrBars as a9, type OlePptxElement as aA, type GroupPptxElement as aB, type PlaceholderTextLevelStyle as aC, type PptxChartOfPieOptions as aD, type PptxChartView3D as aE, type PptxChartChrome as aF, type PptxChartSeries as aG, type SmartArtPptxElement as aH, type GeometryAdjustmentHandle as aI, type CustomGeometryRawData as aJ, type AdjustHandleXY as aK, type AdjustHandlePolar as aL, type ConnectionSite as aM, type CustomGeometryTextRect as aN, type CustomGeometryPath as aO, type BulletInfo as aP, type PptxShapeLocks as aQ, type PptxTextStyleLevels as aR, type PptxThemeFillStyle as aS, type PptxThemeLineStyle as aT, type PptxThemeEffectStyle as aU, type PptxSmartArtChrome as aV, type PptxSmartArtColorTransform as aW, type PptxSmartArtQuickStyle as aX, type PptxExternalData as aY, type CustomGeometryPoint as aZ, type ChartPptxElement as a_, type PptxChartTrendline as aa, type PptxChartMarker as ab, type PptxChartDataLabel as ac, type PptxChartDataPoint as ad, type PptxChartShapeProps as ae, type PptxChart3DSurface as af, type PptxChartAxisFormatting as ag, type PptxEmbeddedWorkbookData as ah, type PptxDrawingGuide as ai, type PptxTableCellStyle as aj, type PptxCustomXmlPart as ak, type PptxCommentAuthor as al, type MediaPptxElement as am, type PptxTableData as an, type PptxTheme as ao, type PptxThemeOption as ap, type PlaceholderDefaults as aq, type PptxMasterTextStyles as ar, type PptxThemeObjectDefaults as as, type ParsedTableStyleFill as at, type ParsedTableBackground as au, type ParsedTableStyleText as av, type PptxImageEffects as aw, type MediaBookmark as ax, type PptxChartStyle as ay, type TablePptxElement as az, type PptxElementWithText as b, type PptxTextWarpPreset as b$, type ActionButtonPreset as b0, type AnimationConditionEvent as b1, type BevelPresetType as b2, type ConnectorConnectionPoint as b3, type ContentPartInkStroke as b4, type ContentPartPptxElement as b5, type CustomGeometrySegment as b6, type EffectDagBlend as b7, type EffectDagBlendMode as b8, type EffectDagContainer as b9, type PptxChartMarkerSymbol as bA, type PptxChartTrendlineType as bB, type PptxColorAnimation as bC, type PptxCommonSlideViewProperties as bD, type PptxCropShape as bE, type PptxCustomPathProperties as bF, type PptxElementBase as bG, type PptxElementType as bH, type PptxExportFormat as bI, type PptxGraphicFrameExtension as bJ, type PptxHeaderFooterFlags as bK, type PptxImageProperties as bL, type PptxMediaType as bM, type PptxNativeAnimationKind as bN, type PptxNormalViewProperties as bO, type PptxRestoredRegion as bP, type PptxShapeProperties as bQ, type PptxSmartArtConnection as bR, type PptxSplitDirection as bS, type PptxSplitOrientation as bT, type PptxStripDirection as bU, type PptxTableCell as bV, type PptxTableRow as bW, type PptxTag as bX, type PptxTextAnimationTarget as bY, type PptxTextBuildType as bZ, type PptxTextProperties as b_, type EffectDagContainerType as ba, type EffectDagNode as bb, type EffectDagRawLeaf as bc, type EffectDagRelOff as bd, type EffectDagXfrm as be, type ElementActionType as bf, type MasterViewTab as bg, type MaterialPresetType as bh, type MediaCaptionTrack as bi, type MediaMetadata as bj, type Model3DPptxElement as bk, type ParsedTableStyleEntry as bl, type PicturePptxElement as bm, type Pptx3DScene as bn, type Pptx3DShape as bo, type PptxAfterAnimationAction as bp, type PptxAnimationDirection as bq, type PptxAnimationIterate as br, type PptxAnimationKeyframe as bs, type PptxAnimationRepeatMode as bt, type PptxAnimationSequence as bu, type PptxAnimationTimingCurve as bv, type PptxChartAxisNumFmt as bw, type PptxChartErrBarDir as bx, type PptxChartErrBarType as by, type PptxChartErrValType as bz, type PptxImageLikeElement as c, type PptxThemeFontGroup as c0, type PptxTransitionDirection4 as c1, type PptxTransitionDirection8 as c2, type PptxViewOrigin as c3, type PptxViewScale as c4, type ShadowEffect as c5, type SmartArtColorScheme as c6, type SmartArtLayout as c7, type SmartArtStyle as c8, THEME_COLOR_SCHEME_KEYS as c9, TRANSITION_VALID_DIRECTIONS as ca, type Text3DStyle as cb, type UnderlineStyle as cc, type UnknownPptxElement as cd, type PptxThemeColorScheme as d, type PptxThemeFontScheme as e, type PptxAnimationPreset as f, type PptxAnimationTrigger as g, type StrokeDashType as h, type ConnectorArrowType as i, type PptxTransitionType as j, type PptxChartType as k, type PptxSlide as l, type PptxData as m, type PptxCompatibilityWarning as n, type PptxLayoutOption as o, type PptxChartData as p, type PptxSmartArtData as q, type PptxHeaderFooter as r, type PptxPresentationProperties as s, type PptxCustomShow as t, type PptxSection as u, type PptxCoreProperties as v, type PptxAppProperties as w, type PptxCustomProperty as x, type PptxNotesMaster as y, type PptxHandoutMaster as z };