pptx-vue-viewer 1.22.1 → 1.23.0

package/CHANGELOG.md

@@ -4,6 +4,8 @@ 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.22.1](https://github.com/ChristopherVR/pptx-viewer/releases/tag/pptx-vue-viewer@1.22.1) - 2026-07-18
+
 ## [1.22.0](https://github.com/ChristopherVR/pptx-viewer/releases/tag/pptx-vue-viewer@1.22.0) - 2026-07-18
 
 ## [1.21.0](https://github.com/ChristopherVR/pptx-viewer/releases/tag/pptx-vue-viewer@1.21.0) - 2026-07-17

package/README.md

@@ -214,8 +214,50 @@ async function save() {
 ### Exported components & helpers
 
 `PowerPointViewer`, `SlideCanvas`, `SlideStage`, `ElementRenderer`,
-`provideViewerTheme`, `useViewerTheme`, and the `ViewerTheme` / `CanvasSize` /
-`CollaborationConfig` / `ToolbarActionId` types.
+`RibbonToolbar`, `provideViewerTheme`, `useViewerTheme`, and the `ViewerTheme` /
+`CanvasSize` / `CollaborationConfig` / `ToolbarActionId` / `RibbonProps` types.
+
+### Composing a custom viewer shell
+
+`<PowerPointViewer>` bundles the slide canvas, ribbon, inspector, and every
+dialog into one component. If you only want a subset, for example your own
+chrome around just the ribbon and the slide canvas, import the pieces
+independently instead: `RibbonToolbar` (from `pptx-vue-viewer`, same as
+`SlideCanvas`) and the `useRibbonProps` composable (from the "advanced
+integrations" entry point `pptx-vue-viewer/composables-unstable`) that
+assembles its props. `composables-unstable` has no semver stability
+guarantee, so pin your version when relying on it.
+
+```vue
+<script setup lang="ts">
+import { SlideCanvas, RibbonToolbar } from 'pptx-vue-viewer';
+import {
+	useRibbonProps,
+	useEditorHistory,
+	useSelection,
+	// ...plus whichever other composables you need to build the
+	// `UseRibbonPropsInput` state/action fields (see ribbon-props-types.ts).
+} from 'pptx-vue-viewer/composables-unstable';
+
+// Wire up just the state/handlers your custom shell needs; anything from
+// `UseRibbonPropsInput` you don't use can be a no-op ref/callback.
+const ribbonProps = useRibbonProps({
+	/* ribbonMode, canEdit, isMobile, ..., see UseRibbonPropsInput */
+});
+</script>
+
+<template>
+	<div class="my-custom-shell">
+		<RibbonToolbar v-bind="ribbonProps" />
+		<SlideCanvas :slide="activeSlide" :scale="zoom" />
+	</div>
+</template>
+```
+
+`RibbonToolbar`'s full prop contract is the `RibbonProps` type; `useRibbonProps`
+returns a `ComputedRef<RibbonProps>` built from the same state/action
+composables `PowerPointViewer.vue` itself uses, so `v-bind`ing it straight onto
+`RibbonToolbar` mirrors the bundled component's wiring exactly.
 
 ## Localization (i18n)
 

package/dist/composables-unstable.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const e = require("./useViewerSettingsDialog-CvBIvcW0.cjs");
+const e = require("./useViewerSettingsDialog-DYK4zbNW.cjs");
 let t = require("vue");
 function s(e) {
 	const t = /* @__PURE__ */ new Set(), s = [];

package/dist/composables-unstable.js

@@ -1,4 +1,4 @@
-import { $ as a, $n as s, $t as t, A as e, At as n, B as u, Bt as l, Ct as i, D as o, Dt as c, E as r, Et as v, F as f, G as d, Gt as g, H as h, Ht as m, I as p, J as w, Jt as y, K as S, Kt as j, L as k, La as x, M as D, Mt as E, N as M, Nt as V, O as $, Ot as q, P as z, Q as A, Qn as B, R as G, St as H, T as I, Tt as J, U as K, Ut as L, V as N, Vt as O, W as Q, Wt as T, X as U, Xt as W, Y as X, Yt as Y, Z, Zt as _, _ as b, _t as C, a as F, an as P, at as R, bt as aa, c as sa, cn as ta, ct as ea, d as na, dt as ua, et as la, f as ia, ft as oa, g as ca, gt as ra, h as va, hn as fa, ht as da, i as ga, in as ha, it as ma, j as pa, jt as wa, k as ya, kr as Sa, kt as ja, l as ka, ln as xa, m as Da, mt as Ea, n as Ma, nn as Va, nt as $a, o as qa, on as za, ot as Aa, p as Ba, pt as Ga, q as Ha, qt as Ia, r as Ja, ri as Ka, rn as La, rt as Na, s as Oa, sn as Qa, st as Ta, t as Ua, tt as Wa, u as Xa, ur as Ya, v as Za, vt as _a, w as ba, wt as Ca, xi as Fa, xt as Pa, y as Ra, yt as as, z as ss, zt as ts } from "./useViewerSettingsDialog-CkY4fSDh.js";
+import { $ as a, $n as s, $t as t, A as e, Ar as n, At as u, B as l, Bt as i, Ct as o, D as c, Dt as r, E as v, Et as f, F as d, G as g, Gt as h, H as m, Ht as p, I as S, J as w, Jt as y, K as j, Kt as A, L as D, M as E, Mt as M, N as V, Nt as $, O as k, Ot as q, P as x, Q as z, R as B, Ra as G, Si as H, St as I, T as J, Tt as K, U as N, Ut as O, V as R, Vt as T, W as U, Wt as W, X, Xt as Y, Y as Z, Yt as _, Z as b, Zt as C, _ as F, _t as L, a as P, an as Q, at as aa, bt as sa, c as ta, cn as ea, ct as na, d as ua, dr as la, dt as ia, er as oa, et as ca, f as ra, ft as va, g as fa, gt as da, h as ga, hn as ha, ht as ma, i as pa, ii as Sa, in as wa, it as ya, j as ja, jt as Aa, k as Da, kt as Ea, l as Ma, ln as Va, m as $a, mt as ka, n as qa, nn as xa, nt as za, o as Ba, on as Ga, ot as Ha, p as Ia, pt as Ja, q as Ka, qt as Na, r as Oa, rn as Ra, rt as Ta, s as Ua, sn as Wa, st as Xa, t as Ya, tt as Za, u as _a, v as ba, vt as Ca, w as Fa, wt as La, xt as Pa, y as Qa, yt as as, z as ss, zt as ts } from "./useViewerSettingsDialog-BFXCVlAC.js";
 import { computed as es, readonly as ns, ref as us } from "vue";
 function ls(a = []) {
 	const s = us(is(a)), t = es(() => 0 === s.value.length);
@@ -27,4 +27,4 @@ function is(a) {
 	for (const e of a) s.has(e) || (s.add(e), t.push(e));
 	return t;
 }
-export { Ja as DEFAULT_MAX_VERSIONS, Ca as ERASER_RADIUS, J as HIGHLIGHTER_OPACITY, v as HIGHLIGHTER_WIDTH, B as MOBILE_BREAKPOINT, s as MOBILE_LANDSCAPE_MAX_HEIGHT, oa as NUDGE_LARGE, Ga as NUDGE_SMALL, c as PEN_WIDTH, ca as RIBBON_ALIGN, Ea as SHORTCUT_CATALOG, da as SHORTCUT_GROUP_LABEL_KEYS, l as SMARTART_COLOR_SCHEMES, O as SMARTART_STYLE_OPTIONS, ta as SmartArt3DKey, Ya as TABLET_BREAKPOINT, Ia as TableSelectionKey, Sa as buildClickGroups, k as buildSearchRegex, q as buildStrokePathD, y as computeCellSelection, Ka as computeDocumentStatistics, as as computeElapsed, Fa as countWords, ja as createStroke, n as eraseStrokesAtPoint, G as findMatches, aa as formatRehearseMs, $a as generateCommentId, ra as groupShortcutCatalog, Y as injectTableSelection, Va as inlineEditorRect, x as isMobileViewport, La as nodeIdsInRenderOrder, W as provideTableSelection, ss as replaceInElement, C as resolveShortcutAction, m as smartArtLayoutLabel, ha as textNodeIdsInRenderOrder, b as toShapePreset, ea as useAccessibility, Ta as useAlignGroup, V as useAnimationPlayback, Aa as useAutosave, g as useChartEditing, R as useCollaboration, ma as useCollaborationWiring, Qa as useColorChangeImage, Na as useComments, Wa as useCommentsWiring, la as useContextMenu, a as useCustomShows, A as useCustomShowsWiring, T as useDebouncedCallback, Z as useDocumentPropertiesDialog, j as useDocumentStatistics, U as useEditorHistory, X as useEditorKeyboard, w as useEditorOperations, Ha as useElementDrag, S as useElementInsertion, d as useEmbeddedFonts, Q as useExport, K as useExportProgress, N as useExportWiring, u as useFindReplace, p as useFontEmbedding, f as useFormatPainter, z as useHeaderFooterDialog, M as useInkDrawing, D as useInlineEditing, pa as useInsertElementDialogs, E as useIsMobile, e as useKeyboardInsets, _a as useKeyboardShortcuts, ya as useLoadContent, $ as useMasterViewState, h as useMediaExport, o as useMobileChrome, za as useModel3dScene, r as useMultiSelectOps, I as usePasswordProtection, wa as usePresentationAnnotations, ba as usePresentationModeWiring, Ra as usePrint, Pa as useRehearseTimings, Za as useRibbonActions, va as useRibbonProps, Da as useRibbonUiState, Ba as useSectionOperations, ls as useSelection, ia as useSelectionPaneWiring, fa as useSheetDismissDrag, na as useSignatureWorkflow, ua as useSignatures, Xa as useSlideMutations, ka as useSlideOperations, sa as useSlideShowSettings, xa as useSmartArt3D, ts as useSmartArtEditing, L as useSmartArtFocus, t as useSmartArtHoverRect, P as useSmartArtInlineEditState, Oa as useSmartArtNodeEditContext, qa as useTableCellEditingContext, _ as useTableCellSelection, F as useThemeEditing, i as useToolbarAutoHide, H as useTouchGestures, ga as useVersionHistory, Ma as useVersionHistoryWiring, Ua as useViewerSettingsDialog };
+export { Oa as DEFAULT_MAX_VERSIONS, La as ERASER_RADIUS, K as HIGHLIGHTER_OPACITY, f as HIGHLIGHTER_WIDTH, s as MOBILE_BREAKPOINT, oa as MOBILE_LANDSCAPE_MAX_HEIGHT, va as NUDGE_LARGE, Ja as NUDGE_SMALL, r as PEN_WIDTH, fa as RIBBON_ALIGN, ka as SHORTCUT_CATALOG, ma as SHORTCUT_GROUP_LABEL_KEYS, i as SMARTART_COLOR_SCHEMES, T as SMARTART_STYLE_OPTIONS, ea as SmartArt3DKey, la as TABLET_BREAKPOINT, Na as TableSelectionKey, n as buildClickGroups, D as buildSearchRegex, q as buildStrokePathD, y as computeCellSelection, Sa as computeDocumentStatistics, as as computeElapsed, H as countWords, Ea as createStroke, u as eraseStrokesAtPoint, B as findMatches, sa as formatRehearseMs, za as generateCommentId, da as groupShortcutCatalog, _ as injectTableSelection, xa as inlineEditorRect, G as isMobileViewport, Ra as nodeIdsInRenderOrder, Y as provideTableSelection, ss as replaceInElement, L as resolveShortcutAction, p as smartArtLayoutLabel, wa as textNodeIdsInRenderOrder, F as toShapePreset, na as useAccessibility, Xa as useAlignGroup, $ as useAnimationPlayback, Ha as useAutosave, h as useChartEditing, aa as useCollaboration, ya as useCollaborationWiring, Wa as useColorChangeImage, Ta as useComments, Za as useCommentsWiring, ca as useContextMenu, a as useCustomShows, z as useCustomShowsWiring, W as useDebouncedCallback, b as useDocumentPropertiesDialog, A as useDocumentStatistics, X as useEditorHistory, Z as useEditorKeyboard, w as useEditorOperations, Ka as useElementDrag, j as useElementInsertion, g as useEmbeddedFonts, U as useExport, N as useExportProgress, R as useExportWiring, l as useFindReplace, S as useFontEmbedding, d as useFormatPainter, x as useHeaderFooterDialog, V as useInkDrawing, E as useInlineEditing, ja as useInsertElementDialogs, M as useIsMobile, e as useKeyboardInsets, Ca as useKeyboardShortcuts, Da as useLoadContent, k as useMasterViewState, m as useMediaExport, c as useMobileChrome, Ga as useModel3dScene, v as useMultiSelectOps, J as usePasswordProtection, Aa as usePresentationAnnotations, Fa as usePresentationModeWiring, Qa as usePrint, Pa as useRehearseTimings, ba as useRibbonActions, ga as useRibbonProps, $a as useRibbonUiState, Ia as useSectionOperations, ls as useSelection, ra as useSelectionPaneWiring, ha as useSheetDismissDrag, ua as useSignatureWorkflow, ia as useSignatures, _a as useSlideMutations, Ma as useSlideOperations, ta as useSlideShowSettings, Va as useSmartArt3D, ts as useSmartArtEditing, O as useSmartArtFocus, t as useSmartArtHoverRect, Q as useSmartArtInlineEditState, Ua as useSmartArtNodeEditContext, Ba as useTableCellEditingContext, C as useTableCellSelection, P as useThemeEditing, o as useToolbarAutoHide, I as useTouchGestures, pa as useVersionHistory, qa as useVersionHistoryWiring, Ya as useViewerSettingsDialog };