pptx-react-viewer 4.3.0 → 4.4.0

package/dist/index.d.ts

@@ -1713,6 +1713,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`). */
@@ -1866,6 +1876,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. */
@@ -2002,6 +2021,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`. */
@@ -7291,11 +7322,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;
   /**
@@ -9295,7 +9332,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;
@@ -13153,6 +13195,28 @@ interface EditorImagePasteOptions {
   insertElement(element: ImagePptxElement): void;
 }
 //#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;
+}
+//#endregion
 //#region src/render/account.d.ts
 /** Local-only display profile shown in File > Account. Never sent anywhere; purely cosmetic. */
 interface ViewerProfile {
@@ -14494,7 +14558,7 @@ interface SlideCanvasProps {
   /** All slides in the presentation (for zoom element thumbnails). */
   allSlides?: readonly PptxSlide[];
   /** Callback fired when a zoom element is clicked in presentation mode. */
-  onZoomClick?: (targetSlideIndex: number, returnSlideIndex: number) => void;
+  onZoomClick?: (target: ZoomNavigationTarget, returnSlideIndex: number) => void;
   /** Index of the current slide (for zoom return navigation). */
   sourceSlideIndex?: number;
   /** Context for text field placeholder substitution (slide number, header/footer, etc.). */

package/dist/index.js

@@ -1,184 +1,184 @@
 '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');
-var chunkW5KLLGVH_js = require('./chunk-W5KLLGVH.js');
+var chunkAI6K5EAE_js = require('./chunk-AI6K5EAE.js');
+require('./chunk-CSY422LU.js');
+var chunkYJKR7Z3X_js = require('./chunk-YJKR7Z3X.js');
+var chunkOWTHF5N4_js = require('./chunk-OWTHF5N4.js');
+var chunk7WWINBGF_js = require('./chunk-7WWINBGF.js');
+var chunkI4D6JQOI_js = require('./chunk-I4D6JQOI.js');
 require('./chunk-4VNS5WPM.js');
 
 
 
 Object.defineProperty(exports, "PowerPointViewer", {
   enumerable: true,
-  get: function () { return chunk42XEZVUQ_js.PowerPointViewer; }
+  get: function () { return chunkAI6K5EAE_js.PowerPointViewer; }
 });
 Object.defineProperty(exports, "SlideCanvas", {
   enumerable: true,
-  get: function () { return chunk42XEZVUQ_js.SlideCanvas; }
+  get: function () { return chunkAI6K5EAE_js.SlideCanvas; }
 });
 Object.defineProperty(exports, "SlideTemplateGalleryDialog", {
   enumerable: true,
-  get: function () { return chunk42XEZVUQ_js.SlideTemplateGalleryDialog; }
+  get: function () { return chunkAI6K5EAE_js.SlideTemplateGalleryDialog; }
 });
 Object.defineProperty(exports, "SlideTemplatePreview", {
   enumerable: true,
-  get: function () { return chunk42XEZVUQ_js.SlideTemplatePreview; }
+  get: function () { return chunkAI6K5EAE_js.SlideTemplatePreview; }
 });
 Object.defineProperty(exports, "Toolbar", {
   enumerable: true,
-  get: function () { return chunk42XEZVUQ_js.Toolbar; }
+  get: function () { return chunkAI6K5EAE_js.Toolbar; }
 });
 Object.defineProperty(exports, "ViewerThemeProvider", {
   enumerable: true,
-  get: function () { return chunk42XEZVUQ_js.ViewerThemeProvider; }
+  get: function () { return chunkAI6K5EAE_js.ViewerThemeProvider; }
 });
 Object.defineProperty(exports, "useViewerTheme", {
   enumerable: true,
-  get: function () { return chunk42XEZVUQ_js.useViewerTheme; }
+  get: function () { return chunkAI6K5EAE_js.useViewerTheme; }
 });
 Object.defineProperty(exports, "renderToCanvas", {
   enumerable: true,
-  get: function () { return chunkY7LI2JIR_js.renderToCanvas; }
+  get: function () { return chunkYJKR7Z3X_js.renderToCanvas; }
 });
 Object.defineProperty(exports, "useViewerBuildingBlocks", {
   enumerable: true,
-  get: function () { return chunkY7LI2JIR_js.useViewerBuildingBlocks; }
+  get: function () { return chunkYJKR7Z3X_js.useViewerBuildingBlocks; }
 });
 Object.defineProperty(exports, "getAnimationInitialStyle", {
   enumerable: true,
-  get: function () { return chunkE7O4HTS5_js.getAnimationInitialStyle; }
+  get: function () { return chunkOWTHF5N4_js.getAnimationInitialStyle; }
 });
 Object.defineProperty(exports, "AVATAR_COLOR_SWATCHES", {
   enumerable: true,
-  get: function () { return chunkUTI4CLYJ_js.AVATAR_COLOR_SWATCHES; }
+  get: function () { return chunk7WWINBGF_js.AVATAR_COLOR_SWATCHES; }
 });
 Object.defineProperty(exports, "DEFAULT_VIEWER_PROFILE", {
   enumerable: true,
-  get: function () { return chunkUTI4CLYJ_js.DEFAULT_VIEWER_PROFILE; }
+  get: function () { return chunk7WWINBGF_js.DEFAULT_VIEWER_PROFILE; }
 });
 Object.defineProperty(exports, "PPTX_OPEN_ACCEPT", {
   enumerable: true,
-  get: function () { return chunkUTI4CLYJ_js.PPTX_OPEN_ACCEPT; }
+  get: function () { return chunk7WWINBGF_js.PPTX_OPEN_ACCEPT; }
 });
 Object.defineProperty(exports, "PRESENTATION_OPEN_EXTENSIONS", {
   enumerable: true,
-  get: function () { return chunkUTI4CLYJ_js.PRESENTATION_OPEN_EXTENSIONS; }
+  get: function () { return chunk7WWINBGF_js.PRESENTATION_OPEN_EXTENSIONS; }
 });
 Object.defineProperty(exports, "SLIDE_TEMPLATES", {
   enumerable: true,
-  get: function () { return chunkUTI4CLYJ_js.SLIDE_TEMPLATES; }
+  get: function () { return chunk7WWINBGF_js.SLIDE_TEMPLATES; }
 });
 Object.defineProperty(exports, "THEME_CATALOG", {
   enumerable: true,
-  get: function () { return chunkUTI4CLYJ_js.THEME_CATALOG; }
+  get: function () { return chunk7WWINBGF_js.THEME_CATALOG; }
 });
 Object.defineProperty(exports, "VIEWER_PREFS_STORAGE_KEY", {
   enumerable: true,
-  get: function () { return chunkUTI4CLYJ_js.VIEWER_PREFS_STORAGE_KEY; }
+  get: function () { return chunk7WWINBGF_js.VIEWER_PREFS_STORAGE_KEY; }
 });
 Object.defineProperty(exports, "buildSlideTemplateContent", {
   enumerable: true,
-  get: function () { return chunkUTI4CLYJ_js.buildSlideTemplateContent; }
+  get: function () { return chunk7WWINBGF_js.buildSlideTemplateContent; }
 });
 Object.defineProperty(exports, "buildSlideTemplateSlide", {
   enumerable: true,
-  get: function () { return chunkUTI4CLYJ_js.buildSlideTemplateSlide; }
+  get: function () { return chunk7WWINBGF_js.buildSlideTemplateSlide; }
 });
 Object.defineProperty(exports, "clearAllLocalViewerData", {
   enumerable: true,
-  get: function () { return chunkUTI4CLYJ_js.clearAllLocalViewerData; }
+  get: function () { return chunk7WWINBGF_js.clearAllLocalViewerData; }
 });
 Object.defineProperty(exports, "clearStoredViewerPrefs", {
   enumerable: true,
-  get: function () { return chunkUTI4CLYJ_js.clearStoredViewerPrefs; }
+  get: function () { return chunk7WWINBGF_js.clearStoredViewerPrefs; }
 });
 Object.defineProperty(exports, "createImageElementFromFile", {
   enumerable: true,
-  get: function () { return chunkUTI4CLYJ_js.createImageElementFromFile; }
+  get: function () { return chunk7WWINBGF_js.createImageElementFromFile; }
 });
 Object.defineProperty(exports, "defaultCssVars", {
   enumerable: true,
-  get: function () { return chunkUTI4CLYJ_js.defaultCssVars; }
+  get: function () { return chunk7WWINBGF_js.defaultCssVars; }
 });
 Object.defineProperty(exports, "defaultRadius", {
   enumerable: true,
-  get: function () { return chunkUTI4CLYJ_js.defaultRadius; }
+  get: function () { return chunk7WWINBGF_js.defaultRadius; }
 });
 Object.defineProperty(exports, "defaultThemeColors", {
   enumerable: true,
-  get: function () { return chunkUTI4CLYJ_js.defaultThemeColors; }
+  get: function () { return chunk7WWINBGF_js.defaultThemeColors; }
 });
 Object.defineProperty(exports, "describeCollaborationShellState", {
   enumerable: true,
-  get: function () { return chunkUTI4CLYJ_js.describeCollaborationShellState; }
+  get: function () { return chunk7WWINBGF_js.describeCollaborationShellState; }
 });
 Object.defineProperty(exports, "getLocalStorageUsageSummary", {
   enumerable: true,
-  get: function () { return chunkUTI4CLYJ_js.getLocalStorageUsageSummary; }
+  get: function () { return chunk7WWINBGF_js.getLocalStorageUsageSummary; }
 });
 Object.defineProperty(exports, "isLegacyBinaryPresentation", {
   enumerable: true,
-  get: function () { return chunkUTI4CLYJ_js.isLegacyBinaryPresentation; }
+  get: function () { return chunk7WWINBGF_js.isLegacyBinaryPresentation; }
 });
 Object.defineProperty(exports, "isSupportedPresentationFile", {
   enumerable: true,
-  get: function () { return chunkUTI4CLYJ_js.isSupportedPresentationFile; }
+  get: function () { return chunk7WWINBGF_js.isSupportedPresentationFile; }
 });
 Object.defineProperty(exports, "presentationBaseName", {
   enumerable: true,
-  get: function () { return chunkUTI4CLYJ_js.presentationBaseName; }
+  get: function () { return chunk7WWINBGF_js.presentationBaseName; }
 });
 Object.defineProperty(exports, "readStoredViewerPrefs", {
   enumerable: true,
-  get: function () { return chunkUTI4CLYJ_js.readStoredViewerPrefs; }
+  get: function () { return chunk7WWINBGF_js.readStoredViewerPrefs; }
 });
 Object.defineProperty(exports, "resolveProfileInitial", {
   enumerable: true,
-  get: function () { return chunkUTI4CLYJ_js.resolveProfileInitial; }
+  get: function () { return chunk7WWINBGF_js.resolveProfileInitial; }
 });
 Object.defineProperty(exports, "resolveThemeCatalogEntry", {
   enumerable: true,
-  get: function () { return chunkUTI4CLYJ_js.resolveThemeCatalogEntry; }
+  get: function () { return chunk7WWINBGF_js.resolveThemeCatalogEntry; }
 });
 Object.defineProperty(exports, "saveViewerProfile", {
   enumerable: true,
-  get: function () { return chunkUTI4CLYJ_js.saveViewerProfile; }
+  get: function () { return chunk7WWINBGF_js.saveViewerProfile; }
 });
 Object.defineProperty(exports, "savedPresentationFileName", {
   enumerable: true,
-  get: function () { return chunkUTI4CLYJ_js.savedPresentationFileName; }
+  get: function () { return chunk7WWINBGF_js.savedPresentationFileName; }
 });
 Object.defineProperty(exports, "themeToCssVars", {
   enumerable: true,
-  get: function () { return chunkUTI4CLYJ_js.themeToCssVars; }
+  get: function () { return chunk7WWINBGF_js.themeToCssVars; }
 });
 Object.defineProperty(exports, "vermilionDarkColors", {
   enumerable: true,
-  get: function () { return chunkUTI4CLYJ_js.vermilionDarkColors; }
+  get: function () { return chunk7WWINBGF_js.vermilionDarkColors; }
 });
 Object.defineProperty(exports, "vermilionDarkTheme", {
   enumerable: true,
-  get: function () { return chunkUTI4CLYJ_js.vermilionDarkTheme; }
+  get: function () { return chunk7WWINBGF_js.vermilionDarkTheme; }
 });
 Object.defineProperty(exports, "vermilionLightColors", {
   enumerable: true,
-  get: function () { return chunkUTI4CLYJ_js.vermilionLightColors; }
+  get: function () { return chunk7WWINBGF_js.vermilionLightColors; }
 });
 Object.defineProperty(exports, "vermilionLightTheme", {
   enumerable: true,
-  get: function () { return chunkUTI4CLYJ_js.vermilionLightTheme; }
+  get: function () { return chunk7WWINBGF_js.vermilionLightTheme; }
 });
 Object.defineProperty(exports, "vermilionRadius", {
   enumerable: true,
-  get: function () { return chunkUTI4CLYJ_js.vermilionRadius; }
+  get: function () { return chunk7WWINBGF_js.vermilionRadius; }
 });
 Object.defineProperty(exports, "writeStoredViewerPrefs", {
   enumerable: true,
-  get: function () { return chunkUTI4CLYJ_js.writeStoredViewerPrefs; }
+  get: function () { return chunk7WWINBGF_js.writeStoredViewerPrefs; }
 });
 Object.defineProperty(exports, "LOCALE_CATALOG", {
   enumerable: true,
-  get: function () { return chunkW5KLLGVH_js.LOCALE_CATALOG; }
+  get: function () { return chunkI4D6JQOI_js.LOCALE_CATALOG; }
 });

package/dist/index.mjs

@@ -1,7 +1,7 @@
-export { PowerPointViewer, SlideCanvas, SlideTemplateGalleryDialog, SlideTemplatePreview, Toolbar, ViewerThemeProvider, useViewerTheme } from './chunk-RXYLPESV.mjs';
-import './chunk-YQJOCGOK.mjs';
-export { renderToCanvas, useViewerBuildingBlocks } from './chunk-SKTZSG7Q.mjs';
-export { getAnimationInitialStyle } from './chunk-PLDG3CXW.mjs';
-export { AVATAR_COLOR_SWATCHES, DEFAULT_VIEWER_PROFILE, PPTX_OPEN_ACCEPT, PRESENTATION_OPEN_EXTENSIONS, SLIDE_TEMPLATES, THEME_CATALOG, VIEWER_PREFS_STORAGE_KEY, buildSlideTemplateContent, buildSlideTemplateSlide, clearAllLocalViewerData, clearStoredViewerPrefs, createImageElementFromFile, defaultCssVars, defaultRadius, defaultThemeColors, describeCollaborationShellState, getLocalStorageUsageSummary, isLegacyBinaryPresentation, isSupportedPresentationFile, presentationBaseName, readStoredViewerPrefs, resolveProfileInitial, resolveThemeCatalogEntry, saveViewerProfile, savedPresentationFileName, themeToCssVars, vermilionDarkColors, vermilionDarkTheme, vermilionLightColors, vermilionLightTheme, vermilionRadius, writeStoredViewerPrefs } from './chunk-3UWJWJCR.mjs';
-export { LOCALE_CATALOG } from './chunk-OBQ453H6.mjs';
+export { PowerPointViewer, SlideCanvas, SlideTemplateGalleryDialog, SlideTemplatePreview, Toolbar, ViewerThemeProvider, useViewerTheme } from './chunk-LUHUYBGW.mjs';
+import './chunk-XMKLY2SE.mjs';
+export { renderToCanvas, useViewerBuildingBlocks } from './chunk-WCHKDZP6.mjs';
+export { getAnimationInitialStyle } from './chunk-WNFHFFYE.mjs';
+export { AVATAR_COLOR_SWATCHES, DEFAULT_VIEWER_PROFILE, PPTX_OPEN_ACCEPT, PRESENTATION_OPEN_EXTENSIONS, SLIDE_TEMPLATES, THEME_CATALOG, VIEWER_PREFS_STORAGE_KEY, buildSlideTemplateContent, buildSlideTemplateSlide, clearAllLocalViewerData, clearStoredViewerPrefs, createImageElementFromFile, defaultCssVars, defaultRadius, defaultThemeColors, describeCollaborationShellState, getLocalStorageUsageSummary, isLegacyBinaryPresentation, isSupportedPresentationFile, presentationBaseName, readStoredViewerPrefs, resolveProfileInitial, resolveThemeCatalogEntry, saveViewerProfile, savedPresentationFileName, themeToCssVars, vermilionDarkColors, vermilionDarkTheme, vermilionLightColors, vermilionLightTheme, vermilionRadius, writeStoredViewerPrefs } from './chunk-D3TZOCQP.mjs';
+export { LOCALE_CATALOG } from './chunk-JQXN6PO7.mjs';
 import './chunk-XGB3TDIC.mjs';