pptx-viewer-core 1.4.0 → 1.6.0

package/dist/{presentation-BfnrtJV1.d.ts → presentation-BLbjWKxK.d.ts}

@@ -435,6 +435,8 @@ interface CustomGeometryPath {
  * and the text rectangle are not lost when a custGeom is edited and saved.
  */
 interface CustomGeometryRawData {
+    /** Raw `a:avLst` XML content (adjustment value list). */
+    avLstXml?: unknown;
     /** Raw `a:gdLst` XML content (guide list). */
     gdLstXml?: unknown;
     /** Raw `a:ahLst` XML content (adjustment handles). */
@@ -575,7 +577,7 @@ interface PptxCustomPathProperties {
     pathHeight?: number;
     /** Structured custom geometry paths for editing (maps to a:custGeom/a:pathLst). */
     customGeometryPaths?: CustomGeometryPath[];
-    /** Raw a:gdLst/a:ahLst/a:cxnLst/a:rect XML preserved for round-trip serialization. */
+    /** Raw adjustment/guide/handle/connection/text-rectangle XML preserved for serialization. */
     customGeometryRawData?: CustomGeometryRawData;
     /**
      * Typed XY adjustment handles parsed from `a:custGeom/a:ahLst/a:ahXY`.
@@ -675,6 +677,10 @@ interface Text3DStyle {
 interface Pptx3DScene {
     /** Camera preset type, e.g. "orthographicFront", "perspectiveFront". */
     cameraPreset?: string;
+    /** Camera field of view in 1/60000 degrees (`a:camera/@fov`). */
+    cameraFieldOfView?: number;
+    /** Camera zoom as an OOXML percentage fraction (`a:camera/@zoom`, 1 = 100%). */
+    cameraZoom?: number;
     /** Camera rotation around X axis in 1/60000 degrees. */
     cameraRotX?: number;
     /** Camera rotation around Y axis in 1/60000 degrees. */
@@ -685,6 +691,12 @@ interface Pptx3DScene {
     lightRigType?: string;
     /** Light rig direction, e.g. "t", "b", "l", "r", "tl". */
     lightRigDirection?: string;
+    /** Light-rig rotation latitude in 1/60000 degrees. */
+    lightRigRotX?: number;
+    /** Light-rig rotation longitude in 1/60000 degrees. */
+    lightRigRotY?: number;
+    /** Light-rig rotation revolution in 1/60000 degrees. */
+    lightRigRotZ?: number;
     /** Whether a 3D backdrop plane is present (`a:backdrop`). */
     hasBackdrop?: boolean;
     /** Backdrop plane anchor X in EMU. */
@@ -693,6 +705,18 @@ interface Pptx3DScene {
     backdropAnchorY?: number;
     /** Backdrop plane anchor Z in EMU. */
     backdropAnchorZ?: number;
+    /** Backdrop normal vector X component. */
+    backdropNormalX?: number;
+    /** Backdrop normal vector Y component. */
+    backdropNormalY?: number;
+    /** Backdrop normal vector Z component. */
+    backdropNormalZ?: number;
+    /** Backdrop up vector X component. */
+    backdropUpX?: number;
+    /** Backdrop up vector Y component. */
+    backdropUpY?: number;
+    /** Backdrop up vector Z component. */
+    backdropUpZ?: number;
 }
 /**
  * 3D shape extrusion/bevel from `a:sp3d`.
@@ -764,6 +788,12 @@ type PptxTextWarpPreset = 'textNoShape' | 'textPlain' | 'textStop' | 'textTriang
  * @module pptx-types/shape-style
  */
 
+interface PptxCustomDashSegment {
+    /** Dash length as a non-negative percentage in thousandths of one percent. */
+    dash: number;
+    /** Space length as a non-negative percentage in thousandths of one percent. */
+    space: number;
+}
 /**
  * Comprehensive visual style for a shape, connector, or image element.
  *
@@ -812,9 +842,13 @@ interface ShapeStyle {
      */
     fillColorXml?: XmlObject;
     fillGradient?: string;
+    /** Original `gradFill` XML retained for unknown-child and extension round-tripping. */
+    fillGradientXml?: XmlObject;
     fillMode?: 'solid' | 'gradient' | 'pattern' | 'none' | 'image' | 'theme' | 'group';
     fillPatternPreset?: string;
     fillPatternBackgroundColor?: string;
+    /** Original `pattFill` XML retained for unknown-child round-tripping. */
+    fillPatternXml?: XmlObject;
     /** Raw XML node for pattern fill foreground colour (preserves color transforms). */
     fillPatternFgClrXml?: XmlObject;
     /** Raw XML node for pattern fill background colour (preserves color transforms). */
@@ -880,6 +914,14 @@ interface ShapeStyle {
     /** Pen line alignment (`a:ln/@algn`): `ctr` (centre, default) or `in` (inside). */
     lineAlignment?: 'ctr' | 'in';
     shadowColor?: string;
+    /** Preserved source `a:effectLst`, including unknown effects and extensions. */
+    effectListXml?: XmlObject;
+    /** Original outer-shadow node used for lossless surgical updates. */
+    outerShadowXml?: XmlObject;
+    /** Resolved source shadow colour used to detect colour edits. */
+    outerShadowOriginalColor?: string;
+    /** Source shadow opacity used to detect alpha edits. */
+    outerShadowOriginalOpacity?: number;
     shadowBlur?: number;
     shadowOffsetX?: number;
     shadowOffsetY?: number;
@@ -923,11 +965,23 @@ interface ShapeStyle {
     /** Multiple shadow layers (for advanced effects). */
     shadows?: ShadowEffect[];
     glowColor?: string;
+    /** Original glow node used for lossless surgical updates. */
+    glowXml?: XmlObject;
+    /** Resolved source glow colour used to detect colour edits. */
+    glowOriginalColor?: string;
+    /** Source glow opacity used to detect alpha edits. */
+    glowOriginalOpacity?: number;
     glowRadius?: number;
     glowOpacity?: number;
     softEdgeRadius?: number;
     /** Inner shadow colour (`a:innerShdw`). */
     innerShadowColor?: string;
+    /** Original inner-shadow node used for lossless surgical updates. */
+    innerShadowXml?: XmlObject;
+    /** Resolved source inner-shadow colour used to detect colour edits. */
+    innerShadowOriginalColor?: string;
+    /** Source inner-shadow opacity used to detect alpha edits. */
+    innerShadowOriginalOpacity?: number;
     /** Inner shadow opacity (0-1). */
     innerShadowOpacity?: number;
     /** Inner shadow blur radius in px. */
@@ -936,8 +990,12 @@ interface ShapeStyle {
     innerShadowOffsetX?: number;
     /** Inner shadow vertical offset in px. */
     innerShadowOffsetY?: number;
+    /** Original soft-edge node, including vendor attributes and extensions. */
+    softEdgeXml?: XmlObject;
     /** Reflection effect — distance from shape bottom in px. */
     reflectionBlurRadius?: number;
+    /** Original reflection node, including vendor attributes and extensions. */
+    reflectionXml?: XmlObject;
     /** Reflection start opacity (0-1). */
     reflectionStartOpacity?: number;
     /** Reflection end opacity (0-1). */
@@ -968,11 +1026,12 @@ interface ShapeStyle {
     connectorStartConnection?: ConnectorConnectionPoint;
     /** Connection point for the end of a connector. */
     connectorEndConnection?: ConnectorConnectionPoint;
-    /** Custom dash segments array (`a:custDash/a:ds`). Each entry has dash length and space length in EMU. */
-    customDashSegments?: Array<{
-        dash: number;
-        space: number;
-    }>;
+    /** Custom dash pattern, measured relative to line width in thousandths of one percent. */
+    customDashSegments?: PptxCustomDashSegment[];
+    /** Original `a:ds` payloads retained by index for lossless edits. */
+    customDashSegmentXml?: XmlObject[];
+    /** Original `a:custDash` payload retained for lossless edits. */
+    customDashXml?: XmlObject;
     /** 3D scene/camera settings from `a:scene3d`. */
     scene3d?: Pptx3DScene;
     /** 3D shape extrusion/bevel from `a:sp3d`. */
@@ -1084,6 +1143,8 @@ interface ShapeStyle {
  * ```
  */
 interface TextStyle {
+    /** Original `a:rPr` XML retained by projections that share the shape-text model. */
+    runPropertiesXml?: XmlObject;
     fontFamily?: string;
     fontSize?: number;
     /** When true, renderer should shrink text to fit the shape bounds. */
@@ -1433,6 +1494,8 @@ interface TextStyle {
     text3d?: Text3DStyle;
     /** 3D scene (camera + light rig) settings on the text body (`a:bodyPr/a:scene3d`). */
     textBodyScene3d?: Pptx3DScene;
+    /** Raw `a:scene3d` subtree used to preserve extensions and unmodelled children. */
+    textBodyScene3dXml?: XmlObject;
     /**
      * Raw `<a:extLst>` subtree captured from `<a:bodyPr>`. Preserved verbatim so
      * authored extensions (e.g. content placeholders, custom application data)
@@ -1850,12 +1913,126 @@ interface PlaceholderDefaults {
     promptText?: string;
 }
 
+/** Tick-mark placement from ChartML `ST_TickMark`. */
+type PptxChartTickMark = 'cross' | 'in' | 'none' | 'out';
+/** Typed axis tick and category/date label controls. */
+interface PptxChartAxisLabelFormatting {
+    /** Primary and secondary tick-mark placement. */
+    majorTickMark?: PptxChartTickMark;
+    minorTickMark?: PptxChartTickMark;
+    /** Tick-label position from ChartML `ST_TickLblPos`. */
+    tickLblPos?: 'high' | 'low' | 'nextTo' | 'none';
+    /** Automatic category/date axis behavior (`c:auto`). */
+    auto?: boolean;
+    /** Category-axis label alignment (`c:lblAlgn`). */
+    labelAlignment?: 'ctr' | 'l' | 'r';
+    /** Category/date label distance, from 0 through 1000 percent. */
+    labelOffset?: number;
+    /** Number of category/date labels between rendered labels. */
+    tickLabelSkip?: number;
+    /** Number of category/date tick positions between major tick marks. */
+    tickMarkSkip?: number;
+    /** Suppress multi-level category labels (`c:noMultiLvlLbl`). */
+    noMultiLevelLabels?: boolean;
+}
+
+interface PptxChartPivotFormat {
+    index: number;
+    shapePropertiesXml?: XmlObject | null;
+    markerXml?: XmlObject | null;
+    dataLabelXml?: XmlObject | null;
+    extensionListXml?: XmlObject | null;
+    rawXml?: XmlObject;
+}
+/** Editable classic ChartML `c:pivotFmts` collection. */
+interface PptxChartPivotFormats {
+    formats: PptxChartPivotFormat[];
+    rawXml?: XmlObject;
+}
+
+/** Editable classic ChartML `c:pivotSource` metadata. */
+interface PptxChartPivotSource {
+    /** Pivot table reference stored as `c:name` text. */
+    name: string;
+    /** Required unsigned format identifier stored in `c:fmtId/@val`. */
+    formatId: number;
+    /** Internal source subtree used to preserve extensions and foreign markup. */
+    rawXml?: XmlObject;
+}
+
+/** Headers and footers used when a classic ChartML chart is printed. */
+interface PptxChartPrintHeaderFooter {
+    oddHeader?: string;
+    oddFooter?: string;
+    evenHeader?: string;
+    evenFooter?: string;
+    firstHeader?: string;
+    firstFooter?: string;
+    alignWithMargins?: boolean;
+    differentOddEven?: boolean;
+    differentFirst?: boolean;
+    /** Original subtree retained for foreign attributes and extension children. */
+    rawXml?: unknown;
+}
+/** Required page margins from ChartML `c:pageMargins`, measured in inches. */
+interface PptxChartPageMargins {
+    left: number;
+    right: number;
+    top: number;
+    bottom: number;
+    header: number;
+    footer: number;
+    /** Original leaf retained for foreign attributes. */
+    rawXml?: unknown;
+}
+/** Printer page configuration from ChartML `c:pageSetup`. */
+interface PptxChartPageSetup {
+    paperSize?: number;
+    firstPageNumber?: number;
+    orientation?: 'default' | 'portrait' | 'landscape';
+    blackAndWhite?: boolean;
+    draft?: boolean;
+    useFirstPageNumber?: boolean;
+    horizontalDpi?: number;
+    verticalDpi?: number;
+    copies?: number;
+    /** Original leaf retained for foreign attributes. */
+    rawXml?: unknown;
+}
+/** Editable `c:printSettings` content from a classic ChartML chart space. */
+interface PptxChartPrintSettings {
+    headerFooter?: PptxChartPrintHeaderFooter | null;
+    pageMargins?: PptxChartPageMargins | null;
+    pageSetup?: PptxChartPageSetup | null;
+    /** `null` removes the legacy header/footer drawing relationship element. */
+    legacyDrawingHeaderFooterRelationshipId?: string | null;
+    /** Original subtree retained for unknown and extension content. */
+    rawXml?: unknown;
+}
+
+/** Editable classic ChartML `c:protection` settings. */
+interface PptxChartProtection {
+    /** Prevent editing the chart object. */
+    chartObject?: boolean | null;
+    /** Prevent editing the chart data. */
+    data?: boolean | null;
+    /** Prevent editing chart formatting. */
+    formatting?: boolean | null;
+    /** Prevent selecting chart elements. */
+    selection?: boolean | null;
+    /** Prevent chart user-interface operations. */
+    userInterface?: boolean | null;
+    /** Internal source subtree used to preserve foreign markup during edits. */
+    rawXml?: XmlObject;
+}
+
 /**
  * Chart types: chart categories, series data, style metadata, data tables,
  * trendlines, error bars, and the composite `PptxChartData`.
  *
  * @module pptx-types/chart
  */
+
 /**
  * Supported chart type discriminators.
  *
@@ -1892,6 +2069,7 @@ type PptxChartTrendlineType = 'linear' | 'exponential' | 'logarithmic' | 'polyno
  */
 interface PptxChartTrendline {
     trendlineType: PptxChartTrendlineType;
+    name?: string;
     order?: number;
     period?: number;
     forward?: number;
@@ -1900,6 +2078,13 @@ interface PptxChartTrendline {
     displayRSq?: boolean;
     displayEq?: boolean;
     color?: string;
+    label?: PptxChartTrendlineLabel | null;
+}
+/** Typed, commonly edited properties of `c:trendlineLbl`. */
+interface PptxChartTrendlineLabel {
+    layout?: PptxChartManualLayout;
+    numberFormatCode?: string;
+    sourceLinked?: boolean;
 }
 /** Error-bar direction axis. */
 type PptxChartErrBarDir = 'x' | 'y';
@@ -1936,6 +2121,8 @@ interface PptxChartErrBars {
     val?: number;
     customPlus?: number[];
     customMinus?: number[];
+    noEndCap?: boolean;
+    color?: string;
 }
 /**
  * Visibility flags for the chart data table (axes + legend keys).
@@ -1985,9 +2172,17 @@ interface PptxChartShapeProps {
     /** Line dash style (a:prstDash/@val), e.g. 'solid', 'dash', 'dot', 'lgDash'. */
     strokeDashStyle?: string;
 }
+/** Up/down bar formatting on line and stock charts (`c:upDownBars`). */
+interface PptxChartUpDownBars {
+    /** Gap between bars as a percentage, constrained to 0 through 500. */
+    gapWidth?: number;
+    upBars?: PptxChartShapeProps;
+    downBars?: PptxChartShapeProps;
+}
 /** Marker appearance on a chart series or data point. */
 interface PptxChartMarker {
     symbol: PptxChartMarkerSymbol;
+    /** Marker size in points, constrained by ST_MarkerSize to 2 through 72. */
     size?: number;
     spPr?: PptxChartShapeProps;
 }
@@ -1998,26 +2193,43 @@ interface PptxChartDataPoint {
     explosion?: number;
     invertIfNegative?: boolean;
     marker?: PptxChartMarker;
+    /** Render a bubble-chart point with a 3-D appearance. */
+    bubble3D?: boolean;
 }
+/** Schema values accepted by `c:dLblPos`. */
+type PptxChartDataLabelPosition = 'bestFit' | 'b' | 'ctr' | 'inBase' | 'inEnd' | 'l' | 'outEnd' | 'r' | 't';
 /** Individual data label override (c:dLbl). */
 interface PptxChartDataLabel {
     idx: number;
+    /** Suppress this data point's automatically generated label. */
+    deleted?: boolean;
     showVal?: boolean;
     showCatName?: boolean;
     showSerName?: boolean;
     showPercent?: boolean;
     showLegendKey?: boolean;
     showBubbleSize?: boolean;
-    position?: string;
+    position?: PptxChartDataLabelPosition;
     text?: string;
+    separator?: string;
+    showLeaderLines?: boolean;
 }
 /** Axis number format. */
 interface PptxChartAxisNumFmt {
     formatCode: string;
     sourceLinked?: boolean;
 }
+/** Typed contents of a value-axis display-unit label (`c:dispUnitsLbl`). */
+interface PptxChartDisplayUnitsLabel {
+    /** Literal label text. Omit to preserve the source text subtree. */
+    text?: string;
+    /** Manual label placement. `null` removes only the manual layout. */
+    layout?: PptxChartManualLayout | null;
+    /** Label shape formatting. `null` removes `c:spPr`. */
+    spPr?: PptxChartShapeProps | null;
+}
 /** Axis formatting for category, value, or date axes. */
-interface PptxChartAxisFormatting {
+interface PptxChartAxisFormatting extends PptxChartAxisLabelFormatting {
     axisType: 'catAx' | 'valAx' | 'dateAx' | 'serAx';
     /** Axis position: "b" (bottom), "l" (left), "r" (right), "t" (top). */
     axPos?: 'b' | 'l' | 'r' | 't';
@@ -2025,6 +2237,12 @@ interface PptxChartAxisFormatting {
     axisId?: number;
     /** Cross-axis identifier — the axis this axis crosses. */
     crossAxisId?: number;
+    /** Automatic crossing mode (`c:crosses`). Mutually exclusive with `crossesAt`. */
+    crosses?: 'autoZero' | 'min' | 'max';
+    /** Explicit crossing value (`c:crossesAt`). Units depend on the axis type. */
+    crossesAt?: number;
+    /** Whether a value axis crosses between or at category tick marks. */
+    crossBetween?: 'between' | 'midCat';
     numFmt?: PptxChartAxisNumFmt;
     titleText?: string;
     spPr?: PptxChartShapeProps;
@@ -2042,6 +2260,8 @@ interface PptxChartAxisFormatting {
     min?: number;
     /** Maximum axis value override (c:max/@val). */
     max?: number;
+    /** Axis value direction (`c:scaling/c:orientation/@val`). */
+    orientation?: 'minMax' | 'maxMin';
     /** Whether the axis is deleted/hidden (c:delete/@val). */
     deleted?: boolean;
     /**
@@ -2051,8 +2271,12 @@ interface PptxChartAxisFormatting {
     displayUnits?: 'hundreds' | 'thousands' | 'tenThousands' | 'hundredThousands' | 'millions' | 'tenMillions' | 'hundredMillions' | 'billions' | 'trillions' | 'custom';
     /** Custom display unit divisor value (c:dispUnits/c:custUnit/@val). Only used when displayUnits is 'custom'. */
     displayUnitsValue?: number;
-    /** Display units label text (c:dispUnits/c:dispUnitsLbl). Overrides the built-in default label when present. */
-    displayUnitsLabel?: string;
+    /**
+     * Display-unit label contents (`c:dispUnits/c:dispUnitsLbl`). A string is
+     * retained as a compatibility shorthand for `{ text: string }`; `null`
+     * explicitly removes the label.
+     */
+    displayUnitsLabel?: string | PptxChartDisplayUnitsLabel | null;
     /** Whether logarithmic scaling is enabled (presence of c:scaling/c:logBase). */
     logScale?: boolean;
     /** Logarithmic base value (c:scaling/c:logBase/@val), typically 10 or e. */
@@ -2061,14 +2285,69 @@ interface PptxChartAxisFormatting {
     majorUnit?: number;
     /** Minor-unit interval between secondary tick marks (c:minorUnit/@val). */
     minorUnit?: number;
-    /** Tick-label position (c:tickLblPos/@val): 'high', 'low', 'nextTo', or 'none'. */
-    tickLblPos?: 'high' | 'low' | 'nextTo' | 'none';
+    /** Calendar unit used to interpret date-axis serial values. */
+    baseTimeUnit?: 'days' | 'months' | 'years';
+    majorTimeUnit?: 'days' | 'months' | 'years';
+    minorTimeUnit?: 'days' | 'months' | 'years';
 }
 /** 3D wall or floor element formatting. */
 interface PptxChart3DSurface {
     thickness?: number;
     spPr?: PptxChartShapeProps;
 }
+/** Office 2016 ChartEx box-and-whisker series layout options. */
+interface PptxChartBoxWhiskerOptions {
+    quartileMethod?: 'inclusive' | 'exclusive';
+    showMeanLine?: boolean;
+    showMeanMarker?: boolean;
+    /** Show non-outlier (inner) data points. */
+    showInnerPoints?: boolean;
+    showOutlierPoints?: boolean;
+}
+/** Office 2016 ChartEx histogram and Pareto series layout options. */
+interface PptxChartHistogramOptions {
+    /** Maps to `clusteredColumn` for histogram columns or `paretoLine`. */
+    layout?: 'histogram' | 'pareto';
+    /** Exactly one of binSize and binCount is emitted by the ChartEx writer. */
+    binSize?: number;
+    binCount?: number;
+    intervalClosed?: 'l' | 'r';
+    underflow?: number | 'auto';
+    overflow?: number | 'auto';
+}
+/** Office 2016 ChartEx waterfall series layout options. */
+interface PptxChartWaterfallOptions {
+    /** Zero-based data point indexes rendered as absolute subtotal or total bars. */
+    subtotalIndices?: number[];
+    /** Whether connector lines are visible between adjacent bars. */
+    connectorLines?: boolean;
+}
+/** Office 2016 ChartEx geographic series dimensions and layout options. */
+interface PptxChartRegionMapOptions {
+    /** Optional provider entity identifiers aligned with categories and values. */
+    entityIds?: string[];
+    /** Original `cx:pt/@idx` values for category points. */
+    categorySourceIndices?: number[];
+    /** Original `cx:pt/@idx` values for colour-value points. */
+    valueSourceIndices?: number[];
+    /** Original `cx:pt/@idx` values for entity-ID points. */
+    entityIdSourceIndices?: number[];
+    regionLabelLayout?: 'none' | 'bestFitOnly' | 'showAll';
+    projectionType?: 'mercator' | 'miller' | 'robinson' | 'albers';
+    viewedRegionType?: 'dataOnly' | 'postalCode' | 'county' | 'state' | 'countryRegion' | 'countryRegionList' | 'world';
+    cultureLanguage?: string;
+    /** ISO-3166-1 alpha-2 region code. */
+    cultureRegion?: string;
+    attribution?: string;
+    /** Opaque authored provider cache under `cx:geography/cx:geoCache`. */
+    geographyCache?: XmlObject;
+}
+/** Layout for parent category labels in a hierarchical ChartEx treemap. */
+type PptxChartParentLabelLayout = 'none' | 'banner' | 'overlapping';
+/** Per-series layout options for an Office 2016+ ChartEx treemap. */
+interface PptxChartTreemapOptions {
+    parentLabelLayout?: PptxChartParentLabelLayout;
+}
 /**
  * A single data series within a chart.
  *
@@ -2104,6 +2383,11 @@ interface PptxChartSeries {
      * series.
      */
     seriesChartType?: PptxChartType;
+    boxWhiskerOptions?: PptxChartBoxWhiskerOptions;
+    histogramOptions?: PptxChartHistogramOptions;
+    waterfallOptions?: PptxChartWaterfallOptions;
+    regionMapOptions?: PptxChartRegionMapOptions;
+    treemapOptions?: PptxChartTreemapOptions;
 }
 /**
  * Chart-level data-label options (`c:dLbls` directly under a chart-type
@@ -2121,12 +2405,32 @@ interface PptxChartDataLabelOptions {
     showPercent?: boolean;
     /** Show the legend key swatch (`c:showLegendKey`). */
     showLegendKey?: boolean;
+    /** Show bubble size (`c:showBubbleSize`). */
+    showBubbleSize?: boolean;
+    /** Text placed between combined label components (`c:separator`). */
+    separator?: string;
+    /** Show leader lines where supported (`c:showLeaderLines`). */
+    showLeaderLines?: boolean;
     /**
      * Label position (`c:dLblPos`). Valid values depend on the chart type
      * (`ctr`, `inEnd`, `inBase`, `outEnd`, `bestFit`, `l`, `r`, `t`, `b`).
      * Omit to let PowerPoint use the type default.
      */
-    position?: 'ctr' | 'inEnd' | 'inBase' | 'outEnd' | 'bestFit' | 'l' | 'r' | 't' | 'b';
+    position?: PptxChartDataLabelPosition;
+}
+/** Typed text defaults for a single chart legend entry. */
+interface PptxChartLegendTextStyle {
+    fontFamily?: string;
+    fontSize?: number;
+    bold?: boolean;
+    italic?: boolean;
+    color?: string;
+}
+/** Per-series legend entry override (`c:legendEntry`). */
+interface PptxChartLegendEntry {
+    index: number;
+    deleted?: boolean;
+    textStyle?: PptxChartLegendTextStyle;
 }
 /**
  * Style / formatting metadata for a chart.
@@ -2149,6 +2453,8 @@ interface PptxChartStyle {
     hasLegend?: boolean;
     /** Legend position (t, b, l, r, tr). */
     legendPosition?: string;
+    /** Per-series visibility and text-style overrides. */
+    legendEntries?: PptxChartLegendEntry[];
     /** Whether the chart has a title. */
     hasTitle?: boolean;
     /** Whether gridlines are visible. */
@@ -2209,6 +2515,14 @@ interface PptxChartOfPieOptions {
     serLines?: boolean;
     gapWidth?: number;
 }
+/** Classic `c:bubbleChart` options from CT_BubbleChart. */
+interface PptxBubbleChartOptions {
+    bubble3D?: boolean;
+    /** Bubble diameter scale in percent, constrained to 0 through 300. */
+    bubbleScale?: number;
+    showNegativeBubbles?: boolean;
+    sizeRepresents?: 'area' | 'w';
+}
 /**
  * 3D viewing parameters for a chart (`c:view3D`, ECMA-376 §21.2.2.228 /
  * CT_View3D).
@@ -2249,6 +2563,27 @@ interface PptxChartChrome {
     dispBlanksAs?: 'gap' | 'zero' | 'span';
     showDLblsOverMax?: boolean;
 }
+/** Manual chart placement from `c:layout/c:manualLayout` (CT_ManualLayout). */
+interface PptxChartManualLayout {
+    layoutTarget?: 'inner' | 'outer';
+    xMode?: 'edge' | 'factor';
+    yMode?: 'edge' | 'factor';
+    widthMode?: 'edge' | 'factor';
+    heightMode?: 'edge' | 'factor';
+    x?: number;
+    y?: number;
+    width?: number;
+    height?: number;
+}
+/**
+ * Typed manual layouts for chart regions that accept `c:layout`.
+ * A `null` region removes its manual layout without removing extensions.
+ */
+interface PptxChartLayouts {
+    title?: PptxChartManualLayout | null;
+    plotArea?: PptxChartManualLayout | null;
+    legend?: PptxChartManualLayout | null;
+}
 /** Parsed data extracted from an embedded xlsx workbook. */
 interface PptxEmbeddedWorkbookData {
     /** Category labels from the first column/row. */
@@ -2258,6 +2593,16 @@ interface PptxEmbeddedWorkbookData {
         name: string;
         values: number[];
     }>;
+    /** Whether the workbook uses the 1904 date system. */
+    date1904?: boolean;
+}
+/** Raw numeric category cache used by a classic ChartML date axis. */
+interface PptxChartDateCategories {
+    values: number[];
+    /** False/default uses Excel's 1900 date system; true uses the 1904 system. */
+    date1904?: boolean;
+    /** Number format copied from the numeric category cache. */
+    formatCode?: string;
 }
 /**
  * Complete parsed chart data for a {@link ChartPptxElement}.
@@ -2281,6 +2626,13 @@ interface PptxChartData {
     title?: string;
     chartType: PptxChartType;
     categories: string[];
+    /**
+     * Hierarchical category levels in source XML order for ChartEx hierarchy charts.
+     * Level 0 contains the leaf labels and remains mirrored by {@link categories}
+     * for consumers that only understand a flat category axis.
+     */
+    categoryLevels?: string[][];
+    dateCategories?: PptxChartDateCategories;
     series: PptxChartSeries[];
     /** Chart style/formatting metadata. */
     style?: PptxChartStyle;
@@ -2290,9 +2642,12 @@ interface PptxChartData {
     chartPartPath?: string;
     /** Internal: relationship ID linking the graphic frame to the chart part. */
     chartRelationshipId?: string;
-    dataTable?: PptxChartDataTable;
+    /** `null` explicitly removes an existing ChartML data table. */
+    dataTable?: PptxChartDataTable | null;
     dropLines?: PptxChartLineStyle;
     hiLowLines?: PptxChartLineStyle;
+    /** `null` explicitly removes an existing up/down-bars container. */
+    upDownBars?: PptxChartUpDownBars | null;
     axes?: PptxChartAxisFormatting[];
     floor?: PptxChart3DSurface;
     sideWall?: PptxChart3DSurface;
@@ -2314,12 +2669,7 @@ interface PptxChartData {
      * The chart still renders using its cached series data; this field
      * is metadata about the data origin, preserved for round-trip fidelity.
      */
-    pivotSource?: {
-        /** Pivot table reference name, e.g. "[workbook.xlsx]Sheet1!PivotTable1". */
-        name: string;
-        /** Format identifier from c:fmtId/@val. */
-        formatId?: number;
-    };
+    pivotSource?: PptxChartPivotSource | null;
     /**
      * Whether only visible cells are plotted (c:plotVisOnly).
      * When `true` (the default), hidden cells are excluded from the chart.
@@ -2342,6 +2692,12 @@ interface PptxChartData {
      * - `"acrossLinear"` — gradient across series
      */
     colorMethod?: 'cycle' | 'withinLinear' | 'acrossLinear';
+    /** Internal source color-style part path used for lossless dirty saves. */
+    colorStylePartPath?: string;
+    /** Internal parsed palette snapshot used to detect actual edits. */
+    colorStyleOriginalPalette?: string[];
+    /** Internal parsed method snapshot used to detect actual edits. */
+    colorStyleOriginalMethod?: 'cycle' | 'withinLinear' | 'acrossLinear';
     /**
      * Pie-of-pie / Bar-of-pie options (`c:ofPieChart`, CT_OfPieChart).
      *
@@ -2350,6 +2706,8 @@ interface PptxChartData {
      * `ofPieChart` element can be re-emitted on save with full fidelity.
      */
     ofPieOptions?: PptxChartOfPieOptions;
+    /** Classic bubble-chart display options (`c:bubbleChart`). */
+    bubbleOptions?: PptxBubbleChartOptions;
     /**
      * 3D viewing parameters (`c:view3D`, CT_View3D).
      *
@@ -2365,6 +2723,12 @@ interface PptxChartData {
      * source data, so absence does not produce empty `<c:…/>` placeholders.
      */
     chartChrome?: PptxChartChrome;
+    /** `c:chartSpace/c:printSettings`; `null` removes the container on save. */
+    printSettings?: PptxChartPrintSettings | null;
+    /** `c:chartSpace/c:protection`; `null` removes the container on save. */
+    protection?: PptxChartProtection | null;
+    /** Editable manual placement for the title, plot area, and legend. */
+    layouts?: PptxChartLayouts;
     /**
      * Raw `c:userShapes` XML subtree (a drawing tree) preserved verbatim.
      *
@@ -2381,7 +2745,8 @@ interface PptxChartData {
      * for charts whose data originates from a PivotTable. Preserved
      * verbatim for round-trip fidelity.
      */
-    pivotFmtsXml?: unknown;
+    /** Typed pivot-chart format persistence; `null` removes `c:pivotFmts`. */
+    pivotFormats?: PptxChartPivotFormats | null;
     /**
      * Color-map override (`c:clrMapOvr`) carrying 12 attributes that
      * remap theme colour roles for this chart only. Preserved as a flat
@@ -2390,107 +2755,61 @@ interface PptxChartData {
     clrMapOvr?: Record<string, string>;
 }
 
-/**
- * Image types: effects, crop shapes, and properties shared by image/picture
- * elements.
- *
- * @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`. */
+type EffectDagNode = EffectDagContainer | EffectDagBlend | EffectDagXfrm | EffectDagRelOff | EffectDagBlur | EffectDagAlphaOutset | EffectDagPresetShadow | EffectDagRawLeaf;
 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.
- */
+/** Typed CT_BlurEffect with its original payload retained for lossless edits. */
+interface EffectDagBlur {
+    kind: 'blur';
+    radiusEmu?: number;
+    grow?: boolean;
+    xml: XmlObject;
+}
+/** Typed CT_AlphaOutsetEffect with original XML retained for lossless edits. */
+interface EffectDagAlphaOutset {
+    kind: 'alphaOutset';
+    radiusEmu?: number;
+    xml: XmlObject;
+}
+/** Typed CT_PresetShadowEffect with colour and extension XML retained verbatim. */
+interface EffectDagPresetShadow {
+    kind: 'prstShdw';
+    preset?: `shdw${number}`;
+    distanceEmu?: number;
+    direction?: number;
+    xml: XmlObject;
+}
 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.
  *
@@ -2516,6 +2835,8 @@ interface PptxImageEffects {
     duotone?: {
         color1: string;
         color2: string;
+        /** Original effect XML, retained while the resolved colours are unchanged. */
+        rawXml?: XmlObject;
     };
     /** Grayscale flag. */
     grayscale?: boolean;
@@ -2530,8 +2851,10 @@ interface PptxImageEffects {
     artisticEffect?: string;
     /** Artistic effect radius/amount. */
     artisticRadius?: number;
-    /** Alpha modulation fixed — overall opacity (0-100, where 100 = fully opaque). */
+    /** Alpha modulation fixed: non-negative percentage (100 means unchanged opacity). */
     alphaModFix?: number;
+    /** Original alpha modulation fixed node, including foreign attributes. */
+    alphaModFixRawXml?: XmlObject;
     /** Bi-level threshold — converts to 1-bit black/white (0-100). */
     biLevel?: number;
     /** Colour change — swap one colour range for another (used for transparency keying). */
@@ -2540,7 +2863,13 @@ interface PptxImageEffects {
         clrTo: string;
         /** Whether the target colour is fully transparent (alpha = 0). */
         clrToTransparent?: boolean;
+        /** Original effect XML, including colour transforms and extensions. */
+        rawXml?: XmlObject;
     };
+    /** Original grayscale node, including extension or foreign attributes. */
+    grayscaleRawXml?: XmlObject;
+    /** Original bi-level node, including extension or foreign attributes. */
+    biLevelRawXml?: XmlObject;
     /**
      * Alpha inverse effect (`a:alphaInv`). Inverts the alpha channel; an optional
      * colour child shifts the inversion baseline.
@@ -2548,11 +2877,17 @@ interface PptxImageEffects {
     alphaInv?: {
         /** Optional baseline colour (hex). */
         color?: string;
+        /** Original effect XML, including colour transforms and foreign attributes. */
+        rawXml?: XmlObject;
     };
     /** Alpha ceiling (`a:alphaCeiling`) — clamps any non-zero alpha to fully opaque. Boolean flag. */
     alphaCeiling?: boolean;
+    /** Original alpha ceiling node, including foreign attributes. */
+    alphaCeilingRawXml?: XmlObject;
     /** Alpha floor (`a:alphaFloor`) — clamps any non-fully-opaque alpha to fully transparent. Boolean flag. */
     alphaFloor?: boolean;
+    /** Original alpha floor node, including foreign attributes. */
+    alphaFloorRawXml?: XmlObject;
     /**
      * Alpha modulate (`a:alphaMod`). The schema requires a single `cont` (effect
      * container) child; we preserve the inner XML opaquely for round-trip.
@@ -2560,11 +2895,17 @@ interface PptxImageEffects {
     alphaMod?: {
         /** Raw opaque XML for the `a:cont` child to preserve on save. */
         contRawXml?: Record<string, unknown>;
+        /** Original effect XML, including foreign attributes. */
+        rawXml?: XmlObject;
     };
     /** Alpha replace (`a:alphaRepl`) — replaces alpha with the given fixed-percent value (0..100). */
     alphaRepl?: number;
+    /** Original alpha replace node, including foreign attributes. */
+    alphaReplRawXml?: XmlObject;
     /** Alpha bi-level (`a:alphaBiLevel`) — threshold (0..100) above which alpha becomes fully opaque. */
     alphaBiLevel?: number;
+    /** Original alpha bi-level node, including foreign attributes. */
+    alphaBiLevelRawXml?: XmlObject;
     /**
      * Colour replace (`a:clrRepl`) — replaces all colour information in an image
      * with the given solid colour. Stores the raw colour child to preserve scheme
@@ -2707,6 +3048,7 @@ declare module './shape-style' {
  *
  * @module pptx-types/media
  */
+
 /**
  * Discriminator for embedded media element types.
  *
@@ -2717,6 +3059,13 @@ declare module './shape-style' {
  * ```
  */
 type PptxMediaType = 'video' | 'audio' | 'unknown';
+type PptxMediaReferenceKind = 'audioCd' | 'wavAudioFile' | 'audioFile' | 'videoFile' | 'quickTimeFile';
+interface PptxAudioCdPosition {
+    track: number;
+    time?: number;
+    /** Original `st` or `end` node, retained for lossless edits. */
+    rawXml?: XmlObject;
+}
 /**
  * A named bookmark within a media clip timeline.
  *
@@ -2793,6 +3142,112 @@ interface MediaCaptionTrack {
     isDefault?: boolean;
 }
 
+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;
+}
+/** Editable DiagramML CT_Constraint. */
+interface PptxSmartArtConstraint extends PptxSmartArtConstraintTarget {
+    type: string;
+    referenceType?: string;
+    referenceFor?: PptxSmartArtConstraintRelationship;
+    referenceForName?: string;
+    referencePointType?: PptxSmartArtConstraintPointType;
+    operator?: PptxSmartArtConstraintOperator;
+    value?: number;
+    factor?: number;
+    /** Original constraint retained for foreign attributes and extension content. */
+    rawXml?: XmlObject;
+}
+/** Editable DiagramML CT_NumericRule. */
+interface PptxSmartArtNumericRule extends PptxSmartArtConstraintTarget {
+    type: string;
+    value?: number;
+    factor?: number;
+    max?: number;
+    /** Original rule retained for foreign attributes and extension content. */
+    rawXml?: XmlObject;
+}
+
+/** Typed, editable metadata from a DiagramML layout-definition part. */
+
+interface PptxSmartArtLocalizedText {
+    value: string;
+    language?: string;
+}
+interface PptxSmartArtLayoutCategory {
+    type: string;
+    priority: number;
+}
+interface PptxSmartArtAlgorithmParameter {
+    type: string;
+    value?: string;
+}
+/** Typed DiagramML CT_Algorithm data attached to a layout node. */
+interface PptxSmartArtLayoutAlgorithm {
+    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 {
+    function: string;
+    argument?: string;
+    operator: string;
+    value: string;
+    rawXml?: XmlObject;
+}
+interface PptxSmartArtChoose {
+    name?: string;
+    when: PptxSmartArtWhen[];
+    otherwise?: {
+        name?: string;
+        rawXml?: XmlObject;
+    } | null;
+    rawXml?: XmlObject;
+}
+/** 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[];
+    children?: PptxSmartArtLayoutNode[];
+}
+/** Metadata and root node from DiagramML CT_DiagramDefinition. */
+interface PptxSmartArtLayoutDefinition {
+    uniqueId?: string;
+    minimumVersion?: string;
+    defaultStyle?: string;
+    titles?: PptxSmartArtLocalizedText[];
+    descriptions?: PptxSmartArtLocalizedText[];
+    categories?: PptxSmartArtLayoutCategory[];
+    rootNode: PptxSmartArtLayoutNode;
+    /** Original definition retained for constraint evaluation and foreign rules. */
+    rawXml?: XmlObject;
+}
+
 /**
  * SmartArt node types: per-run text, per-node visual override, and the
  * data-model node itself. Split out of `smart-art.ts` to keep each type file
@@ -2802,6 +3257,7 @@ interface MediaCaptionTrack {
  *
  * @module pptx-types/smart-art-node
  */
+
 /**
  * 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,
@@ -2825,6 +3281,54 @@ interface PptxSmartArtTextRun {
      * round-trip. Untyped XML, hence the loose record shape.
      */
     rPr?: Record<string, unknown>;
+    /** Resolved standard shape-text style derived from {@link rPr}. */
+    style?: TextStyle;
+    /** 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 = {
+    kind: 'run';
+    run: PptxSmartArtTextRun;
+} | {
+    kind: 'break';
+    rPr?: Record<string, unknown>;
+    style?: TextStyle;
+    rawXml?: Record<string, unknown>;
+    childOrder?: string[];
+} | {
+    kind: 'field';
+    id?: string;
+    fieldType?: string;
+    text: string;
+    rPr?: Record<string, unknown>;
+    style?: TextStyle;
+    pPr?: Record<string, unknown>;
+    rawXml?: Record<string, unknown>;
+    childOrder?: string[];
+} | {
+    kind: 'tab';
+    rawXml?: Record<string, unknown>;
+    childOrder?: string[];
+} | {
+    kind: 'raw';
+    name: string;
+    value: unknown;
+};
+/** A complete `a:p` paragraph in a SmartArt data-model text body. */
+interface PptxSmartArtTextParagraph {
+    /** Paragraph properties (`a:pPr`) preserved verbatim. */
+    pPr?: Record<string, unknown>;
+    /** Text children in source order. */
+    items: PptxSmartArtTextParagraphItem[];
+    /** End-paragraph run properties (`a:endParaRPr`) preserved verbatim. */
+    endParaRPr?: Record<string, unknown>;
+    /** Resolved style for the paragraph terminator. */
+    endParaStyle?: TextStyle;
+    /** Raw paragraph XML used to retain unmodelled extension children on save. */
+    rawXml?: Record<string, unknown>;
 }
 /**
  * Per-node visual override for a SmartArt node.
@@ -2880,6 +3384,8 @@ interface PptxSmartArtNodeStyle {
 interface PptxSmartArtNode {
     id: string;
     text: string;
+    /** CT_Pt connection identifier, when the point references a connection. */
+    connectionId?: string | null;
     parentId?: string;
     children?: PptxSmartArtNode[];
     /** Node type from `@_type` attribute (e.g. "doc", "node", "asst", "pres"). */
@@ -2892,6 +3398,11 @@ interface PptxSmartArtNode {
      * is not flattened. When {@link text} diverges, the runs are ignored.
      */
     runs?: PptxSmartArtTextRun[];
+    /**
+     * Complete typed paragraph model. Unlike {@link runs}, this retains every
+     * paragraph and the ordered run, field, break, and tab children within it.
+     */
+    paragraphs?: PptxSmartArtTextParagraph[];
     /**
      * Optional per-node visual override (fill / line / font colour, bold /
      * italic). Read at parse time from the point's `spPr` / first-run `rPr`, set
@@ -2901,6 +3412,64 @@ interface PptxSmartArtNode {
     style?: PptxSmartArtNodeStyle;
 }
 
+/** Editable metadata shared by DiagramML quick-style and color definitions. */
+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;
+}
+/** CT_StyleLabel metadata from a quick-style definition. */
+interface PptxSmartArtQuickStyleLabel {
+    name: string;
+}
+/** 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 CT_CTStyleLabel metadata. */
+    labels?: PptxSmartArtColorStyleLabel[];
+}
+/** 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[];
+}
+
 /**
  * SmartArt types: layout categories, layout presets, colour schemes,
  * data-model nodes/connections, drawing shapes, chrome, and the composite
@@ -2963,6 +3532,8 @@ type SmartArtStyle = 'flat' | 'moderate' | 'intense';
  * ```
  */
 interface PptxSmartArtConnection {
+    /** Stable CT_Cxn model identifier. Required when serialized. */
+    modelId?: string | null;
     /** Model ID of the source node. */
     sourceId: string;
     /** Model ID of the destination node. */
@@ -2973,6 +3544,12 @@ interface PptxSmartArtConnection {
     srcOrd?: number;
     /** Destination index for ordering. */
     destOrd?: number;
+    /** Model ID of the parent transition point associated with this edge. */
+    parentTransitionId?: string | null;
+    /** Model ID of the sibling transition point associated with this edge. */
+    siblingTransitionId?: string | null;
+    /** Layout presentation identifier used by presentation connections. */
+    presentationId?: string | null;
 }
 /**
  * A pre-computed shape from `ppt/diagrams/drawing*.xml`.
@@ -2989,7 +3566,7 @@ interface PptxSmartArtConnection {
  * // => satisfies PptxSmartArtDrawingShape
  * ```
  */
-interface PptxSmartArtDrawingShape {
+interface PptxSmartArtDrawingShape extends PptxCustomPathProperties {
     /** Shape ID within the drawing. */
     id: string;
     /** Preset geometry type (e.g. "roundRect", "ellipse"). */
@@ -3013,6 +3590,8 @@ interface PptxSmartArtDrawingShape {
     strokeWidth?: number;
     /** Text content of the shape. */
     text?: string;
+    /** Standard rich-text segments projected from the associated SmartArt node. */
+    textSegments?: TextSegment[];
     /** Font size in points. */
     fontSize?: number;
     /** Font colour (hex). */
@@ -3039,45 +3618,6 @@ interface PptxSmartArtChrome {
     /** Outline stroke width in points. */
     outlineWidth?: number;
 }
-/**
- * Colour transform entry from `ppt/diagrams/colors*.xml`.
- *
- * @example
- * ```ts
- * const transform: PptxSmartArtColorTransform = {
- *   name: "Colorful - Accent Colors",
- *   fillColors: ["#4F81BD", "#C0504D", "#9BBB59"],
- *   lineColors: ["#385D8A", "#8C3836", "#71893F"],
- * };
- * // => satisfies PptxSmartArtColorTransform
- * ```
- */
-interface PptxSmartArtColorTransform {
-    /** Colour scheme name / title. */
-    name?: string;
-    /** Ordered list of fill colours (hex) for each node. */
-    fillColors: string[];
-    /** Ordered list of line colours (hex). */
-    lineColors: string[];
-}
-/**
- * Style entry from `ppt/diagrams/quickStyles*.xml`.
- *
- * @example
- * ```ts
- * const qs: PptxSmartArtQuickStyle = {
- *   name: "Moderate Effect",
- *   effectIntensity: "moderate",
- * };
- * // => satisfies PptxSmartArtQuickStyle
- * ```
- */
-interface PptxSmartArtQuickStyle {
-    /** Style name / title. */
-    name?: string;
-    /** Effect intensity identifier (e.g. "subtle", "moderate", "intense"). */
-    effectIntensity?: string;
-}
 /**
  * Complete parsed SmartArt data for a {@link SmartArtPptxElement}.
  *
@@ -3117,14 +3657,28 @@ interface PptxSmartArtData {
     colorTransform?: PptxSmartArtColorTransform;
     /** Quick style from `ppt/diagrams/quickStyles*.xml`. */
     quickStyle?: PptxSmartArtQuickStyle;
+    /** Editable metadata from the related DiagramML layout definition. */
+    layoutDefinition?: PptxSmartArtLayoutDefinition;
     /** Relationship ID for the diagram data part (for round-trip save). */
     dataRelId?: string;
+    /** Relationship ID for the diagram layout part. */
+    layoutRelId?: string;
     /** Relationship ID for the drawing part. */
     drawingRelId?: string;
     /** Relationship ID for the colours part. */
     colorsRelId?: string;
     /** Relationship ID for the quick-styles part. */
     styleRelId?: string;
+    /** Internal save hint: the layout definition changed in the editor. */
+    layoutDirty?: boolean;
+    /** Internal save hint: typed layout-definition metadata changed. */
+    layoutDefinitionDirty?: boolean;
+    /** Internal save hint: quick-style definition metadata changed. */
+    quickStyleDirty?: boolean;
+    /** Internal save hint: color-transform definition metadata changed. */
+    colorTransformDirty?: boolean;
+    /** Internal save hint: cached drawing geometry or text changed in the editor. */
+    drawingDirty?: boolean;
 }
 
 /**
@@ -3733,6 +4287,13 @@ interface MediaPptxElement extends PptxElementBase {
     mediaPath?: string;
     mediaData?: string;
     mediaMimeType?: string;
+    mediaReferenceKind?: PptxMediaReferenceKind;
+    mediaReferenceName?: string;
+    /** Explicit DrawingML `audioFile/@contentType` value when present. */
+    mediaReferenceContentType?: string;
+    audioCdStart?: PptxAudioCdPosition;
+    audioCdEnd?: PptxAudioCdPosition;
+    rawMediaReferenceXml?: XmlObject;
     /** Trim start in milliseconds (from p:cMediaNode p:cTn @st). */
     trimStartMs?: number;
     /** Trim end in milliseconds (from p:cMediaNode p:cTn @end). */
@@ -3853,6 +4414,10 @@ interface ContentPartPptxElement extends PptxElementBase {
     type: 'contentPart';
     /** Ink strokes contained in this content part. */
     inkStrokes?: ContentPartInkStroke[];
+    /** Package path of the related InkML part. */
+    inkPartPath?: string;
+    /** Parsed InkML root retained for unknown-node preservation on dirty save. */
+    inkPartRawXml?: XmlObject;
 }
 /**
  * A Slide Zoom or Section Zoom element (PowerPoint Zoom Object).
@@ -3873,12 +4438,32 @@ interface ContentPartPptxElement extends PptxElementBase {
  */
 interface ZoomPptxElement extends PptxElementBase, PptxImageProperties {
     type: 'zoom';
-    /** Type of zoom: slide-level or section-level. */
-    zoomType: 'slide' | 'section';
+    /** Type of zoom: slide-level, section-level, or a multi-section summary. */
+    zoomType: 'slide' | 'section' | 'summary';
     /** Zero-based index of the target slide. */
     targetSlideIndex: number;
     /** Section ID for section zoom. */
     targetSectionId?: string;
+    /** Ordered section tiles in a Summary Zoom container. */
+    summaryTargets?: SummaryZoomTarget[];
+    /** Layout mode authored on the Summary Zoom container. */
+    summaryLayout?: 'grid' | 'fixed';
+}
+/** A single section tile within a PowerPoint Summary Zoom container. */
+interface SummaryZoomTarget extends PptxImageProperties {
+    sectionId: string;
+    targetSlideIndex: number;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    title?: string;
+    description?: string;
+    offsetFactorX?: number;
+    offsetFactorY?: number;
+    scaleFactorX?: number;
+    scaleFactorY?: number;
+    rawXml?: XmlObject;
 }
 /**
  * A 3D model object embedded via `p16:model3D` inside an
@@ -4173,6 +4758,44 @@ type PptxAnimationTrigger = 'onClick' | 'onShapeClick' | 'onHover' | 'afterPrevi
  * is preserved alongside other animations.
  */
 type PptxNativeAnimationKind = 'media';
+/** A target selected by `p:tgtEl` in the PresentationML timing model. */
+type PptxAnimationTarget = {
+    type: 'shape';
+    shapeId: string;
+    rawXml?: XmlObject;
+} | {
+    type: 'slide';
+    rawXml?: XmlObject;
+} | {
+    type: 'sound';
+    relationshipId: string;
+    name?: string;
+    rawXml?: XmlObject;
+} | {
+    type: 'ink';
+    shapeId: string;
+    rawXml?: XmlObject;
+} | {
+    type: 'unknown';
+    rawXml: XmlObject;
+};
+/** Nested build choice carried by `p:bldGraphic`. */
+type PptxGraphicBuild = {
+    mode: 'asOne';
+    rawXml?: XmlObject;
+} | {
+    mode: 'sub';
+    kind: 'diagram';
+    build: string;
+    reverse: boolean;
+    rawXml?: XmlObject;
+} | {
+    mode: 'sub';
+    kind: 'chart';
+    build: string;
+    animateBackground: boolean;
+    rawXml?: XmlObject;
+};
 /**
  * Parsed native animation record from `p:timing / p:tnLst`.
  *
@@ -4194,6 +4817,8 @@ type PptxNativeAnimationKind = 'media';
 interface PptxNativeAnimation {
     /** Target element/shape ID. */
     targetId?: string;
+    /** Full timing target, including sound and ink target variants. */
+    target?: PptxAnimationTarget;
     /** Trigger type. */
     trigger?: PptxAnimationTrigger;
     /** Shape ID that triggers this animation when clicked (interactive sequence). */
@@ -4298,6 +4923,8 @@ interface PptxNativeAnimation {
      * that aren't OLE charts).
      */
     graphicBuild?: string;
+    /** Schema-accurate `p:bldGraphic/p:bldAsOne|p:bldSub` representation. */
+    graphicBuildProperties?: PptxGraphicBuild;
     /**
      * 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
@@ -4414,6 +5041,8 @@ interface AnimationCondition {
     targetShapeId?: string;
     /** Whether the condition targets a slide (from `p:tgtEl/p:sldTgt`). */
     targetSlide?: boolean;
+    /** Full target choice, including `p:sndTgt` and `p:inkTgt`. */
+    target?: PptxAnimationTarget;
 }
 /** Iteration configuration from `p:iterate`. */
 interface PptxAnimationIterate {
@@ -4492,12 +5121,40 @@ interface PptxElementAnimation {
     stopSound?: boolean;
 }
 
+interface PptxEmbeddedFontDataId {
+    /** Required relationship identifier from `r:id`. */
+    relationshipId?: string | null;
+    /** Original leaf retained for unknown attribute preservation. */
+    rawXml?: XmlObject;
+}
+interface PptxEmbeddedFontDescriptor {
+    typeface?: string | null;
+    panose?: string | null;
+    pitchFamily?: string | null;
+    charset?: string | null;
+    rawXml?: XmlObject;
+}
+interface PptxEmbeddedFontListEntry {
+    font: PptxEmbeddedFontDescriptor;
+    regular?: PptxEmbeddedFontDataId | null;
+    bold?: PptxEmbeddedFontDataId | null;
+    italic?: PptxEmbeddedFontDataId | null;
+    boldItalic?: PptxEmbeddedFontDataId | null;
+    rawXml?: XmlObject;
+}
+interface PptxEmbeddedFontList {
+    fonts: PptxEmbeddedFontListEntry[];
+    /** Original list retained for unknown attribute and child preservation. */
+    rawXml?: XmlObject;
+}
+
 /**
  * Metadata types: slide comments, compatibility warnings, tags,
  * custom properties, core/app document properties.
  *
  * @module pptx-types/metadata
  */
+
 /**
  * A slide comment — may be a legacy positional comment or a modern
  * threaded comment with replies.
@@ -4517,6 +5174,10 @@ interface PptxElementAnimation {
 interface PptxComment {
     id: string;
     text: string;
+    /** Storage vocabulary used by this comment. Omitted means legacy PresentationML. */
+    format?: 'legacy' | 'modern';
+    /** Stable GUID author identifier used by Office 2021 modern comments. */
+    authorId?: string;
     /** Optional parent comment id for reply threading metadata. */
     parentId?: string;
     author?: string;
@@ -4525,12 +5186,35 @@ interface PptxComment {
     y?: number;
     /** Whether this comment has been resolved/marked done. */
     resolved?: boolean;
+    /** Native p188 status token. */
+    status?: 'active' | 'resolved' | 'closed';
+    /** Modern comment classification tags and author IDs that liked the comment. */
+    tags?: string[];
+    likes?: string[];
+    startDate?: string;
+    dueDate?: string;
+    assignedTo?: string[];
+    /** Task completion in thousandths of a percent, from 0 through 100000. */
+    complete?: number;
+    priority?: number;
+    title?: string;
     /** Modern threaded comment support (p15:threadingInfo). */
     threadId?: string;
     /** Replies to this comment (for modern threaded comments). */
     replies?: PptxComment[];
     /** ID of the element this comment is associated with (if any). */
     elementId?: string;
+    /** Original `p:cm` subtree, retained for unknown child and extension preservation. */
+    rawXml?: XmlObject;
+}
+/** Office 2021 comment author from the p188 Author part. */
+interface PptxModernCommentAuthor {
+    id: string;
+    name: string;
+    initials?: string;
+    userId: string;
+    providerId: string;
+    rawXml?: XmlObject;
 }
 /**
  * A comment author from `ppt/commentAuthors.xml`.
@@ -4563,6 +5247,8 @@ interface PptxCommentAuthor {
     lastIdx: number;
     /** Colour index assigned to this author (`@_clrIdx`). */
     clrIdx: number;
+    /** Original `p:cmAuthor` subtree, retained for unknown attribute preservation. */
+    rawXml?: XmlObject;
 }
 /**
  * A compatibility warning generated during parse or save when the
@@ -4617,9 +5303,17 @@ interface PptxTag {
  */
 interface PptxTagCollection {
     /** File path within the PPTX archive. */
-    path: string;
+    path?: string;
+    /** Package owner of the tags relationship. New collections default to presentation. */
+    owner?: 'presentation' | 'slide' | 'part';
+    /** Source OPC part that owns the relationship, e.g. ppt/slides/slide1.xml. */
+    sourcePartPath?: string;
+    /** Durable relationship identifier from the owning part. */
+    relationshipId?: string;
     /** Tags in this collection. */
     tags: PptxTag[];
+    /** Parsed tag-list XML retained for unknown-node preservation. */
+    rawXml?: XmlObject;
 }
 /**
  * A custom document property from `docProps/custom.xml`.
@@ -4725,6 +5419,19 @@ interface PptxAppProperties {
     hyperlinkBase?: string;
 }
 
+type PptxPrintOutput = 'slides' | 'handouts1' | 'handouts2' | 'handouts3' | 'handouts4' | 'handouts6' | 'handouts9' | 'notes' | 'outline';
+type PptxPrintColorMode = 'bw' | 'gray' | 'clr';
+/** PresentationML `CT_PrintProperties` (`p:prnPr`). */
+interface PptxPresentationPrintProperties {
+    printWhat?: PptxPrintOutput | null;
+    colorMode?: PptxPrintColorMode | null;
+    hiddenSlides?: boolean | null;
+    scaleToFitPaper?: boolean | null;
+    frameSlides?: boolean | null;
+    /** Original subtree retained for unknown attributes and `p:extLst`. */
+    rawXml?: XmlObject;
+}
+
 /**
  * Theme object model — colour scheme, font scheme, and format scheme
  * parsed from `ppt/theme/theme1.xml`.
@@ -5058,6 +5765,8 @@ type PptxStripDirection = 'lu' | 'ld' | 'ru' | 'rd';
 type PptxSplitOrientation = 'horz' | 'vert';
 /** Split in/out direction from OOXML `@_dir`. */
 type PptxSplitDirection = 'in' | 'out';
+/** Schema-defined `ST_TransitionSpeed` values. */
+type PptxTransitionSpeed = 'slow' | 'med' | 'fast';
 /** Valid direction sets per transition type. */
 declare const TRANSITION_VALID_DIRECTIONS: Readonly<Partial<Record<PptxTransitionType, readonly string[]>>>;
 /**
@@ -5076,6 +5785,8 @@ declare const TRANSITION_VALID_DIRECTIONS: Readonly<Partial<Record<PptxTransitio
  */
 interface PptxSlideTransition {
     type: PptxTransitionType;
+    /** Schema-defined transition speed. Defaults to `fast` when omitted. */
+    speed?: PptxTransitionSpeed;
     durationMs?: number;
     direction?: string;
     advanceOnClick?: boolean;
@@ -5090,6 +5801,10 @@ interface PptxSlideTransition {
     orient?: PptxSplitOrientation;
     /** Relationship ID of transition sound from `p:sndAc/p:stSnd/@r:embed` when present. */
     soundRId?: string;
+    /** Embedded WAV display name from `p:stSnd/p:snd/@name`. */
+    soundName?: string;
+    /** Whether the transition sound repeats until another sound starts. */
+    soundLoop?: boolean;
     /** Resolved transition sound media path within the package. */
     soundPath?: string;
     /** Human-readable sound file name (extracted from soundPath). */
@@ -5103,6 +5818,8 @@ interface PptxSlideTransition {
     rawSoundAction?: XmlObject;
     /** Preserved extension-list XML node from `p:extLst` within the transition for lossless round-trip. */
     rawExtLst?: XmlObject;
+    /** Original transition node, retained to preserve unknown attributes and children. */
+    rawTransition?: XmlObject;
 }
 
 /**
@@ -5122,6 +5839,11 @@ interface PptxViewScale {
     n: number;
     /** Denominator of the scale percentage (e.g. 100 for 100%). */
     d: number;
+    /** Optional independent vertical scale. When absent, the X scale is used. */
+    sy?: {
+        n: number;
+        d: number;
+    };
 }
 /**
  * Origin point for a view (x, y in twips or EMU).
@@ -5130,6 +5852,16 @@ interface PptxViewOrigin {
     x: number;
     y: number;
 }
+/** A horizontal or vertical drawing guide in slide coordinates. */
+interface PptxViewGuide {
+    orientation?: 'horz' | 'vert';
+    position?: number;
+}
+/** Positive grid spacing from `p:gridSpacing`. */
+interface PptxGridSpacing {
+    cx: number;
+    cy: number;
+}
 /**
  * Restored region dimensions for normal view splitter.
  * Represents `p:restoredLeft` or `p:restoredTop`.
@@ -5171,6 +5903,10 @@ interface PptxCommonSlideViewProperties {
     snapToObjects?: boolean;
     /** Whether drawing guides are shown. */
     showGuides?: boolean;
+    /** Whether the application may vary the scale automatically. */
+    variableScale?: boolean;
+    /** Drawing guides shown in this slide view. */
+    guides?: PptxViewGuide[];
     /** View origin (scroll position). */
     origin?: PptxViewOrigin;
     /** View scale. */
@@ -5198,6 +5934,8 @@ interface PptxViewProperties {
     };
     /** Notes view properties. */
     notesViewPr?: PptxCommonSlideViewProperties;
+    /** Grid spacing in positive DrawingML coordinates. */
+    gridSpacing?: PptxGridSpacing;
     /** Raw XML preserved for lossless round-trip of unparsed attributes. */
     rawXml?: Record<string, unknown>;
 }
@@ -5212,12 +5950,16 @@ interface PptxViewProperties {
  * @see ECMA-376 Part 1, §19.2.1.3 (custDataLst), §19.3.1.6 (custData)
  */
 interface PptxCustomerData {
-    /** Resolved part path inside the package (e.g. `ppt/customerData/item1.xml`). */
-    id: string;
+    /** Resolved part path inside the package (e.g. `customXml/item1.xml`). */
+    id?: string;
     /** Relationship ID referencing the custom data part. */
-    relId: string;
+    relId?: string;
     /** Raw string content of the custom data part (if resolvable). */
     data?: string;
+    /** OPC content type for the custom data part. */
+    contentType?: string;
+    /** Raw `p:custData` XML retained for unknown-node preservation. */
+    rawXml?: XmlObject;
 }
 /**
  * An ActiveX control reference from `p:controls / p:control`.
@@ -5342,6 +6084,8 @@ interface PptxSlide {
     /** Optional `<p:cSld @name>` value of the notes slide, for round-trip. */
     notesCSldName?: string;
     comments?: PptxComment[];
+    /** Source package metadata for an Office 2021 p188 comment part. */
+    modernCommentPart?: PptxModernCommentPart;
     warnings?: PptxCompatibilityWarning[];
     rawXml?: XmlObject;
     /** Per-slide colour map override parsed from `p:clrMapOvr`. */
@@ -5360,6 +6104,24 @@ interface PptxSlide {
     activeXControls?: PptxActiveXControl[];
     /** Per-slide header/footer flags from `<p:hf>` (P-H3). */
     headerFooterFlags?: PptxHeaderFooterFlags;
+    /** Server-backed slide synchronization metadata stored in a related OPC part. */
+    slideSynchronization?: PptxSlideSyncProperties;
+}
+interface PptxModernCommentPart {
+    path: string;
+    relationshipId: string;
+    /** Original p188:cmLst root, including unknown attributes and extensions. */
+    rawXml?: XmlObject;
+}
+/** Metadata from a `p:sldSyncPr` slide synchronization data part. */
+interface PptxSlideSyncProperties {
+    serverSlideId: string;
+    serverSlideModifiedTime: string;
+    clientInsertedTime: string;
+    extensionList?: XmlObject;
+    rawXml?: XmlObject;
+    partPath?: string;
+    relationshipId?: string;
 }
 /**
  * A slide layout available in the loaded presentation.
@@ -5446,11 +6208,13 @@ interface PptxPresentationProperties {
     showSlidesTo?: number;
     /** Whether to show subtitles/captions during presentation mode. */
     showSubtitles?: boolean;
-    /** Print settings: slides per page. */
+    /** Typed `p:prnPr` settings. Set to null during save to remove the element. */
+    printProperties?: PptxPresentationPrintProperties | null;
+    /** @deprecated Use `printProperties.printWhat`; retained as a handout compatibility alias. */
     printSlidesPerPage?: number;
-    /** Print settings: frame slides. */
+    /** @deprecated Use `printProperties.frameSlides`. */
     printFrameSlides?: boolean;
-    /** Print settings: colour mode (from `p:prnPr/@clrMode`). */
+    /** @deprecated Use `printProperties.colorMode`. */
     printColorMode?: 'clr' | 'gray' | 'bw';
     /** Most-recently-used colours from the presentation palette. */
     mruColors?: string[];
@@ -5487,6 +6251,8 @@ interface PptxCustomShow {
     id: string;
     /** Ordered list of slide relationship IDs included in this custom show. */
     slideRIds: string[];
+    /** Original `p:custShow` subtree used to preserve unmodelled attributes and extensions. */
+    rawXml?: XmlObject;
 }
 /**
  * An ordered section in the presentation (from `p:sectionLst` / `p14:sectionLst`).
@@ -5515,6 +6281,8 @@ interface PptxSection {
     collapsed?: boolean;
     /** Section highlight color hex (from p15:sectionPr/@clr). */
     color?: string;
+    /** Original section subtree used to preserve unmodelled attributes and extensions. */
+    rawXml?: XmlObject;
 }
 /**
  * Write-protection hash data parsed from `p:modifyVerifier` in `presentation.xml`.
@@ -5583,11 +6351,13 @@ interface PptxPhotoAlbum {
  */
 interface PptxKinsoku {
     /** Language code (e.g. "ja-JP", "zh-CN"). */
-    lang?: string;
+    lang?: string | null;
     /** Characters that cannot begin a line. */
     invalStChars?: string;
     /** Characters that cannot end a line. */
     invalEndChars?: string;
+    /** Original leaf retained for unknown attribute preservation. */
+    rawXml?: XmlObject;
 }
 /**
  * Root data structure returned by {@link PptxHandlerCore.load}.
@@ -5638,6 +6408,8 @@ interface PptxData {
     isPasswordProtected?: boolean;
     /** Embedded font data (name + binary data URL) extracted from the presentation. */
     embeddedFonts?: PptxEmbeddedFont[];
+    /** Typed `p:embeddedFontLst` package metadata, including unresolved variants. */
+    embeddedFontList?: PptxEmbeddedFontList;
     /** Most-recently-used colour list from presentation properties. */
     mruColors?: string[];
     /** Parsed notes master data if present in the PPTX. */
@@ -5678,6 +6450,8 @@ interface PptxData {
     thumbnailData?: Uint8Array;
     /** Comment authors parsed from `ppt/commentAuthors.xml` for round-trip preservation. */
     commentAuthors?: PptxCommentAuthor[];
+    /** Office 2021 p188 authors from the modern Author part. */
+    modernCommentAuthors?: PptxModernCommentAuthor[];
     /**
      * OOXML conformance class of the loaded file.
      * - `'strict'` -- ISO/IEC 29500 Strict (uses `purl.oclc.org` namespace URIs)
@@ -5794,4 +6568,4 @@ interface PptxEmbeddedFont {
     originalPartBytes?: Uint8Array;
 }
 
-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 PptxSlide 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 PptxElement as a, type PptxExternalData 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 PptxSmartArtNodeStyle as a7, type PptxChartDataTable as a8, type PptxChartLineStyle as a9, type TablePptxElement as aA, type ChartPptxElement as aB, type OlePptxElement as aC, type GroupPptxElement as aD, type PlaceholderTextLevelStyle as aE, type PptxChartOfPieOptions as aF, type PptxChartView3D as aG, type PptxChartChrome as aH, type PptxChartSeries as aI, type SmartArtPptxElement as aJ, type GeometryAdjustmentHandle as aK, type CustomGeometryRawData as aL, type AdjustHandleXY as aM, type AdjustHandlePolar as aN, type ConnectionSite as aO, type CustomGeometryTextRect as aP, type CustomGeometryPath as aQ, type BulletInfo as aR, type PptxShapeLocks as aS, type PptxTextStyleLevels as aT, type PptxThemeFillStyle as aU, type PptxThemeLineStyle as aV, type PptxThemeEffectStyle as aW, type PptxSmartArtTextRun as aX, type PptxSmartArtChrome as aY, type PptxSmartArtColorTransform as aZ, type PptxSmartArtQuickStyle as a_, type PptxChartErrBars as aa, type PptxChartTrendline as ab, type PptxChartMarker as ac, type PptxChartDataLabel as ad, type PptxChartDataPoint as ae, type PptxChartShapeProps as af, type PptxChart3DSurface as ag, type PptxChartAxisFormatting as ah, type PptxEmbeddedWorkbookData as ai, type PptxDrawingGuide as aj, type PptxTableCellStyle as ak, type PptxCustomXmlPart as al, type PptxCommentAuthor as am, type MediaPptxElement as an, type PptxTableData as ao, type PptxTheme as ap, type PptxThemeOption as aq, type PlaceholderDefaults as ar, type PptxMasterTextStyles as as, type PptxThemeObjectDefaults as at, type ParsedTableStyleFill as au, type ParsedTableBackground as av, type ParsedTableStyleText as aw, type PptxImageEffects as ax, type MediaBookmark as ay, type PptxChartStyle as az, type PptxElementWithShapeStyle as b, type PptxTextAnimationTarget as b$, type CustomGeometryPoint as b0, type ImagePptxElement as b1, type PptxChartDataLabelOptions as b2, type PptxChartMarkerSymbol as b3, type ActionButtonPreset as b4, type AnimationConditionEvent as b5, type BevelPresetType as b6, type ConnectorConnectionPoint as b7, type ContentPartInkStroke as b8, type ContentPartPptxElement as b9, type PptxChartAxisNumFmt as bA, type PptxChartErrBarDir as bB, type PptxChartErrBarType as bC, type PptxChartErrValType as bD, type PptxChartTrendlineType as bE, type PptxColorAnimation as bF, type PptxCommonSlideViewProperties as bG, type PptxCropShape as bH, type PptxCustomPathProperties as bI, type PptxElementBase as bJ, type PptxElementType as bK, type PptxExportFormat as bL, type PptxGraphicFrameExtension as bM, type PptxHeaderFooterFlags as bN, type PptxImageProperties as bO, type PptxMediaType as bP, type PptxNativeAnimationKind as bQ, type PptxNormalViewProperties as bR, type PptxRestoredRegion as bS, type PptxShapeProperties as bT, type PptxSmartArtConnection as bU, type PptxSplitDirection as bV, type PptxSplitOrientation as bW, type PptxStripDirection as bX, type PptxTableCell as bY, type PptxTableRow as bZ, type PptxTag as b_, type CustomGeometrySegment as ba, type EffectDagBlend as bb, type EffectDagBlendMode as bc, type EffectDagContainer as bd, type EffectDagContainerType as be, type EffectDagNode as bf, type EffectDagRawLeaf as bg, type EffectDagRelOff as bh, type EffectDagXfrm as bi, type ElementActionType as bj, type MasterViewTab as bk, type MaterialPresetType as bl, type MediaCaptionTrack as bm, type MediaMetadata as bn, type Model3DPptxElement as bo, type ParsedTableStyleEntry as bp, type PicturePptxElement as bq, type Pptx3DScene as br, type Pptx3DShape as bs, type PptxAfterAnimationAction as bt, type PptxAnimationDirection as bu, type PptxAnimationIterate as bv, type PptxAnimationKeyframe as bw, type PptxAnimationRepeatMode as bx, type PptxAnimationSequence as by, type PptxAnimationTimingCurve as bz, type PptxElementWithText as c, type PptxTextBuildType as c0, type PptxTextProperties as c1, type PptxTextWarpPreset as c2, type PptxThemeFontGroup as c3, type PptxTransitionDirection4 as c4, type PptxTransitionDirection8 as c5, type PptxViewOrigin as c6, type PptxViewScale as c7, type ShadowEffect as c8, type SmartArtColorScheme as c9, type SmartArtLayout as ca, type SmartArtStyle as cb, THEME_COLOR_SCHEME_KEYS as cc, TRANSITION_VALID_DIRECTIONS as cd, type Text3DStyle as ce, type UnderlineStyle as cf, type UnknownPptxElement as cg, type PptxImageLikeElement as d, type PptxThemeColorScheme as e, type PptxThemeFontScheme as f, type PptxAnimationPreset as g, type PptxAnimationTrigger as h, type StrokeDashType as i, type ConnectorArrowType as j, type PptxTransitionType as k, type PptxChartType 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 PptxComment as $, type PptxCoreProperties as A, type PptxAppProperties as B, type ConnectorPptxElement as C, type PptxCustomProperty as D, type PptxNotesMaster as E, type PptxHandoutMaster as F, type PptxSlideMaster as G, type PptxSlideLayout as H, type InkPptxElement as I, type PptxTagCollection as J, type PptxCustomerData as K, type PptxPhotoAlbum as L, type PptxKinsoku as M, type PptxModifyVerifier as N, type PptxViewProperties as O, type PptxSlide as P, type ParsedTableStyleMap as Q, type PptxEmbeddedFont as R, type ShapePptxElement as S, type TextPptxElement as T, type PptxEmbeddedFontList as U, type PptxExportOptions as V, type PptxMediaReferenceKind as W, type XmlObject as X, type PptxThemeFormatScheme as Y, type ZoomPptxElement as Z, type TextSegment as _, type PptxElement as a, type PptxChartOfPieOptions as a$, type PptxModernCommentPart as a0, type PptxSlideBackgroundPattern as a1, type PptxSlideTransition as a2, type PptxElementAnimation as a3, type PptxNativeAnimation as a4, type PptxActiveXControl as a5, type AnimationCondition as a6, type PptxGraphicBuild as a7, type PptxAnimationTarget as a8, type ShapeStyle as a9, type PptxChartLayouts as aA, type PptxChartManualLayout as aB, type PptxBubbleChartOptions as aC, type PptxSmartArtLayoutNode as aD, type PptxChartUpDownBars as aE, type PptxAudioCdPosition as aF, type MediaPptxElement as aG, type PptxCustomXmlPart as aH, type PptxCommentAuthor as aI, type PptxTableData as aJ, type PptxTheme as aK, type PptxThemeOption as aL, type PptxModernCommentAuthor as aM, type PlaceholderDefaults as aN, type PptxMasterTextStyles as aO, type PptxThemeObjectDefaults as aP, type ParsedTableStyleFill as aQ, type ParsedTableBackground as aR, type ParsedTableStyleText as aS, type PptxImageEffects as aT, type MediaBookmark as aU, type PptxChartStyle as aV, type TablePptxElement as aW, type ChartPptxElement as aX, type OlePptxElement as aY, type GroupPptxElement as aZ, type PlaceholderTextLevelStyle as a_, type TextStyle as aa, type ElementAction as ab, type PptxAction as ac, type ContentPartInkStroke as ad, type OleObjectType as ae, type PptxSmartArtNodeStyle as af, type PptxSmartArtDrawingShape as ag, type PptxChartDataTable as ah, type PptxChartLineStyle as ai, type PptxChartErrBars as aj, type PptxChartTrendline as ak, type PptxChartDataLabel as al, type PptxChartMarker as am, type PptxChartDataPoint as an, type PptxChartShapeProps as ao, type PptxChart3DSurface as ap, type PptxChartAxisFormatting as aq, type PptxEmbeddedWorkbookData as ar, type PptxDrawingGuide as as, type SmartArtLayoutType as at, type PptxSmartArtNode as au, type PptxSmartArtLayoutDefinition as av, type PptxSmartArtColorStyleLabel as aw, type PptxSmartArtDefinitionMetadata as ax, type PptxSmartArtQuickStyleLabel as ay, type PptxTableCellStyle as az, type PptxElementWithShapeStyle as b, type PptxChartDataLabelPosition as b$, type PptxChartView3D as b0, type PptxChartChrome as b1, type PptxChartSeries as b2, type SmartArtPptxElement as b3, type Model3DPptxElement as b4, type ContentPartPptxElement as b5, type GeometryAdjustmentHandle as b6, type CustomGeometryRawData as b7, type AdjustHandleXY as b8, type AdjustHandlePolar as b9, type EffectDagBlendMode as bA, type EffectDagBlur as bB, type EffectDagContainer as bC, type EffectDagContainerType as bD, type EffectDagNode as bE, type EffectDagPresetShadow as bF, type EffectDagRawLeaf as bG, type EffectDagRelOff as bH, type EffectDagXfrm as bI, type ElementActionType as bJ, type MasterViewTab as bK, type MaterialPresetType as bL, type MediaCaptionTrack as bM, type MediaMetadata as bN, type ParsedTableStyleEntry as bO, type PicturePptxElement as bP, type Pptx3DScene as bQ, type Pptx3DShape as bR, type PptxAfterAnimationAction as bS, type PptxAnimationDirection as bT, type PptxAnimationIterate as bU, type PptxAnimationKeyframe as bV, type PptxAnimationRepeatMode as bW, type PptxAnimationSequence as bX, type PptxAnimationTimingCurve as bY, type PptxChartAxisLabelFormatting as bZ, type PptxChartAxisNumFmt as b_, type ConnectionSite as ba, type CustomGeometryTextRect as bb, type CustomGeometryPath as bc, type BulletInfo as bd, type PptxShapeLocks as be, type PptxTextStyleLevels as bf, type PptxThemeFillStyle as bg, type PptxThemeLineStyle as bh, type PptxThemeEffectStyle as bi, type PptxSmartArtTextRun as bj, type PptxSmartArtChrome as bk, type PptxSmartArtColorTransform as bl, type PptxSmartArtConnection as bm, type PptxSmartArtQuickStyle as bn, type PptxExternalData as bo, type CustomGeometryPoint as bp, type ImagePptxElement as bq, type PptxChartDataLabelOptions as br, type PptxChartMarkerSymbol as bs, type ActionButtonPreset as bt, type AnimationConditionEvent as bu, type BevelPresetType as bv, type ConnectorConnectionPoint as bw, type CustomGeometrySegment as bx, type EffectDagAlphaOutset as by, type EffectDagBlend as bz, type PptxElementWithText as c, type PptxSmartArtWhen as c$, type PptxChartDateCategories as c0, type PptxChartDisplayUnitsLabel as c1, type PptxChartErrBarDir as c2, type PptxChartErrBarType as c3, type PptxChartErrValType as c4, type PptxChartLegendEntry as c5, type PptxChartLegendTextStyle as c6, type PptxChartPageMargins as c7, type PptxChartPageSetup as c8, type PptxChartParentLabelLayout as c9, type PptxNormalViewProperties as cA, type PptxPresentationPrintProperties as cB, type PptxPrintColorMode as cC, type PptxPrintOutput as cD, type PptxRestoredRegion as cE, type PptxShapeProperties as cF, type PptxSlideSyncProperties as cG, type PptxSmartArtAlgorithmParameter as cH, type PptxSmartArtChoose as cI, type PptxSmartArtColorApplicationMethod as cJ, type PptxSmartArtColorListMetadata as cK, type PptxSmartArtConstraint as cL, type PptxSmartArtConstraintOperator as cM, type PptxSmartArtConstraintPointType as cN, type PptxSmartArtConstraintRelationship as cO, type PptxSmartArtConstraintTarget as cP, type PptxSmartArtDefinitionCategory as cQ, type PptxSmartArtDefinitionText as cR, type PptxSmartArtForEach as cS, type PptxSmartArtHueDirection as cT, type PptxSmartArtIteratorAttributes as cU, type PptxSmartArtLayoutAlgorithm as cV, type PptxSmartArtLayoutCategory as cW, type PptxSmartArtLocalizedText as cX, type PptxSmartArtNumericRule as cY, type PptxSmartArtTextParagraph as cZ, type PptxSmartArtTextParagraphItem as c_, type PptxChartPivotFormat as ca, type PptxChartPivotFormats as cb, type PptxChartPivotSource as cc, type PptxChartPrintHeaderFooter as cd, type PptxChartPrintSettings as ce, type PptxChartProtection as cf, type PptxChartTickMark as cg, type PptxChartTrendlineLabel as ch, type PptxChartTrendlineType as ci, type PptxColorAnimation as cj, type PptxCommonSlideViewProperties as ck, type PptxCropShape as cl, type PptxCustomDashSegment as cm, type PptxCustomPathProperties as cn, type PptxElementBase as co, type PptxElementType as cp, type PptxEmbeddedFontDataId as cq, type PptxEmbeddedFontDescriptor as cr, type PptxEmbeddedFontListEntry as cs, type PptxExportFormat as ct, type PptxGraphicFrameExtension as cu, type PptxGridSpacing as cv, type PptxHeaderFooterFlags as cw, type PptxImageProperties as cx, type PptxMediaType as cy, type PptxNativeAnimationKind as cz, type PptxImageLikeElement as d, type PptxSplitDirection as d0, type PptxSplitOrientation as d1, type PptxStripDirection as d2, type PptxTableCell as d3, type PptxTableRow as d4, type PptxTag as d5, type PptxTextAnimationTarget as d6, type PptxTextBuildType as d7, type PptxTextProperties as d8, type PptxTextWarpPreset as d9, type PptxThemeFontGroup as da, type PptxTransitionDirection4 as db, type PptxTransitionDirection8 as dc, type PptxTransitionSpeed as dd, type PptxViewGuide as de, type PptxViewOrigin as df, type PptxViewScale as dg, type ShadowEffect as dh, type SmartArtColorScheme as di, type SmartArtLayout as dj, type SmartArtStyle as dk, type SummaryZoomTarget as dl, THEME_COLOR_SCHEME_KEYS as dm, TRANSITION_VALID_DIRECTIONS as dn, type Text3DStyle as dp, type UnderlineStyle as dq, type UnknownPptxElement as dr, type PptxThemeColorScheme as e, type PptxThemeFontScheme as f, type PptxAnimationPreset as g, type PptxAnimationTrigger as h, type PptxChartBoxWhiskerOptions as i, type PptxChartHistogramOptions as j, type PptxChartWaterfallOptions as k, type PptxChartRegionMapOptions as l, type PptxChartTreemapOptions as m, type StrokeDashType as n, type ConnectorArrowType as o, type PptxTransitionType as p, type PptxChartType as q, type PptxData as r, type PptxCompatibilityWarning as s, type PptxLayoutOption as t, type PptxChartData as u, type PptxSmartArtData as v, type PptxHeaderFooter as w, type PptxPresentationProperties as x, type PptxCustomShow as y, type PptxSection as z };