pptx-svelte-viewer 0.8.1 → 0.9.0

package/dist/index.d.ts

@@ -1,130 +1,5 @@
 import { Component } from 'svelte';
 
-/**
- * Theme configuration types for the PowerPoint viewer.
- *
- * All color values accept any valid CSS color string:
- * hex (`#6366f1`), rgb (`rgb(99 102 241)`), hsl (`hsl(239 84% 67%)`),
- * oklch (`oklch(0.585 0.233 277)`), named colors, etc.
- *
- * Framework-agnostic — shared by the React, Vue, and Angular bindings.
- */
-/**
- * Semantic color tokens for the viewer UI.
- *
- * These map to CSS custom properties (`--pptx-<token>`) and drive all
- * UI component colors. The naming follows the shadcn/ui convention so
- * that Tailwind + shadcn users get a familiar experience.
- */
-interface ViewerThemeColors {
-    /** Page / root background */
-    background: string;
-    /** Default text color */
-    foreground: string;
-    /** Card / panel surface */
-    card: string;
-    /** Text on card surfaces */
-    cardForeground: string;
-    /** Popover / dropdown surface */
-    popover: string;
-    /** Text inside popovers */
-    popoverForeground: string;
-    /** Primary action color (buttons, active indicators) */
-    primary: string;
-    /** Text on primary-colored backgrounds */
-    primaryForeground: string;
-    /** Secondary / subdued action color */
-    secondary: string;
-    /** Text on secondary backgrounds */
-    secondaryForeground: string;
-    /** Muted / disabled surface */
-    muted: string;
-    /** Text on muted surfaces (also used for secondary text) */
-    mutedForeground: string;
-    /** Accent / hover-highlight surface */
-    accent: string;
-    /** Text on accent surfaces */
-    accentForeground: string;
-    /** Destructive / danger action color */
-    destructive: string;
-    /** Text on destructive backgrounds */
-    destructiveForeground: string;
-    /** Default border color */
-    border: string;
-    /** Input field border color */
-    input: string;
-    /** Focus ring color */
-    ring: string;
-}
-/**
- * Full viewer theme configuration.
- *
- * Every property is optional — unset values fall back to the built-in
- * dark theme defaults.
- */
-interface ViewerTheme {
-    /** Semantic UI colors. Each key maps to a `--pptx-<key>` CSS custom property. */
-    colors?: Partial<ViewerThemeColors>;
-    /** Base border-radius value (e.g. `"0.5rem"`, `"8px"`). */
-    radius?: string;
-    /**
-     * Escape hatch: arbitrary CSS custom properties to set on the viewer
-     * root element. Keys should include the `--` prefix.
-     *
-     * @example
-     * ```ts
-     * { "--my-custom-shadow": "0 4px 12px rgba(0,0,0,0.5)" }
-     * ```
-     */
-    cssVars?: Record<string, string>;
-}
-
-/**
- * Default dark-theme color values.
- *
- * These correspond to the built-in dark UI of the PowerPoint viewer and
- * use Tailwind's gray palette as the neutral scale with indigo as the
- * primary accent.
- */
-declare const defaultThemeColors: ViewerThemeColors;
-/** Default border-radius. */
-declare const defaultRadius = "0.5rem";
-
-/**
- * Convert a `ViewerTheme` into a flat `Record<string, string>` of CSS
- * custom properties (including the `--` prefix) ready to be spread onto
- * a `style` attribute.
- *
- * Only properties that differ from the built-in defaults are emitted when
- * `omitDefaults` is true (the default).
- */
-declare function themeToCssVars(theme: ViewerTheme | undefined, omitDefaults?: boolean): Record<string, string>;
-/**
- * Build the complete set of CSS custom properties with all defaults.
- * Useful for generating a full fallback stylesheet.
- */
-declare function defaultCssVars(): Record<string, string>;
-
-/**
- * Built-in "vermilion" theme presets.
- *
- * These mirror the pptx-viewer brand used on the documentation site:
- * a warm paper canvas in light mode, a dimmed presenter room in dark
- * mode, and the vermilion accent in both. Pass one to the viewer's
- * `theme` prop (React/Vue) or `provideViewerTheme` (Angular), or spread
- * the color objects to derive your own variant.
- */
-/** Light "paper" palette: a projection screen in a bright room. */
-declare const vermilionLightColors: ViewerThemeColors;
-/** Dark "presenter" palette: the presenter room with the lights down. */
-declare const vermilionDarkColors: ViewerThemeColors;
-/** Shared border-radius for the vermilion presets (slightly sharper than the default). */
-declare const vermilionRadius = "0.375rem";
-/** Light vermilion theme, ready for the viewer's `theme` prop. */
-declare const vermilionLightTheme: ViewerTheme;
-/** Dark vermilion theme, ready for the viewer's `theme` prop. */
-declare const vermilionDarkTheme: ViewerTheme;
-
 /**
  * Action types: hyperlinks, slide jumps, macros, and action buttons.
  *
@@ -482,6 +357,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). */
@@ -622,7 +499,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`.
@@ -833,6 +710,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.
  *
@@ -1065,11 +948,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`. */
@@ -1181,6 +1065,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. */
@@ -1866,6 +1752,47 @@ interface PptxShapeProperties {
     /** Adjustment handles for interactive shape modification (yellow diamond handles). */
     adjustmentHandles?: GeometryAdjustmentHandle[];
 }
+/**
+ * Text styling for a single indent level (0–8) inside a placeholder’s
+ * `a:lstStyle`.
+ *
+ * Used during placeholder inheritance to fill in defaults for font,
+ * bullet, and spacing properties the slide element does not override.
+ *
+ * @example
+ * ```ts
+ * const level0: PlaceholderTextLevelStyle = {
+ *   fontSize: 32,
+ *   bold: true,
+ *   bulletChar: "•",
+ * };
+ * // => satisfies PlaceholderTextLevelStyle
+ * ```
+ */
+interface PlaceholderTextLevelStyle {
+    fontFamily?: string;
+    fontSize?: number;
+    bold?: boolean;
+    italic?: boolean;
+    color?: string;
+    bulletChar?: string;
+    bulletAutoNumType?: string;
+    bulletFontFamily?: string;
+    bulletSizePercent?: number;
+    /** Bullet colour from `a:buClr` as hex string. */
+    bulletColor?: string;
+    /** Bullet size in points from `a:buSzPts`. */
+    bulletSizePts?: number;
+    /** True when `a:buNone` is present at this level. */
+    bulletNone?: boolean;
+    marginLeft?: number;
+    indent?: number;
+    alignment?: string;
+    lineSpacing?: number;
+    lineSpacingExactPt?: number;
+    spaceBefore?: number;
+    spaceAfter?: number;
+}
 
 /** Tick-mark placement from ChartML `ST_TickMark`. */
 type PptxChartTickMark = 'cross' | 'in' | 'none' | 'out';
