pptx-react-viewer 3.0.4 → 3.1.1

package/dist/{chunk-6ILXI752.mjs → chunk-OUX4O5XK.mjs}

@@ -1,5 +1,5 @@
-import { translationsEn } from './chunk-L5MNLIQF.mjs';
-import { SHAPE_PRESET_DEFS, VIEWER_SHORTCUT_REFERENCE, getAnimationInitialStyle, cloneHistorySnapshot, hasShapeProperties, getImageFitStyle, isImageLikeElement, getImageTilingStyle, runMediaCommand, findMediaElementByElementId, mediaPlaybackAttributes, buildTextBlockStyle, hasTextProperties, toCssWritingMode, toCssTextOrientation, toCssVerticalDirection, buildTextBodyLayoutStyle, buildTextBody3DSceneStyle, buildParagraphs, colorWithOpacity, normalizeHexColor, build3DExtrusionData, getComputedFillStyle, getComputedEffectStyle, getComputedStrokeStyle, isStrokeOnlyPresetElement, resolveShapeGeometry, normalizeStrokeDashType, getSvgStrokeDasharray, buildSvgGradientDef, isCalloutShape, getCalloutLeaderLineGeometry, buildCalloutLeaderLineSvgPath, getCalloutViewBoxBounds, svgLineCap, getCompoundLineOffsets, getCompoundLineWidths, computeSelectionRect, DEFAULT_FONT_FAMILY, cellStyleToCss, rectToCells, isCellInRect, tableContainerCss, buildChartViewModel, resolveChartKind, chartPreserveAspectRatio, buildNotesPdfBytes, buildSlidesPdfBytes, buildPreviewAnimation, buildMotionPathPreview, getRoundRectRadiusPx2, getResolvedShapeClipPath, mediaFallbackVisual, registerPersistentAudio, resolveAutoFitFontScale, resolveFontKerning, getSubstituteFontFamily, parsePanoseString, resolveScriptFontSet, hasDistinctScriptFonts, nestedTextDecorationStyle, pieceLetterSpacing, resolveMetricTrackingPx, hollowTextFillStyle, buildTabContext, TEXT_BUILD_ID_SEP, buildTextBuildSpec, textBuildSpanStyle, apply3dEffects, clampUnitInterval, customGeometryPathsToSvgSubpaths, svgGradientFillRef, buildSubpathPaints, computeColumnBoundaries, getTableCellBandStyle, parseDrawingColor, parseDrawingColorOpacity, getCellDiagonalBorders, cellRunStyle, getChartStylePalette, computeChartLegendLayout, mediaFallbackIcon, mediaFallbackLabelKey, MEDIA_CHROME_ATTRIBUTE, convertOmmlToMathMl, sanitizeMathMl, tableCellCss, computeResizedColumnWidths, computeResizedRowHeight, DEFAULT_ROW_HEIGHT, ooxmlGradientAngleToCssDegrees, buildRunTabLines, chartPartToAttrs, splitRunForMetrics, splitRunByScriptFont } from './chunk-V7ZLEZ5W.mjs';
+import { translationsEn } from './chunk-MKPSUHUH.mjs';
+import { SHAPE_PRESET_DEFS, VIEWER_SHORTCUT_REFERENCE, getAnimationInitialStyle, cloneHistorySnapshot, hasShapeProperties, getImageFitStyle, isImageLikeElement, getImageTilingStyle, runMediaCommand, findMediaElementByElementId, mediaPlaybackAttributes, buildTextBlockStyle, hasTextProperties, toCssWritingMode, toCssTextOrientation, toCssVerticalDirection, buildTextBodyLayoutStyle, buildTextBody3DSceneStyle, buildParagraphs, colorWithOpacity, normalizeHexColor, build3DExtrusionData, getComputedFillStyle, getComputedEffectStyle, getComputedStrokeStyle, isStrokeOnlyPresetElement, resolveShapeGeometry, normalizeStrokeDashType, getSvgStrokeDasharray, buildSvgGradientDef, isCalloutShape, getCalloutLeaderLineGeometry, buildCalloutLeaderLineSvgPath, getCalloutViewBoxBounds, svgLineCap, getCompoundLineOffsets, getCompoundLineWidths, computeSelectionRect, DEFAULT_FONT_FAMILY, cellStyleToCss, rectToCells, isCellInRect, tableContainerCss, buildChartViewModel, resolveChartKind, chartPreserveAspectRatio, buildNotesPdfBytes, buildSlidesPdfBytes, buildPreviewAnimation, buildMotionPathPreview, getRoundRectRadiusPx2, getResolvedShapeClipPath, mediaFallbackVisual, registerPersistentAudio, resolveAutoFitFontScale, resolveFontKerning, getSubstituteFontFamily, parsePanoseString, resolveScriptFontSet, hasDistinctScriptFonts, nestedTextDecorationStyle, pieceLetterSpacing, resolveMetricTrackingPx, hollowTextFillStyle, buildTabContext, TEXT_BUILD_ID_SEP, buildTextBuildSpec, textBuildSpanStyle, apply3dEffects, clampUnitInterval, customGeometryPathsToSvgSubpaths, svgGradientFillRef, buildSubpathPaints, computeColumnBoundaries, getTableCellBandStyle, parseDrawingColor, parseDrawingColorOpacity, getCellDiagonalBorders, cellRunStyle, getChartStylePalette, computeChartLegendLayout, mediaFallbackIcon, mediaFallbackLabelKey, MEDIA_CHROME_ATTRIBUTE, convertOmmlToMathMl, sanitizeMathMl, tableCellCss, computeResizedColumnWidths, computeResizedRowHeight, DEFAULT_ROW_HEIGHT, ooxmlGradientAngleToCssDegrees, buildRectPathGradient, buildRunTabLines, chartPartToAttrs, splitRunForMetrics, splitRunByScriptFont } from './chunk-ISDTM2V3.mjs';
 import { clsx } from 'clsx';
 import { twMerge } from 'tailwind-merge';
 import React6, { useRef, useState, useEffect, useCallback, useMemo, useLayoutEffect } from 'react';
