pptx-react-viewer 4.3.0 → 4.5.0

package/dist/viewer/index.d.ts

@@ -1694,6 +1694,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 +1806,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. */
@@ -1808,6 +1827,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
@@ -1847,6 +1878,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. */
@@ -1983,6 +2023,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`. */
@@ -3419,6 +3471,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 {
@@ -4083,6 +4144,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`).
    *
@@ -7272,11 +7345,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;
   /**
@@ -9276,7 +9355,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;
@@ -12734,8 +12818,13 @@ interface ElementContextMenuState {
   y: number;
   elementId: string;
 }
+/** Tracks the position of an open empty-canvas (no element hit) context menu. */
+interface CanvasContextMenuState {
+  x: number;
+  y: number;
+}
 /** Identifies an action triggered from the element right-click context menu. */
-type ElementContextMenuAction = 'copy' | 'cut' | 'paste' | 'duplicate' | 'delete' | 'bring-forward' | 'send-backward' | 'bring-front' | 'send-back' | 'bringForward' | 'sendBackward' | 'bringToFront' | 'sendToBack' | 'comment' | 'addComment' | 'group' | 'ungroup' | 'editPoints' | 'editHyperlink';
+type ElementContextMenuAction = 'copy' | 'cut' | 'paste' | 'duplicate' | 'delete' | 'bring-forward' | 'send-backward' | 'bring-front' | 'send-back' | 'bringForward' | 'sendBackward' | 'bringToFront' | 'sendToBack' | 'comment' | 'addComment' | 'group' | 'ungroup' | 'editPoints' | 'editHyperlink' | 'edit-text' | 'save-as-picture' | 'edit-alt-text' | 'size-and-position' | 'format-shape';
 /**
  * State of an active marquee (rubber-band) selection rectangle.
  * Created when the user clicks and drags on the canvas background,
@@ -13479,4 +13568,4 @@ interface CollaborationStatusIndicatorProps {
 declare function CollaborationStatusIndicator({ status, connectedCount, onRetry }: CollaborationStatusIndicatorProps): React__default.ReactElement;
 
 export { CollaborationProvider, CollaborationStatusIndicator, PowerPointViewer, RemoteUserCursors, UserAvatarBar, clearAudienceContent, forgetSessionDeck, getAnimationInitialStyle, getSessionTabId, isAudienceTab, loadAudienceContent, loadSessionDeck, parseAudienceNonce, rememberSessionDeck, restoreSessionDeck, storeAudienceContent, useCollaborativeHistory, useCollaborativeState, usePresenceTracking, useThemeSwitching, useYjsProvider };
-export type { AccessibilityIssue, AnimationPresetOption, CanvasSize, CollaborationConfig, CollaborationContextValue, CollaborationRole, CollaborationStatusIndicatorProps, ConnectionStatus, ConnectorArrowOption, ConnectorGeometryOption, ConnectorGeometryType, ConnectorPathGeometry, DragState, DrawingTool, EditorHistorySnapshot, ElementBounds, ElementClipboardPayload, ElementContextMenuAction, ElementContextMenuState, ExternalCollaborationAwareness, ExternalCollaborationSession, ExternalCollaborationSnapshot, FileViewerHandle, MarqueeSelectionState, ParsedTableCell, ParsedTableData, PowerPointViewerHandle, PowerPointViewerProps, PptxAiBridge, PptxAiConfig, PptxAiConnection, PptxAiContextStrategy, PptxAiToolName, PptxAiWritePolicy, PresentationAnimationRuntime, RemoteUserCursorsProps, ResizeHandle, ResizeState, SessionDeck, ShapeAdjustmentDragState, ShapeAdjustmentHandleDescriptor, ShapePreset, ShapeQuickStyle, ShortcutReferenceItem, SlideAlignment, SlideSectionGroup, SlideTransitionOption, StrokeDashOption, SupportedShapeType, TableCellEditorState, ThemeSwitchingResult, ToolbarSection, UseCollaborativeHistoryResult, UseCollaborativeStateInput, UsePresenceTrackingResult, UseThemeSwitchingInput, UserAvatarBarProps, UserPresence, ViewerMode };
+export type { AccessibilityIssue, AnimationPresetOption, CanvasContextMenuState, CanvasSize, CollaborationConfig, CollaborationContextValue, CollaborationRole, CollaborationStatusIndicatorProps, ConnectionStatus, ConnectorArrowOption, ConnectorGeometryOption, ConnectorGeometryType, ConnectorPathGeometry, DragState, DrawingTool, EditorHistorySnapshot, ElementBounds, ElementClipboardPayload, ElementContextMenuAction, ElementContextMenuState, ExternalCollaborationAwareness, ExternalCollaborationSession, ExternalCollaborationSnapshot, FileViewerHandle, MarqueeSelectionState, ParsedTableCell, ParsedTableData, PowerPointViewerHandle, PowerPointViewerProps, PptxAiBridge, PptxAiConfig, PptxAiConnection, PptxAiContextStrategy, PptxAiToolName, PptxAiWritePolicy, PresentationAnimationRuntime, RemoteUserCursorsProps, ResizeHandle, ResizeState, SessionDeck, ShapeAdjustmentDragState, ShapeAdjustmentHandleDescriptor, ShapePreset, ShapeQuickStyle, ShortcutReferenceItem, SlideAlignment, SlideSectionGroup, SlideTransitionOption, StrokeDashOption, SupportedShapeType, TableCellEditorState, ThemeSwitchingResult, ToolbarSection, UseCollaborativeHistoryResult, UseCollaborativeStateInput, UsePresenceTrackingResult, UseThemeSwitchingInput, UserAvatarBarProps, UserPresence, ViewerMode };

package/dist/viewer/index.js

@@ -1,96 +1,96 @@
 'use strict';
 
-var chunk42XEZVUQ_js = require('../chunk-42XEZVUQ.js');
-require('../chunk-KAO5USPE.js');
-var chunkY7LI2JIR_js = require('../chunk-Y7LI2JIR.js');
-var chunkE7O4HTS5_js = require('../chunk-E7O4HTS5.js');
-var chunkUTI4CLYJ_js = require('../chunk-UTI4CLYJ.js');
-require('../chunk-W5KLLGVH.js');
+var chunkUZFCFYK6_js = require('../chunk-UZFCFYK6.js');
+require('../chunk-T35BGKZG.js');
+var chunkY4VRYQQS_js = require('../chunk-Y4VRYQQS.js');
+var chunk6FVYG27J_js = require('../chunk-6FVYG27J.js');
+var chunkLYZQLV7R_js = require('../chunk-LYZQLV7R.js');
+require('../chunk-UMQV2432.js');
 require('../chunk-4VNS5WPM.js');
 
 
 
 Object.defineProperty(exports, "CollaborationStatusIndicator", {
   enumerable: true,
-  get: function () { return chunk42XEZVUQ_js.CollaborationStatusIndicator; }
+  get: function () { return chunkUZFCFYK6_js.CollaborationStatusIndicator; }
 });
 Object.defineProperty(exports, "PowerPointViewer", {
   enumerable: true,
-  get: function () { return chunk42XEZVUQ_js.PowerPointViewer; }
+  get: function () { return chunkUZFCFYK6_js.PowerPointViewer; }
 });
 Object.defineProperty(exports, "UserAvatarBar", {
   enumerable: true,
-  get: function () { return chunk42XEZVUQ_js.UserAvatarBar; }
+  get: function () { return chunkUZFCFYK6_js.UserAvatarBar; }
 });
 Object.defineProperty(exports, "CollaborationProvider", {
   enumerable: true,
-  get: function () { return chunkY7LI2JIR_js.CollaborationProvider; }
+  get: function () { return chunkY4VRYQQS_js.CollaborationProvider; }
 });
 Object.defineProperty(exports, "RemoteUserCursors", {
   enumerable: true,
-  get: function () { return chunkY7LI2JIR_js.RemoteUserCursors; }
+  get: function () { return chunkY4VRYQQS_js.RemoteUserCursors; }
 });
 Object.defineProperty(exports, "isAudienceTab", {
   enumerable: true,
-  get: function () { return chunkY7LI2JIR_js.isAudienceTab; }
+  get: function () { return chunkY4VRYQQS_js.isAudienceTab; }
 });
 Object.defineProperty(exports, "parseAudienceNonce", {
   enumerable: true,
-  get: function () { return chunkY7LI2JIR_js.parseAudienceNonce; }
+  get: function () { return chunkY4VRYQQS_js.parseAudienceNonce; }
 });
 Object.defineProperty(exports, "useCollaborativeHistory", {
   enumerable: true,
-  get: function () { return chunkY7LI2JIR_js.useCollaborativeHistory; }
+  get: function () { return chunkY4VRYQQS_js.useCollaborativeHistory; }
 });
 Object.defineProperty(exports, "useCollaborativeState", {
   enumerable: true,
-  get: function () { return chunkY7LI2JIR_js.useCollaborativeState; }
+  get: function () { return chunkY4VRYQQS_js.useCollaborativeState; }
 });
 Object.defineProperty(exports, "usePresenceTracking", {
   enumerable: true,
-  get: function () { return chunkY7LI2JIR_js.usePresenceTracking; }
+  get: function () { return chunkY4VRYQQS_js.usePresenceTracking; }
 });
 Object.defineProperty(exports, "useThemeSwitching", {
   enumerable: true,
-  get: function () { return chunkY7LI2JIR_js.useThemeSwitching; }
+  get: function () { return chunkY4VRYQQS_js.useThemeSwitching; }
 });
 Object.defineProperty(exports, "useYjsProvider", {
   enumerable: true,
-  get: function () { return chunkY7LI2JIR_js.useYjsProvider; }
+  get: function () { return chunkY4VRYQQS_js.useYjsProvider; }
 });
 Object.defineProperty(exports, "getAnimationInitialStyle", {
   enumerable: true,
-  get: function () { return chunkE7O4HTS5_js.getAnimationInitialStyle; }
+  get: function () { return chunk6FVYG27J_js.getAnimationInitialStyle; }
 });
 Object.defineProperty(exports, "clearAudienceContent", {
   enumerable: true,
-  get: function () { return chunkUTI4CLYJ_js.clearAudienceContent; }
+  get: function () { return chunkLYZQLV7R_js.clearAudienceContent; }
 });
 Object.defineProperty(exports, "forgetSessionDeck", {
   enumerable: true,
-  get: function () { return chunkUTI4CLYJ_js.forgetSessionDeck; }
+  get: function () { return chunkLYZQLV7R_js.forgetSessionDeck; }
 });
 Object.defineProperty(exports, "getSessionTabId", {
   enumerable: true,
-  get: function () { return chunkUTI4CLYJ_js.getSessionTabId; }
+  get: function () { return chunkLYZQLV7R_js.getSessionTabId; }
 });
 Object.defineProperty(exports, "loadAudienceContent", {
   enumerable: true,
-  get: function () { return chunkUTI4CLYJ_js.loadAudienceContent; }
+  get: function () { return chunkLYZQLV7R_js.loadAudienceContent; }
 });
 Object.defineProperty(exports, "loadSessionDeck", {
   enumerable: true,
-  get: function () { return chunkUTI4CLYJ_js.loadSessionDeck; }
+  get: function () { return chunkLYZQLV7R_js.loadSessionDeck; }
 });
 Object.defineProperty(exports, "rememberSessionDeck", {
   enumerable: true,
-  get: function () { return chunkUTI4CLYJ_js.rememberSessionDeck; }
+  get: function () { return chunkLYZQLV7R_js.rememberSessionDeck; }
 });
 Object.defineProperty(exports, "restoreSessionDeck", {
   enumerable: true,
-  get: function () { return chunkUTI4CLYJ_js.restoreSessionDeck; }
+  get: function () { return chunkLYZQLV7R_js.restoreSessionDeck; }
 });
 Object.defineProperty(exports, "storeAudienceContent", {
   enumerable: true,
-  get: function () { return chunkUTI4CLYJ_js.storeAudienceContent; }
+  get: function () { return chunkLYZQLV7R_js.storeAudienceContent; }
 });

package/dist/viewer/index.mjs

@@ -1,7 +1,7 @@
-export { CollaborationStatusIndicator, PowerPointViewer, UserAvatarBar } from '../chunk-RXYLPESV.mjs';
-import '../chunk-YQJOCGOK.mjs';
-export { CollaborationProvider, RemoteUserCursors, isAudienceTab, parseAudienceNonce, useCollaborativeHistory, useCollaborativeState, usePresenceTracking, useThemeSwitching, useYjsProvider } from '../chunk-SKTZSG7Q.mjs';
-export { getAnimationInitialStyle } from '../chunk-PLDG3CXW.mjs';
-export { clearAudienceContent, forgetSessionDeck, getSessionTabId, loadAudienceContent, loadSessionDeck, rememberSessionDeck, restoreSessionDeck, storeAudienceContent } from '../chunk-3UWJWJCR.mjs';
-import '../chunk-OBQ453H6.mjs';
+export { CollaborationStatusIndicator, PowerPointViewer, UserAvatarBar } from '../chunk-IDV2ITXM.mjs';
+import '../chunk-DX2JCSQ4.mjs';
+export { CollaborationProvider, RemoteUserCursors, isAudienceTab, parseAudienceNonce, useCollaborativeHistory, useCollaborativeState, usePresenceTracking, useThemeSwitching, useYjsProvider } from '../chunk-PRXJ3J5W.mjs';
+export { getAnimationInitialStyle } from '../chunk-ZF5S3HHW.mjs';
+export { clearAudienceContent, forgetSessionDeck, getSessionTabId, loadAudienceContent, loadSessionDeck, rememberSessionDeck, restoreSessionDeck, storeAudienceContent } from '../chunk-VZNIVS3X.mjs';
+import '../chunk-APAVAD2A.mjs';
 import '../chunk-XGB3TDIC.mjs';

package/package.json

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