ooxml-core 1.14.0 → 1.16.0

package/dist/pptx/chunks/{index-DS9Y4Ne3.d.ts → index-BWHNCVNC.d.ts}

@@ -1,8 +1,8 @@
 import { D as StrokeDashType, S as ConnectorArrowType, T as PptxShapeLocks, i as TextStyle, k as XmlObject, r as TextSegment, t as BulletInfo } from "./text-D49FKllA.js";
 import { t as PptxThemeColorRef } from "./color-ref-DT599vEx.js";
-import { $ as ParsedTableStyleFill, $t as PptxChartSeries, Bn as ShapeStyle, Bt as PptxChartGradientFill, C as SmartArtPptxElement, Dt as PptxChartDataLabel, Et as PptxChartData, F as PlaceholderTextLevelStyle, Fn as PptxImageEffects, H as PptxAction, Jt as PptxChartMarkerSymbol, Ln as PptxImageProperties, Lt as PptxChartErrBars, O as ZoomPptxElement, Ot as PptxChartDataLabelOptions, P as PlaceholderDefaults, T as TablePptxElement, Tt as PptxChartChrome, U as MediaBookmark, Vt as PptxChartHistogramOptions, Y as ParsedTableBackground, Yt as PptxChartOfPieOptions, Z as ParsedTableStyleBorders, Zt as PptxChartRegionMapOptions, _ as PptxElementWithText, a as GroupPptxElement, at as ParsedTableStyleText, bt as PptxChartAxisFormatting, c as MediaPptxElement, cn as PptxChartView3D, ct as PptxTableCellParagraph, d as OlePptxElement, dn as PptxEmbeddedWorkbookData, dt as PptxTableData, en as PptxChartShapeProps, fn as PptxExternalData, i as ContentPartPptxElement, l as Model3DPptxElement, ln as PptxChartWaterfallOptions, lt as PptxTableCellStyle, m as PptxElement, n as ConnectorPptxElement, nn as PptxChartTreemapOptions, on as PptxChartType, pn as PptxChartUserShape, q as PptxMediaReferenceKind, qt as PptxChartMarker, rn as PptxChartTrendline, rt as ParsedTableStyleMap, s as InkPptxElement, t as ChartPptxElement, tn as PptxChartStyle, vn as ResolvedChartStyleDefinition, wt as PptxChartBoxWhiskerOptions, y as PptxImageLikeElement, zn as ResolvedStyleMatrix } from "./elements-tK7xnWeS.js";
+import { $ as ParsedTableStyleFill, $n as PptxImageEffects, $t as PptxChartSeries, Bt as PptxChartGradientFill, C as SmartArtPptxElement, Dt as PptxChartDataLabel, Et as PptxChartData, F as PlaceholderTextLevelStyle, H as PptxAction, Jt as PptxChartMarkerSymbol, Lt as PptxChartErrBars, O as ZoomPptxElement, Ot as PptxChartDataLabelOptions, P as PlaceholderDefaults, T as TablePptxElement, Tt as PptxChartChrome, U as MediaBookmark, Vt as PptxChartHistogramOptions, Y as ParsedTableBackground, Yt as PptxChartOfPieOptions, Z as ParsedTableStyleBorders, Zt as PptxChartRegionMapOptions, _ as PptxElementWithText, a as GroupPptxElement, at as ParsedTableStyleText, bt as PptxChartAxisFormatting, c as MediaPptxElement, cn as PptxChartView3D, ct as PptxTableCellParagraph, d as OlePptxElement, dn as PptxEmbeddedWorkbookData, dt as PptxTableData, en as PptxChartShapeProps, fn as PptxExternalData, i as ContentPartPptxElement, ir as ShapeStyle, l as Model3DPptxElement, ln as PptxChartWaterfallOptions, lt as PptxTableCellStyle, m as PptxElement, n as ConnectorPptxElement, nn as PptxChartTreemapOptions, on as PptxChartType, pn as PptxChartUserShape, q as PptxMediaReferenceKind, qt as PptxChartMarker, rn as PptxChartTrendline, rr as ResolvedStyleMatrix, rt as ParsedTableStyleMap, s as InkPptxElement, t as ChartPptxElement, tn as PptxChartStyle, tr as PptxImageProperties, vn as ResolvedChartStyleDefinition, wt as PptxChartBoxWhiskerOptions, y as PptxImageLikeElement } from "./elements-iUzpAeqR.js";
 import { B as PptxSmartArtTextRun, G as PptxSmartArtChrome, It as AdjustHandlePolar, Lt as AdjustHandleXY, P as PptxSmartArtQuickStyle, Rt as ConnectionSite, Ut as CustomGeometryTextRect, Vt as CustomGeometryRawData, Wt as GeometryAdjustmentHandle, f as PptxSmartArtColorTransform, j as PptxSmartArtNodeStyle, n as PptxSmartArtData, r as PptxSmartArtDrawingShape, t as PptxSmartArtConnection, zt as CustomGeometryPath } from "./smart-art-ENMMEbmW.js";
-import { $ as PptxThemeOption, C as PptxSlide, D as PptxSmartTagsReference, Ft as PptxAnimationTrigger, Ht as PptxNativeAnimation, J as PptxNotesMaster, K as PptxLayoutPreview, P as PptxViewProperties, Q as PptxTextStyleLevels, Rt as PptxElementAnimation, S as PptxSection, T as PptxSlideSize, V as PptxEmbeddedFontList, W as PptxHandoutMaster, X as PptxSlideLayout, Y as PptxPlaceholderFrame, Z as PptxSlideMaster, _ as PptxLayoutOption, a as MergeOptions, an as PptxSlideTransition, at as PptxThemeFontScheme, b as PptxPhotoAlbum, c as PptxCustomShow, ct as PptxThemeObjectDefaults, d as PptxData, dt as PptxComment, et as PptxTheme, f as PptxEmbeddedFont, fn as PptxTransitionType, ft as PptxCommentAuthor, g as PptxKinsoku, gt as PptxModernCommentAuthor, h as PptxHeaderFooter, ht as PptxCustomProperty, kt as PptxAnimationPreset, l as PptxCustomXmlPart, m as PptxExportOptions, mt as PptxCoreProperties, nt as PptxThemeEffectStyle, ot as PptxThemeFormatScheme, pt as PptxCompatibilityWarning, q as PptxMasterTextStyles, rt as PptxThemeFillStyle, s as PptxActiveXControl, st as PptxThemeLineStyle, t as FindResult, tt as PptxThemeColorScheme, u as PptxCustomerData, ut as PptxAppProperties, v as PptxModernCommentPart, vt as PptxTagCollection, w as PptxSlideBackgroundPattern, x as PptxPresentationProperties, y as PptxModifyVerifier } from "./text-operations-BdD_UQ11.js";
+import { $ as PptxThemeOption, C as PptxSlide, Ct as PptxCustomProperty, D as PptxSmartTagsReference, Et as PptxTagCollection, J as PptxNotesMaster, K as PptxLayoutPreview, Kt as PptxElementAnimation, Lt as PptxAnimationPreset, P as PptxViewProperties, Q as PptxTextStyleLevels, S as PptxSection, St as PptxCoreProperties, T as PptxSlideSize, Ut as PptxAnimationTrigger, V as PptxEmbeddedFontList, W as PptxHandoutMaster, X as PptxSlideLayout, Xt as PptxNativeAnimation, Y as PptxPlaceholderFrame, Z as PptxSlideMaster, _ as PptxLayoutOption, a as MergeOptions, b as PptxPhotoAlbum, bn as PptxTransitionType, bt as PptxCommentAuthor, c as PptxCustomShow, ct as PptxThemeColorScheme, d as PptxData, f as PptxEmbeddedFont, ft as PptxThemeFontScheme, g as PptxKinsoku, gt as PptxThemeVariant, h as PptxHeaderFooter, ht as PptxThemeObjectDefaults, l as PptxCustomXmlPart, lt as PptxThemeEffectStyle, m as PptxExportOptions, mt as PptxThemeLineStyle, pn as PptxSlideTransition, pt as PptxThemeFormatScheme, q as PptxMasterTextStyles, s as PptxActiveXControl, st as PptxTheme, t as FindResult, u as PptxCustomerData, ut as PptxThemeFillStyle, v as PptxModernCommentPart, vt as PptxAppProperties, w as PptxSlideBackgroundPattern, wt as PptxModernCommentAuthor, x as PptxPresentationProperties, xt as PptxCompatibilityWarning, y as PptxModifyVerifier, yt as PptxComment } from "./text-operations-CfLVZ7DK.js";
 import { XMLBuilder, XMLParser } from "fast-xml-parser";
 import JSZip from "jszip";
 //#region pptx/core/types/theme-presets.d.ts
@@ -1297,297 +1297,69 @@ declare class PptxSlideNotesBuilder {
   private syncSegmentsFromNotes;
 }
 //#endregion
