pptx-react-viewer 3.0.4 → 3.1.0

package/dist/{chunk-ROWGR6GY.mjs → chunk-VMLKJDA5.mjs}

@@ -1,6 +1,6 @@
-import { cloneHistorySnapshot, MIN_ELEMENT_SIZE, ZOOM_TO_SELECTION_PADDING, DEFAULT_CANVAS_HEIGHT, DEFAULT_CANVAS_WIDTH, UNGROUPED_SECTION_ID, DEFAULT_SECTION_GROUP_ID, DEFAULT_TABLE_ROWS, DEFAULT_TABLE_COLUMNS, executeMediaCommand, buildPdfFromImageData, buildNotesPdf, GRID_SIZE, DEFAULT_TEXT_FONT_SIZE } from './chunk-6ILXI752.mjs';
-import { translationsEn } from './chunk-L5MNLIQF.mjs';
-import { TOOLBAR_TABS, computeVirtualRange, DEFAULT_VIRTUAL_OVERSCAN, createPresenceProjector, BROADCAST_THROTTLE_MS, createSyncGate, clearLocalAwareness, validateRoomId, createDepartureChannel, resolveTransportForServerUrl, isMixedContentBlocked, CONNECTION_TIMEOUT_MS, registerCollaborationTeardown, sanitizeColor, cloneTemplateElementsBySlideId, cloneSlide, createWheelStepBuffer, createViewerZoomStore, clampZoomScale, mapEditingWheel, PresentationAnimationController, PRESENTATION_HASH, PRESENTATION_NONCE_KEY, PRESENTATION_CHANNEL_NAME, swapPresentationWindows, PRESENTATION_MESSAGE_ORIGIN, clearAudienceContent, buildPresentationAudienceUrl, resolveAudienceScreenPlacement, placeAudienceWindow, storeAudienceContent, isPresentationSessionMessage, endAudienceDisplay, createPresentationKeyBuffer, acceptsPresentationInput, resolveAutoAdvanceDelayMs, hasShowSlideAfter, nextShowSlideIndex, previousShowSlideIndex, createPresenterShowGuard, attachPresentationVisibilityPause, buildMorphTransitionPlan, morphOptionToMode, buildMorphAnimationRules, findInSlides, applyFindReplacements, createCollaborationLivePatcher, publishLiveInlineText, PptxHandler, collectMediaElements, collectImagePaths, collectTableCellImagePaths, applyTableCellImagePatches, collectTableStyleImagePaths, applyTableStyleImagePatches, partitionTemplateElements, resolveAuthoredCustomShowId, buildInitialGuides, EncryptedFileError, resolveAutosaveIntervalMs, shouldWriteAutosaveSnapshot, saveAutosaveSnapshot, autosaveSnapshotMark, updateMasterViewElement, isTemplateElementId, hasShapeProperties, hasTextProperties, getInlineEditorSelection, applyStyleToSelectedSegments, setPendingSelectionRestore, applyCaseTransformToSegments, transformTextCase, masterViewElements, replaceMasterViewElements, addSection, renameSection, deleteSection, moveSectionUp, moveSectionDown, moveSlidesToSection, normalizeColorsForCapture, preprocessCssForCapture, slideProgressPercent, slideStatusLabel, EXPORT_ASSEMBLING_PERCENT, EXPORT_DONE_PERCENT, isExportAbortError, recordProgressPercent, downloadBlob, applyThemeToData, THEME_PRESETS, themeColorSchemesEqual, comparePresentation, applyAcceptSlide, applyAcceptAllSlides, collectUsedFonts, describeFontEmbedding, isMobileViewport, mayLeaveSlideShow, stopAllPersistentAudio, remapTextToSegments, guidePxToEmu, buildSaveSlides, embeddedFontSaveOptions, resolveSlideSizeSelection, saveDeckWithPassword, shouldProbeAutosaveRecovery, probeAutosaveRecovery, acceptAutosaveRecovery, discardAutosaveRecovery, shouldLoopContinuously, applyRehearsalTimings, copyFormatFromElement, applyFormatToElement, mapEditorKey, isEditorTextInputTarget, createViewerOptionsStore, readSlidesFromYDoc, shouldRoomSlidesReplaceLoad, reconcileSlidesInYDoc, LOCAL_SYNC_ORIGIN, observeYDocSlides, shouldAutoFollowBroadcaster, detectTouchDevice, detectOrientation, deriveViewportBreakpoints, createTouchGestureRecognizer, MAX_ZOOM_SCALE, MIN_ZOOM_SCALE, isKeyboardOpen, scopeLayoutOptionsToSlide, openPptxFile, readBackstageRecentFile, isActionHidden, resolveInlineEditAutoFitHeight, canInteractWithElement, filterInteractableIds, beginShapeAdjustment, buildElementClipboardPayload, savedPresentationFileName, generatePackageReadme, presentationBaseName, exportDeckJson, groupElements, generateElementId, makeCloneId, ungroupElements, alignElements, distributeElements, bringForward, sendBackward, bringToFront, sendToBack, newTableElement, createDefaultChartElement, readViewportMetrics, computeKeyboardInset, mergeShapes, mapPresentationKey, lastShowSlideIndex, firstShowSlideIndex, mapPresentationWheel, computeColorFilter, computeSlideIndices, buildPrintDocument, buildOutlineHtml, buildSlidesHtml, buildNotesHtml, buildHandoutsHtml, createBlankSlide, makeSlideId, buildSlideTemplateSlide, templateSchemeFromTheme, buildThemeColorMap, reResolveSlideColors, computeEntranceAnimationDelay, createPresentationSessionId, resolveTransitionDurationMs, runPresentationAction, createPresenterTimer, createInitialPresentationSnapshot, mergePresentationSnapshot, resetPresenterTimer, presenterElapsed, stepPresenterZoom, togglePresenterTimer, addCommentToList, removeCommentFromList, editCommentInList, toggleCommentResolvedInList, replyToCommentInList, canvasToJpegData, downloadDataUrl, pickSupportedMimeType, WEBM_MIME_CANDIDATES, fpsToFrameIntervalMs, segmentFrameCount, encodeGif, computeGridSpacingPx, resolveShowSlideIndexes, groupSlidesBySection, masterViewPseudoSlide, hasCopyableFormat, createBackstagePresentation, buildFieldSubstitutionContext, cloneElementForPaste, computeScrollDelta, getPresetShapeClipPath, svgPathToPolygons, polygonsToSvgPath, rerouteConnectorsForMovedElements, applyReroutedConnectors, SvgExporter, buildPrintHtmlDocument, deleteTableColumn, rebuildTableStructureInRawXml, insertTableColumn, deleteTableRow, insertTableRow, updateCellTextStyleInRawXml, setCellText, updateCellTextInRawXml, splitCell, updateMergeAttrsInRawXml, mergeCells, isPpactionUrl, parsePpactionUrl, safeOpenUrl, ACTION_BUTTON_PRESETS, elementActionToPptxAction, isUrlSafe, buildSmartArtPresetData, classifyMediaType, computeSnapToShape, publishLiveGeometry, getDraggedShapeAdjustments, computeMarqueeHitIds, mergeAdditiveSelection, applyResize, snapBoxToGrid, applyMotionPathPreset } from './chunk-V7ZLEZ5W.mjs';
+import { cloneHistorySnapshot, MIN_ELEMENT_SIZE, ZOOM_TO_SELECTION_PADDING, DEFAULT_CANVAS_HEIGHT, DEFAULT_CANVAS_WIDTH, UNGROUPED_SECTION_ID, DEFAULT_SECTION_GROUP_ID, DEFAULT_TABLE_ROWS, DEFAULT_TABLE_COLUMNS, executeMediaCommand, buildPdfFromImageData, buildNotesPdf, GRID_SIZE, DEFAULT_TEXT_FONT_SIZE } from './chunk-SNWAM2XJ.mjs';
+import { translationsEn } from './chunk-MKPSUHUH.mjs';
+import { TOOLBAR_TABS, computeVirtualRange, DEFAULT_VIRTUAL_OVERSCAN, createPresenceProjector, BROADCAST_THROTTLE_MS, createSyncGate, clearLocalAwareness, validateRoomId, createDepartureChannel, resolveTransportForServerUrl, isMixedContentBlocked, CONNECTION_TIMEOUT_MS, registerCollaborationTeardown, sanitizeColor, cloneTemplateElementsBySlideId, cloneSlide, createWheelStepBuffer, createViewerZoomStore, clampZoomScale, mapEditingWheel, PresentationAnimationController, PRESENTATION_HASH, PRESENTATION_NONCE_KEY, PRESENTATION_CHANNEL_NAME, swapPresentationWindows, PRESENTATION_MESSAGE_ORIGIN, clearAudienceContent, buildPresentationAudienceUrl, resolveAudienceScreenPlacement, placeAudienceWindow, storeAudienceContent, isPresentationSessionMessage, endAudienceDisplay, createPresentationKeyBuffer, acceptsPresentationInput, resolveAutoAdvanceDelayMs, hasShowSlideAfter, nextShowSlideIndex, previousShowSlideIndex, createPresenterShowGuard, attachPresentationVisibilityPause, buildMorphTransitionPlan, morphOptionToMode, buildMorphAnimationRules, findInSlides, applyFindReplacements, createCollaborationLivePatcher, publishLiveInlineText, PptxHandler, collectMediaElements, collectImagePaths, collectTableCellImagePaths, applyTableCellImagePatches, collectTableStyleImagePaths, applyTableStyleImagePatches, partitionTemplateElements, resolveAuthoredCustomShowId, buildInitialGuides, EncryptedFileError, resolveAutosaveIntervalMs, shouldWriteAutosaveSnapshot, saveAutosaveSnapshot, autosaveSnapshotMark, updateMasterViewElement, isTemplateElementId, hasShapeProperties, hasTextProperties, getInlineEditorSelection, applyStyleToSelectedSegments, setPendingSelectionRestore, applyCaseTransformToSegments, transformTextCase, masterViewElements, replaceMasterViewElements, addSection, renameSection, deleteSection, moveSectionUp, moveSectionDown, moveSlidesToSection, normalizeColorsForCapture, preprocessCssForCapture, slideProgressPercent, slideStatusLabel, EXPORT_ASSEMBLING_PERCENT, EXPORT_DONE_PERCENT, isExportAbortError, recordProgressPercent, downloadBlob, applyThemeToData, THEME_PRESETS, themeColorSchemesEqual, comparePresentation, applyAcceptSlide, applyAcceptAllSlides, collectUsedFonts, describeFontEmbedding, isMobileViewport, mayLeaveSlideShow, stopAllPersistentAudio, remapTextToSegments, guidePxToEmu, buildSaveSlides, embeddedFontSaveOptions, resolveSlideSizeSelection, saveDeckWithPassword, shouldProbeAutosaveRecovery, probeAutosaveRecovery, acceptAutosaveRecovery, discardAutosaveRecovery, shouldLoopContinuously, applyRehearsalTimings, copyFormatFromElement, applyFormatToElement, mapEditorKey, isEditorTextInputTarget, createViewerOptionsStore, readSlidesFromYDoc, shouldRoomSlidesReplaceLoad, reconcileSlidesInYDoc, LOCAL_SYNC_ORIGIN, observeYDocSlides, shouldAutoFollowBroadcaster, detectTouchDevice, detectOrientation, deriveViewportBreakpoints, createTouchGestureRecognizer, MAX_ZOOM_SCALE, MIN_ZOOM_SCALE, isKeyboardOpen, scopeLayoutOptionsToSlide, openPptxFile, readBackstageRecentFile, isActionHidden, resolveInlineEditAutoFitHeight, canInteractWithElement, filterInteractableIds, beginShapeAdjustment, buildElementClipboardPayload, savedPresentationFileName, generatePackageReadme, presentationBaseName, exportDeckJson, groupElements, generateElementId, makeCloneId, ungroupElements, alignElements, distributeElements, bringForward, sendBackward, bringToFront, sendToBack, newTableElement, createDefaultChartElement, readViewportMetrics, computeKeyboardInset, mergeShapes, mapPresentationKey, lastShowSlideIndex, firstShowSlideIndex, mapPresentationWheel, computeColorFilter, computeSlideIndices, buildPrintDocument, buildOutlineHtml, buildSlidesHtml, buildNotesHtml, buildHandoutsHtml, createBlankSlide, makeSlideId, buildSlideTemplateSlide, templateSchemeFromTheme, buildThemeColorMap, reResolveSlideColors, computeEntranceAnimationDelay, createPresentationSessionId, resolveTransitionDurationMs, runPresentationAction, createPresenterTimer, createInitialPresentationSnapshot, mergePresentationSnapshot, resetPresenterTimer, presenterElapsed, stepPresenterZoom, togglePresenterTimer, addCommentToList, removeCommentFromList, editCommentInList, toggleCommentResolvedInList, replyToCommentInList, canvasToJpegData, downloadDataUrl, pickSupportedMimeType, WEBM_MIME_CANDIDATES, fpsToFrameIntervalMs, segmentFrameCount, encodeGif, computeGridSpacingPx, resolveShowSlideIndexes, groupSlidesBySection, masterViewPseudoSlide, hasCopyableFormat, createBackstagePresentation, buildFieldSubstitutionContext, cloneElementForPaste, computeScrollDelta, getPresetShapeClipPath, svgPathToPolygons, polygonsToSvgPath, rerouteConnectorsForMovedElements, applyReroutedConnectors, SvgExporter, buildPrintHtmlDocument, deleteTableColumn, rebuildTableStructureInRawXml, insertTableColumn, deleteTableRow, insertTableRow, updateCellTextStyleInRawXml, setCellText, updateCellTextInRawXml, splitCell, updateMergeAttrsInRawXml, mergeCells, isPpactionUrl, parsePpactionUrl, safeOpenUrl, ACTION_BUTTON_PRESETS, elementActionToPptxAction, isUrlSafe, buildSmartArtPresetData, classifyMediaType, computeSnapToShape, publishLiveGeometry, getDraggedShapeAdjustments, computeMarqueeHitIds, mergeAdditiveSelection, applyResize, snapBoxToGrid, applyMotionPathPreset } from './chunk-BP2L2KOZ.mjs';
 import { useRef, useState, useEffect, useCallback, useMemo, useLayoutEffect, useImperativeHandle, useSyncExternalStore } from 'react';
 import JSZip from 'jszip';
 import { useTranslation } from 'react-i18next';

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

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunk7HPI5HBA_js = require('./chunk-7HPI5HBA.js');
+var chunkT7BAPZBY_js = require('./chunk-T7BAPZBY.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 chunkT7BAPZBY_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(chunkT7BAPZBY_js.ThemePresets)
   };
 };
 var readExecutors = {

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`,

package/dist/index.js

@@ -1,176 +1,176 @@
 'use strict';
 
-var chunkAX4JM6TW_js = require('./chunk-AX4JM6TW.js');
-require('./chunk-5IYGA2HX.js');
-var chunkXURJHY6K_js = require('./chunk-XURJHY6K.js');
-var chunkZ4F5BCQB_js = require('./chunk-Z4F5BCQB.js');
-var chunkU6A5FWWE_js = require('./chunk-U6A5FWWE.js');
-var chunk7HPI5HBA_js = require('./chunk-7HPI5HBA.js');
+var chunkA5EUD6UU_js = require('./chunk-A5EUD6UU.js');
+require('./chunk-VQVC27WL.js');
+var chunkPOAZ53L5_js = require('./chunk-POAZ53L5.js');
+var chunk7JZLE56X_js = require('./chunk-7JZLE56X.js');
+var chunkPIUB7R2K_js = require('./chunk-PIUB7R2K.js');
+var chunkT7BAPZBY_js = require('./chunk-T7BAPZBY.js');
 require('./chunk-4VNS5WPM.js');
 
 
 
 Object.defineProperty(exports, "PowerPointViewer", {
   enumerable: true,
-  get: function () { return chunkAX4JM6TW_js.PowerPointViewer; }
+  get: function () { return chunkA5EUD6UU_js.PowerPointViewer; }
 });
 Object.defineProperty(exports, "SlideCanvas", {
   enumerable: true,
-  get: function () { return chunkAX4JM6TW_js.SlideCanvas; }
+  get: function () { return chunkA5EUD6UU_js.SlideCanvas; }
 });
 Object.defineProperty(exports, "SlideTemplateGalleryDialog", {
   enumerable: true,
-  get: function () { return chunkAX4JM6TW_js.SlideTemplateGalleryDialog; }
+  get: function () { return chunkA5EUD6UU_js.SlideTemplateGalleryDialog; }
 });
 Object.defineProperty(exports, "SlideTemplatePreview", {
   enumerable: true,
-  get: function () { return chunkAX4JM6TW_js.SlideTemplatePreview; }
+  get: function () { return chunkA5EUD6UU_js.SlideTemplatePreview; }
 });
 Object.defineProperty(exports, "Toolbar", {
   enumerable: true,
-  get: function () { return chunkAX4JM6TW_js.Toolbar; }
+  get: function () { return chunkA5EUD6UU_js.Toolbar; }
 });
 Object.defineProperty(exports, "ViewerThemeProvider", {
   enumerable: true,
-  get: function () { return chunkAX4JM6TW_js.ViewerThemeProvider; }
+  get: function () { return chunkA5EUD6UU_js.ViewerThemeProvider; }
 });
 Object.defineProperty(exports, "useViewerTheme", {
   enumerable: true,
-  get: function () { return chunkAX4JM6TW_js.useViewerTheme; }
+  get: function () { return chunkA5EUD6UU_js.useViewerTheme; }
 });
 Object.defineProperty(exports, "renderToCanvas", {
   enumerable: true,
-  get: function () { return chunkXURJHY6K_js.renderToCanvas; }
+  get: function () { return chunkPOAZ53L5_js.renderToCanvas; }
 });
 Object.defineProperty(exports, "useViewerBuildingBlocks", {
   enumerable: true,
-  get: function () { return chunkXURJHY6K_js.useViewerBuildingBlocks; }
+  get: function () { return chunkPOAZ53L5_js.useViewerBuildingBlocks; }
 });
 Object.defineProperty(exports, "getAnimationInitialStyle", {
   enumerable: true,
-  get: function () { return chunkZ4F5BCQB_js.getAnimationInitialStyle; }
+  get: function () { return chunk7JZLE56X_js.getAnimationInitialStyle; }
 });
 Object.defineProperty(exports, "LOCALE_CATALOG", {
   enumerable: true,
-  get: function () { return chunkU6A5FWWE_js.LOCALE_CATALOG; }
+  get: function () { return chunkPIUB7R2K_js.LOCALE_CATALOG; }
 });
 Object.defineProperty(exports, "AVATAR_COLOR_SWATCHES", {
   enumerable: true,
-  get: function () { return chunk7HPI5HBA_js.AVATAR_COLOR_SWATCHES; }
+  get: function () { return chunkT7BAPZBY_js.AVATAR_COLOR_SWATCHES; }
 });
 Object.defineProperty(exports, "DEFAULT_VIEWER_PROFILE", {
   enumerable: true,
-  get: function () { return chunk7HPI5HBA_js.DEFAULT_VIEWER_PROFILE; }
+  get: function () { return chunkT7BAPZBY_js.DEFAULT_VIEWER_PROFILE; }
 });
 Object.defineProperty(exports, "PPTX_OPEN_ACCEPT", {
   enumerable: true,
-  get: function () { return chunk7HPI5HBA_js.PPTX_OPEN_ACCEPT; }
+  get: function () { return chunkT7BAPZBY_js.PPTX_OPEN_ACCEPT; }
 });
 Object.defineProperty(exports, "PRESENTATION_OPEN_EXTENSIONS", {
   enumerable: true,
-  get: function () { return chunk7HPI5HBA_js.PRESENTATION_OPEN_EXTENSIONS; }
+  get: function () { return chunkT7BAPZBY_js.PRESENTATION_OPEN_EXTENSIONS; }
 });
 Object.defineProperty(exports, "SLIDE_TEMPLATES", {
   enumerable: true,
-  get: function () { return chunk7HPI5HBA_js.SLIDE_TEMPLATES; }
+  get: function () { return chunkT7BAPZBY_js.SLIDE_TEMPLATES; }
 });
 Object.defineProperty(exports, "THEME_CATALOG", {
   enumerable: true,
-  get: function () { return chunk7HPI5HBA_js.THEME_CATALOG; }
+  get: function () { return chunkT7BAPZBY_js.THEME_CATALOG; }
 });
 Object.defineProperty(exports, "VIEWER_PREFS_STORAGE_KEY", {
   enumerable: true,
-  get: function () { return chunk7HPI5HBA_js.VIEWER_PREFS_STORAGE_KEY; }
+  get: function () { return chunkT7BAPZBY_js.VIEWER_PREFS_STORAGE_KEY; }
 });
 Object.defineProperty(exports, "buildSlideTemplateContent", {
   enumerable: true,
-  get: function () { return chunk7HPI5HBA_js.buildSlideTemplateContent; }
+  get: function () { return chunkT7BAPZBY_js.buildSlideTemplateContent; }
 });
 Object.defineProperty(exports, "buildSlideTemplateSlide", {
   enumerable: true,
-  get: function () { return chunk7HPI5HBA_js.buildSlideTemplateSlide; }
+  get: function () { return chunkT7BAPZBY_js.buildSlideTemplateSlide; }
 });
 Object.defineProperty(exports, "clearAllLocalViewerData", {
   enumerable: true,
-  get: function () { return chunk7HPI5HBA_js.clearAllLocalViewerData; }
+  get: function () { return chunkT7BAPZBY_js.clearAllLocalViewerData; }
 });
 Object.defineProperty(exports, "clearStoredViewerPrefs", {
   enumerable: true,
-  get: function () { return chunk7HPI5HBA_js.clearStoredViewerPrefs; }
+  get: function () { return chunkT7BAPZBY_js.clearStoredViewerPrefs; }
 });
 Object.defineProperty(exports, "defaultCssVars", {
   enumerable: true,
-  get: function () { return chunk7HPI5HBA_js.defaultCssVars; }
+  get: function () { return chunkT7BAPZBY_js.defaultCssVars; }
 });
 Object.defineProperty(exports, "defaultRadius", {
   enumerable: true,
-  get: function () { return chunk7HPI5HBA_js.defaultRadius; }
+  get: function () { return chunkT7BAPZBY_js.defaultRadius; }
 });
 Object.defineProperty(exports, "defaultThemeColors", {
   enumerable: true,
-  get: function () { return chunk7HPI5HBA_js.defaultThemeColors; }
+  get: function () { return chunkT7BAPZBY_js.defaultThemeColors; }
 });
 Object.defineProperty(exports, "getLocalStorageUsageSummary", {
   enumerable: true,
-  get: function () { return chunk7HPI5HBA_js.getLocalStorageUsageSummary; }
+  get: function () { return chunkT7BAPZBY_js.getLocalStorageUsageSummary; }
 });
 Object.defineProperty(exports, "isLegacyBinaryPresentation", {
   enumerable: true,
-  get: function () { return chunk7HPI5HBA_js.isLegacyBinaryPresentation; }
+  get: function () { return chunkT7BAPZBY_js.isLegacyBinaryPresentation; }
 });
 Object.defineProperty(exports, "isSupportedPresentationFile", {
   enumerable: true,
-  get: function () { return chunk7HPI5HBA_js.isSupportedPresentationFile; }
+  get: function () { return chunkT7BAPZBY_js.isSupportedPresentationFile; }
 });
 Object.defineProperty(exports, "presentationBaseName", {
   enumerable: true,
-  get: function () { return chunk7HPI5HBA_js.presentationBaseName; }
+  get: function () { return chunkT7BAPZBY_js.presentationBaseName; }
 });
 Object.defineProperty(exports, "readStoredViewerPrefs", {
   enumerable: true,
-  get: function () { return chunk7HPI5HBA_js.readStoredViewerPrefs; }
+  get: function () { return chunkT7BAPZBY_js.readStoredViewerPrefs; }
 });
 Object.defineProperty(exports, "resolveProfileInitial", {
   enumerable: true,
-  get: function () { return chunk7HPI5HBA_js.resolveProfileInitial; }
+  get: function () { return chunkT7BAPZBY_js.resolveProfileInitial; }
 });
 Object.defineProperty(exports, "resolveThemeCatalogEntry", {
   enumerable: true,
-  get: function () { return chunk7HPI5HBA_js.resolveThemeCatalogEntry; }
+  get: function () { return chunkT7BAPZBY_js.resolveThemeCatalogEntry; }
 });
 Object.defineProperty(exports, "saveViewerProfile", {
   enumerable: true,
-  get: function () { return chunk7HPI5HBA_js.saveViewerProfile; }
+  get: function () { return chunkT7BAPZBY_js.saveViewerProfile; }
 });
 Object.defineProperty(exports, "savedPresentationFileName", {
   enumerable: true,
-  get: function () { return chunk7HPI5HBA_js.savedPresentationFileName; }
+  get: function () { return chunkT7BAPZBY_js.savedPresentationFileName; }
 });
 Object.defineProperty(exports, "themeToCssVars", {
   enumerable: true,
-  get: function () { return chunk7HPI5HBA_js.themeToCssVars; }
+  get: function () { return chunkT7BAPZBY_js.themeToCssVars; }
 });
 Object.defineProperty(exports, "vermilionDarkColors", {
   enumerable: true,
-  get: function () { return chunk7HPI5HBA_js.vermilionDarkColors; }
+  get: function () { return chunkT7BAPZBY_js.vermilionDarkColors; }
 });
 Object.defineProperty(exports, "vermilionDarkTheme", {
   enumerable: true,
-  get: function () { return chunk7HPI5HBA_js.vermilionDarkTheme; }
+  get: function () { return chunkT7BAPZBY_js.vermilionDarkTheme; }
 });
 Object.defineProperty(exports, "vermilionLightColors", {
   enumerable: true,
-  get: function () { return chunk7HPI5HBA_js.vermilionLightColors; }
+  get: function () { return chunkT7BAPZBY_js.vermilionLightColors; }
 });
 Object.defineProperty(exports, "vermilionLightTheme", {
   enumerable: true,
-  get: function () { return chunk7HPI5HBA_js.vermilionLightTheme; }
+  get: function () { return chunkT7BAPZBY_js.vermilionLightTheme; }
 });
 Object.defineProperty(exports, "vermilionRadius", {
   enumerable: true,
-  get: function () { return chunk7HPI5HBA_js.vermilionRadius; }
+  get: function () { return chunkT7BAPZBY_js.vermilionRadius; }
 });
 Object.defineProperty(exports, "writeStoredViewerPrefs", {
   enumerable: true,
-  get: function () { return chunk7HPI5HBA_js.writeStoredViewerPrefs; }
+  get: function () { return chunkT7BAPZBY_js.writeStoredViewerPrefs; }
 });