pptx-svelte-viewer 4.2.0 → 4.4.0

package/dist/viewer/index.d.ts

@@ -1397,6 +1397,32 @@ 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. */
@@ -1579,6 +1605,16 @@ 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`. */
@@ -1621,6 +1657,20 @@ 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`. */
@@ -1643,6 +1693,16 @@ interface TextStyle {
   hyperlinkHighlightClick?: boolean;
   /** Whether hyperlink ends a sound (`a:hlinkClick/@endSnd`). */
   hyperlinkEndSound?: boolean;
+  /**
+   * Raw `a:hlinkClick/a:extLst` child, preserved verbatim for round-trip.
+   * Carries vendor extensions this engine does not interpret, most commonly
+   * `ahyp:hlinkClr` (Microsoft's "hyperlink color" extension,
+   * `{A12FA001-AC4F-418D-AE19-62706E023703}`), which records whether a
+   * hyperlink run should paint with the theme's text colour instead of the
+   * hyperlink colour. Dropping the whole `a:extLst` silently reverted such a
+   * run to the default (themed) hyperlink colour on save.
+   */
+  hyperlinkExtensionXml?: XmlObject;
   /** Kumimoji (ideographic text combining) flag for vertical CJK text (`a:rPr/@kumimoji`). */
   kumimoji?: boolean;
   /** Normalize height flag (`a:rPr/@normalizeH`). */
@@ -1796,6 +1856,15 @@ interface TextStyle {
   textGlowRadius?: number;
   /** Text glow opacity (0-1). */
   textGlowOpacity?: number;
+  /**
+   * Original glow colour-choice XML (`a:glow`'s `a:schemeClr`/`a:srgbClr`/…
+   * child), preserved verbatim so a theme colour reference round-trips
+   * instead of always being re-serialized as a resolved `a:srgbClr` (which
+   * cuts the glow off from theme/Recolor changes).
+   */
+  textGlowColorXml?: XmlObject;
+  /** Theme colour slot the glow colour resolved from, when it is `a:schemeClr`. */
+  textGlowColorRef?: PptxThemeColorRef;
   /** Text reflection enabled flag. */
   textReflection?: boolean;
   /** Text reflection blur radius in px. */
@@ -1932,6 +2001,18 @@ interface BulletInfo {
   paragraphIndex?: number;
   /** Bullet font family from `a:buFont`. */
   fontFamily?: string;
+  /**
+   * PANOSE font-matching hint from `a:buFont/@panose`. `a:buFont` is a
+   * CT_TextFont, the same complex type as `a:latin`/`a:ea`/`a:cs`/`a:sym`
+   * (which carry the equivalent `TextStyle.latinFontPanose` etc.), so a
+   * bullet's own PANOSE/pitch-family/charset decide the fallback glyph
+   * PowerPoint substitutes when the named typeface is missing.
+   */
+  fontPanose?: string;
+  /** Font pitch-and-family byte from `a:buFont/@pitchFamily`. */
+  fontPitchFamily?: number;
+  /** Font character-set byte from `a:buFont/@charset`. */
+  fontCharset?: number;
   /** Bullet size as percentage of text font size from `a:buSzPct`. */
   sizePercent?: number;
   /** Bullet size in points from `a:buSzPts`. */
@@ -1973,6 +2054,18 @@ 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;
 }
 /**
  * A single text run within a paragraph.
@@ -2015,6 +2108,23 @@ 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.
@@ -2299,6 +2409,24 @@ interface PptxShapeProperties {
  */
 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;
@@ -2348,8 +2476,32 @@ 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. */
@@ -5082,6 +5234,18 @@ 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;
 }
 //#endregion
 //#region src/core/types/smart-art-node.d.ts
@@ -6194,6 +6358,20 @@ 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;
 }
 /**
  * A single fill reference within a table style section.
@@ -6219,6 +6397,14 @@ 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. */
@@ -7054,6 +7240,20 @@ 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[];
 }
 /**
  * A content-part element wrapped in `mc:AlternateContent`.
@@ -7098,6 +7298,34 @@ 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. The schema declares `<xsd:attribute
+   * name="returnToParent" type="xsd:boolean" use="optional" default="true"/>`,
+   * so an ABSENT attribute means `true`, not `false`. This codebase still
+   * leaves the field `undefined` (rather than fabricating `true`) when the
+   * source XML omits it, so a round-trip never invents an attribute the
+   * source never had; a CONSUMER of this field (playback, e.g.
+   * `pptx-viewer-shared`'s `resolveZoomNavigationTarget`) must read
+   * `returnToParent !== false`, not `Boolean(returnToParent)`, to get the
+   * spec-correct effective value. 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;
 }
 /** A single section tile within a PowerPoint Summary Zoom container. */
 interface SummaryZoomTarget extends PptxImageProperties {
@@ -7113,6 +7341,10 @@ 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;
 }
 /**
@@ -8113,6 +8345,17 @@ 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;
 }
 /** Signed HSL channel deltas parsed from `p:animClr/p:by/p:hsl`. */
 interface PptxHslColorDelta {
@@ -8194,7 +8437,19 @@ interface PptxTextAnimationTarget {
  * These map directly to OOXML condition event attribute values
  * (ISO/IEC 29500-1 S19.5.28 CT_TLTimeCondition).
  */
-type AnimationConditionEvent = 'onBegin' | 'onEnd' | 'begin' | 'end' | 'onClick' | 'onMouseOver' | 'onMouseOut' | 'onNext' | 'onPrev' | 'onStopAudio' | 'onDblClick';
+type AnimationConditionEvent = 'onBegin' | 'onEnd' | 'begin' | 'end' | 'onClick' | 'onMouseOver' | 'onMouseOut' | 'onNext' | 'onPrev' | 'onStopAudio' | 'onDblClick' | 'onMediaBookmark';
+/**
+ * `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`).
+ */
+interface PptxMediaBookmarkTarget {
+  /** `p14:bmkTgt/@_spid`: the media element's shape id. */
+  shapeId: string;
+  /** `p14:bmkTgt/@_bmkName`: the bookmark's name. */
+  bookmarkName: string;
+}
 /**
  * Structured representation of a single OOXML animation condition
  * from `p:cond` elements inside `p:stCondLst` or `p:endCondLst`.
@@ -8214,6 +8469,11 @@ type AnimationConditionEvent = 'onBegin' | 'onEnd' | 'begin' | 'end' | 'onClick'
 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`). */
@@ -9062,7 +9322,12 @@ interface PptxSlideTransition {
   spokes?: number;
   /** Pattern type for shred transition. */
   pattern?: string;
-  /** Through-black flag for blinds/checker (OOXML `@_thruBlk`). */
+  /**
+   * Through-black flag (OOXML `@_thruBlk`). COM-verified to actually apply to
+   * `cut` and `fade` (see {@link TRANSITION_THRUBLK_TYPES}); parsed generically
+   * off any standard transition child so an unexpected authored value still
+   * round-trips.
+   */
   thruBlk?: boolean;
   /** Split orientation (horz/vert) parsed from `@_orient`. */
   orient?: PptxSplitOrientation;
@@ -9532,7 +9797,12 @@ 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;
 }
@@ -12522,13 +12792,21 @@ interface InlineTextSelection {
  * Pure string logic: resolves OOXML field runs (slide number, date/time,
  * header/footer, document properties, slide title) into their display text.
  * Extracted from the React `viewer/utils/text-field-substitution` module so
- * every binding substitutes identically.
+ * every binding substitutes identically. The locale-aware datetime engine
+ * lives in `text-field-datetime.ts`.
  */
 /** Context for substituting field placeholders (slide number, date/time, header/footer, etc.). */
 interface FieldSubstitutionContext {
   slideNumber?: number;
   dateTimeText?: string;
-  /** OOXML date-format pattern from header/footer settings (e.g. "M/d/yyyy"). */
+  /**
+   * The deck's master date-field default TYPE (`a:fld/@type` on the slide
+   * master's `dt` placeholder, e.g. "datetime2"; see `header-footer-parts.ts`).
+   * This is a field TYPE, not a format pattern, and is used ONLY as a
+   * fallback for a field authored with the generic, unnumbered `datetime`
+   * type - a field that already names its own `datetime1`-`datetime13` type
+   * always uses that type, never this one (see `substituteFieldText`).
+   */
   dateFormat?: string;
   /** Footer text from PptxHeaderFooter settings. */
   footerText?: string;
@@ -12955,6 +13233,10 @@ interface PresentationInkStroke {
   points: PresentationInkPoint[];
 }
 //#endregion
+//#region src/render/paste-special.d.ts
+/** The four paste formats PowerPoint's Paste Options / Paste Special offer. */
+type PasteSpecialFormat = 'keep-source-formatting' | 'use-destination-theme' | 'picture' | 'keep-text-only';
+//#endregion
 //#region src/render/alignment-guides.d.ts
 /** A single alignment guide, positioned in authored slide pixels. */
 interface Guide {
@@ -13046,6 +13328,20 @@ interface InkStrokeView {
    * existed.
    */
   nibMarks: NibMark[] | null;
+  /**
+   * CSS `mix-blend-mode` this stroke should paint with: `'multiply'` for a
+   * highlighter-style stroke, so overlapping highlighter strokes darken
+   * where they cross (and a highlighter stroke darkens whatever slide
+   * content sits underneath it) the way a real highlighter pen does, instead
+   * of plain alpha compositing. `'normal'` for every other stroke. A binding
+   * applies this as an inline `mix-blend-mode` style on the stroke's own
+   * `<path>`/`<g>` (not on the element's outer `<svg>`): setting it on the
+   * container instead would blend the whole element's already-composited
+   * output against the backdrop as one unit, so strokes sharing that
+   * container would still alpha-composite (not multiply) against each
+   * other.
+   */
+  blendMode: 'normal' | 'multiply';
 }
 //#endregion
 //#region src/render/mobile-chrome.d.ts
@@ -13086,6 +13382,28 @@ interface FontEmbeddingDescriptor {
   /** Present only when `interactive` is false. */
   disabledReasonKey?: string;
 }
+//#endregion
+//#region src/render/zoom-return-navigation.d.ts
+/**
+ * The navigation-relevant fields of a Zoom click target, independent of
+ * `zoomType`.
+ *
+ * `returnToParent` is already resolved to its EFFECTIVE value here (not the
+ * raw, possibly-`undefined` `ZoomPptxElement`/`SummaryZoomTarget` field):
+ * `CT_ZoomObjectProperties/@returnToParent` (MS-PPTX) is `<xsd:attribute
+ * name="returnToParent" type="xsd:boolean" use="optional" default="true"/>`,
+ * so an ABSENT attribute means true, not false. Core deliberately stores
+ * `undefined` rather than fabricating `true` (so a round-trip never invents
+ * an attribute the source never had), which makes `Boolean(x)` the wrong way
+ * to read it; the two `resolve*NavigationTarget` functions below are the only
+ * place that distinction should be made.
+ */
+interface ZoomNavigationTarget {
+  targetSlideIndex: number;
+  targetSectionId?: string;
+  returnToParent: boolean;
+  transitionDurationMs?: number;
+}
 /** The percentage one zoom-in press moves to, clamped. */
 declare function zoomInPercent(percent: number): number;
 /** The percentage one zoom-out press moves to, clamped. */
@@ -14987,6 +15305,21 @@ declare class EditorClipboardController {
     cutSelected(): void;
     /** Paste the clipboard payload onto the current slide (fresh id, offset, selects it). */
     pasteClipboard(): string | null;
+    /**
+     * Paste Special (Ctrl+Alt+V) / the dialog's OK: paste the clipboard with
+     * `format` already applied.
+     */
+    pasteWithFormat(format: PasteSpecialFormat): string | null;
+    /**
+     * Re-derive an already-pasted element (the Paste Options toolbar) from its
+     * own pristine source clone. Non-cumulative: every choice starts over from
+     * the clone `pasteClipboard`/`pasteWithFormat` recorded, matching
+     * PowerPoint's own toolbar. "Picture" is handled by the caller (it needs a
+     * DOM rasterize step this controller does not perform) via `replaceElement`.
+     */
+    reformatPasted(elementId: string, sourceClone: PptxElement, format: PasteSpecialFormat): void;
+    /** Replace one element by id, e.g. after rasterizing it to a picture. */
+    replaceElement(elementId: string, next: PptxElement): void;
 }
 
 interface EditorSnapshot {
@@ -15622,6 +15955,13 @@ declare class EditorState {
     editTemplateMode: boolean;
     interactionActive: boolean;
     clipboard: ElementClipboardPayload | null;
+    /** Ctrl/Cmd+Alt+V dialog visibility. */
+    pasteSpecialDialogOpen: boolean;
+    /** The Paste Options toolbar's target: the elements a normal paste just inserted. */
+    pasteOptionsToolbar: {
+        id: string;
+        sourceClone: PptxElement;
+    }[] | null;
     /**
      * File ▸ Info ▸ Protect Presentation state. Deliberately NOT part of
      * {@link EditorSnapshot}: the secret is session state, not document content,
@@ -15864,6 +16204,19 @@ interface EditorControllerDeps {
      * shell-owned UI state, so the controller only signals the intent.
      */
     toggleFind?(): void;
+    /**
+     * Open the find bar already switched to its Replace row (Ctrl/Cmd+H). The
+     * panel has no distinct find-only/replace mode, so this is the same panel
+     * `toggleFind` opens; kept as its own hook only so a host can tell the two
+     * chords apart if it ever grows one.
+     */
+    toggleFindReplace?(): void;
+    /**
+     * Insert a new slide after the active one (Ctrl+M). Optional because the
+     * deck-level API this calls is constructed after the controller (see
+     * `create-viewer-state.svelte.ts`), so a host wires it in once it exists.
+     */
+    newSlide?(): void;
 }
 
 interface EditorMarqueeRect extends MarqueeRect {
@@ -15904,6 +16257,13 @@ declare class EditorController {
     snapLines: readonly SnapLine[];
     editingId: string | null;
     marquee: EditorMarqueeRect | null;
+    /**
+     * The hyperlink dialog, opened by Ctrl+K or the Insert-tab/context-menu
+     * buttons. Lives here (not on the always-mounted `ViewerStage`) so the
+     * keyboard shortcut has one flag to flip regardless of which of those two
+     * pre-existing triggers a host renders.
+     */
+    hyperlinkOpen: boolean;
     constructor(editor: EditorState, deps: EditorControllerDeps);
     /** The elements the pointer acts on (slide, or master/layout), for overlays. */
     get activeElements(): PptxElement[];
@@ -15950,6 +16310,23 @@ declare class EditorController {
         patcher: CollaborationLivePatcher;
         slideId: string;
     } | undefined;
+    /** Open the hyperlink dialog for the current selection (Ctrl+K). */
+    openHyperlink(): void;
+    /**
+     * Apply an element patch built by a formatting shortcut, mid-edit or not.
+     * `InlineTextEditor` has no access to `EditorState`, only to this
+     * controller and the element it is editing, so this is its way to reach
+     * the same `patchSelected` the root keyboard handler and the ribbon use.
+     */
+    patchSelected(patch: Partial<PptxElement> | ((element: PptxElement) => Partial<PptxElement>)): void;
+    /** Arm the format painter from the current selection (Ctrl+Shift+C). */
+    copyFormat(): void;
+    /** Apply the copied format to the current selection (Ctrl+Shift+V). */
+    pasteFormat(): void;
+    /** Open the find bar (Ctrl+F), including mid-edit; see `EditorControllerDeps`. */
+    toggleFind(): void;
+    /** Open the find bar's replace row (Ctrl+H), including mid-edit. */
+    toggleFindReplace(): void;
     /** Commit the inline editor's text onto the element and close it. */
     commitInline(id: string, text: string, snapshot?: InlineTextEditSnapshot): void;
     /** Register a live reader with this viewer's document and editing session. */
@@ -16889,6 +17266,15 @@ declare class PresentationController {
     firstSlide(): void;
     /** End: the show's last slide, skipping trailing hidden slides. */
     lastSlide(): void;
+    /**
+     * Handle a Slide Zoom / Section Zoom / Summary Zoom tile click: navigates
+     * to the target slide, playing the zoom's own `zmPr/@transitionDur` when
+     * authored, and (when `returnToParent` is set) arms an excursion so the
+     * next forward {@link advance} past the target's range returns to the
+     * slide the zoom was clicked from instead of continuing linearly through
+     * the deck.
+     */
+    navigateToZoomTarget(target: ZoomNavigationTarget): void;
     /**
      * Raise the black end-of-slide-show screen without ending anything.
      *

package/dist/viewer/index.js

@@ -1,26 +1,26 @@
-import { Nh as l, Ph as S } from "../transition-overlay-BcUomRXK.js";
-import { A as e, I as a, M as o, N as r, P as s, c as n, d, f as b, i as m, j as t, l as p, m as c, n as g, o as x, p as P, r as w, s as C, t as T, u as $ } from "../export-DoyAdIHl.js";
-var y = a, A = s, V = o, f = t, u = e, R = r;
+import { Qh as l, Zh as S } from "../transition-overlay-CfsPqlES.js";
+import { A as e, I as a, N as o, P as r, a as n, c as d, d as b, f as p, i as c, j as s, k as t, l as m, n as g, o as x, p as w, r as C, s as P, t as T, u as $ } from "../export-BUx-Kmlc.js";
+var y = a, A = r, V = s, f = e, u = t, R = o;
 export {
   f as CollaborationCursors,
   R as EditorLayer,
   T as PowerPointViewer,
-  m as PresentationLoader,
+  c as PresentationLoader,
   u as RemoteSelectionOverlay,
   y as Ribbon,
   V as SlideCanvas,
-  w as ViewerState,
+  C as ViewerState,
   A as ViewerToolbar,
-  d as clampSlideIndex,
-  c as createSvelteAiBridge,
+  $ as clampSlideIndex,
+  w as createSvelteAiBridge,
   g as createViewerState,
-  x as exportAllSlidesToSvg,
-  C as exportAllSlidesToSvgBlobs,
-  n as exportSlideAsSvg,
-  p as exportSlideToSvg,
-  $ as exportSlideToSvgBlob,
+  n as exportAllSlidesToSvg,
+  x as exportAllSlidesToSvgBlobs,
+  P as exportSlideAsSvg,
+  d as exportSlideToSvg,
+  m as exportSlideToSvgBlob,
   b as fitScale,
-  P as resolveNavigationKey,
-  l as zoomInPercent,
-  S as zoomOutPercent
+  p as resolveNavigationKey,
+  S as zoomInPercent,
+  l as zoomOutPercent
 };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pptx-svelte-viewer",
-	"version": "4.2.0",
+	"version": "4.4.0",
 	"description": "Svelte 5 PowerPoint viewer and editor component: render, edit, present, and export PPTX slides in the browser.",
 	"keywords": [
 		"office",

package/dist/canvas_emf-converter-CKs-EBwD.js

@@ -1,5 +0,0 @@
-var e = {};
-throw new Error('Could not resolve "@napi-rs/canvas" imported by "emf-converter". Is it installed?');
-export {
-  e as default
-};