pptx-svelte-viewer 4.3.0 → 4.5.0

package/dist/{translator-BZ6HUBWJ.js → translator-C-KdhJw4.js}

@@ -1119,6 +1119,7 @@ var n = {
   "pptx.media.startAutomatically": "Automatically",
   "pptx.media.playAcrossSlides": "Play across slides",
   "pptx.media.fullScreen": "Full screen",
+  "pptx.media.onlineVideoTitle": "Online video",
   "pptx.media.hideWhenNotPlaying": "Hide when not playing",
   "pptx.media.bookmarks": "Bookmarks",
   "pptx.media.bookmark": "Bookmark",
@@ -1186,6 +1187,12 @@ var n = {
   "pptx.compare.noDifferences": "No differences",
   "pptx.compare.summary": "{{added}} added, {{removed}} removed, {{changed}} changed",
   "pptx.compare.title": "Compare",
+  "pptx.canvasContextMenu.ariaLabel": "Canvas context menu",
+  "pptx.canvasContextMenu.formatBackground": "Format Background...",
+  "pptx.canvasContextMenu.gridAndGuides": "Grid and Guides",
+  "pptx.canvasContextMenu.layout": "Layout",
+  "pptx.canvasContextMenu.resetSlide": "Reset Slide",
+  "pptx.canvasContextMenu.ruler": "Ruler",
   "pptx.contextMenu.addComment": "Add Comment",
   "pptx.contextMenu.bringForward": "Bring Forward",
   "pptx.contextMenu.bringToFront": "Bring to Front",
@@ -1195,7 +1202,10 @@ var n = {
   "pptx.contextMenu.deleteColumn": "Delete Column",
   "pptx.contextMenu.deleteRow": "Delete Row",
   "pptx.contextMenu.duplicate": "Duplicate",
+  "pptx.contextMenu.editAltText": "Edit Alt Text...",
   "pptx.contextMenu.editHyperlink": "Edit Hyperlink",
+  "pptx.contextMenu.editText": "Edit Text",
+  "pptx.contextMenu.formatShape": "Format Shape...",
   "pptx.contextMenu.group": "Group",
   "pptx.contextMenu.insertColumnLeft": "Insert Column Left",
   "pptx.contextMenu.insertColumnRight": "Insert Column Right",
@@ -1204,10 +1214,18 @@ var n = {
   "pptx.contextMenu.mergeCells": "Merge Right",
   "pptx.contextMenu.mergeSelectedCells": "Merge Selected Cells",
   "pptx.contextMenu.paste": "Paste",
+  "pptx.contextMenu.saveAsPicture": "Save as Picture...",
   "pptx.contextMenu.sendBackward": "Send Backward",
   "pptx.contextMenu.sendToBack": "Send to Back",
+  "pptx.contextMenu.sizeAndPosition": "Size and Position...",
   "pptx.contextMenu.splitCell": "Split Cell",
   "pptx.contextMenu.ungroup": "Ungroup",
+  "pptx.pasteSpecial.dialogTitle": "Paste Special",
+  "pptx.pasteSpecial.keepSourceFormatting": "Keep Source Formatting",
+  "pptx.pasteSpecial.keepTextOnly": "Keep Text Only",
+  "pptx.pasteSpecial.optionsLabel": "Paste Options",
+  "pptx.pasteSpecial.picture": "Picture",
+  "pptx.pasteSpecial.useDestinationTheme": "Use Destination Theme",
   "pptx.digitalSignatures.badge": "Signed",
   "pptx.digitalSignatures.editWarning": "Editing this presentation will invalidate its digital signatures.",
   "pptx.digitalSignatures.signed": "This presentation is digitally signed.",
@@ -1450,6 +1468,15 @@ var n = {
   "pptx.slideSorter.contextMenu.hideSlides": "Hide Slides",
   "pptx.slideSorter.contextMenu.paste": "Paste",
   "pptx.slideSorter.contextMenu.showSlides": "Show Slides",
+  "pptx.slidesPane.contextMenu.newSlide": "New Slide",
+  "pptx.slidesPane.contextMenu.duplicate": "Duplicate Slide",
+  "pptx.slidesPane.contextMenu.duplicateCount": "Duplicate {{count}} Slides",
+  "pptx.slidesPane.contextMenu.delete": "Delete Slide",
+  "pptx.slidesPane.contextMenu.deleteCount": "Delete {{count}} Slides",
+  "pptx.slidesPane.contextMenu.layout": "Layout",
+  "pptx.slidesPane.contextMenu.hide": "Hide Slide",
+  "pptx.slidesPane.contextMenu.show": "Show Slide",
+  "pptx.slidesPane.contextMenu.addSection": "Add Section",
   "pptx.smartart.cancel": "Cancel",
   "pptx.smartart.close": "Close",
   "pptx.smartart.insert": "Insert",
@@ -1521,6 +1548,12 @@ var n = {
   "pptx.transition.morphOption.byObject": "By Object",
   "pptx.transition.morphOption.byWord": "By Word",
   "pptx.transition.morphOption.byChar": "By Character",
+  "pptx.transition.pattern": "Pattern",
+  "pptx.transition.pattern.diamond": "Diamond",
+  "pptx.transition.pattern.hexagon": "Hexagon",
+  "pptx.transition.pattern.strip": "Strips",
+  "pptx.transition.pattern.rectangle": "Rectangles",
+  "pptx.transition.thruBlk": "Through black",
   "pptx.contextMenu.ariaLabel": "Context menu",
   "pptx.editorToolbar.ariaLabel": "Editor toolbar",
   "pptx.editorToolbar.insert": "Insert",

package/dist/viewer/index.d.ts

@@ -1693,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`). */
@@ -1795,6 +1805,15 @@ interface TextStyle {
   textInnerShadowOffsetX?: number;
   /** Text inner shadow vertical offset in px. */
   textInnerShadowOffsetY?: number;
+  /**
+   * Original inner-shadow colour-choice XML (`a:innerShdw`'s
+   * `a:prstClr`/`a:schemeClr`/`a:srgbClr`/… child), preserved verbatim so an
+   * authored preset or theme colour round-trips instead of always being
+   * re-serialized as a resolved `a:srgbClr`. Mirrors {@link textGlowColorXml}.
+   */
+  textInnerShadowColorXml?: XmlObject;
+  /** Theme colour slot the inner shadow colour resolved from, when it is `a:schemeClr`. */
+  textInnerShadowColorRef?: PptxThemeColorRef;
   /** Preset shadow type from `a:prstShdw/@prst` (e.g. "shdw1"..."shdw20"). */
   textPresetShadowName?: string;
   /** Preset shadow colour as hex string. */
@@ -1807,6 +1826,18 @@ interface TextStyle {
   textPresetShadowDirection?: number;
   /** Text blur effect radius in px (`a:blur`). */
   textBlurRadius?: number;
+  /**
+   * Text soft-edge radius in px (`a:softEdge/@rad`).
+   *
+   * Feathers the glyph's own edges (a uniform blur of the alpha silhouette,
+   * the same effect a shape's `a:softEdge` gives its fill), unrelated to
+   * `a:blur` (which blurs the whole run, colour included) or a shadow. Never
+   * parsed before this field existed, so `a:softEdge` on a run was silently
+   * dropped: PowerPoint fades the glyphs to near-transparent at their
+   * outline (COM-verified, `audit-text` slide 14's "SOFTEDGE" run), while
+   * the viewer painted them fully crisp.
+   */
+  textSoftEdgeRadius?: number;
   /**
    * Raw `a:effectDag` XML node from `a:rPr`, preserved verbatim for
    * round-trip serialisation. Mirrors the shape-level
@@ -1846,6 +1877,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. */
@@ -1982,6 +2022,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`. */
@@ -3418,6 +3470,15 @@ interface PptxChartHistogramOptions {
   intervalClosed?: 'l' | 'r';
   underflow?: number | 'auto';
   overflow?: number | 'auto';
+  /**
+   * `c:layoutPr/cx:aggregation` was authored instead of `cx:binning`: the
+   * raw rows are CATEGORICAL (a Pareto chart's `clusteredColumn` series
+   * counting occurrences of each authored category, COM-verified against
+   * charts-com.pptx slide 31 / chartEx6.xml), not a numeric range to bin.
+   * Mutually exclusive with `binSize`/`binCount`/`intervalClosed`, which
+   * only apply to a true numeric-value histogram.
+   */
+  aggregateByCategory?: boolean;
 }
 /** Office 2016 ChartEx waterfall series layout options. */
 interface PptxChartWaterfallOptions {
@@ -4082,6 +4143,18 @@ interface PptxChartData {
    * the source" and callers should treat it as `true`. Surface only.
    */
   wireframe?: boolean;
+  /**
+   * Whether the surface chart is the 2-D "top view" projection
+   * (`c:surfaceChart`, PowerPoint's "Contour" / "Wireframe Contour" types)
+   * rather than the 3-D isometric one (`c:surface3DChart`, "3-D Surface" /
+   * "3-D Surface (Wireframe)"). Both element names map to chart type
+   * `"surface"`; this bit is the only thing that tells the renderer which
+   * of the two projections PowerPoint actually drew, since a top-view
+   * surface has no Z-axis at all (only category and series axes) while the
+   * 3-D one draws all three. Surface only; `undefined` for every other
+   * chart type.
+   */
+  surfaceTopView?: boolean;
   /**
    * Scatter presentation mode (`c:scatterChart/c:scatterStyle/@val`).
    *
@@ -7271,11 +7344,17 @@ interface ZoomPptxElement extends PptxElementBase, PptxImageProperties {
    * `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.
+   * 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;
   /**
@@ -9285,7 +9364,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;
@@ -12152,7 +12236,7 @@ interface ReflectionWrapperStyle {
   top: string;
   width: string;
   height: string;
-  /** Mirror (`scaleY(-1)`) composed with `@sx`/`@sy`/`@kx`/`@ky`/`@rot`. */
+  /** `scale(@sx, @sy)` (the sign of `@sy` IS the mirror) composed with `@kx`/`@ky`/`@rot`. */
   transform: string;
   /** Anchor point for the transform above, from `@algn` (default `center top`). */
   transformOrigin: string;
@@ -13191,6 +13275,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 {
@@ -13336,6 +13424,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. */
@@ -15237,6 +15347,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 {
@@ -15577,6 +15702,13 @@ declare class EditorSlidesController {
     constructor(editor: EditorState);
     /** Insert a blank slide after the current one. Returns its new index, or null when not editable. */
     insertSlideAfterCurrent(): number | null;
+    /**
+     * Insert a blank slide after `index` (the thumbnail context menu's New
+     * Slide, and Enter on a focused thumbnail, both of which may target a slide
+     * other than the currently active one). Returns the new index, or null
+     * when not editable.
+     */
+    insertSlideAfter(index: number): number | null;
     /**
      * Insert a shared-catalogue template slide after the current one, as one
      * undoable step (Home > Slide Templates gallery). The caller (the gallery
@@ -15605,6 +15737,12 @@ declare class EditorSlidesController {
     deleteSlideAtIndex(index: number): number | null;
     /** Toggle the hidden flag on the slide at `index` (the sorter's context-menu target). */
     toggleSlideHidden(index: number): void;
+    /** Duplicate every selected slide (the thumbnail context menu's multi-select bulk Duplicate). */
+    duplicateSlides(indexes: readonly number[]): void;
+    /** Delete every selected slide (the thumbnail context menu's multi-select bulk Delete). */
+    deleteSlides(indexes: readonly number[]): void;
+    /** Toggle hidden on every selected slide (the thumbnail context menu's multi-select bulk Hide/Show). */
+    toggleSlidesHidden(indexes: readonly number[]): void;
     /**
      * The layouts available for the current slide (its master's layouts),
      * resolved via the core `getAvailableLayoutsForSlide` API. Empty when no
@@ -15872,6 +16010,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,
@@ -16078,6 +16223,12 @@ interface EditorControllerDeps {
      * model, so the cell under the pointer is the target.
      */
     onContextMenu?(x: number, y: number, cell: ContextMenuCellTarget | null): void;
+    /**
+     * Open the EMPTY-CANVAS context menu at viewport `x`/`y` (no element under
+     * the cursor). Mutually exclusive with {@link onContextMenu}: opening one
+     * closes the other.
+     */
+    onCanvasContextMenu?(x: number, y: number): void;
     getSnapToGrid?(): boolean;
     /**
      * Grid spacing in CSS px for snap-to-grid, derived from the deck's
@@ -16268,6 +16419,11 @@ interface StageContextMenu {
     y: number;
     cell: ContextMenuCellTarget | null;
 }
+/** Where the empty-canvas (no element hit) context menu opened. */
+interface StageCanvasContextMenu {
+    x: number;
+    y: number;
+}
 
 /**
  * Reactive Find & Replace panel state for the Home tab's Editing group.
@@ -17176,6 +17332,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.
      *
@@ -17858,6 +18023,7 @@ interface ViewerStateBag {
     /** `Date.now()` timestamp of the last `enterPresenterView()` call; the presenter view's elapsed-time display. */
     readonly presenterStartedAt: number;
     stageContextMenu: StageContextMenu | null;
+    stageCanvasContextMenu: StageCanvasContextMenu | null;
     readonly activeMobileSheet: MobileSheetKey;
     setActiveMobileSheet(next: MobileSheetKey): void;
     readonly notesExpanded: boolean;

package/dist/viewer/index.js

@@ -1,26 +1,26 @@
-import { Bh as l, zh as S } from "../transition-overlay-BmUNA9xJ.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 w, r as C, s as P, t as T, u as $ } from "../export-CVIAWQ_T.js";
-var y = a, A = s, V = o, f = t, u = e, B = r;
+import { ng as l, rg as S } from "../transition-overlay-BfpjfjU4.js";
+import { A as e, I as a, N as o, P as r, a as v, c as d, d as b, f as p, i as c, j as s, k as t, l as g, n as m, o as x, p as w, r as C, s as P, t as T, u as $ } from "../export-Bln1wHMQ.js";
+var y = a, A = r, V = s, f = e, u = t, R = o;
 export {
   f as CollaborationCursors,
-  B as EditorLayer,
+  R as EditorLayer,
   T as PowerPointViewer,
-  m as PresentationLoader,
+  c as PresentationLoader,
   u as RemoteSelectionOverlay,
   y as Ribbon,
   V as SlideCanvas,
   C as ViewerState,
   A as ViewerToolbar,
-  d as clampSlideIndex,
-  c as createSvelteAiBridge,
-  g as createViewerState,
-  x as exportAllSlidesToSvg,
-  P as exportAllSlidesToSvgBlobs,
-  n as exportSlideAsSvg,
-  p as exportSlideToSvg,
-  $ as exportSlideToSvgBlob,
+  $ as clampSlideIndex,
+  w as createSvelteAiBridge,
+  m as createViewerState,
+  v as exportAllSlidesToSvg,
+  x as exportAllSlidesToSvgBlobs,
+  P as exportSlideAsSvg,
+  d as exportSlideToSvg,
+  g as exportSlideToSvgBlob,
   b as fitScale,
-  w as resolveNavigationKey,
-  S as zoomInPercent,
-  l as zoomOutPercent
+  p as resolveNavigationKey,
+  l as zoomInPercent,
+  S as zoomOutPercent
 };

package/package.json

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