pptx-vue-viewer 4.1.6 → 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[];
 }
 
 /**
@@ -1297,6 +1328,9 @@ export declare const DEFAULT_MAX_VERSIONS = 50;
  */
 export declare const DEFAULT_MORPH_DURATION_MS = 500;
 
+/** All off: the safe default outside `PowerPointViewer` (tests, isolated thumbnails). */
+export declare const DEFAULT_RENDERING_3D_FLAGS: Rendering3DFlags;
+
 /**
  * Default transition duration (ms) when the transition omits `durationMs`. This
  * is the React/Vue default consumed by `resolveSlideTransition`. The Angular
@@ -1423,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>;
@@ -3258,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. */
@@ -3457,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;
@@ -3506,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. */
@@ -4057,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 {
@@ -7727,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;
 }
@@ -8228,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';
 
 /**
@@ -9841,7 +9957,6 @@ declare interface PptxSmartArtDefinitionMetadata {
     categories?: PptxSmartArtDefinitionCategory[];
 }
 
-/** Editable metadata shared by DiagramML quick-style and color definitions. */
 declare interface PptxSmartArtDefinitionText {
     value: string;
     language?: string;
@@ -9963,6 +10078,29 @@ declare interface PptxSmartArtDrawingShape extends PptxCustomPathProperties {
     textFrameY?: number;
     textFrameWidth?: number;
     textFrameHeight?: number;
+    /**
+     * 3D scene (camera/light rig/backdrop) from `dsp:spPr/a:scene3d`, when this
+     * cached shape carries its own per-shape camera. Bevel quick styles
+     * (Polished, Inset, Cartoon, Powder) cache one per shape (always
+     * `orthographicFront`, so the 2D layout stays undistorted). Scene quick
+     * styles (Brick, Flat, Metallic, Sunset, Bird's Eye) instead put ONE camera
+     * on the whole diagram (see `PptxSmartArtQuickStyle.scene3d`) and leave this
+     * undefined on every shape.
+     */
+    scene3d?: Pptx3DScene;
+    /**
+     * 3D extrusion/bevel/contour/material from `dsp:spPr/a:sp3d`. PowerPoint
+     * caches this fully resolved (from the quick style's per-label `dgm:sp3d`)
+     * on every shape for every non-flat quick style, bevel or scene alike.
+     */
+    shape3d?: Pptx3DShape;
+    /**
+     * Text-body 3D extrusion/bevel from `dsp:txBody/a:bodyPr/a:sp3d`. Rare:
+     * present when a quick style extrudes the label text itself off the shape
+     * face (e.g. Bird's Eye Scene: `extrusionH="28000"`), rather than only the
+     * shape body.
+     */
+    text3d?: Text3DStyle;
 }
 
 declare interface PptxSmartArtForEach extends PptxSmartArtIteratorAttributes {
@@ -10005,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. */
@@ -10445,6 +10595,17 @@ declare interface PptxSmartArtQuickStyle extends PptxSmartArtDefinitionMetadata
     effectIntensity?: string;
     /** Ordered CT_StyleLabel metadata. Complex style payload remains preserved XML. */
     labels?: PptxSmartArtQuickStyleLabel[];
+    /**
+     * Whole-diagram 3D scene (camera preset/rotation/zoom/fov, light rig,
+     * backdrop) from the quick style's own `dgm:styleDef/dgm:scene3d`, present
+     * for the "Scene" quick styles (Brick, Flat, Metallic, Sunset, Bird's Eye
+     * Scene). One camera renders the whole diagram; per-shape `a:scene3d` is
+     * absent for those styles (see `PptxSmartArtDrawingShape.scene3d`). Each
+     * `dgm:styleLbl` also carries its own per-label `dgm:scene3d`/`dgm:sp3d`,
+     * but PowerPoint bakes those fully resolved onto each cached shape's own
+     * `dsp:spPr/a:sp3d`, so only the diagram-level scene is exposed here.
+     */
+    scene3d?: Pptx3DScene;
 }
 
 /** CT_StyleLabel metadata from a quick-style definition. */
@@ -10961,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;
 }
 
 /**
@@ -11857,6 +12032,19 @@ export declare interface RemotePresence {
     role?: CollaborationRole;
 }
 
+/** The six opt-in interactive-3D scene flags every binding exposes as host props. */
+declare interface Rendering3DFlags {
+    smartArt3D: boolean;
+    surfaceChart3D: boolean;
+    barChart3D: boolean;
+    lineChart3D: boolean;
+    areaChart3D: boolean;
+    pieChart3D: boolean;
+}
+
+/** Injection key for the resolved flags; a computed ref so a live Options change reaches every injector. */
+export declare const Rendering3DFlagsKey: InjectionKey<ComputedRef<Rendering3DFlags>>;
+
 /** A rendered paragraph: runs plus resolved bullet + hanging-indent metadata. */
 declare interface RenderParagraph {
     runs: ParagraphRun[];
@@ -12142,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. */
@@ -12850,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
@@ -12891,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. */
@@ -12900,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;
@@ -12915,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';
 
@@ -13199,14 +13433,6 @@ export declare interface SlideVersion {
     slides: PptxSlide[];
 }
 
-/**
- * Injection key carrying the `smartArt3D` opt-in flag, ANDed with Options >
- * Advanced > "Disable 3D rendering" (see `resolve3DRenderingFlags`). A
- * computed ref, not a plain boolean, so a live Options change reaches every
- * injector without a reload.
- */
-export declare const SmartArt3DKey: InjectionKey<ComputedRef<boolean>>;
-
 /**
  * Static option lists and layout-label helper for the SmartArt inspector.
  *
@@ -13482,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;
 }
 
@@ -13826,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.
@@ -13989,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. */
@@ -14171,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`. */
@@ -14213,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`. */
@@ -15345,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 {
@@ -16658,6 +16977,9 @@ export declare interface UseRehearseTimingsResult {
     dismissSummary: () => void;
 }
 
+/** Read the resolved 3D flags; all off when not provided. */
+export declare function useRendering3DFlags(): ComputedRef<Rendering3DFlags>;
+
 export declare function useRibbonActions(input: UseRibbonActionsInput): {
     ribbonMode: ComputedRef<ViewerMode>;
     activeTableSelection: ComputedRef<TableCellEditorState | null>;
@@ -17167,9 +17489,6 @@ export declare interface UseSlideTemplateInsertionResult {
     insertSlideFromTemplate: (templateId: SlideTemplateId) => void;
 }
 
-/** Read the SmartArt 3D opt-in flag; defaults to `false` when not provided. */
-export declare function useSmartArt3D(): ComputedRef<boolean>;
-
 export declare function useSmartArtEditing(input: UseSmartArtEditingInput): SmartArtEditingApi;
 
 export declare interface UseSmartArtEditingInput {
@@ -17862,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 a, A as s, B as t, Bt as n, Ct as i, D as r, Da as e, Dr as o, E as f, F as l, Fn as y, Ft as g, G as c, Gd as d, Ht as m, I as p, In as h, It as T, J as u, Jc as v, K as D, Kd as F, L, Lt as M, M as V, Mr as b, Mt as j, N as q, Nt as w, O as x, Os as I, P as O, Pt as P, Q, Qc as R, Qi as S, R as z, Ri as B, Rt as E, Sa as G, St as J, T as K, Tn as N, Tt as U, U as W, Ut as X, V as Z, Vs as _, Vt as k, W as A, Wt as C, X as H, Xn as Y, Y as $, Z as aa, Zi as sa, _ as ta, _t as na, a as ia, aa as ra, at as ea, b as oa, bi as fa, bt as la, c as ya, ci as ga, cn as ca, ct as da, d as ma, di as pa, dt as ha, et as Ta, f as ua, ff as va, fi as Da, fn as Fa, fr as La, ft as Ma, g as Va, gn as ba, go as ja, gt as qa, h as wa, hf as xa, hn as Ia, ht as Oa, i as Pa, it as Qa, j as Ra, jt as Sa, k as za, l as Ba, li as Ea, ll as Ga, ln as Ja, lt as Ka, m as Na, mn as Ua, mt as Wa, n as Xa, nf as Za, nt as _a, o as ka, on as Aa, ot as Ca, p as Ha, pn as Ya, pt as $a, q as as, ql as ss, qt as ts, r as ns, ri as is, rt as rs, s as es, sf as os, sn as fs, st as ls, t as ys, tt as gs, u as cs, un as ds, ut as ms, v as ps, vi as hs, vt as Ts, wr as us, wt as vs, xt as Ds, y as Fs, yi as Ls, yl as Ms, yn as Vs, yt as bs, z as js, zt as qs } from "./useViewerSettingsDialog-DGSKnDyZ.js";
-export { La as CINEMATIC_TRANSITION_KEYFRAMES, Pa as DEFAULT_MAX_VERSIONS, us as DEFAULT_MORPH_DURATION_MS, o as DEFAULT_TRANSITION_DURATION_MS, b as EASE, Ts as ERASER_RADIUS, Wa as FragmentedTransitionLayer, bs as HIGHLIGHTER_OPACITY, la as HIGHLIGHTER_WIDTH, is as INSTANT, ga as MOBILE_BREAKPOINT, Ea as MOBILE_LANDSCAPE_MAX_HEIGHT, $a as MorphExtraLayers, pa as NUDGE_LARGE, Da as NUDGE_SMALL, hs as P14_TRANSITION_KEYFRAMES, Ls as P14_TRANSITION_KEYFRAMES_2, fa as P14_TRANSITION_KEYFRAMES_ALL, Ds as PEN_WIDTH, Ma as PresentationTransitionOverlay, B as RANDOM_ELIGIBLE_TYPES, ta as RIBBON_ALIGN, E as SHORTCUT_CATALOG, qs as SHORTCUT_GROUP_LABEL_KEYS, sa as SLIDE_TRANSITION_KEYFRAMES, S as SLIDE_TRANSITION_KEYFRAMES_CSS, j as SMARTART_COLOR_SCHEMES, w as SMARTART_STYLE_OPTIONS, y as SmartArt3DKey, ra as TABLET_BREAKPOINT, G as TRANSITION_SPEED_DURATION_MS, Aa as TableSelectionKey, e as WHEEL_SPOKE_COUNTS, ja as buildClickGroups, fs as computeCellSelection, I as computeDocumentStatistics, Ka as computeElapsed, _ as countWords, J as createStroke, i as eraseStrokesAtPoint, ms as formatRehearseMs, v as generateCommentId, R as getCinematicTransitionAnimations, Ga as getP14TransitionAnimations, Ms as getSlideTransitionAnimations, n as groupShortcutCatalog, ca as injectTableSelection, Ya as inlineEditorRect, ss as isMobileViewport, Ua as nodeIdsInRenderOrder, s as parseSignaturesFromBuffer, Ja as provideTableSelection, d as resolveDirection, F as resolveDirection8, Za as resolveOrientation, k as resolveShortcutAction, os as resolveSlideTransition, va as resolveTransitionDurationMs, xa as resolveWheelSpokeCount, P as smartArtLayoutLabel, Ia as textNodeIdsInRenderOrder, ps as toShapePreset, ls as useAccessibility, Ca as useAlignGroup, U as useAnimationPlayback, ea as useAutosave, M as useChartEditing, Qa as useCollaboration, rs as useCollaborationWiring, N as useColorChangeImage, _a as useComments, gs as useCommentsWiring, Ta as useContextMenu, a as useCustomShows, Q as useCustomShowsWiring, T as useDebouncedCallback, aa as useDocumentPropertiesDialog, X as useDocumentStatistics, H as useEditorHistory, $ as useEditorKeyboard, u as useEditorOperations, as as useElementDrag, D as useElementInsertion, c as useEmbeddedFonts, A as useExport, W as useExportProgress, t as useExportWiring, js as useFindReplace, z as useFontEmbedding, L as useFormatPainter, p as useHeaderFooterDialog, l as useInkDrawing, O as useInlineEditing, q as useInsertElementDialogs, C as useIsMobile, V as useKeyboardInsets, m as useKeyboardShortcuts, Ra as useLoadContent, za as useMasterViewState, Z as useMediaExport, x as useMobileChrome, Vs as useModel3dScene, Oa as useMorphTransitionOverlay, r as useMultiSelectOps, f as usePasswordProtection, vs as usePresentationAnnotations, K as usePresentationModeWiring, oa as usePrint, ha as useRehearseTimings, Fs as useRibbonActions, Xa as useRibbonProps, Va as useRibbonUiState, wa as useSectionOperations, Na as useSelectionPaneWiring, Y as useSheetDismissDrag, Ha as useSignatureWorkflow, da as useSignatures, ua as useSlideMutations, ma as useSlideOperations, cs as useSlideShowSettings, Ba as useSlideTemplateInsertion, h as useSmartArt3D, Sa as useSmartArtEditing, g as useSmartArtFocus, Fa as useSmartArtHoverRect, ba as useSmartArtInlineEditState, ya as useSmartArtNodeEditContext, es as useTableCellEditingContext, ds as useTableCellSelection, ka as useThemeEditing, na as useToolbarAutoHide, ts as useToolbarVisibility, qa as useTouchGestures, ia as useVersionHistory, ns as useVersionHistoryWiring, ys 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 };