pptx-angular-viewer 1.30.0 → 1.30.1

package/CHANGELOG.md

@@ -4,6 +4,12 @@ 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.30.0](https://github.com/ChristopherVR/pptx-viewer/releases/tag/pptx-angular-viewer@1.30.0) - 2026-07-18
+
+### Features
+
+- **angular:** Promote RibbonComponent for independent composition (by @ChristopherVR) ([00ab33e](https://github.com/ChristopherVR/pptx-viewer/commit/00ab33e515857cd60a5aef01537c1024297e08e5))
+
 ## [1.29.0](https://github.com/ChristopherVR/pptx-viewer/releases/tag/pptx-angular-viewer@1.29.0) - 2026-07-18
 
 ### Dependencies

package/README.md

@@ -14,8 +14,6 @@ The rendering is done by the framework-agnostic [`pptx-viewer-core`](https://www
 
 <samp>**[▶️ Try the live demo](https://christophervr.github.io/pptx-viewer/demo-angular/)** · **[📦 npm](https://www.npmjs.com/package/pptx-angular-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-angular/)**: open a `.pptx` and render it in your browser, no install required.
-
 ## Features
 
 - **Standalone component**: `<pptx-viewer>`, no NgModule needed.
@@ -48,7 +46,18 @@ The rendering is done by the framework-agnostic [`pptx-viewer-core`](https://www
 npm install pptx-angular-viewer
 ```
 
-**Peer requirements:** Angular 22+ (`@angular/core`, `@angular/common`) and `rxjs`.
+**Peer requirements:** Angular 22+ (`@angular/core`, `@angular/common`), `rxjs`,
+and `@ngx-translate/core` (all UI labels go through it, see
+[Localization](#localization-i18n)):
+
+```bash
+npm install @angular/core @angular/common rxjs @ngx-translate/core
+```
+
+**Optional peers:** `three` enables interactive GLB/GLTF 3D models and the
+`smartArt3D` renderer; `yjs` + `y-websocket` (or `y-webrtc` for serverless
+peer-to-peer) enable real-time collaboration. Without them those features
+degrade gracefully (poster images, no live session).
 
 ## Usage
 
@@ -205,26 +214,43 @@ and `LoadContentService` are the two nearly everything depends on).
 
 ### Inputs
 
-| Input           | Type                                | Default | Description                                                                                                            |
-| --------------- | ----------------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------- |
-| `content`       | `Uint8Array \| ArrayBuffer \| null` | `null`  | The `.pptx` bytes to render.                                                                                           |
-| `theme`         | `ViewerTheme`                       | n/a     | Color/radius overrides applied as CSS custom properties.                                                               |
-| `class`         | `string`                            | `''`    | Class applied to the root element.                                                                                     |
-| `canEdit`       | `boolean`                           | `false` | Enables the editor toolbar, inspector, and drag-and-drop editing.                                                      |
-| `collaboration` | `CollaborationConfig`               | n/a     | Yjs real-time collaboration config (server URL, room, role).                                                           |
-| `hiddenActions` | `ToolbarActionId[]`                 | `[]`    | Toolbar buttons/ribbon tabs to hide individually (e.g. `['share', 'broadcast']`), instead of hiding the whole toolbar. |
+| Input              | Type                                 | Default | Description                                                                                                            |
+| ------------------ | ------------------------------------ | ------- | ---------------------------------------------------------------------------------------------------------------------- |
+| `content`          | `Uint8Array \| ArrayBuffer \| null`  | `null`  | The `.pptx` bytes to render.                                                                                           |
+| `theme`            | `ViewerTheme`                        | n/a     | Color/radius overrides applied as CSS custom properties. Always wins over the File > Options theme picker.             |
+| `class`            | `string`                             | `''`    | Class applied to the root element.                                                                                     |
+| `canEdit`          | `boolean`                            | `false` | Enables the editor toolbar, inspector, and drag-and-drop editing.                                                      |
+| `filePath`         | `string`                             | n/a     | Host file path/identifier keying the version-history store.                                                            |
+| `fileName`         | `string`                             | n/a     | Display name of the open document, shown in the title bar.                                                             |
+| `fonts`            | `ViewerFontSource[]`                 | `[]`    | Licensed font sources supplied by the host application.                                                                |
+| `authorName`       | `string`                             | n/a     | Display name for the local user in collaboration/broadcast sessions and presence avatars.                              |
+| `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's start form.                                                                         |
+| `onOpenFile`       | `() => void`                         | n/a     | Host override for File > Open; bypasses the built-in file picker.                                                      |
+| `smartArt3D`       | `boolean`                            | `false` | Opt-in Three.js 3D SmartArt renderer (needs the optional `three` peer; falls back to SVG without it).                  |
+| `hiddenActions`    | `ToolbarActionId[]`                  | `[]`    | Toolbar buttons/ribbon tabs to hide individually (e.g. `['share', 'broadcast']`), instead of hiding the whole toolbar. |
+| `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 `TranslateService` languages).         |
+| `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`).                                      |
 
 ### Outputs
 
-| Output              | Payload      | Description                                                          |
-| ------------------- | ------------ | -------------------------------------------------------------------- |
-| `activeSlideChange` | `number`     | Emits the active slide index on navigation.                          |
-| `dirtyChange`       | `boolean`    | Emits `true`/`false` when the dirty state changes.                   |
-| `contentChange`     | `Uint8Array` | Emits updated bytes after any editing change.                        |
-| `modeChange`        | `string`     | Emits the new mode (`'preview'`, `'edit'`, `'present'`, `'master'`). |
-| `zoomChange`        | `number`     | Emits the new zoom level (1 = 100%).                                 |
-| `selectionChange`   | `string[]`   | Emits the selected element IDs when selection changes.               |
-| `slideCountChange`  | `number`     | Emits the total slide count when slides change.                      |
+| Output               | Payload                       | Description                                                          |
+| -------------------- | ----------------------------- | -------------------------------------------------------------------- |
+| `activeSlideChange`  | `number`                      | Emits the active slide index on navigation.                          |
+| `dirtyChange`        | `boolean`                     | Emits `true`/`false` when the dirty state changes.                   |
+| `contentChange`      | `Uint8Array`                  | Emits updated bytes after any editing change.                        |
+| `modeChange`         | `string`                      | Emits the new mode (`'preview'`, `'edit'`, `'present'`, `'master'`). |
+| `zoomChange`         | `number`                      | Emits the new zoom level (1 = 100%).                                 |
+| `selectionChange`    | `string[]`                    | Emits the selected element IDs when selection changes.               |
+| `slideCountChange`   | `number`                      | Emits the total slide count when slides change.                      |
+| `propertiesChange`   | `Partial<PptxCoreProperties>` | Emits when the user edits document properties in the Info dialog.    |
+| `startCollaboration` | `CollaborationConfig`         | Emits when a collaboration/broadcast session starts.                 |
+| `stopCollaboration`  | `void`                        | Emits when the collaboration/broadcast session stops.                |
 
 ### Methods
 
@@ -252,6 +278,15 @@ and `LoadContentService` are the two nearly everything depends on).
 | `selectElements(ids)`     | `void`                | Programmatically select elements by ID.        |
 | `clearSelection()`        | `void`                | Clear the current selection.                   |
 
+The component 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)`.
+
 ### Exported components & helpers
 
 `PowerPointViewerComponent`, `SlideCanvasComponent`, `RibbonComponent`,

package/fesm2022/pptx-angular-viewer.mjs

@@ -25116,7 +25116,12 @@ function decodeDelta(delta) {
                 /* skip */
             }
         }
-        if (op.insert !== '\n' && op.insert !== '​') {
+        // '\n' is only the synthetic break marker when the op carries a break
+        // attribute; a literal newline TEXT run (no pb/lb) must keep its text or
+        // runs like "Project\nAtlas" collapse to "ProjectAtlas" on decode. The
+        // zero-width space is always the empty-run attribute holder.
+        const isBreakMarker = op.insert === '\n' && (a.pb === '1' || a.lb === '1');
+        if (!isBreakMarker && op.insert !== '​') {
             seg.text = op.insert;
         }
         segments.push(seg);
@@ -44379,6 +44384,33 @@ class CollaborationService {
     seedBaseline(slides) {
         this.lastSynced = JSON.stringify(slides);
     }
+    /**
+     * Re-adopt the shared document's slides after a local content load has been
+     * committed to viewer state. The load pipeline applies its parsed deck
+     * unconditionally, so a load that finishes AFTER the room's slides were
+     * already applied (a late joiner's bootstrap deck parsing slower than the
+     * doc sync) silently clobbers the synced state and, with the doc itself
+     * unchanged, the remote observer never re-fires. When the room already has
+     * slides they win: the doc content is re-applied through `onRemoteSlides`
+     * and recorded as the sync baseline (bypassing the usual JSON dedupe) so
+     * the follow-up local broadcast of the adopted deck is a no-op. An empty
+     * room means this client is the seeder and the loaded deck stands, written
+     * by the normal gated broadcast path. Returns true when the doc was adopted.
+     */
+    adoptDocSlidesAfterLoad() {
+        if (!this.ydoc || !this.connected()) {
+            return false;
+        }
+        const docSlides = readSlidesFromYDoc(this.ydoc);
+        if (docSlides.length === 0) {
+            return false;
+        }
+        this.lastSynced = JSON.stringify(docSlides);
+        this.applyingRemote = true;
+        this.onRemoteSlides?.(docSlides);
+        this.applyingRemote = false;
+        return true;
+    }
     broadcastSlides(slides) {
         if (!this.ydoc || !this.yFactories || this.applyingRemote || slides.length === 0) {
             return;
@@ -72505,7 +72537,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.7", ngImpor
         }], propDecorators: { canEdit: [{ type: i0.Input, args: [{ isSignal: true, alias: "canEdit", required: false }] }], slideIndex: [{ type: i0.Input, args: [{ isSignal: true, alias: "slideIndex", required: false }] }] } });
 
 // Generated by scripts/inline-shared.mjs from package.json. Do not edit.
-const PPTX_ANGULAR_VIEWER_VERSION = "1.29.0";
+const PPTX_ANGULAR_VIEWER_VERSION = "1.30.0";
 
 /**
  * account-page.component.ts: File > Account content.
@@ -95648,6 +95680,15 @@ class PowerPointViewerComponent {
             untracked(() => {
                 this.editor.setSlides(slides, this.loader.sections());
                 this.activeSlideIndex.set(0);
+                // A load that lands mid-session must not clobber remotely synced
+                // slides: when the shared doc already holds the room's content, a
+                // late joiner's bootstrap deck (parsed slower than the doc sync)
+                // would silently overwrite it here and, with the doc unchanged,
+                // never see it re-applied. Re-adopt the doc's slides synchronously
+                // so the broadcast effect below (which only runs after this effect
+                // completes) sees the adopted deck, never the placeholder, and its
+                // write dedupes against the adopted baseline.
+                this.collab.adoptDocSlidesAfterLoad();
             });
         });
         // Selecting an element re-opens the inspector if a prior swipe had hidden