@@ -2375,13 +2375,13 @@ function parseGradientFillCss(gradFill) {
   if (stops.length === 0) {
     return void 0;
   }
-  const parsed = stops.map((gs) => {
+  const rawStops = stops.map((gs) => {
     const pos = Number.parseInt(String(gs["@_pos"] || "0"), 10) / 1e3;
     const color = parseDrawingColor(gs) ?? "#888888";
     const opacity = parseDrawingColorOpacity(gs);
-    return { pos, color: colorWithOpacity(color, opacity) };
-  }).sort((a, b) => a.pos - b.pos);
-  const stopStrings = parsed.map((s) => `${s.color} ${s.pos.toFixed(1)}%`).join(", ");
+    return { position: pos, color, opacity };
+  }).sort((a, b) => a.position - b.position);
+  const stopStrings = rawStops.map((s) => `${colorWithOpacity(s.color, s.opacity)} ${s.position.toFixed(1)}%`).join(", ");
   const lin = gradFill["a:lin"];
   if (lin) {
     const angRaw = Number.parseInt(String(lin["@_ang"] || "0"), 10);
@@ -2391,24 +2391,25 @@ function parseGradientFillCss(gradFill) {
   const path = gradFill["a:path"];
   if (path) {
     const pathType = String(path["@_path"] || "circle");
-    const fillToRect = path["a:fillToRect"];
+    const fillToRectXml = path["a:fillToRect"];
+    const fillToRect = fillToRectXml ? {
+      l: Number.parseInt(String(fillToRectXml["@_l"] || "0"), 10) / 1e5,
+      t: Number.parseInt(String(fillToRectXml["@_t"] || "0"), 10) / 1e5,
+      r: Number.parseInt(String(fillToRectXml["@_r"] || "0"), 10) / 1e5,
+      b: Number.parseInt(String(fillToRectXml["@_b"] || "0"), 10) / 1e5
+    } : void 0;
+    if (pathType === "rect") {
+      return buildRectPathGradient(rawStops, void 0, fillToRect);
+    }
     let cx = 50;
     let cy = 50;
     if (fillToRect) {
-      const l = Number.parseInt(String(fillToRect["@_l"] || "0"), 10) / 1e5;
-      const t = Number.parseInt(String(fillToRect["@_t"] || "0"), 10) / 1e5;
-      const r = Number.parseInt(String(fillToRect["@_r"] || "0"), 10) / 1e5;
-      const b = Number.parseInt(String(fillToRect["@_b"] || "0"), 10) / 1e5;
+      const { l, t, r, b } = fillToRect;
       cx = (l + (1 - r)) / 2 * 100;
       cy = (t + (1 - b)) / 2 * 100;
     }
     const posX = `${Math.round(cx)}%`;
     const posY = `${Math.round(cy)}%`;
-    if (pathType === "rect") {
-      const semiX = Math.max(cx, 100 - cx);
-      const semiY = Math.max(cy, 100 - cy);
-      return `radial-gradient(${Math.round(semiX)}% ${Math.round(semiY)}% at ${posX} ${posY}, ${stopStrings})`;
-    }
     if (pathType === "shape") {
       return `radial-gradient(farthest-side at ${posX} ${posY}, ${stopStrings})`;
     }

package/dist/{chunk-5IYGA2HX.js → chunk-OZGFMZEX.js}

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunk7HPI5HBA_js = require('./chunk-7HPI5HBA.js');
+var chunkIDTNKL4S_js = require('./chunk-IDTNKL4S.js');
 var chunk4VNS5WPM_js = require('./chunk-4VNS5WPM.js');
 var mcp = require('pptx-viewer-mcp');
 var mcpSchemas = require('pptx-viewer-mcp/schemas');
@@ -14879,7 +14879,7 @@ async function buildSlideMarkdown(slides, slideIndex2, meta3, options = {}) {
   };
   let markdown;
   try {
-    const converter = new chunk7HPI5HBA_js.PptxMarkdownConverter(
+    const converter = new chunkIDTNKL4S_js.PptxMarkdownConverter(
       "",
       {
         sourceName: meta3.title ?? "deck.pptx",
@@ -15471,7 +15471,7 @@ var getTheme = (ctx) => {
     name: theme?.name,
     colorScheme: theme?.colorScheme,
     fontScheme: theme?.fontScheme,
-    availablePresets: Object.keys(chunk7HPI5HBA_js.ThemePresets)
+    availablePresets: Object.keys(chunkIDTNKL4S_js.ThemePresets)
   };
 };
 var readExecutors = {

package/dist/{chunk-U6A5FWWE.js → chunk-PIUB7R2K.js}

@@ -1236,6 +1236,8 @@ var translationsEn = {
   "pptx.animation.duration": "Duration (ms)",
   "pptx.animation.moveDown": "Move down",
   "pptx.animation.moveUp": "Move up",
+  "pptx.animation.nativeEffect": "PowerPoint effect",
+  "pptx.animation.nativeEffectHint": "Added in PowerPoint. Drag your own effects ahead of or behind it.",
   "pptx.animation.none": "None",
   "pptx.animation.preview": "Preview",
   "pptx.animation.repeatCount": "Repeat count",
@@ -1411,6 +1413,8 @@ var translationsEn = {
   "pptx.ole.linked": "Linked",
   "pptx.ole.title": "OLE Object",
   "pptx.ole.type": "Type",
+  "pptx.ole.objectName": "Object Name",
+  "pptx.ole.objectNamePlaceholder": "Used by screen readers and the Selection Pane",
   // Presentation mode (annotations-on-exit prompt)
   "pptx.presentation.clearAnnotations": "Clear Annotations",
   "pptx.presentation.discardAnnotations": "Discard Annotations",
@@ -1607,6 +1611,14 @@ var translationsEn = {
   "pptx.transition.sound": "Sound",
   "pptx.transition.spokes": "Spokes",
   "pptx.transition.type": "Type",
+  "pptx.transition.speed": "Speed",
+  "pptx.transition.speed.slow": "Slow",
+  "pptx.transition.speed.med": "Medium",
+  "pptx.transition.speed.fast": "Fast",
+  "pptx.transition.morphOption": "Morph by",
+  "pptx.transition.morphOption.byObject": "By Object",
+  "pptx.transition.morphOption.byWord": "By Word",
+  "pptx.transition.morphOption.byChar": "By Character",
   // Context menu / editor toolbar (Angular/Vue-specific additions)
   "pptx.contextMenu.ariaLabel": "Context menu",
   "pptx.editorToolbar.ariaLabel": "Editor toolbar",
@@ -2111,6 +2123,7 @@ var translationsEn = {
   "pptx.ribbon.advanceAfterSeconds": "Advance after specified duration",
   "pptx.ribbon.sound": "Sound:",
   "pptx.ribbon.soundNone": "[No Sound]",
+  "pptx.ribbon.soundOther": "Other Sound...",
   "pptx.ribbon.inspector": "Inspector",
   "pptx.ribbon.openInspectorTransitions": "Open Inspector for full transition options",
   "pptx.ribbon.removeAnimation": "Remove Animation",
@@ -2342,6 +2355,17 @@ var translationsEn = {
   "pptx.animation.motionPath.endHandle": "Motion path end point",
   "pptx.animation.motionPath.overlay": "Motion path preview",
   "pptx.animations.motionPathGalleryAria": "Motion Paths: Lines, Arcs, Turns, Shapes, and Loops",
+  // --- Effect sound + "after animation" authoring controls ---
+  "pptx.animation.sound": "Sound",
+  "pptx.animation.sound.none": "[No Sound]",
+  "pptx.animation.sound.custom": "Choose sound file...",
+  "pptx.animation.sound.chooseFile": "Choose an audio file",
+  "pptx.animation.afterAnimation": "After animation",
+  "pptx.animation.afterAnimation.none": "Don't Dim",
+  "pptx.animation.afterAnimation.dimToColor": "Dim after animation",
+  "pptx.animation.afterAnimation.hideAfterAnimation": "Hide after animation",
+  "pptx.animation.afterAnimation.hideOnNextClick": "Hide on next mouse click",
+  "pptx.animation.afterAnimation.color": "Dim color",
   // --- 2026-07-03 missing-key sweep: keys used by Vue/Angular with no
   // existing dictionary entry (React has 0 such gaps and is the ground-
   // truth reference these were derived from). Appended flat rather than
@@ -3552,6 +3576,7 @@ var translationsEn = {
   "pptx.chart.typeArea3D": "Area (3-D)",
   "pptx.chart.typeSurface": "Surface",
   "pptx.chart.typeHistogram": "Histogram",
+  "pptx.chart.typePareto": "Pareto",
   "pptx.chart.typeFunnel": "Funnel",
   "pptx.chart.typeTreemap": "Treemap",
   "pptx.chart.typeSunburst": "Sunburst",

package/dist/i18n.js

@@ -1,19 +1,19 @@
 'use strict';
 
-var chunkU6A5FWWE_js = require('./chunk-U6A5FWWE.js');
+var chunkPIUB7R2K_js = require('./chunk-PIUB7R2K.js');
 require('./chunk-4VNS5WPM.js');
 
 
 
 Object.defineProperty(exports, "LOCALE_CATALOG", {
   enumerable: true,
-  get: function () { return chunkU6A5FWWE_js.LOCALE_CATALOG; }
+  get: function () { return chunkPIUB7R2K_js.LOCALE_CATALOG; }
 });
 Object.defineProperty(exports, "keyToLabel", {
   enumerable: true,
-  get: function () { return chunkU6A5FWWE_js.keyToLabel; }
+  get: function () { return chunkPIUB7R2K_js.keyToLabel; }
 });
 Object.defineProperty(exports, "translationsEn", {
   enumerable: true,
-  get: function () { return chunkU6A5FWWE_js.translationsEn; }
+  get: function () { return chunkPIUB7R2K_js.translationsEn; }
 });

package/dist/i18n.mjs

@@ -1,2 +1,2 @@
-export { LOCALE_CATALOG, keyToLabel, translationsEn } from './chunk-L5MNLIQF.mjs';
+export { LOCALE_CATALOG, keyToLabel, translationsEn } from './chunk-MKPSUHUH.mjs';
 import './chunk-XGB3TDIC.mjs';

package/dist/index.d.ts

@@ -1698,6 +1698,32 @@ interface TextStyle {
   textReflectionEndOpacity?: number;
   /** Text reflection offset distance in px. */
   textReflectionOffset?: number;
+  /**
+   * Text reflection fade direction (`a:rPr/a:effectLst/a:reflection/@fadeDir`)
+   * in degrees. Mirrors `ShapeStyle.reflectionFadeDirection`.
+   */
+  textReflectionFadeDirection?: number;
+  /**
+   * Text reflection horizontal scaling (`@sx`), same units as
+   * `ShapeStyle.reflectionScaleX` (1000ths of a percent, e.g. 100000 = 100%).
+   */
+  textReflectionScaleX?: number;
+  /** Text reflection vertical scaling (`@sy`). See `ShapeStyle.reflectionScaleY`. */
+  textReflectionScaleY?: number;
+  /**
+   * Text reflection horizontal skew (`@kx`) in 60000ths of a degree. See
+   * `ShapeStyle.reflectionSkewX`.
+   */
+  textReflectionSkewX?: number;
+  /** Text reflection vertical skew (`@ky`). See `ShapeStyle.reflectionSkewY`. */
+  textReflectionSkewY?: number;
+  /**
+   * Text reflection independent rotation (`@rot`) in degrees. See
+   * `ShapeStyle.reflectionRotation`.
+   */
+  textReflectionRotation?: number;
+  /** Text reflection anchor (`@algn`). See `ShapeStyle.reflectionAlignment`. */
+  textReflectionAlignment?: 'tl' | 't' | 'tr' | 'l' | 'ctr' | 'r' | 'bl' | 'b' | 'br';
   /** 3D extrusion/bevel settings on the text body. */
   text3d?: Text3DStyle;
   /** 3D scene (camera + light rig) settings on the text body (`a:bodyPr/a:scene3d`). */
@@ -5399,6 +5425,21 @@ interface ContentPartInkStroke {
    * variable-width strokes that reflect stylus/pen pressure.
    */
   pressures?: number[];
+  /**
+   * Per-point pen-tilt lean direction (radians), decoded from the source
+   * InkML's `OTx`/`OTy` tilt-offset channels or its `AZIMUTH` channel.
+   *
+   * When present (paired with {@link tiltMagnitudes}), the renderer widens
+   * each point perpendicular to the lean direction, approximating a
+   * calligraphic (chisel-tip) nib. Absent when the source declared no tilt
+   * channel, in which case rendering is unaffected.
+   */
+  tiltAngles?: number[];
+  /**
+   * Per-point pen-tilt strength (0 upright, 1 maximally leaned), paired with
+   * {@link tiltAngles}.
+   */
+  tiltMagnitudes?: number[];
 }
 /**
  * A content-part element wrapped in `mc:AlternateContent`.
@@ -5957,6 +5998,19 @@ interface PptxNativeAnimation {
   scaleZoomContents?: boolean;
   /** Parsed `p:tav` keyframes from `p:tavLst` (CT_TLAnimVariantList). */
   keyframes?: PptxAnimationKeyframe[];
+  /**
+   * The attribute {@link keyframes} drives, from the SAME node's
+   * `p:cBhvr/p:attrNameLst/p:attrName` (ECMA-376 S19.5.4). `p:tavLst` is
+   * schema-generic: without this, playback could see a numeric ramp but not
+   * know whether it targeted opacity, position, colour, or something with
+   * no CSS mapping. Lowercased and trimmed; common values seen in the wild
+   * (and written by this codebase's own animation writer) include
+   * `"style.opacity"`, `"style.color"`, `"style.visibility"`, `"fillcolor"`,
+   * `"stroke.color"`, `"r"` (rotation, only meaningful on `p:animRot`), and
+   * `"ppt_x"` / `"ppt_y"` (position, normally driven via `p:animMotion`
+   * instead). Absent when the behaviour carries no `p:attrNameLst`.
+   */
+  attrName?: string;
   /** Repeat count (e.g. `2`, `Infinity` for indefinite). */
   repeatCount?: number;
   /** Whether the animation plays in reverse after completion. */
@@ -6058,6 +6112,17 @@ interface PptxNativeAnimation {
   textTarget?: PptxTextAnimationTarget;
   /** Whether this animation is inside an exclusive container (`p:excl`). */
   exclusive?: boolean;
+  /**
+   * Identifies which `p:excl` container this animation belongs to, when
+   * {@link exclusive} is set. ECMA-376 S19.5.24 CT_TLExclusiveTimeNode: at
+   * most one direct child of an exclusive container may be active at a
+   * time, so starting one child stops any other currently-playing child of
+   * the SAME container. Two different `p:excl` containers on the same slide
+   * are independent groups; this id (assigned per container encountered
+   * during parsing, stable only within one parse's animation list) lets
+   * playback tell them apart. Absent when {@link exclusive} is unset.
+   */
+  exclGroupId?: number;
   /** Command type from `p:cmd` (@_type: call/evt/verb). */
   commandType?: string;
   /** Command string from `p:cmd` (@_cmd). */
@@ -6341,6 +6406,52 @@ interface PptxElementAnimation {
   soundPath?: string;
   /** Whether to stop any currently playing sound (`p:endSnd`). */
   stopSound?: boolean;
+  /**
+   * Pending, not-yet-embedded sound chosen in the authoring UI, as a
+   * `data:audio/...;base64,...` URL. Mirrors the `imageData` /
+   * `mediaData` pending-embed convention used elsewhere in the typed model:
+   * on save, the writer converts this to real bytes under `ppt/media/`,
+   * mints a relationship, and replaces this field with the resolved
+   * {@link soundRId} / {@link soundPath}. Cleared once embedded.
+   */
+  soundData?: string;
+  /**
+   * Display name for the chosen sound (e.g. the uploaded file's name),
+   * shown by the authoring UI's sound picker. Purely cosmetic; has no
+   * OOXML equivalent and is not required for playback.
+   */
+  soundFileName?: string;
+}
+/**
+ * A read-only anchor representing one of the deck's own effect groups: a
+ * top-level click group (`p:par` under `p:timing`'s main sequence) that this
+ * app did not author, so it is never exposed as an editable
+ * {@link PptxElementAnimation}.
+ *
+ * The authoring UI merges these anchors alongside `PptxSlide.animations` to
+ * render the FULL animation sequence (editor-authored and deck-native
+ * effects together) and lets an editor-authored entry be dragged to any
+ * position relative to them. `order` is the anchor's position among ALL
+ * top-level click groups (editor-owned and native) at load time, in the same
+ * numbering space as {@link PptxElementAnimation.order}, so the two
+ * populations sort into one coherent timeline.
+ *
+ * Anchors are never written back: on save, an untouched anchor's own click
+ * group is repositioned (if an editor-authored effect was dragged past it)
+ * but never mutated, so the deck's own effect stays byte-identical apart
+ * from its position in the sequence.
+ */
+interface PptxAnimationTimelineAnchor {
+  /**
+   * Position of this group among all top-level click groups in the main
+   * animation sequence at load time (dense, shared with editor entries'
+   * `order`).
+   */
+  order: number;
+  /** Shape id(s) this group's effects target, for a readable UI label. */
+  targetIds: string[];
+  /** Effect preset classes present in the group (entr/exit/emph/path). */
+  presetClasses: Array<'entr' | 'exit' | 'emph' | 'path'>;
 }
 //#endregion
 //#region src/core/types/embedded-font.d.ts
@@ -7044,8 +7155,19 @@ interface PptxSlideTransition {
   soundLoop?: boolean;
   /** Resolved transition sound media path within the package. */
   soundPath?: string;
-  /** Human-readable sound file name (extracted from soundPath). */
+  /** Human-readable sound file name (extracted from soundPath, or set by the
+   * UI when a new file is picked, before it has a soundPath at all). */
   soundFileName?: string;
+  /**
+   * A newly-picked local sound file awaiting embedding, as a `data:` URL.
+   * Set by the transitions ribbon's Sound picker (`applyTransitionSoundFile`
+   * in `pptx-viewer-shared`) when the user chooses a file that is not yet
+   * part of the package; mirrors `imageData`/`mediaData` on picture and media
+   * elements. The save pipeline (`embedTransitionSound`) writes the bytes to
+   * `ppt/media/`, mints a relationship, sets `soundRId`/`soundPath`, and
+   * clears this field so a later save does not re-embed the same bytes.
+   */
+  soundData?: string;
   /**
    * When true, the transition stops the currently-playing sound (OOXML `p:sndAc/p:endSnd`).
    * Mutually exclusive with `soundRId`/`soundPath` (which use `p:stSnd`).
@@ -7319,17 +7441,29 @@ interface PptxSlide {
   backgroundPattern?: PptxSlideBackgroundPattern;
   /**
    * `<p:bgPr/@shadeToTitle>`: boolean flag instructing the renderer to
-   * shade the background toward the title placeholder colour. Captured
-   * for lossless round-trip only; no renderer applies the visual effect.
-   * Documented as a known no-op in `docs/guide/limitations.md` (legacy
-   * PowerPoint 97-2003 hint, not observed in any real-world corpus file
-   * and not settable from any modern PowerPoint UI).
+   * shade the background gradient toward the title placeholder's text
+   * colour. Parsed and round-tripped here on the core model; the actual
+   * visual effect is applied by `pptx-viewer-shared`'s
+   * `getSlideBackgroundStyle` (see `render/background-shade-to-title.ts`),
+   * consumed by all five bindings, not by core itself. That module's
+   * docstring explains the approximation: no published ECMA-376 or
+   * MS-ODRAWXML text documents the exact legacy blend. Legacy PowerPoint
+   * 97-2003 hint, not observed in any real-world corpus file this project
+   * has collected and not settable from any modern PowerPoint UI; see
+   * `docs/guide/limitations.md`.
    *
    * ECMA-376 §19.3.1.2 (CT_BackgroundProperties).
    */
   backgroundShadeToTitle?: boolean;
   transition?: PptxSlideTransition;
   animations?: PptxElementAnimation[];
+  /**
+   * Read-only anchors for the deck's own (non-editor-authored) effect
+   * groups, merged with `animations` by the authoring UI so drag-to-reorder
+   * can target any position in the full sequence. See
+   * {@link PptxAnimationTimelineAnchor}.
+   */
+  animationTimelineAnchors?: PptxAnimationTimelineAnchor[];
   /** Native OOXML animation data parsed from `p:timing`. */
   nativeAnimations?: PptxNativeAnimation[];
   /** Preserved raw `p:timing` XML for lossless round-trip of native animations. */
@@ -8721,12 +8855,25 @@ interface IPptxHandlerRuntimeFactory {
  */
 /** Supported encryption algorithms. */
 type EncryptionAlgorithm = 'AES128' | 'AES256';
+/**
+ * Which OOXML encryption scheme to write when creating a password-protected
+ * file. Real PowerPoint can write and open either scheme; this library
+ * defaults to 'agile' (Office 2010+), matching PowerPoint's own default.
+ */
+type EncryptionScheme = 'agile' | 'standard';
 /** Encryption options for creating encrypted files. */
 interface EncryptionOptions {
   /** The encryption algorithm to use (defaults to AES256). */
   algorithm?: EncryptionAlgorithm;
   /** Number of hash iterations for key derivation (defaults to 100000). Lower values speed up tests. */
   spinCount?: number;
+  /**
+   * Which encryption scheme to write (defaults to 'agile'). 'standard'
+   * writes the ECMA-376 Standard scheme (Office 2007-compatible: a single
+   * password-derived AES-CBC key with a zero IV over the whole package),
+   * mirroring the scheme this library already knows how to decrypt.
+   */
+  encryptionScheme?: EncryptionScheme;
 }
 //#endregion
 //#region src/core/PptxHandlerCore.d.ts
@@ -9934,10 +10081,13 @@ declare function savedPresentationFileName(sourceName: string | null | undefined
 /**
  * Dropdown ids for the insert-chart menu. Distinct from `PptxChartType`
  * because PowerPoint offers Column (vertical) and Bar (horizontal) as two
- * entries over the same underlying `'bar'` chart type. The six ChartEx ids
- * (`histogram` through `regionMap`) map one-to-one onto their chart type.
+ * entries over the same underlying `'bar'` chart type, and because `'pareto'`
+ * has no `PptxChartType` of its own: it is a dropdown entry that resolves to
+ * `type: 'histogram'` (see docs/guide/limitations.md's ChartEx row) with a
+ * frequency-plus-cumulative-percentage default shape. The other six ChartEx
+ * ids (`histogram` through `regionMap`) map one-to-one onto their chart type.
  */
-type InsertChartKind = 'column' | 'bar' | 'line' | 'pie' | 'doughnut' | 'area' | 'scatter' | 'histogram' | 'funnel' | 'treemap' | 'sunburst' | 'boxWhisker' | 'regionMap';
+type InsertChartKind = 'column' | 'bar' | 'line' | 'pie' | 'doughnut' | 'area' | 'scatter' | 'histogram' | 'pareto' | 'funnel' | 'treemap' | 'sunburst' | 'boxWhisker' | 'regionMap';
 /** In-memory clipboard payload stored when an element is copied or cut. */
 interface ElementClipboardPayload {
   element: PptxElement;
@@ -10680,6 +10830,49 @@ interface PowerPointViewerProps {
    * to the SVG surface renderer. Default `false`.
    */
   surfaceChart3D?: boolean;
+  /**
+   * Opt in to the interactive Three.js bar3D-chart renderer. When `true`,
+   * `bar3D` charts render as camera-orbitable real box meshes (drag to
+   * rotate, scroll to zoom) instead of the flat SVG oblique-projection
+   * illusion. Chart marks are not selectable/draggable in this mode.
+   * Requires the optional `three` peer dependency; when it is not installed
+   * (or the chart has no plottable grid, or it is a horizontal 3-D Bar), the
+   * viewer transparently falls back to the flat SVG bar3D renderer. Default
+   * `false`.
+   */
+  barChart3D?: boolean;
+  /**
+   * Opt in to the interactive Three.js line3D-chart renderer. When `true`,
+   * `line3D` charts render as a camera-orbitable real tube-path mesh per
+   * series, one per depth ("series") plane (drag to rotate, scroll to zoom),
+   * instead of the flat SVG oblique-projection illusion. Chart marks are not
+   * selectable/draggable in this mode. Requires the optional `three` peer
+   * dependency; when it is not installed (or the chart has no plottable
+   * grid), the viewer transparently falls back to the flat SVG line3D
+   * renderer. Default `false`.
+   */
+  lineChart3D?: boolean;
+  /**
+   * Opt in to the interactive Three.js area3D-chart renderer. When `true`,
+   * `area3D` charts render as a camera-orbitable real tube path + filled
+   * ribbon mesh per series, one per depth ("series") plane (drag to rotate,
+   * scroll to zoom), instead of the flat SVG oblique-projection illusion.
+   * Chart marks are not selectable/draggable in this mode. Requires the
+   * optional `three` peer dependency; when it is not installed (or the chart
+   * has no plottable grid), the viewer transparently falls back to the flat
+   * SVG area3D renderer. Default `false`.
+   */
+  areaChart3D?: boolean;
+  /**
+   * Opt in to the interactive Three.js pie3D-chart renderer. When `true`,
+   * `pie3D` charts render as camera-orbitable real wedge meshes (drag to
+   * rotate, scroll to zoom) instead of the flat SVG oblique-projection
+   * illusion. Chart marks are not selectable/draggable in this mode.
+   * Requires the optional `three` peer dependency; when it is not installed
+   * (or the chart has no plottable series), the viewer transparently falls
+   * back to the flat SVG pie3D renderer. Default `false`.
+   */
+  pieChart3D?: boolean;
   /**
    * Hide individual toolbar buttons and/or ribbon tabs instead of the whole
    * toolbar. Accepts any mix of button ids (`share`, `broadcast`, `export`,