pptx-vue-viewer 4.2.0 → 4.3.0

package/dist/internals.d.ts

@@ -260,6 +260,11 @@ export declare interface AnimationClickGroup {
 declare interface AnimationCondition {
     /** Event that triggers the condition. */
     event?: AnimationConditionEvent;
+    /**
+     * The media element/bookmark this condition fires for, when
+     * {@link event} is `onMediaBookmark`. See {@link PptxMediaBookmarkTarget}.
+     */
+    bookmarkTarget?: PptxMediaBookmarkTarget;
     /** Delay in milliseconds (from `@_delay`). "indefinite" is represented as -1. */
     delay?: number;
     /** Target time node ID reference (from `@_tn`). */
@@ -278,7 +283,7 @@ declare interface AnimationCondition {
  * These map directly to OOXML condition event attribute values
  * (ISO/IEC 29500-1 S19.5.28 CT_TLTimeCondition).
  */
-declare type AnimationConditionEvent = 'onBegin' | 'onEnd' | 'begin' | 'end' | 'onClick' | 'onMouseOver' | 'onMouseOut' | 'onNext' | 'onPrev' | 'onStopAudio' | 'onDblClick';
+declare type AnimationConditionEvent = 'onBegin' | 'onEnd' | 'begin' | 'end' | 'onClick' | 'onMouseOver' | 'onMouseOut' | 'onNext' | 'onPrev' | 'onStopAudio' | 'onDblClick' | 'onMediaBookmark';
 
 declare interface AnimationInput {
     preset: PptxAnimationPreset;
@@ -481,6 +486,18 @@ declare interface BulletInfo {
     /** When true, `<a:buSzTx/>` was specified — inherit the bullet size from
      *  the run text font size. */
     sizeInherit?: boolean;
+    /**
+     * True when this bullet resolution came from the paragraph's OWN `a:pPr`
+     * rather than the shape's `a:lstStyle`, an inherited placeholder, or the
+     * master's `a:defPPr` / `p:txStyles`. `resolveParagraphBulletInfo` walks
+     * that cascade and returns the first match, so without this flag a
+     * writer that re-emits every resolved `BulletInfo` in full pins an
+     * inherited bullet (e.g. a master `buFont="Arial"` / `buChar="•"`) onto
+     * every paragraph's own `a:pPr` the moment the slide is rewritten. The
+     * save path only writes the bullet group when this is `true`, mirroring
+     * how `paragraphProperties` gates every other per-paragraph field.
+     */
+    ownedByParagraph?: boolean;
 }
 
 /** Canvas dimensions in pixels. */
@@ -1025,6 +1042,20 @@ declare interface ContentPartInkStroke {
      * NAMES differ.
      */
     tiltEncoding?: 'vector' | 'azimuthAltitude';
+    /**
+     * Per-point timestamps (milliseconds), decoded from the source InkML
+     * trace's `T` channel when it declared one.
+     *
+     * Absent for the overwhelming majority of real decks: PowerPoint's own
+     * SaveAs output declares only `X`/`Y` and has no per-point time channel at
+     * all (see `contentpart-real-ink-roundtrip.test.ts`'s fixture), so this is
+     * populated only for InkML sources that genuinely author one (a captured
+     * digitizer session, OneNote, a Surface Hub export). When present, ink
+     * replay ("watch the ink get drawn") uses each stroke's own first/last
+     * timestamp to time its reveal instead of the fixed per-stroke cascade; see
+     * `pptx-viewer-shared`'s `render/ink-replay-timeline.ts`.
+     */
+    pointTimestamps?: number[];
 }
 
 /**
@@ -1426,6 +1457,9 @@ export declare interface EditorHistoryResult {
     setMaxDepth: (depth: number) => void;
 }
 
+/** A logical editor command produced by one key press. */
+declare type EditorKeyActionName = 'undo' | 'redo' | 'copy' | 'cut' | 'paste' | 'duplicate' | 'delete' | 'selectAll' | 'group' | 'ungroup' | 'nudge' | 'prevSlide' | 'nextSlide' | 'escape' | 'find' | 'findReplace' | 'toggleShortcuts' | 'alignLeft' | 'alignCenter' | 'alignRight' | 'alignJustify' | 'increaseFontSize' | 'decreaseFontSize' | 'copyFormat' | 'pasteFormat' | 'newSlide' | 'hyperlink' | 'clearFormatting' | 'cycleSelectionNext' | 'cycleSelectionPrev';
+
 export declare interface EditorOperations {
     /** Resolved active slide (or `undefined` when the index is out of range). */
     activeSlide: ComputedRef<PptxSlide | undefined>;
@@ -3261,6 +3295,14 @@ declare interface ParsedTableStyleFill {
     tint?: number;
     /** Shade value (0-100 000). */
     shade?: number;
+    /**
+     * Alpha (opacity) value (0-100 000, where 100 000 is fully opaque) from an
+     * `a:alpha` child of `a:schemeClr`/`a:srgbClr`. Several built-in table
+     * styles (e.g. "Light Style 1/3", "Themed Style 1/2") band their rows with
+     * a partially transparent tint of the theme colour rather than a tint/shade
+     * blend.
+     */
+    alpha?: number;
     /** Explicit sRGB hex colour (e.g. `#FF8800`) from `a:srgbClr`. */
     color?: string;
     /** The fill was `a:noFill`: renders transparent and clears lower layers. */
@@ -3460,6 +3502,24 @@ declare interface PicturePptxElement extends PptxElementBase, PptxShapePropertie
  */
 declare interface PlaceholderTextLevelStyle {
     fontFamily?: string;
+    /**
+     * The RAW `a:defRPr/a:latin/@typeface` string (verbatim: a theme alias
+     * such as `+mj-lt`/`+mn-lt`, or a literal face name) {@link fontFamily}
+     * was resolved from. Master/layout text styles are parsed once and
+     * cached, so `fontFamily` is a resolved-for-display snapshot; re-emitting
+     * it as the literal name on every save (the master-level analogue of
+     * `colorChoiceXml` below) flattens the theme alias the moment ANYTHING
+     * about the deck is rewritten, even when this level was never touched.
+     * Absent when the level declares no `a:latin`.
+     */
+    fontTypefaceXml?: string;
+    /**
+     * Snapshot of {@link fontFamily} exactly as parsed, before any edit. The
+     * save path diffs the live value against this: unchanged means re-emit
+     * {@link fontTypefaceXml} verbatim (preserve the alias); different means
+     * a genuine edit, so the new literal name is written instead.
+     */
+    resolvedFontFamily?: string;
     fontSize?: number;
     bold?: boolean;
     italic?: boolean;
@@ -3509,8 +3569,32 @@ declare interface PlaceholderTextLevelStyle {
     tabStops?: TextStyle['tabStops'];
     lineSpacing?: number;
     lineSpacingExactPt?: number;
+    /**
+     * Space before the paragraph in px, resolved from EITHER `a:spcPts`
+     * (absolute) or `a:spcPct` (a percentage of this level's own `a:defRPr`
+     * font size) - the OOXML source is not distinguishable from this field
+     * alone. See {@link spaceBeforePercent} / {@link resolvedSpaceBefore}.
+     */
     spaceBefore?: number;
     spaceAfter?: number;
+    /**
+     * Snapshot of {@link spaceBefore} / {@link spaceAfter} exactly as parsed.
+     * Diffed the same way as {@link resolvedFontFamily}: unchanged means the
+     * writer re-emits the ORIGINAL form (`a:spcPct` when
+     * {@link spaceBeforePercent} / {@link spaceAfterPercent} is set); a value
+     * that has since moved away from the snapshot is a genuine edit and is
+     * always written as `a:spcPts`, since an editor works in absolute units.
+     */
+    resolvedSpaceBefore?: number;
+    resolvedSpaceAfter?: number;
+    /**
+     * The raw `a:spcPct` fraction (e.g. `0.2` for 20%) {@link spaceBefore} /
+     * {@link spaceAfter} was resolved from, when the source used percentage
+     * spacing rather than `a:spcPts`. Absent when the source used `a:spcPts`
+     * (or authored no spacing at all).
+     */
+    spaceBeforePercent?: number;
+    spaceAfterPercent?: number;
     /** Default tab interval in CSS pixels (`a:lvlXpPr/@defTabSz`). */
     defaultTabSize?: number;
     /** Whether East Asian line-breaking rules are enabled. */
@@ -4060,6 +4144,17 @@ declare interface PptxAttributeAnimation {
      * IS consulted regardless of this field's value. Absent means `lin`.
      */
     calcMode?: 'discrete' | 'lin' | 'fmla';
+    /**
+     * `p:anim/@_p14:bounceEnd` (Office 2010 `p14` extension attribute,
+     * MS-OI29500), normalized to a 0-1 fraction of this behaviour's own
+     * duration. PowerPoint's Fly In "Bounce End" effect option writes this on
+     * the position-ramp `p:anim` node(s): the fraction of the duration at
+     * which the primary travel completes, with the remainder spent bouncing
+     * and settling at the final value. Mirrored verbatim by PowerPoint onto
+     * the enclosing `p:cTn/@_p14:presetBounceEnd`. Absent for every animation
+     * that doesn't use this effect option (the overwhelming majority).
+     */
+    bounceEnd?: number;
 }
 
 declare interface PptxAudioCdPosition {
@@ -7730,7 +7825,12 @@ declare interface PptxHeaderFooter {
     hasDateTime?: boolean;
     dateTimeText?: string;
     dateTimeAuto?: boolean;
-    /** OOXML date format pattern (e.g. "M/d/yyyy", "dddd, MMMM dd, yyyy"). */
+    /**
+     * The master date placeholder's own `a:fld/@type` (e.g. "datetime2"), NOT a
+     * format pattern. It is one of the predefined OOXML datetime field types
+     * (`datetime1`-`datetime13`); the display pattern for each is resolved by
+     * `resolveFieldDateText` in `packages/shared/src/render/text-field-substitution.ts`.
+     */
     dateFormat?: string;
     hasSlideNumber?: boolean;
 }
@@ -8231,6 +8331,19 @@ declare interface PptxMasterTextStyles {
     otherStyle?: PptxTextStyleLevels;
 }
 
+/**
+ * `p14:bmkTgt` (Office 2010 `p14` extension, MS-OI29500): names the specific
+ * media element and bookmark an `evt="onMediaBookmark"` condition fires for.
+ * `bookmarkName` matches a `p14:bmk/@_name` on that media element's own
+ * `p14:bmkLst` (see `MediaBookmark.label` in `core/types/elements.ts`).
+ */
+declare interface PptxMediaBookmarkTarget {
+    /** `p14:bmkTgt/@_spid`: the media element's shape id. */
+    shapeId: string;
+    /** `p14:bmkTgt/@_bmkName`: the bookmark's name. */
+    bookmarkName: string;
+}
+
 declare type PptxMediaReferenceKind = 'audioCd' | 'wavAudioFile' | 'audioFile' | 'videoFile' | 'quickTimeFile';
 
 /**
@@ -10030,6 +10143,18 @@ declare interface PptxSmartArtLayoutDefinition {
     rootNode: PptxSmartArtLayoutNode;
     /** Original definition retained for constraint evaluation and foreign rules. */
     rawXml?: XmlObject;
+    /**
+     * The un-parsed layout-definition part text (starting at `<dgm:layoutDef>`,
+     * XML declaration included). `rawXml` above loses the document order of
+     * differently-named siblings (the package-wide `fast-xml-parser`
+     * configuration groups children into one array per tag), which the
+     * per-point DiagramML engine (`core/utils/smartart-engine/`) needs to
+     * execute a `layoutNode` body's `forEach`/`choose`/`constrLst` statements
+     * in their real declared sequence - see that package's `ordered-xml.ts`.
+     * `undefined` when the part could not be read (matches `rawXml`'s own
+     * optionality); the engine falls back to the legacy interpreter then.
+     */
+    rawXmlText?: string;
 }
 
 /** Identity and ordering metadata from DiagramML CT_LayoutNode. */
@@ -10997,6 +11122,20 @@ declare interface PptxTableData {
      * present when there is at least one effect.
      */
     tableEffects?: ParsedTableStyleEffect[];
+    /**
+     * Table-cell-context default text size in points, resolved from the
+     * slide's master `p:otherStyle` (ECMA-376 §19.3.1.42 CT_TextListStyle,
+     * §19.3.1.52 for `p:txStyles`). PowerPoint sizes a table cell's text off
+     * this master default (commonly 18pt) whenever neither the run nor the
+     * (size-less) table style provides one; without it, cell text without an
+     * explicit `a:rPr@sz` fell back to the browser's own default font size
+     * (16px / 12pt) instead. A render-only hint: it is not part of any
+     * individual cell's parsed style and is never written back on save, so
+     * resaving an unstyled cell does not bake in an explicit size that was
+     * never authored. `undefined` when no master/otherStyle size resolves
+     * (renderers should leave the browser default in place in that case).
+     */
+    defaultCellFontSize?: number;
 }
 
 /**
@@ -12191,6 +12330,11 @@ declare interface RibbonProps {
     onOpenSettings?: () => void;
     onRunAccessibilityCheck: () => void;
     onToggleSlideSorter: () => void;
+    /**
+     * View > Normal: leave whichever alternate view (slide sorter, reading,
+     * outline, master) is open and return to the ordinary editing canvas.
+     */
+    onGoToNormalView?: () => void;
     /** Open the windowed Reading View (NOT the fullscreen slide show). */
     onOpenReadingView: () => void;
     /** Enter PowerPoint's Outline view: the deck as editable indented text. */
@@ -12899,8 +13043,12 @@ export declare const SHORTCUT_CATALOG: readonly ShortcutDefinition[];
 /** i18n keys for each group's label, in display order. */
 export declare const SHORTCUT_GROUP_LABEL_KEYS: Record<ShortcutGroup, string>;
 
-/** The set of action identifiers the registry can dispatch. */
-export declare type ShortcutActionName = 'undo' | 'redo' | 'copy' | 'cut' | 'paste' | 'duplicate' | 'delete' | 'selectAll' | 'group' | 'ungroup' | 'toggleShortcuts' | 'nudge' | 'prevSlide' | 'nextSlide' | 'escape' | 'find';
+/**
+ * The set of action identifiers the registry can dispatch: an alias of the
+ * shared keymap's own action union, not a hand-copied one, so a new shared
+ * action can never silently fall through the dispatcher.
+ */
+export declare type ShortcutActionName = EditorKeyActionName;
 
 /**
  * Action callbacks the registry dispatches to. All are optional; a missing
@@ -12940,6 +13088,34 @@ export declare interface ShortcutActions {
     escape?: () => void;
     /** Open or close the find bar (Ctrl/Cmd+F). */
     find?: () => void;
+    /** Open Find & Replace (Ctrl/Cmd+H). */
+    findReplace?: () => void;
+    /** Left-align the current paragraph (Ctrl/Cmd+L). */
+    alignLeft?: () => void;
+    /** Centre-align the current paragraph (Ctrl/Cmd+E). */
+    alignCenter?: () => void;
+    /** Right-align the current paragraph (Ctrl/Cmd+R). */
+    alignRight?: () => void;
+    /** Justify the current paragraph (Ctrl/Cmd+J). */
+    alignJustify?: () => void;
+    /** Step the font size up PowerPoint's size ladder (Ctrl/Cmd+Shift+> or +]). */
+    increaseFontSize?: () => void;
+    /** Step the font size down PowerPoint's size ladder (Ctrl/Cmd+Shift+< or +[). */
+    decreaseFontSize?: () => void;
+    /** Copy the selection's formatting (Ctrl/Cmd+Shift+C). */
+    copyFormat?: () => void;
+    /** Apply the copied formatting to the selection (Ctrl/Cmd+Shift+V). */
+    pasteFormat?: () => void;
+    /** Insert a new slide (Ctrl/Cmd+M). */
+    newSlide?: () => void;
+    /** Open the hyperlink dialog (Ctrl/Cmd+K). */
+    hyperlink?: () => void;
+    /** Clear direct character formatting on the selection (Ctrl/Cmd+Space). */
+    clearFormatting?: () => void;
+    /** Select the next element on the slide (Tab). */
+    cycleSelectionNext?: () => void;
+    /** Select the previous element on the slide (Shift+Tab). */
+    cycleSelectionPrev?: () => void;
 }
 
 /** The catalog grouped by `group`, in `SHORTCUT_GROUP_LABEL_KEYS` order. */
@@ -12949,7 +13125,7 @@ export declare interface ShortcutCatalogGroup {
     shortcuts: ShortcutDefinition[];
 }
 
-/** A single entry in the shortcut catalog (drives both dispatch and the help UI). */
+/** A single entry in the shortcut catalog (drives the help UI). */
 export declare interface ShortcutDefinition {
     /** Stable identifier (also the action name where 1:1). */
     id: string;
@@ -12964,6 +13140,15 @@ export declare interface ShortcutDefinition {
     descriptionKey: string;
 }
 
+/**
+ * The keyboard-shortcut help catalog: data for `ShortcutPanel.vue`.
+ *
+ * Split out of `useKeyboardShortcuts.ts` to keep that file under this repo's
+ * file-size limit; the catalog is presentation data for the "?" help overlay,
+ * not dispatch logic, so it stands on its own.
+ *
+ * @module composables/shortcut-catalog
+ */
 /** Logical grouping for the help overlay. */
 export declare type ShortcutGroup = 'history' | 'clipboard' | 'editing' | 'navigation' | 'general';
 
@@ -13523,6 +13708,10 @@ declare interface SummaryZoomTarget extends PptxImageProperties {
     offsetFactorY?: number;
     scaleFactorX?: number;
     scaleFactorY?: number;
+    /** This tile's own `zmPr/@returnToParent`; see {@link ZoomPptxElement.returnToParent}. */
+    returnToParent?: boolean;
+    /** This tile's own `zmPr/@transitionDur` in milliseconds; see {@link ZoomPptxElement.transitionDurationMs}. */
+    transitionDurationMs?: number;
     rawXml?: XmlObject;
 }
 
@@ -13867,6 +14056,23 @@ declare interface TextSegment {
     fieldParagraphPropertiesXml?: XmlObject;
     /** Raw OMML XML node for equation segments (from `a14:m` / `m:oMathPara`). */
     equationXml?: Record<string, unknown>;
+    /**
+     * The ORIGINAL top-level paragraph child that carried this equation,
+     * captured verbatim at parse time and keyed by its own tag: `{ 'a14:m':
+     * ... }`, `{ 'm:oMathPara': ... }`, `{ 'm:oMath': ... }`, or `{
+     * 'mc:AlternateContent': ... }` for an equation authored behind a
+     * Choice/Fallback switch. `equationXml` above is the resolved math content
+     * used for rendering (unwrapped one level for `a14:m`/`mc:AlternateContent`
+     * sources); this field exists solely so the writer can re-emit an UNTOUCHED
+     * equation byte-for-byte, Choice and Fallback both, instead of collapsing
+     * it to a bare math element PowerPoint's own writer never produces.
+     * `undefined` for a freshly inserted or edited equation, which the writer
+     * instead reconstructs from `equationXml` (always `{ 'm:oMathPara': ... }`
+     * or `{ 'm:oMath': ... }` for those cases). Any code that replaces
+     * `equationXml` on an existing segment must drop this field, or the writer
+     * would keep re-emitting the equation's OLD XML instead of the edit.
+     */
+    equationSourceXml?: Record<string, unknown>;
     /**
      * Optional equation number for numbered equations (e.g. "(1)", "(2.3)").
      * When present, the equation is rendered centered with the number right-aligned.
@@ -14030,6 +14236,32 @@ declare interface TextStyle {
      * @see element-paragraph-geometry.ts
      */
     resolvedParagraphGeometry?: TextStyle;
+    /**
+     * Snapshot of the ELEMENT-scope `a:bodyPr` properties (vertical anchor,
+     * text direction, columns, overflow, autofit, body insets, text wrap, and
+     * the boolean/rotation attributes) as the load pipeline resolved them.
+     *
+     * A shape's own `a:bodyPr` is parsed first, then whatever it left
+     * `undefined` is back-filled from the placeholder / layout / master
+     * defaults (`applyPlaceholderBodyDefaults`), and a placeholder shape with
+     * no `a:bodyPr` of its own has the INHERITED one parsed as if it were its
+     * own. None of those three sources is distinguishable at
+     * `element.textStyle` once the cascade finishes, so a writer that
+     * re-emits every defined field turns an inherited anchor, inset, autofit
+     * mode or `rtlCol` into a value pinned on the slide forever (and an
+     * inherited `a:normAutofit` with no scale gets written back as
+     * `a:spAutoFit`, flipping AutoSize from "shrink text" to "resize shape").
+     *
+     * Present only on an `element.textStyle` that came from a parsed deck.
+     * The save path diffs the live style against this snapshot: a field that
+     * still matches is an inheritance artefact and the writer leaves the
+     * underlying `a:bodyPr` attribute untouched (whatever it already is,
+     * present or absent); a field that differs was authored or has since
+     * been edited and is written out.
+     *
+     * @see element-body-properties.ts
+     */
+    resolvedBodyProperties?: TextStyle;
     fontFamily?: string;
     fontSize?: number;
     /** When true, some form of autofit is in effect; see {@link autoFitMode} for which. */
@@ -14212,6 +14444,16 @@ declare interface TextStyle {
         align: 'l' | 'ctr' | 'r' | 'dec';
         leader?: 'none' | 'dot' | 'hyphen' | 'underscore';
     }>;
+    /**
+     * True when the paragraph's own `a:pPr` authored an EMPTY `<a:tabLst/>`
+     * (explicitly "no tab stops", overriding whatever the cascade would
+     * otherwise supply) rather than omitting the element entirely (inherit).
+     * fast-xml-parser gives a childless element as the empty string, so
+     * `tabLst` and no-`tabLst` are otherwise indistinguishable once `tabStops`
+     * comes back empty either way. Paragraph-scope only; not part of the
+     * element-level geometry cascade.
+     */
+    tabStopsExplicitEmpty?: boolean;
     /** Body text wrapping mode from `a:bodyPr/@wrap`. */
     textWrap?: 'square' | 'none';
     /** Preset text warp type from `a:bodyPr/a:prstTxWarp`. */
@@ -14254,6 +14496,20 @@ declare interface TextStyle {
      * serialised back on save, so it never disturbs the round-trip typefaces.
      */
     scriptFallbackFont?: string;
+    /**
+     * Set alongside {@link scriptFallbackFont} when the resolved {@link fontFamily}
+     * came only from the paragraph/list-style/theme CASCADE (the run's own
+     * `a:rPr` authored no `a:latin`/`a:ea`/`a:cs` of its own). A run always
+     * inherits SOME font this way (typically the theme's `+mn-lt`), so without
+     * this flag `fontFamily` was indistinguishable from a run that genuinely
+     * chose that font itself, and the renderer never applied the theme's
+     * per-script override (see #83): `+mn-lt` names only the LATIN member of
+     * the font scheme and was never meant to cover text in a different
+     * dominant script. An explicit `a:latin`/`a:ea`/`a:cs` authored on the run
+     * itself still always wins; only the cascade default yields to the
+     * script-specific override.
+     */
+    fontFamilyIsCascadeDefault?: boolean;
     /** Text language from `a:rPr/@lang`. */
     language?: string;
     /** Hyperlink mouse-over target from `a:hlinkMouseOver`. */
@@ -15386,6 +15642,28 @@ export declare interface UseEditorKeyboardInput {
     presentFromBeginning: () => void;
     /** Shift+F5: start the show from the active slide (same as "From Current Slide"). */
     startPresenting: () => void;
+    /** Id of the element under active inline edit, or `null`. Lets live-format chords survive the typing gate. */
+    inlineEditingElementId: Ref<string | null>;
+    /** Whether a table cell is actively being edited. Same purpose as `inlineEditingElementId`. */
+    tableEditorIsEditing: () => boolean;
+    /** The armed drawing tool; shortcuts stand down unless it is `'select'`. */
+    activeTool: () => string;
+    /** The current selection's elements, for reading the effective font size. */
+    selectedElements: ComputedRef<PptxElement[]>;
+    /** Select one element non-additively (Tab / Shift+Tab cycling). */
+    selectElement: (id: string, additive: boolean) => void;
+    /** Apply a text-style delta to the selection (Home ▸ Text section's own path). */
+    ribbonUpdateTextStyle: (updates: Partial<TextStyle>) => void;
+    /** Insert a new slide after the active one (Ctrl/Cmd+M). */
+    addSlide: () => void;
+    /** Open the hyperlink dialog for the current selection (Ctrl/Cmd+K). */
+    openHyperlinkForSelection: () => void;
+    /** Arm the format painter from the current selection (Ctrl/Cmd+Shift+C). */
+    toggleFormatPainter: () => void;
+    /** Apply the copied format to one element (used by `pasteFormat`). */
+    applyFormatToTarget: (id: string) => void;
+    /** Disarm the format painter without applying (used after `pasteFormat`). */
+    cancelFormatPainter: () => void;
 }
 
 export declare interface UseEditorKeyboardResult {
@@ -17903,6 +18181,28 @@ declare interface ZoomPptxElement extends PptxElementBase, PptxImageProperties {
     summaryTargets?: SummaryZoomTarget[];
     /** Layout mode authored on the Summary Zoom container. */
     summaryLayout?: 'grid' | 'fixed';
+    /**
+     * `zmPr/@returnToParent` (MS-PPTX `CT_ZoomObjectProperties`, shared by all
+     * three Zoom kinds): whether continuing forward from the destination slide
+     * during a live show returns to this Zoom's origin slide instead of
+     * advancing linearly through the deck. OOXML default is `true` when the
+     * attribute is present but this codebase leaves it `undefined` when the
+     * source XML omits it, so a round-trip never fabricates the attribute.
+     * For `zoomType: 'summary'`, this mirrors the first tile's own value; see
+     * {@link SummaryZoomTarget.returnToParent} for the per-tile value.
+     */
+    returnToParent?: boolean;
+    /**
+     * `zmPr/@transitionDur` (MS-PPTX `CT_ZoomObjectProperties`): the
+     * zoom-transition length in milliseconds. PowerPoint's own writer emits a
+     * unitless decimal-millisecond value for every OOXML `ST_UniversalTimeOffset`
+     * this codebase has observed (see the media-trim/-fade parsers), so this
+     * follows the same convention rather than the full TIMEOFFSET grammar's
+     * unit suffixes. Undefined uses the destination slide's own transition.
+     * For `zoomType: 'summary'`, this mirrors the first tile's own value; see
+     * {@link SummaryZoomTarget.transitionDurationMs} for the per-tile value.
+     */
+    transitionDurationMs?: number;
 }
 
 export { }

package/dist/internals.js

@@ -1,2 +1,2 @@
-import { $ as s, A as a, An as t, B as n, Bd as i, Bt as r, Cs as e, Ct as o, D as l, Dr as m, E as d, F as f, Ft as p, G as y, Hl as g, Ht as c, I as h, Is as u, It as T, J as j, K as q, Ki as L, Kn as M, L as S, Lt as V, M as v, Mn as x, Mt as B, N as D, Ni as F, Nt as I, O as K, P as N, Pt as P, Q as U, Qr as _, R as b, Rt as w, Sa as z, Sr as A, St as C, T as E, Tn as H, Tt as O, U as Q, Uc as R, Ut as W, V as Z, Vd as k, Vt as G, W as J, Wt as X, X as Y, Y as $, Z as ss, Zd as as, _ as ts, _a as ns, _t as is, a as rs, at as es, b as os, bt as ls, c as ms, cn as ds, ct as fs, d as ps, do as ys, dt as gs, ea as cs, et as hs, f as us, fn as Ts, ft as js, g as qs, gn as Ls, gt as Ms, h as Ss, hi as Vs, hn as vs, ht as xs, i as Bs, ii as Ds, il as Fs, it as Is, j as Ks, jn as Ns, jt as Ps, k as Us, l as _s, ln as bs, lt as ws, m as zs, mi as As, ml as Cs, mn as Es, mt as Hs, n as Os, nf as Qs, nt as Rs, o as Ws, oi as Zs, on as ks, ot as Gs, p as Js, pi as Xs, pn as Ys, pt as $s, q as sa, qc as aa, qi as ta, qt as na, r as ia, ri as ra, rt as ea, s as oa, sf as la, si as ma, sn as da, sr as fa, st as pa, t as ya, tt as ga, u as ca, uf as ha, un as ua, ut as Ta, v as ja, vt as qa, wt as La, xt as Ma, y as Sa, yn as Va, yr as va, yt as xa, z as Ba, zt as Da } from "./useViewerSettingsDialog-csWTWDGr.js";
-export { fa as CINEMATIC_TRANSITION_KEYFRAMES, Bs as DEFAULT_MAX_VERSIONS, va as DEFAULT_MORPH_DURATION_MS, t as DEFAULT_RENDERING_3D_FLAGS, A as DEFAULT_TRANSITION_DURATION_MS, m as EASE, qa as ERASER_RADIUS, Hs as FragmentedTransitionLayer, xa as HIGHLIGHTER_OPACITY, ls as HIGHLIGHTER_WIDTH, _ as INSTANT, ra as MOBILE_BREAKPOINT, Ds as MOBILE_LANDSCAPE_MAX_HEIGHT, $s as MorphExtraLayers, Zs as NUDGE_LARGE, ma as NUDGE_SMALL, Xs as P14_TRANSITION_KEYFRAMES, As as P14_TRANSITION_KEYFRAMES_2, Vs as P14_TRANSITION_KEYFRAMES_ALL, Ma as PEN_WIDTH, js as PresentationTransitionOverlay, F as RANDOM_ELIGIBLE_TYPES, ts as RIBBON_ALIGN, Ns as Rendering3DFlagsKey, w as SHORTCUT_CATALOG, Da as SHORTCUT_GROUP_LABEL_KEYS, L as SLIDE_TRANSITION_KEYFRAMES, ta as SLIDE_TRANSITION_KEYFRAMES_CSS, B as SMARTART_COLOR_SCHEMES, I as SMARTART_STYLE_OPTIONS, cs as TABLET_BREAKPOINT, ns as TRANSITION_SPEED_DURATION_MS, ks as TableSelectionKey, z as WHEEL_SPOKE_COUNTS, ys as buildClickGroups, da as computeCellSelection, e as computeDocumentStatistics, ws as computeElapsed, u as countWords, C as createStroke, o as eraseStrokesAtPoint, Ta as formatRehearseMs, R as generateCommentId, aa as getCinematicTransitionAnimations, Fs as getP14TransitionAnimations, Cs as getSlideTransitionAnimations, r as groupShortcutCatalog, ds as injectTableSelection, Ys as inlineEditorRect, g as isMobileViewport, Es as nodeIdsInRenderOrder, a as parseSignaturesFromBuffer, bs as provideTableSelection, i as resolveDirection, k as resolveDirection8, as as resolveOrientation, G as resolveShortcutAction, Qs as resolveSlideTransition, la as resolveTransitionDurationMs, ha as resolveWheelSpokeCount, P as smartArtLayoutLabel, vs as textNodeIdsInRenderOrder, ja as toShapePreset, pa as useAccessibility, Gs as useAlignGroup, O as useAnimationPlayback, es as useAutosave, V as useChartEditing, Is as useCollaboration, ea as useCollaborationWiring, H as useColorChangeImage, Rs as useComments, ga as useCommentsWiring, hs as useContextMenu, s as useCustomShows, U as useCustomShowsWiring, T as useDebouncedCallback, ss as useDocumentPropertiesDialog, W as useDocumentStatistics, Y as useEditorHistory, $ as useEditorKeyboard, j as useEditorOperations, sa as useElementDrag, q as useElementInsertion, y as useEmbeddedFonts, J as useExport, Q as useExportProgress, n as useExportWiring, Ba as useFindReplace, b as useFontEmbedding, S as useFormatPainter, h as useHeaderFooterDialog, f as useInkDrawing, N as useInlineEditing, D as useInsertElementDialogs, X as useIsMobile, v as useKeyboardInsets, c as useKeyboardShortcuts, Ks as useLoadContent, Us as useMasterViewState, Z as useMediaExport, K as useMobileChrome, Va as useModel3dScene, xs as useMorphTransitionOverlay, l as useMultiSelectOps, d as usePasswordProtection, La as usePresentationAnnotations, E as usePresentationModeWiring, os as usePrint, gs as useRehearseTimings, x as useRendering3DFlags, Sa as useRibbonActions, Os as useRibbonProps, qs as useRibbonUiState, Ss as useSectionOperations, zs as useSelectionPaneWiring, M as useSheetDismissDrag, Js as useSignatureWorkflow, fs as useSignatures, us as useSlideMutations, ps as useSlideOperations, ca as useSlideShowSettings, _s as useSlideTemplateInsertion, Ps as useSmartArtEditing, p as useSmartArtFocus, Ts as useSmartArtHoverRect, Ls as useSmartArtInlineEditState, ms as useSmartArtNodeEditContext, oa as useTableCellEditingContext, ua as useTableCellSelection, Ws as useThemeEditing, is as useToolbarAutoHide, na as useToolbarVisibility, Ms as useTouchGestures, rs as useVersionHistory, ia as useVersionHistoryWiring, ya as useViewerSettingsDialog };
+import { $ as a, $d as s, A as t, An as n, B as i, Bt as r, Ct as e, D as o, Dr as l, E as f, F as d, Ft as m, G as p, Hd as y, Ht as g, I as h, It as c, J as L, Jc as T, K as j, Ki as u, Kn as M, L as S, Ls as U, Lt as q, M as v, Mn as w, Mt as x, N as D, Ni as F, Nt as K, O as N, P, Pt as V, Q as W, Qr as _, R as b, Rt as z, Sa as A, Sr as B, St as E, T as H, Tn as I, Tt as J, U as O, Ud as Q, Ul as R, Ut as $, V as k, Vt as C, W as G, Wc as X, Wt as Y, X as Z, Y as aa, Z as sa, _ as ta, _a as na, _t as ia, a as ra, al as ea, at as oa, b as la, bt as fa, c as da, cn as ma, ct as pa, d as ya, do as ga, dt as ha, ea as ca, et as La, f as Ta, ff as ja, fn as ua, ft as Ma, g as Sa, gn as Ua, gt as qa, h as va, hi as wa, hl as xa, hn as Da, ht as Fa, i as Ka, if as Na, ii as Pa, it as Va, j as Wa, jn as _a, jt as ba, k as za, l as Aa, lf as Ba, ln as Ea, lt as Ha, m as Ia, mi as Ja, mn as Oa, mt as Qa, n as Ra, nt as $a, o as ka, oi as Ca, on as Ga, ot as Xa, p as Ya, pi as Za, pn as as, pt as ss, q as ts, qi as ns, qt as is, r as rs, ri as es, rt as os, s as ls, si as fs, sn as ds, sr as ms, st as ps, t as ys, tt as gs, u as hs, un as cs, ut as Ls, v as Ts, vt as js, ws as us, wt as Ms, xt as Ss, y as Us, yn as qs, yr as vs, yt as ws, z as xs, zt as Ds } from "./useViewerSettingsDialog-DKWvCzGK.js";
+export { ms as CINEMATIC_TRANSITION_KEYFRAMES, Ka as DEFAULT_MAX_VERSIONS, vs as DEFAULT_MORPH_DURATION_MS, n as DEFAULT_RENDERING_3D_FLAGS, B as DEFAULT_TRANSITION_DURATION_MS, l as EASE, js as ERASER_RADIUS, Qa as FragmentedTransitionLayer, ws as HIGHLIGHTER_OPACITY, fa as HIGHLIGHTER_WIDTH, _ as INSTANT, es as MOBILE_BREAKPOINT, Pa as MOBILE_LANDSCAPE_MAX_HEIGHT, ss as MorphExtraLayers, Ca as NUDGE_LARGE, fs as NUDGE_SMALL, Za as P14_TRANSITION_KEYFRAMES, Ja as P14_TRANSITION_KEYFRAMES_2, wa as P14_TRANSITION_KEYFRAMES_ALL, Ss as PEN_WIDTH, Ma as PresentationTransitionOverlay, F as RANDOM_ELIGIBLE_TYPES, ta as RIBBON_ALIGN, _a as Rendering3DFlagsKey, r as SHORTCUT_CATALOG, C as SHORTCUT_GROUP_LABEL_KEYS, u as SLIDE_TRANSITION_KEYFRAMES, ns as SLIDE_TRANSITION_KEYFRAMES_CSS, x as SMARTART_COLOR_SCHEMES, K as SMARTART_STYLE_OPTIONS, ca as TABLET_BREAKPOINT, na as TRANSITION_SPEED_DURATION_MS, Ga as TableSelectionKey, A as WHEEL_SPOKE_COUNTS, ga as buildClickGroups, ds as computeCellSelection, us as computeDocumentStatistics, Ha as computeElapsed, U as countWords, E as createStroke, e as eraseStrokesAtPoint, Ls as formatRehearseMs, X as generateCommentId, T as getCinematicTransitionAnimations, ea as getP14TransitionAnimations, xa as getSlideTransitionAnimations, g as groupShortcutCatalog, ma as injectTableSelection, as as inlineEditorRect, R as isMobileViewport, Oa as nodeIdsInRenderOrder, t as parseSignaturesFromBuffer, Ea as provideTableSelection, y as resolveDirection, Q as resolveDirection8, s as resolveOrientation, z as resolveShortcutAction, Na as resolveSlideTransition, Ba as resolveTransitionDurationMs, ja as resolveWheelSpokeCount, V as smartArtLayoutLabel, Da as textNodeIdsInRenderOrder, Ts as toShapePreset, ps as useAccessibility, Xa as useAlignGroup, J as useAnimationPlayback, oa as useAutosave, q as useChartEditing, Va as useCollaboration, os as useCollaborationWiring, I as useColorChangeImage, $a as useComments, gs as useCommentsWiring, La as useContextMenu, a as useCustomShows, W as useCustomShowsWiring, c as useDebouncedCallback, sa as useDocumentPropertiesDialog, $ as useDocumentStatistics, Z as useEditorHistory, aa as useEditorKeyboard, L as useEditorOperations, ts as useElementDrag, j as useElementInsertion, p as useEmbeddedFonts, G as useExport, O as useExportProgress, i as useExportWiring, xs as useFindReplace, b as useFontEmbedding, S as useFormatPainter, h as useHeaderFooterDialog, d as useInkDrawing, P as useInlineEditing, D as useInsertElementDialogs, Y as useIsMobile, v as useKeyboardInsets, Ds as useKeyboardShortcuts, Wa as useLoadContent, za as useMasterViewState, k as useMediaExport, N as useMobileChrome, qs as useModel3dScene, Fa as useMorphTransitionOverlay, o as useMultiSelectOps, f as usePasswordProtection, Ms as usePresentationAnnotations, H as usePresentationModeWiring, la as usePrint, ha as useRehearseTimings, w as useRendering3DFlags, Us as useRibbonActions, Ra as useRibbonProps, Sa as useRibbonUiState, va as useSectionOperations, Ia as useSelectionPaneWiring, M as useSheetDismissDrag, Ya as useSignatureWorkflow, pa as useSignatures, Ta as useSlideMutations, ya as useSlideOperations, hs as useSlideShowSettings, Aa as useSlideTemplateInsertion, ba as useSmartArtEditing, m as useSmartArtFocus, ua as useSmartArtHoverRect, Ua as useSmartArtInlineEditState, da as useSmartArtNodeEditContext, ls as useTableCellEditingContext, cs as useTableCellSelection, ka as useThemeEditing, ia as useToolbarAutoHide, is as useToolbarVisibility, qa as useTouchGestures, ra as useVersionHistory, rs as useVersionHistoryWiring, ys as useViewerSettingsDialog };

package/dist/pptx-vue-viewer.css

@@ -34,7 +34,7 @@
 }
 
 
-.pptx-vue-chart-svg[data-v-b41ce5bb] {
+.pptx-vue-chart-svg[data-v-527055f4] {
 	width: 100%;
 	height: 100%;
 	display: block;
@@ -85,14 +85,14 @@
 }
 
 
-.pptx-vue-contentpart-svg[data-v-f83c81f0] {
+.pptx-vue-contentpart-svg[data-v-4f7a16dc] {
 	width: 100%;
 	height: 100%;
 	pointer-events: none;
 	display: block;
 }
 
-.pptx-vue-contentpart-fallback[data-v-f83c81f0] {
+.pptx-vue-contentpart-fallback[data-v-4f7a16dc] {
 	width: 100%;
 	height: 100%;
 	box-sizing: border-box;
@@ -104,7 +104,7 @@
 	background: rgba(148, 163, 184, 0.08);
 }
 
-.pptx-vue-contentpart-fallback-label[data-v-f83c81f0] {
+.pptx-vue-contentpart-fallback-label[data-v-4f7a16dc] {
 	font-size: 11px;
 	font-family: system-ui, sans-serif;
 	color: rgba(100, 116, 139, 0.9);
@@ -137,7 +137,7 @@
 
 /* The host `.pptx-vue-media` is already absolutely positioned by
    `getContainerStyle`, so the badge centres against the element's own box. */
-.pptx-vue-media-badge[data-v-58b8d34c] {
+.pptx-vue-media-badge[data-v-943e5f33] {
 	position: absolute;
 	inset: 0;
 	display: flex;
@@ -151,31 +151,52 @@
 	font-size: 10px;
 }
 
-.pptx-vue-media-badge svg[data-v-58b8d34c] {
+.pptx-vue-media-badge svg[data-v-943e5f33] {
 	width: 48px;
 	height: 48px;
 }
 
-.pptx-vue-media-badge-missing[data-v-58b8d34c] {
+.pptx-vue-media-badge-missing[data-v-943e5f33] {
 	color: rgba(255, 255, 255, 0.6);
 }
 
-.pptx-vue-media-badge-missing svg[data-v-58b8d34c] {
+.pptx-vue-media-badge-missing svg[data-v-943e5f33] {
 	width: 32px;
 	height: 32px;
 }
 
-.pptx-vue-media-placeholder[data-v-58b8d34c] {
+.pptx-vue-media-placeholder[data-v-943e5f33] {
 	flex-direction: column;
 	gap: 4px;
 	font-size: 10px;
 }
 
-.pptx-vue-media-placeholder svg[data-v-58b8d34c] {
+.pptx-vue-media-placeholder svg[data-v-943e5f33] {
 	width: 32px;
 	height: 32px;
 }
 
+.pptx-vue-media-fullscreen-stop[data-v-943e5f33] {
+	position: absolute;
+	bottom: 12px;
+	right: 12px;
+	z-index: 30;
+	border: none;
+	border-radius: 9999px;
+	background: rgba(0, 0, 0, 0.5);
+	color: rgba(255, 255, 255, 0.8);
+	padding: 8px;
+	cursor: pointer;
+	transition:
+		background-color 0.15s ease,
+		color 0.15s ease;
+}
+
+.pptx-vue-media-fullscreen-stop[data-v-943e5f33]:hover {
+	background: rgba(0, 0, 0, 0.7);
+	color: #fff;
+}
+
 
 .pptx-vue-equation-wrapper[data-v-040d8b50] {
 	display: flex;
@@ -213,7 +234,7 @@
 }
 
 
-.pptx-vue-ink-svg[data-v-b57bbdfb] {
+.pptx-vue-ink-svg[data-v-af9d7ab9] {
 	width: 100%;
 	height: 100%;
 	pointer-events: none;
@@ -567,7 +588,7 @@
 }
 
 
-.pptx-vue-wordart[data-v-b190a737] {
+.pptx-vue-wordart[data-v-fb0f296a] {
 	position: absolute;
 	inset: 0;
 	overflow: visible;