pptx-svelte-viewer 0.8.0 → 0.9.0

package/dist/viewer/index.d.ts

@@ -1,84 +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>;
-}
-
 /**
  * Action types: hyperlinks, slide jumps, macros, and action buttons.
  *
@@ -436,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). */
@@ -576,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`.
@@ -787,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.
  *
@@ -1019,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`. */
@@ -1135,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. */
@@ -1877,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`.
@@ -2037,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;
 }
@@ -2047,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';
@@ -2089,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;
@@ -2106,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;
     /**
@@ -2129,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.
  *
@@ -2170,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
@@ -2375,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}.
@@ -2398,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;
@@ -2434,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.
@@ -2462,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).
      *
@@ -2487,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;
     /**
@@ -2505,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
@@ -2516,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;
@@ -2549,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';
@@ -2588,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;
@@ -2602,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). */
@@ -2612,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.
@@ -2620,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.
@@ -2632,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
@@ -2779,6 +2929,7 @@ declare module "./index" {
  *
  * @module pptx-types/media
  */
+
 /**
  * Discriminator for embedded media element types.
  *
@@ -2793,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.
@@ -2870,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;
@@ -2879,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. */
@@ -2896,6 +3125,8 @@ interface PptxSmartArtLayoutDefinition {
     descriptions?: PptxSmartArtLocalizedText[];
     categories?: PptxSmartArtLayoutCategory[];
     rootNode: PptxSmartArtLayoutNode;
+    /** Original definition retained for constraint evaluation and foreign rules. */
+    rawXml?: XmlObject;
 }
 
 /**
@@ -2907,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,
@@ -2930,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.
@@ -2999,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
@@ -3162,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"). */
@@ -3186,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). */
@@ -3883,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;
@@ -4006,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).
@@ -4026,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
@@ -4673,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.
@@ -4828,9 +5168,17 @@ interface PptxTag {
  */
 interface PptxTagCollection {
     /** File path within the PPTX archive. */
-    path: string;
+    path?: string;
+    /** Package owner of the tags relationship. New collections default to presentation. */
+    owner?: 'presentation' | 'slide' | 'part';
+    /** Source OPC part that owns the relationship, e.g. ppt/slides/slide1.xml. */
+    sourcePartPath?: string;
+    /** Durable relationship identifier from the owning part. */
+    relationshipId?: string;
     /** Tags in this collection. */
     tags: PptxTag[];
+    /** Parsed tag-list XML retained for unknown-node preservation. */
+    rawXml?: XmlObject;
 }
 /**
  * A custom document property from `docProps/custom.xml`.
@@ -4935,6 +5283,19 @@ interface PptxAppProperties {
     /** 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.
  *
@@ -5293,6 +5654,11 @@ interface PptxViewScale {
     n: number;
     /** Denominator of the scale percentage (e.g. 100 for 100%). */
     d: number;
+    /** Optional independent vertical scale. When absent, the X scale is used. */
+    sy?: {
+        n: number;
+        d: number;
+    };
 }
 /**
  * Origin point for a view (x, y in twips or EMU).
@@ -5301,6 +5667,16 @@ interface PptxViewOrigin {
     x: number;
     y: number;
 }
+/** A horizontal or vertical drawing guide in slide coordinates. */
+interface PptxViewGuide {
+    orientation?: 'horz' | 'vert';
+    position?: number;
+}
+/** Positive grid spacing from `p:gridSpacing`. */
+interface PptxGridSpacing {
+    cx: number;
+    cy: number;
+}
 /**
  * Restored region dimensions for normal view splitter.
  * Represents `p:restoredLeft` or `p:restoredTop`.
@@ -5342,6 +5718,10 @@ interface PptxCommonSlideViewProperties {
     snapToObjects?: boolean;
     /** Whether drawing guides are shown. */
     showGuides?: boolean;
+    /** Whether the application may vary the scale automatically. */
+    variableScale?: boolean;
+    /** Drawing guides shown in this slide view. */
+    guides?: PptxViewGuide[];
     /** View origin (scroll position). */
     origin?: PptxViewOrigin;
     /** View scale. */
@@ -5369,6 +5749,8 @@ interface PptxViewProperties {
     };
     /** Notes view properties. */
     notesViewPr?: PptxCommonSlideViewProperties;
+    /** Grid spacing in positive DrawingML coordinates. */
+    gridSpacing?: PptxGridSpacing;
     /** Raw XML preserved for lossless round-trip of unparsed attributes. */
     rawXml?: Record<string, unknown>;
 }
@@ -5383,12 +5765,16 @@ interface PptxViewProperties {
  * @see ECMA-376 Part 1, §19.2.1.3 (custDataLst), §19.3.1.6 (custData)
  */
 interface PptxCustomerData {
-    /** Resolved part path inside the package (e.g. `ppt/customerData/item1.xml`). */
-    id: string;
+    /** Resolved part path inside the package (e.g. `customXml/item1.xml`). */
+    id?: string;
     /** Relationship ID referencing the custom data part. */
-    relId: string;
+    relId?: string;
     /** Raw string content of the custom data part (if resolvable). */
     data?: string;
+    /** OPC content type for the custom data part. */
+    contentType?: string;
+    /** Raw `p:custData` XML retained for unknown-node preservation. */
+    rawXml?: XmlObject;
 }
 /**
  * An ActiveX control reference from `p:controls / p:control`.
@@ -5637,11 +6023,13 @@ interface PptxPresentationProperties {
     showSlidesTo?: number;
     /** Whether to show subtitles/captions during presentation mode. */
     showSubtitles?: boolean;
-    /** Print settings: slides per page. */
+    /** Typed `p:prnPr` settings. Set to null during save to remove the element. */
+    printProperties?: PptxPresentationPrintProperties | null;
+    /** @deprecated Use `printProperties.printWhat`; retained as a handout compatibility alias. */
     printSlidesPerPage?: number;
-    /** Print settings: frame slides. */
+    /** @deprecated Use `printProperties.frameSlides`. */
     printFrameSlides?: boolean;
-    /** Print settings: colour mode (from `p:prnPr/@clrMode`). */
+    /** @deprecated Use `printProperties.colorMode`. */
     printColorMode?: 'clr' | 'gray' | 'bw';
     /** Most-recently-used colours from the presentation palette. */
     mruColors?: string[];
@@ -5778,11 +6166,13 @@ interface PptxPhotoAlbum {
  */
 interface PptxKinsoku {
     /** Language code (e.g. "ja-JP", "zh-CN"). */
-    lang?: string;
+    lang?: string | null;
     /** Characters that cannot begin a line. */
     invalStChars?: string;
     /** Characters that cannot end a line. */
     invalEndChars?: string;
+    /** Original leaf retained for unknown attribute preservation. */
+    rawXml?: XmlObject;
 }
 /**
  * Root data structure returned by {@link PptxHandlerCore.load}.
@@ -5833,6 +6223,8 @@ interface PptxData {
     isPasswordProtected?: boolean;
     /** Embedded font data (name + binary data URL) extracted from the presentation. */
     embeddedFonts?: PptxEmbeddedFont[];
+    /** Typed `p:embeddedFontLst` package metadata, including unresolved variants. */
+    embeddedFontList?: PptxEmbeddedFontList;
     /** Most-recently-used colour list from presentation properties. */
     mruColors?: string[];
     /** Parsed notes master data if present in the PPTX. */
@@ -5991,6 +6383,30 @@ interface PptxEmbeddedFont {
     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;
+}
+
 /**
  * Built-in theme presets modelled after common PowerPoint themes.
  *
@@ -6167,10 +6583,17 @@ interface ChartSeriesInput {
     name: string;
     values: number[];
     color?: string;
+    boxWhiskerOptions?: PptxChartBoxWhiskerOptions;
+    histogramOptions?: PptxChartHistogramOptions;
+    waterfallOptions?: PptxChartWaterfallOptions;
+    regionMapOptions?: PptxChartRegionMapOptions;
+    treemapOptions?: PptxChartTreemapOptions;
 }
 interface ChartInput {
     series: ChartSeriesInput[];
     categories: string[];
+    /** ChartEx hierarchy levels in leaf-to-root XML order. */
+    categoryLevels?: string[][];
     title?: string;
     hasLegend?: boolean;
     legendPosition?: 't' | 'b' | 'l' | 'r' | 'tr';
@@ -6684,10 +7107,12 @@ interface PptxHandlerSaveOptions {
     slideLayouts?: PptxSlideLayout[];
     /** Updated tag collections to save back to ppt/tags/tag*.xml. */
     tags?: PptxTagCollection[];
+    /** Presentation-level customer data references to author or update. */
+    customerData?: PptxCustomerData[];
     /** Photo album metadata to save back to `p:photoAlbum`. */
     photoAlbum?: PptxPhotoAlbum;
     /** East Asian line-break settings to save back to `p:kinsoku`. */
-    kinsoku?: PptxKinsoku;
+    kinsoku?: PptxKinsoku | null;
     /** Write-protection verifier. Set to `null` to remove, `undefined` to preserve existing. */
     modifyVerifier?: PptxModifyVerifier | null;
     /** View properties to save back to ppt/viewProps.xml. */
@@ -6719,6 +7144,8 @@ interface PptxHandlerSaveOptions {
      * preserved (i.e. the default is lossless round-trip).
      */
     embeddedFonts?: PptxEmbeddedFont[];
+    /** Typed embedded-font list metadata. Set to null to remove fonts and relationships. */
+    embeddedFontList?: PptxEmbeddedFontList | null;
     /**
      * OOXML conformance class for the saved output.
      * - `'preserve'` (default): use the same conformance as the loaded file.
@@ -7342,6 +7769,85 @@ declare class PptxHandler extends PptxHandlerCore {
     static create(options?: PresentationOptions): Promise<PresentationBuilderResult>;
 }
 
+/**
+ * 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>;
+}
+
 /**
  * Framework-agnostic public types shared by the viewer bindings.
  *
@@ -7611,8 +8117,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
@@ -7666,6 +8173,19 @@ interface ExportPdfOptions {
     signal?: AbortSignal;
 }
 
+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. */
@@ -7813,7 +8333,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>;
     /**
@@ -7822,6 +8344,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.
@@ -7904,6 +8428,19 @@ declare class PresentationLoader {
     slideMasters: PptxSlideMaster[];
     notesMaster: PptxNotesMaster | undefined;
     handoutMaster: PptxHandoutMaster | undefined;
+    sections: PptxSection[];
+    headerFooter: PptxHeaderFooter;
+    presentationProperties: PptxPresentationProperties;
+    customShows: PptxCustomShow[];
+    coreProperties: PptxCoreProperties | undefined;
+    appProperties: PptxAppProperties | undefined;
+    customProperties: PptxCustomProperty[];
+    embeddedFonts: PptxEmbeddedFont[];
+    hasDigitalSignatures: boolean;
+    digitalSignatureCount: number;
+    isPasswordProtected: boolean;
+    /** Whether the loaded package contains a VBA project. */
+    hasMacros: boolean;
     notesCanvasSize: CanvasSize | undefined;
     /** Slide canvas size in pixels. */
     canvasSize: CanvasSize;
@@ -7911,6 +8448,7 @@ declare class PresentationLoader {
     mediaDataUrls: Map<string, string>;
     /** Presentation theme colours used to resolve scheme-based table styles. */
     colorScheme: PptxThemeColorScheme | undefined;
+    presentationTheme: PptxTheme | undefined;
     /** Parsed presentation table-style definitions keyed by style id. */
     tableStyleMap: ParsedTableStyleMap | undefined;
     /** True while a load is in flight. */
@@ -7965,5 +8503,5 @@ declare class ViewerState {
     handleNavigationKey(key: string): boolean;
 }
 
-export { PowerPointViewer, PresentationLoader, ViewerState, clampSlideIndex, fitScale, resolveNavigationKey, zoomInPercent, zoomOutPercent };
-export type { CanvasSize, ExportGifOptions, ExportPdfOptions, ExportVideoOptions, NavigationAction, PowerPointViewerApi, PowerPointViewerProps, PrintOptions, ViewerLoadDetail, ViewerTheme };
+export { PowerPointViewer, PresentationLoader, ViewerState, clampSlideIndex, exportAllSlidesToSvg, exportAllSlidesToSvgBlobs, exportSlideAsSvg, exportSlideToSvg, exportSlideToSvgBlob, fitScale, resolveNavigationKey, zoomInPercent, zoomOutPercent };
+export type { CanvasSize, ExportGifOptions, ExportPdfOptions, ExportVideoOptions, NavigationAction, PowerPointViewerApi, PowerPointViewerProps, PrintOptions, SvgExportAllOptions, SvgExportSingleSlideOptions, ViewerLoadDetail, ViewerTheme };