pptx-react-viewer 4.55.0 → 4.56.0

package/CHANGELOG.md

@@ -7,6 +7,60 @@ A release listed with no entries carried no Conventional Commit in this package'
 scope: scripts/release-plan.mjs releases whenever any published file changes, not only on
 conventional commits.
 
+## [4.56.0](https://github.com/ChristopherVR/ooxml/releases/tag/pptx-react-viewer@4.56.0) - 2026-10-28
+
+### Features
+
+- **pptx:** Expose the slide thumbnail rail as a building block in every binding ([#228](https://github.com/ChristopherVR/ooxml/issues/228)) ([2b77f02](https://github.com/ChristopherVR/ooxml/commit/2b77f026e1e26e6a5fe3c52f275608f39bc0ea8e))
+- **text:** Share font selection with word script layout ([59ad0a2](https://github.com/ChristopherVR/ooxml/commit/59ad0a2e8249d3ffc9be34c2c9e6f9ffe8b3b07a))
+- **chart:** Share manual plot layout across chart painters ([18b79c0](https://github.com/ChristopherVR/ooxml/commit/18b79c04bb1d2aa914630453413d995d0bb54922))
+- **chart:** Share smooth series paths and authored strokes ([7329e5c](https://github.com/ChristopherVR/ooxml/commit/7329e5cbb546a041c0e67417fbe84e9d3dc415a2))
+- **chart:** Share point label offsets and pie leader lines ([861f78f](https://github.com/ChristopherVR/ooxml/commit/861f78f5d9ba0fa93ed6e85ddfc209fd2bf828ca))
+- **drawingml:** Render guide-driven custom shapes in word ([81558e6](https://github.com/ChristopherVR/ooxml/commit/81558e6fcfdb2a64ced22661410cbdfba954cea2))
+- **drawingml:** Share picture crop with excel ([f093c0f](https://github.com/ChristopherVR/ooxml/commit/f093c0f6d1c2ea96736613990e870143d770774e))
+- **chart:** Share calendar date axis rendering ([474de5c](https://github.com/ChristopherVR/ooxml/commit/474de5c4f2418ee7b67ec34a5e08c8eefa4bb992))
+- **chart:** Share chart data table layout and rendering ([09fbdf1](https://github.com/ChristopherVR/ooxml/commit/09fbdf1ec8016b376b67053d8a5575fc3d1ef145))
+- **drawingml:** Share ordered picture effects with excel ([b669575](https://github.com/ChristopherVR/ooxml/commit/b669575a041ab25169a7c83757075fe9dffe390a))
+- **chart:** Share funnel geometry and neutral rendering ([28f6ce3](https://github.com/ChristopherVR/ooxml/commit/28f6ce302fa5791a11819209d6501e97e971b80b))
+- **chart:** Share box distributions and neutral rendering ([6390e30](https://github.com/ChristopherVR/ooxml/commit/6390e30ac6994e6891f8324e4264949f66e0a0a0))
+- **diagram:** Paint cached pictures in word and excel ([f254d51](https://github.com/ChristopherVR/ooxml/commit/f254d51eeed81279dd9f971cb7ac496364738ec2))
+- **drawingml:** Share source-backed text body 3d codecs ([bcf2a0a](https://github.com/ChristopherVR/ooxml/commit/bcf2a0a491c6e4dc4e5fd4f5b615f3673285cadf))
+- **pptx:** Add an /ai entry and createAiAssistant to every binding ([#219](https://github.com/ChristopherVR/ooxml/issues/219)) ([ecd4d43](https://github.com/ChristopherVR/ooxml/commit/ecd4d43acfc0133c2f9c1e3320f366244ba3bba3))
+- **visio:** Improve selection dragging and resizing ([60cf8dd](https://github.com/ChristopherVR/ooxml/commit/60cf8dd9c547f16e114b98ae01fed0968aca5866))
+
+### Bug Fixes
+
+- **pptx:** Scope collaboration undo to the local participant ([55b8bad](https://github.com/ChristopherVR/ooxml/commit/55b8badcf0ec06a7294debff8deff844dcfafb62))
+- **pptx:** Autocorrect only the text typed in this edit ([0e5a85e](https://github.com/ChristopherVR/ooxml/commit/0e5a85e496e0d53e36c00e6fdfd5dd3749337d8a))
+- **pptx:** Keep browser-local blob URLs out of the collaboration room ([433891b](https://github.com/ChristopherVR/ooxml/commit/433891b1db9a173780e6ad59cad56d92a5a0e929))
+- **chart:** Resolve chartex axes by position to avoid prototype pollution ([16edc2f](https://github.com/ChristopherVR/ooxml/commit/16edc2fd96b261ecbfbe388491fe12494be15b89))
+- **drawingml:** Separate guide and path coordinate spaces ([4db9fe1](https://github.com/ChristopherVR/ooxml/commit/4db9fe140ec43aae8cac6cae8846ccf4dad9ba58))
+- **chart:** Export shared date format tokenizer ([b928657](https://github.com/ChristopherVR/ooxml/commit/b928657532d41bec6a83a5969c03be922ef0a90a))
+- **drawingml:** Bound picture luminance and report extensions ([a36e847](https://github.com/ChristopherVR/ooxml/commit/a36e84725c483815ae7508872dd4d89c5a8375b2))
+- **chart:** Paint date ticks over plot backgrounds ([e3fad37](https://github.com/ChristopherVR/ooxml/commit/e3fad379f6d990c1ad85658e751cb84176ca7852))
+- **docx:** Load media for cached smartart pictures ([149b350](https://github.com/ChristopherVR/ooxml/commit/149b35025750b5189813e34cfa33cd1ff5757a17))
+- **chart:** Retain table names and exclude hidden box series ([292dc25](https://github.com/ChristopherVR/ooxml/commit/292dc25c22544d9179d5c0fd31327a3d0aafb462))
+- **chart:** Match native funnel label and box mean defaults ([06bbf26](https://github.com/ChristopherVR/ooxml/commit/06bbf26e496f00270eca67472087454496217cc1))
+- **drawingml:** Preserve anchors and guard text 3d edits ([617a029](https://github.com/ChristopherVR/ooxml/commit/617a02979d5cdae5e3818afd8fb79af367de25eb))
+- **drawingml:** Preserve omitted picture source formatting ([5e2d57d](https://github.com/ChristopherVR/ooxml/commit/5e2d57dfe0b3076be7c6cb5b086c596643eb5203))
+
+### Refactor
+
+- **opc:** Share hyperlink policy with explicit host protocols ([5f8ac72](https://github.com/ChristopherVR/ooxml/commit/5f8ac72edbe4fff4d2fa303ed3ce8a471762bd12))
+
+### Documentation
+
+- Record further shared office capability delivery ([845ee99](https://github.com/ChristopherVR/ooxml/commit/845ee99bdc290e148c485c87e64d853a5884e7f8))
+
+### Testing
+
+- **diagram:** Guard optional word media in picture assertion ([c8f5d14](https://github.com/ChristopherVR/ooxml/commit/c8f5d14ddcdef1ee04de6d4f3e557d1719eae5e8))
+
+### Chores
+
+- Integrate current main for reuse verification ([a22d5f5](https://github.com/ChristopherVR/ooxml/commit/a22d5f53406330909d3853ab64a4d850bc3c0ad1))
+- Integrate main before shared capability push ([9dc78da](https://github.com/ChristopherVR/ooxml/commit/9dc78da5262a854807b9fc8395f1fd97f71c2eb4))
+
 ## [4.55.0](https://github.com/ChristopherVR/ooxml/releases/tag/pptx-react-viewer@4.55.0) - 2026-10-28
 
 ### Features

package/README.md

@@ -110,7 +110,7 @@ const bytes = await viewerRef.current?.getContent(); // Uint8Array of a valid .p
 | `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)                                                                                                                                                                                                                                                     |
 | `surfaceChart3D`, `barChart3D`, `lineChart3D`, `areaChart3D`, `pieChart3D` | `boolean`                               | `false`  | Independently opt in to interactive Three.js renderers for the matching 3D chart kinds; each falls back to SVG when WebGL is unavailable.                                                                                                                                                                                                                      |
-| `ai`                                                                       | `PptxAiConfig`                          | n/a      | Optional AI assistant configuration. The SDK peers load only when its panel is opened.                                                                                                                                                                                                                                                                         |
+| `ai`                                                                       | `PptxAiAssistant \| PptxAiConfig`       | n/a      | Optional AI assistant: a handle from `createAiAssistant` (`pptx-react-viewer/ai`), or a plain config. The SDK peers load only when its panel is opened. See [AI assistant](#ai-assistant).                                                                                                                                                                     |
 | `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                                                                                                                                                                                                                                                                                                                                |
@@ -265,6 +265,21 @@ import { PowerPointViewer, vermilionLightTheme } from 'pptx-react-viewer';
 
 The underlying palettes (`vermilionLightColors`, `vermilionDarkColors`) and radius (`vermilionRadius`) are exported too, so you can spread them into your own variant.
 
+## AI assistant
+
+Create the assistant with `createAiAssistant` from the `pptx-react-viewer/ai` entry. Install the `ai` and `@ai-sdk/react` peers, create an assistant once (at module scope or in `useMemo`) and pass it to the `ai` prop:
+
+```tsx
+import { PowerPointViewer } from 'pptx-react-viewer';
+import { createAiAssistant } from 'pptx-react-viewer/ai';
+
+const assistant = createAiAssistant({ connection: { kind: 'endpoint', api: '/api/ai/chat' } });
+
+<PowerPointViewer content={bytes} ai={assistant} />;
+```
+
+The panel still loads lazily, the first time the user opens it, and the main entries still reach the same lazy panel loader. The handle is opaque: only `createAiAssistant` makes one, and any other value is read as a plain config. A plain `PptxAiConfig` (`ai={{ connection }}`) keeps working through the viewer's own lazy panel and is not deprecated in this release; the handle is a preparatory, opt-in path for a later major release (see [The `/ai` entry](https://christophervr.github.io/ooxml/pptx/guide/ai-assistant#ai-entry)). The `PptxAi*` types are exported from both `pptx-react-viewer` and `pptx-react-viewer/ai`. See the [AI assistant guide](https://christophervr.github.io/ooxml/pptx/guide/ai-assistant) for connection modes, tools and the write policy.
+
 ## Localization (i18n)
 
 UI labels go through [i18next](https://www.i18next.com/) / [react-i18next](https://react.i18next.com/) with dotted keys such as `pptx.statusBar.allSaved`, or through your own i18n library with `PptxI18nProvider` (see below). Initialise an i18next instance and wrap your app in `I18nextProvider` (the demo's `demos/pptx/demo-react/i18n.ts` shows a minimal config, including a `parseMissingKeyHandler` that derives Title Case labels for any key you don't explicitly translate). `pptx-react-viewer/i18n` exports `translationsEn` (the English dictionary), `keyToLabel` (the fallback), and a `TranslationKey` type you can use to type-check a new locale dictionary (`Record<TranslationKey, string>`) at compile time. Add a new language by supplying a resource bundle under its language code. See the [Localization guide](https://christophervr.github.io/ooxml/pptx/guide/localization) for full wiring examples and how to contribute a translation upstream; the live demo's language picker is a working reference.

package/dist/ai.d.ts

@@ -0,0 +1,17 @@
+import { PptxAiConfig } from 'ooxml-ui/pptx/ai';
+export { PptxAiBridge, PptxAiConfig, PptxAiConnection, PptxAiContextStrategy, PptxAiToolName, PptxAiWritePolicy } from 'ooxml-ui/pptx/ai';
+import { PptxAiAssistant } from 'ooxml-ui/pptx/ai/host';
+export { PptxAiAssistant } from 'ooxml-ui/pptx/ai/host';
+
+//#region src/ai.d.ts
+/**
+ * Create an AI assistant for the viewer's `ai` prop from a `PptxAiConfig`.
+ *
+ * The handle is opaque and loads nothing. It keeps `config` by reference; create a new
+ * handle to change it. Every handle renders the same chat panel component, so a handle
+ * created on every render (rather than in `useMemo` or at module scope) never remounts the
+ * chat.
+ */
+declare function createAiAssistant(config: PptxAiConfig): PptxAiAssistant;
+
+export { createAiAssistant };

package/dist/ai.js

@@ -0,0 +1,11 @@
+'use strict';
+
+var chunkF6WCYCHV_js = require('./chunk-F6WCYCHV.js');
+require('./chunk-PIRHQTI4.js');
+
+// src/ai.ts
+function createAiAssistant(config) {
+  return chunkF6WCYCHV_js.aiAssistants.register(config, chunkF6WCYCHV_js.AiChatPanelLazy);
+}
+
+exports.createAiAssistant = createAiAssistant;

package/dist/ai.js.br

@@ -0,0 +1,2 @@
+%
 ��tc/�:��^[�kZ�չ
+q�r}����Tri�AP~:X�˷+�o~;%E(l�+f��1m����B���>��J�8?�WF�#A�͑S@&�
RuՄ:�^�;���
=Wlq@N^g��=\i���%��KD.T��PQ^�<d���������ݽ-	9GH�

package/dist/ai.mjs

@@ -0,0 +1,9 @@
+import { aiAssistants, AiChatPanelLazy } from './chunk-NE5JQMED.mjs';
+import './chunk-UV2HVMKZ.mjs';
+
+// src/ai.ts
+function createAiAssistant(config) {
+  return aiAssistants.register(config, AiChatPanelLazy);
+}
+
+export { createAiAssistant };

package/dist/{chunk-OIQAJR57.js → chunk-BL2P6K67.js}

@@ -917,6 +917,7 @@ function useEditorHistory(input) {
     handleRedo,
     resetHistory,
     forgetHistory: history.forget,
+    attachCollaboration: history.attachCollaboration,
     markDirty,
     withoutUndoStep,
     buildHistorySnapshot
@@ -5649,7 +5650,7 @@ function useCanvasInteractions(input) {
         return;
       }
       const liveText = read?.snapshot.text ?? inlineEditingTextRef?.current ?? inlineEditingText;
-      const committedText = transformCommittedText ? transformCommittedText(liveText) : liveText;
+      const committedText = transformCommittedText ? transformCommittedText(liveText, el.text) : liveText;
       const textPatch = pptx.buildInlineTextCommitPatch(
         el,
         committedText,
@@ -7121,7 +7122,7 @@ function createTableStructHandlers(input) {
     if (!el || el.type !== "table") {
       return;
     }
-    const text = transformCommittedText ? transformCommittedText(rawText) : rawText;
+    const text = transformCommittedText ? transformCommittedText(rawText, pptx.getCellText(el, rowIndex, colIndex)) : rawText;
     const updates = {};
     if (el.tableData) {
       updates.tableData = pptx.setCellText(el, rowIndex, colIndex, text).tableData;
@@ -11993,6 +11994,70 @@ function buildCanvasProps(input) {
     }
   };
 }
+function useSlidesPaneProps({
+  state,
+  slides,
+  canEdit,
+  activeSlideIndex,
+  slideSectionGroups,
+  slideOps,
+  sectionOps,
+  recordedTimings,
+  onOpenLayoutGallery
+}) {
+  const { setActiveSlideIndex, setIsSlidesPaneOpen } = state;
+  const fieldContext = React17.useMemo(
+    () => pptx.buildSlidesPaneFieldContext({
+      headerFooter: state.headerFooter,
+      customProperties: state.customProperties,
+      firstSlideNumber: state.firstSlideNumber
+    }),
+    [state.headerFooter, state.customProperties, state.firstSlideNumber]
+  );
+  const tableStyleContext = React17.useMemo(
+    () => pptx.buildSlidesPaneTableStyleContext(state.theme, state.tableStyleMap),
+    [state.theme, state.tableStyleMap]
+  );
+  const rehearsalTimings = React17.useMemo(
+    () => pptx.slidesPaneRehearsalTimings(recordedTimings),
+    [recordedTimings]
+  );
+  const onOpenLayoutForSlide = React17.useCallback(
+    (slideIndex, x, y) => {
+      pptx.openSlidesPaneLayoutGallery({ slideIndex, x, y }, setActiveSlideIndex, onOpenLayoutGallery);
+    },
+    [setActiveSlideIndex, onOpenLayoutGallery]
+  );
+  const onCollapse = React17.useCallback(() => setIsSlidesPaneOpen(false), [setIsSlidesPaneOpen]);
+  return {
+    slides,
+    templateElementsBySlideId: state.templateElementsBySlideId,
+    activeSlideIndex,
+    canvasSize: state.canvasSize,
+    sectionGroups: slideSectionGroups,
+    isOpen: state.isSlidesPaneOpen,
+    canEdit,
+    onSelectSlide: setActiveSlideIndex,
+    onSlideContextMenu: slideOps.handleSlideContextMenu,
+    onMoveSlide: slideOps.handleMoveSlide,
+    onAddSlide: slideOps.handleAddSlide,
+    onAddSlideAfter: slideOps.handleAddSlideAfter,
+    onDuplicateSlides: slideOps.handleDuplicateSlides,
+    onDeleteSlides: slideOps.handleDeleteSlides,
+    onHideSlides: slideOps.handleToggleHideSlides,
+    onOpenLayoutForSlide,
+    onCollapse,
+    onAddSection: sectionOps.addSection,
+    onRenameSection: sectionOps.renameSection,
+    onDeleteSection: sectionOps.deleteSection,
+    onMoveSectionUp: sectionOps.moveSectionUp,
+    onMoveSectionDown: sectionOps.moveSectionDown,
+    onToggleSectionCollapse: sectionOps.toggleSectionCollapse,
+    rehearsalTimings,
+    fieldContext,
+    tableStyleContext
+  };
+}
 
 // src/viewer/hooks/createReviewCommentsHost.ts
 function createReviewCommentsHost(input) {
@@ -12467,7 +12532,7 @@ function RemoteSelectionOverlay({
   )) });
 }
 function useCollaborationDocumentSync(input) {
-  const { collaboration, ...state } = input;
+  const { collaboration, history, ...state } = input;
   const latest = React17.useRef(input);
   latest.current = input;
   const getSourceBytes = React17.useCallback(() => {
@@ -12486,6 +12551,20 @@ function useCollaborationDocumentSync(input) {
     }
   }, []);
   const isConnected = config?.externalSession ? Boolean(collaboration?.doc) : collaboration?.status === "connected";
+  const historyReady = pptx.collaborationHistoryReady({
+    hasDoc: Boolean(doc),
+    external: Boolean(config?.externalSession),
+    connected: isConnected && !config?.externalSession,
+    synced: collaboration?.synced ?? false,
+    viewer: config?.role === "viewer"
+  });
+  const attachCollaboration = history?.attachCollaboration;
+  React17.useEffect(() => {
+    if (!attachCollaboration || !doc || !historyReady) {
+      return;
+    }
+    return pptx.bindCollaborationHistory({ attachCollaboration }, doc, collabModules.loadYjs);
+  }, [attachCollaboration, doc, historyReady]);
   useYjsDocumentSync({
     ...state,
     doc: collaboration?.doc ?? null,
@@ -12522,6 +12601,7 @@ function useViewerBuildingBlocksCollaboration(input) {
   });
   useCollaborationDocumentSync({
     collaboration,
+    history: input.core.history,
     content: input.content,
     slides: state.slides,
     setSlides: state.setSlides,
@@ -12626,7 +12706,7 @@ function useViewerBuildingBlocksCore(input) {
     setEditTemplateMode: state.setEditTemplateMode,
     setHeaderFooter: state.setHeaderFooter
   });
-  const { gridSpacingPx, visibleSlideIndexes, masterPseudoSlide } = useDerivedSlideState({
+  const { gridSpacingPx, visibleSlideIndexes, masterPseudoSlide, slideSectionGroups } = useDerivedSlideState({
     slides,
     sections: state.sections,
     customShows: state.customShows,
@@ -12685,6 +12765,7 @@ function useViewerBuildingBlocksCore(input) {
     setExitModeHandler,
     masterPseudoSlide,
     gridSpacingPx,
+    slideSectionGroups,
     // Multiplied against the pre-existing 2x baseline; see the matching
     // comment in `PowerPointViewer.tsx`.
     imageExportScale: 2 * pptx.resolveImageResolutionScale(viewerOptions),
@@ -13014,7 +13095,8 @@ function useViewerBuildingBlocks(input) {
     onSlideCountChange,
     onOpenSettings,
     onOpenHeaderFooter,
-    onOpenShareDialog
+    onOpenShareDialog,
+    onOpenLayoutGallery
   } = input;
   const collaborationConfig = pptx.resolveCollaborationConfig(input.collaboration);
   const [collaborationReadOnly, setCollaborationReadOnly] = React17.useState(Boolean(collaborationConfig));
@@ -13062,6 +13144,7 @@ function useViewerBuildingBlocks(input) {
     presentation,
     masterPseudoSlide,
     gridSpacingPx,
+    slideSectionGroups,
     viewerOptions
   } = core;
   const canEdit = pptx.resolveCollaborationShellEditability({
@@ -13168,6 +13251,17 @@ function useViewerBuildingBlocks(input) {
 ${url}`
   });
   canvasProps.collaborationOverlay = overlay;
+  const slidesPaneProps = useSlidesPaneProps({
+    state,
+    slides,
+    canEdit,
+    activeSlideIndex,
+    slideSectionGroups,
+    slideOps: editorOps.slideOps,
+    sectionOps: editorOps.sectionOps,
+    recordedTimings: presentation.recordedTimings,
+    onOpenLayoutGallery
+  });
   const shellState = React17.useMemo(
     () => pptx.resolveCollaborationShellState({
       authorizedCanEdit: requestedCanEdit,
@@ -13192,6 +13286,7 @@ ${url}`
   return {
     toolbarProps,
     canvasProps,
+    slidesPaneProps,
     mode,
     loading,
     error,