ooxml-core 1.25.2 → 1.26.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (103) hide show
  1. package/README.md +16 -0
  2. package/dist/{PptxHandler-AUK27AQD.mjs → PptxHandler-64BZOBWX.mjs} +3 -3
  3. package/dist/{PptxHandler-QBGEZDCO.cjs → PptxHandler-AILFLRH7.cjs} +3 -3
  4. package/dist/PptxHandler-PMLQGMFQ.mjs +4 -0
  5. package/dist/{PresentationBuilder-RX7D75GZ.mjs → PresentationBuilder-EJY2TYWL.mjs} +2 -2
  6. package/dist/{PresentationBuilder-MEETJGEA.mjs → PresentationBuilder-HBCCO2CF.mjs} +3 -3
  7. package/dist/{PresentationBuilder-CI45KEHL.cjs → PresentationBuilder-RBQP6A37.cjs} +5 -5
  8. package/dist/automation/index.cjs +273 -156
  9. package/dist/automation/index.mjs +273 -156
  10. package/dist/automation/xlsx-read.d.ts +2 -8
  11. package/dist/automation/xlsx-read.d.ts.map +1 -1
  12. package/dist/automation/xlsx.d.ts +2 -2
  13. package/dist/chart/index.cjs +89 -47
  14. package/dist/chart/index.mjs +89 -47
  15. package/dist/{chunk-6DHZZD5R.mjs → chunk-2XMK5SXU.mjs} +106 -48
  16. package/dist/{chunk-VGDHSED6.mjs → chunk-DHAZSMC7.mjs} +1 -1
  17. package/dist/{chunk-TX2QFS3J.mjs → chunk-FZBAMWCJ.mjs} +788 -542
  18. package/dist/{chunk-E2PYQQQV.mjs → chunk-JJ37PCNR.mjs} +89 -47
  19. package/dist/{chunk-S5TGOEQX.cjs → chunk-MU3XSASV.cjs} +106 -47
  20. package/dist/{chunk-GMETZZ3V.cjs → chunk-NXTHB2M3.cjs} +1857 -1611
  21. package/dist/{chunk-HVRFRYYS.mjs → chunk-OQPT5IC3.mjs} +5 -5
  22. package/dist/{chunk-5F7OB7PA.mjs → chunk-OTXJVFMY.mjs} +785 -539
  23. package/dist/{chunk-635WPRNJ.mjs → chunk-R7RL7W43.mjs} +19 -3
  24. package/dist/{chunk-E3PRAHL6.mjs → chunk-WRFMS5CL.mjs} +1 -1
  25. package/dist/docx/embedded.cjs +89 -47
  26. package/dist/docx/embedded.mjs +89 -47
  27. package/dist/docx/index.cjs +89 -47
  28. package/dist/docx/index.mjs +89 -47
  29. package/dist/docx/load/index.cjs +89 -47
  30. package/dist/docx/load/index.mjs +89 -47
  31. package/dist/index.cjs +128 -53
  32. package/dist/index.mjs +128 -53
  33. package/dist/opc/index.cjs +90 -47
  34. package/dist/opc/index.mjs +90 -48
  35. package/dist/opc/zip-limits.d.ts +6 -0
  36. package/dist/opc/zip-limits.d.ts.map +1 -1
  37. package/dist/pptx/automation/index.cjs +954 -622
  38. package/dist/pptx/automation/index.d.ts +4 -4
  39. package/dist/pptx/automation/index.mjs +6 -6
  40. package/dist/pptx/chunks/{index-DCbp5fOs.d.ts → index-CbFowkp4.d.ts} +12 -5
  41. package/dist/pptx/chunks/{index-DCbp5fOs.d.ts.map → index-CbFowkp4.d.ts.map} +1 -1
  42. package/dist/pptx/chunks/{index-CX0RM1fF.d.ts → index-D4FnOx6x.d.ts} +3 -3
  43. package/dist/pptx/chunks/{index-CX0RM1fF.d.ts.map → index-D4FnOx6x.d.ts.map} +1 -1
  44. package/dist/pptx/chunks/{index-CgjEEpfK.d.ts → index-D8DNpc1X.d.ts} +289 -118
  45. package/dist/pptx/chunks/index-D8DNpc1X.d.ts.map +1 -0
  46. package/dist/pptx/chunks/{text-operations-CjalmJIi.d.ts → text-operations-CNfUj45U.d.ts} +16 -2
  47. package/dist/pptx/chunks/{text-operations-CjalmJIi.d.ts.map → text-operations-CNfUj45U.d.ts.map} +1 -1
  48. package/dist/pptx/cli/index.cjs +954 -622
  49. package/dist/pptx/cli/index.d.ts +1 -1
  50. package/dist/pptx/cli/index.mjs +5 -5
  51. package/dist/pptx/converter/index.d.ts +1 -1
  52. package/dist/pptx/converter/index.mjs +3 -3
  53. package/dist/pptx/editor/render/editor-history.cjs +21 -0
  54. package/dist/pptx/editor/render/editor-history.d.ts +9 -0
  55. package/dist/pptx/editor/render/editor-history.d.ts.map +1 -1
  56. package/dist/pptx/editor/render/editor-history.mjs +21 -0
  57. package/dist/pptx/editor/render/find-replace.cjs +14 -14
  58. package/dist/pptx/editor/render/find-replace.d.ts +2 -2
  59. package/dist/pptx/editor/render/find-replace.mjs +1 -1
  60. package/dist/pptx/editor/render/slide-operations.cjs +8 -8
  61. package/dist/pptx/editor/render/slide-operations.mjs +2 -2
  62. package/dist/pptx/index.cjs +953 -620
  63. package/dist/pptx/index.d.ts +5 -5
  64. package/dist/pptx/index.mjs +6 -6
  65. package/dist/pptx/node/index.d.ts +1 -1
  66. package/dist/pptx/signature-node/index.cjs +89 -47
  67. package/dist/pptx/signature-node/index.mjs +2 -2
  68. package/dist/visio/index.cjs +266 -150
  69. package/dist/visio/index.mjs +266 -150
  70. package/dist/visio/ui/index.cjs +266 -150
  71. package/dist/visio/ui/index.mjs +266 -150
  72. package/dist/xlsx/index.cjs +518 -153
  73. package/dist/xlsx/index.mjs +518 -154
  74. package/dist/xlsx/load/index.cjs +266 -150
  75. package/dist/xlsx/load/index.mjs +266 -150
  76. package/dist/xlsx/numfmt/view.d.ts +13 -0
  77. package/dist/xlsx/numfmt/view.d.ts.map +1 -0
  78. package/dist/xlsx/read/index.d.ts +1 -0
  79. package/dist/xlsx/read/index.d.ts.map +1 -1
  80. package/dist/xlsx/read/limits.d.ts +5 -0
  81. package/dist/xlsx/read/limits.d.ts.map +1 -1
  82. package/dist/xlsx/read/package.d.ts +6 -0
  83. package/dist/xlsx/read/package.d.ts.map +1 -1
  84. package/dist/xlsx/read/rows-stream.d.ts +12 -0
  85. package/dist/xlsx/read/rows-stream.d.ts.map +1 -0
  86. package/dist/xlsx/read/rows.d.ts +37 -0
  87. package/dist/xlsx/read/rows.d.ts.map +1 -0
  88. package/dist/xlsx/read/shared-strings.d.ts +6 -1
  89. package/dist/xlsx/read/shared-strings.d.ts.map +1 -1
  90. package/dist/xlsx/read/sheet-data-source.d.ts +30 -3
  91. package/dist/xlsx/read/sheet-data-source.d.ts.map +1 -1
  92. package/dist/xlsx/read/sheet-data.d.ts +13 -2
  93. package/dist/xlsx/read/sheet-data.d.ts.map +1 -1
  94. package/dist/xlsx/read/worksheet.d.ts.map +1 -1
  95. package/dist/xlsx/ui/index.cjs +266 -150
  96. package/dist/xlsx/ui/index.mjs +266 -150
  97. package/dist/xml/index.cjs +38 -6
  98. package/dist/xml/index.mjs +37 -7
  99. package/dist/xml/lite.d.ts +15 -0
  100. package/dist/xml/lite.d.ts.map +1 -1
  101. package/package.json +1 -1
  102. package/dist/PptxHandler-5UO5DD5K.mjs +0 -4
  103. package/dist/pptx/chunks/index-CgjEEpfK.d.ts.map +0 -1