@@ -1882,10 +1809,104 @@ interface PptxChartAxisLabelFormatting {
     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`.
@@ -2042,6 +2063,7 @@ interface PptxChartUpDownBars {
 /** 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;
 }
@@ -2052,6 +2074,8 @@ 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';
@@ -2094,6 +2118,12 @@ interface PptxChartAxisFormatting extends PptxChartAxisLabelFormatting {
     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;
@@ -2111,6 +2141,8 @@ interface PptxChartAxisFormatting extends PptxChartAxisLabelFormatting {
     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;
     /**
@@ -2134,12 +2166,69 @@ interface PptxChartAxisFormatting extends PptxChartAxisLabelFormatting {
     majorUnit?: number;
     /** Minor-unit interval between secondary tick marks (c:minorUnit/@val). */
     minorUnit?: number;
+    /** 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.
  *
@@ -2175,6 +2264,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
@@ -2380,6 +2474,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}.
@@ -2403,6 +2507,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;
@@ -2439,12 +2550,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.
@@ -2467,6 +2573,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).
      *
@@ -2492,6 +2604,10 @@ 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;
     /**
@@ -2510,7 +2626,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
@@ -2521,7 +2638,7 @@ interface PptxChartData {
 
 type EffectDagBlendMode = 'darken' | 'lighten' | 'mult' | 'over' | 'screen';
 type EffectDagContainerType = 'sib' | 'tree';
-type EffectDagNode = EffectDagContainer | EffectDagBlend | EffectDagXfrm | EffectDagRelOff | EffectDagBlur | EffectDagPresetShadow | EffectDagRawLeaf;
+type EffectDagNode = EffectDagContainer | EffectDagBlend | EffectDagXfrm | EffectDagRelOff | EffectDagBlur | EffectDagAlphaOutset | EffectDagPresetShadow | EffectDagRawLeaf;
 interface EffectDagContainer {
     kind: 'cont';
     type: EffectDagContainerType;
@@ -2554,6 +2671,12 @@ interface EffectDagBlur {
     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';
@@ -2593,6 +2716,8 @@ interface PptxImageEffects {
     duotone?: {
         color1: string;
         color2: string;
+        /** Original effect XML, retained while the resolved colours are unchanged. */
+        rawXml?: XmlObject;
     };
     /** Grayscale flag. */
     grayscale?: boolean;
@@ -2607,8 +2732,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). */
@@ -2617,7 +2744,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.
@@ -2625,11 +2758,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.
@@ -2637,11 +2776,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
@@ -2784,6 +2929,7 @@ declare module "./index" {
  *
  * @module pptx-types/media
  */
+
 /**
  * Discriminator for embedded media element types.
  *
@@ -2798,6 +2944,8 @@ type PptxMediaReferenceKind = 'audioCd' | 'wavAudioFile' | 'audioFile' | 'videoF
 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.
@@ -2875,7 +3023,39 @@ 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;
@@ -2884,12 +3064,56 @@ 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. */
@@ -2901,6 +3125,8 @@ interface PptxSmartArtLayoutDefinition {
     descriptions?: PptxSmartArtLocalizedText[];
     categories?: PptxSmartArtLayoutCategory[];
     rootNode: PptxSmartArtLayoutNode;
+    /** Original definition retained for constraint evaluation and foreign rules. */
+    rawXml?: XmlObject;
 }
 
 /**
@@ -2912,6 +3138,7 @@ interface PptxSmartArtLayoutDefinition {
  *
  * @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,
@@ -2935,6 +3162,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.
@@ -3004,6 +3279,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
@@ -3167,7 +3447,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"). */
@@ -3191,6 +3471,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). */
@@ -3516,6 +3798,126 @@ interface PptxTableData {
     /** Right-to-left table layout from `a:tblPr/@rtl`. */
     rtl?: boolean;
 }
+/**
+ * A single fill reference within a table style section.
+ *
+ * @example
+ * ```ts
+ * const fill: ParsedTableStyleFill = {
+ *   schemeColor: "accent1",
+ *   tint: 40000,   // 40% tint
+ * };
+ * // => satisfies ParsedTableStyleFill
+ * ```
+ */
+interface ParsedTableStyleFill {
+    /** Theme colour key (e.g. `accent1`, `dk1`). */
+    schemeColor: string;
+    /** Tint value (0-100 000). */
+    tint?: number;
+    /** Shade value (0-100 000). */
+    shade?: number;
+}
+/**
+ * A single entry in the parsed table style map.
+ *
+ * Contains fill colours for whole-table, banded rows/columns, first/last
+ * row, and first/last column sections.
+ *
+ * @example
+ * ```ts
+ * const entry: ParsedTableStyleEntry = {
+ *   styleId: "{5C22544A-7EE6-4342-B048-85BDC9FD1C3A}",
+ *   styleName: "Medium Style 2 - Accent 1",
+ *   accentKey: "accent1",
+ *   wholeTblFill: { schemeColor: "accent1", tint: 20000 },
+ *   band1HFill:   { schemeColor: "accent1", tint: 40000 },
+ *   firstRowFill: { schemeColor: "accent1" },
+ * };
+ * // => satisfies ParsedTableStyleEntry
+ * ```
+ */
+/** Text properties from a:tcTxStyle in a table style section. */
+interface ParsedTableStyleText {
+    /** Font bold. */
+    bold?: boolean;
+    /** Font italic. */
+    italic?: boolean;
+    /** Font colour as theme scheme key. */
+    fontSchemeColor?: string;
+    /** Font colour tint (0-100 000). */
+    fontTint?: number;
+    /** 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;
+    band1VFill?: ParsedTableStyleFill;
+    band2VFill?: ParsedTableStyleFill;
+    firstRowFill?: ParsedTableStyleFill;
+    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;
+    lastRowText?: ParsedTableStyleText;
+    firstColText?: ParsedTableStyleText;
+    lastColText?: ParsedTableStyleText;
+    band1HText?: ParsedTableStyleText;
+    band2HText?: ParsedTableStyleText;
+    band1VText?: ParsedTableStyleText;
+    band2VText?: ParsedTableStyleText;
+    seCellText?: ParsedTableStyleText;
+    swCellText?: ParsedTableStyleText;
+    neCellText?: ParsedTableStyleText;
+    nwCellText?: ParsedTableStyleText;
+}
+/**
+ * Map of GUID → table style entry.
+ *
+ * Parsed from `ppt/tableStyles.xml` and indexed by the style GUID
+ * referenced in `a:tblPr@tblStyle`.
+ *
+ * @example
+ * ```ts
+ * const styles: ParsedTableStyleMap = {
+ *   "{5C22544A-7EE6-4342-B048-85BDC9FD1C3A}": {
+ *     styleId: "{5C22544A-7EE6-4342-B048-85BDC9FD1C3A}",
+ *     styleName: "Medium Style 2 - Accent 1",
+ *     accentKey: "accent1",
+ *   },
+ * };
+ * // => satisfies ParsedTableStyleMap
+ * ```
+ */
+type ParsedTableStyleMap = Record<string, ParsedTableStyleEntry>;
 
 /**
  * A text box — a plain rectangle containing text, typically with no
@@ -3768,6 +4170,8 @@ interface MediaPptxElement extends PptxElementBase {
     mediaMimeType?: string;
     mediaReferenceKind?: PptxMediaReferenceKind;
     mediaReferenceName?: string;
+    /** Explicit DrawingML `audioFile/@contentType` value when present. */
+    mediaReferenceContentType?: string;
     audioCdStart?: PptxAudioCdPosition;
     audioCdEnd?: PptxAudioCdPosition;
     rawMediaReferenceXml?: XmlObject;
@@ -3891,6 +4295,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).
@@ -3911,12 +4319,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
@@ -3953,22 +4381,217 @@ interface UnknownPptxElement extends PptxElementBase {
  * (shape), or `textSegments` (text/shape).
  */
 type PptxElement = TextPptxElement | ShapePptxElement | ConnectorPptxElement | ImagePptxElement | PicturePptxElement | TablePptxElement | ChartPptxElement | SmartArtPptxElement | OlePptxElement | MediaPptxElement | GroupPptxElement | InkPptxElement | ContentPartPptxElement | ZoomPptxElement | Model3DPptxElement | UnknownPptxElement;
+
 /**
- * Per-part header/footer flags from `<p:hf>` (CT_HeaderFooter, ECMA-376
- * §19.3.1.21). Defaults are "all true" — fields are only set on the typed
- * model when they were explicitly read, so callers can distinguish "unset"
- * (preserve original XML) from "false" (override).
+ * Master and layout types: notes master, handout master, slide master,
+ * slide layout, and theme options.
+ *
+ * @module pptx-types/masters
  */
-interface PptxHeaderFooterFlags {
-    /** `@hdr` — show header placeholder. Spec default: `true`. */
-    hasHeader?: boolean;
-    /** `@ftr` — show footer placeholder. Spec default: `true`. */
-    hasFooter?: boolean;
-    /** `@dt` — show date/time placeholder. Spec default: `true`. */
+
+/**
+ * Parsed notes master from `ppt/notesMasters/notesMaster1.xml`.
+ *
+ * @example
+ * ```ts
+ * const notes: PptxNotesMaster = {
+ *   path: "ppt/notesMasters/notesMaster1.xml",
+ *   backgroundColor: "#FFFFFF",
+ *   placeholders: [{ type: "body" }, { type: "sldImg" }],
+ * };
+ * // => satisfies PptxNotesMaster
+ * ```
+ */
+interface PptxNotesMaster {
+    /** File path within the PPTX archive. */
+    path: string;
+    /** Background colour of the notes master. */
+    backgroundColor?: string;
+    /** Background image data URL. */
+    backgroundImage?: string;
+    /** Placeholder shapes found on the notes master. */
+    placeholders?: Array<{
+        type: string;
+        idx?: string;
+    }>;
+    /** Editable elements on the notes master (header, footer, date, page number, slide image, notes body). */
+    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`.
+ *
+ * @example
+ * ```ts
+ * const handout: PptxHandoutMaster = {
+ *   path: "ppt/handoutMasters/handoutMaster1.xml",
+ *   slidesPerPage: 6,
+ * };
+ * // => satisfies PptxHandoutMaster
+ * ```
+ */
+interface PptxHandoutMaster {
+    /** File path within the PPTX archive. */
+    path: string;
+    /** Background colour of the handout master. */
+    backgroundColor?: string;
+    /** Background image data URL. */
+    backgroundImage?: string;
+    /** Placeholder shapes found on the handout master. */
+    placeholders?: Array<{
+        type: string;
+        idx?: string;
+    }>;
+    /** Editable elements on the handout master (header, footer, date, page number, slide placeholders). */
+    elements?: PptxElement[];
+    /** Number of slides per page for handout print layout (1, 2, 3, 4, 6, or 9). */
+    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>;
+}
+/**
+ * Structured slide master data.
+ *
+ * @example
+ * ```ts
+ * const master: PptxSlideMaster = {
+ *   path: "ppt/slideMasters/slideMaster1.xml",
+ *   name: "Office Theme",
+ *   backgroundColor: "#FFFFFF",
+ *   themePath: "ppt/theme/theme1.xml",
+ * };
+ * // => satisfies PptxSlideMaster
+ * ```
+ */
+interface PptxSlideMaster {
+    /** File path within the PPTX archive. */
+    path: string;
+    /** Human-readable name if available. */
+    name?: string;
+    /** Background colour of the slide master. */
+    backgroundColor?: string;
+    /** Background image data URL for the slide master. */
+    backgroundImage?: string;
+    /** Theme file path this master references. */
+    themePath?: string;
+    /** Layout paths associated with this master. */
+    layoutPaths?: string[];
+    /** Placeholder shapes on the master. */
+    placeholders?: Array<{
+        type: string;
+        idx?: string;
+    }>;
+    /** Parsed element shapes on the master slide (for master view rendering). */
+    elements?: PptxElement[];
+    /** Parsed slide layout objects associated with this master. */
+    layouts?: PptxSlideLayout[];
+    /** Text styles from `p:txStyles` — title, body, and other text defaults. */
+    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.
+ * Each entry maps a 0-based level index to its style defaults.
+ */
+type PptxTextStyleLevels = Record<number, PlaceholderTextLevelStyle>;
+/**
+ * Text styles parsed from `p:txStyles` on a slide master.
+ * Provides cascading defaults for title, body, and other text.
+ */
+interface PptxMasterTextStyles {
+    /** Title text style (`p:titleStyle`). */
+    titleStyle?: PptxTextStyleLevels;
+    /** Body text style (`p:bodyStyle`). */
+    bodyStyle?: PptxTextStyleLevels;
+    /** Other text style (`p:otherStyle`). */
+    otherStyle?: PptxTextStyleLevels;
+}
+/**
+ * Per-part header/footer flags from `<p:hf>` (CT_HeaderFooter, ECMA-376
+ * §19.3.1.21). Defaults are "all true" — fields are only set on the typed
+ * model when they were explicitly read, so callers can distinguish "unset"
+ * (preserve original XML) from "false" (override).
+ */
+interface PptxHeaderFooterFlags {
+    /** `@hdr` — show header placeholder. Spec default: `true`. */
+    hasHeader?: boolean;
+    /** `@ftr` — show footer placeholder. Spec default: `true`. */
+    hasFooter?: boolean;
+    /** `@dt` — show date/time placeholder. Spec default: `true`. */
     hasDateTime?: boolean;
     /** `@sldNum` — show slide-number placeholder. Spec default: `true`. */
     hasSlideNumber?: boolean;
 }
+/**
+ * A slide layout associated with a slide master.
+ *
+ * @example
+ * ```ts
+ * const layout: PptxSlideLayout = {
+ *   path: "ppt/slideLayouts/slideLayout2.xml",
+ *   name: "Title and Content",
+ * };
+ * // => satisfies PptxSlideLayout
+ * ```
+ */
+interface PptxSlideLayout {
+    /** File path within the PPTX archive. */
+    path: string;
+    /** Human-readable layout name. */
+    name?: string;
+    /** Background colour of the layout. */
+    backgroundColor?: string;
+    /** Background image data URL for the layout. */
+    backgroundImage?: string;
+    /** Parsed element shapes on the layout. */
+    elements?: PptxElement[];
+    /** Placeholder shapes on the layout. */
+    placeholders?: Array<{
+        type: string;
+        idx?: string;
+    }>;
+    /** Matching name attribute for layout identification (`@matchingName`). */
+    matchingName?: string;
+    /** Whether the layout is marked as preserved (prevent deletion, `@preserve`). */
+    preserve?: boolean;
+    /** Whether master placeholder animations should play (`@showMasterPhAnim`). */
+    showMasterPhAnim?: boolean;
+    /** Whether this layout is user-drawn (`@userDrawn`). */
+    userDrawn?: boolean;
+    /** Colour map override from `p:clrMapOvr`. */
+    clrMapOverride?: Record<string, string>;
+    /** Header/footer flags from `<p:hf>` on this layout (P-H3). */
+    headerFooter?: PptxHeaderFooterFlags;
+}
+/**
+ * A theme part available in the presentation package.
+ *
+ * @example
+ * ```ts
+ * const opt: PptxThemeOption = {
+ *   path: "ppt/theme/theme1.xml",
+ *   name: "Office Theme",
+ * };
+ * // => satisfies PptxThemeOption
+ * ```
+ */
+interface PptxThemeOption {
+    /** File path within the PPTX archive (e.g. `ppt/theme/theme2.xml`). */
+    path: string;
+    /** Human-readable theme name from `a:theme/@name`, when present. */
+    name?: string;
+}
 
 /**
  * Animation types: presets, triggers, timing, native parsed animation data,
@@ -4363,6 +4986,33 @@ 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.
@@ -4422,6 +5072,49 @@ interface PptxComment {
     /** 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`.
+ *
+ * Stores all attributes needed for lossless round-trip serialization
+ * of the `p:cmAuthor` element (id, name, initials, lastIdx, clrIdx).
+ *
+ * @see ECMA-376 Part 1, §19.4.2 (cmAuthor)
+ *
+ * @example
+ * ```ts
+ * const author: PptxCommentAuthor = {
+ *   id: "0",
+ *   name: "John Doe",
+ *   initials: "JD",
+ *   lastIdx: 3,
+ *   clrIdx: 0,
+ * };
+ * // => satisfies PptxCommentAuthor
+ * ```
+ */
+interface PptxCommentAuthor {
+    /** Unique numeric author identifier (`@_id`). */
+    id: string;
+    /** Author display name (`@_name`). */
+    name: string;
+    /** Author initials (`@_initials`). */
+    initials: string;
+    /** Last comment index used by this author (`@_lastIdx`). */
+    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
  * file uses features not fully supported by the editor.
@@ -4448,6 +5141,423 @@ interface PptxCompatibilityWarning {
     elementId?: string;
     xmlPath?: string;
 }
+/**
+ * A single name–value tag from `ppt/tags/*.xml`.
+ *
+ * @example
+ * ```ts
+ * const tag: PptxTag = { name: "CUSTOM_ID", value: "12345" };
+ * // => satisfies PptxTag
+ * ```
+ */
+interface PptxTag {
+    name: string;
+    value: string;
+}
+/**
+ * A collection of tags from a single tags XML part.
+ *
+ * @example
+ * ```ts
+ * const coll: PptxTagCollection = {
+ *   path: "ppt/tags/tag1.xml",
+ *   tags: [{ name: "CUSTOM_ID", value: "12345" }],
+ * };
+ * // => satisfies PptxTagCollection
+ * ```
+ */
+interface PptxTagCollection {
+    /** File path within the PPTX archive. */
+    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`.
+ *
+ * @example
+ * ```ts
+ * const prop: PptxCustomProperty = {
+ *   name: "Project",
+ *   value: "pptx",
+ *   type: "lpwstr",
+ * };
+ * // => satisfies PptxCustomProperty
+ * ```
+ */
+interface PptxCustomProperty {
+    /** Property name. */
+    name: string;
+    /** Property value (always stringified). */
+    value: string;
+    /** Original VT type (e.g. "lpwstr", "i4", "bool", "filetime"). */
+    type: string;
+}
+/**
+ * Core document properties from `docProps/core.xml` (Dublin Core + OOXML).
+ *
+ * @example
+ * ```ts
+ * const core: PptxCoreProperties = {
+ *   title: "Q4 Business Review",
+ *   creator: "Alice",
+ *   created: "2024-01-15T08:00:00Z",
+ *   modified: "2024-06-01T12:30:00Z",
+ *   lastModifiedBy: "Bob",
+ * };
+ * // => satisfies PptxCoreProperties
+ * ```
+ */
+interface PptxCoreProperties {
+    /** dc:title */
+    title?: string;
+    /** dc:subject */
+    subject?: string;
+    /** dc:creator */
+    creator?: string;
+    /** cp:keywords */
+    keywords?: string;
+    /** dc:description */
+    description?: string;
+    /** cp:lastModifiedBy */
+    lastModifiedBy?: string;
+    /** cp:revision */
+    revision?: string;
+    /** dcterms:created (ISO 8601) */
+    created?: string;
+    /** dcterms:modified (ISO 8601) */
+    modified?: string;
+    /** cp:category */
+    category?: string;
+    /** cp:contentStatus */
+    contentStatus?: string;
+}
+/**
+ * Extended (application) properties from `docProps/app.xml`.
+ *
+ * @example
+ * ```ts
+ * const app: PptxAppProperties = {
+ *   application: "Microsoft Office PowerPoint",
+ *   appVersion: "16.0000",
+ *   slides: 24,
+ *   words: 1500,
+ *   company: "Acme Corp",
+ * };
+ * // => satisfies PptxAppProperties
+ * ```
+ */
+interface PptxAppProperties {
+    /** Application name (e.g. "Microsoft Office PowerPoint"). */
+    application?: string;
+    /** Application version string. */
+    appVersion?: string;
+    /** Presentation format (e.g. "On-screen Show (16:9)"). */
+    presentationFormat?: string;
+    /** Total number of slides. */
+    slides?: number;
+    /** Number of hidden slides. */
+    hiddenSlides?: number;
+    /** Number of notes slides. */
+    notes?: number;
+    /** Total editing time in minutes. */
+    totalTime?: number;
+    /** Number of words. */
+    words?: number;
+    /** Number of paragraphs. */
+    paragraphs?: number;
+    /** Company name. */
+    company?: string;
+    /** Manager name. */
+    manager?: string;
+    /** Template name. */
+    template?: string;
+    /** Hyperlink base URL. */
+    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;
+}
+/**
+ * Resolved hex values for the 12 theme colour slots.
+ *
+ * @example
+ * ```ts
+ * const scheme: PptxThemeColorScheme = {
+ *   dk1: "#000000", lt1: "#FFFFFF",
+ *   dk2: "#1F497D", lt2: "#EEECE1",
+ *   accent1: "#4F81BD", accent2: "#C0504D",
+ *   accent3: "#9BBB59", accent4: "#8064A2",
+ *   accent5: "#4BACC6", accent6: "#F79646",
+ *   hlink: "#0000FF", folHlink: "#800080",
+ * };
+ * // => satisfies PptxThemeColorScheme
+ * ```
+ */
+interface PptxThemeColorScheme {
+    dk1: string;
+    lt1: string;
+    dk2: string;
+    lt2: string;
+    accent1: string;
+    accent2: string;
+    accent3: string;
+    accent4: string;
+    accent5: string;
+    accent6: string;
+    hlink: string;
+    folHlink: string;
+}
+/**
+ * A font-family triplet for major or minor theme fonts.
+ *
+ * Supports Latin, East Asian, and Complex Script font families.
+ *
+ * @example
+ * ```ts
+ * const fonts: PptxThemeFontGroup = {
+ *   latin: "Calibri Light",
+ *   eastAsia: "MS PGothic",
+ *   complexScript: "Arial",
+ * };
+ * // => satisfies PptxThemeFontGroup
+ * ```
+ */
+interface PptxThemeFontGroup {
+    latin?: string;
+    eastAsia?: string;
+    complexScript?: string;
+    /**
+     * Per-script typeface overrides (`<a:font script="Hans|Hant|Arab|Hebr|
+     * Thai|Beng|Gujr|Khmr|Knda|…"/>` per ECMA-376 §20.1.4.1.16). Keyed by
+     * the four-letter ISO 15924 script tag from the `script` attribute.
+     *
+     * Phase 4 Stream A / M4.
+     */
+    byScript?: Record<string, string>;
+}
+/**
+ * Theme font scheme — major (headings) and minor (body) font families.
+ *
+ * @example
+ * ```ts
+ * const scheme: PptxThemeFontScheme = {
+ *   majorFont: { latin: "Calibri Light" },
+ *   minorFont: { latin: "Calibri", eastAsia: "MS PGothic" },
+ * };
+ * // => satisfies PptxThemeFontScheme
+ * ```
+ */
+interface PptxThemeFontScheme {
+    majorFont?: PptxThemeFontGroup;
+    minorFont?: PptxThemeFontGroup;
+}
+/**
+ * A single fill style entry from the theme format scheme.
+ * Each entry is one of: solid, gradient, pattern, or no fill.
+ * The raw XML node is also stored so that `phClr` substitution can happen
+ * at resolution time.
+ *
+ * @example
+ * ```ts
+ * const solidFill: PptxThemeFillStyle = {
+ *   kind: "solid",
+ *   color: "#4F81BD",
+ *   opacity: 1,
+ * };
+ *
+ * const gradientFill: PptxThemeFillStyle = {
+ *   kind: "gradient",
+ *   gradientAngle: 90,
+ *   gradientType: "linear",
+ *   gradientStops: [
+ *     { color: "#4F81BD", position: 0 },
+ *     { color: "#1F497D", position: 1 },
+ *   ],
+ * };
+ * // => satisfies PptxThemeFillStyle
+ * ```
+ */
+interface PptxThemeFillStyle {
+    /**
+     * 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;
+    /** Gradient-specific fields (only present when `kind === "gradient"`). */
+    gradientStops?: Array<{
+        color: string;
+        position: number;
+        opacity?: number;
+    }>;
+    gradientAngle?: number;
+    gradientType?: 'linear' | 'radial';
+    gradientCss?: string;
+    /** Pattern-specific fields (only present when `kind === "pattern"`). */
+    patternPreset?: string;
+    patternBackgroundColor?: string;
+    /** Raw XML node preserved for `phClr` re-resolution. */
+    rawNode?: unknown;
+}
+/**
+ * A single line style entry from `a:lnStyleLst`.
+ * Provides width, dash, join, cap, and optional fill colour.
+ *
+ * @example
+ * ```ts
+ * const line: PptxThemeLineStyle = {
+ *   width: 1.5,
+ *   color: "#4F81BD",
+ *   dash: "solid",
+ *   lineJoin: "round",
+ *   lineCap: "flat",
+ * };
+ * // => satisfies PptxThemeLineStyle
+ * ```
+ */
+interface PptxThemeLineStyle {
+    /** Line width in pixels (converted from EMU). */
+    width?: number;
+    color?: string;
+    opacity?: number;
+    dash?: string;
+    lineJoin?: 'round' | 'bevel' | 'miter';
+    lineCap?: 'flat' | 'rnd' | 'sq';
+    compoundLine?: 'sng' | 'dbl' | 'thickThin' | 'thinThick' | 'tri';
+    /** Raw XML node preserved for `phClr` re-resolution. */
+    rawNode?: unknown;
+}
+/**
+ * A single effect style entry from `a:effectStyleLst`.
+ * Each entry may define shadow, glow, soft-edge, reflection, blur,
+ * and optionally a 3-D scene/shape.
+ *
+ * @example
+ * ```ts
+ * const dropShadow: PptxThemeEffectStyle = {
+ *   shadowColor: "#000000",
+ *   shadowBlur: 4,
+ *   shadowOffsetX: 2,
+ *   shadowOffsetY: 3,
+ *   shadowOpacity: 0.4,
+ * };
+ * // => satisfies PptxThemeEffectStyle
+ * ```
+ */
+interface PptxThemeEffectStyle {
+    shadowColor?: string;
+    shadowBlur?: number;
+    shadowOffsetX?: number;
+    shadowOffsetY?: number;
+    shadowOpacity?: number;
+    glowColor?: string;
+    glowRadius?: number;
+    glowOpacity?: number;
+    softEdgeRadius?: number;
+    innerShadowColor?: string;
+    innerShadowOpacity?: number;
+    innerShadowBlur?: number;
+    innerShadowOffsetX?: number;
+    innerShadowOffsetY?: number;
+    reflectionBlurRadius?: number;
+    reflectionStartOpacity?: number;
+    reflectionEndOpacity?: number;
+    reflectionEndPosition?: number;
+    reflectionDirection?: number;
+    reflectionRotation?: number;
+    reflectionDistance?: number;
+    /** 3D scene/camera from `a:scene3d` on the effect style (idx 3 typically). */
+    scene3d?: Pptx3DScene;
+    /** 3D shape extrusion/bevel from `a:sp3d` on the effect style (idx 3 typically). */
+    shape3d?: Pptx3DShape;
+    /** Raw XML node preserved for `phClr` re-resolution. */
+    rawNode?: unknown;
+}
+/**
+ * The full parsed format scheme from `a:fmtScheme` inside `a:themeElements`.
+ * Contains three fill style lists and one line/effect style list each,
+ * at three intensity levels: subtle (idx 1), moderate (idx 2), intense (idx 3).
+ *
+ * OOXML reference indices:
+ * - fillStyleLst:   idx 1-3  (used by `a:fillRef @idx` 1-3)
+ * - lnStyleLst:     idx 1-3  (used by `a:lnRef @idx` 1-3)
+ * - effectStyleLst:  idx 1-3  (used by `a:effectRef @idx` 1-3)
+ * - bgFillStyleLst:  idx 1-3  (used by `a:fillRef @idx` 1001-1003)
+ *
+ * @example
+ * ```ts
+ * const fmt: PptxThemeFormatScheme = {
+ *   name: "Office",
+ *   fillStyles: [solidFill, gradientFill, intenseFill],
+ *   lineStyles: [thinLine, mediumLine, thickLine],
+ *   effectStyles: [subtle, moderate, intense],
+ *   backgroundFillStyles: [solidBg, gradientBg, intenseBg],
+ * };
+ * // => satisfies PptxThemeFormatScheme
+ * ```
+ */
+interface PptxThemeFormatScheme {
+    /** The `@name` attribute of the format scheme. */
+    name?: string;
+    /** Fill styles at indices 1-3 (subtle, moderate, intense). */
+    fillStyles: PptxThemeFillStyle[];
+    /** Line styles at indices 1-3. */
+    lineStyles: PptxThemeLineStyle[];
+    /** Effect styles at indices 1-3. */
+    effectStyles: PptxThemeEffectStyle[];
+    /** Background fill styles at indices 1-3 (referenced via idx 1001-1003). */
+    backgroundFillStyles: PptxThemeFillStyle[];
+}
+/**
+ * Full parsed theme object available to renderers.
+ *
+ * @example
+ * ```ts
+ * const theme: PptxTheme = {
+ *   name: "Office Theme",
+ *   colorScheme: { dk1: "#000", lt1: "#FFF", /* … *\/ },
+ *   fontScheme: {
+ *     majorFont: { latin: "Calibri Light" },
+ *     minorFont: { latin: "Calibri" },
+ *   },
+ * };
+ * // => satisfies PptxTheme
+ * ```
+ */
+interface PptxTheme {
+    /** Theme name from `a:theme @name`. */
+    name?: string;
+    /** Resolved colour scheme. */
+    colorScheme?: PptxThemeColorScheme;
+    /** Resolved font scheme. */
+    fontScheme?: PptxThemeFontScheme;
+    /** Format scheme — fill, line, effect and background fill style matrices. */
+    formatScheme?: PptxThemeFormatScheme;
+}
 
 /**
  * Slide transition types and the {@link PptxSlideTransition} data structure.
@@ -4527,6 +5637,124 @@ interface PptxSlideTransition {
     rawTransition?: XmlObject;
 }
 
+/**
+ * View properties types parsed from `ppt/viewProps.xml`.
+ *
+ * Models the `p:viewPr` element and its child views:
+ * normalViewPr, slideViewPr, outlineViewPr, notesTextViewPr,
+ * sorterViewPr, notesViewPr.
+ *
+ * @module pptx-types/view-properties
+ */
+/**
+ * Scale factor for a view (numerator / denominator percentage).
+ */
+interface PptxViewScale {
+    /** Numerator of the scale percentage (e.g. 100 for 100%). */
+    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).
+ */
+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`.
+ */
+interface PptxRestoredRegion {
+    /** Size as a percentage of the available space (thousandths of a percent). */
+    sz: number;
+    /** Whether auto-adjust is enabled. */
+    autoAdjust?: boolean;
+}
+/**
+ * Normal view properties (`p:normalViewPr`).
+ * Controls the splitter positions in normal (editing) view.
+ */
+interface PptxNormalViewProperties {
+    /** Whether to show outline icons in the slide panel. */
+    showOutlineIcons?: boolean;
+    /** Whether the outline/slide panel is snapped closed. */
+    snapVertSplitter?: boolean;
+    /** Vertical splitter bar state: 'minimized' | 'maximized' | 'restored'. */
+    vertBarState?: string;
+    /** Horizontal splitter bar state. */
+    horzBarState?: string;
+    /** Whether to prefer single-slide view in the panel. */
+    preferSingleView?: boolean;
+    /** Restored left region (slide panel width). */
+    restoredLeft?: PptxRestoredRegion;
+    /** Restored top region (notes panel height). */
+    restoredTop?: PptxRestoredRegion;
+}
+/**
+ * Common slide view properties shared by slideViewPr, outlineViewPr,
+ * notesTextViewPr, and notesViewPr.
+ */
+interface PptxCommonSlideViewProperties {
+    /** Whether snap-to-grid is enabled. */
+    snapToGrid?: boolean;
+    /** Whether snap-to-objects is enabled. */
+    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. */
+    scale?: PptxViewScale;
+}
+/**
+ * Full view properties from `ppt/viewProps.xml`.
+ */
+interface PptxViewProperties {
+    /** Last used view type (`p:viewPr/@lastView`). */
+    lastView?: string;
+    /** Whether comments are shown (`p:viewPr/@showComments`). */
+    showComments?: boolean;
+    /** Normal view properties (splitter positions). */
+    normalViewPr?: PptxNormalViewProperties;
+    /** Slide view properties. */
+    slideViewPr?: PptxCommonSlideViewProperties;
+    /** Outline view properties. */
+    outlineViewPr?: PptxCommonSlideViewProperties;
+    /** Notes text view properties. */
+    notesTextViewPr?: PptxCommonSlideViewProperties;
+    /** Sorter view scale. */
+    sorterViewPr?: {
+        scale?: PptxViewScale;
+    };
+    /** 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>;
+}
+
 /**
  * A customer data reference from `p:custDataLst / p:custData`.
  *
@@ -4537,12 +5765,16 @@ interface PptxSlideTransition {
  * @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`.
@@ -4706,6 +5938,571 @@ interface PptxSlideSyncProperties {
     partPath?: string;
     relationshipId?: string;
 }
+/**
+ * A slide layout available in the loaded presentation.
+ *
+ * Each entry maps to a `<p:sldLayout>` inside `ppt/slideLayouts/`.
+ *
+ * @example
+ * ```ts
+ * const layout: PptxLayoutOption = {
+ *   path: "ppt/slideLayouts/slideLayout2.xml",
+ *   name: "Title and Content",
+ * };
+ * // => satisfies PptxLayoutOption
+ * ```
+ */
+interface PptxLayoutOption {
+    path: string;
+    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.
+ *
+ * Parsed from `ppt/presProps.xml` and individual slide layouts.
+ *
+ * @example
+ * ```ts
+ * const hf: PptxHeaderFooter = {
+ *   hasFooter: true,
+ *   footerText: "Confidential",
+ *   hasSlideNumber: true,
+ * };
+ * // => satisfies PptxHeaderFooter
+ * ```
+ */
+interface PptxHeaderFooter {
+    hasHeader?: boolean;
+    headerText?: string;
+    hasFooter?: boolean;
+    footerText?: string;
+    hasDateTime?: boolean;
+    dateTimeText?: string;
+    dateTimeAuto?: boolean;
+    /** OOXML date format pattern (e.g. "M/d/yyyy", "dddd, MMMM dd, yyyy"). */
+    dateFormat?: string;
+    hasSlideNumber?: boolean;
+}
+/**
+ * Presentation-level properties parsed from `presentationPr.xml`.
+ *
+ * Controls slideshow behaviour, print settings, custom colours, and grid.
+ *
+ * @example
+ * ```ts
+ * const props: PptxPresentationProperties = {
+ *   showType: "presented",
+ *   loopContinuously: false,
+ *   advanceMode: "useTimings",
+ * };
+ * // => satisfies PptxPresentationProperties
+ * ```
+ */
+interface PptxPresentationProperties {
+    /** Show type: presented, browsed, kiosk. */
+    showType?: 'presented' | 'browsed' | 'kiosk';
+    /** Whether to loop the slideshow continuously. */
+    loopContinuously?: boolean;
+    /** Whether to show without narration. */
+    showWithNarration?: boolean;
+    /** Whether to show without animation. */
+    showWithAnimation?: boolean;
+    /** Advance slides mode: manual click or use stored timings. */
+    advanceMode?: 'manual' | 'useTimings';
+    /** Show slides: 'all', a custom show id, or a from-to range. */
+    showSlidesMode?: 'all' | 'customShow' | 'range';
+    /** Custom show id to use when showSlidesMode is 'customShow'. */
+    showSlidesCustomShowId?: string;
+    /** Slide range start (1-based) when showSlidesMode is 'range'. */
+    showSlidesFrom?: number;
+    /** Slide range end (1-based) when showSlidesMode is 'range'. */
+    showSlidesTo?: number;
+    /** Whether to show subtitles/captions during presentation mode. */
+    showSubtitles?: boolean;
+    /** 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;
+    /** @deprecated Use `printProperties.frameSlides`. */
+    printFrameSlides?: boolean;
+    /** @deprecated Use `printProperties.colorMode`. */
+    printColorMode?: 'clr' | 'gray' | 'bw';
+    /** Most-recently-used colours from the presentation palette. */
+    mruColors?: string[];
+    /** Grid spacing in EMUs (cx, cy). Default is 914400 / 8 = 114300. */
+    gridSpacing?: {
+        cx: number;
+        cy: number;
+    };
+    /** Pen colour for presentation mode annotations (from `p:showPr/p:penClr`). */
+    penColor?: string;
+    /** Kiosk auto-restart interval in milliseconds (from `p:kiosk/@restart`). Only meaningful when showType is "kiosk". */
+    kioskRestartTime?: number;
+}
+/**
+ * A named custom slide show (`p:custShowLst / p:custShow`).
+ *
+ * Custom shows define ordered subsets of slides that can be presented
+ * independently of the full deck.
+ *
+ * @example
+ * ```ts
+ * const show: PptxCustomShow = {
+ *   name: "Executive Summary",
+ *   id: "0",
+ *   slideRIds: ["rId2", "rId5", "rId8"],
+ * };
+ * // => satisfies PptxCustomShow
+ * ```
+ */
+interface PptxCustomShow {
+    /** Custom show name. */
+    name: string;
+    /** Custom show id. */
+    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`).
+ *
+ * Sections group consecutive slides under a named heading (visible
+ * in the PowerPoint slide sorter).
+ *
+ * @example
+ * ```ts
+ * const section: PptxSection = {
+ *   id: "sec_1",
+ *   name: "Introduction",
+ *   slideIds: ["256", "257"],
+ * };
+ * // => satisfies PptxSection
+ * ```
+ */
+interface PptxSection {
+    /** Section unique identifier (GUID or synthetic). */
+    id: string;
+    /** Human-readable section name. */
+    name: string;
+    /** Ordered list of numeric slide IDs that belong to this section. */
+    slideIds: string[];
+    /** Whether the section is collapsed in the slide sorter (from p15:sectionPr). */
+    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`.
+ *
+ * When present, the presentation is marked as "read-only recommended" or
+ * write-protected with a password hash.  The hash parameters follow the
+ * ECMA-376 Part 1, section 19.2.1.22 specification.
+ *
+ * @example
+ * ```ts
+ * const verifier: PptxModifyVerifier = {
+ *   algorithmName: "SHA-512",
+ *   hashData: "base64EncodedHash==",
+ *   saltData: "base64EncodedSalt==",
+ *   spinValue: 100000,
+ * };
+ * // => satisfies PptxModifyVerifier
+ * ```
+ */
+interface PptxModifyVerifier {
+    /** Hash algorithm name (e.g. "SHA-512", "SHA-1"). */
+    algorithmName?: string;
+    /** Base64-encoded hash value. */
+    hashData?: string;
+    /** Base64-encoded salt value. */
+    saltData?: string;
+    /** Number of hash iterations (spin count). */
+    spinValue?: number;
+    /** Legacy algorithm ID extension. */
+    algIdExt?: string;
+    /** Legacy algorithm ID. */
+    cryptAlgorithmSid?: number;
+    /** Cryptographic algorithm type (e.g. "typeAny"). */
+    cryptAlgorithmType?: string;
+    /** Cryptographic provider name. */
+    cryptProvider?: string;
+    /** Cryptographic provider type (e.g. "providerTypeRsaFull"). */
+    cryptProviderType?: string;
+    /** Cryptographic algorithm class (e.g. "hash"). */
+    cryptAlgorithmClass?: string;
+}
+/**
+ * Photo album metadata from `p:photoAlbum` in `presentation.xml`.
+ *
+ * Stores settings for presentations created via Insert > Photo Album.
+ *
+ * @see ECMA-376 Part 1, §19.2.1.27
+ */
+interface PptxPhotoAlbum {
+    /** Whether photos are displayed in black-and-white. */
+    bw?: boolean;
+    /** Whether captions are shown below each photo. */
+    showCaptions?: boolean;
+    /** Photo album layout (e.g. "1pic", "2pic", "4pic", "fitToSlide"). */
+    layout?: string;
+    /** Frame style applied to each photo (e.g. "frameStyle1"). */
+    frame?: string;
+}
+/**
+ * East Asian line-break (kinsoku) settings from `p:kinsoku` in `presentation.xml`.
+ *
+ * Defines forbidden start/end characters for a given language so that
+ * line-breaking follows East Asian typographic rules.
+ *
+ * @see ECMA-376 Part 1, §19.2.1.17
+ */
+interface PptxKinsoku {
+    /** Language code (e.g. "ja-JP", "zh-CN"). */
+    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}.
+ *
+ * Contains every slide, canvas dimensions, theme data, layout options,
+ * metadata, and optional features (custom shows, sections, macros,
+ * digital signatures, embedded fonts).
+ *
+ * @example
+ * ```ts
+ * const data: PptxData = await handler.load(buffer);
+ * console.log(`${data.slides.length} slides, ${data.width}×${data.height}`);
+ * // => e.g. "24 slides, 960×540"
+ * ```
+ */
+interface PptxData {
+    slides: PptxSlide[];
+    width: number;
+    height: number;
+    /** Slide width in EMU (for save round-trip). */
+    widthEmu?: number;
+    /** Slide height in EMU (for save round-trip). */
+    heightEmu?: number;
+    /** Slide size type from `p:sldSz/@type` (e.g. "screen4x3", "screen16x9", "custom"). */
+    slideSizeType?: string;
+    /** Notes page width in EMU (from `p:notesSz`). */
+    notesWidthEmu?: number;
+    /** Notes page height in EMU (from `p:notesSz`). */
+    notesHeightEmu?: number;
+    layoutOptions?: PptxLayoutOption[];
+    headerFooter?: PptxHeaderFooter;
+    /** Presentation-level properties parsed from `presentationPr.xml`. */
+    presentationProperties?: PptxPresentationProperties;
+    /** Named custom slide shows from `p:custShowLst`. */
+    customShows?: PptxCustomShow[];
+    /** Ordered presentation sections from `p:sectionLst` / `p14:sectionLst`. */
+    sections?: PptxSection[];
+    warnings?: PptxCompatibilityWarning[];
+    /** Map of theme colour scheme keys to resolved hex values. */
+    themeColorMap?: Record<string, string>;
+    /** Full parsed theme object with colours, fonts, and name. */
+    theme?: PptxTheme;
+    /** Available theme parts discovered in `ppt/theme/`. */
+    themeOptions?: PptxThemeOption[];
+    /** Parsed table style definitions from `ppt/tableStyles.xml`. */
+    tableStyleMap?: ParsedTableStyleMap;
+    /** Whether the presentation is password-protected. */
+    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. */
+    notesMaster?: PptxNotesMaster;
+    /** Parsed handout master data if present in the PPTX. */
+    handoutMaster?: PptxHandoutMaster;
+    /** Structured slide master data for each master in the presentation. */
+    slideMasters?: PptxSlideMaster[];
+    /** Parsed tag collections attached to the presentation or slides. */
+    tags?: PptxTagCollection[];
+    /** Custom document properties from `docProps/custom.xml`. */
+    customProperties?: PptxCustomProperty[];
+    /** Core document properties from `docProps/core.xml`. */
+    coreProperties?: PptxCoreProperties;
+    /** Extended (application) properties from `docProps/app.xml`. */
+    appProperties?: PptxAppProperties;
+    /** Whether the presentation contains VBA macros (is a .pptm file). */
+    hasMacros?: boolean;
+    /** Whether the presentation contains digital signatures (`_xmlsignatures/` parts). */
+    hasDigitalSignatures?: boolean;
+    /** Number of digital signatures found. */
+    digitalSignatureCount?: number;
+    /** Presentation-level drawing guides from `p:extLst`. */
+    presentationGuides?: PptxDrawingGuide[];
+    /** View properties from `ppt/viewProps.xml`. */
+    viewProperties?: PptxViewProperties;
+    /** Write-protection verifier from `p:modifyVerifier` in `presentation.xml`. */
+    modifyVerifier?: PptxModifyVerifier;
+    /** Photo album metadata from `p:photoAlbum` in `presentation.xml`. */
+    photoAlbum?: PptxPhotoAlbum;
+    /** East Asian line-break settings from `p:kinsoku` in `presentation.xml`. */
+    kinsoku?: PptxKinsoku;
+    /** Custom XML data parts from `customXml/` in the OPC package. */
+    customXmlParts?: PptxCustomXmlPart[];
+    /** Customer data references from `p:custDataLst` in `presentation.xml`. */
+    customerData?: PptxCustomerData[];
+    /** Thumbnail image binary data from `docProps/thumbnail.{jpeg,png}`. */
+    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)
+     * - `'transitional'` -- ECMA-376 Transitional (uses `schemas.openxmlformats.org` URIs)
+     *
+     * When saving, if the save option `conformance` is `'preserve'` (default),
+     * the file will be saved using the same conformance class as the original.
+     */
+    conformance?: 'strict' | 'transitional';
+}
+/**
+ * Embedded font data extracted from a PPTX file.
+ *
+ * Used to register `@font-face` rules so the renderer can display
+ * the correct typeface even when the system font is missing.
+ *
+ * @example
+ * ```ts
+ * const font: PptxEmbeddedFont = {
+ *   name: "CustomSans",
+ *   dataUrl: "data:font/truetype;base64,AAEAK...",
+ *   format: "truetype",
+ * };
+ * // => satisfies PptxEmbeddedFont
+ * ```
+ */
+/**
+ * A single Custom XML Data Part stored in `customXml/` within the OPC package.
+ *
+ * These parts are used by add-ins, data-binding, and enterprise templates
+ * to store structured data alongside the presentation.
+ *
+ * @see ECMA-376 Part 1, §15.2.5
+ */
+interface PptxCustomXmlPart {
+    /** Item number (e.g. "1" for `customXml/item1.xml`). */
+    id: string;
+    /** Raw XML string content of the custom XML item. */
+    data: string;
+    /** Schema target namespace URI from `itemProps` (ds:schemaRef/@ds:uri). */
+    schemaUri?: string;
+    /** Raw XML string content of the associated `itemProps` file. */
+    properties?: string;
+    /** Raw XML string content of the OPC relationship file (`customXml/_rels/item{id}.xml.rels`). */
+    rels?: string;
+}
+interface PptxEmbeddedFont {
+    name: string;
+    dataUrl: string;
+    bold?: boolean;
+    italic?: boolean;
+    /** CSS font format hint (e.g. "truetype", "opentype"). */
+    format?: 'truetype' | 'opentype' | 'woff' | 'woff2';
+    /**
+     * Deobfuscated (clear-text) font binary data preserved from load
+     * for round-trip re-embedding on save. When present, the save
+     * pipeline will re-obfuscate and write this data back into the ZIP.
+     */
+    rawFontData?: Uint8Array;
+    /**
+     * Original ZIP path of the font part (e.g. `ppt/fonts/{GUID}.fntdata`).
+     * Preserved from load for round-trip.
+     */
+    partPath?: string;
+    /**
+     * The GUID used for obfuscation, either from the `fontKey` attribute
+     * or extracted from the part path. Preserved from load for round-trip.
+     */
+    fontGuid?: string;
+    /**
+     * Relationship ID (e.g. `rId21`) of the font part in
+     * `ppt/_rels/presentation.xml.rels`. Preserved from load so the save
+     * pipeline can reuse the original part/rel instead of minting a new
+     * GUID-named copy alongside the stale original.
+     */
+    originalRId?: string;
+    /**
+     * Raw bytes of the original obfuscated font part exactly as they were
+     * stored in the source ZIP. When the loader could not determine a
+     * usable GUID (e.g. EOT extraction path), the save pipeline preserves
+     * these bytes verbatim under the original path/rel.
+     */
+    originalPartBytes?: Uint8Array;
+}
+
+/**
+ * Headless SVG exporter — converts parsed {@link PptxSlide} data to
+ * SVG XML strings without requiring a browser DOM.
+ *
+ * All output is generated via string concatenation so the exporter
+ * works in any JavaScript runtime (Node, Bun, Deno, Workers, etc.).
+ *
+ * @module converter/SvgExporter
+ */
+
+/**
+ * Options controlling SVG export behaviour.
+ */
+interface SvgExportOptions {
+    /** Include hidden slides when exporting all. Default `false`. */
+    includeHidden?: boolean;
+    /** Slide indices to export (0-based). If omitted, all slides are exported. */
+    slideIndices?: number[];
+    /** Default font family when the element does not specify one. */
+    defaultFontFamily?: string;
+    /** Default font size in points when the element does not specify one. */
+    defaultFontSize?: number;
+}
+
+/** Output format for the save pipeline. */
+type PptxSaveFormat = 'pptx' | 'ppsx' | 'pptm';
+
+/**
+ * Theme configuration types for the PowerPoint viewer.
+ *
+ * All color values accept any valid CSS color string:
+ * hex (`#6366f1`), rgb (`rgb(99 102 241)`), hsl (`hsl(239 84% 67%)`),
+ * oklch (`oklch(0.585 0.233 277)`), named colors, etc.
+ *
+ * Framework-agnostic — shared by the React, Vue, and Angular bindings.
+ */
+/**
+ * Semantic color tokens for the viewer UI.
+ *
+ * These map to CSS custom properties (`--pptx-<token>`) and drive all
+ * UI component colors. The naming follows the shadcn/ui convention so
+ * that Tailwind + shadcn users get a familiar experience.
+ */
+interface ViewerThemeColors {
+    /** Page / root background */
+    background: string;
+    /** Default text color */
+    foreground: string;
+    /** Card / panel surface */
+    card: string;
+    /** Text on card surfaces */
+    cardForeground: string;
+    /** Popover / dropdown surface */
+    popover: string;
+    /** Text inside popovers */
+    popoverForeground: string;
+    /** Primary action color (buttons, active indicators) */
+    primary: string;
+    /** Text on primary-colored backgrounds */
+    primaryForeground: string;
+    /** Secondary / subdued action color */
+    secondary: string;
+    /** Text on secondary backgrounds */
+    secondaryForeground: string;
+    /** Muted / disabled surface */
+    muted: string;
+    /** Text on muted surfaces (also used for secondary text) */
+    mutedForeground: string;
+    /** Accent / hover-highlight surface */
+    accent: string;
+    /** Text on accent surfaces */
+    accentForeground: string;
+    /** Destructive / danger action color */
+    destructive: string;
+    /** Text on destructive backgrounds */
+    destructiveForeground: string;
+    /** Default border color */
+    border: string;
+    /** Input field border color */
+    input: string;
+    /** Focus ring color */
+    ring: string;
+}
+/**
+ * Full viewer theme configuration.
+ *
+ * Every property is optional — unset values fall back to the built-in
+ * dark theme defaults.
+ */
+interface ViewerTheme {
+    /** Semantic UI colors. Each key maps to a `--pptx-<key>` CSS custom property. */
+    colors?: Partial<ViewerThemeColors>;
+    /** Base border-radius value (e.g. `"0.5rem"`, `"8px"`). */
+    radius?: string;
+    /**
+     * Escape hatch: arbitrary CSS custom properties to set on the viewer
+     * root element. Keys should include the `--` prefix.
+     *
+     * @example
+     * ```ts
+     * { "--my-custom-shadow": "0 4px 12px rgba(0,0,0,0.5)" }
+     * ```
+     */
+    cssVars?: Record<string, string>;
+}
+
+/**
+ * Default dark-theme color values.
+ *
+ * These correspond to the built-in dark UI of the PowerPoint viewer and
+ * use Tailwind's gray palette as the neutral scale with indigo as the
+ * primary accent.
+ */
+declare const defaultThemeColors: ViewerThemeColors;
+/** Default border-radius. */
+declare const defaultRadius = "0.5rem";
+
+/**
+ * Convert a `ViewerTheme` into a flat `Record<string, string>` of CSS
+ * custom properties (including the `--` prefix) ready to be spread onto
+ * a `style` attribute.
+ *
+ * Only properties that differ from the built-in defaults are emitted when
+ * `omitDefaults` is true (the default).
+ */
+declare function themeToCssVars(theme: ViewerTheme | undefined, omitDefaults?: boolean): Record<string, string>;
+/**
+ * Build the complete set of CSS custom properties with all defaults.
+ * Useful for generating a full fallback stylesheet.
+ */
+declare function defaultCssVars(): Record<string, string>;
+
+/**
+ * Built-in "vermilion" theme presets.
+ *
+ * These mirror the pptx-viewer brand used on the documentation site:
+ * a warm paper canvas in light mode, a dimmed presenter room in dark
+ * mode, and the vermilion accent in both. Pass one to the viewer's
+ * `theme` prop (React/Vue) or `provideViewerTheme` (Angular), or spread
+ * the color objects to derive your own variant.
+ */
+/** Light "paper" palette: a projection screen in a bright room. */
+declare const vermilionLightColors: ViewerThemeColors;
+/** Dark "presenter" palette: the presenter room with the lights down. */
+declare const vermilionDarkColors: ViewerThemeColors;
+/** Shared border-radius for the vermilion presets (slightly sharper than the default). */
+declare const vermilionRadius = "0.375rem";
+/** Light vermilion theme, ready for the viewer's `theme` prop. */
+declare const vermilionLightTheme: ViewerTheme;
+/** Dark vermilion theme, ready for the viewer's `theme` prop. */
+declare const vermilionDarkTheme: ViewerTheme;
 
 /**
  * Framework-agnostic public types shared by the viewer bindings.
@@ -5002,8 +6799,9 @@ interface ExportGifOptions {
  * settings, `computeSlideIndices` / `computeColorFilter` resolve the range and
  * colour mode, the `build*Html` helpers produce the escaped body markup, and
  * `buildPrintHtmlDocument` sanitises + assembles the final document. This
- * module (the Svelte counterpart of Vue's `usePrint`) only rasterises the
- * selected slides and opens the print surface.
+ * module (the Svelte counterpart of Vue's `usePrint`) exports direct slide
+ * pages as vector SVG, rasterises notes/handout thumbnails, and opens the
+ * print surface.
  *
  * **Print surface / popup-blocker caveats:** the default opener renders the
  * document into a hidden same-origin `<iframe srcdoc>` and calls
@@ -5077,6 +6875,19 @@ type Translator = (key: string, params?: Record<string, string | number>) => str
  */
 declare function registerTranslations(locale: string, dictionary: TranslationDictionary): void;
 
+type SvgExportSingleSlideOptions = SvgExportOptions;
+type SvgExportAllOptions = SvgExportOptions;
+/** Export one parsed slide as self-contained SVG markup. */
+declare function exportSlideToSvg(slide: PptxSlide, width: number, height: number, options?: SvgExportSingleSlideOptions): string;
+/** Export one parsed slide as an SVG Blob. */
+declare function exportSlideToSvgBlob(slide: PptxSlide, width: number, height: number, options?: SvgExportSingleSlideOptions): Blob;
+/** Export one parsed slide as an SVG download. */
+declare function exportSlideAsSvg(slide: PptxSlide, slideIndex: number, width: number, height: number, options?: SvgExportSingleSlideOptions): void;
+/** Export the selected presentation slides as SVG strings. */
+declare function exportAllSlidesToSvg(data: PptxData, options?: SvgExportAllOptions): string[];
+/** Export the selected presentation slides as SVG Blobs. */
+declare function exportAllSlidesToSvgBlobs(data: PptxData, options?: SvgExportAllOptions): Blob[];
+
 /** Payload for the `onload` callback. */
 interface ViewerLoadDetail {
     /** Number of slides in the loaded presentation. */
@@ -5224,7 +7035,9 @@ interface PowerPointViewerApi extends PowerPointViewerAPI {
     /** The selected top-level element id, or null. */
     getSelectedElementId(): string | null;
     /** Serialize the edited slides to `.pptx` bytes via the core handler. */
-    save(): Promise<Uint8Array>;
+    save(format?: PptxSaveFormat): Promise<Uint8Array>;
+    downloadAs(format: PptxSaveFormat, fileName?: string): Promise<void>;
+    packageForSharing(fileName?: string): Promise<void>;
     /** Save + trigger a browser download of the `.pptx` (default name). */
     downloadPptx(fileName?: string): Promise<void>;
     /**
@@ -5233,6 +7046,8 @@ interface PowerPointViewerApi extends PowerPointViewerAPI {
      * (dynamically imported), so the first call pays a one-time load cost.
      */
     exportSlidePng(index?: number): Promise<void>;
+    /** Copy a slide to the system clipboard as a PNG image. */
+    copySlideAsImage(index?: number): Promise<void>;
     /**
      * Export every slide as a multi-page PDF download (one slide per page).
      * `jspdf` is dynamically imported on first use.
@@ -5303,5 +7118,5 @@ declare const PowerPointViewer: Component<PowerPointViewerProps, PowerPointViewe
  */
 type AutosaveStatus = 'idle' | 'disabled' | 'saving' | 'saved' | 'error';
 
-export { PowerPointViewer, defaultCssVars, defaultRadius, defaultThemeColors, deleteAutosaveSnapshot, getAutosaveSnapshot, listAutosaveSnapshots, loadPresentationDeck, parsePresentationSessionId, registerTranslations, themeToCssVars, vermilionDarkColors, vermilionDarkTheme, vermilionLightColors, vermilionLightTheme, vermilionRadius };
-export type { AutosaveRecord, AutosaveStatus, CanvasSize, CollaborationConfig, CollaborationRole, CollaborationTransport, ExportGifOptions, ExportPdfOptions, ExportVideoOptions, PowerPointViewerApi, PowerPointViewerProps, PrintOptions, TranslationDictionary, Translator, ViewerLoadDetail, ViewerTheme, ViewerThemeColors };
+export { PowerPointViewer, defaultCssVars, defaultRadius, defaultThemeColors, deleteAutosaveSnapshot, exportAllSlidesToSvg, exportAllSlidesToSvgBlobs, exportSlideAsSvg, exportSlideToSvg, exportSlideToSvgBlob, getAutosaveSnapshot, listAutosaveSnapshots, loadPresentationDeck, parsePresentationSessionId, registerTranslations, themeToCssVars, vermilionDarkColors, vermilionDarkTheme, vermilionLightColors, vermilionLightTheme, vermilionRadius };
+export type { AutosaveRecord, AutosaveStatus, CanvasSize, CollaborationConfig, CollaborationRole, CollaborationTransport, ExportGifOptions, ExportPdfOptions, ExportVideoOptions, PowerPointViewerApi, PowerPointViewerProps, PrintOptions, SvgExportAllOptions, SvgExportSingleSlideOptions, TranslationDictionary, Translator, ViewerLoadDetail, ViewerTheme, ViewerThemeColors };