pptx-vue-viewer 3.17.0 → 3.18.0

package/CHANGELOG.md

@@ -7,6 +7,44 @@ A release listed with no entries carried no Conventional Commit in this package'
 scope: scripts/release-plan.mjs re-releases a package whenever any of its files
 change, not only on conventional ones.
 
+## [3.17.1](https://github.com/ChristopherVR/pptx-viewer/releases/tag/pptx-vue-viewer@3.17.1) - 2026-09-14
+
+### Bug Fixes
+
+- **i18n:** Localize inspector and ribbon controls (by @yunfeizhu) ([a657a76](https://github.com/ChristopherVR/pptx-viewer/commit/a657a766d653106f04d50f7b13a94a6c12c77f1e))
+
+## [3.17.0](https://github.com/ChristopherVR/pptx-viewer/releases/tag/pptx-vue-viewer@3.17.0) - 2026-09-13
+
+### Features
+
+- **shared:** Add configurable viewport fit options (by @Sudhansh6) ([93e3218](https://github.com/ChristopherVR/pptx-viewer/commit/93e3218de54ce8d153761e2fba83f3558fc3051b))
+- **vue:** Add configurable viewport fit options (by @Sudhansh6) ([5b3bdac](https://github.com/ChristopherVR/pptx-viewer/commit/5b3bdace56a56b10bf0175179f28fb2c3f9ee9d8))
+- **shared:** Expose public element insertion across viewers (by @Sudhansh6) ([2701047](https://github.com/ChristopherVR/pptx-viewer/commit/2701047d5011b5d7ce8408009addc1dc31f6e3f7))
+
+### Bug Fixes
+
+- **core:** Preserve empty paragraph insertion formatting (by @Sudhansh6) ([121f6bf](https://github.com/ChristopherVR/pptx-viewer/commit/121f6bf9f64a29ab07e07b5d4f042a4b075d7876))
+- **shared:** Preserve empty paragraph insertion formatting (by @Sudhansh6) ([b34d0f5](https://github.com/ChristopherVR/pptx-viewer/commit/b34d0f5ab9879e02f1de85c0e50b15f3947735c3))
+- **vue:** Preserve empty paragraph insertion formatting (by @Sudhansh6) ([4a82f35](https://github.com/ChristopherVR/pptx-viewer/commit/4a82f35e14e66cb0e48c7780f3355fa8aca4b4c2))
+- **vue,angular:** Honor public edit and preview mode switches (by @Sudhansh6) ([97b1e7b](https://github.com/ChristopherVR/pptx-viewer/commit/97b1e7b494d793fae1069583a7db1aa385550329))
+- **shared:** Continue inserted paragraphs from the local list (by @Sudhansh6) ([78b8226](https://github.com/ChristopherVR/pptx-viewer/commit/78b82261a320b93052627ec9e6e460c4845f6f32))
+- **shared:** Leave empty clipboard paste shortcuts unclaimed (by @Sudhansh6) ([aec446f](https://github.com/ChristopherVR/pptx-viewer/commit/aec446f7f36371ad2f9c1cf3e68b7aaeb4f2cc28))
+
+### Other
+
+- Retain empty paragraph styles with source alignment (by @Sudhansh6) ([d979cd2](https://github.com/ChristopherVR/pptx-viewer/commit/d979cd25b7c05cef0fc4d4501c39d2bb11e572e0))
+- Integrate semantic list commands with empty paragraph formatting (by @Sudhansh6) ([c5d9a6f](https://github.com/ChristopherVR/pptx-viewer/commit/c5d9a6f4f52c44180111c1f5fca0f10299dce47a))
+- Sync main font and SmartArt fixes (by @Sudhansh6) ([f2066eb](https://github.com/ChristopherVR/pptx-viewer/commit/f2066eb87b62884cadd77593e8b36426398c3312))
+- Sync main paragraph and history fixes (by @Sudhansh6) ([a18a2d7](https://github.com/ChristopherVR/pptx-viewer/commit/a18a2d7fe2bccf7d8c49b72d7a80087d423d1da0))
+- Sync viewport fit changes from main (by @Sudhansh6) ([3c3c0bd](https://github.com/ChristopherVR/pptx-viewer/commit/3c3c0bdb2f88648dd20ffac9b6fd5a691741253d))
+- Sync public insertion with viewport fit API (by @Sudhansh6) ([47df3db](https://github.com/ChristopherVR/pptx-viewer/commit/47df3db6bb7bb6bbee06e36c9ff9565b2fc61252))
+- Sync public insertion with empty paragraph formatting (by @Sudhansh6) ([d1ad9c9](https://github.com/ChristopherVR/pptx-viewer/commit/d1ad9c9562313085cab62f3b9f9fa0abc6d0fa1f))
+- Integrate preview and save-state fixes into insertion (by @Sudhansh6) ([1c33fb5](https://github.com/ChristopherVR/pptx-viewer/commit/1c33fb571634306e6dd989291185313e3cdafb49))
+
+### Documentation
+
+- Move viewport fitting into developer guides (by @Sudhansh6) ([60707eb](https://github.com/ChristopherVR/pptx-viewer/commit/60707ebf8f261779b2ebfa41ff0741267a672bd3))
+
 ## [3.16.7](https://github.com/ChristopherVR/pptx-viewer/releases/tag/pptx-vue-viewer@3.16.7) - 2026-09-13
 
 ### Bug Fixes

package/README.md

@@ -53,7 +53,7 @@ npm install vue vue-i18n jszip fast-xml-parser
 ```
 
 **Optional:** `three` enables interactive GLB/GLTF 3D models and the
-`smartArt3D` renderer; without it those elements fall back to poster images /
+`smartArt3D` and 3D chart renderers; without it those elements fall back to poster images /
 flat SVG.
 
 The `pptx-viewer-core` engine is **bundled in**, so you don't install it
@@ -178,30 +178,32 @@ See the [cross-binding defaults](../../docs/guide/viewport-fit.md).
 
 ### Props
 
-| Prop                 | Type                                 | Default | Description                                                                                                               |
-| -------------------- | ------------------------------------ | ------- | ------------------------------------------------------------------------------------------------------------------------- |
-| `content`            | `Uint8Array \| ArrayBuffer`          | n/a     | The `.pptx` bytes to render. **Required.**                                                                                |
-| `theme`              | `ViewerTheme`                        | n/a     | Color/radius overrides applied as CSS custom properties. Always wins over the File > Options theme picker.                |
-| `class`              | `string`                             | n/a     | Class applied to the root element.                                                                                        |
-| `canEdit`            | `boolean`                            | `false` | Enables the editor toolbar, inspector, and drag-and-drop editing.                                                         |
-| `filePath`           | `string`                             | n/a     | Original file path, used for autosave recovery and version history.                                                       |
-| `fileName`           | `string`                             | n/a     | Display name of the open document, shown in the title bar.                                                                |
-| `fonts`              | `ViewerFontSource[]`                 | n/a     | Licensed font sources supplied by the host application.                                                                   |
-| `autosave`           | `boolean`                            | `false` | Enables debounced autosave (emits `@autosave` with serialised bytes).                                                     |
-| `autosaveIntervalMs` | `number`                             | `2000`  | Autosave debounce window in milliseconds.                                                                                 |
-| `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.                                                                                  |
-| `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[]`                  | n/a     | Individual toolbar buttons and/or ribbon tabs to hide (e.g. `['share', 'broadcast', 'insert']`). Omit to show everything. |
-| `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 host `vue-i18n` 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`).                                         |
+| Prop                                                                       | Type                                 | Default                | Description                                                                                                                               |
+| -------------------------------------------------------------------------- | ------------------------------------ | ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
+| `content`                                                                  | `Uint8Array \| ArrayBuffer`          | n/a                    | The `.pptx` bytes to render. **Required.**                                                                                                |
+| `theme`                                                                    | `ViewerTheme`                        | n/a                    | Color/radius overrides applied as CSS custom properties. Always wins over the File > Options theme picker.                                |
+| `class`                                                                    | `string`                             | n/a                    | Class applied to the root element.                                                                                                        |
+| `canEdit`                                                                  | `boolean`                            | `false`                | Enables the editor toolbar, inspector, and drag-and-drop editing.                                                                         |
+| `filePath`                                                                 | `string`                             | n/a                    | Original file path, used for autosave recovery and version history.                                                                       |
+| `fileName`                                                                 | `string`                             | n/a                    | Display name of the open document, shown in the title bar.                                                                                |
+| `fonts`                                                                    | `ViewerFontSource[]`                 | n/a                    | Licensed font sources supplied by the host application.                                                                                   |
+| `autosave`                                                                 | `boolean`                            | `true`                 | Enables debounced autosave (emits `@autosave` with serialised bytes).                                                                     |
+| `autosaveIntervalMs`                                                       | `number`                             | File > Options cadence | Autosave debounce window in milliseconds.                                                                                                 |
+| `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.                                                                                                  |
+| `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).                                     |
+| `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.                                                    |
+| `hiddenActions`                                                            | `ToolbarActionId[]`                  | n/a                    | Individual toolbar buttons and/or ribbon tabs to hide (e.g. `['share', 'broadcast', 'insert']`). Omit to show everything.                 |
+| `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 host `vue-i18n` 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`).                                                         |
 
 ### Events
 

package/dist/{AiChatPanel-DHzr7ZJl.cjs → AiChatPanel-B7L2Dp2W.cjs}

@@ -1,4 +1,4 @@
-const e = require("./useViewerSettingsDialog-B9JF7jtB.cjs"), t = require("./viewer-CibpDvHC.cjs");
+const e = require("./useViewerSettingsDialog-At0VtvFj.cjs"), t = require("./viewer-BAa4Nn4b.cjs");
 let r = require("vue"), a = require("lucide-vue-next"), n = require("ai");
 var o = /* @__PURE__ */ new Set([
 	"input-available",

package/dist/{AiChatPanel-BfD6F0f2.js → AiChatPanel-BskP7nIk.js}

@@ -1,5 +1,5 @@
-import { xn as e } from "./useViewerSettingsDialog-Da50h8r8.js";
-import { S as t, T as a, _ as s, b as r, d as l, f as o, g as n, h as i, m as p, o as d, p as c, u, v as m, x, y as g } from "./viewer-DyQ3HU5L.js";
+import { xn as e } from "./useViewerSettingsDialog-CLSowN49.js";
+import { S as t, T as a, _ as s, b as r, d as l, f as o, g as n, h as i, m as p, o as d, p as c, u, v as m, x, y as g } from "./viewer-BUzQMo78.js";
 import { Fragment as f, Suspense as b, computed as v, createBlock as h, createCommentVNode as y, createElementBlock as k, createElementVNode as w, createTextVNode as C, createVNode as P, defineComponent as S, nextTick as T, normalizeClass as I, normalizeStyle as j, onBeforeUnmount as _, onMounted as A, openBlock as E, ref as M, renderList as F, resolveDynamicComponent as B, shallowRef as D, toDisplayString as N, unref as L, vModelText as R, watch as H, withAsyncContext as W, withCtx as z, withDirectives as V } from "vue";
 import { Bot as K, ChartColumn as O, Check as U, Crosshair as $, Eye as q, Film as G, GitMerge as J, History as Q, LayoutTemplate as X, LoaderCircle as Y, MessageSquare as Z, MessageSquarePlus as ee, Move as te, Navigation as ae, Palette as se, Pin as re, PinOff as le, Plus as oe, Search as ne, Send as ie, Shapes as pe, Sparkles as de, Square as ce, StickyNote as ue, Table as me, Trash2 as xe, TriangleAlert as ge, Type as fe, User as be, Wrench as ve, X as he } from "lucide-vue-next";
 import { getToolOrDynamicToolName as ye, isDynamicToolUIPart as ke, isToolUIPart as we } from "ai";