@@ -2,7 +2,7 @@ import { D as StrokeDashType, S as ConnectorArrowType, T as PptxShapeLocks, i as
2
2
  import { t as PptxThemeColorRef } from "./color-ref-DT599vEx.js";
3
3
  import { $ as ParsedTableStyleFill, $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, ar as ResolvedStyleMatrix, 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, or as ShapeStyle, pn as PptxChartUserShape, q as PptxMediaReferenceKind, qt as PptxChartMarker, rn as PptxChartTrendline, rr as PptxImageProperties, rt as ParsedTableStyleMap, s as InkPptxElement, t as ChartPptxElement, tn as PptxChartStyle, tr as PptxImageEffects, vn as ResolvedChartStyleDefinition, wt as PptxChartBoxWhiskerOptions, y as PptxImageLikeElement } from "./elements-DhW764aK.js";
4
4
  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-BEEl0l8X.js";
5
- 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-CjalmJIi.js";
5
+ import { $ as PptxThemeOption, C as PptxSlide, Ct as PptxCoreProperties, D as PptxSmartTagsReference, Dt as PptxTagCollection, J as PptxNotesMaster, K as PptxLayoutPreview, P as PptxViewProperties, Q as PptxTextStyleLevels, Rt as PptxAnimationPreset, S as PptxSection, St as PptxCompatibilityWarning, T as PptxSlideSize, Tt as PptxModernCommentAuthor, V as PptxEmbeddedFontList, W as PptxHandoutMaster, Wt as PptxAnimationTrigger, X as PptxSlideLayout, Y as PptxPlaceholderFrame, Z as PptxSlideMaster, Zt as PptxNativeAnimation, _ as PptxLayoutOption, _t as PptxThemeVariant, a as MergeOptions, b as PptxPhotoAlbum, bt as PptxComment, c as PptxCustomShow, ct as PptxThemeColorScheme, d as PptxData, f as PptxEmbeddedFont, ft as PptxThemeFontScheme, g as PptxKinsoku, gt as PptxThemePartSchemes, h as PptxHeaderFooter, ht as PptxThemeObjectDefaults, l as PptxCustomXmlPart, lt as PptxThemeEffectStyle, m as PptxExportOptions, mn as PptxSlideTransition, mt as PptxThemeLineStyle, pt as PptxThemeFormatScheme, q as PptxMasterTextStyles, qt as PptxElementAnimation, s as PptxActiveXControl, st as PptxTheme, t as FindResult, u as PptxCustomerData, ut as PptxThemeFillStyle, v as PptxModernCommentPart, w as PptxSlideBackgroundPattern, wt as PptxCustomProperty, x as PptxPresentationProperties, xn as PptxTransitionType, xt as PptxCommentAuthor, y as PptxModifyVerifier, yt as PptxAppProperties } from "./text-operations-CNfUj45U.js";
6
6
  import { XMLBuilder, XMLParser } from "fast-xml-parser";
7
7
  import JSZip from "jszip";
8
8
  //#region pptx/core/types/theme-presets.d.ts
@@ -2399,7 +2399,7 @@ declare class TemplateElementBaselineTracker {
2399
2399
  * the constructor of the final concrete class
2400
2400
  * ({@link PptxHandlerRuntimeImplementation}).
2401
2401
  */
2402
- declare class PptxHandlerRuntime$104 {
2402
+ declare class PptxHandlerRuntime$106 {
2403
2403
  /** The in-memory ZIP archive representing the OPC (.pptx) package. */
2404
2404
  protected zip: JSZip;
2405
2405
  /** fast-xml-parser instance used to parse XML strings into JS objects. */
@@ -2812,7 +2812,7 @@ declare class PptxHandlerRuntime$104 {
2812
2812
  }
2813
2813
  //#endregion
2814
2814
  //#region pptx/core/core/runtime/PptxHandlerRuntimeTableStyles.d.ts
2815
- declare class PptxHandlerRuntime$103 extends PptxHandlerRuntime$104 {
2815
+ declare class PptxHandlerRuntime$105 extends PptxHandlerRuntime$106 {
2816
2816
  /**
2817
2817
  * Export slides to a vector or raster format, keyed by slide index.
2818
2818
  *
@@ -2902,12 +2902,20 @@ declare class PptxHandlerRuntime$103 extends PptxHandlerRuntime$104 {
2902
2902
  }
2903
2903
  //#endregion
2904
2904
  //#region pptx/core/core/runtime/PptxHandlerRuntimeElementActions.d.ts
2905
- declare class PptxHandlerRuntime$102 extends PptxHandlerRuntime$103 {
2905
+ /** What an element's actions need from the part being saved to write their relationships. */
2906
+ interface ActionRelationshipContext {
2907
+ readonly resolveHyperlinkRelationshipId: (target: string, forceExternal?: boolean) => string | undefined;
2908
+ /** The part's relationships, `Id` to `Target`. */
2909
+ readonly getSlideRelationshipMap: () => Map<string, string>;
2910
+ /** The `Target`, from the part being saved, of the deck's slide at `index` (a slide jump). */
2911
+ readonly slideTargetAt?: ((index: number) => string | undefined) | undefined;
2912
+ }
2913
+ declare class PptxHandlerRuntime$104 extends PptxHandlerRuntime$105 {
2906
2914
  /**
2907
2915
  * Write or remove a single `a:hlinkClick` / `a:hlinkHover` node on
2908
2916
  * a `p:cNvPr` parent.
2909
2917
  */
2910
- protected serializeSingleAction(cNvPr: XmlObject, nodeName: string, action: PptxAction | undefined, resolveHyperlinkRelationshipId: (target: string, forceExternal?: boolean) => string | undefined): void;
2918
+ protected serializeSingleAction(cNvPr: XmlObject, nodeName: string, action: PptxAction | undefined, links: ActionRelationshipContext): void;
2911
2919
  /**
2912
2920
  * The `p:spTree` child tag an element of this type is written under.
2913
2921
  *
@@ -2938,7 +2946,7 @@ declare class PptxHandlerRuntime$102 extends PptxHandlerRuntime$103 {
2938
2946
  * the `a:hlinkClick` and `a:hlinkHover` nodes on the element's
2939
2947
  * non-visual properties.
2940
2948
  */
2941
- protected serializeElementActions(shape: XmlObject, el: PptxElement, resolveHyperlinkRelationshipId: (target: string, forceExternal?: boolean) => string | undefined): void;
2949
+ protected serializeElementActions(shape: XmlObject, el: PptxElement, links: ActionRelationshipContext): void;
2942
2950
  /**
2943
2951
  * Serialize shape lock attributes from an element back into the XML.
2944
2952
  *
@@ -2959,7 +2967,7 @@ declare class PptxHandlerRuntime$102 extends PptxHandlerRuntime$103 {
2959
2967
  }
2960
2968
  //#endregion
2961
2969
  //#region pptx/core/core/runtime/PptxHandlerRuntimeTableStylesAndActions.d.ts
2962
- declare class PptxHandlerRuntime$101 extends PptxHandlerRuntime$102 {
2970
+ declare class PptxHandlerRuntime$103 extends PptxHandlerRuntime$104 {
2963
2971
  /**
2964
2972
  * Parse a single `a:hlinkClick` or `a:hlinkHover` node into a `PptxAction`.
2965
2973
  */
@@ -3014,7 +3022,7 @@ interface MediaTimingData {
3014
3022
  */
3015
3023
  mediaEmbedPath?: string;
3016
3024
  }
3017
- declare class PptxHandlerRuntime$100 extends PptxHandlerRuntime$101 {
3025
+ declare class PptxHandlerRuntime$102 extends PptxHandlerRuntime$103 {
3018
3026
  /**
3019
3027
  * Extract image recolour/brightness/contrast/artistic effects from blip extensions.
3020
3028
  */
@@ -3054,7 +3062,7 @@ declare class PptxHandlerRuntime$100 extends PptxHandlerRuntime$101 {
3054
3062
  }
3055
3063
  //#endregion
3056
3064
  //#region pptx/core/core/runtime/PptxHandlerRuntimeMediaTimingParsing.d.ts
3057
- declare class PptxHandlerRuntime$99 extends PptxHandlerRuntime$100 {
3065
+ declare class PptxHandlerRuntime$101 extends PptxHandlerRuntime$102 {
3058
3066
  /**
3059
3067
  * Recursively walk the timing tree looking for `p:video` and `p:audio`
3060
3068
  * nodes that contain `p:cMediaNode`.
@@ -3087,7 +3095,7 @@ declare class PptxHandlerRuntime$99 extends PptxHandlerRuntime$100 {
3087
3095
  }
3088
3096
  //#endregion
3089
3097
  //#region pptx/core/core/runtime/PptxHandlerRuntimeMediaData.d.ts
3090
- declare class PptxHandlerRuntime$98 extends PptxHandlerRuntime$99 {
3098
+ declare class PptxHandlerRuntime$100 extends PptxHandlerRuntime$101 {
3091
3099
  /** Forward declaration implemented later in the runtime inheritance chain. */
3092
3100
  protected resolveThemeColor(_schemeKey: string): string | undefined;
3093
3101
  /**
@@ -3133,10 +3141,14 @@ declare class PptxHandlerRuntime$98 extends PptxHandlerRuntime$99 {
3133
3141
  }
3134
3142
  //#endregion
3135
3143
  //#region pptx/core/core/runtime/PptxHandlerRuntimeDocProperties.d.ts
3136
- declare class PptxHandlerRuntime$97 extends PptxHandlerRuntime$98 {
3144
+ declare class PptxHandlerRuntime$99 extends PptxHandlerRuntime$100 {
3137
3145
  protected buildRelativeTargetPath(fromPartPath: string, toPartPath: string): string;
3138
- protected setMasterThemeRelationship(masterPath: string, themePath: string): Promise<void>;
3139
- setPresentationTheme(themePath: string, applyToAllMasters?: boolean): Promise<void>;
3146
+ /**
3147
+ * Point a slide master's theme relationship at `themePath`.
3148
+ *
3149
+ * @returns whether the master had a theme relationship to rewrite
3150
+ */
3151
+ protected setMasterThemeRelationship(masterPath: string, themePath: string): Promise<boolean>;
3140
3152
  /** The text of a package part, or `undefined` when the package has no such part. */
3141
3153
  private readPartText;
3142
3154
  /**
@@ -3188,7 +3200,7 @@ declare class PptxHandlerRuntime$97 extends PptxHandlerRuntime$98 {
3188
3200
  }
3189
3201
  //#endregion
3190
3202
  //#region pptx/core/core/runtime/PptxHandlerRuntimeSlideMasters.d.ts
3191
- declare class PptxHandlerRuntime$96 extends PptxHandlerRuntime$97 {
3203
+ declare class PptxHandlerRuntime$98 extends PptxHandlerRuntime$99 {
3192
3204
  /**
3193
3205
  * Parse background colour from a `p:bg` node.
3194
3206
  */
@@ -3233,7 +3245,7 @@ declare class PptxHandlerRuntime$96 extends PptxHandlerRuntime$97 {
3233
3245
  }
3234
3246
  //#endregion
3235
3247
  //#region pptx/core/core/runtime/PptxHandlerRuntimePresentationProps.d.ts
3236
- declare class PptxHandlerRuntime$95 extends PptxHandlerRuntime$96 {
3248
+ declare class PptxHandlerRuntime$97 extends PptxHandlerRuntime$98 {
3237
3249
  /**
3238
3250
  * Forward declaration - implemented in PptxHandlerRuntimeTextStyleUtils.
3239
3251
  * Resolves `+mj-lt` / `+mn-lt` theme font tokens to the theme typeface.
@@ -3292,7 +3304,7 @@ interface EmbedTransitionSoundContext {
3292
3304
  slideAudioRelationshipType: string;
3293
3305
  slideId: string;
3294
3306
  }
3295
- declare class PptxHandlerRuntime$94 extends PptxHandlerRuntime$95 {
3307
+ declare class PptxHandlerRuntime$96 extends PptxHandlerRuntime$97 {
3296
3308
  protected createEmptySlideXml(): XmlObject;
3297
3309
  protected deepCloneXml(value: XmlObject | undefined): XmlObject | undefined;
3298
3310
  protected findSourceSlidePath(requestedSourcePath: string | undefined): string | undefined;
@@ -3342,18 +3354,18 @@ declare class PptxHandlerRuntime$94 extends PptxHandlerRuntime$95 {
3342
3354
  }
3343
3355
  //#endregion
3344
3356
  //#region pptx/core/core/runtime/PptxHandlerRuntimeSaveRunProperties.d.ts
3345
- declare class PptxHandlerRuntime$93 extends PptxHandlerRuntime$94 {
3357
+ declare class PptxHandlerRuntime$95 extends PptxHandlerRuntime$96 {
3346
3358
  protected createRunPropertiesFromTextStyle(style: TextStyle | undefined, resolveHyperlinkRelationshipId?: (target: string) => string | undefined): XmlObject | undefined;
3347
3359
  private applyHyperlinkExtraAttrs;
3348
3360
  }
3349
3361
  //#endregion
3350
3362
  //#region pptx/core/core/runtime/PptxHandlerRuntimeSaveParagraphs.d.ts
3351
- declare class PptxHandlerRuntime$92 extends PptxHandlerRuntime$93 {
3363
+ declare class PptxHandlerRuntime$94 extends PptxHandlerRuntime$95 {
3352
3364
  protected createParagraphsFromTextContent(text: string | undefined, textStyle: TextStyle | undefined, textSegments: TextSegment[] | undefined, resolveHyperlinkRelationshipId?: (target: string) => string | undefined): XmlObject[];
3353
3365
  }
3354
3366
  //#endregion
3355
3367
  //#region pptx/core/core/runtime/PptxHandlerRuntimeSaveElements.d.ts
3356
- declare class PptxHandlerRuntime$91 extends PptxHandlerRuntime$92 {
3368
+ declare class PptxHandlerRuntime$93 extends PptxHandlerRuntime$94 {
3357
3369
  protected updateNotesXmlText(notesXmlObj: XmlObject, notesText: string | undefined, notesSegments?: TextSegment[]): boolean;
3358
3370
  protected createPictureXml(el: PptxImageLikeElement, relationshipId: string): XmlObject;
3359
3371
  protected createMediaGraphicFrameXml(el: MediaPptxElement, relationshipId: string): XmlObject;
@@ -3383,7 +3395,7 @@ interface GroupOwnEmuOverride {
3383
3395
  //#region pptx/core/core/runtime/PptxHandlerRuntimeSaveShapeXml.d.ts
3384
3396
  /** The save context a group child needs to serialise like a top-level shape. */
3385
3397
  type GroupChildSaveContext = SaveSlideContext;
3386
- declare class PptxHandlerRuntime$90 extends PptxHandlerRuntime$91 {
3398
+ declare class PptxHandlerRuntime$92 extends PptxHandlerRuntime$93 {
3387
3399
  /** See `save-shape-xml-frames.ts`'s `buildTableGraphicFrameXml`. */
3388
3400
  protected createTableGraphicFrameXml(el: TablePptxElement): XmlObject;
3389
3401
  /** See `save-shape-xml-frames.ts`'s `buildChartGraphicFrameXml`. */
@@ -3437,7 +3449,7 @@ declare class PptxHandlerRuntime$90 extends PptxHandlerRuntime$91 {
3437
3449
  }
3438
3450
  //#endregion
3439
3451
  //#region pptx/core/core/runtime/PptxHandlerRuntimeSaveImageEffects.d.ts
3440
- declare class PptxHandlerRuntime$89 extends PptxHandlerRuntime$90 {
3452
+ declare class PptxHandlerRuntime$91 extends PptxHandlerRuntime$92 {
3441
3453
  protected clampCropForSave(value: unknown): number;
3442
3454
  /** See {@link buildSrcRectXml} (issue G2: signed crop insets). */
3443
3455
  protected applyImageCropToBlipFill(blipFill: XmlObject | undefined, element: PptxImageLikeElement): void;
@@ -3462,7 +3474,7 @@ declare class PptxHandlerRuntime$89 extends PptxHandlerRuntime$90 {
3462
3474
  }
3463
3475
  //#endregion
3464
3476
  //#region pptx/core/core/runtime/PptxHandlerRuntimeTextStyleUtils.d.ts
3465
- declare class PptxHandlerRuntime$88 extends PptxHandlerRuntime$89 {
3477
+ declare class PptxHandlerRuntime$90 extends PptxHandlerRuntime$91 {
3466
3478
  /**
3467
3479
  * Resolve the automatic per-script fallback face for a run's text from the
3468
3480
  * theme's `<a:font script="...">` overrides (#83). Body (minor) fonts win
@@ -3497,7 +3509,7 @@ declare class PptxHandlerRuntime$88 extends PptxHandlerRuntime$89 {
3497
3509
  }
3498
3510
  //#endregion
3499
3511
  //#region pptx/core/core/runtime/PptxHandlerRuntimeTextRunEffects.d.ts
3500
- declare class PptxHandlerRuntime$87 extends PptxHandlerRuntime$88 {
3512
+ declare class PptxHandlerRuntime$89 extends PptxHandlerRuntime$90 {
3501
3513
  /**
3502
3514
  * Parse hyperlink-related properties (a:hlinkClick, a:hlinkMouseOver) from
3503
3515
  * run-level XML and apply them to the given TextStyle.
@@ -3526,7 +3538,7 @@ declare class PptxHandlerRuntime$87 extends PptxHandlerRuntime$88 {
3526
3538
  }
3527
3539
  //#endregion
3528
3540
  //#region pptx/core/core/runtime/PptxHandlerRuntimeTextRunStyleExtraction.d.ts
3529
- declare class PptxHandlerRuntime$86 extends PptxHandlerRuntime$87 {
3541
+ declare class PptxHandlerRuntime$88 extends PptxHandlerRuntime$89 {
3530
3542
  protected extractTextRunStyle(runProperties: XmlObject | undefined, align: TextStyle['align'], relationshipMap?: Map<string, string>, includeDefaultAlignment?: boolean, slidePath?: string): TextStyle;
3531
3543
  /**
3532
3544
  * Copy `@panose` / `@pitchFamily` / `@charset` from a font child node
@@ -3537,7 +3549,7 @@ declare class PptxHandlerRuntime$86 extends PptxHandlerRuntime$87 {
3537
3549
  }
3538
3550
  //#endregion
3539
3551
  //#region pptx/core/core/runtime/PptxHandlerRuntimeTextEditing.d.ts
3540
- declare class PptxHandlerRuntime$85 extends PptxHandlerRuntime$86 {
3552
+ declare class PptxHandlerRuntime$87 extends PptxHandlerRuntime$88 {
3541
3553
  protected extractTextSegmentsFromTxBodyForRewrite(txBody: XmlObject | undefined, baseStyle: TextStyle | undefined, relationshipMap?: Map<string, string>): TextSegment[];
3542
3554
  protected remapEditedTextToExistingStyles(existingSegments: TextSegment[], nextText: string, fallbackStyle: TextStyle | undefined): TextSegment[];
3543
3555
  }
@@ -3739,7 +3751,7 @@ interface LayoutPlaceholderSlot {
3739
3751
  * reposition the matched ones, keep content the new layout has no slot for,
3740
3752
  * and inject empty placeholders that exist only in the target layout.
3741
3753
  */
3742
- declare class PptxHandlerRuntime$84 extends PptxHandlerRuntime$85 {
3754
+ declare class PptxHandlerRuntime$86 extends PptxHandlerRuntime$87 {
3743
3755
  /**
3744
3756
  * Read placeholder info from a `p:nvPr` XML node.
3745
3757
  *
@@ -3816,7 +3828,7 @@ declare class PptxHandlerRuntime$84 extends PptxHandlerRuntime$85 {
3816
3828
  }
3817
3829
  //#endregion
3818
3830
  //#region pptx/core/core/runtime/PptxHandlerRuntimeSaveTableStyles.d.ts
3819
- declare class PptxHandlerRuntime$83 extends PptxHandlerRuntime$84 {
3831
+ declare class PptxHandlerRuntime$85 extends PptxHandlerRuntime$86 {
3820
3832
  /**
3821
3833
  * Write plain text into a table cell's txBody, preserving
3822
3834
  * existing run properties where possible.
@@ -3831,7 +3843,7 @@ declare class PptxHandlerRuntime$83 extends PptxHandlerRuntime$84 {
3831
3843
  }
3832
3844
  //#endregion
3833
3845
  //#region pptx/core/core/runtime/PptxHandlerRuntimeChartUserShapes.d.ts
3834
- declare class PptxHandlerRuntime$82 extends PptxHandlerRuntime$83 {
3846
+ declare class PptxHandlerRuntime$84 extends PptxHandlerRuntime$85 {
3835
3847
  /**
3836
3848
  * Reconcile a chart's `c:userShapes` reference and drawing part against
3837
3849
  * the current `chartData.userShapes` typed model, writing a new or
@@ -3867,7 +3879,7 @@ declare class PptxHandlerRuntime$82 extends PptxHandlerRuntime$83 {
3867
3879
  }
3868
3880
  //#endregion
3869
3881
  //#region pptx/core/core/runtime/PptxHandlerRuntimeSaveDataSerialization.d.ts
3870
- declare class PptxHandlerRuntime$81 extends PptxHandlerRuntime$82 {
3882
+ declare class PptxHandlerRuntime$83 extends PptxHandlerRuntime$84 {
3871
3883
  /**
3872
3884
  * Serialise modified `PptxTableData` back into the graphic frame's
3873
3885
  * raw XML so that the round-tripped file preserves edits.
@@ -3990,7 +4002,7 @@ declare class PptxHandlerRuntime$81 extends PptxHandlerRuntime$82 {
3990
4002
  }
3991
4003
  //#endregion
3992
4004
  //#region pptx/core/core/runtime/PptxHandlerRuntimeSaveDocumentParts.d.ts
3993
- declare class PptxHandlerRuntime$80 extends PptxHandlerRuntime$81 {
4005
+ declare class PptxHandlerRuntime$82 extends PptxHandlerRuntime$83 {
3994
4006
  /** Pending SmartArt data updates to process during save. */
3995
4007
  protected pendingSmartArtUpdates?: Array<{
3996
4008
  element: SmartArtPptxElement;
@@ -4113,7 +4125,7 @@ declare class PptxHandlerRuntime$80 extends PptxHandlerRuntime$81 {
4113
4125
  }
4114
4126
  //#endregion
4115
4127
  //#region pptx/core/core/runtime/PptxHandlerRuntimeSavePresPropsAndSignatures.d.ts
4116
- declare class PptxHandlerRuntime$79 extends PptxHandlerRuntime$80 {
4128
+ declare class PptxHandlerRuntime$81 extends PptxHandlerRuntime$82 {
4117
4129
  protected applyPresentationPropertiesPart(properties: PptxPresentationProperties | undefined): Promise<void>;
4118
4130
  /**
4119
4131
  * Strip digital signature parts from the ZIP if the document was signed.
@@ -4123,7 +4135,7 @@ declare class PptxHandlerRuntime$79 extends PptxHandlerRuntime$80 {
4123
4135
  }
4124
4136
  //#endregion
4125
4137
  //#region pptx/core/core/runtime/PptxHandlerRuntimeSaveMediaTimingWrite.d.ts
4126
- declare class PptxHandlerRuntime$78 extends PptxHandlerRuntime$79 {
4138
+ declare class PptxHandlerRuntime$80 extends PptxHandlerRuntime$81 {
4127
4139
  protected collectMediaElements(elements: PptxElement[], output: MediaPptxElement[]): void;
4128
4140
  protected getShapeIdFromRawXml(rawXml: XmlObject | undefined): string | undefined;
4129
4141
  protected applyMediaTimingToTimingTree(node: XmlObject, mediaByShapeId: Map<string, MediaPptxElement>): void;
@@ -4150,7 +4162,7 @@ declare class PptxHandlerRuntime$78 extends PptxHandlerRuntime$79 {
4150
4162
  }
4151
4163
  //#endregion
4152
4164
  //#region pptx/core/core/runtime/PptxHandlerRuntimeSaveXmlHelpers.d.ts
4153
- declare class PptxHandlerRuntime$77 extends PptxHandlerRuntime$78 {
4165
+ declare class PptxHandlerRuntime$79 extends PptxHandlerRuntime$80 {
4154
4166
  /**
4155
4167
  * Recursively walk an XML object tree and deduplicate extension list entries
4156
4168
  * by `@_uri`. When multiple `a:ext` or `p:ext` entries share the same URI,
@@ -4173,7 +4185,7 @@ declare class PptxHandlerRuntime$77 extends PptxHandlerRuntime$78 {
4173
4185
  }
4174
4186
  //#endregion
4175
4187
  //#region pptx/core/core/runtime/PptxHandlerRuntimeSaveShapeStyleWriter.d.ts
4176
- declare class PptxHandlerRuntime$76 extends PptxHandlerRuntime$77 {
4188
+ declare class PptxHandlerRuntime$78 extends PptxHandlerRuntime$79 {
4177
4189
  /**
4178
4190
  * Serialize shape fill, stroke, dash, arrows, line join/cap/compound,
4179
4191
  * and line-level effects to the given spPr XML object.
@@ -4212,7 +4224,7 @@ declare class PptxHandlerRuntime$76 extends PptxHandlerRuntime$77 {
4212
4224
  }
4213
4225
  //#endregion
4214
4226
  //#region pptx/core/core/runtime/PptxHandlerRuntimeSaveEffectsWriter.d.ts
4215
- declare class PptxHandlerRuntime$75 extends PptxHandlerRuntime$76 {
4227
+ declare class PptxHandlerRuntime$77 extends PptxHandlerRuntime$78 {
4216
4228
  /**
4217
4229
  * Serialize visual effects (shadow, glow, reflection, blur, soft edge),
4218
4230
  * effectDag, 3D scene, and 3D shape properties to the given spPr XML object.
@@ -4227,7 +4239,7 @@ declare class PptxHandlerRuntime$75 extends PptxHandlerRuntime$76 {
4227
4239
  }
4228
4240
  //#endregion
4229
4241
  //#region pptx/core/core/runtime/PptxHandlerRuntimeSaveTextWriter.d.ts
4230
- declare class PptxHandlerRuntime$74 extends PptxHandlerRuntime$75 {
4242
+ declare class PptxHandlerRuntime$76 extends PptxHandlerRuntime$77 {
4231
4243
  /**
4232
4244
  * Build and write the text body (`p:txBody`) for shapes, text boxes,
4233
4245
  * and connectors that carry text content.
@@ -4262,6 +4274,8 @@ interface SaveSlideContext {
4262
4274
  readonly slideRelationshipRegistry: IPptxSlideRelationshipRegistry;
4263
4275
  readonly resolveHyperlinkRelationshipId: (target: string, forceExternal?: boolean) => string | undefined;
4264
4276
  readonly getSlideRelationshipMap: () => Map<string, string>;
4277
+ /** The `Target`, from this part, of the deck's slide at `index`; slides only (a slide jump). */
4278
+ readonly slideTargetAt?: ((index: number) => string | undefined) | undefined;
4265
4279
  readonly resolvedMediaBytes: Map<string, {
4266
4280
  bytes: Uint8Array;
4267
4281
  extension: string;
@@ -4299,7 +4313,7 @@ interface SaveSlideContext {
4299
4313
  */
4300
4314
  readonly preserveGroupChildSpace?: GroupChildSpaceOwner;
4301
4315
  }
4302
- declare class PptxHandlerRuntime$73 extends PptxHandlerRuntime$74 {
4316
+ declare class PptxHandlerRuntime$75 extends PptxHandlerRuntime$76 {
4303
4317
  /** Serialize table, chart, and SmartArt data when applicable. */
4304
4318
  protected applyDataSerialization(shape: XmlObject, el: PptxElement, slideId: string): void;
4305
4319
  /** Apply image crop, effects, and alt text for picture/image elements. */
@@ -4313,7 +4327,7 @@ declare class PptxHandlerRuntime$73 extends PptxHandlerRuntime$74 {
4313
4327
  }
4314
4328
  //#endregion
4315
4329
  //#region pptx/core/core/runtime/PptxHandlerRuntimeSaveSmartArtFabrication.d.ts
4316
- declare class PptxHandlerRuntime$72 extends PptxHandlerRuntime$73 {
4330
+ declare class PptxHandlerRuntime$74 extends PptxHandlerRuntime$75 {
4317
4331
  /** Content-type overrides queued for diagram parts fabricated this save. */
4318
4332
  protected pendingDiagramContentTypes?: Array<{
4319
4333
  partName: string;
@@ -4352,7 +4366,7 @@ interface PendingOleContentUpdate {
4352
4366
  * fresh by `createOleElementWithPayload` (`PptxHandlerRuntimeSaveOleEmbedding.ts`),
4353
4367
  * which already embeds whatever `oleEmbeddedData` holds at save time.
4354
4368
  */
4355
- declare class PptxHandlerRuntime$71 extends PptxHandlerRuntime$72 {
4369
+ declare class PptxHandlerRuntime$73 extends PptxHandlerRuntime$74 {
4356
4370
  protected pendingOleContentUpdates?: PendingOleContentUpdate[];
4357
4371
  private nextOlePreviewImageIndex?;
4358
4372
  private nextOlePreviewImagePath;
@@ -4370,7 +4384,7 @@ declare class PptxHandlerRuntime$71 extends PptxHandlerRuntime$72 {
4370
4384
  }
4371
4385
  //#endregion
4372
4386
  //#region pptx/core/core/runtime/PptxHandlerRuntimeSaveOleEmbedding.d.ts
4373
- declare class PptxHandlerRuntime$70 extends PptxHandlerRuntime$71 {
4387
+ declare class PptxHandlerRuntime$72 extends PptxHandlerRuntime$73 {
4374
4388
  private pendingOleContentTypes?;
4375
4389
  private nextOleEmbeddingPath;
4376
4390
  /** Write an SDK-authored OLE payload and return its graphic-frame envelope. */
@@ -4380,7 +4394,7 @@ declare class PptxHandlerRuntime$70 extends PptxHandlerRuntime$71 {
4380
4394
  }
4381
4395
  //#endregion
4382
4396
  //#region pptx/core/core/runtime/PptxHandlerRuntimeSaveZoom.d.ts
4383
- declare class PptxHandlerRuntime$69 extends PptxHandlerRuntime$70 {
4397
+ declare class PptxHandlerRuntime$71 extends PptxHandlerRuntime$72 {
4384
4398
  protected readonly newZoomFallbackByXml: Map<XmlObject, XmlObject>;
4385
4399
  /** Update an existing slide Zoom or build a new Office 2016 Zoom node. */
4386
4400
  protected createOrUpdateSlideZoomXml(el: ZoomPptxElement, shape: XmlObject | undefined, ctx: SaveSlideContext): XmlObject | undefined;
@@ -4399,7 +4413,7 @@ declare class PptxHandlerRuntime$69 extends PptxHandlerRuntime$70 {
4399
4413
  }
4400
4414
  //#endregion
4401
4415
  //#region pptx/core/core/runtime/PptxHandlerRuntimeSaveSectionZoom.d.ts
4402
- declare class PptxHandlerRuntime$68 extends PptxHandlerRuntime$69 {
4416
+ declare class PptxHandlerRuntime$70 extends PptxHandlerRuntime$71 {
4403
4417
  /** Dispatch typed Zoom elements to their distinct slide/section envelopes. */
4404
4418
  protected createOrUpdateZoomXml(el: ZoomPptxElement, shape: XmlObject | undefined, ctx: SaveSlideContext): XmlObject | undefined;
4405
4419
  private createOrUpdateSectionZoomXml;
@@ -4407,7 +4421,7 @@ declare class PptxHandlerRuntime$68 extends PptxHandlerRuntime$69 {
4407
4421
  }
4408
4422
  //#endregion
4409
4423
  //#region pptx/core/core/runtime/PptxHandlerRuntimeSaveSummaryZoom.d.ts
4410
- declare class PptxHandlerRuntime$67 extends PptxHandlerRuntime$68 {
4424
+ declare class PptxHandlerRuntime$69 extends PptxHandlerRuntime$70 {
4411
4425
  /** Dispatch Summary Zoom containers without conflating them with Section Zoom tiles. */
4412
4426
  protected createOrUpdateZoomXml(el: ZoomPptxElement, shape: XmlObject | undefined, ctx: SaveSlideContext): XmlObject | undefined;
4413
4427
  private createOrUpdateSummaryZoomXml;
@@ -4421,7 +4435,7 @@ declare class PptxHandlerRuntime$67 extends PptxHandlerRuntime$68 {
4421
4435
  }
4422
4436
  //#endregion
4423
4437
  //#region pptx/core/core/runtime/PptxHandlerRuntimeSaveModel3D.d.ts
4424
- declare class PptxHandlerRuntime$66 extends PptxHandlerRuntime$67 {
4438
+ declare class PptxHandlerRuntime$68 extends PptxHandlerRuntime$69 {
4425
4439
  private readonly newModel3DFallbackByXml;
4426
4440
  /** Create or update an embedded GLB model, its poster, and package relationships. */
4427
4441
  protected createOrUpdateModel3DXml(el: Model3DPptxElement, shape: XmlObject | undefined, ctx: SaveSlideContext): XmlObject | undefined;
@@ -4436,7 +4450,7 @@ declare class PptxHandlerRuntime$66 extends PptxHandlerRuntime$67 {
4436
4450
  }
4437
4451
  //#endregion
4438
4452
  //#region pptx/core/core/runtime/PptxHandlerRuntimeSaveContentPartInk.d.ts
4439
- declare class PptxHandlerRuntime$65 extends PptxHandlerRuntime$66 {
4453
+ declare class PptxHandlerRuntime$67 extends PptxHandlerRuntime$68 {
4440
4454
  private readonly newContentPartFallbackByXml;
4441
4455
  /**
4442
4456
  * Convert a Draw-tab pen/highlighter element (no `rawXml`) into the
@@ -4480,7 +4494,7 @@ interface SlideShapeCollectors {
4480
4494
  readonly contentParts: XmlObject[];
4481
4495
  readonly zooms: XmlObject[];
4482
4496
  }
4483
- declare class PptxHandlerRuntime$64 extends PptxHandlerRuntime$65 {
4497
+ declare class PptxHandlerRuntime$66 extends PptxHandlerRuntime$67 {
4484
4498
  private static readonly CHART_COLOR_CONTENT_TYPE;
4485
4499
  private static readonly CHART_COLOR_REL_TYPE;
4486
4500
  private static readonly CHART_EX_CONTENT_TYPE;
@@ -4631,7 +4645,7 @@ declare class PptxHandlerRuntime$64 extends PptxHandlerRuntime$65 {
4631
4645
  }
4632
4646
  //#endregion
4633
4647
  //#region pptx/core/core/runtime/PptxHandlerRuntimeSaveSlideWriter.d.ts
4634
- declare class PptxHandlerRuntime$63 extends PptxHandlerRuntime$64 {
4648
+ declare class PptxHandlerRuntime$65 extends PptxHandlerRuntime$66 {
4635
4649
  protected resolveModernCommentAuthorId(comment: PptxComment): string;
4636
4650
  protected nextModernCommentPartPath(): string;
4637
4651
  private createModernCommentAuthorId;
@@ -4685,7 +4699,7 @@ declare class PptxHandlerRuntime$63 extends PptxHandlerRuntime$64 {
4685
4699
  * Process a single slide during save: update slide XML, process elements,
4686
4700
  * rebuild shape tree, and persist relationships.
4687
4701
  */
4688
- protected processSlideForSave(slide: PptxSlide, saveSession: PptxSaveState, constants: PptxSaveConstants): Promise<void>;
4702
+ protected processSlideForSave(slide: PptxSlide, saveSession: PptxSaveState, constants: PptxSaveConstants, slidePaths?: readonly string[]): Promise<void>;
4689
4703
  /**
4690
4704
  * Largest `p:cNvPr/@id` already present anywhere in a shape tree, including
4691
4705
  * the implicit `<p:spTree>` group's own reserved id. Used to seed minting of
@@ -4721,7 +4735,7 @@ declare class PptxHandlerRuntime$63 extends PptxHandlerRuntime$64 {
4721
4735
  * save pipeline to regenerate the theme part instead of re-emitting the
4722
4736
  * original XML.
4723
4737
  */
4724
- declare class PptxHandlerRuntime$62 extends PptxHandlerRuntime$63 {
4738
+ declare class PptxHandlerRuntime$64 extends PptxHandlerRuntime$65 {
4725
4739
  /**
4726
4740
  * Mark a theme path as dirty so the save pipeline will regenerate
4727
4741
  * the theme XML from in-memory state. Optional — without this the
@@ -4793,7 +4807,7 @@ declare class PptxHandlerRuntime$62 extends PptxHandlerRuntime$63 {
4793
4807
  }
4794
4808
  //#endregion
4795
4809
  //#region pptx/core/core/runtime/PptxHandlerRuntimeSaveSlideMaster.d.ts
4796
- declare class PptxHandlerRuntime$61 extends PptxHandlerRuntime$62 {
4810
+ declare class PptxHandlerRuntime$63 extends PptxHandlerRuntime$64 {
4797
4811
  /**
4798
4812
  * Apply typed mutations from the supplied {@link PptxSlideMaster} array
4799
4813
  * to each master's cached XmlObject. Called by the save pipeline before
@@ -4804,7 +4818,7 @@ declare class PptxHandlerRuntime$61 extends PptxHandlerRuntime$62 {
4804
4818
  }
4805
4819
  //#endregion
4806
4820
  //#region pptx/core/core/runtime/PptxHandlerRuntimeSaveSlideLayout.d.ts
4807
- declare class PptxHandlerRuntime$60 extends PptxHandlerRuntime$61 {
4821
+ declare class PptxHandlerRuntime$62 extends PptxHandlerRuntime$63 {
4808
4822
  /**
4809
4823
  * Apply typed mutations from the supplied {@link PptxSlideLayout} array
4810
4824
  * to each layout's cached XmlObject. Called by the save pipeline before
@@ -4828,7 +4842,7 @@ declare class PptxHandlerRuntime$60 extends PptxHandlerRuntime$61 {
4828
4842
  }
4829
4843
  //#endregion
4830
4844
  //#region pptx/core/core/runtime/PptxHandlerRuntimeSaveMasterElements.d.ts
4831
- declare class PptxHandlerRuntime$59 extends PptxHandlerRuntime$60 {
4845
+ declare class PptxHandlerRuntime$61 extends PptxHandlerRuntime$62 {
4832
4846
  /**
4833
4847
  * Persist Slide Master view edits to every master and layout the caller
4834
4848
  * handed back, then let the pipeline's passthrough flush emit them.
@@ -4868,7 +4882,7 @@ declare class PptxHandlerRuntime$59 extends PptxHandlerRuntime$60 {
4868
4882
  }
4869
4883
  //#endregion
4870
4884
  //#region pptx/core/core/runtime/PptxHandlerRuntimeSaveNotesMaster.d.ts
4871
- declare class PptxHandlerRuntime$58 extends PptxHandlerRuntime$59 {
4885
+ declare class PptxHandlerRuntime$60 extends PptxHandlerRuntime$61 {
4872
4886
  /**
4873
4887
  * Apply clrMap and headerFooter mutations to the notes master XML.
4874
4888
  * Background-colour mutations are still handled by the pre-existing
@@ -4880,7 +4894,7 @@ declare class PptxHandlerRuntime$58 extends PptxHandlerRuntime$59 {
4880
4894
  }
4881
4895
  //#endregion
4882
4896
  //#region pptx/core/core/runtime/PptxHandlerRuntimeSaveHandoutMaster.d.ts
4883
- declare class PptxHandlerRuntime$57 extends PptxHandlerRuntime$58 {
4897
+ declare class PptxHandlerRuntime$59 extends PptxHandlerRuntime$60 {
4884
4898
  /**
4885
4899
  * Apply clrMap and headerFooter mutations to the handout master XML.
4886
4900
  */
@@ -4888,7 +4902,7 @@ declare class PptxHandlerRuntime$57 extends PptxHandlerRuntime$58 {
4888
4902
  }
4889
4903
  //#endregion
4890
4904
  //#region pptx/core/core/runtime/PptxHandlerRuntimeSaveViewProperties.d.ts
4891
- declare class PptxHandlerRuntime$56 extends PptxHandlerRuntime$57 {
4905
+ declare class PptxHandlerRuntime$58 extends PptxHandlerRuntime$59 {
4892
4906
  /**
4893
4907
  * Re-emit `ppt/viewProps.xml` from the typed view properties. Walks
4894
4908
  * `presentation.xml.rels` to find the viewProps target so non-default
@@ -4918,7 +4932,7 @@ declare class PptxHandlerRuntime$56 extends PptxHandlerRuntime$57 {
4918
4932
  }
4919
4933
  //#endregion
4920
4934
  //#region pptx/core/core/runtime/PptxHandlerRuntimeSaveNotesInfrastructure.d.ts
4921
- declare class PptxHandlerRuntime$55 extends PptxHandlerRuntime$56 {
4935
+ declare class PptxHandlerRuntime$57 extends PptxHandlerRuntime$58 {
4922
4936
  /** Ensure authored notes have the global notes-master OPC infrastructure. */
4923
4937
  protected ensureNotesMasterForAuthoredNotes(slides: readonly PptxSlide[], constants: PptxSaveConstants): Promise<void>;
4924
4938
  private buildDefaultNotesMaster;
@@ -4926,7 +4940,7 @@ declare class PptxHandlerRuntime$55 extends PptxHandlerRuntime$56 {
4926
4940
  }
4927
4941
  //#endregion
4928
4942
  //#region pptx/core/core/runtime/PptxHandlerRuntimeSaveHandoutInfrastructure.d.ts
4929
- declare class PptxHandlerRuntime$54 extends PptxHandlerRuntime$55 {
4943
+ declare class PptxHandlerRuntime$56 extends PptxHandlerRuntime$57 {
4930
4944
  /** Ensure an authored handout master has complete OPC package infrastructure. */
4931
4945
  protected ensureHandoutMasterInfrastructure(handoutMaster: PptxHandoutMaster | undefined, constants: PptxSaveConstants): Promise<void>;
4932
4946
  private ensureHandoutThemeRelationship;
@@ -4951,7 +4965,7 @@ type LegacyPptxSerializer = () => Promise<Uint8Array>;
4951
4965
  * to resolve `media`-`audio` elements loaded from a real `.pptx` (see
4952
4966
  * `resolveAudioMediaBytes`'s doc).
4953
4967
  */
4954
- declare class PptxHandlerRuntime$53 extends PptxHandlerRuntime$54 {
4968
+ declare class PptxHandlerRuntime$55 extends PptxHandlerRuntime$56 {
4955
4969
  /**
4956
4970
  * A `media`-`audio` element loaded from a real `.pptx` carries only
4957
4971
  * `mediaPath` (a lazy reference into `this.zip`), never `mediaData`
@@ -5011,7 +5025,7 @@ declare class PptxHandlerRuntime$53 extends PptxHandlerRuntime$54 {
5011
5025
  * back out with it on every save. See `save-structural-id-gate.ts` for the
5012
5026
  * decision helpers.
5013
5027
  */
5014
- declare class PptxHandlerRuntime$52 extends PptxHandlerRuntime$53 {
5028
+ declare class PptxHandlerRuntime$54 extends PptxHandlerRuntime$55 {
5015
5029
  protected repairStructuralIdsBeforeExport(slides: PptxSlide[]): Promise<void>;
5016
5030
  /** The loader's cached parse of a part, which the live model's `rawXml` nodes belong to. */
5017
5031
  private cachedStructuralPart;
@@ -5020,7 +5034,7 @@ declare class PptxHandlerRuntime$52 extends PptxHandlerRuntime$53 {
5020
5034
  }
5021
5035
  //#endregion
5022
5036
  //#region pptx/core/core/runtime/PptxHandlerRuntimeSavePipeline.d.ts
5023
- declare class PptxHandlerRuntime$51 extends PptxHandlerRuntime$52 {
5037
+ declare class PptxHandlerRuntime$53 extends PptxHandlerRuntime$54 {
5024
5038
  /**
5025
5039
  * Resolve the effective conformance class for this save operation.
5026
5040
  *
@@ -5028,7 +5042,19 @@ declare class PptxHandlerRuntime$51 extends PptxHandlerRuntime$52 {
5028
5042
  * - `'strict'` / `'transitional'`: force that conformance class
5029
5043
  */
5030
5044
  private resolveEffectiveConformance;
5045
+ /** The save running now, or the last one: see {@link save}. */
5046
+ private saveQueue;
5047
+ /**
5048
+ * Saves run one at a time. A save rewrites `this.zip` in place across many awaits and moves
5049
+ * per-part baselines (slide fingerprints, chart data, pending chart updates) while it runs, so
5050
+ * a second save that starts mid-way (a viewer's autosave snapshot firing during the user's own
5051
+ * save) read half-written state: it skipped the slide as unchanged and wrote the chart part's
5052
+ * original XML back over the edit, in both outputs. Each save now waits for the one before it;
5053
+ * one that fails does not hold up the next.
5054
+ */
5031
5055
  save(slides: PptxSlide[], options?: PptxHandlerSaveOptions): Promise<Uint8Array>;
5056
+ /** One save, with the package to itself; callers go through {@link save}. */
5057
+ private saveNow;
5032
5058
  /**
5033
5059
  * Apply the Header & Footer dialog's state to every slide master.
5034
5060
  *
@@ -5053,7 +5079,7 @@ declare class PptxHandlerRuntime$51 extends PptxHandlerRuntime$52 {
5053
5079
  }
5054
5080
  //#endregion
5055
5081
  //#region pptx/core/core/runtime/PptxHandlerRuntimeElementParsing.d.ts
5056
- declare class PptxHandlerRuntime$50 extends PptxHandlerRuntime$51 {
5082
+ declare class PptxHandlerRuntime$52 extends PptxHandlerRuntime$53 {
5057
5083
  /**
5058
5084
  * Parse media data (video/audio path and MIME type) from graphic frame data.
5059
5085
  */
@@ -5114,7 +5140,7 @@ declare class PptxHandlerRuntime$50 extends PptxHandlerRuntime$51 {
5114
5140
  }
5115
5141
  //#endregion
5116
5142
  //#region pptx/core/core/runtime/PptxHandlerRuntimeZoomParsing.d.ts
5117
- declare class PptxHandlerRuntime$49 extends PptxHandlerRuntime$50 {
5143
+ declare class PptxHandlerRuntime$51 extends PptxHandlerRuntime$52 {
5118
5144
  /** Parse an Office 2016 `pslz:sldZm` slide Zoom object. */
5119
5145
  protected parseSlideZoomElement(zoom: XmlObject, id: string, slidePath: string): Promise<PptxElement | null>;
5120
5146
  protected findSlideIndexByNumericId(value: unknown): number;
@@ -5129,13 +5155,13 @@ declare class PptxHandlerRuntime$49 extends PptxHandlerRuntime$50 {
5129
5155
  }
5130
5156
  //#endregion
5131
5157
  //#region pptx/core/core/runtime/PptxHandlerRuntimeSectionZoomParsing.d.ts
5132
- declare class PptxHandlerRuntime$48 extends PptxHandlerRuntime$49 {
5158
+ declare class PptxHandlerRuntime$50 extends PptxHandlerRuntime$51 {
5133
5159
  /** Parse an Office 2016 `psezm:sectionZm` section Zoom object. */
5134
5160
  protected parseSectionZoomElement(zoom: XmlObject, id: string, slidePath: string): Promise<PptxElement | null>;
5135
5161
  }
5136
5162
  //#endregion
5137
5163
  //#region pptx/core/core/runtime/PptxHandlerRuntimeSummaryZoomParsing.d.ts
5138
- declare class PptxHandlerRuntime$47 extends PptxHandlerRuntime$48 {
5164
+ declare class PptxHandlerRuntime$49 extends PptxHandlerRuntime$50 {
5139
5165
  /** Parse an Office 2016 Summary Zoom container and all section tiles. */
5140
5166
  protected parseSummaryZoomElement(zoom: XmlObject, id: string, slidePath: string): Promise<PptxElement | null>;
5141
5167
  private parseSummaryZoomPreview;
@@ -5152,7 +5178,7 @@ interface PlaceholderNodeContext extends PlaceholderLookupContext {
5152
5178
  /** The inherited graphic frame XML object from the layout/master, if any. */
5153
5179
  graphicFrame?: XmlObject;
5154
5180
  }
5155
- declare class PptxHandlerRuntime$46 extends PptxHandlerRuntime$47 {
5181
+ declare class PptxHandlerRuntime$48 extends PptxHandlerRuntime$49 {
5156
5182
  protected findPlaceholderInShapeTree(spTree: XmlObject | undefined, expected: PlaceholderInfo | null): PlaceholderNodeContext | undefined;
5157
5183
  private scanPlaceholderBuckets;
5158
5184
  /**
@@ -5208,7 +5234,7 @@ declare class PptxHandlerRuntime$46 extends PptxHandlerRuntime$47 {
5208
5234
  }
5209
5235
  //#endregion
5210
5236
  //#region pptx/core/core/runtime/PptxHandlerRuntimeGeometryParsing.d.ts
5211
- declare class PptxHandlerRuntime$45 extends PptxHandlerRuntime$46 {
5237
+ declare class PptxHandlerRuntime$47 extends PptxHandlerRuntime$48 {
5212
5238
  protected parseGeometryAdjustments(prstGeom: XmlObject | undefined): Record<string, number> | undefined;
5213
5239
  /**
5214
5240
  * Parse adjustment handles from `a:ahLst` in a geometry definition.
@@ -5285,7 +5311,7 @@ declare class PptxHandlerRuntime$45 extends PptxHandlerRuntime$46 {
5285
5311
  }
5286
5312
  //#endregion
5287
5313
  //#region pptx/core/core/runtime/PptxHandlerRuntimeShapeImageFill.d.ts
5288
- declare class PptxHandlerRuntime$44 extends PptxHandlerRuntime$45 {
5314
+ declare class PptxHandlerRuntime$46 extends PptxHandlerRuntime$47 {
5289
5315
  /**
5290
5316
  * Parse a shape that has an image fill (a:blipFill inside spPr)
5291
5317
  * This handles shapes like rectangles filled with images (e.g., wood texture backgrounds)
@@ -5304,7 +5330,7 @@ declare class PptxHandlerRuntime$44 extends PptxHandlerRuntime$45 {
5304
5330
  }
5305
5331
  //#endregion
5306
5332
  //#region pptx/core/core/runtime/PptxHandlerRuntimeTextDefaults.d.ts
5307
- declare class PptxHandlerRuntime$43 extends PptxHandlerRuntime$44 {
5333
+ declare class PptxHandlerRuntime$45 extends PptxHandlerRuntime$46 {
5308
5334
  /**
5309
5335
  * Apply {@link PlaceholderDefaults} body-level properties to a
5310
5336
  * {@link TextStyle} as fallback values (only sets fields that are
@@ -5341,7 +5367,7 @@ declare class PptxHandlerRuntime$43 extends PptxHandlerRuntime$44 {
5341
5367
  //#endregion
5342
5368
  //#region pptx/core/core/runtime/PptxHandlerRuntimeBulletParsing.d.ts
5343
5369
  type LevelStyleMap = Record<number, PlaceholderTextLevelStyle>;
5344
- declare class PptxHandlerRuntime$42 extends PptxHandlerRuntime$43 {
5370
+ declare class PptxHandlerRuntime$44 extends PptxHandlerRuntime$45 {
5345
5371
  protected resolveParagraphBulletInfo(paragraph: XmlObject | undefined, paragraphIndex: number, txBody: XmlObject | undefined, inheritedTxBody: XmlObject | undefined, isBodyPlaceholder?: boolean, slidePath?: string, effectiveLevelStyles?: LevelStyleMap): BulletInfo | null;
5346
5372
  protected createBulletInfoFromLevelStyle(levelStyle: PlaceholderTextLevelStyle | undefined, paragraphIndex: number): BulletInfo | null;
5347
5373
  /**
@@ -5364,7 +5390,7 @@ declare class PptxHandlerRuntime$42 extends PptxHandlerRuntime$43 {
5364
5390
  }
5365
5391
  //#endregion
5366
5392
  //#region pptx/core/core/runtime/PptxHandlerRuntimeShapeBodyParsing.d.ts
5367
- declare class PptxHandlerRuntime$41 extends PptxHandlerRuntime$42 {
5393
+ declare class PptxHandlerRuntime$43 extends PptxHandlerRuntime$44 {
5368
5394
  /**
5369
5395
  * Parse `a:spLocks` attributes into a structured {@link PptxShapeLocks} object.
5370
5396
  * Returns `undefined` when the node is absent or contains no lock attributes.
@@ -5391,7 +5417,7 @@ declare class PptxHandlerRuntime$41 extends PptxHandlerRuntime$42 {
5391
5417
  }
5392
5418
  //#endregion
5393
5419
  //#region pptx/core/core/runtime/PptxHandlerRuntimeShapeTextParsing.d.ts
5394
- declare class PptxHandlerRuntime$40 extends PptxHandlerRuntime$41 {
5420
+ declare class PptxHandlerRuntime$42 extends PptxHandlerRuntime$43 {
5395
5421
  /**
5396
5422
  * A copy of an `a:lstStyle` level entry without its `a:defRPr`: run
5397
5423
  * defaults follow their own precedence chain, so only the paragraph-level
@@ -5430,7 +5456,7 @@ declare class PptxHandlerRuntime$40 extends PptxHandlerRuntime$41 {
5430
5456
  }
5431
5457
  //#endregion
5432
5458
  //#region pptx/core/core/runtime/PptxHandlerRuntimeShapeParagraphContentParsing.d.ts
5433
- declare class PptxHandlerRuntime$39 extends PptxHandlerRuntime$40 {
5459
+ declare class PptxHandlerRuntime$41 extends PptxHandlerRuntime$42 {
5434
5460
  /**
5435
5461
  * Collect text content (runs, fields, equations, bullets) for a single
5436
5462
  * paragraph and return text parts + segments. The returned `seedStyle`
@@ -5449,17 +5475,17 @@ declare class PptxHandlerRuntime$39 extends PptxHandlerRuntime$40 {
5449
5475
  }
5450
5476
  //#endregion
5451
5477
  //#region pptx/core/core/runtime/PptxHandlerRuntimeShapeParsing.d.ts
5452
- declare class PptxHandlerRuntime$38 extends PptxHandlerRuntime$39 {
5478
+ declare class PptxHandlerRuntime$40 extends PptxHandlerRuntime$41 {
5453
5479
  protected parseShape(shape: XmlObject, id: string, slidePath?: string, layoutPath?: string): PptxElement | null;
5454
5480
  }
5455
5481
  //#endregion
5456
5482
  //#region pptx/core/core/runtime/PptxHandlerRuntimePictureParsing.d.ts
5457
- declare class PptxHandlerRuntime$37 extends PptxHandlerRuntime$38 {
5483
+ declare class PptxHandlerRuntime$39 extends PptxHandlerRuntime$40 {
5458
5484
  protected parsePicture(pic: XmlObject, id: string, slidePath: string): Promise<PptxElement | null>;
5459
5485
  }
5460
5486
  //#endregion
5461
5487
  //#region pptx/core/core/runtime/PptxHandlerRuntimeSpTreeParsing.d.ts
5462
- declare class PptxHandlerRuntime$36 extends PptxHandlerRuntime$37 {
5488
+ declare class PptxHandlerRuntime$38 extends PptxHandlerRuntime$39 {
5463
5489
  /**
5464
5490
  * Known element tag names that appear as direct children of `p:spTree`
5465
5491
  * (or `p:grpSp`) and represent renderable shapes/objects.
@@ -5537,7 +5563,7 @@ declare class PptxHandlerRuntime$36 extends PptxHandlerRuntime$37 {
5537
5563
  }
5538
5564
  //#endregion
5539
5565
  //#region pptx/core/core/runtime/PptxHandlerRuntimeGroupParsing.d.ts
5540
- declare class PptxHandlerRuntime$35 extends PptxHandlerRuntime$36 {
5566
+ declare class PptxHandlerRuntime$37 extends PptxHandlerRuntime$38 {
5541
5567
  /**
5542
5568
  * Parse the children of a `<p:grpSp>` into the group's own pixel space.
5543
5569
  *
@@ -5562,7 +5588,7 @@ declare class PptxHandlerRuntime$35 extends PptxHandlerRuntime$36 {
5562
5588
  }
5563
5589
  //#endregion
5564
5590
  //#region pptx/core/core/runtime/PptxHandlerRuntimeSlideParsing.d.ts
5565
- declare class PptxHandlerRuntime$34 extends PptxHandlerRuntime$35 {
5591
+ declare class PptxHandlerRuntime$36 extends PptxHandlerRuntime$37 {
5566
5592
  /**
5567
5593
  * Parse text body from a connector shape (p:cxnSp > p:txBody).
5568
5594
  * Uses the same text run extraction logic as regular shapes but
@@ -5573,7 +5599,7 @@ declare class PptxHandlerRuntime$34 extends PptxHandlerRuntime$35 {
5573
5599
  }
5574
5600
  //#endregion
5575
5601
  //#region pptx/core/core/runtime/PptxHandlerRuntimeColorAndEffects.d.ts
5576
- declare class PptxHandlerRuntime$33 extends PptxHandlerRuntime$34 {
5602
+ declare class PptxHandlerRuntime$35 extends PptxHandlerRuntime$36 {
5577
5603
  /**
5578
5604
  * Forward declaration – implemented in PptxHandlerRuntimeThemeProcessing.
5579
5605
  * Re-resolves gradient stops by substituting `phClr` with the given colour.
@@ -5609,7 +5635,7 @@ declare class PptxHandlerRuntime$33 extends PptxHandlerRuntime$34 {
5609
5635
  }
5610
5636
  //#endregion
5611
5637
  //#region pptx/core/core/runtime/PptxHandlerRuntimeBackgroundParsing.d.ts
5612
- declare class PptxHandlerRuntime$32 extends PptxHandlerRuntime$33 {
5638
+ declare class PptxHandlerRuntime$34 extends PptxHandlerRuntime$35 {
5613
5639
  /**
5614
5640
  * Preserve the visual properties authored on a background `a:blipFill`.
5615
5641
  *
@@ -5620,6 +5646,14 @@ declare class PptxHandlerRuntime$32 extends PptxHandlerRuntime$33 {
5620
5646
  protected extractBackgroundImageProperties(slideXml: XmlObject, rootElement?: string): PptxImageProperties | undefined;
5621
5647
  protected extractBackgroundImage(slideXml: XmlObject, slidePath: string, rootElement?: string): Promise<string | undefined>;
5622
5648
  protected extractBackgroundColor(slideXml: XmlObject, rootElement?: string): string | undefined;
5649
+ /**
5650
+ * The colour a slide master or layout paints from its own `p:bg`, resolved exactly as a
5651
+ * slide's background is: through the active master's colour map and format scheme, with
5652
+ * `clrMapOverride` (a layout's `p:clrMapOvr`, or `null`) taking precedence. The caller makes
5653
+ * the part's master active first; a master's `bgRef` on `bg1` means `dk1` under a dark
5654
+ * `p:clrMap`, which no other state can tell.
5655
+ */
5656
+ protected extractTemplateBackgroundColor(partXml: XmlObject | undefined, rootTag: 'p:sldMaster' | 'p:sldLayout', clrMapOverride: Record<string, string> | null): string | undefined;
5623
5657
  /**
5624
5658
  * Composite a resolved background colour with its `a:alpha` (or
5625
5659
  * `a:alphaMod`/`a:alphaOff`) opacity onto opaque white.
@@ -5729,7 +5763,7 @@ declare class PptxHandlerRuntime$32 extends PptxHandlerRuntime$33 {
5729
5763
  }
5730
5764
  //#endregion
5731
5765
  //#region pptx/core/core/runtime/PptxHandlerRuntimeSlideUtils.d.ts
5732
- declare class PptxHandlerRuntime$31 extends PptxHandlerRuntime$32 {
5766
+ declare class PptxHandlerRuntime$33 extends PptxHandlerRuntime$34 {
5733
5767
  /**
5734
5768
  * Retrieve the background gradient from a layout, falling back to master.
5735
5769
  */
@@ -5767,6 +5801,12 @@ declare class PptxHandlerRuntime$31 extends PptxHandlerRuntime$32 {
5767
5801
  * whichever slide happened to be parsed last.
5768
5802
  */
5769
5803
  protected applyMasterThemeState(masterPath: string | undefined): void;
5804
+ /**
5805
+ * Run `work` with one master's theme state active and no slide colour-map override, then
5806
+ * put back whatever state was active before, so a part parsed on request (a layout preview)
5807
+ * resolves through its own master without disturbing the caller's.
5808
+ */
5809
+ protected withMasterThemeState<T>(masterPath: string | undefined, work: () => Promise<T>): Promise<T>;
5770
5810
  /**
5771
5811
  * Extract the `p:bg/@showAnimation` flag from a slide's XML.
5772
5812
  * Returns `true` when the background should animate, `false` when
@@ -5804,7 +5844,7 @@ declare class PptxHandlerRuntime$31 extends PptxHandlerRuntime$32 {
5804
5844
  }
5805
5845
  //#endregion
5806
5846
  //#region pptx/core/core/runtime/PptxHandlerRuntimePlaceholderStyles.d.ts
5807
- declare class PptxHandlerRuntime$30 extends PptxHandlerRuntime$31 {
5847
+ declare class PptxHandlerRuntime$32 extends PptxHandlerRuntime$33 {
5808
5848
  /**
5809
5849
  * Parse a single `a:lvlXpPr` node into a structured
5810
5850
  * {@link PlaceholderTextLevelStyle}.
@@ -5823,7 +5863,7 @@ declare class PptxHandlerRuntime$30 extends PptxHandlerRuntime$31 {
5823
5863
  }
5824
5864
  //#endregion
5825
5865
  //#region pptx/core/core/runtime/PptxHandlerRuntimePlaceholderDefaults.d.ts
5826
- declare class PptxHandlerRuntime$29 extends PptxHandlerRuntime$30 {
5866
+ declare class PptxHandlerRuntime$31 extends PptxHandlerRuntime$32 {
5827
5867
  /**
5828
5868
  * Extract structured {@link PlaceholderDefaults} from a layout or master
5829
5869
  * shape that carries a `p:ph` element.
@@ -5832,7 +5872,7 @@ declare class PptxHandlerRuntime$29 extends PptxHandlerRuntime$30 {
5832
5872
  }
5833
5873
  //#endregion
5834
5874
  //#region pptx/core/core/runtime/PptxHandlerRuntimeMasterElements.d.ts
5835
- declare class PptxHandlerRuntime$28 extends PptxHandlerRuntime$29 {
5875
+ declare class PptxHandlerRuntime$30 extends PptxHandlerRuntime$31 {
5836
5876
  /**
5837
5877
  * Parse a `CT_TextListStyle` node (`a:defPPr` + `a:lvl1pPr` … `a:lvl9pPr`)
5838
5878
  * into a level-keyed style map. Used for `<p:txStyles>` children
@@ -5868,20 +5908,22 @@ interface MasterPartElementHost {
5868
5908
  backgroundImage?: string;
5869
5909
  backgroundImageProperties?: PptxImageProperties;
5870
5910
  /**
5871
- * Already resolved by the master/layout parser. Read here only so the save
5872
- * side can tell a chosen colour from a flattened `p:bgRef`.
5911
+ * Already resolved (for a slide master or layout, by
5912
+ * {@link PptxHandlerRuntime.enrichSlideMasterElements}). Read here only so
5913
+ * the save side can tell a chosen colour from a flattened `p:bgRef`.
5873
5914
  */
5874
5915
  backgroundColor?: string;
5875
5916
  }
5876
- declare class PptxHandlerRuntime$27 extends PptxHandlerRuntime$28 {
5917
+ declare class PptxHandlerRuntime$29 extends PptxHandlerRuntime$30 {
5877
5918
  /** Parse every editable element in a master or layout shape tree. */
5878
5919
  protected enrichMasterPartElements(part: MasterPartElementHost | undefined, rootTag: MasterPartRootTag): Promise<void>;
5879
5920
  /**
5880
- * Populate `elements` on every slide master and on each of its layouts.
5921
+ * Resolve the background of every slide master and of each of its layouts,
5922
+ * and populate their `elements`.
5881
5923
  *
5882
- * Scheme colours on a master's own shapes must resolve through that
5883
- * master's colour map and theme, so the active master state is switched
5884
- * per part and reset to the deck-wide snapshot afterwards.
5924
+ * Scheme colours on a master, its own `p:bgRef` included, must resolve
5925
+ * through that master's colour map and theme, so the active master state is
5926
+ * switched per part and reset to the deck-wide snapshot afterwards.
5885
5927
  */
5886
5928
  protected enrichSlideMasterElements(masters: PptxSlideMaster[]): Promise<void>;
5887
5929
  /** Parse every editable element in a notes or handout master shape tree. */
@@ -5890,7 +5932,7 @@ declare class PptxHandlerRuntime$27 extends PptxHandlerRuntime$28 {
5890
5932
  }
5891
5933
  //#endregion
5892
5934
  //#region pptx/core/core/runtime/PptxHandlerRuntimeLayoutElements.d.ts
5893
- declare class PptxHandlerRuntime$26 extends PptxHandlerRuntime$27 {
5935
+ declare class PptxHandlerRuntime$28 extends PptxHandlerRuntime$29 {
5894
5936
  /**
5895
5937
  * Parse the layout artwork inherited by a slide.
5896
5938
  *
@@ -5919,7 +5961,7 @@ declare class PptxHandlerRuntime$26 extends PptxHandlerRuntime$27 {
5919
5961
  * masters, and the majority of sessions never open the gallery at all. The
5920
5962
  * results are memoised, so opening the gallery a second time is free.
5921
5963
  */
5922
- declare class PptxHandlerRuntime$25 extends PptxHandlerRuntime$26 {
5964
+ declare class PptxHandlerRuntime$27 extends PptxHandlerRuntime$28 {
5923
5965
  private layoutPreviewCache;
5924
5966
  /**
5925
5967
  * Build (or return the memoised) preview for one layout.
@@ -5942,7 +5984,9 @@ declare class PptxHandlerRuntime$25 extends PptxHandlerRuntime$26 {
5942
5984
  protected invalidateLayoutPreviews(layoutPath?: string): void;
5943
5985
  /**
5944
5986
  * Resolve the background a layout thumbnail should paint, falling back to
5945
- * the layout's master when the layout itself declares none.
5987
+ * the layout's master when the layout itself declares none. Runs with the
5988
+ * master active; the layout's own colour map override applies to an
5989
+ * inherited background too, as a slide's does.
5946
5990
  */
5947
5991
  private resolveLayoutPreviewBackground;
5948
5992
  }
@@ -5956,7 +6000,7 @@ declare class PptxHandlerRuntime$25 extends PptxHandlerRuntime$26 {
5956
6000
  */
5957
6001
  declare const FILL_LIST_CHILD_TAGS: readonly ['a:solidFill', 'a:gradFill', 'a:pattFill', 'a:noFill', 'a:grpFill'];
5958
6002
  type FillListChildTag = (typeof FILL_LIST_CHILD_TAGS)[number];
5959
- declare class PptxHandlerRuntime$24 extends PptxHandlerRuntime$25 {
6003
+ declare class PptxHandlerRuntime$26 extends PptxHandlerRuntime$27 {
5960
6004
  /**
5961
6005
  * Build a fill-style entry for one child node based on its tag.
5962
6006
  */
@@ -5998,7 +6042,7 @@ declare class PptxHandlerRuntime$24 extends PptxHandlerRuntime$25 {
5998
6042
  }
5999
6043
  //#endregion
6000
6044
  //#region pptx/core/core/runtime/PptxHandlerRuntimeThemeOverrides.d.ts
6001
- declare class PptxHandlerRuntime$23 extends PptxHandlerRuntime$24 {
6045
+ declare class PptxHandlerRuntime$25 extends PptxHandlerRuntime$26 {
6002
6046
  /**
6003
6047
  * Parse the `a:fmtScheme` element from the theme into a structured
6004
6048
  * {@link PptxThemeFormatScheme}. Each sub-list (fillStyleLst, lnStyleLst,
@@ -6066,7 +6110,7 @@ declare class PptxHandlerRuntime$23 extends PptxHandlerRuntime$24 {
6066
6110
  }
6067
6111
  //#endregion
6068
6112
  //#region pptx/core/core/runtime/PptxHandlerRuntimeThemeRefResolution.d.ts
6069
- declare class PptxHandlerRuntime$22 extends PptxHandlerRuntime$23 {
6113
+ declare class PptxHandlerRuntime$24 extends PptxHandlerRuntime$25 {
6070
6114
  /**
6071
6115
  * Resolve a `a:effectRef` element into concrete effect properties
6072
6116
  * by looking up `@_idx` in the theme format scheme's effect style list.
@@ -6103,8 +6147,64 @@ declare class PptxHandlerRuntime$22 extends PptxHandlerRuntime$23 {
6103
6147
  protected resolveThemeFillRef(refNode: XmlObject, style: ShapeStyle): void;
6104
6148
  }
6105
6149
  //#endregion
6150
+ //#region pptx/core/core/runtime/theme-part-model.d.ts
6151
+ /** One theme part, parsed. */
6152
+ interface ThemePartModel {
6153
+ /** `a:theme @name`, `a:clrScheme @name` and `a:fontScheme @name`, when present. */
6154
+ name: string | undefined;
6155
+ colorSchemeName: string | undefined;
6156
+ fontSchemeName: string | undefined;
6157
+ /**
6158
+ * The twelve scheme slots over the schema defaults. The `tx1`/`bg1`/`tx2`/`bg2` aliases are not
6159
+ * baked in: they resolve through each master's own `p:clrMap` at lookup time.
6160
+ */
6161
+ colorMap: Record<string, string>;
6162
+ /** `mj-lt`/`mj-ea`/`mj-cs` and `mn-lt`/`mn-ea`/`mn-cs`. */
6163
+ fontMap: Record<string, string>;
6164
+ /** Per-script faces (`<a:font script="..."/>`) of the major and minor fonts. */
6165
+ majorFontScripts: Record<string, string>;
6166
+ minorFontScripts: Record<string, string>;
6167
+ /** Raw subtrees the save re-emits verbatim; `undefined` when the part has none. */
6168
+ objectDefaults: PptxThemeObjectDefaults | undefined;
6169
+ extraClrSchemeLst: unknown;
6170
+ custClrLst: unknown;
6171
+ extLst: unknown;
6172
+ formatScheme: PptxThemeFormatScheme | undefined;
6173
+ }
6174
+ //#endregion
6175
+ //#region pptx/core/core/runtime/PptxHandlerRuntimeThemePartModel.d.ts
6176
+ /**
6177
+ * Reading one theme part (`ppt/theme/themeN.xml`).
6178
+ *
6179
+ * {@link parseThemePartXml} turns a part's XML into a {@link ThemePartModel} and changes nothing;
6180
+ * {@link cacheThemePartModel} records what the save pipeline and font resolution need of it, keyed
6181
+ * by the part's path. The load pipeline does both for every part a master uses
6182
+ * (`parseThemePart`); {@link getThemePartSchemes} only reads.
6183
+ */
6184
+ declare class PptxHandlerRuntime$23 extends PptxHandlerRuntime$24 {
6185
+ /** Parse one theme part's XML. Side-effect free. */
6186
+ protected parseThemePartXml(themeXml: string): ThemePartModel;
6187
+ /**
6188
+ * Record a parsed part under its path: its original XML (byte-stable passthrough on save,
6189
+ * C-H3), its names, per-script fonts and the raw subtrees the save re-emits.
6190
+ */
6191
+ protected cacheThemePartModel(themePath: string, themeXml: string, model: ThemePartModel): void;
6192
+ /**
6193
+ * Parse `<a:font script="..." typeface="..."/>` children of a major or minor font node into a
6194
+ * `script -> typeface` dictionary. fast-xml-parser collapses repeated tags into arrays, so the
6195
+ * array form is walked regardless of how many siblings are present. Phase 4 Stream A / M4.
6196
+ */
6197
+ protected collectFontScriptOverrides(fontNode: XmlObject | undefined): Record<string, string>;
6198
+ /**
6199
+ * The colour, font and format schemes and name of one theme part in the package, as the part holds
6200
+ * them now (a scheme edit already written to it included). Reads only: the loaded theme, the
6201
+ * masters and what a save writes are unchanged. `undefined` when the package has no such part.
6202
+ */
6203
+ getThemePartSchemes(themePath: string): Promise<PptxThemePartSchemes | undefined>;
6204
+ }
6205
+ //#endregion
6106
6206
  //#region pptx/core/core/runtime/PptxHandlerRuntimeThemeLoading.d.ts
6107
- declare class PptxHandlerRuntime$21 extends PptxHandlerRuntime$22 {
6207
+ declare class PptxHandlerRuntime$22 extends PptxHandlerRuntime$23 {
6108
6208
  protected resolvePrimaryThemePath(): Promise<string | undefined>;
6109
6209
  protected parseThemeOptions(): Promise<PptxThemeOption[]>;
6110
6210
  /**
@@ -6146,15 +6246,6 @@ declare class PptxHandlerRuntime$21 extends PptxHandlerRuntime$22 {
6146
6246
  fontMap: Record<string, string>;
6147
6247
  formatScheme: PptxThemeFormatScheme | undefined;
6148
6248
  } | null>;
6149
- /**
6150
- * Parse `<a:font script="…" typeface="…"/>` children of a major or
6151
- * minor font node into a `script -> typeface` dictionary.
6152
- *
6153
- * fast-xml-parser collapses repeated tags into arrays, so iterate
6154
- * over the array form regardless of how many siblings are present.
6155
- *
6156
- * Phase 4 Stream A / M4.
6157
- */
6158
6249
  /**
6159
6250
  * Flatten a per-theme-path script-override map (`themePath -> {script ->
6160
6251
  * typeface}`) into a single `{script -> typeface}` lookup for
@@ -6162,7 +6253,6 @@ declare class PptxHandlerRuntime$21 extends PptxHandlerRuntime$22 {
6162
6253
  * the primary-theme-first parse order. Phase 4 Stream A / M4 (#83).
6163
6254
  */
6164
6255
  protected aggregateFontScriptOverrides(perPathMap: Map<string, Record<string, string>>): Record<string, string>;
6165
- protected collectFontScriptOverrides(fontNode: XmlObject | undefined): Record<string, string>;
6166
6256
  /**
6167
6257
  * Resolve the theme file path referenced by a given master's `.rels`.
6168
6258
  * Returns `undefined` when the master has no theme relationship.
@@ -6188,7 +6278,7 @@ declare class PptxHandlerRuntime$21 extends PptxHandlerRuntime$22 {
6188
6278
  * the per-master maps, the deck-wide snapshots, and the currently active
6189
6279
  * `themeColorMap` / `themeFontMap`.
6190
6280
  */
6191
- declare class PptxHandlerRuntime$20 extends PptxHandlerRuntime$21 {
6281
+ declare class PptxHandlerRuntime$21 extends PptxHandlerRuntime$22 {
6192
6282
  /**
6193
6283
  * The theme parts an edit should touch, primary theme first.
6194
6284
  *
@@ -6200,12 +6290,13 @@ declare class PptxHandlerRuntime$20 extends PptxHandlerRuntime$21 {
6200
6290
  protected resolveThemeEditTargets(themePaths?: readonly string[]): Promise<string[]>;
6201
6291
  private readThemePart;
6202
6292
  /**
6203
- * Parse, edit, and write back every target theme part. Parts the edit
6204
- * cannot apply to (no `a:themeElements`) are left untouched.
6293
+ * Parse, edit, and write back every target theme part (`edit` gets the
6294
+ * part's path too). Parts the edit cannot apply to (no `a:themeElements`)
6295
+ * are left untouched.
6205
6296
  *
6206
6297
  * @returns the paths that were rewritten
6207
6298
  */
6208
- protected rewriteThemeParts(themePaths: readonly string[] | undefined, edit: (data: XmlObject) => boolean): Promise<string[]>;
6299
+ protected rewriteThemeParts(themePaths: readonly string[] | undefined, edit: (data: XmlObject, themePath: string) => boolean): Promise<string[]>;
6209
6300
  /** Masters whose theme part is among the rewritten paths. */
6210
6301
  protected mastersUsingThemes(themePaths: readonly string[]): string[];
6211
6302
  /**
@@ -6244,6 +6335,33 @@ declare class PptxHandlerRuntime$20 extends PptxHandlerRuntime$21 {
6244
6335
  applyTheme(colorScheme: PptxThemeColorScheme, fontScheme: PptxThemeFontScheme, themeName?: string): Promise<void>;
6245
6336
  }
6246
6337
  //#endregion
6338
+ //#region pptx/core/core/runtime/PptxHandlerRuntimeThemeSwitching.d.ts
6339
+ /**
6340
+ * Pointing slide masters at another theme part already in the package (Presentation properties >
6341
+ * Theme).
6342
+ *
6343
+ * Rewriting a master's theme relationship is not enough on its own: the runtime's theme state
6344
+ * (`masterThemePaths`, the per-master colour, font and format maps, and for the first master the
6345
+ * active maps and the deck-wide snapshots) still described the old part, so a scheme edit
6346
+ * (`resolveThemeEditTargets`) and a save (`persistThemeParts`) made after the switch went to the
6347
+ * part the masters no longer use. Every re-targeted master adopts the new part's state too.
6348
+ */
6349
+ declare class PptxHandlerRuntime$20 extends PptxHandlerRuntime$21 {
6350
+ /**
6351
+ * Point the first slide master, or every one, at a theme part already in the package. Does
6352
+ * nothing when the package has no such part.
6353
+ */
6354
+ setPresentationTheme(themePath: string, applyToAllMasters?: boolean): Promise<void>;
6355
+ /**
6356
+ * Point one slide master at a theme part already in the package (Undo of a theme switch puts
6357
+ * each master back on its own part). Does nothing when the package has no such master or part.
6358
+ */
6359
+ setSlideMasterTheme(masterPath: string, themePath: string): Promise<void>;
6360
+ private retargetMasterTheme;
6361
+ /** Point the runtime's theme state for `masterPath` at the part it now uses. */
6362
+ private adoptMasterTheme;
6363
+ }
6364
+ //#endregion
6247
6365
  //#region pptx/core/core/runtime/PptxHandlerRuntimeComments.d.ts
6248
6366
  declare class PptxHandlerRuntime$19 extends PptxHandlerRuntime$20 {
6249
6367
  /**
@@ -6892,6 +7010,8 @@ interface StyleReferenceReResolution {
6892
7010
  */
6893
7011
  declare class PptxHandlerRuntime$4 extends PptxHandlerRuntime$5 {
6894
7012
  private readonly effectSchemeCache;
7013
+ /** Every `a:fmtScheme` written into a theme part or over one ({@link restoreThemeFormatScheme}). */
7014
+ private readonly heldFormatSchemes;
6895
7015
  /**
6896
7016
  * Resolve a `<p:style>` node as the base class does, against built-in effect scheme
6897
7017
  * `effectSchemeId` instead of the deck's own (the Effects gallery draws each tile this way).
@@ -6911,6 +7031,24 @@ declare class PptxHandlerRuntime$4 extends PptxHandlerRuntime$5 {
6911
7031
  * into every theme part a master references; a real theme variant brings its own.
6912
7032
  */
6913
7033
  applyThemeFormatSchemeXml(fmtSchemeXml: string): Promise<PptxThemeFormatScheme | undefined>;
7034
+ /**
7035
+ * Put back a format scheme the deck held before (Undo and Redo of an Effects pick), as the parts
7036
+ * held it: each theme part a master references gets back what it held the last time the deck's
7037
+ * scheme was `scheme` over those same parts, so a part with a scheme of its own gets its own back
7038
+ * (with no such time, `scheme`'s own element goes into every one). With `themePaths`, `scheme`'s
7039
+ * own element goes into those parts only.
7040
+ *
7041
+ * @returns the deck's format scheme now, or `undefined` (nothing written) for a scheme no part
7042
+ * held while this handler wrote into it
7043
+ */
7044
+ restoreThemeFormatScheme(scheme: PptxThemeFormatScheme, themePaths?: readonly string[]): Promise<PptxThemeFormatScheme | undefined>;
7045
+ /**
7046
+ * Write `elementFor(part)` into every theme part a master references (or only `themePaths`),
7047
+ * skipping a part it gives none, holding what each part held and now holds, and refresh the
7048
+ * in-memory format schemes of the masters on those parts and, when the deck's part is among
7049
+ * them, the deck's.
7050
+ */
7051
+ private writeFormatScheme;
6914
7052
  /** The real theme variants the loaded package carries, or none. */
6915
7053
  getThemeVariants(): PptxThemeVariant[];
6916
7054
  /** The format scheme the deck's primary theme carries now. */
@@ -7192,15 +7330,20 @@ interface IPptxHandlerRuntime {
7192
7330
  Builder(data: PptxData): PptxXmlBuilder;
7193
7331
  setTemplateBackground(path: string, backgroundColor: string | undefined): void;
7194
7332
  setPresentationTheme(themePath: string, applyToAllMasters?: boolean): Promise<void>;
7333
+ setSlideMasterTheme(masterPath: string, themePath: string): Promise<void>;
7334
+ getThemePartSchemes(themePath: string): Promise<PptxThemePartSchemes | undefined>;
7195
7335
  getTemplateBackgroundColor(path: string): string | undefined;
7196
- updateThemeColorScheme(colorScheme: PptxThemeColorScheme): Promise<void>;
7197
- updateThemeFontScheme(fontScheme: PptxThemeFontScheme): Promise<void>;
7198
- updateThemeName(name: string): Promise<void>;
7336
+ /** Scheme edits write every part a slide master uses, or only `themePaths`. */
7337
+ updateThemeColorScheme(colorScheme: PptxThemeColorScheme, themePaths?: readonly string[]): Promise<void>;
7338
+ updateThemeFontScheme(fontScheme: PptxThemeFontScheme, themePaths?: readonly string[]): Promise<void>;
7339
+ updateThemeName(name: string, themePaths?: readonly string[]): Promise<void>;
7199
7340
  /** Resolve a `<p:style>` node against the loaded theme (see PptxHandlerRuntimeStyleMatrixResolve). */
7200
7341
  resolveStyleMatrixReferences(styleXml: XmlObject, effectSchemeId?: string): ResolvedStyleMatrix;
7201
7342
  /** Write a built-in effect scheme (`a:fmtScheme`) into the theme parts. */
7202
7343
  applyThemeEffectScheme(id: string): Promise<PptxThemeFormatScheme | undefined>;
7203
7344
  applyThemeFormatSchemeXml(fmtSchemeXml: string): Promise<PptxThemeFormatScheme | undefined>;
7345
+ /** Put back a format scheme a theme part held before (Undo of an Effects pick). */
7346
+ restoreThemeFormatScheme(scheme: PptxThemeFormatScheme, themePaths?: readonly string[]): Promise<PptxThemeFormatScheme | undefined>;
7204
7347
  getThemeFormatScheme(): PptxThemeFormatScheme | undefined;
7205
7348
  getThemeVariants(): PptxThemeVariant[];
7206
7349
  reResolveThemeStyleReferences(slides: readonly PptxSlide[], templateElementsBySlideId: Readonly<Record<string, PptxElement[]>>, effectSchemeId?: string): StyleReferenceReResolution;
@@ -7497,10 +7640,28 @@ declare class PptxHandlerCore {
7497
7640
  * ```
7498
7641
  */
7499
7642
  setPresentationTheme(themePath: string, applyToAllMasters?: boolean): Promise<void>;
7643
+ /**
7644
+ * Point one slide master at a theme part already in the package; scheme edits and saves follow
7645
+ * it. Does nothing when the package has no such master or part.
7646
+ *
7647
+ * @param masterPath - The master's part path (e.g. `ppt/slideMasters/slideMaster2.xml`).
7648
+ * @param themePath - The theme part's path (e.g. `ppt/theme/theme1.xml`).
7649
+ */
7650
+ setSlideMasterTheme(masterPath: string, themePath: string): Promise<void>;
7651
+ /**
7652
+ * Read one theme part's colour, font and format schemes and its name without changing the
7653
+ * loaded theme, for example to show what switching to it would apply.
7654
+ *
7655
+ * @param themePath - The theme part's path (e.g. `ppt/theme/theme2.xml`).
7656
+ * @returns The part's schemes, or `undefined` when the package has no such part.
7657
+ */
7658
+ getThemePartSchemes(themePath: string): Promise<PptxThemePartSchemes | undefined>;
7500
7659
  /**
7501
7660
  * Modify the theme’s colour scheme (accent colours, background, text, etc.).
7502
7661
  *
7503
7662
  * @param colorScheme - A {@link PptxThemeColorScheme} with hex colour values.
7663
+ * @param themePaths - Only these theme parts (e.g. `ppt/theme/theme2.xml`); every part a slide
7664
+ * master uses when omitted.
7504
7665
  *
7505
7666
  * @example
7506
7667
  * ```ts
@@ -7513,11 +7674,13 @@ declare class PptxHandlerCore {
7513
7674
  * // => void — colour scheme updated in the in-memory theme XML
7514
7675
  * ```
7515
7676
  */
7516
- updateThemeColorScheme(colorScheme: PptxThemeColorScheme): Promise<void>;
7677
+ updateThemeColorScheme(colorScheme: PptxThemeColorScheme, themePaths?: readonly string[]): Promise<void>;
7517
7678
  /**
7518
7679
  * Update the theme’s font scheme (heading + body typefaces).
7519
7680
  *
7520
7681
  * @param fontScheme - A {@link PptxThemeFontScheme} with font family names.
7682
+ * @param themePaths - Only these theme parts (e.g. `ppt/theme/theme2.xml`); every part a slide
7683
+ * master uses when omitted.
7521
7684
  *
7522
7685
  * @example
7523
7686
  * ```ts
@@ -7528,13 +7691,15 @@ declare class PptxHandlerCore {
7528
7691
  * // => void — font scheme updated in the in-memory theme XML
7529
7692
  * ```
7530
7693
  */
7531
- updateThemeFontScheme(fontScheme: PptxThemeFontScheme): Promise<void>;
7694
+ updateThemeFontScheme(fontScheme: PptxThemeFontScheme, themePaths?: readonly string[]): Promise<void>;
7532
7695
  /**
7533
7696
  * Rename the presentation theme.
7534
7697
  *
7535
7698
  * @param name - New display name for the theme.
7699
+ * @param themePaths - Only these theme parts (e.g. `ppt/theme/theme2.xml`); every part a slide
7700
+ * master uses when omitted.
7536
7701
  */
7537
- updateThemeName(name: string): Promise<void>;
7702
+ updateThemeName(name: string, themePaths?: readonly string[]): Promise<void>;
7538
7703
  /**
7539
7704
  * Resolve a `<p:style>` block (`a:lnRef` / `a:fillRef` / `a:effectRef` /
7540
7705
  * `a:fontRef`) against the loaded theme, exactly as the load path would for
@@ -7550,6 +7715,12 @@ declare class PptxHandlerCore {
7550
7715
  applyThemeEffectScheme(id: string): Promise<PptxThemeFormatScheme | undefined>;
7551
7716
  /** Write an `a:fmtScheme` element (a real theme variant's) into the theme parts. */
7552
7717
  applyThemeFormatSchemeXml(fmtSchemeXml: string): Promise<PptxThemeFormatScheme | undefined>;
7718
+ /**
7719
+ * Put a format scheme a theme part held before back into the theme parts (or only `themePaths`),
7720
+ * as the part held it: Undo and Redo of an Effects pick. Only a scheme this handler wrote into a
7721
+ * part or over one can come back; for any other it writes nothing and returns `undefined`.
7722
+ */
7723
+ restoreThemeFormatScheme(scheme: PptxThemeFormatScheme, themePaths?: readonly string[]): Promise<PptxThemeFormatScheme | undefined>;
7553
7724
  /** The real theme variants the loaded package carries (`themeVariants/` parts), or none. */
7554
7725
  getThemeVariants(): PptxThemeVariant[];
7555
7726
  /** The format scheme the deck's primary theme carries now. */
@@ -9561,4 +9732,4 @@ declare function renameSlideMaster(handler: PptxHandler, data: PptxData, masterI
9561
9732
  declare function insertSlideMaster(handler: PptxHandler, data: PptxData): Promise<DuplicateMasterResult>;
9562
9733
  //#endregion
9563
9734
  export { PresentationThemeInput as $, DiagramRelationshipIds as $i, PptxCommentXmlFactoryProvider as $n, SignatureReference as $r, IPptxHandlerRuntime as $t, PresentationDiff as A, PptxNativeAnimationService as Ai, PptxMediaDataParserContext as An, PptxSaveConstantsFactory as Ar, setChartDataPointLabel as At, AnimationInput as B, PptxSlideLoaderParams as Bi, IPptxSlideBackgroundBuilder as Bn, isStrictNamespaceUri as Br, setChartType as Bt, generateLayoutXml as C, ooxmlToPresetName as Ci, PptxBuilderFactoryContext as Cn, PptxPresentationSaveBuilder as Cr, setChartAxisGridlineStyle as Ct, mailMerge as D, PptxSlideTransitionService as Di, PptxGraphicFrameParserContext as Dn, PptxContentTypesCommentBuildInput as Dr, setChartDataLabels as Dt, findPlaceholders as E, IPptxSlideTransitionService as Ei, PptxGraphicFrameParser as En, PptxContentTypesBuilder as Er, setChartCategories as Et, PptxHandler as F, PptxXmlLookupService as Fi, PptxShapeStyleExtractor as Fn, parsePresentationSmartTags as Fr, setChartSeriesColor as Ft, ConnectorOptions as G, PptxTemplateBackgroundState as Gi, PptxSlideNotesPartUpdaterInput as Gn, AlternateContentBlock as Gr, ChartGradientInput as Gt, ChartInput as H, PptxSlideNotesResult as Hi, PptxSlideBackgroundBuilderInput as Hn, normalizeNamespaceUri as Hr, updateChartSeriesValues as Ht, PresentationBuilder as I, PptxSlideLoaderService as Ii, PptxShapeStyleExtractorContext as In, OoxmlConformanceClass as Ir, setChartSeriesErrorBars as It, GroupOptions as J, IPptxCompatibilityService as Ji, IPptxElementTransformUpdater as Jn, selectAlternateContentBranch as Jr, PptxHandlerRuntime as Jt, ElementPosition as K, PptxDocumentPropertiesUpdater as Ki, IPptxSlideMediaRelationshipBuilder as Kn, SHAPE_TREE_ELEMENT_TAGS as Kr, ChartGradientStopInput as Kt, PresentationBuilderResult as L, IPptxSlideLoaderService as Li, IPptxColorStyleCodec as Ln, containsConvertibleStrictNamespaceAttribute as Lr, setChartSeriesMarker as Lt, SlideDiff as M, PptxEditorAnimationService as Mi, PptxTableDataParser as Mn, IFactory as Mr, setChartGrouping as Mt, diffPresentations as N, PptxEditorAnimationServiceOptions as Ni, PptxTableDataParserContext as Nn, ResolveChartColor as Nr, setChartLegend as Nt, TemplateData as O, PptxSlideTransitionServiceOptions as Oi, IPptxMediaDataParser as On, PptxContentTypesSlideMediaBuildInput as Or, setChartDataPointExplosion as Ot, diffSlides as P, IPptxXmlLookupService as Pi, IPptxShapeStyleExtractor as Pn, loadThemeVariants as Pr, setChartSeriesChartType as Pt, PresentationOptions as Q, PptxConnectorParserContext as Qi, PptxSlideCommentPartWriterInput as Qn, SignatureDetectionResult as Qr, DEFAULT_MAX_UNCOMPRESSED_BYTES as Qt, buildBlankPresentationArchive as R, PptxMediaTimingEntry as Ri, PptxColorStyleCodec as Rn, convertXmlToStrict as Rr, setChartSeriesTrendline as Rt, findLayoutByType as S, PRESET_TO_OOXML as Si, PictureXmlFactoryInit as Sn, PptxPresentationSaveBuildInput as Sr, setChartAxis as St, applyTemplate as T, OoxmlPresetMapping as Ti, IPptxGraphicFrameParser as Tn, IPptxContentTypesBuilder as Tr, setChartAxisTitleStyle as Tt, ChartOptions as U, IPptxTemplateBackgroundService as Ui, IPptxSlideNotesPartUpdater as Un, normalizeStrictXml as Ur, ChartAreaFormatInput as Ut, BackgroundInput as V, PptxSlideLoaderThemeOverride as Vi, PptxSlideBackgroundBuilder as Vn, isTransitionalNamespaceUri as Vr, updateChartDataPoint as Vt, ChartSeriesInput as W, PptxTemplateBackgroundService as Wi, PptxSlideNotesPartUpdater as Wn, toStrictNamespaceUri as Wr, ChartGroupOptionsInput as Wt, MediaOptions as X, IPptxConnectorParser as Xi, IPptxSlideCommentPartWriter as Xn, ParsedSignature as Xr, PptxHandlerRuntimeFactory as Xt, ImageOptions as Y, PptxCompatibilityService as Yi, PptxElementTransformUpdater as Yn, unwrapAlternateContent as Yr, IPptxHandlerRuntimeFactory as Yt, PlaceholderOptions as Z, PptxConnectorParser as Zi, PptxSlideCommentPartWriter as Zn, SignatureCertificateInfo as Zr, createDefaultPptxHandlerRuntime as Zt, LayoutDefinition as _, PptxRuntimeDependencyFactoryInput as _i, IPictureXmlFactory as _n, PptxCommentAuthorDescriptor as _r, PptxChartLegendPosition as _t, insertSlideMaster as a, PptxSlideNotesBuilder as aa, EncryptionAlgorithm as ai, ZipBombError as an, IPptxSlideCommentsXmlFactory as ar, TableOptions as at, createLayouts as b, OOXML_TO_PRESET_ENTR as bi, IXmlElementFactory as bn, PptxSaveStateBuilder as br, removeChartCategory as bt, DuplicateLayoutSuccess as c, THEME_PRESETS as ca, EncryptionScheme as ci, StyleReferenceReResolution as cn, IPptxSlideRelationshipRegistry as cr, TextPlaceholderType as ct, insertLayout as d, applyCustomShows as di, nextAutoNumber as dn, PptxSlideRelationshipRegistryOptions as dr, TransitionInput as dt, applyDiagramRelationshipIds as ea, SignatureStatus as ei, MAX_ZIP_ENTRY_COUNT as en, PptxCommentAuthorsXmlFactory as er, ShadowInput as et, renameLayout as f, applySections as fi, PptxElementXmlBuilder as fn, SlideReferenceRemapInput as fr, ChartAxisEdit as ft, LayoutCreationResult as g, PptxRuntimeDependencyFactory as gi, IMediaGraphicFrameXmlFactory as gn, PptxPresentationSlidesReconcilerInput as gr, PptxChartAxisType as gt, MasterLayoutCrudSuccess as h, PptxRuntimeDependencyBundle as hi, IConnectorXmlFactory as hn, PptxPresentationSlidesReconciler as hr, ChartGridlineStyleEdit as ht, duplicateSlideMaster as i, PptxSlideElementsBuilder as ia, verifySignatureDigests as ii, PptxSvgRasterizer as in, IPptxCommentXmlFactoryProvider as ir, TableInput as it, PropertyChange as j, IPptxEditorAnimationService as ji, IPptxTableDataParser as jn, createPptxSaveConstants as jr, setChartDataPointMarker as jt, ElementDiff as k, IPptxNativeAnimationService as ki, PptxMediaDataParser as kn, PptxSaveConstants as kr, setChartDataPointFill as kt, deleteLayout as l, StandardEncryptionInfo as li, breakAutoNumberRun as ln, PptxSlideCommentRelationshipInfo as lr, TextSegmentInput as lt, MasterLayoutCrudResult as m, IPptxRuntimeDependencyFactory as mi, ConnectorXmlFactoryInit as mn, IPptxPresentationSlidesReconciler as mr, ChartDataPointLabelEdit as mt, DuplicateMasterSuccess as n, IPptxXmlBuilder as na, getSignaturePathsToStrip as ni, PptxHandlerSaveOptions as nn, ICoreXmlElementFactory as nr, StrokeInput as nt, renameSlideMaster as o, PptxXmlBuilder as oa, EncryptionInfo as oi, BackgroundStyleApplication as on, PptxCommentAuthorsXmlFactoryInit as or, TableRowInput as ot, MasterLayoutCrudFailure as p, parseCustomShows as pi, PptxElementXmlBuilderOptions as pn, buildSlideReferenceRemap as pr, ChartAxisTitleStyleEdit as pt, FillInput as q, CompatibilityWarningInput as qi, PptxSlideMediaRelationshipBuilder as qn, reapplyAlternateContentToTree as qr, toChartGradientFill as qt, deleteSlideMaster as r, PptxSlideBuilder as ra, parseSignatureXml as ri, PptxSaveFormat as rn, IPptxCommentAuthorsXmlFactory as rr, TableCellInput as rt, DuplicateLayoutResult as s, PptxThemePreset as sa, EncryptionOptions as si, BackgroundStyleScope as sn, PptxSlideCommentsXmlFactoryInit as sr, TextOptions as st, DuplicateMasterResult as t, parseDiagramRelationshipIds as ta, detectDigitalSignatures as ti, PptxHandlerLoadOptions as tn, PptxSlideCommentsXmlFactory as tr, ShapeOptions as tt, duplicateLayout as u, PptxSlideReferenceRemap as ui, createAutoNumberSequence as un, PptxSlideRelationshipRegistry as ur, TextStyleInput as ut, PlaceholderDefinition as v, IPptxAnimationWriteService as vi, IPptxXmlFactoryProvider as vn, PptxSaveMediaKind as vr, addChartCategory as vt, Presentation as w, resolveOoxmlPresetMapping as wi, TextShapeXmlFactoryInit as wn, PptxPresentationSaveBuilderOptions as wr, setChartAxisLogScale as wt, findLayoutByName as x, OOXML_TO_PRESET_EXIT as xi, MediaGraphicFrameXmlFactoryInit as xn, IPptxPresentationSaveBuilder as xr, removeChartSeries as xt, createLayout as y, OOXML_TO_PRESET_EMPH as yi, ITextShapeXmlFactory as yn, PptxSaveState as yr, addChartSeries as yt, SlideBuilder as z, PptxMediaTimingMap as zi, PptxColorStyleCodecContext as zn, detectStrictConformance as zr, setChartTitle as zt };
9564
- //# sourceMappingURL=index-CgjEEpfK.d.ts.map
9735
+ //# sourceMappingURL=index-D8DNpc1X.d.ts.map