-//#region pptx/core/core/types.d.ts
-interface PptxHandlerLoadOptions {
-  eagerDecodeImages?: boolean;
-  password?: string;
-  /**
-   * Maximum total uncompressed bytes accepted from the input ZIP archive.
-   * Defaults to 500 MiB. When the sum of `_data.uncompressedSize` across
-   * all archive entries exceeds this cap, `load()` rejects with a
-   * {@link ZipBombError}. A hard cap of 65 536 archive entries also
-   * applies.
-   */
-  maxUncompressedBytes?: number;
-  /**
-   * When `false` (default), relationship targets that resolve to
-   * `http://` or `https://` URLs are dropped from rendered slides
-   * (image, picture, background). Set to `true` to allow external image
-   * URLs to flow through to `<img src>`.
-   *
-   * Disabled by default to mitigate SSRF / privacy-leak vectors in
-   * server-side rendering and headless export pipelines.
-   */
-  allowExternalImages?: boolean;
-}
-/**
- * Default maximum uncompressed byte budget for {@link PptxHandlerLoadOptions.maxUncompressedBytes}.
- * 500 MiB.
- */
-declare const DEFAULT_MAX_UNCOMPRESSED_BYTES: number;
-/**
- * Hard cap on archive entry count. Beyond this, the package is rejected.
- */
-declare const MAX_ZIP_ENTRY_COUNT = 65536;
-/**
- * Thrown by the load pipeline when a ZIP archive exceeds the configured
- * uncompressed-size budget or the entry-count limit.
- */
-declare class ZipBombError extends Error {
-  readonly code = "ZIP_BOMB";
-  readonly uncompressedBytes: number | undefined;
-  readonly limit: number;
-  readonly entryCount: number | undefined;
-  constructor(message: string, details: {
-    uncompressedBytes?: number;
-    limit: number;
-    entryCount?: number;
-  });
-}
-/** Output format for the save pipeline. */
-type PptxSaveFormat = 'pptx' | 'ppsx' | 'pptm' | 'ppt';
-interface PptxHandlerSaveOptions {
-  headerFooter?: PptxHeaderFooter;
-  presentationProperties?: PptxPresentationProperties;
-  customShows?: PptxCustomShow[];
-  sections?: PptxSection[];
-  coreProperties?: PptxCoreProperties;
-  appProperties?: PptxAppProperties;
-  customProperties?: PptxCustomProperty[];
-  /** Updated notes master data to save back to notesMaster1.xml. */
-  notesMaster?: PptxNotesMaster;
-  /** Updated handout master data to save back to handoutMaster1.xml. */
-  handoutMaster?: PptxHandoutMaster;
-  /**
-   * Updated slide masters to save back to ppt/slideMasters/slideMaster*.xml.
-   * Each entry in the array applies typed mutations (clrMap, hf flags,
-   * background) to the master at its `path`. Masters not listed here pass
-   * through verbatim from the original load.
-   */
-  slideMasters?: PptxSlideMaster[];
-  /**
-   * Updated slide layouts to save back to ppt/slideLayouts/slideLayout*.xml.
-   * Each entry applies typed mutations (clrMapOverride, attrs, hf flags,
-   * background) to the layout at its `path`. Layouts not listed here pass
-   * through verbatim from the original load.
-   */
-  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;
-  /**
-   * Slide dimensions to write back to `p:sldSz`.
-   *
-   * Omitting the option preserves the load-time dimensions verbatim, which
-   * is why an edit made through a viewer's Slide Size control has to reach
-   * the save call: nothing else in the pipeline can observe it.
-   *
-   * PowerPoint derives `Presentation.PageSetup.SlideSize` from `@cx`/`@cy`
-   * alone (verified by COM: an A4-typed `p:sldSz` carrying 4:3 dimensions
-   * still reports `ppSlideSizeCustom`), so `type` is written for fidelity
-   * but the dimensions are what actually decide the reported preset.
-   */
-  slideSize?: PptxSlideSize;
-  /** East Asian line-break settings to save back to `p:kinsoku`. */
-  kinsoku?: PptxKinsoku | null;
-  /** Write-protection verifier. Set to `null` to remove, `undefined` to preserve existing. */
-  modifyVerifier?: PptxModifyVerifier | null;
-  /**
-   * `p:presentation/@embedTrueTypeFonts` to write. `undefined` preserves
-   * whatever was loaded (or omits the attribute for a brand-new deck);
-   * purely declarative here, see {@link PptxData.embedTrueTypeFonts}.
-   */
-  embedTrueTypeFonts?: boolean;
-  /**
-   * Presentation-level default text style edits to save back to
-   * `p:defaultTextStyle`. Only the levels present in the map are touched;
-   * omitted levels and any unmodelled XML on an edited level survive
-   * untouched. See {@link PptxData.defaultTextStyle}.
-   */
-  defaultTextStyle?: PptxTextStyleLevels;
-  /** View properties to save back to ppt/viewProps.xml. */
-  viewProperties?: PptxViewProperties;
-  /**
-   * Table style edits to save back to `ppt/tableStyles.xml`. Pass the
-   * `tableStyleMap` from `PptxData` (optionally with edited entries)
-   * to persist user edits. The `def` GUID and any unmodelled XML are
-   * preserved verbatim. Omitting the option round-trips the original
-   * part untouched.
-   */
-  tableStyles?: ParsedTableStyleMap;
-  /**
-   * Set `ppt/tableStyles.xml`'s `<a:tblStyleLst @def>` to this style GUID
-   * (normalised to uppercase-with-braces). `undefined` preserves the
-   * existing default; there is no removal form (`@def` is required by the
-   * schema and PowerPoint always points it at a real style). No-op when the
-   * archive has no `ppt/tableStyles.xml`, same as {@link tableStyles}.
-   */
-  tableStylesDefaultId?: string;
-  /**
-   * Style GUIDs to remove from `ppt/tableStyles.xml` entirely, kept as a
-   * separate opt-in list rather than inferred from omission on
-   * {@link tableStyles}: that map is documented as safe to pass a PARTIAL
-   * edit (only the entries a caller actually touched), so treating every
-   * GUID missing from it as "delete this" would silently destroy untouched
-   * styles on an ordinary targeted edit. A GUID here that is also the
-   * current (or newly requested) default is left in place and skipped.
-   */
-  tableStylesToDelete?: string[];
-  /**
-   * Target output format.
-   * - `'pptx'` (default): Standard presentation.
-   * - `'ppsx'`: Slide-show file (opens in presentation mode).
-   * - `'pptm'`: Macro-enabled presentation (requires VBA data).
-   * - `'ppt'`: Legacy binary PowerPoint 97-2003 presentation. Bypasses the
-   *   OOXML ZIP pipeline entirely; see `PptxHandlerRuntimeSaveLegacyPpt`.
-   *   Elements with no binary equivalent (charts, SmartArt, media, OLE, ink,
-   *   3D models) are degraded to a rasterised preview picture or a labelled
-   *   placeholder, each reported via a `scope: 'save'`-adjacent
-   *   `PptxCompatibilityWarning`.
-   */
-  outputFormat?: PptxSaveFormat;
-  /**
-   * Password for RC4 CryptoAPI encryption of a `'ppt'`-format save. Ignored
-   * for every other {@link outputFormat}; encrypting a `.pptx`/`.ppsx`/`.pptm`
-   * save uses {@link IPptxHandlerRuntime.saveEncrypted}'s separate AES/Agile
-   * OLE2 wrapping instead, since the legacy binary format's own encryption
-   * scheme is embedded directly in the `.ppt` stream rather than wrapping an
-   * already-produced package.
-   */
-  pptPassword?: string;
-  /**
-   * Embedded fonts to write back (or add) to the saved PPTX.
-   *
-   * Pass the `embeddedFonts` array from `PptxData` to preserve existing
-   * embedded fonts during save. You can also add new fonts by including
-   * entries with `rawFontData` populated.
-   *
-   * When omitted, the save pipeline will automatically re-embed any
-   * fonts that were loaded from the original PPTX and have `rawFontData`
-   * 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.
-   * - `'strict'`: force Strict Open XML (ISO/IEC 29500) namespace URIs.
-   * - `'transitional'`: force Transitional (ECMA-376) namespace URIs.
-   */
-  conformance?: 'strict' | 'transitional' | 'preserve';
-}
-interface IPptxHandlerRuntime {
-  /**
-   * Release all resources held by this runtime (Blob URLs, caches, ZIP).
-   * After calling, the runtime cannot be used further.
-   */
-  dispose(): void;
-  /**
-   * Revoke all Blob URLs created during image loading.
-   */
-  revokeBlobUrls(): void;
-  getCompatibilityWarnings(): PptxCompatibilityWarning[];
-  getLayoutOptions(): PptxLayoutOption[];
-  getLayoutPreview(layoutPath: string): Promise<PptxLayoutPreview | null>;
-  getLayoutPreviews(layoutPaths?: readonly string[]): Promise<PptxLayoutPreview[]>;
-  createXmlBuilder(data: PptxData): PptxXmlBuilder;
-  Builder(data: PptxData): PptxXmlBuilder;
-  setTemplateBackground(path: string, backgroundColor: string | undefined): void;
-  setPresentationTheme(themePath: string, applyToAllMasters?: boolean): Promise<void>;
-  getTemplateBackgroundColor(path: string): string | undefined;
-  updateThemeColorScheme(colorScheme: PptxThemeColorScheme): Promise<void>;
-  updateThemeFontScheme(fontScheme: PptxThemeFontScheme): Promise<void>;
-  updateThemeName(name: string): Promise<void>;
-  /** Resolve a `<p:style>` node against the loaded theme (see PptxHandlerRuntimeStyleMatrixResolve). */
-  resolveStyleMatrixReferences(styleXml: XmlObject): ResolvedStyleMatrix;
-  applyTheme(colorScheme: PptxThemeColorScheme, fontScheme: PptxThemeFontScheme, themeName?: string): Promise<void>;
-  load(data: ArrayBuffer, options?: PptxHandlerLoadOptions): Promise<PptxData>;
-  getChartDataForGraphicFrame(slidePath: string, graphicFrame: XmlObject | undefined): Promise<PptxChartData | undefined>;
-  getSmartArtDataForGraphicFrame(slidePath: string, graphicFrame: XmlObject | undefined): Promise<PptxSmartArtData | undefined>;
-  getImageData(imagePath: string): Promise<string | undefined>;
-  /**
-   * Extract a media file from the PPTX archive as an ArrayBuffer.
-   * Returns undefined if the file is not found.
-   */
-  getMediaArrayBuffer(mediaPath: string): Promise<ArrayBuffer | undefined>;
-  save(slides: PptxSlide[], options?: PptxHandlerSaveOptions): Promise<Uint8Array>;
-  exportSlides(slides: PptxSlide[], options: PptxExportOptions): Promise<Map<number, Uint8Array>>;
-  /**
-   * Get the available slide layouts for a specific slide, based on the
-   * slide's master. Scans the slide master's relationships to find all
-   * layouts that belong to it.
-   *
-   * @param slideIndex - Zero-based slide index.
-   * @param slides - Current slides array.
-   * @returns Array of layout options belonging to the same slide master.
-   */
-  getAvailableLayoutsForSlide(slideIndex: number, slides: PptxSlide[]): Promise<PptxLayoutOption[]>;
-  /**
-   * Resolve the editable template (master + layout) elements a slide
-   * inherits, each carrying a `master-` / `layout-` prefixed id. Excludes
-   * placeholders; returns only decorative shapes/pictures/graphic frames.
-   *
-   * @param slideId - The slide's archive path (`PptxSlide.id`).
-   */
-  getTemplateElementsForSlide(slideId: string): Promise<PptxElement[]>;
-  /**
-   * Scan the loaded PPTX archive for all theme parts.
-   */
-  getAvailableThemes(): Promise<Array<{
-    path: string;
-    name?: string;
-  }>>;
-  /**
-   * Apply a different layout to an existing slide by updating the slide's
-   * relationship to point to the new layout and re-parsing layout
-   * placeholders / background.
-   *
-   * @param slideIndex - Zero-based slide index.
-   * @param layoutPath - Archive path of the target layout
-   *                     (e.g. `ppt/slideLayouts/slideLayout2.xml`).
-   * @param slides - Current slides array.
-   * @returns The updated slide with new layout path, name, and background.
-   */
-  applyLayoutToSlide(slideIndex: number, layoutPath: string, slides: PptxSlide[]): Promise<PptxSlide>;
+//#region pptx/core/utils/diagram-relationship-ids.d.ts
+/** Typed view of the four required relationship attributes on `dgm:relIds`. */
+interface DiagramRelationshipIds {
+  dataRelId?: string;
+  layoutRelId?: string;
+  styleRelId?: string;
+  colorsRelId?: string;
 }
-//#endregion
-//#region pptx/core/core/PptxHandlerRuntimeFactory.d.ts
 /**
- * Abstract factory contract for creating {@link IPptxHandlerRuntime}
- * instances.
- *
- * Implement this interface to supply a custom runtime (e.g. a
- * WASM-backed or test-double runtime) to {@link PptxHandlerCore}.
+ * Read `CT_RelIds` without assuming the conventional `dgm` or `r` prefixes.
+ * Namespace prefixes are aliases and may legally differ in Strict documents.
  */
-interface IPptxHandlerRuntimeFactory {
-  /** Instantiate and return a new runtime implementation. */
-  createRuntime(): IPptxHandlerRuntime;
-}
+declare function parseDiagramRelationshipIds(graphicData: XmlObject | undefined): DiagramRelationshipIds | undefined;
 /**
- * Default factory that produces the standard {@link PptxHandlerRuntime}.
- *
- * Used internally by {@link PptxHandlerCore} when no custom factory is
- * provided.
+ * Apply edited relationship ids to an existing SmartArt graphic frame.
+ * Unspecified ids, unknown attributes, child markup, and extensions are kept.
  */
-declare class PptxHandlerRuntimeFactory implements IPptxHandlerRuntimeFactory {
-  /**
-   * Create and return a new {@link PptxHandlerRuntime} instance.
-   *
-   * @returns A freshly constructed runtime ready for loading a PPTX file.
-   */
-  createRuntime(): IPptxHandlerRuntime;
-}
+declare function applyDiagramRelationshipIds(frame: XmlObject, data: Pick<PptxSmartArtData, 'dataRelId' | 'layoutRelId' | 'styleRelId' | 'colorsRelId'>): void;
+//#endregion
+//#region pptx/core/core/runtime/master-part-tags.d.ts
 /**
- * Convenience function that creates a default {@link IPptxHandlerRuntime}
- * without needing to instantiate the factory class.
+ * @fileoverview Root tags and element-id prefixes for the four "template"
+ * parts whose shape trees the Slide Master view renders and edits.
  *
- * @returns A new {@link PptxHandlerRuntime} instance.
+ * Kept in its own module so the save-side writer can name the tag union
+ * without importing the load-side parser, which sits further down the mixin
+ * chain.
  */
-declare const createDefaultPptxHandlerRuntime: () => IPptxHandlerRuntime;
+/** Root tags of the parts whose shape tree the Slide Master view can edit. */
+type MasterPartRootTag = 'p:notesMaster' | 'p:handoutMaster' | 'p:sldMaster' | 'p:sldLayout';
+//#endregion
+//#region pptx/core/core/builders/PptxConnectorParser.d.ts
+interface ConnectorTextResult {
+  text: string;
+  textStyle: TextStyle;
+  textSegments: TextSegment[];
+}
+interface PptxConnectorParserContext {
+  emuPerPx: number;
+  getOrderedSlidePaths: () => string[];
+  slideRelsMap: Map<string, Map<string, string>>;
+  parseGeometryAdjustments: (prstGeom: XmlObject | undefined) => Record<string, number> | undefined;
+  readFlipState: (xfrm: XmlObject | undefined) => {
+    flipHorizontal?: boolean;
+    flipVertical?: boolean;
+  };
+  extractShapeStyle: (spPr: XmlObject | undefined, styleNode?: XmlObject) => ShapeStyle;
+  parseShapeLocks: (spLocks: XmlObject | undefined) => PptxElement['locks'];
+  parseElementActions: (cNvPr: XmlObject | undefined, slideRelationships: Map<string, string> | undefined, orderedSlidePaths: string[]) => {
+    actionClick?: PptxElement['actionClick'];
+    actionHover?: PptxElement['actionHover'];
+  };
+  /** Parse text body XML into text, style, and segments. */
+  parseConnectorTextBody?: (txBody: XmlObject | undefined, slidePath?: string) => ConnectorTextResult | null;
+}
+interface IPptxConnectorParser {
+  parseConnector(connector: XmlObject, id: string, slidePath?: string): PptxElement | null;
+}
+declare class PptxConnectorParser implements IPptxConnectorParser {
+  private readonly context;
+  constructor(context: PptxConnectorParserContext);
+  parseConnector(connector: XmlObject, id: string, slidePath?: string): PptxElement | null;
+}
 //#endregion
 //#region pptx/core/services/PptxCompatibilityService.d.ts
 interface CompatibilityWarningInput {
@@ -2263,25 +2035,6 @@ declare function parseCustomShows(presentationData: XmlObject | null, lookup: IP
 declare function applyCustomShows(presentation: XmlObject, shows: PptxCustomShow[] | undefined, lookup: IPptxXmlLookupService, remap?: PptxSlideReferenceRemap): void;
 declare function applySections(presentation: XmlObject, sections: PptxSection[] | undefined, lookup: IPptxXmlLookupService, remap?: PptxSlideReferenceRemap): void;
 //#endregion
-//#region pptx/core/utils/diagram-relationship-ids.d.ts
-/** Typed view of the four required relationship attributes on `dgm:relIds`. */
-interface DiagramRelationshipIds {
-  dataRelId?: string;
-  layoutRelId?: string;
-  styleRelId?: string;
-  colorsRelId?: string;
-}
-/**
- * Read `CT_RelIds` without assuming the conventional `dgm` or `r` prefixes.
- * Namespace prefixes are aliases and may legally differ in Strict documents.
- */
-declare function parseDiagramRelationshipIds(graphicData: XmlObject | undefined): DiagramRelationshipIds | undefined;
-/**
- * Apply edited relationship ids to an existing SmartArt graphic frame.
- * Unspecified ids, unknown attributes, child markup, and extensions are kept.
- */
-declare function applyDiagramRelationshipIds(frame: XmlObject, data: Pick<PptxSmartArtData, 'dataRelId' | 'layoutRelId' | 'styleRelId' | 'colorsRelId'>): void;
-//#endregion
 //#region crypto/types.d.ts
 /**
  * Type definitions for OOXML package encryption and decryption.
@@ -2690,6 +2443,13 @@ declare function convertXmlToStrict(node: Record<string, unknown>, setConformanc
  */
 declare function parsePresentationSmartTags(zip: JSZip, parseXml: (xml: string) => XmlObject, presentationData: XmlObject | null | undefined): Promise<PptxSmartTagsReference | undefined>;
 //#endregion
+//#region pptx/core/utils/theme-variants.d.ts
+/**
+ * The variants a package carries, in the manager's order, for the deck's slide width (the first
+ * size group when none matches). Empty when the package has no `themeVariants` relationship.
+ */
+declare function loadThemeVariants(zip: JSZip, parse: (xml: string) => XmlObject, deckSlideWidthEmu?: number): Promise<PptxThemeVariant[]>;
+//#endregion
 //#region pptx/core/utils/chart-color-choice.d.ts
 /**
  * Resolve an authored colour-choice node (`a:schemeClr` with its transforms,
@@ -2733,51 +2493,6 @@ declare class PptxSaveConstantsFactory implements IFactory<PptxSaveConstants, Oo
 }
 declare const createPptxSaveConstants: (conformance?: OoxmlConformanceClass) => PptxSaveConstants;
 //#endregion
-//#region pptx/core/core/runtime/master-part-tags.d.ts
-/**
- * @fileoverview Root tags and element-id prefixes for the four "template"
- * parts whose shape trees the Slide Master view renders and edits.
- *
- * Kept in its own module so the save-side writer can name the tag union
- * without importing the load-side parser, which sits further down the mixin
- * chain.
- */
-/** Root tags of the parts whose shape tree the Slide Master view can edit. */
-type MasterPartRootTag = 'p:notesMaster' | 'p:handoutMaster' | 'p:sldMaster' | 'p:sldLayout';
-//#endregion
-//#region pptx/core/core/builders/PptxConnectorParser.d.ts
-interface ConnectorTextResult {
-  text: string;
-  textStyle: TextStyle;
-  textSegments: TextSegment[];
-}
-interface PptxConnectorParserContext {
-  emuPerPx: number;
-  getOrderedSlidePaths: () => string[];
-  slideRelsMap: Map<string, Map<string, string>>;
-  parseGeometryAdjustments: (prstGeom: XmlObject | undefined) => Record<string, number> | undefined;
-  readFlipState: (xfrm: XmlObject | undefined) => {
-    flipHorizontal?: boolean;
-    flipVertical?: boolean;
-  };
-  extractShapeStyle: (spPr: XmlObject | undefined, styleNode?: XmlObject) => ShapeStyle;
-  parseShapeLocks: (spLocks: XmlObject | undefined) => PptxElement['locks'];
-  parseElementActions: (cNvPr: XmlObject | undefined, slideRelationships: Map<string, string> | undefined, orderedSlidePaths: string[]) => {
-    actionClick?: PptxElement['actionClick'];
-    actionHover?: PptxElement['actionHover'];
-  };
-  /** Parse text body XML into text, style, and segments. */
-  parseConnectorTextBody?: (txBody: XmlObject | undefined, slidePath?: string) => ConnectorTextResult | null;
-}
-interface IPptxConnectorParser {
-  parseConnector(connector: XmlObject, id: string, slidePath?: string): PptxElement | null;
-}
-declare class PptxConnectorParser implements IPptxConnectorParser {
-  private readonly context;
-  constructor(context: PptxConnectorParserContext);
-  parseConnector(connector: XmlObject, id: string, slidePath?: string): PptxElement | null;
-}
-//#endregion
 //#region pptx/core/core/builders/PptxContentTypesBuilder.d.ts
 interface PptxContentTypesSlideMediaBuildInput {
   contentTypesData: XmlObject;
@@ -3769,7 +3484,7 @@ declare class TemplateElementBaselineTracker {
  * the constructor of the final concrete class
  * ({@link PptxHandlerRuntimeImplementation}).
  */
-declare class PptxHandlerRuntime$101 {
+declare class PptxHandlerRuntime$103 {
   /** The in-memory ZIP archive representing the OPC (.pptx) package. */
   protected zip: JSZip;
   /** fast-xml-parser instance used to parse XML strings into JS objects. */
@@ -3890,6 +3605,17 @@ declare class PptxHandlerRuntime$101 {
    * Phase 2 Stream B / C-H4.
    */
   protected masterClrMaps: Map<string, Record<string, string>>;
+  /**
+   * Background style (Design > Background Styles) applied to a master since load: its `p:bg` and
+   * `p:clrMap`. The save writer applies them last, so a stale `PptxSlideMaster` model handed back
+   * by the editor cannot undo them.
+   */
+  /** Real theme variants the loaded package carries (see `loadThemeVariants`). */
+  protected loadedThemeVariants: PptxThemeVariant[];
+  protected masterStyleOverrides: Map<string, {
+    bg: XmlObject;
+    clrMap: Record<string, string>;
+  }>;
   /**
    * Per-master theme color maps. Each master may reference its own theme
    * file via `_rels/slideMasterN.xml.rels`. For multi-master decks, slides
@@ -4171,7 +3897,7 @@ declare class PptxHandlerRuntime$101 {
 }
 //#endregion
 //#region pptx/core/core/runtime/PptxHandlerRuntimeTableStyles.d.ts
-declare class PptxHandlerRuntime$100 extends PptxHandlerRuntime$101 {
+declare class PptxHandlerRuntime$102 extends PptxHandlerRuntime$103 {
   /**
    * Export slides to a vector or raster format, keyed by slide index.
    *
@@ -4261,7 +3987,7 @@ declare class PptxHandlerRuntime$100 extends PptxHandlerRuntime$101 {
 }
 //#endregion
 //#region pptx/core/core/runtime/PptxHandlerRuntimeElementActions.d.ts
-declare class PptxHandlerRuntime$99 extends PptxHandlerRuntime$100 {
+declare class PptxHandlerRuntime$101 extends PptxHandlerRuntime$102 {
   /**
    * Write or remove a single `a:hlinkClick` / `a:hlinkHover` node on
    * a `p:cNvPr` parent.
@@ -4318,7 +4044,7 @@ declare class PptxHandlerRuntime$99 extends PptxHandlerRuntime$100 {
 }
 //#endregion
 //#region pptx/core/core/runtime/PptxHandlerRuntimeTableStylesAndActions.d.ts
-declare class PptxHandlerRuntime$98 extends PptxHandlerRuntime$99 {
+declare class PptxHandlerRuntime$100 extends PptxHandlerRuntime$101 {
   /**
    * Parse a single `a:hlinkClick` or `a:hlinkHover` node into a `PptxAction`.
    */
@@ -4373,7 +4099,7 @@ interface MediaTimingData {
    */
   mediaEmbedPath?: string;
 }
-declare class PptxHandlerRuntime$97 extends PptxHandlerRuntime$98 {
+declare class PptxHandlerRuntime$99 extends PptxHandlerRuntime$100 {
   /**
    * Extract image recolour/brightness/contrast/artistic effects from blip extensions.
    */
@@ -4413,7 +4139,7 @@ declare class PptxHandlerRuntime$97 extends PptxHandlerRuntime$98 {
 }
 //#endregion
 //#region pptx/core/core/runtime/PptxHandlerRuntimeMediaTimingParsing.d.ts
-declare class PptxHandlerRuntime$96 extends PptxHandlerRuntime$97 {
+declare class PptxHandlerRuntime$98 extends PptxHandlerRuntime$99 {
   /**
    * Recursively walk the timing tree looking for `p:video` and `p:audio`
    * nodes that contain `p:cMediaNode`.
@@ -4446,7 +4172,7 @@ declare class PptxHandlerRuntime$96 extends PptxHandlerRuntime$97 {
 }
 //#endregion
 //#region pptx/core/core/runtime/PptxHandlerRuntimeMediaData.d.ts
-declare class PptxHandlerRuntime$95 extends PptxHandlerRuntime$96 {
+declare class PptxHandlerRuntime$97 extends PptxHandlerRuntime$98 {
   /** Forward declaration implemented later in the runtime inheritance chain. */
   protected resolveThemeColor(_schemeKey: string): string | undefined;
   /**
@@ -4492,7 +4218,7 @@ declare class PptxHandlerRuntime$95 extends PptxHandlerRuntime$96 {
 }
 //#endregion
 //#region pptx/core/core/runtime/PptxHandlerRuntimeDocProperties.d.ts
-declare class PptxHandlerRuntime$94 extends PptxHandlerRuntime$95 {
+declare class PptxHandlerRuntime$96 extends PptxHandlerRuntime$97 {
   protected buildRelativeTargetPath(fromPartPath: string, toPartPath: string): string;
   protected setMasterThemeRelationship(masterPath: string, themePath: string): Promise<void>;
   setPresentationTheme(themePath: string, applyToAllMasters?: boolean): Promise<void>;
@@ -4547,7 +4273,7 @@ declare class PptxHandlerRuntime$94 extends PptxHandlerRuntime$95 {
 }
 //#endregion
 //#region pptx/core/core/runtime/PptxHandlerRuntimeSlideMasters.d.ts
-declare class PptxHandlerRuntime$93 extends PptxHandlerRuntime$94 {
+declare class PptxHandlerRuntime$95 extends PptxHandlerRuntime$96 {
   /**
    * Parse background colour from a `p:bg` node.
    */
@@ -4592,7 +4318,7 @@ declare class PptxHandlerRuntime$93 extends PptxHandlerRuntime$94 {
 }
 //#endregion
 //#region pptx/core/core/runtime/PptxHandlerRuntimePresentationProps.d.ts
-declare class PptxHandlerRuntime$92 extends PptxHandlerRuntime$93 {
+declare class PptxHandlerRuntime$94 extends PptxHandlerRuntime$95 {
   /**
    * Forward declaration - implemented in PptxHandlerRuntimeTextStyleUtils.
    * Resolves `+mj-lt` / `+mn-lt` theme font tokens to the theme typeface.
@@ -4651,7 +4377,7 @@ interface EmbedTransitionSoundContext {
   slideAudioRelationshipType: string;
   slideId: string;
 }
-declare class PptxHandlerRuntime$91 extends PptxHandlerRuntime$92 {
+declare class PptxHandlerRuntime$93 extends PptxHandlerRuntime$94 {
   protected createEmptySlideXml(): XmlObject;
   protected deepCloneXml(value: XmlObject | undefined): XmlObject | undefined;
   protected findSourceSlidePath(requestedSourcePath: string | undefined): string | undefined;
@@ -4701,18 +4427,18 @@ declare class PptxHandlerRuntime$91 extends PptxHandlerRuntime$92 {
 }
 //#endregion
 //#region pptx/core/core/runtime/PptxHandlerRuntimeSaveRunProperties.d.ts
-declare class PptxHandlerRuntime$90 extends PptxHandlerRuntime$91 {
+declare class PptxHandlerRuntime$92 extends PptxHandlerRuntime$93 {
   protected createRunPropertiesFromTextStyle(style: TextStyle | undefined, resolveHyperlinkRelationshipId?: (target: string) => string | undefined): XmlObject | undefined;
   private applyHyperlinkExtraAttrs;
 }
 //#endregion
 //#region pptx/core/core/runtime/PptxHandlerRuntimeSaveParagraphs.d.ts
-declare class PptxHandlerRuntime$89 extends PptxHandlerRuntime$90 {
+declare class PptxHandlerRuntime$91 extends PptxHandlerRuntime$92 {
   protected createParagraphsFromTextContent(text: string | undefined, textStyle: TextStyle | undefined, textSegments: TextSegment[] | undefined, resolveHyperlinkRelationshipId?: (target: string) => string | undefined): XmlObject[];
 }
 //#endregion
 //#region pptx/core/core/runtime/PptxHandlerRuntimeSaveElements.d.ts
-declare class PptxHandlerRuntime$88 extends PptxHandlerRuntime$89 {
+declare class PptxHandlerRuntime$90 extends PptxHandlerRuntime$91 {
   protected updateNotesXmlText(notesXmlObj: XmlObject, notesText: string | undefined, notesSegments?: TextSegment[]): boolean;
   protected createPictureXml(el: PptxImageLikeElement, relationshipId: string): XmlObject;
   protected createMediaGraphicFrameXml(el: MediaPptxElement, relationshipId: string): XmlObject;
@@ -4742,7 +4468,7 @@ interface GroupOwnEmuOverride {
 //#region pptx/core/core/runtime/PptxHandlerRuntimeSaveShapeXml.d.ts
 /** The save context a group child needs to serialise like a top-level shape. */
 type GroupChildSaveContext = SaveSlideContext;
-declare class PptxHandlerRuntime$87 extends PptxHandlerRuntime$88 {
+declare class PptxHandlerRuntime$89 extends PptxHandlerRuntime$90 {
   /** See `save-shape-xml-frames.ts`'s `buildTableGraphicFrameXml`. */
   protected createTableGraphicFrameXml(el: TablePptxElement): XmlObject;
   /** See `save-shape-xml-frames.ts`'s `buildChartGraphicFrameXml`. */
@@ -4796,7 +4522,7 @@ declare class PptxHandlerRuntime$87 extends PptxHandlerRuntime$88 {
 }
 //#endregion
 //#region pptx/core/core/runtime/PptxHandlerRuntimeSaveImageEffects.d.ts
-declare class PptxHandlerRuntime$86 extends PptxHandlerRuntime$87 {
+declare class PptxHandlerRuntime$88 extends PptxHandlerRuntime$89 {
   protected clampCropForSave(value: unknown): number;
   /** See {@link buildSrcRectXml} (issue G2: signed crop insets). */
   protected applyImageCropToBlipFill(blipFill: XmlObject | undefined, element: PptxImageLikeElement): void;
@@ -4821,7 +4547,7 @@ declare class PptxHandlerRuntime$86 extends PptxHandlerRuntime$87 {
 }
 //#endregion
 //#region pptx/core/core/runtime/PptxHandlerRuntimeTextStyleUtils.d.ts
-declare class PptxHandlerRuntime$85 extends PptxHandlerRuntime$86 {
+declare class PptxHandlerRuntime$87 extends PptxHandlerRuntime$88 {
   /**
    * Resolve the automatic per-script fallback face for a run's text from the
    * theme's `<a:font script="...">` overrides (#83). Body (minor) fonts win
@@ -4856,7 +4582,7 @@ declare class PptxHandlerRuntime$85 extends PptxHandlerRuntime$86 {
 }
 //#endregion
 //#region pptx/core/core/runtime/PptxHandlerRuntimeTextRunEffects.d.ts
-declare class PptxHandlerRuntime$84 extends PptxHandlerRuntime$85 {
+declare class PptxHandlerRuntime$86 extends PptxHandlerRuntime$87 {
   /**
    * Parse hyperlink-related properties (a:hlinkClick, a:hlinkMouseOver) from
    * run-level XML and apply them to the given TextStyle.
@@ -4885,7 +4611,7 @@ declare class PptxHandlerRuntime$84 extends PptxHandlerRuntime$85 {
 }
 //#endregion
 //#region pptx/core/core/runtime/PptxHandlerRuntimeTextRunStyleExtraction.d.ts
-declare class PptxHandlerRuntime$83 extends PptxHandlerRuntime$84 {
+declare class PptxHandlerRuntime$85 extends PptxHandlerRuntime$86 {
   protected extractTextRunStyle(runProperties: XmlObject | undefined, align: TextStyle['align'], relationshipMap?: Map<string, string>, includeDefaultAlignment?: boolean, slidePath?: string): TextStyle;
   /**
    * Copy `@panose` / `@pitchFamily` / `@charset` from a font child node
@@ -4896,7 +4622,7 @@ declare class PptxHandlerRuntime$83 extends PptxHandlerRuntime$84 {
 }
 //#endregion
 //#region pptx/core/core/runtime/PptxHandlerRuntimeTextEditing.d.ts
-declare class PptxHandlerRuntime$82 extends PptxHandlerRuntime$83 {
+declare class PptxHandlerRuntime$84 extends PptxHandlerRuntime$85 {
   protected extractTextSegmentsFromTxBodyForRewrite(txBody: XmlObject | undefined, baseStyle: TextStyle | undefined, relationshipMap?: Map<string, string>): TextSegment[];
   protected remapEditedTextToExistingStyles(existingSegments: TextSegment[], nextText: string, fallbackStyle: TextStyle | undefined): TextSegment[];
 }
@@ -5098,7 +4824,7 @@ interface LayoutPlaceholderSlot {
  * reposition the matched ones, keep content the new layout has no slot for,
  * and inject empty placeholders that exist only in the target layout.
  */
-declare class PptxHandlerRuntime$81 extends PptxHandlerRuntime$82 {
+declare class PptxHandlerRuntime$83 extends PptxHandlerRuntime$84 {
   /**
    * Read placeholder info from a `p:nvPr` XML node.
    *
@@ -5175,7 +4901,7 @@ declare class PptxHandlerRuntime$81 extends PptxHandlerRuntime$82 {
 }
 //#endregion
 //#region pptx/core/core/runtime/PptxHandlerRuntimeSaveTableStyles.d.ts
-declare class PptxHandlerRuntime$80 extends PptxHandlerRuntime$81 {
+declare class PptxHandlerRuntime$82 extends PptxHandlerRuntime$83 {
   /**
    * Write plain text into a table cell's txBody, preserving
    * existing run properties where possible.
@@ -5190,7 +4916,7 @@ declare class PptxHandlerRuntime$80 extends PptxHandlerRuntime$81 {
 }
 //#endregion
 //#region pptx/core/core/runtime/PptxHandlerRuntimeChartUserShapes.d.ts
-declare class PptxHandlerRuntime$79 extends PptxHandlerRuntime$80 {
+declare class PptxHandlerRuntime$81 extends PptxHandlerRuntime$82 {
   /**
    * Reconcile a chart's `c:userShapes` reference and drawing part against
    * the current `chartData.userShapes` typed model, writing a new or
@@ -5226,7 +4952,7 @@ declare class PptxHandlerRuntime$79 extends PptxHandlerRuntime$80 {
 }
 //#endregion
 //#region pptx/core/core/runtime/PptxHandlerRuntimeSaveDataSerialization.d.ts
-declare class PptxHandlerRuntime$78 extends PptxHandlerRuntime$79 {
+declare class PptxHandlerRuntime$80 extends PptxHandlerRuntime$81 {
   /**
    * Serialise modified `PptxTableData` back into the graphic frame's
    * raw XML so that the round-tripped file preserves edits.
@@ -5241,6 +4967,8 @@ declare class PptxHandlerRuntime$78 extends PptxHandlerRuntime$79 {
    * Record `chartData` as parsed, straight off `enrichChartData`, as this
    * chart's load-time baseline. See {@link chartDataBaselines}.
    */
+  /** The element formats the original chart part authors (see `chart-element-format-read-xml`). */
+  private readAuthoredChartElementFormats;
   protected rememberChartDataBaseline(chartData: PptxChartData): void;
   /**
    * Collect chart data for deferred async processing during save.
@@ -5342,7 +5070,7 @@ declare class PptxHandlerRuntime$78 extends PptxHandlerRuntime$79 {
 }
 //#endregion
 //#region pptx/core/core/runtime/PptxHandlerRuntimeSaveDocumentParts.d.ts
-declare class PptxHandlerRuntime$77 extends PptxHandlerRuntime$78 {
+declare class PptxHandlerRuntime$79 extends PptxHandlerRuntime$80 {
   /** Pending SmartArt data updates to process during save. */
   protected pendingSmartArtUpdates?: Array<{
     element: SmartArtPptxElement;
@@ -5465,7 +5193,7 @@ declare class PptxHandlerRuntime$77 extends PptxHandlerRuntime$78 {
 }
 //#endregion
 //#region pptx/core/core/runtime/PptxHandlerRuntimeSavePresPropsAndSignatures.d.ts
-declare class PptxHandlerRuntime$76 extends PptxHandlerRuntime$77 {
+declare class PptxHandlerRuntime$78 extends PptxHandlerRuntime$79 {
   protected applyPresentationPropertiesPart(properties: PptxPresentationProperties | undefined): Promise<void>;
   /**
    * Strip digital signature parts from the ZIP if the document was signed.
@@ -5475,7 +5203,7 @@ declare class PptxHandlerRuntime$76 extends PptxHandlerRuntime$77 {
 }
 //#endregion
 //#region pptx/core/core/runtime/PptxHandlerRuntimeSaveMediaTimingWrite.d.ts
-declare class PptxHandlerRuntime$75 extends PptxHandlerRuntime$76 {
+declare class PptxHandlerRuntime$77 extends PptxHandlerRuntime$78 {
   protected collectMediaElements(elements: PptxElement[], output: MediaPptxElement[]): void;
   protected getShapeIdFromRawXml(rawXml: XmlObject | undefined): string | undefined;
   protected applyMediaTimingToTimingTree(node: XmlObject, mediaByShapeId: Map<string, MediaPptxElement>): void;
@@ -5502,7 +5230,7 @@ declare class PptxHandlerRuntime$75 extends PptxHandlerRuntime$76 {
 }
 //#endregion
 //#region pptx/core/core/runtime/PptxHandlerRuntimeSaveXmlHelpers.d.ts
-declare class PptxHandlerRuntime$74 extends PptxHandlerRuntime$75 {
+declare class PptxHandlerRuntime$76 extends PptxHandlerRuntime$77 {
   /**
    * Recursively walk an XML object tree and deduplicate extension list entries
    * by `@_uri`. When multiple `a:ext` or `p:ext` entries share the same URI,
@@ -5525,7 +5253,7 @@ declare class PptxHandlerRuntime$74 extends PptxHandlerRuntime$75 {
 }
 //#endregion
 //#region pptx/core/core/runtime/PptxHandlerRuntimeSaveShapeStyleWriter.d.ts
-declare class PptxHandlerRuntime$73 extends PptxHandlerRuntime$74 {
+declare class PptxHandlerRuntime$75 extends PptxHandlerRuntime$76 {
   /**
    * Serialize shape fill, stroke, dash, arrows, line join/cap/compound,
    * and line-level effects to the given spPr XML object.
@@ -5564,7 +5292,7 @@ declare class PptxHandlerRuntime$73 extends PptxHandlerRuntime$74 {
 }
 //#endregion
 //#region pptx/core/core/runtime/PptxHandlerRuntimeSaveEffectsWriter.d.ts
-declare class PptxHandlerRuntime$72 extends PptxHandlerRuntime$73 {
+declare class PptxHandlerRuntime$74 extends PptxHandlerRuntime$75 {
   /**
    * Serialize visual effects (shadow, glow, reflection, blur, soft edge),
    * effectDag, 3D scene, and 3D shape properties to the given spPr XML object.
@@ -5579,7 +5307,7 @@ declare class PptxHandlerRuntime$72 extends PptxHandlerRuntime$73 {
 }
 //#endregion
 //#region pptx/core/core/runtime/PptxHandlerRuntimeSaveTextWriter.d.ts
-declare class PptxHandlerRuntime$71 extends PptxHandlerRuntime$72 {
+declare class PptxHandlerRuntime$73 extends PptxHandlerRuntime$74 {
   /**
    * Build and write the text body (`p:txBody`) for shapes, text boxes,
    * and connectors that carry text content.
@@ -5651,7 +5379,7 @@ interface SaveSlideContext {
    */
   readonly preserveGroupChildSpace?: GroupChildSpaceOwner;
 }
-declare class PptxHandlerRuntime$70 extends PptxHandlerRuntime$71 {
+declare class PptxHandlerRuntime$72 extends PptxHandlerRuntime$73 {
   /** Serialize table, chart, and SmartArt data when applicable. */
   protected applyDataSerialization(shape: XmlObject, el: PptxElement, slideId: string): void;
   /** Apply image crop, effects, and alt text for picture/image elements. */
@@ -5665,7 +5393,7 @@ declare class PptxHandlerRuntime$70 extends PptxHandlerRuntime$71 {
 }
 //#endregion
 //#region pptx/core/core/runtime/PptxHandlerRuntimeSaveSmartArtFabrication.d.ts
-declare class PptxHandlerRuntime$69 extends PptxHandlerRuntime$70 {
+declare class PptxHandlerRuntime$71 extends PptxHandlerRuntime$72 {
   /** Content-type overrides queued for diagram parts fabricated this save. */
   protected pendingDiagramContentTypes?: Array<{
     partName: string;
@@ -5704,7 +5432,7 @@ interface PendingOleContentUpdate {
  * fresh by `createOleElementWithPayload` (`PptxHandlerRuntimeSaveOleEmbedding.ts`),
  * which already embeds whatever `oleEmbeddedData` holds at save time.
  */
-declare class PptxHandlerRuntime$68 extends PptxHandlerRuntime$69 {
+declare class PptxHandlerRuntime$70 extends PptxHandlerRuntime$71 {
   protected pendingOleContentUpdates?: PendingOleContentUpdate[];
   private nextOlePreviewImageIndex?;
   private nextOlePreviewImagePath;
@@ -5722,7 +5450,7 @@ declare class PptxHandlerRuntime$68 extends PptxHandlerRuntime$69 {
 }
 //#endregion
 //#region pptx/core/core/runtime/PptxHandlerRuntimeSaveOleEmbedding.d.ts
-declare class PptxHandlerRuntime$67 extends PptxHandlerRuntime$68 {
+declare class PptxHandlerRuntime$69 extends PptxHandlerRuntime$70 {
   private pendingOleContentTypes?;
   private nextOleEmbeddingPath;
   /** Write an SDK-authored OLE payload and return its graphic-frame envelope. */
@@ -5732,7 +5460,7 @@ declare class PptxHandlerRuntime$67 extends PptxHandlerRuntime$68 {
 }
 //#endregion
 //#region pptx/core/core/runtime/PptxHandlerRuntimeSaveZoom.d.ts
-declare class PptxHandlerRuntime$66 extends PptxHandlerRuntime$67 {
+declare class PptxHandlerRuntime$68 extends PptxHandlerRuntime$69 {
   protected readonly newZoomFallbackByXml: Map<XmlObject, XmlObject>;
   /** Update an existing slide Zoom or build a new Office 2016 Zoom node. */
   protected createOrUpdateSlideZoomXml(el: ZoomPptxElement, shape: XmlObject | undefined, ctx: SaveSlideContext): XmlObject | undefined;
@@ -5751,7 +5479,7 @@ declare class PptxHandlerRuntime$66 extends PptxHandlerRuntime$67 {
 }
 //#endregion
 //#region pptx/core/core/runtime/PptxHandlerRuntimeSaveSectionZoom.d.ts
-declare class PptxHandlerRuntime$65 extends PptxHandlerRuntime$66 {
+declare class PptxHandlerRuntime$67 extends PptxHandlerRuntime$68 {
   /** Dispatch typed Zoom elements to their distinct slide/section envelopes. */
   protected createOrUpdateZoomXml(el: ZoomPptxElement, shape: XmlObject | undefined, ctx: SaveSlideContext): XmlObject | undefined;
   private createOrUpdateSectionZoomXml;
@@ -5759,7 +5487,7 @@ declare class PptxHandlerRuntime$65 extends PptxHandlerRuntime$66 {
 }
 //#endregion
 //#region pptx/core/core/runtime/PptxHandlerRuntimeSaveSummaryZoom.d.ts
-declare class PptxHandlerRuntime$64 extends PptxHandlerRuntime$65 {
+declare class PptxHandlerRuntime$66 extends PptxHandlerRuntime$67 {
   /** Dispatch Summary Zoom containers without conflating them with Section Zoom tiles. */
   protected createOrUpdateZoomXml(el: ZoomPptxElement, shape: XmlObject | undefined, ctx: SaveSlideContext): XmlObject | undefined;
   private createOrUpdateSummaryZoomXml;
@@ -5773,7 +5501,7 @@ declare class PptxHandlerRuntime$64 extends PptxHandlerRuntime$65 {
 }
 //#endregion
 //#region pptx/core/core/runtime/PptxHandlerRuntimeSaveModel3D.d.ts
-declare class PptxHandlerRuntime$63 extends PptxHandlerRuntime$64 {
+declare class PptxHandlerRuntime$65 extends PptxHandlerRuntime$66 {
   private readonly newModel3DFallbackByXml;
   /** Create or update an embedded GLB model, its poster, and package relationships. */
   protected createOrUpdateModel3DXml(el: Model3DPptxElement, shape: XmlObject | undefined, ctx: SaveSlideContext): XmlObject | undefined;
@@ -5788,7 +5516,7 @@ declare class PptxHandlerRuntime$63 extends PptxHandlerRuntime$64 {
 }
 //#endregion
 //#region pptx/core/core/runtime/PptxHandlerRuntimeSaveContentPartInk.d.ts
-declare class PptxHandlerRuntime$62 extends PptxHandlerRuntime$63 {
+declare class PptxHandlerRuntime$64 extends PptxHandlerRuntime$65 {
   private readonly newContentPartFallbackByXml;
   /**
    * Convert a Draw-tab pen/highlighter element (no `rawXml`) into the
@@ -5832,7 +5560,7 @@ interface SlideShapeCollectors {
   readonly contentParts: XmlObject[];
   readonly zooms: XmlObject[];
 }
-declare class PptxHandlerRuntime$61 extends PptxHandlerRuntime$62 {
+declare class PptxHandlerRuntime$63 extends PptxHandlerRuntime$64 {
   private static readonly CHART_COLOR_CONTENT_TYPE;
   private static readonly CHART_COLOR_REL_TYPE;
   private static readonly CHART_EX_CONTENT_TYPE;
@@ -5983,7 +5711,7 @@ declare class PptxHandlerRuntime$61 extends PptxHandlerRuntime$62 {
 }
 //#endregion
 //#region pptx/core/core/runtime/PptxHandlerRuntimeSaveSlideWriter.d.ts
-declare class PptxHandlerRuntime$60 extends PptxHandlerRuntime$61 {
+declare class PptxHandlerRuntime$62 extends PptxHandlerRuntime$63 {
   protected resolveModernCommentAuthorId(comment: PptxComment): string;
   protected nextModernCommentPartPath(): string;
   private createModernCommentAuthorId;
@@ -6073,7 +5801,7 @@ declare class PptxHandlerRuntime$60 extends PptxHandlerRuntime$61 {
  * save pipeline to regenerate the theme part instead of re-emitting the
  * original XML.
  */
-declare class PptxHandlerRuntime$59 extends PptxHandlerRuntime$60 {
+declare class PptxHandlerRuntime$61 extends PptxHandlerRuntime$62 {
   /**
    * Mark a theme path as dirty so the save pipeline will regenerate
    * the theme XML from in-memory state. Optional — without this the
@@ -6145,7 +5873,7 @@ declare class PptxHandlerRuntime$59 extends PptxHandlerRuntime$60 {
 }
 //#endregion
 //#region pptx/core/core/runtime/PptxHandlerRuntimeSaveSlideMaster.d.ts
-declare class PptxHandlerRuntime$58 extends PptxHandlerRuntime$59 {
+declare class PptxHandlerRuntime$60 extends PptxHandlerRuntime$61 {
   /**
    * Apply typed mutations from the supplied {@link PptxSlideMaster} array
    * to each master's cached XmlObject. Called by the save pipeline before
@@ -6156,7 +5884,7 @@ declare class PptxHandlerRuntime$58 extends PptxHandlerRuntime$59 {
 }
 //#endregion
 //#region pptx/core/core/runtime/PptxHandlerRuntimeSaveSlideLayout.d.ts
-declare class PptxHandlerRuntime$57 extends PptxHandlerRuntime$58 {
+declare class PptxHandlerRuntime$59 extends PptxHandlerRuntime$60 {
   /**
    * Apply typed mutations from the supplied {@link PptxSlideLayout} array
    * to each layout's cached XmlObject. Called by the save pipeline before
@@ -6180,7 +5908,7 @@ declare class PptxHandlerRuntime$57 extends PptxHandlerRuntime$58 {
 }
 //#endregion
 //#region pptx/core/core/runtime/PptxHandlerRuntimeSaveMasterElements.d.ts
-declare class PptxHandlerRuntime$56 extends PptxHandlerRuntime$57 {
+declare class PptxHandlerRuntime$58 extends PptxHandlerRuntime$59 {
   /**
    * Persist Slide Master view edits to every master and layout the caller
    * handed back, then let the pipeline's passthrough flush emit them.
@@ -6220,7 +5948,7 @@ declare class PptxHandlerRuntime$56 extends PptxHandlerRuntime$57 {
 }
 //#endregion
 //#region pptx/core/core/runtime/PptxHandlerRuntimeSaveNotesMaster.d.ts
-declare class PptxHandlerRuntime$55 extends PptxHandlerRuntime$56 {
+declare class PptxHandlerRuntime$57 extends PptxHandlerRuntime$58 {
   /**
    * Apply clrMap and headerFooter mutations to the notes master XML.
    * Background-colour mutations are still handled by the pre-existing
@@ -6232,7 +5960,7 @@ declare class PptxHandlerRuntime$55 extends PptxHandlerRuntime$56 {
 }
 //#endregion
 //#region pptx/core/core/runtime/PptxHandlerRuntimeSaveHandoutMaster.d.ts
-declare class PptxHandlerRuntime$54 extends PptxHandlerRuntime$55 {
+declare class PptxHandlerRuntime$56 extends PptxHandlerRuntime$57 {
   /**
    * Apply clrMap and headerFooter mutations to the handout master XML.
    */
@@ -6240,7 +5968,7 @@ declare class PptxHandlerRuntime$54 extends PptxHandlerRuntime$55 {
 }
 //#endregion
 //#region pptx/core/core/runtime/PptxHandlerRuntimeSaveViewProperties.d.ts
-declare class PptxHandlerRuntime$53 extends PptxHandlerRuntime$54 {
+declare class PptxHandlerRuntime$55 extends PptxHandlerRuntime$56 {
   /**
    * Re-emit `ppt/viewProps.xml` from the typed view properties. Walks
    * `presentation.xml.rels` to find the viewProps target so non-default
@@ -6270,7 +5998,7 @@ declare class PptxHandlerRuntime$53 extends PptxHandlerRuntime$54 {
 }
 //#endregion
 //#region pptx/core/core/runtime/PptxHandlerRuntimeSaveNotesInfrastructure.d.ts
-declare class PptxHandlerRuntime$52 extends PptxHandlerRuntime$53 {
+declare class PptxHandlerRuntime$54 extends PptxHandlerRuntime$55 {
   /** Ensure authored notes have the global notes-master OPC infrastructure. */
   protected ensureNotesMasterForAuthoredNotes(slides: readonly PptxSlide[], constants: PptxSaveConstants): Promise<void>;
   private buildDefaultNotesMaster;
@@ -6278,7 +6006,7 @@ declare class PptxHandlerRuntime$52 extends PptxHandlerRuntime$53 {
 }
 //#endregion
 //#region pptx/core/core/runtime/PptxHandlerRuntimeSaveHandoutInfrastructure.d.ts
-declare class PptxHandlerRuntime$51 extends PptxHandlerRuntime$52 {
+declare class PptxHandlerRuntime$53 extends PptxHandlerRuntime$54 {
   /** Ensure an authored handout master has complete OPC package infrastructure. */
   protected ensureHandoutMasterInfrastructure(handoutMaster: PptxHandoutMaster | undefined, constants: PptxSaveConstants): Promise<void>;
   private ensureHandoutThemeRelationship;
@@ -6303,7 +6031,7 @@ type LegacyPptxSerializer = () => Promise<Uint8Array>;
  * to resolve `media`-`audio` elements loaded from a real `.pptx` (see
  * `resolveAudioMediaBytes`'s doc).
  */
-declare class PptxHandlerRuntime$50 extends PptxHandlerRuntime$51 {
+declare class PptxHandlerRuntime$52 extends PptxHandlerRuntime$53 {
   /**
    * A `media`-`audio` element loaded from a real `.pptx` carries only
    * `mediaPath` (a lazy reference into `this.zip`), never `mediaData`
@@ -6362,7 +6090,7 @@ declare class PptxHandlerRuntime$50 extends PptxHandlerRuntime$51 {
  * back out with it on every save. See `save-structural-id-gate.ts` for the
  * decision helpers.
  */
-declare class PptxHandlerRuntime$49 extends PptxHandlerRuntime$50 {
+declare class PptxHandlerRuntime$51 extends PptxHandlerRuntime$52 {
   protected repairStructuralIdsBeforeExport(slides: PptxSlide[]): Promise<void>;
   /** The loader's cached parse of a part, which the live model's `rawXml` nodes belong to. */
   private cachedStructuralPart;
@@ -6371,7 +6099,7 @@ declare class PptxHandlerRuntime$49 extends PptxHandlerRuntime$50 {
 }
 //#endregion
 //#region pptx/core/core/runtime/PptxHandlerRuntimeSavePipeline.d.ts
-declare class PptxHandlerRuntime$48 extends PptxHandlerRuntime$49 {
+declare class PptxHandlerRuntime$50 extends PptxHandlerRuntime$51 {
   /**
    * Resolve the effective conformance class for this save operation.
    *
@@ -6405,7 +6133,7 @@ declare class PptxHandlerRuntime$48 extends PptxHandlerRuntime$49 {
 }
 //#endregion
 //#region pptx/core/core/runtime/PptxHandlerRuntimeElementParsing.d.ts
-declare class PptxHandlerRuntime$47 extends PptxHandlerRuntime$48 {
+declare class PptxHandlerRuntime$49 extends PptxHandlerRuntime$50 {
   /**
    * Parse media data (video/audio path and MIME type) from graphic frame data.
    */
@@ -6466,7 +6194,7 @@ declare class PptxHandlerRuntime$47 extends PptxHandlerRuntime$48 {
 }
 //#endregion
 //#region pptx/core/core/runtime/PptxHandlerRuntimeZoomParsing.d.ts
-declare class PptxHandlerRuntime$46 extends PptxHandlerRuntime$47 {
+declare class PptxHandlerRuntime$48 extends PptxHandlerRuntime$49 {
   /** Parse an Office 2016 `pslz:sldZm` slide Zoom object. */
   protected parseSlideZoomElement(zoom: XmlObject, id: string, slidePath: string): Promise<PptxElement | null>;
   protected findSlideIndexByNumericId(value: unknown): number;
@@ -6481,13 +6209,13 @@ declare class PptxHandlerRuntime$46 extends PptxHandlerRuntime$47 {
 }
 //#endregion
 //#region pptx/core/core/runtime/PptxHandlerRuntimeSectionZoomParsing.d.ts
-declare class PptxHandlerRuntime$45 extends PptxHandlerRuntime$46 {
+declare class PptxHandlerRuntime$47 extends PptxHandlerRuntime$48 {
   /** Parse an Office 2016 `psezm:sectionZm` section Zoom object. */
   protected parseSectionZoomElement(zoom: XmlObject, id: string, slidePath: string): Promise<PptxElement | null>;
 }
 //#endregion
 //#region pptx/core/core/runtime/PptxHandlerRuntimeSummaryZoomParsing.d.ts
-declare class PptxHandlerRuntime$44 extends PptxHandlerRuntime$45 {
+declare class PptxHandlerRuntime$46 extends PptxHandlerRuntime$47 {
   /** Parse an Office 2016 Summary Zoom container and all section tiles. */
   protected parseSummaryZoomElement(zoom: XmlObject, id: string, slidePath: string): Promise<PptxElement | null>;
   private parseSummaryZoomPreview;
@@ -6504,7 +6232,7 @@ interface PlaceholderNodeContext extends PlaceholderLookupContext {
   /** The inherited graphic frame XML object from the layout/master, if any. */
   graphicFrame?: XmlObject;
 }
-declare class PptxHandlerRuntime$43 extends PptxHandlerRuntime$44 {
+declare class PptxHandlerRuntime$45 extends PptxHandlerRuntime$46 {
   protected findPlaceholderInShapeTree(spTree: XmlObject | undefined, expected: PlaceholderInfo | null): PlaceholderNodeContext | undefined;
   private scanPlaceholderBuckets;
   /**
@@ -6560,7 +6288,7 @@ declare class PptxHandlerRuntime$43 extends PptxHandlerRuntime$44 {
 }
 //#endregion
 //#region pptx/core/core/runtime/PptxHandlerRuntimeGeometryParsing.d.ts
-declare class PptxHandlerRuntime$42 extends PptxHandlerRuntime$43 {
+declare class PptxHandlerRuntime$44 extends PptxHandlerRuntime$45 {
   protected parseGeometryAdjustments(prstGeom: XmlObject | undefined): Record<string, number> | undefined;
   /**
    * Parse adjustment handles from `a:ahLst` in a geometry definition.
@@ -6637,7 +6365,7 @@ declare class PptxHandlerRuntime$42 extends PptxHandlerRuntime$43 {
 }
 //#endregion
 //#region pptx/core/core/runtime/PptxHandlerRuntimeShapeImageFill.d.ts
-declare class PptxHandlerRuntime$41 extends PptxHandlerRuntime$42 {
+declare class PptxHandlerRuntime$43 extends PptxHandlerRuntime$44 {
   /**
    * Parse a shape that has an image fill (a:blipFill inside spPr)
    * This handles shapes like rectangles filled with images (e.g., wood texture backgrounds)
@@ -6648,7 +6376,7 @@ declare class PptxHandlerRuntime$41 extends PptxHandlerRuntime$42 {
 }
 //#endregion
 //#region pptx/core/core/runtime/PptxHandlerRuntimeTextDefaults.d.ts
-declare class PptxHandlerRuntime$40 extends PptxHandlerRuntime$41 {
+declare class PptxHandlerRuntime$42 extends PptxHandlerRuntime$43 {
   /**
    * Apply {@link PlaceholderDefaults} body-level properties to a
    * {@link TextStyle} as fallback values (only sets fields that are
@@ -6685,7 +6413,7 @@ declare class PptxHandlerRuntime$40 extends PptxHandlerRuntime$41 {
 //#endregion
 //#region pptx/core/core/runtime/PptxHandlerRuntimeBulletParsing.d.ts
 type LevelStyleMap = Record<number, PlaceholderTextLevelStyle>;
-declare class PptxHandlerRuntime$39 extends PptxHandlerRuntime$40 {
+declare class PptxHandlerRuntime$41 extends PptxHandlerRuntime$42 {
   protected resolveParagraphBulletInfo(paragraph: XmlObject | undefined, paragraphIndex: number, txBody: XmlObject | undefined, inheritedTxBody: XmlObject | undefined, isBodyPlaceholder?: boolean, slidePath?: string, effectiveLevelStyles?: LevelStyleMap): BulletInfo | null;
   protected createBulletInfoFromLevelStyle(levelStyle: PlaceholderTextLevelStyle | undefined, paragraphIndex: number): BulletInfo | null;
   /**
@@ -6708,7 +6436,7 @@ declare class PptxHandlerRuntime$39 extends PptxHandlerRuntime$40 {
 }
 //#endregion
 //#region pptx/core/core/runtime/PptxHandlerRuntimeShapeBodyParsing.d.ts
-declare class PptxHandlerRuntime$38 extends PptxHandlerRuntime$39 {
+declare class PptxHandlerRuntime$40 extends PptxHandlerRuntime$41 {
   /**
    * Parse `a:spLocks` attributes into a structured {@link PptxShapeLocks} object.
    * Returns `undefined` when the node is absent or contains no lock attributes.
@@ -6735,7 +6463,7 @@ declare class PptxHandlerRuntime$38 extends PptxHandlerRuntime$39 {
 }
 //#endregion
 //#region pptx/core/core/runtime/PptxHandlerRuntimeShapeTextParsing.d.ts
-declare class PptxHandlerRuntime$37 extends PptxHandlerRuntime$38 {
+declare class PptxHandlerRuntime$39 extends PptxHandlerRuntime$40 {
   /**
    * A copy of an `a:lstStyle` level entry without its `a:defRPr`: run
    * defaults follow their own precedence chain, so only the paragraph-level
@@ -6760,1464 +6488,1852 @@ declare class PptxHandlerRuntime$37 extends PptxHandlerRuntime$38 {
    * bring them back. Three of the five govern East-Asian line breaking and
    * justification, so the loss fell hardest on CJK decks.
    *
-   * The `a:pPr` child elements likewise round-trip: `lnSpc`/`spcBef`/`spcAft`
-   * and `tabLst` below, `defRPr` and `extLst` verbatim, and the bullet group
-   * separately as `TextSegment.bulletInfo`.
+   * The `a:pPr` child elements likewise round-trip: `lnSpc`/`spcBef`/`spcAft`
+   * and `tabLst` below, `defRPr` and `extLst` verbatim, and the bullet group
+   * separately as `TextSegment.bulletInfo`.
+   */
+  protected extractParagraphOwnProperties(p: XmlObject, basisFontSize: number | undefined): TextStyle | undefined;
+  /**
+   * Resolve paragraph-level styles (alignment, spacing, margins, tabs,
+   * level styles) for a single paragraph.  Modifies `textStyle` in place
+   * for "first-wins" shape-level properties.
+   */
+  protected resolveShapeParagraphStyle(p: XmlObject, textStyle: TextStyle, ctx: ShapeTextParsingContext): ParagraphStyleResult;
+}
+//#endregion
+//#region pptx/core/core/runtime/PptxHandlerRuntimeShapeParagraphContentParsing.d.ts
+declare class PptxHandlerRuntime$38 extends PptxHandlerRuntime$39 {
+  /**
+   * Collect text content (runs, fields, equations, bullets) for a single
+   * paragraph and return text parts + segments.  The returned `seedStyle`
+   * is the style from the first concrete content (used by the caller to
+   * seed the shape-level textStyle).
+   */
+  protected collectShapeParagraphContent(p: XmlObject, pIdx: number, paraCount: number, paraAlign: TextStyle['align'], mergedDefaultRunStyle: TextStyle, ctx: ShapeTextParsingContext): ParagraphContentResult;
+  /**
+   * Font size (px) of the first text run in a paragraph, or `undefined` when
+   * that first run inherits its size.
+   *
+   * Used as the base for unsized and percentage-sized bullets. Only `a:r`
+   * and `a:fld` carry renderable text; `a:br` does not.
+   */
+  protected resolveFirstRunFontSize(p: XmlObject, paraAlign: TextStyle['align'], ctx: ShapeTextParsingContext): number | undefined;
+}
+//#endregion
+//#region pptx/core/core/runtime/PptxHandlerRuntimeShapeParsing.d.ts
+declare class PptxHandlerRuntime$37 extends PptxHandlerRuntime$38 {
+  protected parseShape(shape: XmlObject, id: string, slidePath?: string): PptxElement | null;
+}
+//#endregion
+//#region pptx/core/core/runtime/PptxHandlerRuntimePictureParsing.d.ts
+declare class PptxHandlerRuntime$36 extends PptxHandlerRuntime$37 {
+  protected parsePicture(pic: XmlObject, id: string, slidePath: string): Promise<PptxElement | null>;
+}
+//#endregion
+//#region pptx/core/core/runtime/PptxHandlerRuntimeSpTreeParsing.d.ts
+declare class PptxHandlerRuntime$35 extends PptxHandlerRuntime$36 {
+  /**
+   * Known element tag names that appear as direct children of `p:spTree`
+   * (or `p:grpSp`) and represent renderable shapes/objects.
+   */
+  private static readonly ELEMENT_TAGS;
+  /**
+   * Extract the document-order sequence of child element types from a raw
+   * XML string.  Returns an array of `{ tag, indexInType }` entries where
+   * `indexInType` is the 0-based occurrence index within that tag's array.
+   *
+   * Falls back to the default type-grouped order when `xmlStr` is unavailable.
+   */
+  protected extractSpTreeChildOrder(xmlStr: string | undefined, spTree: Record<string, unknown>, containerTag: string): Array<{
+    tag: string;
+    indexInType: number;
+  }>;
+  /**
+   * Scan the raw XML to find direct child element tags of the first
+   * occurrence of `containerTag`.
+   *
+   * Also handles `mc:AlternateContent` blocks: when one is found at
+   * depth 0, the scanner resolves the selected branch (Choice or
+   * Fallback) and includes element tags from that branch in the
+   * document-order sequence.
+   */
+  private scanDirectChildElements;
+  /**
+   * Find the position of a closing tag `</tagName>` in `xmlStr` starting
+   * from `startPos`, properly handling nesting of the same tag.
+   * Returns the index of the `<` of the closing tag, or -1 if not found.
+   */
+  private static findClosingTag;
+  /**
+   * Given the inner content of an mc:AlternateContent block, determine
+   * which branch (Choice or Fallback) to use and return the element
+   * tags found in that branch.
+   */
+  private static scanAlternateContentBranch;
+  /**
+   * Extract direct child element tag names from a branch content string.
+   * Only looks at depth-0 children that match known element tags.
+   */
+  private static extractElementTagsFromBranch;
+  /**
+   * Build the legacy type-grouped order (all shapes, then all pictures,
+   * etc.).  Used as a fallback when raw XML is unavailable.
+   */
+  private buildTypeGroupedOrder;
+  /**
+   * Parse a single element from its tag and index within the type array.
+   */
+  protected parseSpTreeChild(tag: string, indexInType: number, spTree: Record<string, unknown>, slidePath: string, idPrefix: string, rawXmlStr?: string): Promise<PptxElement | null>;
+  /**
+   * Parse all element children from an spTree (or similar container) in
+   * document order.
+   */
+  protected parseSpTreeChildren(spTree: Record<string, unknown>, slidePath: string, xmlStr: string | undefined, containerTag: string, idPrefix?: string): Promise<PptxElement[]>;
+  /**
+   * Unwrap mc:AlternateContent elements within a shape tree (or group),
+   * merging selected branch children into the parent element arrays.
+   * Delegates to the standalone alternate-content utility.
+   *
+   * Records each consumed AC envelope in {@link alternateContentBlockByRawXml}
+   * so the save layer can re-emit the original `<mc:Choice>` /
+   * `<mc:Fallback>` shape on dirty save (CC-4).
+   */
+  protected unwrapAlternateContent(container: Record<string, unknown>): void;
+  /**
+   * Forward declaration – implemented in PptxHandlerRuntimeGroupParsing.
+   *
+   * `_depth` is the group's `p:grpSp` nesting level (0 for a `p:spTree`
+   * child); the implementation recurses into nested groups with `depth + 1`.
+   */
+  protected parseGroupShapeAsGroup(_group: XmlObject, _baseId: string, _slidePath: string, _rawXmlStr?: string, _depth?: number): Promise<PptxElement | null>;
+}
+//#endregion
+//#region pptx/core/core/runtime/PptxHandlerRuntimeGroupParsing.d.ts
+declare class PptxHandlerRuntime$34 extends PptxHandlerRuntime$35 {
+  /**
+   * Parse the children of a `<p:grpSp>` into the group's own pixel space.
+   *
+   * A nested `<p:grpSp>` becomes a nested {@link GroupPptxElement}, NOT a
+   * flattened run of its descendants. Flattening kept the content but
+   * destroyed the wrapper: its `p:cNvPr/@name`, its `p:grpSpPr` fill and
+   * locks, its animation identity and the user-visible grouping all vanished
+   * from the saved file, silently degrading a two-level group into one.
+   */
+  protected parseGroupShape(group: XmlObject, baseId: string, slidePath: string, rawXmlStr?: string, depth?: number): Promise<PptxElement[]>;
+  /**
+   * Parse a p:grpSp element into a GroupPptxElement with children.
+   * Children have coordinates relative to the group's position.
+   *
+   * `depth` is the group's nesting level: 0 for a `<p:spTree>` child. Only a
+   * top-level group rounds its transform to whole pixels; a nested one stays
+   * unrounded, because its parent is still going to map it through
+   * `ext / chExt` and rounding first collapses a compact child space to 0.
+   */
+  protected parseGroupShapeAsGroup(group: XmlObject, baseId: string, slidePath: string, rawXmlStr?: string, depth?: number): Promise<PptxElement | null>;
+  protected extractGradientFillColor(gradFill: XmlObject): string | undefined;
+}
+//#endregion
+//#region pptx/core/core/runtime/PptxHandlerRuntimeSlideParsing.d.ts
+declare class PptxHandlerRuntime$33 extends PptxHandlerRuntime$34 {
+  /**
+   * Parse text body from a connector shape (p:cxnSp > p:txBody).
+   * Uses the same text run extraction logic as regular shapes but
+   * without placeholder inheritance (connectors don't have placeholders).
+   */
+  protected parseConnectorTextBody(txBody: XmlObject | undefined, slidePath?: string): ConnectorTextResult | null;
+  protected parseSlide(slideXml: XmlObject, slidePath: string): Promise<PptxElement[]>;
+}
+//#endregion
+//#region pptx/core/core/runtime/PptxHandlerRuntimeColorAndEffects.d.ts
+declare class PptxHandlerRuntime$32 extends PptxHandlerRuntime$33 {
+  /**
+   * Forward declaration – implemented in PptxHandlerRuntimeThemeProcessing.
+   * Re-resolves gradient stops by substituting `phClr` with the given colour.
+   */
+  protected reResolveGradientWithPhClr(_gradNode: XmlObject, _phClrValue: string): {
+    stops: NonNullable<ShapeStyle['fillGradientStops']>;
+    css: string | undefined;
+  };
+  /**
+   * Forward declaration – implemented in PptxHandlerRuntimeThemeProcessing.
+   * Parses a layout-level colour map override.
+   */
+  protected parseLayoutClrMapOverride(_layoutXml: XmlObject): Record<string, string> | null;
+  protected getDefaultSchemeColorMap(): Record<string, string>;
+  protected resolveThemeColor(schemeKey: string): string | undefined;
+  protected normalizeStrokeDashType(value: unknown): StrokeDashType | undefined;
+  protected normalizeConnectorArrowType(value: unknown): ConnectorArrowType | undefined;
+  protected extractBlurStyle(shapeProps: XmlObject): Partial<ShapeStyle>;
+  protected extractEffectDagStyle(shapeProps: XmlObject): Partial<ShapeStyle>;
+  protected extractFillOverlayStyle(shapeProps: XmlObject): Partial<ShapeStyle>;
+  protected extractReflectionStyle(shapeProps: XmlObject): Partial<ShapeStyle>;
+  protected extractSoftEdgeStyle(shapeProps: XmlObject): Partial<ShapeStyle>;
+  protected extractGlowStyle(shapeProps: XmlObject): Partial<ShapeStyle>;
+  protected extractInnerShadowStyle(shapeProps: XmlObject): Partial<ShapeStyle>;
+  protected extractShadowStyle(shapeProps: XmlObject): Partial<ShapeStyle>;
+  protected extractGradientFillCss(gradFill: XmlObject): string | undefined;
+  protected buildGradientCssFromStops(stops: NonNullable<ShapeStyle['fillGradientStops']>, type: NonNullable<ShapeStyle['fillGradientType']>, angle: number): string | undefined;
+  protected extractGradientAngle(gradFill: XmlObject): number;
+  protected extractGradientType(gradFill: XmlObject): NonNullable<ShapeStyle['fillGradientType']>;
+  protected extractGradientStops(gradFill: XmlObject): NonNullable<ShapeStyle['fillGradientStops']>;
+  protected extractGradientOpacity(gradFill: XmlObject): number | undefined;
+  protected parseColorChoice(colorChoice: XmlObject | undefined, placeholderColor?: string): string | undefined;
+}
+//#endregion
+//#region pptx/core/core/runtime/PptxHandlerRuntimeBackgroundParsing.d.ts
+declare class PptxHandlerRuntime$31 extends PptxHandlerRuntime$32 {
+  /**
+   * Preserve the visual properties authored on a background `a:blipFill`.
+   *
+   * The decoded image URL alone is not enough to reproduce PowerPoint: crop,
+   * stretch/tile placement and blip effects such as `a:alphaModFix` live next
+   * to the relationship id and otherwise disappear during slide assembly.
+   */
+  protected extractBackgroundImageProperties(slideXml: XmlObject, rootElement?: string): PptxImageProperties | undefined;
+  protected extractBackgroundImage(slideXml: XmlObject, slidePath: string, rootElement?: string): Promise<string | undefined>;
+  protected extractBackgroundColor(slideXml: XmlObject, rootElement?: string): string | undefined;
+  /**
+   * Composite a resolved background colour with its `a:alpha` (or
+   * `a:alphaMod`/`a:alphaOff`) opacity onto opaque white.
+   *
+   * PowerPoint renders a semi-transparent slide/layout/master background
+   * against white, never against whatever happens to sit behind the
+   * viewer's stage (a white canvas, a dark presentation-mode backdrop, a
+   * thumbnail strip). Blending once here keeps `backgroundColor` a plain
+   * `#RRGGBB` value that looks the same on every backdrop, matching
+   * PowerPoint rather than emitting `rgba()` and letting alpha bleed
+   * through whatever the stage happens to be. See issue #288.
+   */
+  private blendBackgroundColorOntoWhite;
+  /**
+   * A deep-cloned snapshot of the slide's own `<p:bgPr>`, exactly as parsed,
+   * for the save writer to restore verbatim when nothing about the
+   * background changed (see {@link AuthoredSlideBackground.rawBgPr}).
+   *
+   * Deep-cloned rather than returned by reference: `extractBackgroundColor`
+   * flattens this same node into a single colour string that survives on
+   * the model across an arbitrary number of saves in one handler session,
+   * while `slideXml` here is the cached parse of the ORIGINAL part, which
+   * later saves mutate in place. A live reference would go stale the moment
+   * a save touched the slide for an unrelated reason.
+   */
+  protected extractOwnBackgroundNode(slideXml: XmlObject, rootElement?: string): XmlObject | undefined;
+  /**
+   * The `<p:bgRef>` twin of {@link extractOwnBackgroundNode}: a deep-cloned
+   * snapshot of the slide's own `<p:bgRef idx="…"><a:schemeClr .../></p:bgRef>`
+   * (a background that follows the theme's `a:bgFillStyleLst` rather than
+   * carrying a literal fill), for the save writer to restore verbatim.
+   *
+   * Without this, a slide authoring `p:bgRef` had no snapshot at all (only
+   * `p:bgPr` was captured), so the save writer's "nothing changed, preserve
+   * verbatim" guard never matched and it fell through to rebuilding
+   * `<p:bgPr><a:solidFill><a:srgbClr .../></a:solidFill></p:bgPr>` from the
+   * flattened colour on every save, replacing the theme reference with a
+   * literal fill and severing the slide from later theme changes.
+   */
+  protected extractOwnBackgroundRefNode(slideXml: XmlObject, rootElement?: string): XmlObject | undefined;
+  /**
+   * Resolve a `<p:bgRef>` element to a flat colour string.
+   *
+   * Per ECMA-376 §20.1.4.2.10 the `@idx` attribute selects an entry
+   * from one of two style matrices on the active theme:
+   *
+   * - `idx == 0` → no fill (transparent / undefined)
+   * - `1 ≤ idx ≤ 999` → `fmtScheme/fillStyleLst[idx-1]`
+   * - `1001 ≤ idx ≤ 1003` → `fmtScheme/bgFillStyleLst[idx-1001]`
+   *
+   * When the resolved fill is a gradient or pattern we surface its
+   * primary colour; gradient CSS is handled separately by
+   * {@link extractBackgroundGradient}. The colour child of `bgRef`
+   * acts as the `phClr` placeholder for any `phClr` tokens inside the
+   * referenced fill definition.
    */
-  protected extractParagraphOwnProperties(p: XmlObject, basisFontSize: number | undefined): TextStyle | undefined;
+  protected resolveBackgroundRefColor(bgRef: XmlObject): string | undefined;
   /**
-   * Resolve paragraph-level styles (alignment, spacing, margins, tabs,
-   * level styles) for a single paragraph.  Modifies `textStyle` in place
-   * for "first-wins" shape-level properties.
+   * Extract a structured pattern fill (`<a:pattFill>`) from a slide
+   * background. Returns the preset name plus resolved fg/bg colours so
+   * renderers can draw a real SVG pattern instead of a flat fill.
+   *
+   * `a:alpha` (or `a:alphaMod`/`a:alphaOff`) on either `a:fgClr` or
+   * `a:bgClr` is composited onto white the same way the flat-colour
+   * fallback in {@link extractBackgroundColor} already does, matching how
+   * PowerPoint renders a semi-transparent pattern colour: always against
+   * white, never against whatever backdrop happens to sit behind the
+   * stage. See issue #288.
+   *
+   * ECMA-376 §20.1.8.47.
    */
-  protected resolveShapeParagraphStyle(p: XmlObject, textStyle: TextStyle, ctx: ShapeTextParsingContext): ParagraphStyleResult;
-}
-//#endregion
-//#region pptx/core/core/runtime/PptxHandlerRuntimeShapeParagraphContentParsing.d.ts
-declare class PptxHandlerRuntime$36 extends PptxHandlerRuntime$37 {
+  protected extractBackgroundPattern(slideXml: XmlObject, rootElement?: string): PptxSlideBackgroundPattern | undefined;
   /**
-   * Collect text content (runs, fields, equations, bullets) for a single
-   * paragraph and return text parts + segments.  The returned `seedStyle`
-   * is the style from the first concrete content (used by the caller to
-   * seed the shape-level textStyle).
+   * Extract the `<p:bgPr/@shadeToTitle>` boolean attribute from a slide
+   * background. Captured here purely as a passthrough flag on the model;
+   * the actual "shade the gradient toward the title colour" effect is
+   * applied downstream by `pptx-viewer-shared`'s `getSlideBackgroundStyle`
+   * (`render/background-shade-to-title.ts`), not by core.
+   *
+   * ECMA-376 §19.3.1.2 (CT_BackgroundProperties).
    */
-  protected collectShapeParagraphContent(p: XmlObject, pIdx: number, paraCount: number, paraAlign: TextStyle['align'], mergedDefaultRunStyle: TextStyle, ctx: ShapeTextParsingContext): ParagraphContentResult;
+  protected extractBackgroundShadeToTitle(slideXml: XmlObject, rootElement?: string): boolean | undefined;
   /**
-   * Font size (px) of the first text run in a paragraph, or `undefined` when
-   * that first run inherits its size.
-   *
-   * Used as the base for unsized and percentage-sized bullets. Only `a:r`
-   * and `a:fld` carry renderable text; `a:br` does not.
+   * Extract a CSS gradient string from a slide/layout/master background.
+   * Handles `a:gradFill` within `p:bgPr` and gradient-based `p:bgRef`.
    */
-  protected resolveFirstRunFontSize(p: XmlObject, paraAlign: TextStyle['align'], ctx: ShapeTextParsingContext): number | undefined;
-}
-//#endregion
-//#region pptx/core/core/runtime/PptxHandlerRuntimeShapeParsing.d.ts
-declare class PptxHandlerRuntime$35 extends PptxHandlerRuntime$36 {
-  protected parseShape(shape: XmlObject, id: string, slidePath?: string): PptxElement | null;
-}
-//#endregion
-//#region pptx/core/core/runtime/PptxHandlerRuntimePictureParsing.d.ts
-declare class PptxHandlerRuntime$34 extends PptxHandlerRuntime$35 {
-  protected parsePicture(pic: XmlObject, id: string, slidePath: string): Promise<PptxElement | null>;
-}
-//#endregion
-//#region pptx/core/core/runtime/PptxHandlerRuntimeSpTreeParsing.d.ts
-declare class PptxHandlerRuntime$33 extends PptxHandlerRuntime$34 {
+  protected extractBackgroundGradient(slideXml: XmlObject, rootElement?: string): string | undefined;
   /**
-   * Known element tag names that appear as direct children of `p:spTree`
-   * (or `p:grpSp`) and represent renderable shapes/objects.
+   * Reuse the cached parse of a layout XML part, parsing (and caching) on a
+   * miss. Background resolution runs per slide but the layout/master parts are
+   * large (a themed master can be ~200 KB); re-parsing them for every slide
+   * dominated load time, so share the same parsed object `getLayoutElements`
+   * already populated.
    */
-  private static readonly ELEMENT_TAGS;
+  protected resolveCachedLayoutXml(layoutPath: string): Promise<XmlObject | undefined>;
+  /** Reuse the cached parse of a master XML part, parsing (and caching) on a miss. */
+  protected resolveCachedMasterXml(masterPath: string): Promise<XmlObject | undefined>;
+  protected getMasterBackgroundImage(layoutPath: string): Promise<string | undefined>;
+  protected getMasterBackgroundImageProperties(layoutPath: string): Promise<PptxImageProperties | undefined>;
+  protected getLayoutBackgroundImage(slidePath: string): Promise<string | undefined>;
+  protected getLayoutBackgroundImageProperties(slidePath: string): Promise<PptxImageProperties | undefined>;
+  protected getLayoutBackgroundColor(slidePath: string): Promise<string | undefined>;
   /**
-   * Extract the document-order sequence of child element types from a raw
-   * XML string.  Returns an array of `{ tag, indexInType }` entries where
-   * `indexInType` is the 0-based occurrence index within that tag's array.
-   *
-   * Falls back to the default type-grouped order when `xmlStr` is unavailable.
+   * Resolve the slide master's background colour given a layout path.
    */
-  protected extractSpTreeChildOrder(xmlStr: string | undefined, spTree: Record<string, unknown>, containerTag: string): Array<{
-    tag: string;
-    indexInType: number;
-  }>;
+  protected getMasterBackgroundColor(layoutPath: string): Promise<string | undefined>;
+}
+//#endregion
+//#region pptx/core/core/runtime/PptxHandlerRuntimeSlideUtils.d.ts
+declare class PptxHandlerRuntime$30 extends PptxHandlerRuntime$31 {
   /**
-   * Scan the raw XML to find direct child element tags of the first
-   * occurrence of `containerTag`.
-   *
-   * Also handles `mc:AlternateContent` blocks: when one is found at
-   * depth 0, the scanner resolves the selected branch (Choice or
-   * Fallback) and includes element tags from that branch in the
-   * document-order sequence.
+   * Retrieve the background gradient from a layout, falling back to master.
    */
-  private scanDirectChildElements;
+  protected getLayoutBackgroundGradient(slidePath: string): Promise<string | undefined>;
   /**
-   * Find the position of a closing tag `</tagName>` in `xmlStr` starting
-   * from `startPos`, properly handling nesting of the same tag.
-   * Returns the index of the `<` of the closing tag, or -1 if not found.
+   * Resolve the slide master's background gradient given a layout path.
    */
-  private static findClosingTag;
+  protected getMasterBackgroundGradient(layoutPath: string): Promise<string | undefined>;
   /**
-   * Given the inner content of an mc:AlternateContent block, determine
-   * which branch (Choice or Fallback) to use and return the element
-   * tags found in that branch.
+   * Find the layout file path referenced by a slide via its relationships.
    */
-  private static scanAlternateContentBranch;
+  protected findLayoutPathForSlide(slidePath: string): string | undefined;
   /**
-   * Extract direct child element tag names from a branch content string.
-   * Only looks at depth-0 children that match known element tags.
+   * Find the master file path referenced by a layout via its relationships.
    */
-  private static extractElementTagsFromBranch;
+  protected findMasterPathForLayoutBase(layoutPath: string): string | undefined;
   /**
-   * Build the legacy type-grouped order (all shapes, then all pictures,
-   * etc.).  Used as a fallback when raw XML is unavailable.
+   * Switch the active master state (clrMap + theme color/font/format
+   * scheme) so that scheme-colour resolution for the slide currently
+   * being parsed walks through the correct master.
+   *
+   * Multi-master decks must resolve scheme colours against each slide's
+   * own master rather than always against `masterFiles[0]`.
+   *
+   * Phase 2 Stream B / C-H4.
    */
-  private buildTypeGroupedOrder;
+  protected setActiveMasterForSlide(slidePath: string): Promise<void>;
   /**
-   * Parse a single element from its tag and index within the type array.
+   * Point colour/font/format resolution at one master's theme, or back at
+   * the deck-wide snapshot when `masterPath` is undefined.
+   *
+   * Split out of {@link setActiveMasterForSlide} because the Slide Master
+   * view parses each master's own shape tree outside any slide, and its
+   * scheme colours must resolve through that master rather than through
+   * whichever slide happened to be parsed last.
    */
-  protected parseSpTreeChild(tag: string, indexInType: number, spTree: Record<string, unknown>, slidePath: string, idPrefix: string, rawXmlStr?: string): Promise<PptxElement | null>;
+  protected applyMasterThemeState(masterPath: string | undefined): void;
   /**
-   * Parse all element children from an spTree (or similar container) in
-   * document order.
+   * Extract the `p:bg/@showAnimation` flag from a slide's XML.
+   * Returns `true` when the background should animate, `false` when
+   * explicitly disabled, or `undefined` when the attribute is absent
+   * (defaults to true per OOXML spec).
    */
-  protected parseSpTreeChildren(spTree: Record<string, unknown>, slidePath: string, xmlStr: string | undefined, containerTag: string, idPrefix?: string): Promise<PptxElement[]>;
+  protected extractBackgroundShowAnimation(slideXml: XmlObject): boolean | undefined;
   /**
-   * Unwrap mc:AlternateContent elements within a shape tree (or group),
-   * merging selected branch children into the parent element arrays.
-   * Delegates to the standalone alternate-content utility.
-   *
-   * Records each consumed AC envelope in {@link alternateContentBlockByRawXml}
-   * so the save layer can re-emit the original `<mc:Choice>` /
-   * `<mc:Fallback>` shape on dirty save (CC-4).
+   * Extract the `p:sld/@showMasterSp` flag.
+   * Returns `false` when master shapes should be hidden, `true` when
+   * explicitly shown, or `undefined` when the attribute is absent
+   * (defaults to true per OOXML spec).
    */
-  protected unwrapAlternateContent(container: Record<string, unknown>): void;
+  protected extractShowMasterShapes(slideXml: XmlObject): boolean | undefined;
   /**
-   * Forward declaration – implemented in PptxHandlerRuntimeGroupParsing.
+   * Extract the `p:sld/@showMasterPhAnim` flag: whether inherited master
+   * placeholder animations should replay on this slide. Mirrors
+   * `p:sldLayout/@showMasterPhAnim` (see `parseSlideLayoutAttributes`).
+   * Distinct from {@link extractShowMasterShapes}, which governs shape
+   * VISIBILITY rather than animation timing.
    *
-   * `_depth` is the group's `p:grpSp` nesting level (0 for a `p:spTree`
-   * child); the implementation recurses into nested groups with `depth + 1`.
+   * Returns `false` when disabled, `true` when explicitly enabled, or
+   * `undefined` when the attribute is absent (defaults to true per spec).
    */
-  protected parseGroupShapeAsGroup(_group: XmlObject, _baseId: string, _slidePath: string, _rawXmlStr?: string, _depth?: number): Promise<PptxElement | null>;
+  protected extractShowMasterPhAnim(slideXml: XmlObject): boolean | undefined;
+  protected isSlideHidden(slideXmlObj: XmlObject, slideIdEntry: XmlObject | undefined): boolean;
+  protected extractTextFromTxBody(txBody: XmlObject | undefined): string;
+  protected extractSlideNotes(slidePath: string): Promise<{
+    notes?: string;
+    notesSegments?: TextSegment[];
+    notesShapes?: PptxElement[];
+    notesClrMapOverride?: Record<string, string>;
+    notesCSldName?: string;
+  }>;
 }
 //#endregion
-//#region pptx/core/core/runtime/PptxHandlerRuntimeGroupParsing.d.ts
-declare class PptxHandlerRuntime$32 extends PptxHandlerRuntime$33 {
+//#region pptx/core/core/runtime/PptxHandlerRuntimePlaceholderStyles.d.ts
+declare class PptxHandlerRuntime$29 extends PptxHandlerRuntime$30 {
   /**
-   * Parse the children of a `<p:grpSp>` into the group's own pixel space.
+   * Parse a single `a:lvlXpPr` node into a structured
+   * {@link PlaceholderTextLevelStyle}.
    *
-   * A nested `<p:grpSp>` becomes a nested {@link GroupPptxElement}, NOT a
-   * flattened run of its descendants. Flattening kept the content but
-   * destroyed the wrapper: its `p:cNvPr/@name`, its `p:grpSpPr` fill and
-   * locks, its animation identity and the user-visible grouping all vanished
-   * from the saved file, silently degrading a two-level group into one.
+   * The paragraph-level attributes go through the same helpers the
+   * per-paragraph `a:pPr` path uses (`paragraph-properties-parser`), so a
+   * master `p:txStyles` or layout `a:lstStyle` level carries exactly the
+   * field set a directly-authored paragraph does: margins on both sides,
+   * `rtl`, tab stops, and the full `ST_TextAlignType` token set.
    */
-  protected parseGroupShape(group: XmlObject, baseId: string, slidePath: string, rawXmlStr?: string, depth?: number): Promise<PptxElement[]>;
+  protected parsePlaceholderLevelStyle(levelProps: XmlObject | undefined): PlaceholderTextLevelStyle | null;
+  /** Bullet group of an `a:lvlXpPr` node (`a:bu*` children). */
+  private parsePlaceholderLevelBullet;
+  /** Default run properties of a level (`a:defRPr`: font, size, bold, italic, colour). */
+  private parsePlaceholderLevelRunDefaults;
+}
+//#endregion
+//#region pptx/core/core/runtime/PptxHandlerRuntimePlaceholderDefaults.d.ts
+declare class PptxHandlerRuntime$28 extends PptxHandlerRuntime$29 {
   /**
-   * Parse a p:grpSp element into a GroupPptxElement with children.
-   * Children have coordinates relative to the group's position.
-   *
-   * `depth` is the group's nesting level: 0 for a `<p:spTree>` child. Only a
-   * top-level group rounds its transform to whole pixels; a nested one stays
-   * unrounded, because its parent is still going to map it through
-   * `ext / chExt` and rounding first collapses a compact child space to 0.
+   * Extract structured {@link PlaceholderDefaults} from a layout or master
+   * shape that carries a `p:ph` element.
    */
-  protected parseGroupShapeAsGroup(group: XmlObject, baseId: string, slidePath: string, rawXmlStr?: string, depth?: number): Promise<PptxElement | null>;
-  protected extractGradientFillColor(gradFill: XmlObject): string | undefined;
+  protected extractPlaceholderDefaultsFromShape(shape: XmlObject): PlaceholderDefaults | null;
 }
 //#endregion
-//#region pptx/core/core/runtime/PptxHandlerRuntimeSlideParsing.d.ts
-declare class PptxHandlerRuntime$31 extends PptxHandlerRuntime$32 {
+//#region pptx/core/core/runtime/PptxHandlerRuntimeMasterElements.d.ts
+declare class PptxHandlerRuntime$27 extends PptxHandlerRuntime$28 {
   /**
-   * Parse text body from a connector shape (p:cxnSp > p:txBody).
-   * Uses the same text run extraction logic as regular shapes but
-   * without placeholder inheritance (connectors don't have placeholders).
+   * Parse a `CT_TextListStyle` node (`a:defPPr` + `a:lvl1pPr` … `a:lvl9pPr`)
+   * into a level-keyed style map. Used for `<p:txStyles>` children
+   * (`p:titleStyle`, `p:bodyStyle`, `p:otherStyle`) — see ECMA-376 §19.3.1.52.
    */
-  protected parseConnectorTextBody(txBody: XmlObject | undefined, slidePath?: string): ConnectorTextResult | null;
-  protected parseSlide(slideXml: XmlObject, slidePath: string): Promise<PptxElement[]>;
+  protected parseTextListStyle(node: XmlObject | undefined): PptxTextStyleLevels | undefined;
+  /**
+   * Parse `<p:txStyles>` from a slide-master XML object into a structured
+   * {@link PptxMasterTextStyles}. Used to populate `PptxSlideMaster.txStyles`
+   * so the title/body/other text-style cascade (P-H1) is visible on the
+   * typed model.
+   */
+  protected parseMasterTxStyles(masterXml: XmlObject | undefined): PptxMasterTextStyles | undefined;
+  /**
+   * Enrich an array of {@link PptxSlideMaster} entries (already produced by
+   * `parseSlideMasters`) with parsed `<p:txStyles>`. Loads each master's XML
+   * once, parses, and caches it in `masterXmlMap` for downstream consumers.
+   *
+   * Also stores the parsed result on the per-master cache so that the
+   * inheritance chain in `applyMasterTextStyleCascade` can find it without
+   * re-parsing.
+   */
+  protected enrichSlideMastersWithTxStyles(slideMasters: PptxSlideMaster[]): Promise<void>;
+  protected parsePresentationDefaultTextStyle(): void;
+  protected getMasterElements(layoutPath: string): Promise<PptxElement[]>;
 }
 //#endregion
-//#region pptx/core/core/runtime/PptxHandlerRuntimeColorAndEffects.d.ts
-declare class PptxHandlerRuntime$30 extends PptxHandlerRuntime$31 {
+//#region pptx/core/core/runtime/PptxHandlerRuntimeAuxiliaryMasterElements.d.ts
+/** The slice of each master/layout model this parser writes to. */
+interface MasterPartElementHost {
+  path: string;
+  elements?: PptxElement[];
+  backgroundImage?: string;
+  backgroundImageProperties?: PptxImageProperties;
   /**
-   * Forward declaration – implemented in PptxHandlerRuntimeThemeProcessing.
-   * Re-resolves gradient stops by substituting `phClr` with the given colour.
+   * Already resolved by the master/layout parser. Read here only so the save
+   * side can tell a chosen colour from a flattened `p:bgRef`.
    */
-  protected reResolveGradientWithPhClr(_gradNode: XmlObject, _phClrValue: string): {
-    stops: NonNullable<ShapeStyle['fillGradientStops']>;
-    css: string | undefined;
-  };
+  backgroundColor?: string;
+}
+declare class PptxHandlerRuntime$26 extends PptxHandlerRuntime$27 {
+  /** Parse every editable element in a master or layout shape tree. */
+  protected enrichMasterPartElements(part: MasterPartElementHost | undefined, rootTag: MasterPartRootTag): Promise<void>;
   /**
-   * Forward declaration – implemented in PptxHandlerRuntimeThemeProcessing.
-   * Parses a layout-level colour map override.
+   * Populate `elements` on every slide master and on each of its layouts.
+   *
+   * Scheme colours on a master's own shapes must resolve through that
+   * master's colour map and theme, so the active master state is switched
+   * per part and reset to the deck-wide snapshot afterwards.
    */
-  protected parseLayoutClrMapOverride(_layoutXml: XmlObject): Record<string, string> | null;
-  protected getDefaultSchemeColorMap(): Record<string, string>;
-  protected resolveThemeColor(schemeKey: string): string | undefined;
-  protected normalizeStrokeDashType(value: unknown): StrokeDashType | undefined;
-  protected normalizeConnectorArrowType(value: unknown): ConnectorArrowType | undefined;
-  protected extractBlurStyle(shapeProps: XmlObject): Partial<ShapeStyle>;
-  protected extractEffectDagStyle(shapeProps: XmlObject): Partial<ShapeStyle>;
-  protected extractFillOverlayStyle(shapeProps: XmlObject): Partial<ShapeStyle>;
-  protected extractReflectionStyle(shapeProps: XmlObject): Partial<ShapeStyle>;
-  protected extractSoftEdgeStyle(shapeProps: XmlObject): Partial<ShapeStyle>;
-  protected extractGlowStyle(shapeProps: XmlObject): Partial<ShapeStyle>;
-  protected extractInnerShadowStyle(shapeProps: XmlObject): Partial<ShapeStyle>;
-  protected extractShadowStyle(shapeProps: XmlObject): Partial<ShapeStyle>;
-  protected extractGradientFillCss(gradFill: XmlObject): string | undefined;
-  protected buildGradientCssFromStops(stops: NonNullable<ShapeStyle['fillGradientStops']>, type: NonNullable<ShapeStyle['fillGradientType']>, angle: number): string | undefined;
-  protected extractGradientAngle(gradFill: XmlObject): number;
-  protected extractGradientType(gradFill: XmlObject): NonNullable<ShapeStyle['fillGradientType']>;
-  protected extractGradientStops(gradFill: XmlObject): NonNullable<ShapeStyle['fillGradientStops']>;
-  protected extractGradientOpacity(gradFill: XmlObject): number | undefined;
-  protected parseColorChoice(colorChoice: XmlObject | undefined, placeholderColor?: string): string | undefined;
+  protected enrichSlideMasterElements(masters: PptxSlideMaster[]): Promise<void>;
+  /** Parse every editable element in a notes or handout master shape tree. */
+  protected enrichAuxiliaryMasterElements(master: PptxNotesMaster | PptxHandoutMaster | undefined, rootTag: 'p:notesMaster' | 'p:handoutMaster'): Promise<void>;
+  private rememberUnparsedMasterNodes;
 }
 //#endregion
-//#region pptx/core/core/runtime/PptxHandlerRuntimeBackgroundParsing.d.ts
-declare class PptxHandlerRuntime$29 extends PptxHandlerRuntime$30 {
+//#region pptx/core/core/runtime/PptxHandlerRuntimeLayoutElements.d.ts
+declare class PptxHandlerRuntime$25 extends PptxHandlerRuntime$26 {
   /**
-   * Preserve the visual properties authored on a background `a:blipFill`.
+   * Parse the layout artwork inherited by a slide.
    *
-   * The decoded image URL alone is not enough to reproduce PowerPoint: crop,
-   * stretch/tile placement and blip effects such as `a:alphaModFix` live next
-   * to the relationship id and otherwise disappear during slide assembly.
+   * @param slidePath - Archive path of the slide whose layout to resolve.
    */
-  protected extractBackgroundImageProperties(slideXml: XmlObject, rootElement?: string): PptxImageProperties | undefined;
-  protected extractBackgroundImage(slideXml: XmlObject, slidePath: string, rootElement?: string): Promise<string | undefined>;
-  protected extractBackgroundColor(slideXml: XmlObject, rootElement?: string): string | undefined;
+  protected getLayoutElements(slidePath: string): Promise<PptxElement[]>;
   /**
-   * Composite a resolved background colour with its `a:alpha` (or
-   * `a:alphaMod`/`a:alphaOff`) opacity onto opaque white.
+   * Parse a layout's artwork given the layout's own archive path.
    *
-   * PowerPoint renders a semi-transparent slide/layout/master background
-   * against white, never against whatever happens to sit behind the
-   * viewer's stage (a white canvas, a dark presentation-mode backdrop, a
-   * thumbnail strip). Blending once here keeps `backgroundColor` a plain
-   * `#RRGGBB` value that looks the same on every backdrop, matching
-   * PowerPoint rather than emitting `rgba()` and letting alpha bleed
-   * through whatever the stage happens to be. See issue #288.
-   */
-  private blendBackgroundColorOntoWhite;
-  /**
-   * A deep-cloned snapshot of the slide's own `<p:bgPr>`, exactly as parsed,
-   * for the save writer to restore verbatim when nothing about the
-   * background changed (see {@link AuthoredSlideBackground.rawBgPr}).
+   * Split out from {@link getLayoutElements} so callers that already know
+   * which layout they want (the layout gallery) do not have to invent a slide
+   * that points at it.
    *
-   * Deep-cloned rather than returned by reference: `extractBackgroundColor`
-   * flattens this same node into a single colour string that survives on
-   * the model across an arbitrary number of saves in one handler session,
-   * while `slideXml` here is the cached parse of the ORIGINAL part, which
-   * later saves mutate in place. A live reference would go stale the moment
-   * a save touched the slide for an unrelated reason.
+   * @param layoutPath - Archive path of the `p:sldLayout` part.
    */
-  protected extractOwnBackgroundNode(slideXml: XmlObject, rootElement?: string): XmlObject | undefined;
+  protected getLayoutElementsByPath(layoutPath: string): Promise<PptxElement[]>;
+}
+//#endregion
+//#region pptx/core/core/runtime/PptxHandlerRuntimeLayoutPreviews.d.ts
+/**
+ * Layout thumbnail sourcing for the New Slide / Layout galleries.
+ *
+ * Previews are produced on request rather than during load. Materialising
+ * every layout's artwork means parsing each `p:sldLayout` part and decoding
+ * the images it references, which is measurable on decks carrying several
+ * masters, and the majority of sessions never open the gallery at all. The
+ * results are memoised, so opening the gallery a second time is free.
+ */
+declare class PptxHandlerRuntime$24 extends PptxHandlerRuntime$25 {
+  private layoutPreviewCache;
   /**
-   * The `<p:bgRef>` twin of {@link extractOwnBackgroundNode}: a deep-cloned
-   * snapshot of the slide's own `<p:bgRef idx="…"><a:schemeClr .../></p:bgRef>`
-   * (a background that follows the theme's `a:bgFillStyleLst` rather than
-   * carrying a literal fill), for the save writer to restore verbatim.
+   * Build (or return the memoised) preview for one layout.
    *
-   * Without this, a slide authoring `p:bgRef` had no snapshot at all (only
-   * `p:bgPr` was captured), so the save writer's "nothing changed, preserve
-   * verbatim" guard never matched and it fell through to rebuilding
-   * `<p:bgPr><a:solidFill><a:srgbClr .../></a:solidFill></p:bgPr>` from the
-   * flattened colour on every save, replacing the theme reference with a
-   * literal fill and severing the slide from later theme changes.
+   * @param layoutPath - Archive path of the `p:sldLayout` part.
+   * @returns The preview, or `null` when the archive holds no such layout.
    */
-  protected extractOwnBackgroundRefNode(slideXml: XmlObject, rootElement?: string): XmlObject | undefined;
+  getLayoutPreview(layoutPath: string): Promise<PptxLayoutPreview | null>;
   /**
-   * Resolve a `<p:bgRef>` element to a flat colour string.
-   *
-   * Per ECMA-376 §20.1.4.2.10 the `@idx` attribute selects an entry
-   * from one of two style matrices on the active theme:
+   * Build previews for every layout the presentation defines.
    *
-   * - `idx == 0` → no fill (transparent / undefined)
-   * - `1 ≤ idx ≤ 999` → `fmtScheme/fillStyleLst[idx-1]`
-   * - `1001 ≤ idx ≤ 1003` → `fmtScheme/bgFillStyleLst[idx-1001]`
+   * The default order matches `getLayoutOptions`, since both walk the layout
+   * XML map, which the master parser fills in `p:sldLayoutIdLst` order.
    *
-   * When the resolved fill is a gradient or pattern we surface its
-   * primary colour; gradient CSS is handled separately by
-   * {@link extractBackgroundGradient}. The colour child of `bgRef`
-   * acts as the `phClr` placeholder for any `phClr` tokens inside the
-   * referenced fill definition.
+   * @param layoutPaths - Restricts the result to these layouts; defaults to
+   *   all of them, which is what an unscoped gallery wants.
    */
-  protected resolveBackgroundRefColor(bgRef: XmlObject): string | undefined;
+  getLayoutPreviews(layoutPaths?: readonly string[]): Promise<PptxLayoutPreview[]>;
+  /** Drop memoised previews, e.g. after a layout is edited in template mode. */
+  protected invalidateLayoutPreviews(layoutPath?: string): void;
   /**
-   * Extract a structured pattern fill (`<a:pattFill>`) from a slide
-   * background. Returns the preset name plus resolved fg/bg colours so
-   * renderers can draw a real SVG pattern instead of a flat fill.
-   *
-   * `a:alpha` (or `a:alphaMod`/`a:alphaOff`) on either `a:fgClr` or
-   * `a:bgClr` is composited onto white the same way the flat-colour
-   * fallback in {@link extractBackgroundColor} already does, matching how
-   * PowerPoint renders a semi-transparent pattern colour: always against
-   * white, never against whatever backdrop happens to sit behind the
-   * stage. See issue #288.
-   *
-   * ECMA-376 §20.1.8.47.
+   * Resolve the background a layout thumbnail should paint, falling back to
+   * the layout's master when the layout itself declares none.
    */
-  protected extractBackgroundPattern(slideXml: XmlObject, rootElement?: string): PptxSlideBackgroundPattern | undefined;
+  private resolveLayoutPreviewBackground;
+}
+//#endregion
+//#region pptx/core/core/runtime/PptxHandlerRuntimeThemeFormatScheme.d.ts
+/**
+ * Ordered fill-child tag tokens recognised inside `a:fillStyleLst` /
+ * `a:bgFillStyleLst`. Used by {@link extractFillStyleListChildOrder} to
+ * recover document order from raw XML when fast-xml-parser has merged
+ * heterogeneous siblings into typed buckets.
+ */
+declare const FILL_LIST_CHILD_TAGS: readonly ['a:solidFill', 'a:gradFill', 'a:pattFill', 'a:noFill', 'a:grpFill'];
+type FillListChildTag = (typeof FILL_LIST_CHILD_TAGS)[number];
+declare class PptxHandlerRuntime$23 extends PptxHandlerRuntime$24 {
   /**
-   * Extract the `<p:bgPr/@shadeToTitle>` boolean attribute from a slide
-   * background. Captured here purely as a passthrough flag on the model;
-   * the actual "shade the gradient toward the title colour" effect is
-   * applied downstream by `pptx-viewer-shared`'s `getSlideBackgroundStyle`
-   * (`render/background-shade-to-title.ts`), not by core.
+   * Build a fill-style entry for one child node based on its tag.
+   */
+  private buildFillStyleEntry;
+  /**
+   * Collect fill-style children from a style list node, preserving
+   * document order when an `orderHint` is supplied (extracted from the
+   * raw theme XML). Handles `a:solidFill`, `a:gradFill`, `a:pattFill`,
+   * `a:noFill`, `a:grpFill`.
    *
-   * ECMA-376 §19.3.1.2 (CT_BackgroundProperties).
+   * fast-xml-parser without `preserveOrder` collapses heterogeneous
+   * siblings into per-tag buckets and we lose the relative document
+   * order. When the caller supplies an `orderHint` (a list of tag names
+   * in source order recovered via {@link extractFillStyleListChildOrder})
+   * we walk the buckets in step with the hint and emit entries in true
+   * document order. Without a hint we fall back to the historical
+   * solid → gradient → pattern → noFill → grpFill grouping.
    */
-  protected extractBackgroundShadeToTitle(slideXml: XmlObject, rootElement?: string): boolean | undefined;
+  protected collectFillChildren(listNode: XmlObject, orderHint?: readonly FillListChildTag[]): PptxThemeFillStyle[];
   /**
-   * Extract a CSS gradient string from a slide/layout/master background.
-   * Handles `a:gradFill` within `p:bgPr` and gradient-based `p:bgRef`.
+   * Parse each child of a `a:fillStyleLst` (or `a:bgFillStyleLst`).
+   * Children can be `a:solidFill`, `a:gradFill`, `a:pattFill`,
+   * `a:noFill`, or `a:grpFill`. The list is ordered and 1-indexed by
+   * position; supply `orderHint` to recover document order when the
+   * parser collapsed heterogeneous siblings.
    */
-  protected extractBackgroundGradient(slideXml: XmlObject, rootElement?: string): string | undefined;
+  protected parseFillStyleList(listNode: XmlObject | undefined, orderHint?: readonly FillListChildTag[]): PptxThemeFillStyle[];
   /**
-   * Reuse the cached parse of a layout XML part, parsing (and caching) on a
-   * miss. Background resolution runs per slide but the layout/master parts are
-   * large (a themed master can be ~200 KB); re-parsing them for every slide
-   * dominated load time, so share the same parsed object `getLayoutElements`
-   * already populated.
+   * Parse `a:lnStyleLst` children (`a:ln` elements) into an array of
+   * {@link PptxThemeLineStyle} entries.
    */
-  protected resolveCachedLayoutXml(layoutPath: string): Promise<XmlObject | undefined>;
-  /** Reuse the cached parse of a master XML part, parsing (and caching) on a miss. */
-  protected resolveCachedMasterXml(masterPath: string): Promise<XmlObject | undefined>;
-  protected getMasterBackgroundImage(layoutPath: string): Promise<string | undefined>;
-  protected getMasterBackgroundImageProperties(layoutPath: string): Promise<PptxImageProperties | undefined>;
-  protected getLayoutBackgroundImage(slidePath: string): Promise<string | undefined>;
-  protected getLayoutBackgroundImageProperties(slidePath: string): Promise<PptxImageProperties | undefined>;
-  protected getLayoutBackgroundColor(slidePath: string): Promise<string | undefined>;
+  protected parseLineStyleList(listNode: XmlObject | undefined): PptxThemeLineStyle[];
   /**
-   * Resolve the slide master's background colour given a layout path.
+   * Parse `a:effectStyleLst` children (`a:effectStyle`) into an array
+   * of {@link PptxThemeEffectStyle} entries.  Each style wraps an
+   * `a:effectLst` node that can contain shadow, glow, soft-edge, etc.
    */
-  protected getMasterBackgroundColor(layoutPath: string): Promise<string | undefined>;
+  protected parseEffectStyleList(listNode: XmlObject | undefined): PptxThemeEffectStyle[];
 }
 //#endregion
-//#region pptx/core/core/runtime/PptxHandlerRuntimeSlideUtils.d.ts
-declare class PptxHandlerRuntime$28 extends PptxHandlerRuntime$29 {
+//#region pptx/core/core/runtime/PptxHandlerRuntimeThemeOverrides.d.ts
+declare class PptxHandlerRuntime$22 extends PptxHandlerRuntime$23 {
   /**
-   * Retrieve the background gradient from a layout, falling back to master.
+   * Parse the `a:fmtScheme` element from the theme into a structured
+   * {@link PptxThemeFormatScheme}.  Each sub-list (fillStyleLst, lnStyleLst,
+   * effectStyleLst, bgFillStyleLst) contains up to three intensity levels
+   * (subtle / moderate / intense) referenced by 1-based index.
+   *
+   * When `rawXml` is supplied (the original theme/themeOverride XML
+   * source), the document order of fill children is recovered via a
+   * targeted regex scan and threaded into {@link parseFillStyleList} so
+   * mixed solid/grad/blip/grpFill lists round-trip in source order even
+   * though fast-xml-parser collapses heterogeneous siblings into typed
+   * buckets.
+   */
+  protected parseFormatScheme(fmtScheme: XmlObject, rawXml?: string): PptxThemeFormatScheme;
+  /**
+   * Extract a colour map override from a `p:clrMapOvr` node.
+   * Returns `null` when the node is absent, empty, or specifies
+   * `a:masterClrMapping` (meaning "inherit from master").
+   *
+   * Each attribute value is an `ST_ColorSchemeIndex` token and is normalised
+   * TO that enumeration rather than case-folded: the parsed map is written
+   * straight back out by `buildClrMapOverrideXml`, and the enumeration is
+   * case sensitive, so lowercasing `folHlink` (its only camel-cased member)
+   * used to make PowerPoint refuse the whole saved package with 0x80070570.
+   * A value outside the enumeration is dropped and reported, never written
+   * through; the writer then supplies the standard default for that alias.
    */
-  protected getLayoutBackgroundGradient(slidePath: string): Promise<string | undefined>;
+  protected parseClrMapOverrideNode(clrMapOvr: XmlObject | undefined): Record<string, string> | null;
   /**
-   * Resolve the slide master's background gradient given a layout path.
+   * Parse `p:clrMapOvr` from a slide's XML.  Returns a mapping from logical
+   * colour name (bg1, tx1, ...) to the theme colour slot it should resolve to,
+   * or `null` when the slide inherits from the master (`a:masterClrMapping`
+   * or no override present).
    */
-  protected getMasterBackgroundGradient(layoutPath: string): Promise<string | undefined>;
+  protected parseSlideClrMapOverride(slideXml: XmlObject): Record<string, string> | null;
   /**
-   * Find the layout file path referenced by a slide via its relationships.
+   * Parse `p:clrMapOvr` from a slide layout's XML.  Layouts can override
+   * the master's colour map just like slides can.
    */
-  protected findLayoutPathForSlide(slidePath: string): string | undefined;
+  protected parseLayoutClrMapOverride(layoutXml: XmlObject): Record<string, string> | null;
   /**
-   * Find the master file path referenced by a layout via its relationships.
+   * Apply a theme override for the duration of parsing a layout or slide.
+   * Saves the current theme state, applies the override, and returns a
+   * restore function that must be called when done.
    */
-  protected findMasterPathForLayoutBase(layoutPath: string): string | undefined;
+  protected applyThemeOverrideState(override: {
+    colorOverrides?: Record<string, string>;
+    formatSchemeOverride?: PptxThemeFormatScheme;
+  }): () => void;
   /**
-   * Switch the active master state (clrMap + theme color/font/format
-   * scheme) so that scheme-colour resolution for the slide currently
-   * being parsed walks through the correct master.
-   *
-   * Multi-master decks must resolve scheme colours against each slide's
-   * own master rather than always against `masterFiles[0]`.
+   * Load and apply a theme override part referenced from a layout's or
+   * slide's relationships.  Theme overrides (`themeOverride*.xml`) can
+   * replace the colour scheme, font scheme, and/or format scheme for
+   * the scope of a specific layout or slide.
    *
-   * Phase 2 Stream B / C-H4.
+   * The method caches results so each override file is parsed at most once.
+   * Overrides are applied as temporary deltas: the caller should save and
+   * restore `themeColorMap`, `themeFontMap`, and `themeFormatScheme` around
+   * the scope where the override is active.
    */
-  protected setActiveMasterForSlide(slidePath: string): Promise<void>;
+  protected loadThemeOverride(partBasePath: string): Promise<{
+    colorOverrides?: Record<string, string>;
+    formatSchemeOverride?: PptxThemeFormatScheme;
+  } | null>;
+}
+//#endregion
+//#region pptx/core/core/runtime/PptxHandlerRuntimeThemeRefResolution.d.ts
+declare class PptxHandlerRuntime$21 extends PptxHandlerRuntime$22 {
   /**
-   * Point colour/font/format resolution at one master's theme, or back at
-   * the deck-wide snapshot when `masterPath` is undefined.
-   *
-   * Split out of {@link setActiveMasterForSlide} because the Slide Master
-   * view parses each master's own shape tree outside any slide, and its
-   * scheme colours must resolve through that master rather than through
-   * whichever slide happened to be parsed last.
+   * Resolve a `a:effectRef` element into concrete effect properties
+   * by looking up `@_idx` in the theme format scheme's effect style list.
    */
-  protected applyMasterThemeState(masterPath: string | undefined): void;
+  protected resolveThemeEffectRef(refNode: XmlObject, style: ShapeStyle): void;
   /**
-   * Extract the `p:bg/@showAnimation` flag from a slide's XML.
-   * Returns `true` when the background should animate, `false` when
-   * explicitly disabled, or `undefined` when the attribute is absent
-   * (defaults to true per OOXML spec).
+   * Resolve a `a:lnRef` element into concrete stroke properties by
+   * looking up `@_idx` in the theme format scheme's line style list.
    */
-  protected extractBackgroundShowAnimation(slideXml: XmlObject): boolean | undefined;
+  protected resolveThemeLineRef(refNode: XmlObject, style: ShapeStyle): void;
   /**
-   * Extract the `p:sld/@showMasterSp` flag.
-   * Returns `false` when master shapes should be hidden, `true` when
-   * explicitly shown, or `undefined` when the attribute is absent
-   * (defaults to true per OOXML spec).
+   * Re-resolve a gradient fill's stops by substituting `phClr` occurrences
+   * with the given override colour.  When the gradient node contains
+   * `a:schemeClr @val="phClr"`, the override colour is injected.
    */
-  protected extractShowMasterShapes(slideXml: XmlObject): boolean | undefined;
+  protected reResolveGradientWithPhClr(gradNode: XmlObject, phClrValue: string): {
+    stops: NonNullable<ShapeStyle['fillGradientStops']>;
+    css: string | undefined;
+  };
   /**
-   * Extract the `p:sld/@showMasterPhAnim` flag: whether inherited master
-   * placeholder animations should replay on this slide. Mirrors
-   * `p:sldLayout/@showMasterPhAnim` (see `parseSlideLayoutAttributes`).
-   * Distinct from {@link extractShowMasterShapes}, which governs shape
-   * VISIBILITY rather than animation timing.
+   * Resolve a `a:fillRef` element into concrete {@link ShapeStyle} fill
+   * properties by looking up the 1-based `@_idx` in the theme's format
+   * scheme fill style list.
    *
-   * Returns `false` when disabled, `true` when explicitly enabled, or
-   * `undefined` when the attribute is absent (defaults to true per spec).
+   * Per the OOXML spec:
+   * - idx 0 or 1000 → no fill
+   * - idx 1-3 → fillStyleLst[idx-1]
+   * - idx 1001-1003 → bgFillStyleLst[idx-1001]
+   *
+   * The colour child of the ref (e.g. `a:schemeClr`) acts as a
+   * "placeholder colour" (`phClr`) override for `phClr` tokens inside
+   * the fill definition.
    */
-  protected extractShowMasterPhAnim(slideXml: XmlObject): boolean | undefined;
-  protected isSlideHidden(slideXmlObj: XmlObject, slideIdEntry: XmlObject | undefined): boolean;
-  protected extractTextFromTxBody(txBody: XmlObject | undefined): string;
-  protected extractSlideNotes(slidePath: string): Promise<{
-    notes?: string;
-    notesSegments?: TextSegment[];
-    notesShapes?: PptxElement[];
-    notesClrMapOverride?: Record<string, string>;
-    notesCSldName?: string;
-  }>;
+  protected resolveThemeFillRef(refNode: XmlObject, style: ShapeStyle): void;
 }
 //#endregion
-//#region pptx/core/core/runtime/PptxHandlerRuntimePlaceholderStyles.d.ts
-declare class PptxHandlerRuntime$27 extends PptxHandlerRuntime$28 {
+//#region pptx/core/core/runtime/PptxHandlerRuntimeThemeLoading.d.ts
+declare class PptxHandlerRuntime$20 extends PptxHandlerRuntime$21 {
+  protected resolvePrimaryThemePath(): Promise<string | undefined>;
+  protected parseThemeOptions(): Promise<PptxThemeOption[]>;
   /**
-   * Parse a single `a:lvlXpPr` node into a structured
-   * {@link PlaceholderTextLevelStyle}.
-   *
-   * The paragraph-level attributes go through the same helpers the
-   * per-paragraph `a:pPr` path uses (`paragraph-properties-parser`), so a
-   * master `p:txStyles` or layout `a:lstStyle` level carries exactly the
-   * field set a directly-authored paragraph does: margins on both sides,
-   * `rtl`, tab stops, and the full `ST_TextAlignType` token set.
+   * Public API — scan the in-memory ZIP for `ppt/theme/theme*.xml` parts
+   * and return their paths and display names.  Delegates to the
+   * protected {@link parseThemeOptions}.
    */
-  protected parsePlaceholderLevelStyle(levelProps: XmlObject | undefined): PlaceholderTextLevelStyle | null;
-  /** Bullet group of an `a:lvlXpPr` node (`a:bu*` children). */
-  private parsePlaceholderLevelBullet;
-  /** Default run properties of a level (`a:defRPr`: font, size, bold, italic, colour). */
-  private parsePlaceholderLevelRunDefaults;
-}
-//#endregion
-//#region pptx/core/core/runtime/PptxHandlerRuntimePlaceholderDefaults.d.ts
-declare class PptxHandlerRuntime$26 extends PptxHandlerRuntime$27 {
+  getAvailableThemes(): Promise<PptxThemeOption[]>;
   /**
-   * Extract structured {@link PlaceholderDefaults} from a layout or master
-   * shape that carries a `p:ph` element.
+   * Build a structured PptxTheme object from the already-parsed
+   * themeColorMap and themeFontMap for consumption by renderers / UI.
    */
-  protected extractPlaceholderDefaultsFromShape(shape: XmlObject): PlaceholderDefaults | null;
-}
-//#endregion
-//#region pptx/core/core/runtime/PptxHandlerRuntimeMasterElements.d.ts
-declare class PptxHandlerRuntime$25 extends PptxHandlerRuntime$26 {
+  protected buildThemeObject(): PptxTheme | undefined;
   /**
-   * Parse a `CT_TextListStyle` node (`a:defPPr` + `a:lvl1pPr` … `a:lvl9pPr`)
-   * into a level-keyed style map. Used for `<p:txStyles>` children
-   * (`p:titleStyle`, `p:bodyStyle`, `p:otherStyle`) — see ECMA-376 §19.3.1.52.
+   * Parse every slide master's `<p:clrMap>` element and store the alias
+   * dictionaries on {@link masterClrMaps}. Do *not* mutate
+   * {@link themeColorMap} — alias resolution happens at colour-lookup
+   * time so that:
+   *
+   * 1. The raw theme scheme stays the source of truth (clrMap is a
+   *    routing layer, not a colour table).
+   * 2. Multi-master decks resolve each slide against its own master's
+   *    clrMap rather than always against `masterFiles[0]`.
+   * 3. Layout `clrMapOvr` semantics work correctly when a slide's master
+   *    differs from the deck's first master.
+   *
+   * Phase 2 Stream B / C-H4.
    */
-  protected parseTextListStyle(node: XmlObject | undefined): PptxTextStyleLevels | undefined;
+  protected applySlideMasterColorMap(_defaultMap: Record<string, string>): Promise<void>;
   /**
-   * Parse `<p:txStyles>` from a slide-master XML object into a structured
-   * {@link PptxMasterTextStyles}. Used to populate `PptxSlideMaster.txStyles`
-   * so the title/body/other text-style cascade (P-H1) is visible on the
-   * typed model.
+   * Parse a single theme part into structured colour, font, and format
+   * scheme dictionaries. Used both for the global default theme and for
+   * each master's per-master theme (multi-master support).
+   *
+   * Phase 2 Stream B / C-H4.
    */
-  protected parseMasterTxStyles(masterXml: XmlObject | undefined): PptxMasterTextStyles | undefined;
+  protected parseThemePart(themePath: string): Promise<{
+    colorMap: Record<string, string>;
+    fontMap: Record<string, string>;
+    formatScheme: PptxThemeFormatScheme | undefined;
+  } | null>;
   /**
-   * Enrich an array of {@link PptxSlideMaster} entries (already produced by
-   * `parseSlideMasters`) with parsed `<p:txStyles>`. Loads each master's XML
-   * once, parses, and caches it in `masterXmlMap` for downstream consumers.
+   * Parse `<a:font script="…" typeface="…"/>` children of a major or
+   * minor font node into a `script -> typeface` dictionary.
    *
-   * Also stores the parsed result on the per-master cache so that the
-   * inheritance chain in `applyMasterTextStyleCascade` can find it without
-   * re-parsing.
+   * fast-xml-parser collapses repeated tags into arrays, so iterate
+   * over the array form regardless of how many siblings are present.
+   *
+   * Phase 4 Stream A / M4.
    */
-  protected enrichSlideMastersWithTxStyles(slideMasters: PptxSlideMaster[]): Promise<void>;
-  protected parsePresentationDefaultTextStyle(): void;
-  protected getMasterElements(layoutPath: string): Promise<PptxElement[]>;
-}
-//#endregion
-//#region pptx/core/core/runtime/PptxHandlerRuntimeAuxiliaryMasterElements.d.ts
-/** The slice of each master/layout model this parser writes to. */
-interface MasterPartElementHost {
-  path: string;
-  elements?: PptxElement[];
-  backgroundImage?: string;
-  backgroundImageProperties?: PptxImageProperties;
   /**
-   * Already resolved by the master/layout parser. Read here only so the save
-   * side can tell a chosen colour from a flattened `p:bgRef`.
+   * Flatten a per-theme-path script-override map (`themePath -> {script ->
+   * typeface}`) into a single `{script -> typeface}` lookup for
+   * {@link buildThemeObject}. Earlier entries win on collision, which matches
+   * the primary-theme-first parse order. Phase 4 Stream A / M4 (#83).
    */
-  backgroundColor?: string;
-}
-declare class PptxHandlerRuntime$24 extends PptxHandlerRuntime$25 {
-  /** Parse every editable element in a master or layout shape tree. */
-  protected enrichMasterPartElements(part: MasterPartElementHost | undefined, rootTag: MasterPartRootTag): Promise<void>;
+  protected aggregateFontScriptOverrides(perPathMap: Map<string, Record<string, string>>): Record<string, string>;
+  protected collectFontScriptOverrides(fontNode: XmlObject | undefined): Record<string, string>;
   /**
-   * Populate `elements` on every slide master and on each of its layouts.
-   *
-   * Scheme colours on a master's own shapes must resolve through that
-   * master's colour map and theme, so the active master state is switched
-   * per part and reset to the deck-wide snapshot afterwards.
+   * Resolve the theme file path referenced by a given master's `.rels`.
+   * Returns `undefined` when the master has no theme relationship.
    */
-  protected enrichSlideMasterElements(masters: PptxSlideMaster[]): Promise<void>;
-  /** Parse every editable element in a notes or handout master shape tree. */
-  protected enrichAuxiliaryMasterElements(master: PptxNotesMaster | PptxHandoutMaster | undefined, rootTag: 'p:notesMaster' | 'p:handoutMaster'): Promise<void>;
-  private rememberUnparsedMasterNodes;
+  protected resolveThemePathForMaster(masterPath: string): Promise<string | undefined>;
+  /**
+   * Populate {@link masterThemeColorMaps}, {@link masterThemeFontMaps},
+   * and {@link masterThemeFormatSchemes} for every slide master in the
+   * deck. Multi-master support — Phase 2 Stream B / C-H4.
+   */
+  protected loadPerMasterThemes(): Promise<void>;
+  protected loadThemeData(): Promise<void>;
 }
 //#endregion
-//#region pptx/core/core/runtime/PptxHandlerRuntimeLayoutElements.d.ts
-declare class PptxHandlerRuntime$23 extends PptxHandlerRuntime$24 {
+//#region pptx/core/core/runtime/PptxHandlerRuntimeThemeProcessing.d.ts
+/**
+ * Theme editing: update colour scheme, font scheme, and name in the zip.
+ *
+ * A deck may carry one theme part per slide master. Every edit therefore
+ * targets ALL theme parts the masters point at (the same set the save
+ * pipeline's `persistThemeParts` walks), unless the caller narrows it with an
+ * explicit `themePaths` list. The in-memory maps are refreshed alongside:
+ * the per-master maps, the deck-wide snapshots, and the currently active
+ * `themeColorMap` / `themeFontMap`.
+ */
+declare class PptxHandlerRuntime$19 extends PptxHandlerRuntime$20 {
+  /**
+   * The theme parts an edit should touch, primary theme first.
+   *
+   * Defaults to every theme referenced by a slide master. A deck whose
+   * masters were never resolved (nothing loaded yet, or a bare zip) falls
+   * back to the primary theme part so the legacy single-theme behaviour is
+   * preserved.
+   */
+  protected resolveThemeEditTargets(themePaths?: readonly string[]): Promise<string[]>;
+  private readThemePart;
   /**
-   * Parse the layout artwork inherited by a slide.
+   * Parse, edit, and write back every target theme part. Parts the edit
+   * cannot apply to (no `a:themeElements`) are left untouched.
    *
-   * @param slidePath - Archive path of the slide whose layout to resolve.
+   * @returns the paths that were rewritten
    */
-  protected getLayoutElements(slidePath: string): Promise<PptxElement[]>;
+  protected rewriteThemeParts(themePaths: readonly string[] | undefined, edit: (data: XmlObject) => boolean): Promise<string[]>;
+  /** Masters whose theme part is among the rewritten paths. */
+  protected mastersUsingThemes(themePaths: readonly string[]): string[];
   /**
-   * Parse a layout's artwork given the layout's own archive path.
+   * Update the theme's colour scheme in-memory and in the zip.
    *
-   * Split out from {@link getLayoutElements} so callers that already know
-   * which layout they want (the layout gallery) do not have to invent a slide
-   * that points at it.
+   * Refreshes `themeColorMap`, the deck-wide snapshot, and every per-master
+   * colour map whose theme was rewritten. The `tx1` / `bg1` / `tx2` / `bg2`
+   * alias slots are routed through each master's own `p:clrMap` rather than
+   * assuming the default `tx1 = dk1` mapping, so a master that swaps light
+   * and dark keeps its swap after the edit.
    *
-   * @param layoutPath - Archive path of the `p:sldLayout` part.
+   * @param themePaths optional explicit theme parts to edit; defaults to
+   *   every theme a slide master references
    */
-  protected getLayoutElementsByPath(layoutPath: string): Promise<PptxElement[]>;
-}
-//#endregion
-//#region pptx/core/core/runtime/PptxHandlerRuntimeLayoutPreviews.d.ts
-/**
- * Layout thumbnail sourcing for the New Slide / Layout galleries.
- *
- * Previews are produced on request rather than during load. Materialising
- * every layout's artwork means parsing each `p:sldLayout` part and decoding
- * the images it references, which is measurable on decks carrying several
- * masters, and the majority of sessions never open the gallery at all. The
- * results are memoised, so opening the gallery a second time is free.
- */
-declare class PptxHandlerRuntime$22 extends PptxHandlerRuntime$23 {
-  private layoutPreviewCache;
+  updateThemeColorScheme(colorScheme: PptxThemeColorScheme, themePaths?: readonly string[]): Promise<void>;
   /**
-   * Build (or return the memoised) preview for one layout.
+   * Update the theme's font scheme in-memory and in the zip, across every
+   * target theme part and the matching per-master font maps.
    *
-   * @param layoutPath - Archive path of the `p:sldLayout` part.
-   * @returns The preview, or `null` when the archive holds no such layout.
+   * @param themePaths optional explicit theme parts to edit; defaults to
+   *   every theme a slide master references
    */
-  getLayoutPreview(layoutPath: string): Promise<PptxLayoutPreview | null>;
+  updateThemeFontScheme(fontScheme: PptxThemeFontScheme, themePaths?: readonly string[]): Promise<void>;
   /**
-   * Build previews for every layout the presentation defines.
-   *
-   * The default order matches `getLayoutOptions`, since both walk the layout
-   * XML map, which the master parser fills in `p:sldLayoutIdLst` order.
+   * Update the theme name in the zip, on every target theme part.
    *
-   * @param layoutPaths - Restricts the result to these layouts; defaults to
-   *   all of them, which is what an unscoped gallery wants.
+   * @param themePaths optional explicit theme parts to edit; defaults to
+   *   every theme a slide master references
    */
-  getLayoutPreviews(layoutPaths?: readonly string[]): Promise<PptxLayoutPreview[]>;
-  /** Drop memoised previews, e.g. after a layout is edited in template mode. */
-  protected invalidateLayoutPreviews(layoutPath?: string): void;
+  updateThemeName(name: string, themePaths?: readonly string[]): Promise<void>;
   /**
-   * Resolve the background a layout thumbnail should paint, falling back to
-   * the layout's master when the layout itself declares none.
+   * Apply a complete theme (both colors and fonts) to the presentation.
+   * This is a convenience method that combines updateThemeColorScheme
+   * and updateThemeFontScheme.
    */
-  private resolveLayoutPreviewBackground;
+  applyTheme(colorScheme: PptxThemeColorScheme, fontScheme: PptxThemeFontScheme, themeName?: string): Promise<void>;
 }
 //#endregion
-//#region pptx/core/core/runtime/PptxHandlerRuntimeThemeFormatScheme.d.ts
-/**
- * Ordered fill-child tag tokens recognised inside `a:fillStyleLst` /
- * `a:bgFillStyleLst`. Used by {@link extractFillStyleListChildOrder} to
- * recover document order from raw XML when fast-xml-parser has merged
- * heterogeneous siblings into typed buckets.
- */
-declare const FILL_LIST_CHILD_TAGS: readonly ['a:solidFill', 'a:gradFill', 'a:pattFill', 'a:noFill', 'a:grpFill'];
-type FillListChildTag = (typeof FILL_LIST_CHILD_TAGS)[number];
-declare class PptxHandlerRuntime$21 extends PptxHandlerRuntime$22 {
+//#region pptx/core/core/runtime/PptxHandlerRuntimeComments.d.ts
+declare class PptxHandlerRuntime$18 extends PptxHandlerRuntime$19 {
   /**
-   * Build a fill-style entry for one child node based on its tag.
+   * Parse modern threaded comments (PowerPoint 2019+ / Office 365).
+   * Modern comments use `p188:cmLst`/`p15:cmLst` roots within
+   * `ppt/comments/modernComment*.xml` or `ppt/comments-extended/...`.
+   * Each `p188:cm` / `p15:cm` node carries `@_id`, `@_authorId`,
+   * `@_created`, `@_status`, text body in `p188:txBody`/`p15:txBody`,
+   * and thread-parent via `@_parentCmId`.
    */
-  private buildFillStyleEntry;
+  protected extractModernSlideComments(slidePath: string): Promise<PptxComment[]>;
+  protected loadModernCommentAuthors(): Promise<void>;
+  protected resolveSlideCommentTarget(slidePath: string): Promise<string | undefined>;
+  protected extractCommentText(commentNode: XmlObject): string;
+  protected extractSlideComments(slidePath: string): Promise<PptxComment[]>;
+  protected loadCommentAuthors(): Promise<void>;
+  /** Derive initials from an author name (first letter of up to 2 tokens). */
+  private toCommentInitials;
+}
+//#endregion
+//#region pptx/core/core/runtime/PptxHandlerRuntimeSmartArtXmlUtils.d.ts
+declare class PptxHandlerRuntime$17 extends PptxHandlerRuntime$18 {
+  protected readXmlPartByRelationshipId(slidePath: string, relationshipId: string): Promise<{
+    xml: XmlObject;
+    partPath: string;
+    text: string;
+  } | undefined>;
+  protected collectLocalTextValues(node: unknown, localName: string, output: string[]): void;
   /**
-   * Collect fill-style children from a style list node, preserving
-   * document order when an `orderHint` is supplied (extracted from the
-   * raw theme XML). Handles `a:solidFill`, `a:gradFill`, `a:pattFill`,
-   * `a:noFill`, `a:grpFill`.
+   * Extract the per-run text + run-properties of a SmartArt content point's
+   * first paragraph (`dgm:t/a:p/a:r`).
    *
-   * fast-xml-parser without `preserveOrder` collapses heterogeneous
-   * siblings into per-tag buckets and we lose the relative document
-   * order. When the caller supplies an `orderHint` (a list of tag names
-   * in source order recovered via {@link extractFillStyleListChildOrder})
-   * we walk the buckets in step with the hint and emit entries in true
-   * document order. Without a hint we fall back to the historical
-   * solid → gradient → pattern → noFill → grpFill grouping.
+   * Each `a:r` yields one {@link PptxSmartArtTextRun} carrying its joined
+   * `a:t` text and a verbatim copy of its `a:rPr` properties (when present).
+   * Only the first paragraph is captured: SmartArt content points are
+   * single-paragraph in practice, and the round-trip save path rebuilds a
+   * single paragraph from these runs. Returns undefined when there is fewer
+   * than one run worth preserving (a single run is still returned so per-run
+   * formatting like a bold sole run survives).
    */
-  protected collectFillChildren(listNode: XmlObject, orderHint?: readonly FillListChildTag[]): PptxThemeFillStyle[];
+  protected extractSmartArtNodeRuns(point: XmlObject): PptxSmartArtTextRun[] | undefined;
   /**
-   * Parse each child of a `a:fillStyleLst` (or `a:bgFillStyleLst`).
-   * Children can be `a:solidFill`, `a:gradFill`, `a:pattFill`,
-   * `a:noFill`, or `a:grpFill`. The list is ordered and 1-indexed by
-   * position; supply `orderHint` to recover document order when the
-   * parser collapsed heterogeneous siblings.
+   * Extract a content point's per-node visual override.
+   *
+   * Reads the point's presentation `spPr` solid fill and line colour, and the
+   * first run's `rPr` bold / italic / solid fill, into a
+   * {@link PptxSmartArtNodeStyle}. Every field is optional and only set when
+   * present, so an unstyled point yields `undefined` (never throws on missing
+   * structure). This lets the editing UI display the node's current colours.
    */
-  protected parseFillStyleList(listNode: XmlObject | undefined, orderHint?: readonly FillListChildTag[]): PptxThemeFillStyle[];
+  protected extractSmartArtNodeStyle(point: XmlObject): PptxSmartArtNodeStyle | undefined;
+  /** Read the first run's `rPr` of a content point's first paragraph. */
+  private firstRunProperties;
+  /** Interpret an OOXML boolean attribute ("1"/"true"/"on" => true). */
+  private xmlBoolean;
   /**
-   * Parse `a:lnStyleLst` children (`a:ln` elements) into an array of
-   * {@link PptxThemeLineStyle} entries.
+   * Parse background and outline chrome from `dgm:bg` and `dgm:whole`.
    */
-  protected parseLineStyleList(listNode: XmlObject | undefined): PptxThemeLineStyle[];
+  protected parseSmartArtChrome(dataModel: XmlObject | undefined): PptxSmartArtChrome | undefined;
   /**
-   * Parse `a:effectStyleLst` children (`a:effectStyle`) into an array
-   * of {@link PptxThemeEffectStyle} entries.  Each style wraps an
-   * `a:effectLst` node that can contain shadow, glow, soft-edge, etc.
+   * Approximate a non-solid `dgm:bg` fill (gradient or pattern) as a single
+   * display colour, matching the "approximate over drop" precedent used
+   * elsewhere for SmartArt/shape fills: a gradient's own
+   * `extractGradientFillColor` blend (the same helper shape/text gradient
+   * fills already reduce to one colour with), or a pattern's foreground
+   * colour. Returns `undefined` when `bg` has neither (e.g. a blip/picture
+   * fill, or `a:noFill`) - still a silent drop, but no worse than before this
+   * change, and rarer in practice for a diagram background.
    */
-  protected parseEffectStyleList(listNode: XmlObject | undefined): PptxThemeEffectStyle[];
+  private approximateSmartArtBackgroundFill;
+  /**
+   * Parse colour transform from `ppt/diagrams/colors*.xml`.
+   */
+  protected parseSmartArtColorTransform(slidePath: string, colorsRelId: string): Promise<PptxSmartArtColorTransform | undefined>;
+  private parseSmartArtColorTransformImpl;
+  /**
+   * Resolve a scheme colour reference to a hex value using the theme colour map.
+   */
+  protected resolveSmartArtSchemeColor(schemeClr: XmlObject | undefined): string | undefined;
 }
 //#endregion
-//#region pptx/core/core/runtime/PptxHandlerRuntimeThemeOverrides.d.ts
-declare class PptxHandlerRuntime$20 extends PptxHandlerRuntime$21 {
+//#region pptx/core/core/runtime/PptxHandlerRuntimeSmartArtParsing.d.ts
+declare class PptxHandlerRuntime$16 extends PptxHandlerRuntime$17 {
+  protected reportIncompleteSmartArtRelationships(graphicFrame: XmlObject | undefined, relationshipIds: DiagramRelationshipIds | undefined, slidePath: string): void;
+  protected parseSmartArtConnections(dataModel: XmlObject | undefined): {
+    parsedConnections: PptxSmartArtConnection[];
+    parentByNodeId: Map<string, string>;
+  };
   /**
-   * Parse the `a:fmtScheme` element from the theme into a structured
-   * {@link PptxThemeFormatScheme}.  Each sub-list (fillStyleLst, lnStyleLst,
-   * effectStyleLst, bgFillStyleLst) contains up to three intensity levels
-   * (subtle / moderate / intense) referenced by 1-based index.
-   *
-   * When `rawXml` is supplied (the original theme/themeOverride XML
-   * source), the document order of fill children is recovered via a
-   * targeted regex scan and threaded into {@link parseFillStyleList} so
-   * mixed solid/grad/blip/grpFill lists round-trip in source order even
-   * though fast-xml-parser collapses heterogeneous siblings into typed
-   * buckets.
+   * Parse quick style from `ppt/diagrams/quickStyles*.xml`.
    */
-  protected parseFormatScheme(fmtScheme: XmlObject, rawXml?: string): PptxThemeFormatScheme;
+  protected parseSmartArtQuickStyle(slidePath: string, styleRelId: string): Promise<PptxSmartArtQuickStyle | undefined>;
   /**
-   * Extract a colour map override from a `p:clrMapOvr` node.
-   * Returns `null` when the node is absent, empty, or specifies
-   * `a:masterClrMapping` (meaning "inherit from master").
+   * Parse pre-computed shapes from `ppt/diagrams/drawing*.xml`.
+   */
+  protected parseSmartArtDrawingShapes(slidePath: string, drawingRelId: string): Promise<PptxSmartArtDrawingShape[]>;
+  protected parseDrawingShape(sp: XmlObject, index: number, emuPerPx: number, mergedTextColor?: string): PptxSmartArtDrawingShape | null;
+  /**
+   * Build the injected accessor bundle used by the pure drawing-shape style
+   * helpers, binding the shared XML-lookup / colour / gradient / shadow codec
+   * methods so no new colour logic is duplicated here.
+   */
+  private drawingShapeStyleDeps;
+}
+//#endregion
+//#region pptx/core/core/runtime/PptxHandlerRuntimeSmartArt.d.ts
+declare class PptxHandlerRuntime$15 extends PptxHandlerRuntime$16 {
+  getSmartArtDataForGraphicFrame(slidePath: string, graphicFrame: XmlObject | undefined): Promise<PptxSmartArtData | undefined>;
+  private resolveSmartArtDrawingPart;
+  /**
+   * Parse cached SmartArt drawing shapes from an absolute part path.
    *
-   * Each attribute value is an `ST_ColorSchemeIndex` token and is normalised
-   * TO that enumeration rather than case-folded: the parsed map is written
-   * straight back out by `buildClrMapOverrideXml`, and the enumeration is
-   * case sensitive, so lowercasing `folHlink` (its only camel-cased member)
-   * used to make PowerPoint refuse the whole saved package with 0x80070570.
-   * A value outside the enumeration is dropped and reported, never written
-   * through; the writer then supplies the standard default for that alias.
+   * Enumerates `dsp:sp` / bare `dsp:pic` (incl. nested `dsp:grpSp`) and
+   * resolves picture (blip) fills to data URLs via the drawing part's own
+   * relationships. Delegates to a pure helper with an injected dep bundle.
    */
-  protected parseClrMapOverrideNode(clrMapOvr: XmlObject | undefined): Record<string, string> | null;
+  private parseSmartArtDrawingShapesFromPath;
+  /** Bind runtime zip / parser / lookup / image helpers for the drawing parser. */
+  private drawingBlipDeps;
+}
+//#endregion
+//#region pptx/core/core/runtime/PptxHandlerRuntimeChartDetection.d.ts
+declare class PptxHandlerRuntime$14 extends PptxHandlerRuntime$15 {
+  protected detectChartType(plotArea: XmlObject | undefined): PptxChartData['chartType'];
+  protected extractChartPointValues(seriesContainer: XmlObject | undefined, preferNumeric: boolean): string[];
   /**
-   * Parse `p:clrMapOvr` from a slide's XML.  Returns a mapping from logical
-   * colour name (bg1, tx1, ...) to the theme colour slot it should resolve to,
-   * or `null` when the slide inherits from the master (`a:masterClrMapping`
-   * or no override present).
+   * Extract a CATEGORY label list, expanded to its declared length.
+   *
+   * `c:strCache`/`c:numCache` is SPARSE and keyed by `@idx`: a blank category
+   * is simply a missing `c:pt`, and `c:ptCount` gives the true length. A single
+   * empty spacer cell in the source workbook therefore produces a cache with,
+   * say, `ptCount="5"` and no `idx="2"`.
+   *
+   * {@link extractChartPointValues} collapses that to a DENSE four-entry list,
+   * which is right for series names and error-bar arrays but wrong here: the
+   * value cache next to it is expanded by index
+   * (`extractSeriesNumbersWithBlanks`), so the categories came out shorter than
+   * the values. Render sizes the category axis from this array, so every point
+   * past the shortened list went unplotted and the surviving labels sat under
+   * the wrong bars - silently wrong numbers, not a visual glitch.
+   *
+   * Blank slots are kept as empty strings so index alignment survives.
    */
-  protected parseSlideClrMapOverride(slideXml: XmlObject): Record<string, string> | null;
+  protected extractChartCategoryValues(categoryContainer: XmlObject | undefined, preferNumeric: boolean): string[];
   /**
-   * Parse `p:clrMapOvr` from a slide layout's XML.  Layouts can override
-   * the master's colour map just like slides can.
+   * Extract hierarchical category levels from a classic `c:multiLvlStrRef`
+   * (e.g. a PowerPoint Quarter > Month category grouping). See
+   * {@link extractMultiLevelCategoryValues} for the extraction rules; this
+   * is a thin wrapper binding it to the runtime's XML lookup service.
    */
-  protected parseLayoutClrMapOverride(layoutXml: XmlObject): Record<string, string> | null;
+  protected extractChartCategoryLevels(categoryContainer: XmlObject | undefined): {
+    categories: string[];
+    categoryLevels?: string[][];
+  } | undefined;
+  protected extractChartSeriesName(seriesNode: XmlObject): string;
+}
+//#endregion
+//#region pptx/core/core/runtime/PptxHandlerRuntimeChartParsingHelpers.d.ts
+declare class PptxHandlerRuntime$13 extends PptxHandlerRuntime$14 {
   /**
-   * Apply a theme override for the duration of parsing a layout or slide.
-   * Saves the current theme state, applies the override, and returns a
-   * restore function that must be called when done.
+   * Parse `c:plotVisOnly` from the chart root element.
+   *
+   * The `c:plotVisOnly` element controls whether hidden cells are plotted.
+   * - `val="1"` or `val="true"` or absent → only visible data is plotted (returns `true`)
+   * - `val="0"` or `val="false"` → hidden data IS plotted (returns `false`)
+   *
+   * Returns `undefined` when the element is absent (caller defaults to `true`).
    */
-  protected applyThemeOverrideState(override: {
-    colorOverrides?: Record<string, string>;
-    formatSchemeOverride?: PptxThemeFormatScheme;
-  }): () => void;
+  protected parsePlotVisOnly(chartRoot: XmlObject | undefined): boolean | undefined;
   /**
-   * Load and apply a theme override part referenced from a layout's or
-   * slide's relationships.  Theme overrides (`themeOverride*.xml`) can
-   * replace the colour scheme, font scheme, and/or format scheme for
-   * the scope of a specific layout or slide.
+   * Parse `c:pivotSource` from the chart's `c:chartSpace`.
    *
-   * The method caches results so each override file is parsed at most once.
-   * Overrides are applied as temporary deltas: the caller should save and
-   * restore `themeColorMap`, `themeFontMap`, and `themeFormatScheme` around
-   * the scope where the override is active.
+   * The `c:pivotSource` element indicates the chart data originates from
+   * a PivotTable. It contains:
+   * - `c:name` — the pivot table reference (e.g. "[workbook.xlsx]Sheet1!PivotTable1")
+   * - `c:fmtId/@val` — an optional format identifier
+   *
+   * The chart still renders using its cached series data; the pivot source
+   * is metadata preserved for round-trip fidelity.
    */
-  protected loadThemeOverride(partBasePath: string): Promise<{
-    colorOverrides?: Record<string, string>;
-    formatSchemeOverride?: PptxThemeFormatScheme;
-  } | null>;
-}
-//#endregion
-//#region pptx/core/core/runtime/PptxHandlerRuntimeThemeRefResolution.d.ts
-declare class PptxHandlerRuntime$19 extends PptxHandlerRuntime$20 {
+  protected parsePivotSource(chartSpace: XmlObject | undefined): PptxChartData['pivotSource'];
   /**
-   * Resolve a `a:effectRef` element into concrete effect properties
-   * by looking up `@_idx` in the theme format scheme's effect style list.
+   * Parse `c:ofPieChart` options from the chart-type container.
+   *
+   * The `ofPieType` element is required by the schema; its `@val`
+   * defaults to `"pie"` when absent. Other fields (`splitType`,
+   * `splitPos`, `secondPieSize`, `serLines`, `gapWidth`, `custSplit`)
+   * are optional and only included when present in the XML.
    */
-  protected resolveThemeEffectRef(refNode: XmlObject, style: ShapeStyle): void;
+  protected parseOfPieOptions(ofPieContainer: XmlObject | undefined): PptxChartOfPieOptions | undefined;
   /**
-   * Resolve a `a:lnRef` element into concrete stroke properties by
-   * looking up `@_idx` in the theme format scheme's line style list.
+   * Parse `c:view3D` (CT_View3D) from the chart root.
+   *
+   * Returns `undefined` when the element is absent so it does not
+   * round-trip as an empty `<c:view3D/>` placeholder.
    */
-  protected resolveThemeLineRef(refNode: XmlObject, style: ShapeStyle): void;
+  protected parseView3D(chartRoot: XmlObject | undefined): PptxChartView3D | undefined;
   /**
-   * Re-resolve a gradient fill's stops by substituting `phClr` occurrences
-   * with the given override colour.  When the gradient node contains
-   * `a:schemeClr @val="phClr"`, the override colour is injected.
+   * Parse top-level chart chrome flags from `c:chart`:
+   * `c:autoTitleDeleted`, `c:dispBlanksAs`, `c:showDLblsOverMax`.
+   *
+   * Each flag is included in the result only when present on the
+   * source XML so that absence does not produce empty elements on
+   * save.
    */
-  protected reResolveGradientWithPhClr(gradNode: XmlObject, phClrValue: string): {
-    stops: NonNullable<ShapeStyle['fillGradientStops']>;
-    css: string | undefined;
-  };
+  protected parseChartChrome(chartRoot: XmlObject | undefined): PptxChartChrome | undefined;
   /**
-   * Resolve a `a:fillRef` element into concrete {@link ShapeStyle} fill
-   * properties by looking up the 1-based `@_idx` in the theme's format
-   * scheme fill style list.
+   * Capture the raw `c:userShapes` subtree for verbatim round-trip.
    *
-   * Per the OOXML spec:
-   * - idx 0 or 1000 → no fill
-   * - idx 1-3 → fillStyleLst[idx-1]
-   * - idx 1001-1003 → bgFillStyleLst[idx-1001]
+   * The element references a separate drawing part; we never parse
+   * the nested drawing tree here. Returning the raw object means the
+   * save layer can re-emit it unchanged.
+   */
+  protected parseUserShapesXml(chartSpace: XmlObject | undefined): unknown;
+  /** Capture the raw `c:pivotFmts` subtree for verbatim round-trip. */
+  protected parsePivotFmtsXml(chartRoot: XmlObject | undefined): unknown;
+  /**
+   * Parse `c:clrMapOvr` into a flat attribute map.
    *
-   * The colour child of the ref (e.g. `a:schemeClr`) acts as a
-   * "placeholder colour" (`phClr`) override for `phClr` tokens inside
-   * the fill definition.
+   * The element carries 12 `bg1/tx1/bg2/tx2/accent1…6/hlink/folHlink`
+   * attributes that remap theme colour roles for the chart only.
+   * Unknown attributes are preserved as-is so that future schema
+   * additions round-trip without code changes.
    */
-  protected resolveThemeFillRef(refNode: XmlObject, style: ShapeStyle): void;
+  protected parseClrMapOvr(chartSpace: XmlObject | undefined): Record<string, string> | undefined;
 }
 //#endregion
-//#region pptx/core/core/runtime/PptxHandlerRuntimeThemeLoading.d.ts
-declare class PptxHandlerRuntime$18 extends PptxHandlerRuntime$19 {
-  protected resolvePrimaryThemePath(): Promise<string | undefined>;
-  protected parseThemeOptions(): Promise<PptxThemeOption[]>;
+//#region pptx/core/core/runtime/PptxHandlerRuntimeChartExternalData.d.ts
+declare class PptxHandlerRuntime$12 extends PptxHandlerRuntime$13 {
   /**
-   * Public API — scan the in-memory ZIP for `ppt/theme/theme*.xml` parts
-   * and return their paths and display names.  Delegates to the
-   * protected {@link parseThemeOptions}.
+   * Parse `c:externalData` from the chart's `c:chartSpace` and resolve
+   * the external relationship target from the chart part's .rels file.
+   *
+   * In OOXML, `c:externalData` contains `@r:id` referencing a relationship
+   * in the chart part's own .rels file with `TargetMode="External"`, typically
+   * pointing to an external Excel workbook.
    */
-  getAvailableThemes(): Promise<PptxThemeOption[]>;
+  protected parseChartExternalData(chartSpace: XmlObject | undefined, chartPartPath: string): Promise<PptxExternalData | undefined>;
   /**
-   * Build a structured PptxTheme object from the already-parsed
-   * themeColorMap and themeFontMap for consumption by renderers / UI.
+   * Read and parse the embedded xlsx workbook referenced by chart external data.
+   *
+   * When an embedded xlsx binary is available in the external data reference,
+   * this method uses the chart-xlsx-parser utility to extract structured
+   * categories and series from the first worksheet.
    */
-  protected buildThemeObject(): PptxTheme | undefined;
+  protected parseEmbeddedWorkbook(externalData: PptxExternalData | undefined): Promise<PptxEmbeddedWorkbookData | undefined>;
   /**
-   * Parse every slide master's `<p:clrMap>` element and store the alias
-   * dictionaries on {@link masterClrMaps}. Do *not* mutate
-   * {@link themeColorMap} — alias resolution happens at colour-lookup
-   * time so that:
-   *
-   * 1. The raw theme scheme stays the source of truth (clrMap is a
-   *    routing layer, not a colour table).
-   * 2. Multi-master decks resolve each slide against its own master's
-   *    clrMap rather than always against `masterFiles[0]`.
-   * 3. Layout `clrMapOvr` semantics work correctly when a slide's master
-   *    differs from the deck's first master.
+   * Resolve and parse the chart's `c:userShapes` drawing overlay.
    *
-   * Phase 2 Stream B / C-H4.
+   * The `c:userShapes/@r:id` references a separate drawing part
+   * (`ppt/drawings/drawingN.xml`) via the chart part's `.rels`. This loads
+   * that part and parses its `cdr:relSizeAnchor` / `cdr:absSizeAnchor` shapes
+   * into a renderable {@link PptxChartUserShape} model. Returns `undefined`
+   * when there is no reference, the target cannot be resolved, or the drawing
+   * contains no shapes.
    */
-  protected applySlideMasterColorMap(_defaultMap: Record<string, string>): Promise<void>;
+  protected parseChartUserShapes(chartSpace: XmlObject | undefined, chartPartPath: string): Promise<PptxChartUserShape[] | undefined>;
   /**
-   * Parse a single theme part into structured colour, font, and format
-   * scheme dictionaries. Used both for the global default theme and for
-   * each master's per-master theme (multi-master support).
-   *
-   * Phase 2 Stream B / C-H4.
+   * Read the chart part's `.rels` file and return all relationships as an
+   * array of `{ id, type, target }` objects.
    */
-  protected parseThemePart(themePath: string): Promise<{
-    colorMap: Record<string, string>;
-    fontMap: Record<string, string>;
-    formatScheme: PptxThemeFormatScheme | undefined;
-  } | null>;
+  protected readChartRels(chartPartPath: string): Promise<Array<{
+    id: string;
+    type: string;
+    target: string;
+  }>>;
+}
+//#endregion
+//#region pptx/core/core/runtime/PptxHandlerRuntimeChartColorStyle.d.ts
+declare class PptxHandlerRuntime$11 extends PptxHandlerRuntime$12 {
   /**
-   * Parse `<a:font script="…" typeface="…"/>` children of a major or
-   * minor font node into a `script -> typeface` dictionary.
+   * Parse the Office 2013+ chart-style part (`ppt/charts/style#.xml`)
+   * referenced from the chart's relationships, sibling to
+   * {@link parseChartColorStyle}. This is a SEPARATE part/relationship from
+   * the colour style (`chartColorStyle*.xml`): the colour style cycles
+   * series colours, this one carries per-element (title, axis, gridline,
+   * data point, ...) font/line/fill defaults for the active built-in style.
+   */
+  protected parseChartStyleDefinitionPart(chartPartPath: string): Promise<ResolvedChartStyleDefinition | undefined>;
+  /**
+   * Parse the Office 2013+ chart color style part (`chartColorStyle*.xml`)
+   * referenced from the chart's relationships.
    *
-   * fast-xml-parser collapses repeated tags into arrays, so iterate
-   * over the array form regardless of how many siblings are present.
+   * The color style XML contains `<cs:colorStyle meth="cycle" id="10">` with
+   * child `<a:schemeClr val="accent1"/>` elements that define the ordered
+   * color palette.
    *
-   * Phase 4 Stream A / M4.
+   * Returns `{ palette, method }` where `palette` is an array of resolved hex
+   * colors, or `undefined` when no color style is found.
    */
+  protected parseChartColorStyle(chartPartPath: string): Promise<{
+    palette: string[];
+    method: PptxChartData['colorMethod'];
+    partPath: string;
+  } | undefined>;
   /**
-   * Flatten a per-theme-path script-override map (`themePath -> {script ->
-   * typeface}`) into a single `{script -> typeface}` lookup for
-   * {@link buildThemeObject}. Earlier entries win on collision, which matches
-   * the primary-theme-first parse order. Phase 4 Stream A / M4 (#83).
+   * The theme's `accent1` to `accent6` as `#RRGGBB`, the colours a chart with no
+   * colour-style part builds its `c:style` palette from. `undefined` unless the
+   * theme resolves all six.
    */
-  protected aggregateFontScriptOverrides(perPathMap: Map<string, Record<string, string>>): Record<string, string>;
-  protected collectFontScriptOverrides(fontNode: XmlObject | undefined): Record<string, string>;
+  protected resolveChartThemeAccents(): string[] | undefined;
   /**
-   * Resolve the theme file path referenced by a given master's `.rels`.
-   * Returns `undefined` when the master has no theme relationship.
+   * Traverse a `<cs:colorStyle>` element and extract ordered palette colors.
+   *
+   * Child elements can be:
+   * - `<a:schemeClr val="accent1"/>` — resolved via theme color map
+   * - `<a:srgbClr val="4472C4"/>` — explicit RGB
    */
-  protected resolveThemePathForMaster(masterPath: string): Promise<string | undefined>;
+  private collectColorStylePalette;
   /**
-   * Populate {@link masterThemeColorMaps}, {@link masterThemeFontMaps},
-   * and {@link masterThemeFormatSchemes} for every slide master in the
-   * deck. Multi-master support — Phase 2 Stream B / C-H4.
+   * Resolve a scheme color reference (`<a:schemeClr val="accent1"/>`) to a
+   * concrete hex color using the presentation theme color map.
    */
-  protected loadPerMasterThemes(): Promise<void>;
-  protected loadThemeData(): Promise<void>;
+  private resolveChartSchemeColor;
 }
 //#endregion
-//#region pptx/core/core/runtime/PptxHandlerRuntimeThemeProcessing.d.ts
-/**
- * Theme editing: update colour scheme, font scheme, and name in the zip.
- *
- * A deck may carry one theme part per slide master. Every edit therefore
- * targets ALL theme parts the masters point at (the same set the save
- * pipeline's `persistThemeParts` walks), unless the caller narrows it with an
- * explicit `themePaths` list. The in-memory maps are refreshed alongside:
- * the per-master maps, the deck-wide snapshots, and the currently active
- * `themeColorMap` / `themeFontMap`.
- */
-declare class PptxHandlerRuntime$17 extends PptxHandlerRuntime$18 {
+//#region pptx/core/core/runtime/PptxHandlerRuntimeChartExParsing.d.ts
+/** The chart-part facts {@link PptxHandlerRuntime.readChartPartFacts} returns. */
+type ChartPartFacts = Pick<PptxChartData, 'externalData' | 'embeddedWorkbookData' | 'pivotSource' | 'colorPalette' | 'themeAccentColors' | 'colorMethod' | 'colorStylePartPath' | 'colorStyleOriginalPalette' | 'colorStyleOriginalMethod' | 'chartStyleDefinition' | 'layouts' | 'userShapesXml' | 'userShapes' | 'pivotFormats' | 'printSettings' | 'protection'>;
+declare class PptxHandlerRuntime$10 extends PptxHandlerRuntime$11 {
   /**
-   * The theme parts an edit should touch, primary theme first.
-   *
-   * Defaults to every theme referenced by a slide master. A deck whose
-   * masters were never resolved (nothing loaded yet, or a bare zip) falls
-   * back to the primary theme part so the legacy single-theme behaviour is
-   * preserved.
+   * The facts of a chart part that live outside the plot (or in other parts): the external data
+   * reference and the embedded workbook's rows, pivot source and formats, the colour-style and
+   * chart-style parts, layouts, user shapes, print settings and protection. Only the facts that
+   * are present are set.
    */
-  private resolveThemeEditTargets;
-  private readThemePart;
+  protected readChartPartFacts(chartSpace: XmlObject | undefined, chartRoot: XmlObject | undefined, chartPartPath: string): Promise<ChartPartFacts>;
   /**
-   * Parse, edit, and write back every target theme part. Parts the edit
-   * cannot apply to (no `a:themeElements`) are left untouched.
-   *
-   * @returns the paths that were rewritten
+   * Resolve a chart title's text when it was authored as a linked cell reference
+   * (`c:title/c:tx/c:strRef`, PowerPoint's "Title Linked to Cell") rather than rich text: its
+   * cached text lives in `c:strRef/c:strCache/c:pt/c:v`.
    */
-  private rewriteThemeParts;
-  /** Masters whose theme part is among the rewritten paths. */
-  private mastersUsingThemes;
+  protected resolveChartLinkedTitleText(titleNode: XmlObject | undefined): string | undefined;
   /**
-   * Update the theme's colour scheme in-memory and in the zip.
-   *
-   * Refreshes `themeColorMap`, the deck-wide snapshot, and every per-master
-   * colour map whose theme was rewritten. The `tx1` / `bg1` / `tx2` / `bg2`
-   * alias slots are routed through each master's own `p:clrMap` rather than
-   * assuming the default `tx1 = dk1` mapping, so a master that swaps light
-   * and dark keeps its swap after the edit.
+   * Parse a cx: namespace (Office 2016+) chart using the utility parser.
    *
-   * @param themePaths optional explicit theme parts to edit; defaults to
-   *   every theme a slide master references
+   * @param plotArea - The `c:plotArea` XML object.
+   * @param chartType - The detected chart type.
+   * @param chartSpace - The `c:chartSpace` XML root.
+   * @param chartRoot - The `c:chart` XML element.
+   * @param chartPartPath - The ZIP path of the chart part.
+   * @param chartRelationshipId - The relationship ID linking the slide to this chart.
+   * @returns Parsed chart data, or `undefined` if cx parsing yields no series.
    */
-  updateThemeColorScheme(colorScheme: PptxThemeColorScheme, themePaths?: readonly string[]): Promise<void>;
+  protected parseCxChart(plotArea: XmlObject, chartType: PptxChartData['chartType'], chartSpace: XmlObject | undefined, chartRoot: XmlObject | undefined, chartPartPath: string, chartRelationshipId: string): Promise<PptxChartData | undefined>;
+}
+//#endregion
+//#region pptx/core/core/runtime/PptxHandlerRuntimeChartParsing.d.ts
+declare class PptxHandlerRuntime$9 extends PptxHandlerRuntime$10 {
   /**
-   * Update the theme's font scheme in-memory and in the zip, across every
-   * target theme part and the matching per-master font maps.
+   * Parse chart data from a graphic frame element on a slide.
    *
-   * @param themePaths optional explicit theme parts to edit; defaults to
-   *   every theme a slide master references
+   * Resolves the chart relationship, reads the chart part, builds the chart model from the
+   * neutral `c:chartSpace` model (classic parts) or the ChartEx reader, and gathers the part's
+   * metadata (axes, data table, external data, colour style...) into one {@link PptxChartData}.
+   *
+   * @param slidePath - The ZIP path of the slide containing the graphic frame.
+   * @param graphicFrame - The raw XML object for the `p:graphicFrame` element.
+   * @returns The parsed chart data, or `undefined` if the frame is not a chart.
    */
-  updateThemeFontScheme(fontScheme: PptxThemeFontScheme, themePaths?: readonly string[]): Promise<void>;
+  getChartDataForGraphicFrame(slidePath: string, graphicFrame: XmlObject | undefined): Promise<PptxChartData | undefined>;
+  /** The runtime services the object-tree half of the adapter reads with. */
+  private chartTreeReader;
   /**
-   * Update the theme name in the zip, on every target theme part.
-   *
-   * @param themePaths optional explicit theme parts to edit; defaults to
-   *   every theme a slide master references
+   * Every series of every chart group, built from the neutral model with the styles of its
+   * object-tree node, plus the c15 filtered series and titles of the groups.
    */
-  updateThemeName(name: string, themePaths?: readonly string[]): Promise<void>;
+  private buildChartSeries;
   /**
-   * Apply a complete theme (both colors and fonts) to the presentation.
-   * This is a convenience method that combines updateThemeColorScheme
-   * and updateThemeFontScheme.
+   * The drop lines, high-low lines and up/down bars, and the data table and 3-D surfaces, with
+   * their resolved styles. The line elements are legal only on some groups; on a combo whose
+   * first group is another type (volume + stock writes c:barChart first), each is read from the
+   * first group that allows it.
    */
-  applyTheme(colorScheme: PptxThemeColorScheme, fontScheme: PptxThemeFontScheme, themeName?: string): Promise<void>;
-}
-//#endregion
-//#region pptx/core/core/runtime/PptxHandlerRuntimeComments.d.ts
-declare class PptxHandlerRuntime$16 extends PptxHandlerRuntime$17 {
+  private readChartLinesAndChrome;
   /**
-   * Parse modern threaded comments (PowerPoint 2019+ / Office 365).
-   * Modern comments use `p188:cmLst`/`p15:cmLst` roots within
-   * `ppt/comments/modernComment*.xml` or `ppt/comments-extended/...`.
-   * Each `p188:cm` / `p15:cm` node carries `@_id`, `@_authorId`,
-   * `@_created`, `@_status`, text body in `p188:txBody`/`p15:txBody`,
-   * and thread-parent via `@_parentCmId`.
+   * A classic chart: structure from the neutral model, styles and the part facts from the
+   * object tree, the embedded workbook as the fallback of empty caches.
    */
-  protected extractModernSlideComments(slidePath: string): Promise<PptxComment[]>;
-  protected loadModernCommentAuthors(): Promise<void>;
-  protected resolveSlideCommentTarget(slidePath: string): Promise<string | undefined>;
-  protected extractCommentText(commentNode: XmlObject): string;
-  protected extractSlideComments(slidePath: string): Promise<PptxComment[]>;
-  protected loadCommentAuthors(): Promise<void>;
-  /** Derive initials from an author name (first letter of up to 2 tokens). */
-  private toCommentInitials;
+  private buildClassicChart;
 }
 //#endregion
-//#region pptx/core/core/runtime/PptxHandlerRuntimeSmartArtXmlUtils.d.ts
-declare class PptxHandlerRuntime$15 extends PptxHandlerRuntime$16 {
-  protected readXmlPartByRelationshipId(slidePath: string, relationshipId: string): Promise<{
-    xml: XmlObject;
-    partPath: string;
-    text: string;
-  } | undefined>;
-  protected collectLocalTextValues(node: unknown, localName: string, output: string[]): void;
+//#region pptx/core/core/runtime/PptxHandlerRuntimePresentationStructure.d.ts
+declare class PptxHandlerRuntime$8 extends PptxHandlerRuntime$9 {
+  protected parseEditorAnimations(slideXml: XmlObject | undefined): PptxElementAnimation[] | undefined;
+  protected parseSlideTransition(slideXml: XmlObject | undefined, slidePath?: string): PptxSlideTransition | undefined;
+  protected extractSectionMap(): {
+    sectionBySlideId: Map<string, {
+      sectionId: string;
+      sectionName: string;
+    }>;
+    orderedSections: PptxSection[];
+  };
   /**
-   * Extract the per-run text + run-properties of a SmartArt content point's
-   * first paragraph (`dgm:t/a:p/a:r`).
+   * Extract the Header & Footer dialog's state.
    *
-   * Each `a:r` yields one {@link PptxSmartArtTextRun} carrying its joined
-   * `a:t` text and a verbatim copy of its `a:rPr` properties (when present).
-   * Only the first paragraph is captured: SmartArt content points are
-   * single-paragraph in practice, and the round-trip save path rebuilds a
-   * single paragraph from these runs. Returns undefined when there is fewer
-   * than one run worth preserving (a single run is still returned so per-run
-   * formatting like a bold sole run survives).
+   * This used to read `p:presentation/p:hf`, an element the OOXML schema
+   * does not allow (CT_Presentation, §19.2.1.26) and that no real deck has
+   * ever contained, so the dialog opened blank for every file. The flags and
+   * the footer/date TEXT actually live on the slide master: `p:hf` for the
+   * former, the master's `ftr` / `dt` / `hdr` placeholder shapes for the
+   * latter. See `header-footer-parts.ts` for the COM evidence.
+   *
+   * The first slide master wins, matching the dialog's presentation-wide
+   * shape. Multi-master decks can disagree; the per-master flags remain
+   * available on `PptxData.slideMasters[n].headerFooter`.
    */
-  protected extractSmartArtNodeRuns(point: XmlObject): PptxSmartArtTextRun[] | undefined;
+  protected extractHeaderFooter(): PptxHeaderFooter | undefined;
+  /** The `p:sldMaster` node of the first master, in archive-path order. */
+  private firstSlideMasterRoot;
   /**
-   * Extract a content point's per-node visual override.
-   *
-   * Reads the point's presentation `spPr` solid fill and line colour, and the
-   * first run's `rPr` bold / italic / solid fill, into a
-   * {@link PptxSmartArtNodeStyle}. Every field is optional and only set when
-   * present, so an unstyled point yields `undefined` (never throws on missing
-   * structure). This lets the editing UI display the node's current colours.
+   * Extract photo album metadata from `p:photoAlbum` in presentation XML.
    */
-  protected extractSmartArtNodeStyle(point: XmlObject): PptxSmartArtNodeStyle | undefined;
-  /** Read the first run's `rPr` of a content point's first paragraph. */
-  private firstRunProperties;
-  /** Interpret an OOXML boolean attribute ("1"/"true"/"on" => true). */
-  private xmlBoolean;
+  protected extractPhotoAlbum(): PptxPhotoAlbum | undefined;
   /**
-   * Parse background and outline chrome from `dgm:bg` and `dgm:whole`.
+   * Extract write-protection verifier from `p:modifyVerifier` in presentation XML.
    */
-  protected parseSmartArtChrome(dataModel: XmlObject | undefined): PptxSmartArtChrome | undefined;
+  protected extractModifyVerifier(): PptxModifyVerifier | undefined;
   /**
-   * Approximate a non-solid `dgm:bg` fill (gradient or pattern) as a single
-   * display colour, matching the "approximate over drop" precedent used
-   * elsewhere for SmartArt/shape fills: a gradient's own
-   * `extractGradientFillColor` blend (the same helper shape/text gradient
-   * fills already reduce to one colour with), or a pattern's foreground
-   * colour. Returns `undefined` when `bg` has neither (e.g. a blip/picture
-   * fill, or `a:noFill`) - still a silent drop, but no worse than before this
-   * change, and rarer in practice for a diagram background.
+   * Extract East Asian line-break settings from `p:kinsoku` in presentation XML.
    */
-  private approximateSmartArtBackgroundFill;
+  protected extractKinsoku(): PptxKinsoku | undefined;
   /**
-   * Parse colour transform from `ppt/diagrams/colors*.xml`.
+   * Extract `p:presentation/@embedTrueTypeFonts` (ECMA-376 §19.2.1.26).
+   * `undefined` when absent, matching the `@showMasterPhAnim` convention of
+   * never forcing the spec default onto the typed model.
    */
-  protected parseSmartArtColorTransform(slidePath: string, colorsRelId: string): Promise<PptxSmartArtColorTransform | undefined>;
-  private parseSmartArtColorTransformImpl;
+  protected extractEmbedTrueTypeFonts(): boolean | undefined;
   /**
-   * Resolve a scheme colour reference to a hex value using the theme colour map.
+   * Extract `p:presentation/@firstSlideNum` (ECMA-376 §19.2.1.26, an
+   * `xsd:int`). `undefined` when absent, not an integer, or outside the
+   * `xsd:int` range (-2147483648 to 2147483647, which also rejects digit
+   * strings too long to parse), so the spec default (`1`) is never forced
+   * onto the typed model.
    */
-  protected resolveSmartArtSchemeColor(schemeClr: XmlObject | undefined): string | undefined;
+  protected extractFirstSlideNumber(): number | undefined;
 }
 //#endregion
-//#region pptx/core/core/runtime/PptxHandlerRuntimeSmartArtParsing.d.ts
-declare class PptxHandlerRuntime$14 extends PptxHandlerRuntime$15 {
-  protected reportIncompleteSmartArtRelationships(graphicFrame: XmlObject | undefined, relationshipIds: DiagramRelationshipIds | undefined, slidePath: string): void;
-  protected parseSmartArtConnections(dataModel: XmlObject | undefined): {
-    parsedConnections: PptxSmartArtConnection[];
-    parentByNodeId: Map<string, string>;
-  };
+//#region pptx/core/core/runtime/PptxHandlerRuntimeEmbeddedFonts.d.ts
+declare class PptxHandlerRuntime$7 extends PptxHandlerRuntime$8 {
+  protected getEmbeddedFonts(fontList?: PptxEmbeddedFontList): Promise<PptxEmbeddedFont[]>;
+  /** Load the presentation.xml.rels and build a map of rId → target path. */
+  private loadPresentationFontRels;
+  /** Extract, de-obfuscate, and encode a single font variant. */
+  private extractEmbeddedFontVariant;
+  /** Convert Uint8Array to base64 string. */
+  private uint8ArrayToBase64;
+  getLayoutOptions(): PptxLayoutOption[];
+  protected resolveMasterPathForLayout(layoutPath: string): string | undefined;
+}
+//#endregion
+//#region pptx/core/core/runtime/PptxHandlerRuntimeLoadSession.d.ts
+declare class PptxHandlerRuntime$6 extends PptxHandlerRuntime$7 {
+  protected isZipContainer(data: ArrayBuffer): boolean;
+  protected initializeLoadSession(data: ArrayBuffer, options: PptxHandlerLoadOptions): Promise<void>;
   /**
-   * Parse quick style from `ppt/diagrams/quickStyles*.xml`.
+   * Detect and preserve VBA macro project data for .pptm round-trip.
+   *
+   * Scans the ZIP for `ppt/vbaProject.bin` and any related VBA parts
+   * (e.g. `ppt/vbaData.xml`). The raw binary data is stored in runtime
+   * state so it can be written back during save.
    */
-  protected parseSmartArtQuickStyle(slidePath: string, styleRelId: string): Promise<PptxSmartArtQuickStyle | undefined>;
+  protected detectAndPreserveVbaProject(): Promise<void>;
   /**
-   * Parse pre-computed shapes from `ppt/diagrams/drawing*.xml`.
+   * Scan ZIP entry paths for `_xmlsignatures/` parts to detect digital
+   * signatures. Stores the result in runtime state so it can be checked
+   * during build and stripped during save.
    */
-  protected parseSmartArtDrawingShapes(slidePath: string, drawingRelId: string): Promise<PptxSmartArtDrawingShape[]>;
-  protected parseDrawingShape(sp: XmlObject, index: number, emuPerPx: number, mergedTextColor?: string): PptxSmartArtDrawingShape | null;
+  protected detectDigitalSignatureParts(): void;
   /**
-   * Build the injected accessor bundle used by the pure drawing-shape style
-   * helpers, binding the shared XML-lookup / colour / gradient / shadow codec
-   * methods so no new colour logic is duplicated here.
+   * Scan ZIP entries for `customXml/item*.xml` parts and their associated
+   * `itemProps*.xml` property files. Parsed parts are stored in
+   * `this.customXmlParts` for round-trip preservation.
    */
-  private drawingShapeStyleDeps;
-}
-//#endregion
-//#region pptx/core/core/runtime/PptxHandlerRuntimeSmartArt.d.ts
-declare class PptxHandlerRuntime$13 extends PptxHandlerRuntime$14 {
-  getSmartArtDataForGraphicFrame(slidePath: string, graphicFrame: XmlObject | undefined): Promise<PptxSmartArtData | undefined>;
-  private resolveSmartArtDrawingPart;
+  protected parseCustomXmlParts(): Promise<void>;
+  protected loadPresentationState(): Promise<{
+    width: number;
+    height: number;
+    notesWidthEmu: number;
+    notesHeightEmu: number;
+    sectionBySlideId: Map<string, {
+      sectionId: string;
+      sectionName: string;
+    }>;
+    orderedSections: PptxSection[];
+  }>;
   /**
-   * Parse cached SmartArt drawing shapes from an absolute part path.
-   *
-   * Enumerates `dsp:sp` / bare `dsp:pic` (incl. nested `dsp:grpSp`) and
-   * resolves picture (blip) fills to data URLs via the drawing part's own
-   * relationships. Delegates to a pure helper with an injected dep bundle.
+   * Recover and attach the real embedded binary for each OLE element on a
+   * slide so callers can download / open the inner file.
+   *
+   * For each embedded (non-linked) OLE object: resolve its relationship
+   * target to a zip path (same resolution as images), read the bytes, unwrap
+   * a generic "Package" wrapper (recovering the original file name) when
+   * present, derive a MIME type, and expose the payload as a data-URL on the
+   * element. Linked objects, missing targets, oversized payloads, and parse
+   * failures are skipped silently so existing behaviour is preserved.
    */
-  private parseSmartArtDrawingShapesFromPath;
-  /** Bind runtime zip / parser / lookup / image helpers for the drawing parser. */
-  private drawingBlipDeps;
+  protected enrichOleElementsWithEmbeddedData(elements: PptxElement[], slidePath: string, depth?: number): Promise<void>;
+  /** Thin instance-bound wrapper; see `enrichBulletPictureImages` for the logic. */
+  protected enrichBulletPictureElementsWithEmbeddedData(elements: PptxElement[], slidePath: string): Promise<void>;
+  protected loadSlidesForPresentation(sectionBySlideId: Map<string, {
+    sectionId: string;
+    sectionName: string;
+  }>): Promise<PptxSlide[]>;
 }
 //#endregion
-//#region pptx/core/core/runtime/PptxHandlerRuntimeChartDetection.d.ts
-declare class PptxHandlerRuntime$12 extends PptxHandlerRuntime$13 {
-  protected detectChartType(plotArea: XmlObject | undefined): PptxChartData['chartType'];
-  protected extractChartPointValues(seriesContainer: XmlObject | undefined, preferNumeric: boolean): string[];
+//#region pptx/core/core/runtime/PptxHandlerRuntimeLoadPipeline.d.ts
+declare class PptxHandlerRuntime$5 extends PptxHandlerRuntime$6 {
+  protected buildLoadData(presentationState: {
+    width: number;
+    height: number;
+    notesWidthEmu: number;
+    notesHeightEmu: number;
+    orderedSections: PptxSection[];
+  }, slidesWithWarnings: PptxSlide[], slideMasters: PptxSlideMaster[]): Promise<PptxData>;
   /**
-   * Extract a CATEGORY label list, expanded to its declared length.
-   *
-   * `c:strCache`/`c:numCache` is SPARSE and keyed by `@idx`: a blank category
-   * is simply a missing `c:pt`, and `c:ptCount` gives the true length. A single
-   * empty spacer cell in the source workbook therefore produces a cache with,
-   * say, `ptCount="5"` and no `idx="2"`.
-   *
-   * {@link extractChartPointValues} collapses that to a DENSE four-entry list,
-   * which is right for series names and error-bar arrays but wrong here: the
-   * value cache next to it is expanded by index
-   * (`extractSeriesNumbersWithBlanks`), so the categories came out shorter than
-   * the values. Render sizes the category axis from this array, so every point
-   * past the shortened list went unplotted and the surviving labels sat under
-   * the wrong bars - silently wrong numbers, not a visual glitch.
+   * Walk the raw XML of every slide to find the highest numeric `@_id`
+   * attribute on `p:cNvPr` / `p:cNvCxnSpPr` / `p:cNvPicPr` nodes.
+   * This is used to seed the element builder's ID counter so that
+   * new elements never collide with existing ones.
    *
-   * Blank slots are kept as empty strings so index alignment survives.
+   * Implementation note (Load H1): uses an explicit-stack iterative walk
+   * instead of recursion to bound stack usage on attacker-supplied XML
+   * with deeply nested nodes. Also caps total visited nodes at
+   * MAX_NODES to bound CPU on pathological trees.
    */
-  protected extractChartCategoryValues(categoryContainer: XmlObject | undefined, preferNumeric: boolean): string[];
+  protected findMaxElementId(slides: PptxSlide[]): number;
+  protected resetElementIdCounter(slides: PptxSlide[]): void;
+  protected attachSlideWarnings(slides: PptxSlide[]): PptxSlide[];
   /**
-   * Extract hierarchical category levels from a classic `c:multiLvlStrRef`
-   * (e.g. a PowerPoint Quarter > Month category grouping). See
-   * {@link extractMultiLevelCategoryValues} for the extraction rules; this
-   * is a thin wrapper binding it to the runtime's XML lookup service.
+   * Revoke all Blob URLs created during image loading.
+   * Safe to call in non-browser environments (no-op).
    */
-  protected extractChartCategoryLevels(categoryContainer: XmlObject | undefined): {
-    categories: string[];
-    categoryLevels?: string[][];
-  } | undefined;
-  protected extractChartSeriesName(seriesNode: XmlObject): string;
-}
-//#endregion
-//#region pptx/core/core/runtime/PptxHandlerRuntimeChartParsingHelpers.d.ts
-declare class PptxHandlerRuntime$11 extends PptxHandlerRuntime$12 {
+  revokeBlobUrls(): void;
   /**
-   * Parse `c:plotVisOnly` from the chart root element.
+   * Release all resources held by this handler instance.
    *
-   * The `c:plotVisOnly` element controls whether hidden cells are plotted.
-   * - `val="1"` or `val="true"` or absent → only visible data is plotted (returns `true`)
-   * - `val="0"` or `val="false"` → hidden data IS plotted (returns `false`)
+   * - Revokes every Blob URL created for images/media.
+   * - Clears all in-memory caches (image data, XML trees, relationships).
+   * - Nulls out the in-memory ZIP archive (largest single allocation).
    *
-   * Returns `undefined` when the element is absent (caller defaults to `true`).
+   * After calling `dispose()`, the handler cannot load new data, save,
+   * or resolve images.  Create a new `PptxHandler` instance instead.
    */
-  protected parsePlotVisOnly(chartRoot: XmlObject | undefined): boolean | undefined;
+  dispose(): void;
+  load(data: ArrayBuffer, options?: PptxHandlerLoadOptions): Promise<PptxData>;
   /**
-   * Parse `c:pivotSource` from the chart's `c:chartSpace`.
-   *
-   * The `c:pivotSource` element indicates the chart data originates from
-   * a PivotTable. It contains:
-   * - `c:name` — the pivot table reference (e.g. "[workbook.xlsx]Sheet1!PivotTable1")
-   * - `c:fmtId/@val` — an optional format identifier
-   *
-   * The chart still renders using its cached series data; the pivot source
-   * is metadata preserved for round-trip fidelity.
+   * Retrieve the current background colour for a layout or master.
    */
-  protected parsePivotSource(chartSpace: XmlObject | undefined): PptxChartData['pivotSource'];
+  getTemplateBackgroundColor(path: string): string | undefined;
   /**
-   * Parse `c:ofPieChart` options from the chart-type container.
+   * Update the background colour of a slide layout or slide master XML node.
    *
-   * The `ofPieType` element is required by the schema; its `@val`
-   * defaults to `"pie"` when absent. Other fields (`splitType`,
-   * `splitPos`, `secondPieSize`, `serLines`, `gapWidth`, `custSplit`)
-   * are optional and only included when present in the XML.
+   * @param path - The archive path of the layout or master
+   *               (e.g. `ppt/slideLayouts/slideLayout1.xml`)
+   * @param backgroundColor - Hex colour string (e.g. `#FF0000`) or
+   *                          `undefined` / empty to remove background.
    */
-  protected parseOfPieOptions(ofPieContainer: XmlObject | undefined): PptxChartOfPieOptions | undefined;
+  setTemplateBackground(path: string, backgroundColor: string | undefined): void;
+  createXmlBuilder(data: PptxData): PptxXmlBuilder;
+  Builder(data: PptxData): PptxXmlBuilder;
+  getCompatibilityWarnings(): PptxCompatibilityWarning[];
   /**
-   * Parse `c:view3D` (CT_View3D) from the chart root.
-   *
-   * Returns `undefined` when the element is absent so it does not
-   * round-trip as an empty `<c:view3D/>` placeholder.
+   * Find the master path that a given layout belongs to by scanning
+   * the layout's own `.rels` file for a `slideMaster` relationship.
    */
-  protected parseView3D(chartRoot: XmlObject | undefined): PptxChartView3D | undefined;
+  protected findMasterPathForLayout(layoutPath: string): string | undefined;
   /**
-   * Parse top-level chart chrome flags from `c:chart`:
-   * `c:autoTitleDeleted`, `c:dispBlanksAs`, `c:showDLblsOverMax`.
-   *
-   * Each flag is included in the result only when present on the
-   * source XML so that absence does not produce empty elements on
-   * save.
+   * Find the master path for a slide by walking: slide -> layout -> master.
    */
-  protected parseChartChrome(chartRoot: XmlObject | undefined): PptxChartChrome | undefined;
+  protected findMasterPathForSlide(slidePath: string): string | undefined;
   /**
-   * Capture the raw `c:userShapes` subtree for verbatim round-trip.
+   * Resolve the editable template (master + layout) elements a slide
+   * inherits, each carrying a `master-` / `layout-` prefixed id.
    *
-   * The element references a separate drawing part; we never parse
-   * the nested drawing tree here. Returning the raw object means the
-   * save layer can re-emit it unchanged.
-   */
-  protected parseUserShapesXml(chartSpace: XmlObject | undefined): unknown;
-  /** Capture the raw `c:pivotFmts` subtree for verbatim round-trip. */
-  protected parsePivotFmtsXml(chartRoot: XmlObject | undefined): unknown;
-  /**
-   * Parse `c:clrMapOvr` into a flat attribute map.
+   * This is the canonical entry point for an "edit template/master"
+   * feature: it returns the same decorative master/layout shapes that the
+   * loader already merges in front of slide-authored content (master shapes
+   * behind, layout shapes on top), reusing the cached
+   * {@link getLayoutElements} parse. Resolving a slide that has not been
+   * loaded yet (no relationships cached) yields an empty array.
    *
-   * The element carries 12 `bg1/tx1/bg2/tx2/accent1…6/hlink/folHlink`
-   * attributes that remap theme colour roles for the chart only.
-   * Unknown attributes are preserved as-is so that future schema
-   * additions round-trip without code changes.
-   */
-  protected parseClrMapOvr(chartSpace: XmlObject | undefined): Record<string, string> | undefined;
-}
-//#endregion
-//#region pptx/core/core/runtime/PptxHandlerRuntimeChartExternalData.d.ts
-declare class PptxHandlerRuntime$10 extends PptxHandlerRuntime$11 {
-  /**
-   * Parse `c:externalData` from the chart's `c:chartSpace` and resolve
-   * the external relationship target from the chart part's .rels file.
+   * Important scope notes for callers:
+   *  - Placeholder shapes (`<p:ph>`) are intentionally excluded; those are
+   *    resolved separately into each slide's own placeholders. Only
+   *    non-placeholder decorations (shapes, pictures, graphic frames) are
+   *    returned, which is exactly what the save writeback path supports.
+   *  - The returned elements are shared by every slide that inherits the
+   *    same layout/master. Editing one element and saving updates the shared
+   *    layout/master part, so the change is visible on all sibling slides.
+   *  - To persist an edit the binding must keep the mutated template element
+   *    inside the `slide.elements` array it passes to {@link save}; the save
+   *    writer reads template elements from `ctx.slide.elements` and writes
+   *    their shape XML back into the owning `p:spTree`.
    *
-   * In OOXML, `c:externalData` contains `@r:id` referencing a relationship
-   * in the chart part's own .rels file with `TargetMode="External"`, typically
-   * pointing to an external Excel workbook.
+   * @param slideId - The slide's archive path (the `PptxSlide.id`, e.g.
+   *   `ppt/slides/slide1.xml`).
+   * @returns Master + layout elements with prefixed ids (may be empty).
    */
-  protected parseChartExternalData(chartSpace: XmlObject | undefined, chartPartPath: string): Promise<PptxExternalData | undefined>;
+  getTemplateElementsForSlide(slideId: string): Promise<PptxElement[]>;
   /**
-   * Read and parse the embedded xlsx workbook referenced by chart external data.
-   *
-   * When an embedded xlsx binary is available in the external data reference,
-   * this method uses the chart-xlsx-parser utility to extract structured
-   * categories and series from the first worksheet.
+   * Get layouts available for a specific slide, scoped to that slide's
+   * master. If the slide's master cannot be determined, returns all
+   * known layouts.
    */
-  protected parseEmbeddedWorkbook(externalData: PptxExternalData | undefined): Promise<PptxEmbeddedWorkbookData | undefined>;
+  getAvailableLayoutsForSlide(slideIndex: number, slides: PptxSlide[]): Promise<PptxLayoutOption[]>;
+  protected buildLayoutOption(path: string, xmlObj: XmlObject): PptxLayoutOption;
   /**
-   * Resolve and parse the chart's `c:userShapes` drawing overlay.
+   * Apply a different layout to an existing slide.
    *
-   * The `c:userShapes/@r:id` references a separate drawing part
-   * (`ppt/drawings/drawingN.xml`) via the chart part's `.rels`. This loads
-   * that part and parses its `cdr:relSizeAnchor` / `cdr:absSizeAnchor` shapes
-   * into a renderable {@link PptxChartUserShape} model. Returns `undefined`
-   * when there is no reference, the target cannot be resolved, or the drawing
-   * contains no shapes.
-   */
-  protected parseChartUserShapes(chartSpace: XmlObject | undefined, chartPartPath: string): Promise<PptxChartUserShape[] | undefined>;
-  /**
-   * Read the chart part's `.rels` file and return all relationships as an
-   * array of `{ id, type, target }` objects.
+   * This updates the slide's `.rels` file in the in-memory ZIP so the
+   * `slideLayout` relationship points to the new layout, then refreshes
+   * the slide's layout-derived properties (background, layoutPath,
+   * layoutName).
    */
-  protected readChartRels(chartPartPath: string): Promise<Array<{
-    id: string;
-    type: string;
-    target: string;
-  }>>;
+  applyLayoutToSlide(slideIndex: number, layoutPath: string, slides: PptxSlide[]): Promise<PptxSlide>;
 }
 //#endregion
-//#region pptx/core/core/runtime/PptxHandlerRuntimeChartColorStyle.d.ts
-declare class PptxHandlerRuntime$9 extends PptxHandlerRuntime$10 {
-  /**
-   * Parse the Office 2013+ chart-style part (`ppt/charts/style#.xml`)
-   * referenced from the chart's relationships, sibling to
-   * {@link parseChartColorStyle}. This is a SEPARATE part/relationship from
-   * the colour style (`chartColorStyle*.xml`): the colour style cycles
-   * series colours, this one carries per-element (title, axis, gridline,
-   * data point, ...) font/line/fill defaults for the active built-in style.
-   */
-  protected parseChartStyleDefinitionPart(chartPartPath: string): Promise<ResolvedChartStyleDefinition | undefined>;
+//#region pptx/core/core/runtime/PptxHandlerRuntimeStyleMatrixResolve.d.ts
+declare class PptxHandlerRuntime$4 extends PptxHandlerRuntime$5 {
   /**
-   * Parse the Office 2013+ chart color style part (`chartColorStyle*.xml`)
-   * referenced from the chart's relationships.
-   *
-   * The color style XML contains `<cs:colorStyle meth="cycle" id="10">` with
-   * child `<a:schemeClr val="accent1"/>` elements that define the ordered
-   * color palette.
-   *
-   * Returns `{ palette, method }` where `palette` is an array of resolved hex
-   * colors, or `undefined` when no color style is found.
+   * Resolve a `<p:style>` node (`a:lnRef`, `a:fillRef`, `a:effectRef`,
+   * `a:fontRef`) against the current theme's format scheme, with the same
+   * code the load path uses. Editors call this to apply a style-matrix
+   * gallery entry (Shape Styles) so that what they render and what they save
+   * both match what PowerPoint writes: a bare `<p:style>` and an `spPr` with
+   * no fill, outline or effects of its own.
    */
-  protected parseChartColorStyle(chartPartPath: string): Promise<{
-    palette: string[];
-    method: PptxChartData['colorMethod'];
-    partPath: string;
-  } | undefined>;
+  resolveStyleMatrixReferences(styleXml: XmlObject): ResolvedStyleMatrix;
+}
+//#endregion
+//#region pptx/core/core/runtime/PptxHandlerRuntimeThemeEffects.d.ts
+/** Slides and template (master/layout) elements after style references were resolved again. */
+interface StyleReferenceReResolution {
+  slides: PptxSlide[];
+  templateElementsBySlideId: Record<string, PptxElement[]>;
+}
+/**
+ * Design > Variants > Effects: replace the theme's format scheme (`a:fmtScheme`) and redraw the
+ * shapes that reference it.
+ *
+ * A shape keeps `fillRef`/`lnRef`/`effectRef` indices and the flat values they resolved to at load
+ * time. {@link reResolveThemeStyleReferences} resolves the indices again against a format scheme
+ * and replaces only what the shape still inherits (its flat value equals the recorded baseline),
+ * so a fill, outline or shadow the author set by hand survives a scheme change, as in PowerPoint.
+ */
+declare class PptxHandlerRuntime$3 extends PptxHandlerRuntime$4 {
+  private readonly effectSchemeCache;
   /**
-   * The theme's `accent1` to `accent6` as `#RRGGBB`, the colours a chart with no
-   * colour-style part builds its `c:style` palette from. `undefined` unless the
-   * theme resolves all six.
+   * Resolve a `<p:style>` node as the base class does, against built-in effect scheme
+   * `effectSchemeId` instead of the deck's own (the Effects gallery draws each tile this way).
    */
-  protected resolveChartThemeAccents(): string[] | undefined;
+  resolveStyleMatrixReferences(styleXml: XmlObject, effectSchemeId?: string): ResolvedStyleMatrix;
+  private parseEffectScheme;
   /**
-   * Traverse a `<cs:colorStyle>` element and extract ordered palette colors.
+   * Write a built-in effect scheme into every theme part a master references and refresh the
+   * in-memory format schemes. Slides are not touched: call {@link reResolveThemeStyleReferences}
+   * for them.
    *
-   * Child elements can be:
-   * - `<a:schemeClr val="accent1"/>` — resolved via theme color map
-   * - `<a:srgbClr val="4472C4"/>` — explicit RGB
+   * @returns the parsed scheme now in force, or `undefined` for an unknown id
    */
-  private collectColorStylePalette;
+  applyThemeEffectScheme(id: string): Promise<PptxThemeFormatScheme | undefined>;
   /**
-   * Resolve a scheme color reference (`<a:schemeClr val="accent1"/>`) to a
-   * concrete hex color using the presentation theme color map.
+   * Write an `a:fmtScheme` element (as the text a theme part carries, `a` prefix undeclared)
+   * into every theme part a master references; a real theme variant brings its own.
    */
-  private resolveChartSchemeColor;
-}
-//#endregion
-//#region pptx/core/core/runtime/PptxHandlerRuntimeChartExParsing.d.ts
-/** The chart-part facts {@link PptxHandlerRuntime.readChartPartFacts} returns. */
-type ChartPartFacts = Pick<PptxChartData, 'externalData' | 'embeddedWorkbookData' | 'pivotSource' | 'colorPalette' | 'themeAccentColors' | 'colorMethod' | 'colorStylePartPath' | 'colorStyleOriginalPalette' | 'colorStyleOriginalMethod' | 'chartStyleDefinition' | 'layouts' | 'userShapesXml' | 'userShapes' | 'pivotFormats' | 'printSettings' | 'protection'>;
-declare class PptxHandlerRuntime$8 extends PptxHandlerRuntime$9 {
+  applyThemeFormatSchemeXml(fmtSchemeXml: string): Promise<PptxThemeFormatScheme | undefined>;
+  /** The real theme variants the loaded package carries, or none. */
+  getThemeVariants(): PptxThemeVariant[];
+  /** The format scheme the deck's primary theme carries now. */
+  getThemeFormatScheme(): PptxThemeFormatScheme | undefined;
   /**
-   * The facts of a chart part that live outside the plot (or in other parts): the external data
-   * reference and the embedded workbook's rows, pivot source and formats, the colour-style and
-   * chart-style parts, layouts, user shapes, print settings and protection. Only the facts that
-   * are present are set.
+   * Resolve every shape's `p:style` references again.
+   *
+   * @param effectSchemeId resolve against this built-in scheme instead of the one in force
+   *   (a preview); omit it after {@link applyThemeEffectScheme}
    */
-  protected readChartPartFacts(chartSpace: XmlObject | undefined, chartRoot: XmlObject | undefined, chartPartPath: string): Promise<ChartPartFacts>;
+  reResolveThemeStyleReferences(slides: readonly PptxSlide[], templateElementsBySlideId: Readonly<Record<string, PptxElement[]>>, effectSchemeId?: string): StyleReferenceReResolution;
+  private reResolveElementStyle;
+  private reResolveShapeStyle;
+}
+//#endregion
+//#region pptx/core/core/runtime/PptxHandlerRuntimeBackgroundStyles.d.ts
+/** Which slides a background style lands on. */
+type BackgroundStyleScope = {
+  kind: 'all';
+} | {
+  kind: 'slides';
+  slideIds: readonly string[];
+};
+/** Slides and template elements after a background style was applied. */
+interface BackgroundStyleApplication {
+  slides: PptxSlide[];
+  templateElementsBySlideId: Record<string, PptxElement[]>;
+}
+/**
+ * Design > Variants > Background Styles.
+ *
+ * A style is a `p:bgRef` into the theme's `a:bgFillStyleLst` plus, for the dark columns, a swapped
+ * colour map. "Apply to All Slides" writes both on the slide master and makes every slide follow
+ * it; "Apply to Selected Slides" writes the same `bgRef` and an explicit `p:clrMapOvr` on each
+ * slide (what PowerPoint writes, verified against `Slide.BackgroundStyle`).
+ */
+declare class PptxHandlerRuntime$2 extends PptxHandlerRuntime$3 {
+  private resolveBackgroundStyle;
+  private layoutAuthorsBackground;
   /**
-   * Resolve a chart title's text when it was authored as a linked cell reference
-   * (`c:title/c:tx/c:strRef`, PowerPoint's "Title Linked to Cell") rather than rich text: its
-   * cached text lives in `c:strRef/c:strCache/c:pt/c:v`.
+   * Apply background style `index` (1 to 12) to `slides` and their template elements. Pure with
+   * respect to the handler's state (a preview); {@link commitMasterBackgroundStyle} makes a
+   * deck-wide application permanent.
    */
-  protected resolveChartLinkedTitleText(titleNode: XmlObject | undefined): string | undefined;
+  applyBackgroundStyleToSlides(slides: readonly PptxSlide[], templateElementsBySlideId: Readonly<Record<string, PptxElement[]>>, index: number, scope: BackgroundStyleScope): BackgroundStyleApplication | undefined;
   /**
-   * Parse a cx: namespace (Office 2016+) chart using the utility parser.
-   *
-   * @param plotArea - The `c:plotArea` XML object.
-   * @param chartType - The detected chart type.
-   * @param chartSpace - The `c:chartSpace` XML root.
-   * @param chartRoot - The `c:chart` XML element.
-   * @param chartPartPath - The ZIP path of the chart part.
-   * @param chartRelationshipId - The relationship ID linking the slide to this chart.
-   * @returns Parsed chart data, or `undefined` if cx parsing yields no series.
+   * Write background style `index` onto every slide master (`p:bg` and `p:clrMap`) so a deck-wide
+   * application is saved. Slides follow it through {@link applyBackgroundStyleToSlides}.
    */
-  protected parseCxChart(plotArea: XmlObject, chartType: PptxChartData['chartType'], chartSpace: XmlObject | undefined, chartRoot: XmlObject | undefined, chartPartPath: string, chartRelationshipId: string): Promise<PptxChartData | undefined>;
+  commitMasterBackgroundStyle(index: number): Promise<boolean>;
 }
 //#endregion
-//#region pptx/core/core/runtime/PptxHandlerRuntimeChartParsing.d.ts
-declare class PptxHandlerRuntime$7 extends PptxHandlerRuntime$8 {
+//#region pptx/core/core/types.d.ts
+interface PptxHandlerLoadOptions {
+  eagerDecodeImages?: boolean;
+  password?: string;
   /**
-   * Parse chart data from a graphic frame element on a slide.
-   *
-   * Resolves the chart relationship, reads the chart part, builds the chart model from the
-   * neutral `c:chartSpace` model (classic parts) or the ChartEx reader, and gathers the part's
-   * metadata (axes, data table, external data, colour style...) into one {@link PptxChartData}.
-   *
-   * @param slidePath - The ZIP path of the slide containing the graphic frame.
-   * @param graphicFrame - The raw XML object for the `p:graphicFrame` element.
-   * @returns The parsed chart data, or `undefined` if the frame is not a chart.
+   * Maximum total uncompressed bytes accepted from the input ZIP archive.
+   * Defaults to 500 MiB. When the sum of `_data.uncompressedSize` across
+   * all archive entries exceeds this cap, `load()` rejects with a
+   * {@link ZipBombError}. A hard cap of 65 536 archive entries also
+   * applies.
    */
-  getChartDataForGraphicFrame(slidePath: string, graphicFrame: XmlObject | undefined): Promise<PptxChartData | undefined>;
-  /** The runtime services the object-tree half of the adapter reads with. */
-  private chartTreeReader;
+  maxUncompressedBytes?: number;
   /**
-   * Every series of every chart group, built from the neutral model with the styles of its
-   * object-tree node, plus the c15 filtered series and titles of the groups.
+   * When `false` (default), relationship targets that resolve to
+   * `http://` or `https://` URLs are dropped from rendered slides
+   * (image, picture, background). Set to `true` to allow external image
+   * URLs to flow through to `<img src>`.
+   *
+   * Disabled by default to mitigate SSRF / privacy-leak vectors in
+   * server-side rendering and headless export pipelines.
    */
-  private buildChartSeries;
+  allowExternalImages?: boolean;
+}
+/**
+ * Default maximum uncompressed byte budget for {@link PptxHandlerLoadOptions.maxUncompressedBytes}.
+ * 500 MiB.
+ */
+declare const DEFAULT_MAX_UNCOMPRESSED_BYTES: number;
+/**
+ * Hard cap on archive entry count. Beyond this, the package is rejected.
+ */
+declare const MAX_ZIP_ENTRY_COUNT = 65536;
+/**
+ * Thrown by the load pipeline when a ZIP archive exceeds the configured
+ * uncompressed-size budget or the entry-count limit.
+ */
+declare class ZipBombError extends Error {
+  readonly code = "ZIP_BOMB";
+  readonly uncompressedBytes: number | undefined;
+  readonly limit: number;
+  readonly entryCount: number | undefined;
+  constructor(message: string, details: {
+    uncompressedBytes?: number;
+    limit: number;
+    entryCount?: number;
+  });
+}
+/** Output format for the save pipeline. */
+type PptxSaveFormat = 'pptx' | 'ppsx' | 'pptm' | 'ppt';
+interface PptxHandlerSaveOptions {
+  headerFooter?: PptxHeaderFooter;
+  presentationProperties?: PptxPresentationProperties;
+  customShows?: PptxCustomShow[];
+  sections?: PptxSection[];
+  coreProperties?: PptxCoreProperties;
+  appProperties?: PptxAppProperties;
+  customProperties?: PptxCustomProperty[];
+  /** Updated notes master data to save back to notesMaster1.xml. */
+  notesMaster?: PptxNotesMaster;
+  /** Updated handout master data to save back to handoutMaster1.xml. */
+  handoutMaster?: PptxHandoutMaster;
   /**
-   * The drop lines, high-low lines and up/down bars, and the data table and 3-D surfaces, with
-   * their resolved styles. The line elements are legal only on some groups; on a combo whose
-   * first group is another type (volume + stock writes c:barChart first), each is read from the
-   * first group that allows it.
+   * Updated slide masters to save back to ppt/slideMasters/slideMaster*.xml.
+   * Each entry in the array applies typed mutations (clrMap, hf flags,
+   * background) to the master at its `path`. Masters not listed here pass
+   * through verbatim from the original load.
    */
-  private readChartLinesAndChrome;
+  slideMasters?: PptxSlideMaster[];
   /**
-   * A classic chart: structure from the neutral model, styles and the part facts from the
-   * object tree, the embedded workbook as the fallback of empty caches.
+   * Updated slide layouts to save back to ppt/slideLayouts/slideLayout*.xml.
+   * Each entry applies typed mutations (clrMapOverride, attrs, hf flags,
+   * background) to the layout at its `path`. Layouts not listed here pass
+   * through verbatim from the original load.
    */
-  private buildClassicChart;
-}
-//#endregion
-//#region pptx/core/core/runtime/PptxHandlerRuntimePresentationStructure.d.ts
-declare class PptxHandlerRuntime$6 extends PptxHandlerRuntime$7 {
-  protected parseEditorAnimations(slideXml: XmlObject | undefined): PptxElementAnimation[] | undefined;
-  protected parseSlideTransition(slideXml: XmlObject | undefined, slidePath?: string): PptxSlideTransition | undefined;
-  protected extractSectionMap(): {
-    sectionBySlideId: Map<string, {
-      sectionId: string;
-      sectionName: string;
-    }>;
-    orderedSections: PptxSection[];
-  };
+  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;
   /**
-   * Extract the Header & Footer dialog's state.
+   * Slide dimensions to write back to `p:sldSz`.
    *
-   * This used to read `p:presentation/p:hf`, an element the OOXML schema
-   * does not allow (CT_Presentation, §19.2.1.26) and that no real deck has
-   * ever contained, so the dialog opened blank for every file. The flags and
-   * the footer/date TEXT actually live on the slide master: `p:hf` for the
-   * former, the master's `ftr` / `dt` / `hdr` placeholder shapes for the
-   * latter. See `header-footer-parts.ts` for the COM evidence.
+   * Omitting the option preserves the load-time dimensions verbatim, which
+   * is why an edit made through a viewer's Slide Size control has to reach
+   * the save call: nothing else in the pipeline can observe it.
    *
-   * The first slide master wins, matching the dialog's presentation-wide
-   * shape. Multi-master decks can disagree; the per-master flags remain
-   * available on `PptxData.slideMasters[n].headerFooter`.
-   */
-  protected extractHeaderFooter(): PptxHeaderFooter | undefined;
-  /** The `p:sldMaster` node of the first master, in archive-path order. */
-  private firstSlideMasterRoot;
-  /**
-   * Extract photo album metadata from `p:photoAlbum` in presentation XML.
+   * PowerPoint derives `Presentation.PageSetup.SlideSize` from `@cx`/`@cy`
+   * alone (verified by COM: an A4-typed `p:sldSz` carrying 4:3 dimensions
+   * still reports `ppSlideSizeCustom`), so `type` is written for fidelity
+   * but the dimensions are what actually decide the reported preset.
    */
-  protected extractPhotoAlbum(): PptxPhotoAlbum | undefined;
+  slideSize?: PptxSlideSize;
+  /** East Asian line-break settings to save back to `p:kinsoku`. */
+  kinsoku?: PptxKinsoku | null;
+  /** Write-protection verifier. Set to `null` to remove, `undefined` to preserve existing. */
+  modifyVerifier?: PptxModifyVerifier | null;
   /**
-   * Extract write-protection verifier from `p:modifyVerifier` in presentation XML.
+   * `p:presentation/@embedTrueTypeFonts` to write. `undefined` preserves
+   * whatever was loaded (or omits the attribute for a brand-new deck);
+   * purely declarative here, see {@link PptxData.embedTrueTypeFonts}.
    */
-  protected extractModifyVerifier(): PptxModifyVerifier | undefined;
+  embedTrueTypeFonts?: boolean;
   /**
-   * Extract East Asian line-break settings from `p:kinsoku` in presentation XML.
+   * Presentation-level default text style edits to save back to
+   * `p:defaultTextStyle`. Only the levels present in the map are touched;
+   * omitted levels and any unmodelled XML on an edited level survive
+   * untouched. See {@link PptxData.defaultTextStyle}.
    */
-  protected extractKinsoku(): PptxKinsoku | undefined;
+  defaultTextStyle?: PptxTextStyleLevels;
+  /** View properties to save back to ppt/viewProps.xml. */
+  viewProperties?: PptxViewProperties;
   /**
-   * Extract `p:presentation/@embedTrueTypeFonts` (ECMA-376 §19.2.1.26).
-   * `undefined` when absent, matching the `@showMasterPhAnim` convention of
-   * never forcing the spec default onto the typed model.
+   * Table style edits to save back to `ppt/tableStyles.xml`. Pass the
+   * `tableStyleMap` from `PptxData` (optionally with edited entries)
+   * to persist user edits. The `def` GUID and any unmodelled XML are
+   * preserved verbatim. Omitting the option round-trips the original
+   * part untouched.
    */
-  protected extractEmbedTrueTypeFonts(): boolean | undefined;
+  tableStyles?: ParsedTableStyleMap;
   /**
-   * Extract `p:presentation/@firstSlideNum` (ECMA-376 §19.2.1.26, an
-   * `xsd:int`). `undefined` when absent, not an integer, or outside the
-   * `xsd:int` range (-2147483648 to 2147483647, which also rejects digit
-   * strings too long to parse), so the spec default (`1`) is never forced
-   * onto the typed model.
+   * Set `ppt/tableStyles.xml`'s `<a:tblStyleLst @def>` to this style GUID
+   * (normalised to uppercase-with-braces). `undefined` preserves the
+   * existing default; there is no removal form (`@def` is required by the
+   * schema and PowerPoint always points it at a real style). No-op when the
+   * archive has no `ppt/tableStyles.xml`, same as {@link tableStyles}.
    */
-  protected extractFirstSlideNumber(): number | undefined;
-}
-//#endregion
-//#region pptx/core/core/runtime/PptxHandlerRuntimeEmbeddedFonts.d.ts
-declare class PptxHandlerRuntime$5 extends PptxHandlerRuntime$6 {
-  protected getEmbeddedFonts(fontList?: PptxEmbeddedFontList): Promise<PptxEmbeddedFont[]>;
-  /** Load the presentation.xml.rels and build a map of rId → target path. */
-  private loadPresentationFontRels;
-  /** Extract, de-obfuscate, and encode a single font variant. */
-  private extractEmbeddedFontVariant;
-  /** Convert Uint8Array to base64 string. */
-  private uint8ArrayToBase64;
-  getLayoutOptions(): PptxLayoutOption[];
-  protected resolveMasterPathForLayout(layoutPath: string): string | undefined;
-}
-//#endregion
-//#region pptx/core/core/runtime/PptxHandlerRuntimeLoadSession.d.ts
-declare class PptxHandlerRuntime$4 extends PptxHandlerRuntime$5 {
-  protected isZipContainer(data: ArrayBuffer): boolean;
-  protected initializeLoadSession(data: ArrayBuffer, options: PptxHandlerLoadOptions): Promise<void>;
+  tableStylesDefaultId?: string;
   /**
-   * Detect and preserve VBA macro project data for .pptm round-trip.
-   *
-   * Scans the ZIP for `ppt/vbaProject.bin` and any related VBA parts
-   * (e.g. `ppt/vbaData.xml`). The raw binary data is stored in runtime
-   * state so it can be written back during save.
+   * Style GUIDs to remove from `ppt/tableStyles.xml` entirely, kept as a
+   * separate opt-in list rather than inferred from omission on
+   * {@link tableStyles}: that map is documented as safe to pass a PARTIAL
+   * edit (only the entries a caller actually touched), so treating every
+   * GUID missing from it as "delete this" would silently destroy untouched
+   * styles on an ordinary targeted edit. A GUID here that is also the
+   * current (or newly requested) default is left in place and skipped.
    */
-  protected detectAndPreserveVbaProject(): Promise<void>;
+  tableStylesToDelete?: string[];
   /**
-   * Scan ZIP entry paths for `_xmlsignatures/` parts to detect digital
-   * signatures. Stores the result in runtime state so it can be checked
-   * during build and stripped during save.
+   * Target output format.
+   * - `'pptx'` (default): Standard presentation.
+   * - `'ppsx'`: Slide-show file (opens in presentation mode).
+   * - `'pptm'`: Macro-enabled presentation (requires VBA data).
+   * - `'ppt'`: Legacy binary PowerPoint 97-2003 presentation. Bypasses the
+   *   OOXML ZIP pipeline entirely; see `PptxHandlerRuntimeSaveLegacyPpt`.
+   *   Elements with no binary equivalent (charts, SmartArt, media, OLE, ink,
+   *   3D models) are degraded to a rasterised preview picture or a labelled
+   *   placeholder, each reported via a `scope: 'save'`-adjacent
+   *   `PptxCompatibilityWarning`.
    */
-  protected detectDigitalSignatureParts(): void;
+  outputFormat?: PptxSaveFormat;
   /**
-   * Scan ZIP entries for `customXml/item*.xml` parts and their associated
-   * `itemProps*.xml` property files. Parsed parts are stored in
-   * `this.customXmlParts` for round-trip preservation.
+   * Password for RC4 CryptoAPI encryption of a `'ppt'`-format save. Ignored
+   * for every other {@link outputFormat}; encrypting a `.pptx`/`.ppsx`/`.pptm`
+   * save uses {@link IPptxHandlerRuntime.saveEncrypted}'s separate AES/Agile
+   * OLE2 wrapping instead, since the legacy binary format's own encryption
+   * scheme is embedded directly in the `.ppt` stream rather than wrapping an
+   * already-produced package.
    */
-  protected parseCustomXmlParts(): Promise<void>;
-  protected loadPresentationState(): Promise<{
-    width: number;
-    height: number;
-    notesWidthEmu: number;
-    notesHeightEmu: number;
-    sectionBySlideId: Map<string, {
-      sectionId: string;
-      sectionName: string;
-    }>;
-    orderedSections: PptxSection[];
-  }>;
+  pptPassword?: string;
   /**
-   * Recover and attach the real embedded binary for each OLE element on a
-   * slide so callers can download / open the inner file.
+   * Embedded fonts to write back (or add) to the saved PPTX.
    *
-   * For each embedded (non-linked) OLE object: resolve its relationship
-   * target to a zip path (same resolution as images), read the bytes, unwrap
-   * a generic "Package" wrapper (recovering the original file name) when
-   * present, derive a MIME type, and expose the payload as a data-URL on the
-   * element. Linked objects, missing targets, oversized payloads, and parse
-   * failures are skipped silently so existing behaviour is preserved.
-   */
-  protected enrichOleElementsWithEmbeddedData(elements: PptxElement[], slidePath: string, depth?: number): Promise<void>;
-  /** Thin instance-bound wrapper; see `enrichBulletPictureImages` for the logic. */
-  protected enrichBulletPictureElementsWithEmbeddedData(elements: PptxElement[], slidePath: string): Promise<void>;
-  protected loadSlidesForPresentation(sectionBySlideId: Map<string, {
-    sectionId: string;
-    sectionName: string;
-  }>): Promise<PptxSlide[]>;
-}
-//#endregion
-//#region pptx/core/core/runtime/PptxHandlerRuntimeLoadPipeline.d.ts
-declare class PptxHandlerRuntime$3 extends PptxHandlerRuntime$4 {
-  protected buildLoadData(presentationState: {
-    width: number;
-    height: number;
-    notesWidthEmu: number;
-    notesHeightEmu: number;
-    orderedSections: PptxSection[];
-  }, slidesWithWarnings: PptxSlide[], slideMasters: PptxSlideMaster[]): Promise<PptxData>;
-  /**
-   * Walk the raw XML of every slide to find the highest numeric `@_id`
-   * attribute on `p:cNvPr` / `p:cNvCxnSpPr` / `p:cNvPicPr` nodes.
-   * This is used to seed the element builder's ID counter so that
-   * new elements never collide with existing ones.
+   * Pass the `embeddedFonts` array from `PptxData` to preserve existing
+   * embedded fonts during save. You can also add new fonts by including
+   * entries with `rawFontData` populated.
    *
-   * Implementation note (Load H1): uses an explicit-stack iterative walk
-   * instead of recursion to bound stack usage on attacker-supplied XML
-   * with deeply nested nodes. Also caps total visited nodes at
-   * MAX_NODES to bound CPU on pathological trees.
+   * When omitted, the save pipeline will automatically re-embed any
+   * fonts that were loaded from the original PPTX and have `rawFontData`
+   * preserved (i.e. the default is lossless round-trip).
    */
-  protected findMaxElementId(slides: PptxSlide[]): number;
-  protected resetElementIdCounter(slides: PptxSlide[]): void;
-  protected attachSlideWarnings(slides: PptxSlide[]): PptxSlide[];
+  embeddedFonts?: PptxEmbeddedFont[];
+  /** Typed embedded-font list metadata. Set to null to remove fonts and relationships. */
+  embeddedFontList?: PptxEmbeddedFontList | null;
   /**
-   * Revoke all Blob URLs created during image loading.
-   * Safe to call in non-browser environments (no-op).
+   * OOXML conformance class for the saved output.
+   * - `'preserve'` (default): use the same conformance as the loaded file.
+   * - `'strict'`: force Strict Open XML (ISO/IEC 29500) namespace URIs.
+   * - `'transitional'`: force Transitional (ECMA-376) namespace URIs.
    */
-  revokeBlobUrls(): void;
+  conformance?: 'strict' | 'transitional' | 'preserve';
+}
+interface IPptxHandlerRuntime {
   /**
-   * Release all resources held by this handler instance.
-   *
-   * - Revokes every Blob URL created for images/media.
-   * - Clears all in-memory caches (image data, XML trees, relationships).
-   * - Nulls out the in-memory ZIP archive (largest single allocation).
-   *
-   * After calling `dispose()`, the handler cannot load new data, save,
-   * or resolve images.  Create a new `PptxHandler` instance instead.
+   * Release all resources held by this runtime (Blob URLs, caches, ZIP).
+   * After calling, the runtime cannot be used further.
    */
   dispose(): void;
-  load(data: ArrayBuffer, options?: PptxHandlerLoadOptions): Promise<PptxData>;
   /**
-   * Retrieve the current background colour for a layout or master.
-   */
-  getTemplateBackgroundColor(path: string): string | undefined;
-  /**
-   * Update the background colour of a slide layout or slide master XML node.
-   *
-   * @param path - The archive path of the layout or master
-   *               (e.g. `ppt/slideLayouts/slideLayout1.xml`)
-   * @param backgroundColor - Hex colour string (e.g. `#FF0000`) or
-   *                          `undefined` / empty to remove background.
+   * Revoke all Blob URLs created during image loading.
    */
-  setTemplateBackground(path: string, backgroundColor: string | undefined): void;
+  revokeBlobUrls(): void;
+  getCompatibilityWarnings(): PptxCompatibilityWarning[];
+  getLayoutOptions(): PptxLayoutOption[];
+  getLayoutPreview(layoutPath: string): Promise<PptxLayoutPreview | null>;
+  getLayoutPreviews(layoutPaths?: readonly string[]): Promise<PptxLayoutPreview[]>;
   createXmlBuilder(data: PptxData): PptxXmlBuilder;
   Builder(data: PptxData): PptxXmlBuilder;
-  getCompatibilityWarnings(): PptxCompatibilityWarning[];
+  setTemplateBackground(path: string, backgroundColor: string | undefined): void;
+  setPresentationTheme(themePath: string, applyToAllMasters?: boolean): Promise<void>;
+  getTemplateBackgroundColor(path: string): string | undefined;
+  updateThemeColorScheme(colorScheme: PptxThemeColorScheme): Promise<void>;
+  updateThemeFontScheme(fontScheme: PptxThemeFontScheme): Promise<void>;
+  updateThemeName(name: string): Promise<void>;
+  /** Resolve a `<p:style>` node against the loaded theme (see PptxHandlerRuntimeStyleMatrixResolve). */
+  resolveStyleMatrixReferences(styleXml: XmlObject, effectSchemeId?: string): ResolvedStyleMatrix;
+  /** Write a built-in effect scheme (`a:fmtScheme`) into the theme parts. */
+  applyThemeEffectScheme(id: string): Promise<PptxThemeFormatScheme | undefined>;
+  applyThemeFormatSchemeXml(fmtSchemeXml: string): Promise<PptxThemeFormatScheme | undefined>;
+  getThemeFormatScheme(): PptxThemeFormatScheme | undefined;
+  getThemeVariants(): PptxThemeVariant[];
+  reResolveThemeStyleReferences(slides: readonly PptxSlide[], templateElementsBySlideId: Readonly<Record<string, PptxElement[]>>, effectSchemeId?: string): StyleReferenceReResolution;
+  applyBackgroundStyleToSlides(slides: readonly PptxSlide[], templateElementsBySlideId: Readonly<Record<string, PptxElement[]>>, index: number, scope: BackgroundStyleScope): BackgroundStyleApplication | undefined;
+  commitMasterBackgroundStyle(index: number): Promise<boolean>;
+  applyTheme(colorScheme: PptxThemeColorScheme, fontScheme: PptxThemeFontScheme, themeName?: string): Promise<void>;
+  load(data: ArrayBuffer, options?: PptxHandlerLoadOptions): Promise<PptxData>;
+  getChartDataForGraphicFrame(slidePath: string, graphicFrame: XmlObject | undefined): Promise<PptxChartData | undefined>;
+  getSmartArtDataForGraphicFrame(slidePath: string, graphicFrame: XmlObject | undefined): Promise<PptxSmartArtData | undefined>;
+  getImageData(imagePath: string): Promise<string | undefined>;
   /**
-   * Find the master path that a given layout belongs to by scanning
-   * the layout's own `.rels` file for a `slideMaster` relationship.
+   * Extract a media file from the PPTX archive as an ArrayBuffer.
+   * Returns undefined if the file is not found.
    */
-  protected findMasterPathForLayout(layoutPath: string): string | undefined;
+  getMediaArrayBuffer(mediaPath: string): Promise<ArrayBuffer | undefined>;
+  save(slides: PptxSlide[], options?: PptxHandlerSaveOptions): Promise<Uint8Array>;
+  exportSlides(slides: PptxSlide[], options: PptxExportOptions): Promise<Map<number, Uint8Array>>;
   /**
-   * Find the master path for a slide by walking: slide -> layout -> master.
+   * Get the available slide layouts for a specific slide, based on the
+   * slide's master. Scans the slide master's relationships to find all
+   * layouts that belong to it.
+   *
+   * @param slideIndex - Zero-based slide index.
+   * @param slides - Current slides array.
+   * @returns Array of layout options belonging to the same slide master.
    */
-  protected findMasterPathForSlide(slidePath: string): string | undefined;
+  getAvailableLayoutsForSlide(slideIndex: number, slides: PptxSlide[]): Promise<PptxLayoutOption[]>;
   /**
    * Resolve the editable template (master + layout) elements a slide
-   * inherits, each carrying a `master-` / `layout-` prefixed id.
-   *
-   * This is the canonical entry point for an "edit template/master"
-   * feature: it returns the same decorative master/layout shapes that the
-   * loader already merges in front of slide-authored content (master shapes
-   * behind, layout shapes on top), reusing the cached
-   * {@link getLayoutElements} parse. Resolving a slide that has not been
-   * loaded yet (no relationships cached) yields an empty array.
-   *
-   * Important scope notes for callers:
-   *  - Placeholder shapes (`<p:ph>`) are intentionally excluded; those are
-   *    resolved separately into each slide's own placeholders. Only
-   *    non-placeholder decorations (shapes, pictures, graphic frames) are
-   *    returned, which is exactly what the save writeback path supports.
-   *  - The returned elements are shared by every slide that inherits the
-   *    same layout/master. Editing one element and saving updates the shared
-   *    layout/master part, so the change is visible on all sibling slides.
-   *  - To persist an edit the binding must keep the mutated template element
-   *    inside the `slide.elements` array it passes to {@link save}; the save
-   *    writer reads template elements from `ctx.slide.elements` and writes
-   *    their shape XML back into the owning `p:spTree`.
+   * inherits, each carrying a `master-` / `layout-` prefixed id. Excludes
+   * placeholders; returns only decorative shapes/pictures/graphic frames.
    *
-   * @param slideId - The slide's archive path (the `PptxSlide.id`, e.g.
-   *   `ppt/slides/slide1.xml`).
-   * @returns Master + layout elements with prefixed ids (may be empty).
+   * @param slideId - The slide's archive path (`PptxSlide.id`).
    */
   getTemplateElementsForSlide(slideId: string): Promise<PptxElement[]>;
   /**
-   * Get layouts available for a specific slide, scoped to that slide's
-   * master. If the slide's master cannot be determined, returns all
-   * known layouts.
+   * Scan the loaded PPTX archive for all theme parts.
    */
-  getAvailableLayoutsForSlide(slideIndex: number, slides: PptxSlide[]): Promise<PptxLayoutOption[]>;
-  protected buildLayoutOption(path: string, xmlObj: XmlObject): PptxLayoutOption;
+  getAvailableThemes(): Promise<Array<{
+    path: string;
+    name?: string;
+  }>>;
   /**
-   * Apply a different layout to an existing slide.
+   * Apply a different layout to an existing slide by updating the slide's
+   * relationship to point to the new layout and re-parsing layout
+   * placeholders / background.
    *
-   * This updates the slide's `.rels` file in the in-memory ZIP so the
-   * `slideLayout` relationship points to the new layout, then refreshes
-   * the slide's layout-derived properties (background, layoutPath,
-   * layoutName).
+   * @param slideIndex - Zero-based slide index.
+   * @param layoutPath - Archive path of the target layout
+   *                     (e.g. `ppt/slideLayouts/slideLayout2.xml`).
+   * @param slides - Current slides array.
+   * @returns The updated slide with new layout path, name, and background.
    */
   applyLayoutToSlide(slideIndex: number, layoutPath: string, slides: PptxSlide[]): Promise<PptxSlide>;
 }
 //#endregion
-//#region pptx/core/core/runtime/PptxHandlerRuntimeStyleMatrixResolve.d.ts
-declare class PptxHandlerRuntime$2 extends PptxHandlerRuntime$3 {
+//#region pptx/core/core/PptxHandlerRuntimeFactory.d.ts
+/**
+ * Abstract factory contract for creating {@link IPptxHandlerRuntime}
+ * instances.
+ *
+ * Implement this interface to supply a custom runtime (e.g. a
+ * WASM-backed or test-double runtime) to {@link PptxHandlerCore}.
+ */
+interface IPptxHandlerRuntimeFactory {
+  /** Instantiate and return a new runtime implementation. */
+  createRuntime(): IPptxHandlerRuntime;
+}
+/**
+ * Default factory that produces the standard {@link PptxHandlerRuntime}.
+ *
+ * Used internally by {@link PptxHandlerCore} when no custom factory is
+ * provided.
+ */
+declare class PptxHandlerRuntimeFactory implements IPptxHandlerRuntimeFactory {
   /**
-   * Resolve a `<p:style>` node (`a:lnRef`, `a:fillRef`, `a:effectRef`,
-   * `a:fontRef`) against the current theme's format scheme, with the same
-   * code the load path uses. Editors call this to apply a style-matrix
-   * gallery entry (Shape Styles) so that what they render and what they save
-   * both match what PowerPoint writes: a bare `<p:style>` and an `spPr` with
-   * no fill, outline or effects of its own.
+   * Create and return a new {@link PptxHandlerRuntime} instance.
+   *
+   * @returns A freshly constructed runtime ready for loading a PPTX file.
    */
-  resolveStyleMatrixReferences(styleXml: XmlObject): ResolvedStyleMatrix;
+  createRuntime(): IPptxHandlerRuntime;
 }
+/**
+ * Convenience function that creates a default {@link IPptxHandlerRuntime}
+ * without needing to instantiate the factory class.
+ *
+ * @returns A new {@link PptxHandlerRuntime} instance.
+ */
+declare const createDefaultPptxHandlerRuntime: () => IPptxHandlerRuntime;
 //#endregion
 //#region pptx/core/core/runtime/PptxHandlerRuntimeImplementation.d.ts
 declare class PptxHandlerRuntime$1 extends PptxHandlerRuntime$2 {
@@ -8447,7 +8563,30 @@ declare class PptxHandlerCore {
    * shape and it renders like PowerPoint's Shape Styles entry and saves as a
    * bare `<p:style>` with an empty `spPr`, which is what PowerPoint writes.
    */
-  resolveStyleMatrixReferences(styleXml: XmlObject): ResolvedStyleMatrix;
+  resolveStyleMatrixReferences(styleXml: XmlObject, effectSchemeId?: string): ResolvedStyleMatrix;
+  /**
+   * Design > Variants > Effects: write a built-in effect scheme (the theme's `a:fmtScheme`) into
+   * every theme part. Follow it with {@link reResolveThemeStyleReferences} to redraw the shapes.
+   */
+  applyThemeEffectScheme(id: string): Promise<PptxThemeFormatScheme | undefined>;
+  /** Write an `a:fmtScheme` element (a real theme variant's) into the theme parts. */
+  applyThemeFormatSchemeXml(fmtSchemeXml: string): Promise<PptxThemeFormatScheme | undefined>;
+  /** The real theme variants the loaded package carries (`themeVariants/` parts), or none. */
+  getThemeVariants(): PptxThemeVariant[];
+  /** The format scheme the deck's primary theme carries now. */
+  getThemeFormatScheme(): PptxThemeFormatScheme | undefined;
+  /**
+   * Resolve every shape's `p:style` references again. With `effectSchemeId` the result is a
+   * preview against that built-in scheme; without it, the scheme now in force.
+   */
+  reResolveThemeStyleReferences(slides: readonly PptxSlide[], templateElementsBySlideId: Readonly<Record<string, PptxElement[]>>, effectSchemeId?: string): StyleReferenceReResolution;
+  /**
+   * Design > Background Styles: apply preset `index` (1 to 12) to the slides in `scope`. Does not
+   * change the handler (a preview); {@link commitMasterBackgroundStyle} saves a deck-wide pick.
+   */
+  applyBackgroundStyleToSlides(slides: readonly PptxSlide[], templateElementsBySlideId: Readonly<Record<string, PptxElement[]>>, index: number, scope: BackgroundStyleScope): BackgroundStyleApplication | undefined;
+  /** Write background style `index` onto every slide master so a deck-wide pick is saved. */
+  commitMasterBackgroundStyle(index: number): Promise<boolean>;
   /**
    * Apply a complete theme in one call (colour scheme + font scheme + optional name).
    *
@@ -10150,5 +10289,5 @@ declare class PptxJsonConverter {
  */
 declare function applyImportedPptxData(base: PptxData, imported: PptxData): PptxData;
 //#endregion
-export { duplicateLayout as $, TableCellInput as $i, ResolveChartColor as $n, IPptxEditorAnimationService as $r, PptxShapeStyleExtractorContext as $t, SlideProcessor as A, setChartSeriesColor as Aa, PptxSlideElementsBuilder as Ai, buildSlideReferenceRemap as An, applyDiagramRelationshipIds as Ar, PptxElementXmlBuilderOptions as At, generateMediaFilename as B, ChartGradientInput as Ba, ChartOptions as Bi, PptxPresentationSaveBuilder as Bn, IPptxAnimationWriteService as Br, PptxBuilderFactoryContext as Bt, PptxJsonAssetStats as C, setChartDataPointExplosion as Ca, MAX_ZIP_ENTRY_COUNT as Ci, PptxCommentAuthorsXmlFactoryInit as Cn, verifySignatureDigests as Cr, diffSlides as Ct, SvgExportOptions as D, setChartGrouping as Da, ZipBombError as Di, PptxSlideRelationshipRegistry as Dn, EncryptionScheme as Dr, createAutoNumberSequence as Dt, isPptxJsonText as E, setChartDataPointMarker as Ea, PptxSaveFormat as Ei, PptxSlideCommentRelationshipInfo as En, EncryptionOptions as Er, breakAutoNumberRun as Et, deriveOutputPath as F, setChartType as Fa, buildBlankPresentationArchive as Fi, PptxSaveMediaKind as Fn, parseCustomShows as Fr, IPptxXmlFactoryProvider as Ft, DuplicateMasterSuccess as G, GroupOptions as Gi, PptxContentTypesSlideMediaBuildInput as Gn, ooxmlToPresetName as Gr, IPptxMediaDataParser as Gt, ConversionResult as H, toChartGradientFill as Ha, ConnectorOptions as Hi, IPptxContentTypesBuilder as Hn, OOXML_TO_PRESET_ENTR as Hr, IPptxGraphicFrameParser as Ht, getDirectory as I, updateChartDataPoint as Ia, SlideBuilder as Ii, PptxSaveState as In, IPptxRuntimeDependencyFactory as Ir, ITextShapeXmlFactory as It, insertSlideMaster as J, PresentationOptions as Ji, PptxConnectorParserContext as Jn, IPptxSlideTransitionService as Jr, IPptxTableDataParser as Jt, deleteSlideMaster as K, ImageOptions as Ki, IPptxConnectorParser as Kn, resolveOoxmlPresetMapping as Kr, PptxMediaDataParser as Kt, normalizePath as L, updateChartSeriesValues as La, AnimationInput as Li, PptxSaveStateBuilder as Ln, PptxRuntimeDependencyBundle as Lr, IXmlElementFactory as Lt, PptxConverterOptions as M, setChartSeriesMarker as Ma, PptxXmlBuilder as Mi, PptxPresentationSlidesReconciler as Mn, PptxSlideReferenceRemap as Mr, IConnectorXmlFactory as Mt, PptxMarkdownConverter as N, setChartSeriesTrendline as Na, PresentationBuilder as Ni, PptxPresentationSlidesReconcilerInput as Nn, applyCustomShows as Nr, IMediaGraphicFrameXmlFactory as Nt, SvgExporter as O, setChartLegend as Oa, IPptxXmlBuilder as Oi, PptxSlideRelationshipRegistryOptions as On, StandardEncryptionInfo as Or, nextAutoNumber as Ot, DocumentConverter as P, setChartTitle as Pa, PresentationBuilderResult as Pi, PptxCommentAuthorDescriptor as Pn, applySections as Pr, IPictureXmlFactory as Pt, deleteLayout as Q, StrokeInput as Qi, IFactory as Qn, PptxNativeAnimationService as Qr, PptxShapeStyleExtractor as Qt, MediaContext as R, ChartAreaFormatInput as Ra, BackgroundInput as Ri, IPptxPresentationSaveBuilder as Rn, PptxRuntimeDependencyFactory as Rr, MediaGraphicFrameXmlFactoryInit as Rt, PPTX_JSON_VERSION as S, setChartDataLabels as Sa, IPptxHandlerRuntime as Si, IPptxSlideCommentsXmlFactory as Sn, parseSignatureXml as Sr, diffPresentations as St, decodePptxJsonText as T, setChartDataPointLabel as Ta, PptxHandlerSaveOptions as Ti, IPptxSlideRelationshipRegistry as Tn, EncryptionInfo as Tr, PptxHandlerRuntime as Tt, FileSystemAdapter as U, PptxThemePreset as Ua, ElementPosition as Ui, PptxContentTypesBuilder as Un, OOXML_TO_PRESET_EXIT as Ur, PptxGraphicFrameParser as Ut, ConversionOptions as V, ChartGradientStopInput as Va, ChartSeriesInput as Vi, PptxPresentationSaveBuilderOptions as Vn, OOXML_TO_PRESET_EMPH as Vr, TextShapeXmlFactoryInit as Vt, DuplicateMasterResult as W, THEME_PRESETS as Wa, FillInput as Wi, PptxContentTypesCommentBuildInput as Wn, PRESET_TO_OOXML as Wr, PptxGraphicFrameParserContext as Wt, DuplicateLayoutResult as X, ShadowInput as Xi, PptxSaveConstantsFactory as Xn, PptxSlideTransitionServiceOptions as Xr, PptxTableDataParserContext as Xt, renameSlideMaster as Y, PresentationThemeInput as Yi, PptxSaveConstants as Yn, PptxSlideTransitionService as Yr, PptxTableDataParser as Yt, DuplicateLayoutSuccess as Z, ShapeOptions as Zi, createPptxSaveConstants as Zn, IPptxNativeAnimationService as Zr, IPptxShapeStyleExtractor as Zt, decodeJsonValue as _, setChartAxis as _a, PptxCompatibilityService as _i, PptxCommentAuthorsXmlFactory as _n, SignatureDetectionResult as _r, TemplateData as _t, deserializePptxFromJson as a, TextStyleInput as aa, IPptxSlideLoaderService as ai, PptxSlideBackgroundBuilderInput as an, isStrictNamespaceUri as ar, LayoutCreationResult as at, PPTX_JSON_FORMAT as b, setChartAxisTitleStyle as ba, createDefaultPptxHandlerRuntime as bi, IPptxCommentAuthorsXmlFactory as bn, detectDigitalSignatures as br, PropertyChange as bt, pptxDataFromJsonDocument as c, ChartAxisTitleStyleEdit as ca, PptxSlideLoaderParams as ci, PptxSlideNotesPartUpdaterInput as cn, normalizeStrictXml as cr, createLayout as ct, serializePptxToJson as d, PptxChartAxisType as da, IPptxTemplateBackgroundService as di, IPptxElementTransformUpdater as dn, SHAPE_TREE_ELEMENT_TAGS as dr, findLayoutByType as dt, TableInput as ea, PptxEditorAnimationService as ei, IPptxColorStyleCodec as en, parsePresentationSmartTags as er, insertLayout as et, PRESENTATION_FIELD_KEYS as f, PptxChartLegendPosition as fa, PptxTemplateBackgroundService as fi, PptxElementTransformUpdater as fn, reapplyAlternateContentToTree as fr, generateLayoutXml as ft, bytesToBase64 as g, removeChartSeries as ga, IPptxCompatibilityService as gi, PptxCommentXmlFactoryProvider as gn, SignatureCertificateInfo as gr, mailMerge as gt, base64ToBytes as h, removeChartCategory as ha, CompatibilityWarningInput as hi, PptxSlideCommentPartWriterInput as hn, ParsedSignature as hr, findPlaceholders as ht, PptxJsonFormatError as i, TextSegmentInput as ia, PptxSlideLoaderService as ii, PptxSlideBackgroundBuilder as in, detectStrictConformance as ir, MasterLayoutCrudSuccess as it, SlideProcessorOptions as j, setChartSeriesErrorBars as ja, PptxSlideNotesBuilder as ji, IPptxPresentationSlidesReconciler as jn, parseDiagramRelationshipIds as jr, ConnectorXmlFactoryInit as jt, SlideMetadataRenderer as k, setChartSeriesChartType as ka, PptxSlideBuilder as ki, SlideReferenceRemapInput as kn, DiagramRelationshipIds as kr, PptxElementXmlBuilder as kt, PptxJsonSerializeOptions as l, ChartDataPointLabelEdit as la, PptxSlideLoaderThemeOverride as li, IPptxSlideMediaRelationshipBuilder as ln, toStrictNamespaceUri as lr, createLayouts as lt, JsonAssetAccumulator as m, addChartSeries as ma, PptxDocumentPropertiesUpdater as mi, PptxSlideCommentPartWriter as mn, unwrapAlternateContent as mr, applyTemplate as mt, PptxJsonConverterOptions as n, TableRowInput as na, IPptxXmlLookupService as ni, PptxColorStyleCodecContext as nn, containsConvertibleStrictNamespaceAttribute as nr, MasterLayoutCrudFailure as nt, parsePptxJson as o, TransitionInput as oa, PptxMediaTimingEntry as oi, IPptxSlideNotesPartUpdater as on, isTransitionalNamespaceUri as or, LayoutDefinition as ot, PRESENTATION_FIELD_NAMES as p, addChartCategory as pa, PptxTemplateBackgroundState as pi, IPptxSlideCommentPartWriter as pn, selectAlternateContentBranch as pr, Presentation as pt, duplicateSlideMaster as q, MediaOptions as qi, PptxConnectorParser as qn, OoxmlPresetMapping as qr, PptxMediaDataParserContext as qt, applyImportedPptxData as r, TextOptions as ra, PptxXmlLookupService as ri, IPptxSlideBackgroundBuilder as rn, convertXmlToStrict as rr, MasterLayoutCrudResult as rt, parsePptxJsonDocument as s, ChartAxisEdit as sa, PptxMediaTimingMap as si, PptxSlideNotesPartUpdater as sn, normalizeNamespaceUri as sr, PlaceholderDefinition as st, PptxJsonConverter as t, TableOptions as ta, PptxEditorAnimationServiceOptions as ti, PptxColorStyleCodec as tn, OoxmlConformanceClass as tr, renameLayout as tt, buildPptxJsonDocument as u, ChartGridlineStyleEdit as ua, PptxSlideNotesResult as ui, PptxSlideMediaRelationshipBuilder as un, AlternateContentBlock as ur, findLayoutByName as ut, encodeJsonValue as v, setChartAxisGridlineStyle as va, IPptxHandlerRuntimeFactory as vi, PptxSlideCommentsXmlFactory as vn, SignatureReference as vr, ElementDiff as vt, PptxJsonDocument as w, setChartDataPointFill as wa, PptxHandlerLoadOptions as wi, PptxSlideCommentsXmlFactoryInit as wn, EncryptionAlgorithm as wr, PptxHandler as wt, PPTX_JSON_MIME_TYPE as x, setChartCategories as xa, DEFAULT_MAX_UNCOMPRESSED_BYTES as xi, IPptxCommentXmlFactoryProvider as xn, getSignaturePathsToStrip as xr, SlideDiff as xt, PPTX_JSON_FILE_EXTENSION as y, setChartAxisLogScale as ya, PptxHandlerRuntimeFactory as yi, ICoreXmlElementFactory as yn, SignatureStatus as yr, PresentationDiff as yt, dataUrlToMediaBytes as z, ChartGroupOptionsInput as za, ChartInput as zi, PptxPresentationSaveBuildInput as zn, PptxRuntimeDependencyFactoryInput as zr, PictureXmlFactoryInit as zt };
-//# sourceMappingURL=index-DS9Y4Ne3.d.ts.map
+export { duplicateLayout as $, PresentationThemeInput as $i, PptxPresentationSaveBuilder as $n, ooxmlToPresetName as $r, PptxBuilderFactoryContext as $t, SlideProcessor as A, setChartDataPointMarker as Aa, applyDiagramRelationshipIds as Ai, PptxCommentAuthorsXmlFactory as An, SignatureStatus as Ar, IPptxHandlerRuntime as At, generateMediaFilename as B, updateChartDataPoint as Ba, SlideBuilder as Bi, PptxSlideRelationshipRegistry as Bn, PptxSlideReferenceRemap as Br, createAutoNumberSequence as Bt, PptxJsonAssetStats as C, setChartAxisLogScale as Ca, CompatibilityWarningInput as Ci, PptxSlideMediaRelationshipBuilder as Cn, reapplyAlternateContentToTree as Cr, diffSlides as Ct, SvgExportOptions as D, setChartDataPointExplosion as Da, PptxConnectorParser as Di, PptxSlideCommentPartWriter as Dn, SignatureCertificateInfo as Dr, PptxHandlerRuntimeFactory as Dt, isPptxJsonText as E, setChartDataLabels as Ea, IPptxConnectorParser as Ei, IPptxSlideCommentPartWriter as En, ParsedSignature as Er, IPptxHandlerRuntimeFactory as Et, deriveOutputPath as F, setChartSeriesErrorBars as Fa, PptxSlideNotesBuilder as Fi, IPptxSlideCommentsXmlFactory as Fn, EncryptionAlgorithm as Fr, ZipBombError as Ft, DuplicateMasterSuccess as G, ChartGradientStopInput as Ga, ChartSeriesInput as Gi, PptxPresentationSlidesReconciler as Gn, PptxRuntimeDependencyBundle as Gr, IConnectorXmlFactory as Gt, ConversionResult as H, ChartAreaFormatInput as Ha, BackgroundInput as Hi, SlideReferenceRemapInput as Hn, applySections as Hr, PptxElementXmlBuilder as Ht, getDirectory as I, setChartSeriesMarker as Ia, PptxXmlBuilder as Ii, PptxCommentAuthorsXmlFactoryInit as In, EncryptionInfo as Ir, BackgroundStyleApplication as It, insertSlideMaster as J, THEME_PRESETS as Ja, FillInput as Ji, PptxSaveMediaKind as Jn, IPptxAnimationWriteService as Jr, IPptxXmlFactoryProvider as Jt, deleteSlideMaster as K, toChartGradientFill as Ka, ConnectorOptions as Ki, PptxPresentationSlidesReconcilerInput as Kn, PptxRuntimeDependencyFactory as Kr, IMediaGraphicFrameXmlFactory as Kt, normalizePath as L, setChartSeriesTrendline as La, PresentationBuilder as Li, PptxSlideCommentsXmlFactoryInit as Ln, EncryptionOptions as Lr, BackgroundStyleScope as Lt, PptxConverterOptions as M, setChartLegend as Ma, IPptxXmlBuilder as Mi, ICoreXmlElementFactory as Mn, getSignaturePathsToStrip as Mr, PptxHandlerLoadOptions as Mt, PptxMarkdownConverter as N, setChartSeriesChartType as Na, PptxSlideBuilder as Ni, IPptxCommentAuthorsXmlFactory as Nn, parseSignatureXml as Nr, PptxHandlerSaveOptions as Nt, SvgExporter as O, setChartDataPointFill as Oa, PptxConnectorParserContext as Oi, PptxSlideCommentPartWriterInput as On, SignatureDetectionResult as Or, createDefaultPptxHandlerRuntime as Ot, DocumentConverter as P, setChartSeriesColor as Pa, PptxSlideElementsBuilder as Pi, IPptxCommentXmlFactoryProvider as Pn, verifySignatureDigests as Pr, PptxSaveFormat as Pt, deleteLayout as Q, PresentationOptions as Qi, PptxPresentationSaveBuildInput as Qn, PRESET_TO_OOXML as Qr, PictureXmlFactoryInit as Qt, MediaContext as R, setChartTitle as Ra, PresentationBuilderResult as Ri, IPptxSlideRelationshipRegistry as Rn, EncryptionScheme as Rr, StyleReferenceReResolution as Rt, PPTX_JSON_VERSION as S, setChartAxisGridlineStyle as Sa, PptxDocumentPropertiesUpdater as Si, IPptxSlideMediaRelationshipBuilder as Sn, SHAPE_TREE_ELEMENT_TAGS as Sr, diffPresentations as St, decodePptxJsonText as T, setChartCategories as Ta, PptxCompatibilityService as Ti, PptxElementTransformUpdater as Tn, unwrapAlternateContent as Tr, PptxHandlerRuntime as Tt, FileSystemAdapter as U, ChartGroupOptionsInput as Ua, ChartInput as Ui, buildSlideReferenceRemap as Un, parseCustomShows as Ur, PptxElementXmlBuilderOptions as Ut, ConversionOptions as V, updateChartSeriesValues as Va, AnimationInput as Vi, PptxSlideRelationshipRegistryOptions as Vn, applyCustomShows as Vr, nextAutoNumber as Vt, DuplicateMasterResult as W, ChartGradientInput as Wa, ChartOptions as Wi, IPptxPresentationSlidesReconciler as Wn, IPptxRuntimeDependencyFactory as Wr, ConnectorXmlFactoryInit as Wt, DuplicateLayoutResult as X, ImageOptions as Xi, PptxSaveStateBuilder as Xn, OOXML_TO_PRESET_ENTR as Xr, IXmlElementFactory as Xt, renameSlideMaster as Y, GroupOptions as Yi, PptxSaveState as Yn, OOXML_TO_PRESET_EMPH as Yr, ITextShapeXmlFactory as Yt, DuplicateLayoutSuccess as Z, MediaOptions as Zi, IPptxPresentationSaveBuilder as Zn, OOXML_TO_PRESET_EXIT as Zr, MediaGraphicFrameXmlFactoryInit as Zt, decodeJsonValue as _, addChartCategory as _a, PptxSlideLoaderThemeOverride as _i, PptxSlideBackgroundBuilder as _n, isTransitionalNamespaceUri as _r, TemplateData as _t, deserializePptxFromJson as a, TableOptions as aa, IPptxNativeAnimationService as ai, PptxMediaDataParser as an, PptxSaveConstants as ar, LayoutCreationResult as at, PPTX_JSON_FORMAT as b, removeChartSeries as ba, PptxTemplateBackgroundService as bi, PptxSlideNotesPartUpdater as bn, toStrictNamespaceUri as br, PropertyChange as bt, pptxDataFromJsonDocument as c, TextSegmentInput as ca, PptxEditorAnimationService as ci, PptxTableDataParser as cn, IFactory as cr, createLayout as ct, serializePptxToJson as d, ChartAxisEdit as da, PptxXmlLookupService as di, PptxShapeStyleExtractor as dn, parsePresentationSmartTags as dr, findLayoutByType as dt, ShadowInput as ea, resolveOoxmlPresetMapping as ei, TextShapeXmlFactoryInit as en, PptxPresentationSaveBuilderOptions as er, insertLayout as et, PRESENTATION_FIELD_KEYS as f, ChartAxisTitleStyleEdit as fa, PptxSlideLoaderService as fi, PptxShapeStyleExtractorContext as fn, OoxmlConformanceClass as fr, generateLayoutXml as ft, bytesToBase64 as g, PptxChartLegendPosition as ga, PptxSlideLoaderParams as gi, IPptxSlideBackgroundBuilder as gn, isStrictNamespaceUri as gr, mailMerge as gt, base64ToBytes as h, PptxChartAxisType as ha, PptxMediaTimingMap as hi, PptxColorStyleCodecContext as hn, detectStrictConformance as hr, findPlaceholders as ht, PptxJsonFormatError as i, TableInput as ia, PptxSlideTransitionServiceOptions as ii, IPptxMediaDataParser as in, PptxContentTypesSlideMediaBuildInput as ir, MasterLayoutCrudSuccess as it, SlideProcessorOptions as j, setChartGrouping as ja, parseDiagramRelationshipIds as ji, PptxSlideCommentsXmlFactory as jn, detectDigitalSignatures as jr, MAX_ZIP_ENTRY_COUNT as jt, SlideMetadataRenderer as k, setChartDataPointLabel as ka, DiagramRelationshipIds as ki, PptxCommentXmlFactoryProvider as kn, SignatureReference as kr, DEFAULT_MAX_UNCOMPRESSED_BYTES as kt, PptxJsonSerializeOptions as l, TextStyleInput as la, PptxEditorAnimationServiceOptions as li, PptxTableDataParserContext as ln, ResolveChartColor as lr, createLayouts as lt, JsonAssetAccumulator as m, ChartGridlineStyleEdit as ma, PptxMediaTimingEntry as mi, PptxColorStyleCodec as mn, convertXmlToStrict as mr, applyTemplate as mt, PptxJsonConverterOptions as n, StrokeInput as na, IPptxSlideTransitionService as ni, PptxGraphicFrameParser as nn, PptxContentTypesBuilder as nr, MasterLayoutCrudFailure as nt, parsePptxJson as o, TableRowInput as oa, PptxNativeAnimationService as oi, PptxMediaDataParserContext as on, PptxSaveConstantsFactory as or, LayoutDefinition as ot, PRESENTATION_FIELD_NAMES as p, ChartDataPointLabelEdit as pa, IPptxSlideLoaderService as pi, IPptxColorStyleCodec as pn, containsConvertibleStrictNamespaceAttribute as pr, Presentation as pt, duplicateSlideMaster as q, PptxThemePreset as qa, ElementPosition as qi, PptxCommentAuthorDescriptor as qn, PptxRuntimeDependencyFactoryInput as qr, IPictureXmlFactory as qt, applyImportedPptxData as r, TableCellInput as ra, PptxSlideTransitionService as ri, PptxGraphicFrameParserContext as rn, PptxContentTypesCommentBuildInput as rr, MasterLayoutCrudResult as rt, parsePptxJsonDocument as s, TextOptions as sa, IPptxEditorAnimationService as si, IPptxTableDataParser as sn, createPptxSaveConstants as sr, PlaceholderDefinition as st, PptxJsonConverter as t, ShapeOptions as ta, OoxmlPresetMapping as ti, IPptxGraphicFrameParser as tn, IPptxContentTypesBuilder as tr, renameLayout as tt, buildPptxJsonDocument as u, TransitionInput as ua, IPptxXmlLookupService as ui, IPptxShapeStyleExtractor as un, loadThemeVariants as ur, findLayoutByName as ut, encodeJsonValue as v, addChartSeries as va, PptxSlideNotesResult as vi, PptxSlideBackgroundBuilderInput as vn, normalizeNamespaceUri as vr, ElementDiff as vt, PptxJsonDocument as w, setChartAxisTitleStyle as wa, IPptxCompatibilityService as wi, IPptxElementTransformUpdater as wn, selectAlternateContentBranch as wr, PptxHandler as wt, PPTX_JSON_MIME_TYPE as x, setChartAxis as xa, PptxTemplateBackgroundState as xi, PptxSlideNotesPartUpdaterInput as xn, AlternateContentBlock as xr, SlideDiff as xt, PPTX_JSON_FILE_EXTENSION as y, removeChartCategory as ya, IPptxTemplateBackgroundService as yi, IPptxSlideNotesPartUpdater as yn, normalizeStrictXml as yr, PresentationDiff as yt, dataUrlToMediaBytes as z, setChartType as za, buildBlankPresentationArchive as zi, PptxSlideCommentRelationshipInfo as zn, StandardEncryptionInfo as zr, breakAutoNumberRun as zt };
+//# sourceMappingURL=index-BWHNCVNC.d.ts.map