pptx-react-viewer 1.22.2 → 1.24.0

package/CHANGELOG.md

@@ -4,6 +4,14 @@ All notable changes to this project are documented here.
 This file is generated from [Conventional Commits](https://www.conventionalcommits.org)
 by [git-cliff](https://git-cliff.org); do not edit it by hand.
 
+## [1.23.0](https://github.com/ChristopherVR/pptx-viewer/releases/tag/pptx-react-viewer@1.23.0) - 2026-07-18
+
+### Dependencies
+
+- **deps:** Update dependencies to latest and migrate core/shared/locales to TypeScript 7 (by @ChristopherVR) ([cc72948](https://github.com/ChristopherVR/pptx-viewer/commit/cc729482cc5ae4ae56e1219f290c2953ec83c12a))
+
+## [1.22.2](https://github.com/ChristopherVR/pptx-viewer/releases/tag/pptx-react-viewer@1.22.2) - 2026-07-18
+
 ## [1.22.1](https://github.com/ChristopherVR/pptx-viewer/releases/tag/pptx-react-viewer@1.22.1) - 2026-07-18
 
 ## [1.22.0](https://github.com/ChristopherVR/pptx-viewer/releases/tag/pptx-react-viewer@1.22.0) - 2026-07-17

package/README.md

@@ -144,6 +144,33 @@ import { renderToCanvas } from 'pptx-react-viewer';
 const canvas = await renderToCanvas(element, options); // => HTMLCanvasElement
 ```
 
+### Composing a custom viewer shell
+
+`<PowerPointViewer>` bundles a full editor chrome (toolbar, canvas, side panels, dialogs, presentation mode). If you only need the toolbar and slide canvas, with your own layout around them, `Toolbar` and `SlideCanvas` are exported as standalone components, and `useViewerBuildingBlocks` wires up the same state and hooks `PowerPointViewer` uses internally, mapped into the flat props those two components expect:
+
+```tsx
+import { Toolbar, SlideCanvas, useViewerBuildingBlocks } from 'pptx-react-viewer';
+
+function MyCustomViewer({ content }: { content: Uint8Array }) {
+	const { toolbarProps, canvasProps, loading, error } = useViewerBuildingBlocks({
+		content,
+		canEdit: true,
+	});
+
+	if (loading) return <p>Loading…</p>;
+	if (error) return <p>Failed to load: {error}</p>;
+
+	return (
+		<div className='my-custom-layout'>
+			<Toolbar {...toolbarProps} />
+			<SlideCanvas {...canvasProps} />
+		</div>
+	);
+}
+```
+
+`useViewerBuildingBlocks` accepts the same `content` / `canEdit` / `filePath` / `hiddenActions` / `onDirtyChange`-style inputs as `PowerPointViewer`, plus `onOpenSettings` / `onOpenHeaderFooter` / `onOpenShareDialog` callbacks (fired by the corresponding toolbar buttons) since this composition doesn't render those dialogs itself. It's an additive alternative, not a replacement: dialogs, presentation-mode overlays, mobile chrome, resizable side panels, and real-time collaboration are all part of `PowerPointViewer` and are out of scope for these building blocks. Reach for `PowerPointViewer` when you need the full editor; reach for `useViewerBuildingBlocks` when you're assembling your own chrome around just the toolbar and canvas.
+
 ---
 
 ## Styling & theming

package/dist/{Model3DScene-NLUSXHD6.mjs → Model3DScene-QTNGCODM.mjs}

@@ -1,5 +1,5 @@
-import { mountModel3D } from './chunk-5SBQZEKD.mjs';
-import './chunk-3ZGCM6RC.mjs';
+import { mountModel3D } from './chunk-KPT54MHG.mjs';
+import './chunk-LDZQNYWL.mjs';
 import './chunk-6DZX6EAA.mjs';
 import { useRef, useEffect } from 'react';
 import { jsx } from 'react/jsx-runtime';

package/dist/{Model3DScene-3YB3JAJS.js → Model3DScene-RD4XEC3F.js}

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunkVSNXVKJI_js = require('./chunk-VSNXVKJI.js');
-require('./chunk-AD3EAEY6.js');
+var chunkI5SO5OV4_js = require('./chunk-I5SO5OV4.js');
+require('./chunk-KV3EOLP3.js');
 require('./chunk-QGM4M3NI.js');
 var react = require('react');
 var jsxRuntime = require('react/jsx-runtime');
@@ -15,7 +15,7 @@ function Model3DScene({ modelUrl, interactive, width, height }) {
       return;
     }
     let disposed = false;
-    void chunkVSNXVKJI_js.mountModel3D(container, modelUrl, { width, height, interactive }).then((handle) => {
+    void chunkI5SO5OV4_js.mountModel3D(container, modelUrl, { width, height, interactive }).then((handle) => {
       if (disposed) {
         handle.dispose();
       } else {

package/dist/{PowerPointViewer-WGVR_u4z.d.ts → PowerPointViewer-CnADroqZ.d.ts}

@@ -1,4 +1,4 @@
-import { f as PowerPointViewerHandle, p as PowerPointViewerProps } from "./types-Cdh0XYcS.js";
+import { m as PowerPointViewerProps, p as PowerPointViewerHandle } from "./animation-timeline-CEJJLFqK.js";
 import { PptxAnimationPreset, PptxNativeAnimation } from "pptx-viewer-core";
 import "pptx-viewer-shared";
 import React from "react";
@@ -18,4 +18,4 @@ declare function getAnimationInitialStyle(preset: PptxAnimationPreset | undefine
 declare const PowerPointViewer: import("react").ForwardRefExoticComponent<PowerPointViewerProps & import("react").RefAttributes<PowerPointViewerHandle>>;
 //#endregion
 export { getAnimationInitialStyle as n, PowerPointViewer as t };
-//# sourceMappingURL=PowerPointViewer-WGVR_u4z.d.ts.map
+//# sourceMappingURL=PowerPointViewer-CnADroqZ.d.ts.map

package/dist/{PowerPointViewer-WGVR_u4z.d.ts.map → PowerPointViewer-CnADroqZ.d.ts.map}

@@ -1 +1 @@
-{"version":3,"file":"PowerPointViewer-WGVR_u4z.d.ts","names":[],"sources":["../src/viewer/utils/animation-effects.ts","../src/viewer/PowerPointViewer.tsx"],"mappings":";;;;;iBAmBgB,yBACf,QAAQ,iCACR,kBAAkB,sBAChB,MAAM;;;;;;;;;;;;cC4EI,kCAAgB,0BAAA,wCAAA,cAAA"}
+{"version":3,"file":"PowerPointViewer-CnADroqZ.d.ts","names":[],"sources":["../src/viewer/utils/animation-effects.ts","../src/viewer/PowerPointViewer.tsx"],"mappings":";;;;;iBAmBgB,yBACf,QAAQ,iCACR,kBAAkB,sBAChB,MAAM;;;;;;;;;;;;cC4EI,kCAAgB,0BAAA,wCAAA,cAAA"}

package/dist/{SurfaceChart3DScene-YBMJQGH3.mjs → SurfaceChart3DScene-VKS3ELTU.mjs}

@@ -1,5 +1,5 @@
-import { mountSurfaceChart3D } from './chunk-5SBQZEKD.mjs';
-import './chunk-3ZGCM6RC.mjs';
+import { mountSurfaceChart3D } from './chunk-KPT54MHG.mjs';
+import './chunk-LDZQNYWL.mjs';
 import './chunk-6DZX6EAA.mjs';
 import { useRef, useEffect } from 'react';
 import { jsxs, jsx } from 'react/jsx-runtime';

package/dist/{SurfaceChart3DScene-PUQ5DCO5.js → SurfaceChart3DScene-YR3GX4X6.js}

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunkVSNXVKJI_js = require('./chunk-VSNXVKJI.js');
-require('./chunk-AD3EAEY6.js');
+var chunkI5SO5OV4_js = require('./chunk-I5SO5OV4.js');
+require('./chunk-KV3EOLP3.js');
 require('./chunk-QGM4M3NI.js');
 var react = require('react');
 var jsxRuntime = require('react/jsx-runtime');
@@ -26,7 +26,7 @@ function SurfaceChart3DScene({
       return;
     }
     let disposed = false;
-    void chunkVSNXVKJI_js.mountSurfaceChart3D(container, {
+    void chunkI5SO5OV4_js.mountSurfaceChart3D(container, {
       cols,
       rows,
       heightMap,

package/dist/{types-Cdh0XYcS.d.ts → animation-timeline-CEJJLFqK.d.ts}

@@ -1,6 +1,6 @@
-import { n as LocaleCatalogEntry } from "./index-SUL_8gq8.js";
+import { n as LocaleCatalogEntry } from "./index-CGKutKk1.js";
 import { ConnectorArrowType, PptxAnimationPreset, PptxElement, PptxElementAnimation, PptxSlide, PptxSlideTransition, ShapeStyle, StrokeDashType, XmlObject } from "pptx-viewer-core";
-import { AccountAuthConfig, CollaborationConfig as CollaborationConfig$1, CollaborationRole, ElementClipboardPayload, PowerPointViewerAPI, THEME_CATALOG, ThemeCatalogEntry, ThemeCatalogEntry as ThemeCatalogEntry$1, ToolbarActionId, ViewerFontSource, ViewerMode as ViewerMode$1, ViewerTheme, ViewerThemeColors, defaultCssVars, defaultRadius, defaultThemeColors, resolveThemeCatalogEntry, themeToCssVars, vermilionDarkColors, vermilionDarkTheme, vermilionLightColors, vermilionLightTheme, vermilionRadius } from "pptx-viewer-shared";
+import { AccountAuthConfig, CollaborationConfig as CollaborationConfig$1, CollaborationRole, ElementAnimationState, ElementClipboardPayload, PowerPointViewerAPI, THEME_CATALOG, ThemeCatalogEntry, ThemeCatalogEntry as ThemeCatalogEntry$1, ToolbarActionId, ViewerFontSource, ViewerMode as ViewerMode$1, ViewerTheme, ViewerThemeColors, defaultCssVars, defaultRadius, defaultThemeColors, resolveThemeCatalogEntry, themeToCssVars, vermilionDarkColors, vermilionDarkTheme, vermilionLightColors, vermilionLightTheme, vermilionRadius } from "pptx-viewer-shared";
 import React$1 from "react";
 import { Doc } from "yjs";
 //#region src/viewer/types-core.d.ts
@@ -542,5 +542,5 @@ interface PowerPointViewerHandle extends FileViewerHandle, PowerPointViewerAPI {
   getContent: () => Promise<Uint8Array>;
 }
 //#endregion
-export { ShapeAdjustmentDragState as $, THEME_CATALOG as A, defaultRadius as B, CollaborationConfig$1 as C, UserPresence as D, ConnectionStatus as E, vermilionDarkColors as F, ConnectorGeometryType as G, ViewerTheme as H, vermilionDarkTheme as I, EditorHistorySnapshot as J, ConnectorPathGeometry as K, vermilionLightColors as L, resolveThemeCatalogEntry as M, defaultCssVars as N, ViewerThemeProvider as O, themeToCssVars as P, ResizeState as Q, vermilionLightTheme as R, ToolbarSection as S, CollaborationRole as T, ViewerThemeColors as U, defaultThemeColors as V, CanvasSize as W, ElementClipboardPayload as X, ElementBounds as Y, ResizeHandle as Z, SlideAlignment as _, DrawingTool as a, StrokeDashOption as b, FileViewerHandle as c, ParsedTableData as d, ShapeAdjustmentHandleDescriptor as et, PowerPointViewerHandle as f, ShortcutReferenceItem as g, ShapePreset as h, ConnectorGeometryOption as i, ThemeCatalogEntry$1 as j, useViewerTheme as k, MarqueeSelectionState as l, PresentationAnimationRuntime as m, AnimationPresetOption as n, SupportedShapeType as nt, ElementContextMenuAction as o, PowerPointViewerProps as p, DragState as q, ConnectorArrowOption as r, ViewerMode$1 as rt, ElementContextMenuState as s, AccessibilityIssue as t, ShapeQuickStyle as tt, ParsedTableCell as u, SlideSectionGroup as v, CollaborationContextValue as w, TableCellEditorState as x, SlideTransitionOption as y, vermilionRadius as z };
-//# sourceMappingURL=types-Cdh0XYcS.d.ts.map
+export { ResizeState as $, useViewerTheme as A, vermilionRadius as B, ToolbarSection as C, ConnectionStatus as D, CollaborationRole as E, themeToCssVars as F, CanvasSize as G, defaultThemeColors as H, vermilionDarkColors as I, DragState as J, ConnectorGeometryType as K, vermilionDarkTheme as L, ThemeCatalogEntry$1 as M, resolveThemeCatalogEntry as N, UserPresence as O, defaultCssVars as P, ResizeHandle as Q, vermilionLightColors as R, TableCellEditorState as S, CollaborationContextValue as T, ViewerTheme as U, defaultRadius as V, ViewerThemeColors as W, ElementBounds as X, EditorHistorySnapshot as Y, ElementClipboardPayload as Z, ShortcutReferenceItem as _, ConnectorGeometryOption as a, SlideTransitionOption as b, ElementContextMenuState as c, ParsedTableCell as d, ShapeAdjustmentDragState as et, ParsedTableData as f, ShapePreset as g, PresentationAnimationRuntime as h, ConnectorArrowOption as i, ViewerMode$1 as it, THEME_CATALOG as j, ViewerThemeProvider as k, FileViewerHandle as l, PowerPointViewerProps as m, AccessibilityIssue as n, ShapeQuickStyle as nt, DrawingTool as o, PowerPointViewerHandle as p, ConnectorPathGeometry as q, AnimationPresetOption as r, SupportedShapeType as rt, ElementContextMenuAction as s, ElementAnimationState as t, ShapeAdjustmentHandleDescriptor as tt, MarqueeSelectionState as u, SlideAlignment as v, CollaborationConfig$1 as w, StrokeDashOption as x, SlideSectionGroup as y, vermilionLightTheme as z };
+//# sourceMappingURL=animation-timeline-CEJJLFqK.d.ts.map

package/dist/animation-timeline-CEJJLFqK.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animation-timeline-CEJJLFqK.d.ts","names":[],"sources":["../src/viewer/types-core.ts","../src/theme/context.tsx","../src/viewer/hooks/collaboration/types.ts","../src/viewer/types-ui.ts"],"mappings":";;;;;;;;;;;KA+BY;;;;;KAqCA;;UAgBK;;EAEhB;;EAEA;;;;;;;;UAagB;;EAEhB;;EAEA;;EAEA;;EAEA,oBAAoB;IAAiB;IAAW;;;EAEhD,QAAQ,YAAY;;EAEpB;;EAEA;EACA;;;KAIW;;;;;;UAOK;;EAEhB;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA,QAAQ;;EAER;;EAEA,OAAO;;EAEP;EACA;EACA;EACA;;;;;;;UAQgB;EAChB;EACA;EACA;EACA;EACA;;;;;;;UAQgB;EAChB;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;;;;;;UAoBgB;EAChB;EACA;EACA;EACA,QAAQ;EACR,2BAA2B,eAAe;EAC1C;;;UAQgB;EAChB;EACA;EACA;EACA;;;;;;;UAQgB;EAChB;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;;UAQgB;EAChB;EACA,OAAO,QAAQ;;;;UCxOC;EAChB,QAAQ;EACR,UAAU,MAAM;;;;;;;;;;iBAWD,sBAAsB,OAAO,YAAY,2CAAwB,IAAA;;;;;iBAYjE,kBAAkB;;;;KCOtB;;;;;UAUK;;EAEhB;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA,OAAO;;;UAQS;;EAEhB,QAAQ;;EAER,aAAa;;EAEb,oBAAoB,QAAQ,QAAQ,KAAK;;EAEzC;;EAEA,QAAQ;;EAER,KAAK;;;;;EAKL;;EAEA;;;;;;;;;;UCtEgB;;EAEhB,kBAAkB,iBAAiB;;;UAQnB;EAChB,MAAM;EACN;EACA,MAAM,QAAM;;;UAQI;EAChB;EACA;EACA;;;KAIW;;;;;;UA8BK;EAChB;EACA;EACA;EACA;EACA;EACA;;;UAQgB;EAChB;EACA;;EAEA;;EAEA,gBAAgB;IAAQ;IAAa;;;;UAIrB;EAChB;EACA;EACA;EACA,OAAO,QAAM;EACb,SAAS;;;UAIO;EAChB;EACA;EACA,MAAM;EACN;EACA,OAAO;;;UAQS;EAChB;EACA;EACA,WAAW;;;;;;UAWK;EAChB;EACA;EACA;;EAEA;;EAEA;;;KAQW;;KAGA;;KAiBA;;UAOK;EAChB;EACA;;;UAIgB;EAChB;EACA;EACA;EACA;;;UAQgB;EAChB,OAAO;EACP;;;UAIgB;EAChB,OAAO;EACP;;;UAIgB;EAChB,OAAO;EACP;;;UAIgB;EAChB,OAAO,YAAY;EACnB;;;UAIgB;EAChB,OAAO,QAAQ;EACf;;UAOgB;;EAEhB,SAAS;;EAET,QAAQ;;EAER;;;;;EAKA;;EAEA,iBAAiB;EACjB,mBAAmB,SAAS;;EAE5B,uBAAuB;;EAEvB,gBAAgB,mCAAmC;;EAEnD,gBAAgB;;EAEhB,qBAAqB;;EAErB,sBAAsB;;;;;;;EAOtB;;EAGA;;EAEA;;;;;EAMA;;;;;;;;;;;;;;;;;;;;;EAsBA,QAlD4B;;;;;;;;EA2D5B;;;;;EAMA,kBAAkB;;;;;;;EAQlB,iBAAiB;;;;;EAMjB;;;;;;EAOA,mBAAmB;;;;;;;EAQnB,kBAAkB;;;;;;EAOlB,cAAc;;;;;;;;;;;;;;;;;;;;;EAsBd,gBAAgB;;;;;;EAOhB,wBAAwB,QAAQ;;;;;EAMhC;;;;;;;;;;;;;;;;;EAkBA;IACC;IACA;IACA;;;;;;;;;EAUD;;;;;;;;;;;;;;;;;;EAmBA,gBAAgB;;UAGA,+BAA+B,kBAAkB;EACjE,kBAAkB,QAAQ"}