pptx-react-viewer 4.54.0 → 4.56.0

package/CHANGELOG.md

@@ -7,6 +7,126 @@ 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
+
+- **pptx:** Save chart labels and series colours through core ([4b25d98](https://github.com/ChristopherVR/ooxml/commit/4b25d98dc70d336d400e185d2af60b190889c4fe))
+- **chart:** Share rich title and axis save semantics ([d55e49d](https://github.com/ChristopherVR/ooxml/commit/d55e49da53b2beef0e8215d76376b42bb74e16cd))
+- **drawingml:** Share outlines effects and theme style matrices ([1bcb6c2](https://github.com/ChristopherVR/ooxml/commit/1bcb6c228370994984ecc277f2d456705fae1134))
+- **drawingml:** Preserve and author pattern and picture fills ([b30778e](https://github.com/ChristopherVR/ooxml/commit/b30778e085f626605c3c42edd1e966733dc77d78))
+- **diagram:** Share interpreted SmartArt previews across products ([f9dd019](https://github.com/ChristopherVR/ooxml/commit/f9dd0197da1871da3178a2d3ee880fe27266f0c0))
+- **chart:** Add safe hierarchical ChartEx editing primitives ([1759131](https://github.com/ChristopherVR/ooxml/commit/17591312e4b41bdf6a10873f54d43bea979cfcc6))
+- **chart:** Bind ChartEx edits to Word and Excel storage ([8443244](https://github.com/ChristopherVR/ooxml/commit/8443244f5520e967b5ddda797b27ddf5929b7eb7))
+- **chart:** Preserve hidden labels and edit cell label ranges ([b17afec](https://github.com/ChristopherVR/ooxml/commit/b17afecadcfc83aa94431d3cf89e8e7621c67ec2))
+- **chart:** Add shared advanced formatting intents ([c4d6fa1](https://github.com/ChristopherVR/ooxml/commit/c4d6fa115445ef6bc99b341c92a46941a326859a))
+- **chart:** Allocate fresh embedded workbook data sheets ([909bc58](https://github.com/ChristopherVR/ooxml/commit/909bc582f793e08b63671d82abe70440a49afdfd))
+- **diagram:** Share SmartArt style and color authoring ([86b43a4](https://github.com/ChristopherVR/ooxml/commit/86b43a497b5effa071b25e73dab91ab4bb18c296))
+- **chart:** Save structural edits with fresh workbook ranges ([99d0a3e](https://github.com/ChristopherVR/ooxml/commit/99d0a3e11ff95d002feb3a6060faa2eac3f6057b))
+- **chart:** Share resolved appearance conversions across hosts ([f26c9ff](https://github.com/ChristopherVR/ooxml/commit/f26c9ffa072db97ae8632c5e97de960821d3cf8f))
+- **chart:** Support structural ChartEx data edits across hosts ([8fd8d15](https://github.com/ChristopherVR/ooxml/commit/8fd8d15729d3c8347c8090451f2fefd420e03c4a))
+- **chart:** Share standalone rich text formatting edits ([829764b](https://github.com/ChristopherVR/ooxml/commit/829764b41480dd4f91f7609cfc1d1071e6117de6))
+- **chart:** Share appearance and chart family save operations ([e1b4f4a](https://github.com/ChristopherVR/ooxml/commit/e1b4f4ae337a2b0b99b9a127219dbbd4e7392109))
+- **ui:** Edit ChartEx charts in Word and Excel ([35ca2bd](https://github.com/ChristopherVR/ooxml/commit/35ca2bd824525a67220c533b6487b604118526b2))
+- **diagram:** Attach generated caches in Word and Excel ([0ba0947](https://github.com/ChristopherVR/ooxml/commit/0ba09477b7c5a6b251dd607d0775feec4655abf0))
+- **chart:** Share chart text layout and point label saves ([a638df2](https://github.com/ChristopherVR/ooxml/commit/a638df2ea8d702b1595b96bddf668a94dc9946dc))
+- **chart:** Split secondary series without changing targets ([cd1d2d5](https://github.com/ChristopherVR/ooxml/commit/cd1d2d5e3fb74bdb1ae7b05f1b2a0836e7ae34c2))
+- **chart:** Share chart chrome and protection edits ([9d59053](https://github.com/ChristopherVR/ooxml/commit/9d590537db83f652b66a8e7c9431ca6b0f640c86))
+- **chart:** Create extended charts through shared operations ([5a8ece7](https://github.com/ChristopherVR/ooxml/commit/5a8ece72b122382e57f8648c8c58a17dec8e5a09))
+- **pptx:** Save extended chart families through the core ([f5c1091](https://github.com/ChristopherVR/ooxml/commit/f5c10914458e9cd31e92d6efdfd156f77de40dd0))
+- **pptx:** Plan shared analysis and point chart saves ([3ab4c64](https://github.com/ChristopherVR/ooxml/commit/3ab4c6462e18ef7a24f35322f7b424337a668384))
+- **chart:** Preserve series targets across combo type edits ([d991ecb](https://github.com/ChristopherVR/ooxml/commit/d991ecb51d855cec58efd752f7c959a8d5346f32))
+- **chart:** Share axis labels and plot decorations ([0838fa8](https://github.com/ChristopherVR/ooxml/commit/0838fa8e6832d6442cec0f9a71e0a83051a5581d))
+- **chart:** Edit rich title runs and typed data vectors ([a3b688e](https://github.com/ChristopherVR/ooxml/commit/a3b688e38ccecdf64d99856df1bed8a33e2866e6))
+- **chart:** Share extended chart style and axis editing ([906594d](https://github.com/ChristopherVR/ooxml/commit/906594d527d0c472cd5435f60049fe0f3e1e4a2b))
+
+### Bug Fixes
+
+- **chart:** Preserve source content across chart consumers ([1ce74e9](https://github.com/ChristopherVR/ooxml/commit/1ce74e92f8864a046f3ef756b35bf8568c685c5b))
+- **diagram:** Report partial interpreted preview capabilities ([ea9e474](https://github.com/ChristopherVR/ooxml/commit/ea9e4746aa826a00a8bc49ac58852687e62eaf12))
+- **chart:** Preserve resolved gradient focus geometry ([0db31bf](https://github.com/ChristopherVR/ooxml/commit/0db31bf6be311d50eceb9aae66b809c15a9ca48c))
+- **chart:** Retain histogram semantics when switching layouts ([95e9a75](https://github.com/ChristopherVR/ooxml/commit/95e9a75440adaf743bc3c76d399f2b39e40b662e))
+- **pptx:** Preserve chart label defaults and retry workbook writes ([78e8efb](https://github.com/ChristopherVR/ooxml/commit/78e8efbe56ff2000e4d189657d7cc972057fd50f))
+- **pptx:** Save ChartEx label content flags through the core ([88309ed](https://github.com/ChristopherVR/ooxml/commit/88309edce7d247d068fd9934cbf79990b40ea081))
+- **chart:** Preserve source attributes and reuse workbook writes ([4a5f40b](https://github.com/ChristopherVR/ooxml/commit/4a5f40b51644afcb8fdc8690e14a89c41fc5b5bd))
+- **pptx:** Refresh chart adapters after saving shared models ([fdebf79](https://github.com/ChristopherVR/ooxml/commit/fdebf796a8168693c678a9889d2b9b1135079f1e))
+- **chart:** Activate newly allocated workbook data sheets ([7767080](https://github.com/ChristopherVR/ooxml/commit/77670803f1e87ffdab709138f57f4850e2946e50))
+- **pptx:** Declare chart refresh across runtime mixins ([5f880e6](https://github.com/ChristopherVR/ooxml/commit/5f880e639b16111c9b591a6cb909a07d6d3f5607))
+- **chart:** Accept host-allocated picture preview sources ([08fe91b](https://github.com/ChristopherVR/ooxml/commit/08fe91b613a007141ec2291a458a6d02cb6f61ab))
+- **chart:** Preserve authored paint and typed category edits ([547e5c0](https://github.com/ChristopherVR/ooxml/commit/547e5c069fdbeb351e5a8fcddbcb67f790a2b677))
+- **chart:** Preserve rich axis title style projection ([b5d5b7a](https://github.com/ChristopherVR/ooxml/commit/b5d5b7a728785576550957ecd07c202ad36ede0e))
+- **pptx:** Default SmartArt reflow to its local origin ([ae8a59b](https://github.com/ChristopherVR/ooxml/commit/ae8a59b43dbf4dcfdec3d199cc0735b09f1d65ec))
+- **pptx:** Morph offstage text size changes and keep run alpha ([75749c0](https://github.com/ChristopherVR/ooxml/commit/75749c0618fe24714d9f086ca7248f9f3e41e729))
+- **pptx:** End inline edit on Escape and scope collab undo origin ([1338d38](https://github.com/ChristopherVR/ooxml/commit/1338d388f137f8542ce07dbd61f5b6186a842d41))
+- **pptx:** Converge when two clients seed an empty room ([#217](https://github.com/ChristopherVR/ooxml/issues/217)) ([ee06f53](https://github.com/ChristopherVR/ooxml/commit/ee06f5389a9f277704640e4efaa567b3d5718507))
+
+### Refactor
+
+- **pptx:** Read ChartEx facts through the neutral model ([f78b582](https://github.com/ChristopherVR/ooxml/commit/f78b58266a5819121f92b9f954fdd5162b4c0eff))
+- **pptx:** Project classic chart paint from neutral models ([76dbdc6](https://github.com/ChristopherVR/ooxml/commit/76dbdc6dc0ba1c3afc8fe98ba92f482abfdcccd2))
+
+### Testing
+
+- **pptx:** Compare authored ChartEx visibility and scaling ([5748e23](https://github.com/ChristopherVR/ooxml/commit/5748e234bbe1919b522479f440440457267c4abf))
+
+### Styling
+
+- **chart:** Apply workspace formatting to chart tests ([b3f3a08](https://github.com/ChristopherVR/ooxml/commit/b3f3a0887eaff025d3fd7bf88cd288977df4121f))
+
 ## [4.54.0](https://github.com/ChristopherVR/ooxml/releases/tag/pptx-react-viewer@4.54.0) - 2026-10-26
 
 ### 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/{AiChatPanel-7GJQ66GR.js → AiChatPanel-7DESUEAZ.js}

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunk3TN5SUQR_js = require('./chunk-3TN5SUQR.js');
+var chunk5KFSMXI4_js = require('./chunk-5KFSMXI4.js');
 require('./chunk-PIRHQTI4.js');
 var react = require('react');
 var lu = require('react-icons/lu');
@@ -301,7 +301,7 @@ function AiComposer({
   prefillText,
   prefillNonce
 }) {
-  const { t } = chunk3TN5SUQR_js.useTranslation();
+  const { t } = chunk5KFSMXI4_js.useTranslation();
   const [value, setValue] = react.useState("");
   const textareaRef = react.useRef(null);
   const appliedNonce = react.useRef(void 0);
@@ -364,7 +364,7 @@ function AiComposer({
         disabled: value.trim().length === 0,
         title: t("pptx.ai.send"),
         "aria-label": t("pptx.ai.send"),
-        className: chunk3TN5SUQR_js.cn(
+        className: chunk5KFSMXI4_js.cn(
           "shrink-0 rounded-sm p-1.5 transition-colors",
           value.trim().length === 0 ? "text-muted-foreground/50" : "bg-primary text-primary-foreground hover:bg-primary/90"
         ),
@@ -386,7 +386,7 @@ function AiFocusBar({
   onStopPick,
   onClearPicks
 }) {
-  const { t } = chunk3TN5SUQR_js.useTranslation();
+  const { t } = chunk5KFSMXI4_js.useTranslation();
   const chips = ai.focusTargetChips(targets, slides);
   const twoTables = ai.isTwoTableFocus(targets, slides);
   return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "border-b border-border bg-secondary/30", children: [
@@ -395,7 +395,7 @@ function AiFocusBar({
       chips.map((chip) => /* @__PURE__ */ jsxRuntime.jsx(
         "span",
         {
-          className: chunk3TN5SUQR_js.cn(
+          className: chunk5KFSMXI4_js.cn(
             "inline-flex max-w-[10rem] items-center rounded-full px-2 py-0.5 text-[11px]",
             hasPicks || isPinned ? "bg-primary/15 text-primary" : "bg-muted text-muted-foreground"
           ),
@@ -432,7 +432,7 @@ function AiFocusBar({
             title: t("pptx.ai.pickElement"),
             "aria-label": t("pptx.ai.pickAria"),
             "aria-pressed": pickMode,
-            className: chunk3TN5SUQR_js.cn(
+            className: chunk5KFSMXI4_js.cn(
               "rounded-sm p-1 max-md:min-w-[44px]! max-md:min-h-[44px]! flex items-center justify-center",
               pickMode ? "bg-primary text-primary-foreground" : "text-muted-foreground hover:bg-accent"
             ),
@@ -501,7 +501,7 @@ function relativeTime(from, now = Date.now()) {
   return `${weeks}w ago`;
 }
 function AiHistoryList({ chats, activeChatId, onResume, onDelete }) {
-  const { t } = chunk3TN5SUQR_js.useTranslation();
+  const { t } = chunk5KFSMXI4_js.useTranslation();
   if (chats.length === 0) {
     return /* @__PURE__ */ jsxRuntime.jsx("p", { className: "px-3 py-4 text-center text-[12px] text-muted-foreground", children: t("pptx.ai.historyEmpty") });
   }
@@ -511,7 +511,7 @@ function AiHistoryList({ chats, activeChatId, onResume, onDelete }) {
       {
         type: "button",
         onClick: () => onResume(chat.id),
-        className: chunk3TN5SUQR_js.cn(
+        className: chunk5KFSMXI4_js.cn(
           "flex min-w-0 flex-1 items-start gap-2 rounded-sm px-2 py-1.5 text-left hover:bg-accent",
           chat.id === activeChatId && "bg-accent/60"
         ),
@@ -550,7 +550,7 @@ function AiHistoryMenu({
   onNewChat,
   onClose
 }) {
-  const { t } = chunk3TN5SUQR_js.useTranslation();
+  const { t } = chunk5KFSMXI4_js.useTranslation();
   const ref = react.useRef(null);
   react.useEffect(() => {
     const handler = (e) => {
@@ -616,7 +616,7 @@ function appliedThemeFromPart(part) {
   return { summary: out.summary ?? "Theme updated", previous: out.previous ?? {} };
 }
 function AiAppliedThemeCard({ summary, onUndo }) {
-  const { t } = chunk3TN5SUQR_js.useTranslation();
+  const { t } = chunk5KFSMXI4_js.useTranslation();
   const [undone, setUndone] = react.useState(false);
   return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex items-center gap-1.5 rounded-md border border-primary/30 bg-primary/5 px-2.5 py-1.5 text-[12px]", children: [
     /* @__PURE__ */ jsxRuntime.jsx(lu.LuPalette, { className: "w-3.5 h-3.5 shrink-0 text-primary" }),
@@ -662,7 +662,7 @@ var ICONS = {
   tool: lu.LuWrench
 };
 function AiToolCallCard({ part }) {
-  const { t } = chunk3TN5SUQR_js.useTranslation();
+  const { t } = chunk5KFSMXI4_js.useTranslation();
   const failed = part.state === "output-error";
   const done = part.state === "output-available";
   const running = !failed && !done;
@@ -675,17 +675,17 @@ function AiToolCallCard({ part }) {
       /* @__PURE__ */ jsxRuntime.jsx(
         Icon,
         {
-          className: chunk3TN5SUQR_js.cn(
+          className: chunk5KFSMXI4_js.cn(
             "w-3.5 h-3.5 shrink-0",
             failed ? "text-destructive" : "text-muted-foreground"
           )
         }
       ),
-      /* @__PURE__ */ jsxRuntime.jsx("span", { className: chunk3TN5SUQR_js.cn("truncate", failed ? "text-destructive" : "text-foreground"), children: activity.label }),
+      /* @__PURE__ */ jsxRuntime.jsx("span", { className: chunk5KFSMXI4_js.cn("truncate", failed ? "text-destructive" : "text-foreground"), children: activity.label }),
       /* @__PURE__ */ jsxRuntime.jsxs(
         "span",
         {
-          className: chunk3TN5SUQR_js.cn(
+          className: chunk5KFSMXI4_js.cn(
             "ml-auto inline-flex items-center gap-1 rounded-sm px-1.5 py-0.5 text-[10px]",
             failed ? "bg-destructive/15 text-destructive" : done ? "bg-primary/10 text-primary" : "bg-muted text-muted-foreground"
           ),
@@ -710,7 +710,7 @@ function AiToolCallCard({ part }) {
   ] });
 }
 function AiMessageList({ messages, isStreaming, bridge }) {
-  const { t } = chunk3TN5SUQR_js.useTranslation();
+  const { t } = chunk5KFSMXI4_js.useTranslation();
   const endRef = react.useRef(null);
   react.useEffect(() => {
     endRef.current?.scrollIntoView({ block: "end" });
@@ -733,7 +733,7 @@ function AiMessageList({ messages, isStreaming, bridge }) {
         /* @__PURE__ */ jsxRuntime.jsx(
           "div",
           {
-            className: chunk3TN5SUQR_js.cn(
+            className: chunk5KFSMXI4_js.cn(
               "mt-0.5 flex h-6 w-6 shrink-0 items-center justify-center rounded-full",
               isUser ? "bg-secondary text-muted-foreground" : "bg-primary/15 text-primary"
             ),
@@ -779,7 +779,7 @@ function AiMessageList({ messages, isStreaming, bridge }) {
   ] });
 }
 function AiProposalCard({ proposal, onAccept, onReject }) {
-  const { t } = chunk3TN5SUQR_js.useTranslation();
+  const { t } = chunk5KFSMXI4_js.useTranslation();
   const lines = proposal.summary.map(ai.humanizeDiffLine);
   return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "rounded-md border border-primary/40 bg-primary/5 p-2.5", children: [
     /* @__PURE__ */ jsxRuntime.jsx("div", { className: "mb-1.5 text-[11px] font-semibold uppercase tracking-wide text-primary", children: t("pptx.ai.proposedChange") }),
@@ -821,7 +821,7 @@ function AiConversation({
   aiPanel,
   deckId
 }) {
-  const { t } = chunk3TN5SUQR_js.useTranslation();
+  const { t } = chunk5KFSMXI4_js.useTranslation();
   const chat = useAiConversation(useChat, session, config, bridge, {
     // Live "AI as a collaborator" focus: as each tool runs, navigate to and
     // highlight the slide / element(s) it touches so the canvas mirrors the
@@ -986,7 +986,7 @@ function AiChatPanel({
   onClose,
   panelWidth
 }) {
-  const { t } = chunk3TN5SUQR_js.useTranslation();
+  const { t } = chunk5KFSMXI4_js.useTranslation();
   const { state, session, initError } = useAiChat(bridge, config);
   const deckId = react.useMemo(() => ai.deckIdFromBridge(bridge), [bridge]);
   return /* @__PURE__ */ jsxRuntime.jsxs(

package/dist/{AiChatPanel-AI75AT6C.mjs → AiChatPanel-GQ64SIYP.mjs}

@@ -1,4 +1,4 @@
-import { useTranslation, cn } from './chunk-ID37Y3HG.mjs';
+import { useTranslation, cn } from './chunk-MR3ZSEHS.mjs';
 import './chunk-UV2HVMKZ.mjs';
 import { useMemo, useRef, useState, useEffect, useReducer, useCallback } from 'react';
 import { LuSparkles, LuX, LuLoaderCircle, LuTriangleAlert, LuHistory, LuMessageSquarePlus, LuTrash2, LuPlus, LuGitMerge, LuCrosshair, LuPinOff, LuPin, LuUser, LuBot, LuCheck, LuSquare, LuSend, LuMessageSquare, LuPalette, LuUndo2, LuWrench, LuStickyNote, LuFilm, LuNavigation, LuSearch, LuMove, LuChartColumn, LuLayoutTemplate, LuTable, LuShapes, LuType, LuEye } from 'react-icons/lu';

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-3TN5SUQR.js → chunk-5KFSMXI4.js}

@@ -1398,9 +1398,12 @@ function renderParagraphRun(run, segment, ctx, keySuffix = "") {
   const segmentStyle = segment?.style ?? {};
   const textValue = run.text;
   const lines = textValue.split("\n");
-  const resolvedSegmentColor = pptx.normalizeHexColor(
-    segmentStyle.color || element.textStyle?.color,
-    run.hyperlink ? HYPERLINK_COLOR : fallbackColor
+  const resolvedSegmentColor = pptx.textRunColor(
+    pptx.normalizeHexColor(
+      segmentStyle.color || element.textStyle?.color,
+      run.hyperlink ? HYPERLINK_COLOR : fallbackColor
+    ),
+    segmentStyle.color ? segmentStyle.colorRef?.alpha : element.textStyle?.colorRef?.alpha
   );
   const rawBaseline = typeof segmentStyle.baseline === "number" ? segmentStyle.baseline : 0;
   const baselineFraction = rawBaseline === 0 ? 0 : Math.abs(rawBaseline) >= 1e3 ? rawBaseline / 1e5 : rawBaseline / 100;