pptx-react-viewer 1.24.0 → 1.25.0

package/CHANGELOG.md

@@ -4,6 +4,18 @@ 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.24.1](https://github.com/ChristopherVR/pptx-viewer/releases/tag/pptx-react-viewer@1.24.1) - 2026-07-18
+
+### Documentation
+
+- Correct and expand the per-package npm readmes (by @ChristopherVR) ([46f7c57](https://github.com/ChristopherVR/pptx-viewer/commit/46f7c573701a19e91c507d41ebdc956c64699c38))
+
+## [1.24.0](https://github.com/ChristopherVR/pptx-viewer/releases/tag/pptx-react-viewer@1.24.0) - 2026-07-18
+
+### Features
+
+- **react:** Export Toolbar/SlideCanvas + useViewerBuildingBlocks hook (by @ChristopherVR) ([37220c3](https://github.com/ChristopherVR/pptx-viewer/commit/37220c3afa1f7eaf62ec9eaa6fca72ee6ab19d7d))
+
 ## [1.23.0](https://github.com/ChristopherVR/pptx-viewer/releases/tag/pptx-react-viewer@1.23.0) - 2026-07-18
 
 ### Dependencies

package/README.md

@@ -12,8 +12,6 @@ Slides render with real **HTML/CSS** (not `<canvas>`), so text stays crisp at an
 
 <samp>**[▶️ Try the live demo](https://christophervr.github.io/pptx-viewer/demo/)** · **[📦 npm](https://www.npmjs.com/package/pptx-react-viewer)** · **[📖 Full docs](https://christophervr.github.io/pptx-viewer/)** · **[🧩 Core SDK](https://www.npmjs.com/package/pptx-viewer-core)**</samp>
 
-> **[▶️ Try the live demo](https://christophervr.github.io/pptx-viewer/demo/)**: open a `.pptx` in your browser and view, edit, present, and export it. No install required.
-
 ---
 
 ## Install
@@ -29,7 +27,7 @@ npm install react react-dom framer-motion lucide-react react-icons jspdf jszip f
 ```
 
 > The package is named **`pptx-react-viewer`** on npm. `pptx-viewer-core` (the engine) is **bundled in**, so you don't install it separately unless you want to call the SDK directly.
-> **Optional:** `three` for 3D models/charts · `yjs y-websocket` for real-time collaboration.
+> **Optional:** `three` (3D models/charts, 3D SmartArt) and `yjs` / `y-websocket` / `y-webrtc` (real-time collaboration) are declared as `optionalDependencies`, so npm installs them automatically when possible; the features degrade gracefully if they're absent.
 
 ## Quick start
 
@@ -40,11 +38,11 @@ import { PowerPointViewer } from 'pptx-react-viewer';
 import 'pptx-react-viewer/styles';
 
 export default function App() {
-	const [content, setContent] = useState<ArrayBuffer | null>(null);
+	const [content, setContent] = useState<Uint8Array | null>(null);
 
-	// Load any .pptx as an ArrayBuffer (fetch, <input type="file">, drag-drop, …)
+	// Load any .pptx as bytes (fetch, <input type="file">, drag-drop, …)
 	const onPick = (e: React.ChangeEvent<HTMLInputElement>) =>
-		e.target.files?.[0]?.arrayBuffer().then(setContent);
+		e.target.files?.[0]?.arrayBuffer().then((buf) => setContent(new Uint8Array(buf)));
 
 	return (
 		<div style={{ height: '100vh' }}>
@@ -78,7 +76,7 @@ const bytes = await viewerRef.current?.getContent(); // Uint8Array of a valid .p
 | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------- |
 | **View**           | Render slides with 16 element types: shapes, text, images, tables, 23 chart types, SmartArt, connectors, media, ink, OLE, 3D models, zoom |
 | **Edit**           | Insert/move/resize/delete elements, edit text inline, modify styles, manage slides                                                        |
-| **Present**        | Fullscreen slideshow with 40+ animations, 42 transitions (including morph), speaker notes, presenter view with timer                      |
+| **Present**        | Fullscreen slideshow with 40+ animations, 46 transitions (including morph), speaker notes, presenter view with timer                      |
 | **Export**         | PNG/JPEG/SVG/PDF/GIF/video slide export, save-as PPTX                                                                                     |
 | **Collaborate**    | Real-time multi-user editing (powered by Yjs) with live presence, remote cursors, and user avatars                                        |
 | **Print**          | Print dialog with handout layouts and notes page formatting with overflow pagination                                                      |
@@ -93,20 +91,37 @@ const bytes = await viewerRef.current?.getContent(); // Uint8Array of a valid .p
 
 ### `PowerPointViewer` props
 
-| Prop                  | Type                                | Default  | Description                                                                                                                            |
-| --------------------- | ----------------------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------- |
-| `content`             | `ArrayBuffer \| Uint8Array \| null` | required | Raw .pptx file bytes                                                                                                                   |
-| `filePath`            | `string`                            | n/a      | Optional file path (for display and autosave)                                                                                          |
-| `canEdit`             | `boolean`                           | `false`  | Enable editing mode                                                                                                                    |
-| `onContentChange`     | `(dirty: boolean) => void`          | n/a      | Called when content changes                                                                                                            |
-| `onDirtyChange`       | `(isDirty: boolean) => void`        | n/a      | Called when dirty state changes                                                                                                        |
-| `onActiveSlideChange` | `(index: number) => void`           | n/a      | Called when the active slide changes                                                                                                   |
-| `onModeChange`        | `(mode: ViewerMode) => void`        | n/a      | Called when the viewer mode changes                                                                                                    |
-| `onZoomChange`        | `(zoom: number) => void`            | n/a      | Called when the zoom level changes                                                                                                     |
-| `onSelectionChange`   | `(ids: string[]) => void`           | n/a      | Called when element selection changes                                                                                                  |
-| `onSlideCountChange`  | `(count: number) => void`           | n/a      | Called when the total slide count changes                                                                                              |
-| `theme`               | `ViewerTheme`                       | n/a      | Theme configuration for customising colours, radius, and CSS vars                                                                      |
-| `hiddenActions`       | `ToolbarActionId[]`                 | n/a      | Hide individual toolbar buttons and/or ribbon tabs (e.g. `['share', 'broadcast']`) instead of the whole toolbar; omitted hides nothing |
+| Prop                   | Type                                    | Default  | Description                                                                                                                            |
+| ---------------------- | --------------------------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------- |
+| `content`              | `Uint8Array`                            | required | Raw .pptx file bytes                                                                                                                   |
+| `filePath`             | `string`                                | n/a      | Optional file path (for display and autosave recovery)                                                                                 |
+| `fileName`             | `string`                                | n/a      | Display name of the open document, shown in the title bar                                                                              |
+| `className`            | `string`                                | n/a      | Class applied to the root element                                                                                                      |
+| `canEdit`              | `boolean`                               | `false`  | Enable editing mode                                                                                                                    |
+| `fonts`                | `ViewerFontSource[]`                    | n/a      | Licensed font sources supplied by the host application                                                                                 |
+| `authorName`           | `string`                                | n/a      | Author name for comments/annotations and collaboration presence                                                                        |
+| `collaboration`        | `CollaborationConfig`                   | n/a      | Yjs real-time collaboration config (server URL, room, role)                                                                            |
+| `shareDefaults`        | `{ roomId?, userName?, serverUrl? }`    | n/a      | Seed values for the Share dialog fields                                                                                                |
+| `smartArt3D`           | `boolean`                               | `false`  | Opt-in Three.js 3D SmartArt renderer (needs the optional `three` dependency; falls back to SVG without it)                             |
+| `onOpenFile`           | `() => void`                            | n/a      | Host override for File > Open; bypasses the built-in file picker                                                                       |
+| `onContentChange`      | `(content: Uint8Array) => void`         | n/a      | Called with freshly serialised `.pptx` bytes when the content changes                                                                  |
+| `onDirtyChange`        | `(isDirty: boolean) => void`            | n/a      | Called when dirty state changes                                                                                                        |
+| `onActiveSlideChange`  | `(index: number) => void`               | n/a      | Called when the active slide changes                                                                                                   |
+| `onModeChange`         | `(mode: ViewerMode) => void`            | n/a      | Called when the viewer mode changes                                                                                                    |
+| `onZoomChange`         | `(zoom: number) => void`                | n/a      | Called when the zoom level changes                                                                                                     |
+| `onSelectionChange`    | `(ids: string[]) => void`               | n/a      | Called when element selection changes                                                                                                  |
+| `onSlideCountChange`   | `(count: number) => void`               | n/a      | Called when the total slide count changes                                                                                              |
+| `onStartCollaboration` | `(config: CollaborationConfig) => void` | n/a      | Called when the user starts a collaboration session from the Share dialog                                                              |
+| `onStopCollaboration`  | `() => void`                            | n/a      | Called when the collaboration session stops                                                                                            |
+| `theme`                | `ViewerTheme`                           | n/a      | Theme configuration for customising colours, radius, and CSS vars                                                                      |
+| `hiddenActions`        | `ToolbarActionId[]`                     | n/a      | Hide individual toolbar buttons and/or ribbon tabs (e.g. `['share', 'broadcast']`) instead of the whole toolbar; omitted hides nothing |
+| `defaultThemeKey`      | `string`                                | n/a      | Initial File > Options > Appearance selection when no persisted preference exists                                                      |
+| `availableThemes`      | `ThemeCatalogEntry[]`                   | n/a      | Theme choices offered by File > Options > Appearance (defaults to the built-in catalog)                                                |
+| `onThemeChange`        | `(key: string) => void`                 | n/a      | Host hook for the appearance picker; when set, the host owns persisting the choice                                                     |
+| `defaultLocale`        | `string`                                | n/a      | Initial locale code when no persisted preference exists                                                                                |
+| `availableLocales`     | `LocaleCatalogEntry[]`                  | n/a      | Locale choices offered by File > Options > Language (defaults to the registered i18next locales)                                       |
+| `onLocaleChange`       | `(code: string) => void`                | n/a      | Host hook for the language picker; when set, the host owns applying/persisting the switch                                              |
+| `accountAuth`          | `AccountAuthConfig`                     | n/a      | Optional sign-in hook point for File > Account (disabled unless `enabled: true`)                                                       |
 
 ### `PowerPointViewerHandle` (via `ref`)
 
@@ -134,6 +149,15 @@ const bytes = await viewerRef.current?.getContent(); // Uint8Array of a valid .p
 | `selectElements`        | `(ids: string[]) => void`    | Programmatically select elements by ID   |
 | `clearSelection`        | `() => void`                 | Clear the current selection              |
 
+The handle implements the full shared `PowerPointViewerAPI`, so the following
+slide/element manipulation methods are also available:
+`setActiveSlideIndex(index)`, `getSlides()`, `getSlide(index)`,
+`getActiveSlide()`, `addSlide(afterIndex?)`, `deleteSlides(indexes)`,
+`duplicateSlides(indexes)`, `moveSlide(from, to)`, `toggleHideSlides(indexes)`,
+`getElements(slideIndex?)`, `getElementById(id, slideIndex?)`,
+`updateElement(id, patch)`, `deleteElements(ids)`, and
+`duplicateElement(id)`.
+
 ### `renderToCanvas`
 
 Standalone utility for rendering a DOM element to a Canvas (with an oklch colour-space workaround):
@@ -152,6 +176,7 @@ const canvas = await renderToCanvas(element, options); // => HTMLCanvasElement
 import { Toolbar, SlideCanvas, useViewerBuildingBlocks } from 'pptx-react-viewer';
 
 function MyCustomViewer({ content }: { content: Uint8Array }) {
+	// Also returned: `mode` (current ViewerMode) and `autosaveStatus`
 	const { toolbarProps, canvasProps, loading, error } = useViewerBuildingBlocks({
 		content,
 		canEdit: true,

package/dist/{Model3DScene-RD4XEC3F.js → Model3DScene-G434BPF4.js}

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

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

@@ -1,4 +1,4 @@
-import { mountModel3D } from './chunk-KPT54MHG.mjs';
+import { mountModel3D } from './chunk-QOBKJKLT.mjs';
 import './chunk-LDZQNYWL.mjs';
 import './chunk-6DZX6EAA.mjs';
 import { useRef, useEffect } from 'react';

package/dist/PowerPointViewer-CnADroqZ.d.ts.map

@@ -1 +1 @@
-{"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"}
+{"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;;;;;;;;;;;;cCiFI,kCAAgB,0BAAA,wCAAA,cAAA"}

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

@@ -1,4 +1,4 @@
-import { mountSurfaceChart3D } from './chunk-KPT54MHG.mjs';
+import { mountSurfaceChart3D } from './chunk-QOBKJKLT.mjs';
 import './chunk-LDZQNYWL.mjs';
 import './chunk-6DZX6EAA.mjs';
 import { useRef, useEffect } from 'react';

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

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

package/dist/{chunk-ZISXRMDJ.js → chunk-2EFVXYNA.js}

@@ -2531,7 +2531,193 @@ var translationsEn = {
   "pptx.connectorArrows.startLength": "Start Length",
   "pptx.connectorArrows.endLength": "End Length",
   "pptx.slideThumbnail.transitionTooltip": "Transition: {{name}}",
-  "pptx.ribbon.groupShapeStyles": "Shape Styles"
+  "pptx.ribbon.groupShapeStyles": "Shape Styles",
+  "pptx.options.title": "Options",
+  "pptx.options.resetAll": "Reset all options",
+  "pptx.options.resetTab": "Reset this tab",
+  "pptx.options.general.description": "General options for working with the viewer.",
+  "pptx.options.general.userInterface": "User Interface options",
+  "pptx.options.general.displayOptimization": "When using multiple displays",
+  "pptx.options.displayOptimization.appearance": "Optimize for best appearance",
+  "pptx.options.displayOptimization.compatibility": "Optimize for compatibility",
+  "pptx.options.general.showMiniToolbar": "Show Mini Toolbar on selection",
+  "pptx.options.general.showMiniToolbarInfo": "Shows the floating formatting toolbar when you select text.",
+  "pptx.options.general.enableLivePreview": "Enable Live Preview",
+  "pptx.options.general.enableLivePreviewInfo": "Previews formatting changes on the slide as you hover over gallery choices.",
+  "pptx.options.general.collapseRibbon": "Collapse the ribbon automatically",
+  "pptx.options.general.collapseSearch": "Collapse the search box by default",
+  "pptx.options.general.screenTipStyle": "ScreenTip style",
+  "pptx.options.screenTipStyle.descriptions": "Show feature descriptions in ScreenTips",
+  "pptx.options.screenTipStyle.plain": "Don't show feature descriptions in ScreenTips",
+  "pptx.options.screenTipStyle.off": "Don't show ScreenTips",
+  "pptx.options.general.personalize": "Personalize your copy of the viewer",
+  "pptx.options.general.userName": "User name",
+  "pptx.options.general.userInitials": "Initials",
+  "pptx.options.general.appearance": "Viewer theme",
+  "pptx.options.general.startup": "Start up options",
+  "pptx.options.general.showStartScreen": "Show the Start screen when this application starts",
+  "pptx.options.proofing.label": "Proofing",
+  "pptx.options.proofing.description": "Change how the viewer corrects and formats your text.",
+  "pptx.options.proofing.autoCorrect": "AutoCorrect options",
+  "pptx.options.proofing.autoCorrectDescription": "Change how text is corrected and formatted as you type.",
+  "pptx.options.proofing.twoInitialCapitals": "Correct TWo INitial CApitals",
+  "pptx.options.proofing.capitalizeFirstLetter": "Capitalize first letter of sentences",
+  "pptx.options.proofing.capitalizeDayNames": "Capitalize names of days",
+  "pptx.options.proofing.smartQuotes": "Replace straight quotes with smart quotes",
+  "pptx.options.proofing.hyphensToDash": "Replace hyphens (--) with dash",
+  "pptx.options.proofing.fractions": "Replace fractions (1/2) with fraction characters (\xBD)",
+  "pptx.options.proofing.ordinals": "Replace ordinals (1st) with superscript",
+  "pptx.options.proofing.spellingOffice": "When correcting spelling",
+  "pptx.options.proofing.ignoreUppercase": "Ignore words in UPPERCASE",
+  "pptx.options.proofing.ignoreWordsWithNumbers": "Ignore words that contain numbers",
+  "pptx.options.proofing.ignoreInternetAddresses": "Ignore Internet and file addresses",
+  "pptx.options.proofing.flagRepeatedWords": "Flag repeated words",
+  "pptx.options.proofing.spellingViewer": "When correcting spelling in the viewer",
+  "pptx.options.proofing.checkSpellingAsYouType": "Check spelling as you type",
+  "pptx.options.proofing.hideSpellingErrors": "Hide spelling errors",
+  "pptx.options.save.label": "Save",
+  "pptx.options.save.description": "Customize how documents are saved.",
+  "pptx.options.save.savePresentations": "Save presentations",
+  "pptx.options.save.autoSave": "Save changes automatically (AutoSave)",
+  "pptx.options.save.autoSaveInfo": "Snapshots are stored locally and offered for recovery when you reopen.",
+  "pptx.options.save.defaultFormat": "Save files in this format",
+  "pptx.options.saveFormat.pptx": "PowerPoint Presentation (*.pptx)",
+  "pptx.options.saveFormat.pdf": "PDF Document (*.pdf)",
+  "pptx.options.saveFormat.png": "PNG Images (*.png)",
+  "pptx.options.save.autoRecoverInterval": "Save AutoRecover information every",
+  "pptx.options.save.minutes": "minutes",
+  "pptx.options.save.keepLastAutoRecovered": "Keep the last AutoRecovered version if I close without saving",
+  "pptx.options.save.fidelity": "Preserve fidelity when sharing this presentation",
+  "pptx.options.save.embedFonts": "Embed fonts in the file",
+  "pptx.options.save.embedFontsInfo": "Embedding fonts increases file size but keeps text identical on other devices.",
+  "pptx.options.save.embedAllCharacters": "Embed all characters (best for editing by other people)",
+  "pptx.options.save.cache": "Cache Settings",
+  "pptx.options.save.cacheRetentionDays": "Days to keep files in the local document cache",
+  "pptx.options.save.days": "days",
+  "pptx.options.save.clearCacheOnClose": "Delete files from the local document cache when they are closed",
+  "pptx.options.save.clearCacheNow": "Delete cached files",
+  "pptx.options.save.clearCacheDescription": "Deletes locally stored recovery snapshots and recent files. This does not affect the open presentation.",
+  "pptx.options.language.description": "Set the viewer language preferences.",
+  "pptx.options.language.displayLanguage": "Display language",
+  "pptx.options.language.displayLanguageDescription": "Buttons, menus, and other controls will show in the selected language.",
+  "pptx.options.accessibility.label": "Accessibility",
+  "pptx.options.accessibility.description": "Make the viewer more accessible.",
+  "pptx.options.accessibility.assistant": "Make your document accessible to others",
+  "pptx.options.accessibility.showStatus": "Show accessibility status in the status bar",
+  "pptx.options.accessibility.feedback": "Feedback options",
+  "pptx.options.accessibility.feedbackWithSound": "Provide feedback with sound",
+  "pptx.options.accessibility.soundScheme": "Sound Scheme",
+  "pptx.options.soundScheme.modern": "Modern",
+  "pptx.options.soundScheme.classic": "Classic",
+  "pptx.options.accessibility.display": "Application display options",
+  "pptx.options.accessibility.showShortcutKeys": "Show shortcut keys in ScreenTips",
+  "pptx.options.advanced.label": "Advanced",
+  "pptx.options.advanced.description": "Advanced options for working with the viewer.",
+  "pptx.options.advanced.editing": "Editing options",
+  "pptx.options.advanced.autoSelectWord": "When selecting, automatically select entire word",
+  "pptx.options.advanced.textDragAndDrop": "Allow text to be dragged and dropped",
+  "pptx.options.advanced.maximumUndoSteps": "Maximum number of undos",
+  "pptx.options.advanced.cutCopyPaste": "Cut, copy, and paste",
+  "pptx.options.advanced.smartCutAndPaste": "Use smart cut and paste",
+  "pptx.options.advanced.showPasteOptions": "Show Paste Options button when content is pasted",
+  "pptx.options.advanced.imageQuality": "Image Size and Quality",
+  "pptx.options.advanced.doNotCompressImages": "Do not compress images in file",
+  "pptx.options.advanced.defaultResolution": "Default resolution",
+  "pptx.options.resolution.highFidelity": "High fidelity",
+  "pptx.options.resolution.ppi330": "330 ppi",
+  "pptx.options.resolution.ppi220": "220 ppi",
+  "pptx.options.resolution.ppi150": "150 ppi",
+  "pptx.options.resolution.ppi96": "96 ppi",
+  "pptx.options.advanced.chart": "Chart",
+  "pptx.options.advanced.chartFollowDataPoint": "Properties follow chart data point",
+  "pptx.options.advanced.display": "Display",
+  "pptx.options.advanced.recentCount": "Show this number of Recent Presentations",
+  "pptx.options.advanced.disableHardwareAcceleration": "Disable hardware graphics acceleration",
+  "pptx.options.advanced.openDocumentsView": "Open all documents using this view",
+  "pptx.options.openView.savedView": "The view saved in the file",
+  "pptx.options.openView.normal": "Normal",
+  "pptx.options.openView.outline": "Outline",
+  "pptx.options.openView.slideSorter": "Slide Sorter",
+  "pptx.options.openView.notes": "Notes",
+  "pptx.options.advanced.slideShow": "Slide Show",
+  "pptx.options.advanced.showMenuOnRightClick": "Show menu on right mouse click",
+  "pptx.options.advanced.showPopupToolbar": "Show popup toolbar",
+  "pptx.options.advanced.promptKeepInk": "Prompt to keep ink annotations when exiting",
+  "pptx.options.advanced.endWithBlackSlide": "End with black slide",
+  "pptx.options.advanced.print": "Print",
+  "pptx.options.advanced.printInBackground": "Print in background",
+  "pptx.options.advanced.printHighQuality": "High quality",
+  "pptx.options.advanced.printUseMostRecent": "Use the most recently used print settings",
+  "pptx.options.advanced.printWhat": "Print what",
+  "pptx.options.printWhat.slides": "Full Page Slides",
+  "pptx.options.printWhat.handouts": "Handouts",
+  "pptx.options.printWhat.notes": "Notes Pages",
+  "pptx.options.printWhat.outline": "Outline",
+  "pptx.options.advanced.printColorMode": "Color/grayscale",
+  "pptx.options.printColorMode.color": "Color",
+  "pptx.options.printColorMode.grayscale": "Grayscale",
+  "pptx.options.printColorMode.blackAndWhite": "Pure Black and White",
+  "pptx.options.advanced.printHiddenSlides": "Print hidden slides",
+  "pptx.options.advanced.printScaleToFit": "Scale to fit paper",
+  "pptx.options.advanced.printFrameSlides": "Frame slides",
+  "pptx.options.ribbon.label": "Customize Ribbon",
+  "pptx.options.ribbon.description": "Customize the ribbon.",
+  "pptx.options.ribbon.tabsTitle": "Main Tabs",
+  "pptx.options.ribbon.tabsDescription": "Untick a tab to hide it from the ribbon. The File tab is always shown.",
+  "pptx.options.ribbon.reset": "Reset ribbon customizations",
+  "pptx.options.quickAccess.label": "Quick Access Toolbar",
+  "pptx.options.quickAccess.description": "Customize the Quick Access Toolbar.",
+  "pptx.options.quickAccess.optionsTitle": "Quick Access Toolbar options",
+  "pptx.options.quickAccess.show": "Show Quick Access Toolbar",
+  "pptx.options.quickAccess.position": "Toolbar Position",
+  "pptx.options.quickAccessPosition.above": "Above Ribbon",
+  "pptx.options.quickAccessPosition.below": "Below Ribbon",
+  "pptx.options.quickAccess.showLabels": "Always show command labels",
+  "pptx.options.quickAccess.chooseCommands": "Choose commands",
+  "pptx.options.quickAccess.currentCommands": "Customize Quick Access Toolbar",
+  "pptx.options.quickAccess.add": "Add",
+  "pptx.options.quickAccess.remove": "Remove",
+  "pptx.options.quickAccess.moveUp": "Move Up",
+  "pptx.options.quickAccess.moveDown": "Move Down",
+  "pptx.options.quickAccess.reset": "Reset",
+  "pptx.options.quickAccess.command.presentFromStart": "From Beginning",
+  "pptx.options.quickAccess.command.print": "Print",
+  "pptx.options.quickAccess.command.exportPdf": "Export as PDF",
+  "pptx.options.quickAccess.command.newSlide": "New Slide",
+  "pptx.options.quickAccess.command.zoomIn": "Zoom In",
+  "pptx.options.quickAccess.command.zoomOut": "Zoom Out",
+  "pptx.options.addIns.label": "Add-ins",
+  "pptx.options.addIns.description": "View and manage viewer capability modules.",
+  "pptx.options.addIns.name": "Name",
+  "pptx.options.addIns.location": "Location",
+  "pptx.options.addIns.type": "Type",
+  "pptx.options.addIns.active": "Active Capability Modules",
+  "pptx.options.addIns.inactive": "Inactive Capability Modules",
+  "pptx.options.addInType.renderer": "Renderer",
+  "pptx.options.addInType.converter": "Converter",
+  "pptx.options.addInType.collaboration": "Collaboration",
+  "pptx.options.addInType.localization": "Localization",
+  "pptx.options.addIns.smartArt3d": "SmartArt 3D Renderer",
+  "pptx.options.addIns.smartArt3dDescription": "Opt-in three.js renderer for extruded and spatial SmartArt layouts.",
+  "pptx.options.addIns.model3d": "3D Model Renderer",
+  "pptx.options.addIns.model3dDescription": "Interactive GLB/GLTF model rendering on slides.",
+  "pptx.options.addIns.emfConverter": "EMF/WMF Converter",
+  "pptx.options.addIns.emfConverterDescription": "Converts EMF and WMF metafile images to PNG for display.",
+  "pptx.options.addIns.mtxDecompressor": "MicroType Express Font Decompressor",
+  "pptx.options.addIns.mtxDecompressorDescription": "Decompresses embedded MicroType Express fonts.",
+  "pptx.options.addIns.collaboration": "Real-time Collaboration",
+  "pptx.options.addIns.collaborationDescription": "CRDT-based co-editing, presence, and sync relay support.",
+  "pptx.options.addIns.locales": "Locale Packs",
+  "pptx.options.addIns.localesDescription": "Additional display languages for the viewer chrome.",
+  "pptx.options.trust.label": "Trust Center",
+  "pptx.options.trust.description": "Help keep your documents safe and secure.",
+  "pptx.options.trust.settingsTitle": "Security settings",
+  "pptx.options.trust.settingsDescription": "These settings help keep the content you open safe. We recommend the defaults.",
+  "pptx.options.trust.protectedView": "Open presentations in Protected View",
+  "pptx.options.trust.protectedViewInfo": "Documents open read-only; use Enable Editing to make changes.",
+  "pptx.options.trust.allowExternalContent": "Allow external content (remote images and media)",
+  "pptx.options.trust.allowExternalContentInfo": "When off, only content embedded in the file is displayed.",
+  "pptx.options.trust.confirmHyperlinks": "Confirm before opening external hyperlinks"
 };
 function keyToLabel(key) {
   const last = key.split(".").pop() ?? key;