pptx-viewer-mcp 1.1.23 → 1.1.26

package/CHANGELOG.md

@@ -0,0 +1,51 @@
+# Changelog
+
+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.1.26](https://github.com/ChristopherVR/pptx-viewer/releases/tag/pptx-viewer-mcp@1.1.26) - 2026-06-21
+
+### Features
+
+- Extracted more shared logic into the shared package (by @ChristopherVR) ([977c608](https://github.com/ChristopherVR/pptx-viewer/commit/977c608ecdb142908b38aaa37104d983275b705b))
+
+### Documentation
+
+- Sharpen npm descriptions and keywords for discoverability (by @ChristopherVR) ([8fea56d](https://github.com/ChristopherVR/pptx-viewer/commit/8fea56d7650f7dc2f3167dea97b94b612a03a4e7))
+
+## [1.1.24](https://github.com/ChristopherVR/pptx-viewer/releases/tag/pptx-viewer-mcp@1.1.24) - 2026-06-20
+
+### Features
+
+- **tools:** Scaffold @pptx-viewer/tools package (by @ChristopherVR) ([f34b949](https://github.com/ChristopherVR/pptx-viewer/commit/f34b949e0f6d6460710aa223146399dfbc38a436))
+
+### Bug Fixes
+
+- **tools:** Ship pptx-viewer-core as a dependency so npx installs it (by @ChristopherVR) ([da33db1](https://github.com/ChristopherVR/pptx-viewer/commit/da33db11281f3573dc49defaba7e7404e59bc43f))
+- **deps:** Unblock install after the 1.1.23 version alignment (by @ChristopherVR) ([542a92d](https://github.com/ChristopherVR/pptx-viewer/commit/542a92dcafe2041e8b1c3cb4b371ef0353a470c9))
+
+### Documentation
+
+- Streamline npm READMEs and add badges, screenshots, demo links (by @ChristopherVR) ([92e980d](https://github.com/ChristopherVR/pptx-viewer/commit/92e980d434900abd223c4d70c6cae19a623f9ca8))
+- **tools:** Make MCP first-class in README and drop em-dashes (by @ChristopherVR) ([89ebd64](https://github.com/ChristopherVR/pptx-viewer/commit/89ebd6453719cf46a4e655dfe689c9d5fae19549))
+
+### Build & CI
+
+- Add @pptx-viewer/tools to test, release, and publish pipeline (by @ChristopherVR) ([0e2ff95](https://github.com/ChristopherVR/pptx-viewer/commit/0e2ff9579a8ea039d4367d69f13998560ee9313d))
+- Independent per-package versioning, tags, and changelogs (by @ChristopherVR) ([79595d9](https://github.com/ChristopherVR/pptx-viewer/commit/79595d972d7c4102e8b1e1e3926f439486f76ba1))
+
+### Dependencies
+
+- **deps:** Update all dependencies to latest (by @ChristopherVR) ([e3287c0](https://github.com/ChristopherVR/pptx-viewer/commit/e3287c03ff58b1a1ae103ed32a513468a454a084))
+- **deps:** Bump all workspace manifest floors to latest (by @ChristopherVR) ([890c33d](https://github.com/ChristopherVR/pptx-viewer/commit/890c33d667a39480a69e6a3da893964382993b29))
+
+### Chores
+
+- **tools:** Bump @pptx-viewer/tools to v1.1.0 (by @ChristopherVR) ([c15aba6](https://github.com/ChristopherVR/pptx-viewer/commit/c15aba600c5f2a1137acb157b7dab896e659f37c))
+- Rename package to pptx-viewer-mcp and publish to npm (by @ChristopherVR) ([9cb8a25](https://github.com/ChristopherVR/pptx-viewer/commit/9cb8a2567082b9bfdc91efee0b91cf2cbe2aa1c4))
+- Bump all packages to 1.x.1 patch versions (by @ChristopherVR) ([c75205a](https://github.com/ChristopherVR/pptx-viewer/commit/c75205a96cc7797d1647ac4705395b7707ac8910))
+- Bump all packages to minor versions for SDK table support (by @ChristopherVR) ([2d4b635](https://github.com/ChristopherVR/pptx-viewer/commit/2d4b6351b0bf328f8a556cf593733fd8ad36c7b5))
+- Bump dependencies to latest and minor-bump packages for parity work (by @ChristopherVR) ([da19fdf](https://github.com/ChristopherVR/pptx-viewer/commit/da19fdf9a4670d274d9973b67aa22d34217b8555))
+- Roll TypeScript back to 5.9.x; quiet new oxlint vitest rules (by @ChristopherVR) ([713c020](https://github.com/ChristopherVR/pptx-viewer/commit/713c020ac2428db0fb1eb6cb30e56b2cff19a80f))
+- Relicense from MIT to Apache-2.0 (by @ChristopherVR) ([e12f926](https://github.com/ChristopherVR/pptx-viewer/commit/e12f9266f02bebbfc218986b617c418fee43a56b))

package/README.md

@@ -1,146 +1,151 @@
 # pptx-viewer-mcp
 
-Pure tool functions, Zod schemas, a Y.Doc collaboration codec, and an MCP server for PPTX manipulation — all built on top of `pptx-viewer-core`.
+[![npm](https://img.shields.io/npm/v/pptx-viewer-mcp.svg)](https://www.npmjs.com/package/pptx-viewer-mcp)
+[![license](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)
 
-## Installation
+Edit PowerPoint files from an AI agent. It ships a ready-to-run [MCP](https://modelcontextprotocol.io) server that gives an agent 25 PowerPoint editing tools (for example "add a slide" or "replace text"). The same tools are also available as plain functions you can call yourself, along with their Zod input schemas and a codec for real-time collaboration (Y.Doc). The [`pptx-viewer-core`](https://www.npmjs.com/package/pptx-viewer-core) engine is bundled in, so a single install gives you everything and you never install the core separately.
 
-```sh
-npm install pptx-viewer-mcp pptx-viewer-core
-# optional — required only for the collaboration codec
-npm install yjs
-```
-
-## Exports
+- **Live demo:** https://christophervr.github.io/pptx-viewer/demo/
+- **Docs:** https://christophervr.github.io/pptx-viewer/
 
-| Entry point               | Contents                                                |
-| ------------------------- | ------------------------------------------------------- |
-| `pptx-viewer-mcp`         | 24 tool functions + provider types + execution pipeline |
-| `pptx-viewer-mcp/schemas` | Zod schemas for every tool input                        |
-| `pptx-viewer-mcp/codec`   | `PptxCodec` — Y.Doc ↔ PPTX bytes codec                  |
-| `pptx-viewer-mcp/mcp`     | `createServer()` — programmatic MCP server factory      |
+## Quick start
 
-## Tool reference
+This package is, first and foremost, an MCP server. The recommended way to use it is to point an MCP client at the published binary. Calling the tools as a library is a secondary, lower-level option (see [Use as a library](#use-as-a-library)).
 
-**Slide (8):** `getSlide`, `addSlide`, `deleteSlides`, `reorderSlides`, `duplicateSlide`, `updateSlideProperties`, `setSlideTransition`, `setCanvasSize`
+### 1. Run as an MCP server (recommended)
 
-**Element (9):** `addElement`, `updateElement`, `deleteElements`, `arrangeElements`, `cloneElement`, `setElementAnimation`, `groupElements`, `ungroupElements`, `batchUpdateElements`
+No clone, no build, no separate core install. Point your MCP client at the published binary via `npx`:
 
-**Table (2):** `updateTableCells`, `manageTableStructure`
+```json
+{
+	"mcpServers": {
+		"pptx": {
+			"command": "npx",
+			"args": ["pptx-viewer-mcp"]
+		}
+	}
+}
+```
 
-**Style (2):** `updateElementStyle`, `runAccessibilityCheck`
+That is the entire setup. `npx` downloads `pptx-viewer-mcp` and its bundled `pptx-viewer-core` engine on first run, so there is nothing else to install. Add the config above, restart your client, and the tools are available.
 
-**Content (3):** `findText`, `replaceText`, `manageComments`
+This works in Claude Desktop, Claude Code, Cursor, and any MCP-compatible client. All 25 tools are exposed over stdio in snake_case (for example `add_slide`, `batch_update_elements`). Every tool takes a `filePath` argument and the server handles load and save internally. File access is scoped to a root directory (`PPTX_TOOLS_ROOT`, defaulting to the process working directory) and restricted to `.pptx` and `.ppt` files.
 
-**Conversion (1):** `convertToMarkdown`
+> If you prefer a global install (`npm i -g pptx-viewer-mcp`), the same server is available as the `pptx-tools` binary. Point `command` at `pptx-tools` with no args.
 
----
+### 2. Use as a library (advanced)
 
-## Quick start
+If you are embedding PPTX editing in your own app instead of running the MCP server, install the package once:
 
-### 1. Using tool functions directly
+```sh
+npm install pptx-viewer-mcp
+# optional, only for the Y.Doc collaboration codec:
+npm install yjs
+```
 
-Every tool is a pure function — no file I/O, no framework dependencies.
+The `pptx-viewer-core` engine is a regular dependency, so it installs automatically. You import everything you need (tools and the engine) from `pptx-viewer-mcp`, with no separate `pptx-viewer-core` install or import:
 
 ```ts
-import { PptxHandler } from 'pptx-viewer-core';
-import { addSlide, getSlide } from 'pptx-viewer-mcp';
+import { readFile, writeFile } from 'node:fs/promises';
+import { PptxHandler, addSlide, getSlide } from 'pptx-viewer-mcp';
 
-// Load
 const handler = new PptxHandler();
-const bytes = await fs.readFile('deck.pptx');
+const bytes = await readFile('deck.pptx');
 const pptxData = await handler.load(bytes.buffer);
 
-// Run a tool
 const ctx = { pptxData };
 const { pptxData: updated, dirty } = addSlide(ctx, { insertAfterIndex: 0 });
 
-// Save when dirty
 if (dirty) {
 	const out = await handler.save(updated.slides);
-	await fs.writeFile('deck.pptx', out);
+	await writeFile('deck.pptx', out);
 }
 
-// Inspect a slide
 const { result } = getSlide(ctx, { slideIndex: 0 });
 console.log(result.elements);
 ```
 
-### 2. Using the MCP server
+See [Use as a library](#use-as-a-library) below for the higher-level `executeToolWithContext` helper that handles the load and save cycle for you.
 
-Add to your MCP client configuration (Claude Desktop, Cursor, etc.):
+## Exports
 
-```json
-{
-	"mcpServers": {
-		"pptx": {
-			"command": "npx",
-			"args": ["pptx-viewer-mcp"]
-		}
-	}
-}
-```
+| Entry point               | Contents                                                                                |
+| ------------------------- | --------------------------------------------------------------------------------------- |
+| `pptx-viewer-mcp`         | 25 tool functions, the `PptxHandler` engine, provider types, and the execution pipeline |
+| `pptx-viewer-mcp/schemas` | Zod schemas for every tool input                                                        |
+| `pptx-viewer-mcp/codec`   | `PptxCodec`, the Y.Doc to PPTX bytes codec                                              |
+| `pptx-viewer-mcp/mcp`     | `createServer()`, the programmatic MCP server factory                                   |
+
+## Tools
+
+| Group          | Tools                                                                                                                                                        |
+| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| Slide (8)      | `getSlide` `addSlide` `deleteSlides` `reorderSlides` `duplicateSlide` `updateSlideProperties` `setSlideTransition` `setCanvasSize`                           |
+| Element (9)    | `addElement` `updateElement` `deleteElements` `arrangeElements` `cloneElement` `setElementAnimation` `groupElements` `ungroupElements` `batchUpdateElements` |
+| Table (2)      | `updateTableCells` `manageTableStructure`                                                                                                                    |
+| Style (2)      | `updateElementStyle` `runAccessibilityCheck`                                                                                                                 |
+| Content (3)    | `findText` `replaceText` `manageComments`                                                                                                                    |
+| Conversion (1) | `convertToMarkdown`                                                                                                                                          |
+
+## Use as a library
 
-The binary is also available as `pptx-tools` after a global install. All 24 tools are exposed over stdio with the same names in snake_case (e.g. `add_slide`, `batch_update_elements`). Every tool accepts a `filePath` parameter — the server handles load/save internally.
+These APIs back the MCP server. Reach for them when you embed PPTX editing directly rather than running the server.
 
-### 3. Using `executeToolWithContext` with providers
+### Call tools directly
 
-`executeToolWithContext` wraps the load → tool → save cycle and routes through a live Y.Doc collaboration room when one is available.
+Each tool is a plain function: it takes the presentation data in and returns the changed data out, without reading or writing files itself and without depending on any framework. The basic load, edit, save loop is shown in [Use as a library (advanced)](#2-use-as-a-library-advanced) above.
+
+### Wrap load, tool, and save with `executeToolWithContext`
+
+`executeToolWithContext` handles the load and save cycle and, when a collaboration room is supplied, routes changes through a live Y.Doc instead of the disk.
 
 ```ts
 import {
 	executeToolWithContext,
 	type ExecutionContext,
 	type FileSystemProvider,
-	type CollaborationProvider,
+	replaceText,
 } from 'pptx-viewer-mcp';
-import { replaceText } from 'pptx-viewer-mcp';
 import { readFile, writeFile } from 'node:fs/promises';
 
-// Minimal file-system-only provider
 const filesystem: FileSystemProvider = {
 	readFile: (p) => readFile(p),
 	writeFile: (p, data) => writeFile(p, data),
 };
 
-const execCtx: ExecutionContext = { filesystem };
-
-const result = await executeToolWithContext('deck.pptx', execCtx, (ctx) =>
+const result = await executeToolWithContext('deck.pptx', { filesystem }, (ctx) =>
 	replaceText(ctx, { find: 'Draft', replace: 'Final', caseSensitive: false }),
 );
 
 console.log(result.replacements, result.savedToDisk);
 ```
 
-When `execCtx.collaboration` is provided, `executeToolWithContext` automatically dehydrates the current Y.Doc state before running the tool and re-hydrates the room after saving, so remote peers receive the change without a file reload.
-
----
+When you supply `collaboration` on the `ExecutionContext`, the tool reads the current shared (Y.Doc) state before running and writes the result back into it after saving, so other people in the session see the change without reloading the file.
 
 ## Architecture
 
 ```
 ToolContext { pptxData }
-        │
-        ▼
-tool function  →  ToolResult { pptxData, result, dirty }
-                        │
-                        ▼  (when dirty)
+        |
+        v
+tool function  ->  ToolResult { pptxData, result, dirty }
+                        |
+                        v  (when dirty)
               savePresentation()
-                ├─ collaboration room → hydrate Y.Doc → broadcast
-                └─ no room → writeFile to disk
+                |- collaboration room -> hydrate Y.Doc -> broadcast
+                '- no room -> writeFile to disk
 ```
 
-`CollaborationProvider`, `FileSystemProvider`, and `ViewerProvider` are plain interfaces — implement them for any runtime (Node, Electron, browser, edge worker).
-
----
+`CollaborationProvider`, `FileSystemProvider`, and `ViewerProvider` are plain interfaces. Implement them for any runtime (Node, Electron, browser, or edge worker).
 
 ## Development
 
 ```sh
-bun run build      # tsup → dist/
+bun run build      # tsup -> dist/
 bun run typecheck  # tsc --noEmit
 bun run test       # vitest run
 ```
 
 ## License
 
-MIT
+Apache-2.0

package/dist/codec/index.d.mts

@@ -3,13 +3,20 @@ import { Doc } from 'yjs';
 declare const ORIGIN_FILE_LOAD = "file-load";
 /**
  * Bidirectional format codec: file bytes <-> Y.Doc shared types.
+ *
+ * Y.Doc schema:
+ *   pptx:meta    Y.Map  - width, height, widthEmu, heightEmu, sourceBytes
+ *   pptx:slides  Y.Array<Y.Map> - one map per slide
+ *     Each slide Y.Map: scalar fields + `_`-prefixed JSON blobs + `elements` Y.Array<Y.Map>
+ *     Each element Y.Map: scalar fields + `_`-prefixed JSON blobs + `textBody` Y.Text
+ *     textBody Y.Text: one delta op per TextSegment (see text-body-codec.ts)
  */
 interface FormatCodec {
     readonly formatId: string;
     readonly extensions: string[];
-    hydrate(ydoc: Doc, bytes: Uint8Array, origin?: string): Promise<void>;
-    dehydrate(ydoc: Doc, dirtyPaths?: string[]): Promise<Uint8Array>;
-    observe(ydoc: Doc, onChange: () => void): () => void;
+    hydrate: (ydoc: Doc, bytes: Uint8Array, origin?: string) => Promise<void>;
+    dehydrate: (ydoc: Doc, dirtyPaths?: string[]) => Promise<Uint8Array>;
+    observe: (ydoc: Doc, onChange: () => void) => () => void;
 }
 declare class PptxCodec implements FormatCodec {
     readonly formatId = "pptx";

package/dist/codec/index.d.ts

@@ -3,13 +3,20 @@ import { Doc } from 'yjs';
 declare const ORIGIN_FILE_LOAD = "file-load";
 /**
  * Bidirectional format codec: file bytes <-> Y.Doc shared types.
+ *
+ * Y.Doc schema:
+ *   pptx:meta    Y.Map  - width, height, widthEmu, heightEmu, sourceBytes
+ *   pptx:slides  Y.Array<Y.Map> - one map per slide
+ *     Each slide Y.Map: scalar fields + `_`-prefixed JSON blobs + `elements` Y.Array<Y.Map>
+ *     Each element Y.Map: scalar fields + `_`-prefixed JSON blobs + `textBody` Y.Text
+ *     textBody Y.Text: one delta op per TextSegment (see text-body-codec.ts)
  */
 interface FormatCodec {
     readonly formatId: string;
     readonly extensions: string[];
-    hydrate(ydoc: Doc, bytes: Uint8Array, origin?: string): Promise<void>;
-    dehydrate(ydoc: Doc, dirtyPaths?: string[]): Promise<Uint8Array>;
-    observe(ydoc: Doc, onChange: () => void): () => void;
+    hydrate: (ydoc: Doc, bytes: Uint8Array, origin?: string) => Promise<void>;
+    dehydrate: (ydoc: Doc, dirtyPaths?: string[]) => Promise<Uint8Array>;
+    observe: (ydoc: Doc, onChange: () => void) => () => void;
 }
 declare class PptxCodec implements FormatCodec {
     readonly formatId = "pptx";

package/dist/codec/index.js

@@ -3,6 +3,177 @@
 var pptxViewerCore = require('pptx-viewer-core');
 var yjs = require('yjs');
 
+// src/codec/pptx-codec.ts
+
+// src/codec/text-body-codec.ts
+var EMPTY_PLACEHOLDER = "\u200B";
+function buildAttrs(seg) {
+  const a = {};
+  const style = seg.style;
+  if (style && typeof style === "object" && Object.keys(style).length > 0) {
+    a.s = JSON.stringify(style);
+  }
+  if (seg.isParagraphBreak) {
+    a.pb = "1";
+  }
+  if (seg.isLineBreak) {
+    a.lb = "1";
+  }
+  if (seg.ep === true) {
+    a.ep = "1";
+  }
+  if (seg.bulletInfo) {
+    a.bi = JSON.stringify(seg.bulletInfo);
+  }
+  if (seg.paragraphLevel !== void 0) {
+    a.pl = String(seg.paragraphLevel);
+  }
+  if (seg.endParaRunProperties) {
+    a.pr = JSON.stringify(seg.endParaRunProperties);
+  }
+  if (typeof seg.fieldType === "string") {
+    a.ft = seg.fieldType;
+  }
+  if (typeof seg.fieldGuid === "string") {
+    a.fg = seg.fieldGuid;
+  }
+  if (seg.fieldGuidAttr === "uuid" || seg.fieldGuidAttr === "id") {
+    a.fga = seg.fieldGuidAttr;
+  }
+  if (seg.fieldParagraphPropertiesXml) {
+    a.fp = JSON.stringify(seg.fieldParagraphPropertiesXml);
+  }
+  if (seg.equationXml) {
+    a.eq = JSON.stringify(seg.equationXml);
+  }
+  if (typeof seg.equationNumber === "string") {
+    a.en = seg.equationNumber;
+  }
+  if (seg.breakRunProperties) {
+    a.br = JSON.stringify(seg.breakRunProperties);
+  }
+  if (typeof seg.rubyText === "string") {
+    a.rt = seg.rubyText;
+  }
+  if (typeof seg.rubyAlignment === "string") {
+    a.ra = seg.rubyAlignment;
+  }
+  if (seg.rubyFontSize !== void 0) {
+    a.rfs = String(seg.rubyFontSize);
+  }
+  if (seg.rubyStyle) {
+    a.rs = JSON.stringify(seg.rubyStyle);
+  }
+  return Object.keys(a).length > 0 ? a : void 0;
+}
+function encodeTextBodyToYText(segments, ytext) {
+  let offset = 0;
+  for (const raw of segments) {
+    const seg = raw;
+    const attrs = buildAttrs(seg);
+    if (seg.isParagraphBreak === true || seg.isLineBreak === true) {
+      ytext.insert(offset, "\n", attrs);
+      offset += 1;
+    } else if (typeof seg.text === "string" && seg.text.length > 0) {
+      ytext.insert(offset, seg.text, attrs);
+      offset += seg.text.length;
+    } else {
+      const epAttrs = { ep: "1", ...attrs ?? {} };
+      ytext.insert(offset, EMPTY_PLACEHOLDER, epAttrs);
+      offset += 1;
+    }
+  }
+}
+function decodeTextBodyFromYText(ytext) {
+  const delta = ytext.toDelta();
+  const segments = [];
+  for (const op of delta) {
+    if (typeof op.insert !== "string" || op.insert === "") {
+      continue;
+    }
+    const a = op.attributes ?? {};
+    const seg = { text: "", style: {} };
+    if (a.s) {
+      try {
+        seg.style = JSON.parse(a.s);
+      } catch {
+        seg.style = {};
+      }
+    }
+    if (a.pb === "1") {
+      seg.isParagraphBreak = true;
+    }
+    if (a.lb === "1") {
+      seg.isLineBreak = true;
+    }
+    if (a.bi) {
+      try {
+        seg.bulletInfo = JSON.parse(a.bi);
+      } catch {
+      }
+    }
+    if (a.pl !== void 0) {
+      seg.paragraphLevel = Number(a.pl);
+    }
+    if (a.pr) {
+      try {
+        seg.endParaRunProperties = JSON.parse(a.pr);
+      } catch {
+      }
+    }
+    if (a.ft) {
+      seg.fieldType = a.ft;
+    }
+    if (a.fg) {
+      seg.fieldGuid = a.fg;
+    }
+    if (a.fga === "uuid" || a.fga === "id") {
+      seg.fieldGuidAttr = a.fga;
+    }
+    if (a.fp) {
+      try {
+        seg.fieldParagraphPropertiesXml = JSON.parse(a.fp);
+      } catch {
+      }
+    }
+    if (a.eq) {
+      try {
+        seg.equationXml = JSON.parse(a.eq);
+      } catch {
+      }
+    }
+    if (a.en) {
+      seg.equationNumber = a.en;
+    }
+    if (a.br) {
+      try {
+        seg.breakRunProperties = JSON.parse(a.br);
+      } catch {
+      }
+    }
+    if (a.rt) {
+      seg.rubyText = a.rt;
+    }
+    if (a.ra) {
+      seg.rubyAlignment = a.ra;
+    }
+    if (a.rfs !== void 0) {
+      seg.rubyFontSize = Number(a.rfs);
+    }
+    if (a.rs) {
+      try {
+        seg.rubyStyle = JSON.parse(a.rs);
+      } catch {
+      }
+    }
+    if (op.insert !== "\n" && op.insert !== EMPTY_PLACEHOLDER) {
+      seg.text = op.insert;
+    }
+    segments.push(seg);
+  }
+  return segments;
+}
+
 // src/codec/pptx-codec.ts
 var ORIGIN_FILE_LOAD = "file-load";
 var SCALAR_ELEMENT_KEYS = /* @__PURE__ */ new Set([
@@ -34,7 +205,6 @@ var SCALAR_ELEMENT_KEYS = /* @__PURE__ */ new Set([
   "promptText"
 ]);
 var COMPLEX_FIELD_MAP = {
-  textSegments: "_textSegments",
   textStyle: "_textStyle",
   shapeStyle: "_shapeStyle",
   shapeAdjustments: "_shapeAdjustments",
@@ -122,8 +292,7 @@ var PptxCodec = class {
         slidesArray.delete(0, slidesArray.length);
       }
       for (const slide of pptxData.slides) {
-        const slideMap = this._slideToYMap(slide);
-        slidesArray.push([slideMap]);
+        slidesArray.push([this._slideToYMap(slide)]);
       }
     }, effectiveOrigin);
   }
@@ -132,8 +301,7 @@ var PptxCodec = class {
     const slidesArray = ydoc.getArray("pptx:slides");
     const slides = [];
     for (let i = 0; i < slidesArray.length; i++) {
-      const slideMap = slidesArray.get(i);
-      slides.push(this._yMapToSlide(slideMap));
+      slides.push(this._yMapToSlide(slidesArray.get(i)));
     }
     const sourceBytesArr = meta.get("sourceBytes");
     try {
@@ -154,27 +322,24 @@ var PptxCodec = class {
   observe(ydoc, onChange) {
     const slidesArray = ydoc.getArray("pptx:slides");
     const meta = ydoc.getMap("pptx:meta");
-    const handler = () => onChange();
-    slidesArray.observeDeep(handler);
-    meta.observeDeep(handler);
+    slidesArray.observeDeep(onChange);
+    meta.observeDeep(onChange);
     return () => {
-      slidesArray.unobserveDeep(handler);
-      meta.unobserveDeep(handler);
+      slidesArray.unobserveDeep(onChange);
+      meta.unobserveDeep(onChange);
     };
   }
   _slideToYMap(slide) {
     const slideMap = new yjs.Map();
-    const slideRecord = slide;
+    const rec = slide;
     for (const key of SCALAR_SLIDE_KEYS) {
-      const value = slideRecord[key];
-      if (value !== void 0) {
-        slideMap.set(key, value);
+      if (rec[key] !== void 0) {
+        slideMap.set(key, rec[key]);
       }
     }
     for (const [original, prefixed] of Object.entries(COMPLEX_SLIDE_FIELD_MAP)) {
-      const value = slideRecord[original];
-      if (value !== void 0) {
-        slideMap.set(prefixed, JSON.stringify(value));
+      if (rec[original] !== void 0) {
+        slideMap.set(prefixed, JSON.stringify(rec[original]));
       }
     }
     const elementsArray = new yjs.Array();
@@ -205,11 +370,10 @@ var PptxCodec = class {
     const elements = [];
     if (elementsArray) {
       for (let i = 0; i < elementsArray.length; i++) {
-        const elemMap = elementsArray.get(i);
-        elements.push(this._yMapToElement(elemMap));
+        elements.push(this._yMapToElement(elementsArray.get(i)));
       }
     }
-    slide["elements"] = elements;
+    slide.elements = elements;
     return slide;
   }
   _elementToYMap(element) {
@@ -219,7 +383,13 @@ var PptxCodec = class {
       if (value === void 0) {
         continue;
       }
-      if (SCALAR_ELEMENT_KEYS.has(key)) {
+      if (key === "textSegments") {
+        if (Array.isArray(value)) {
+          const ytext = new yjs.Text();
+          encodeTextBodyToYText(value, ytext);
+          elemMap.set("textBody", ytext);
+        }
+      } else if (SCALAR_ELEMENT_KEYS.has(key)) {
         elemMap.set(key, value);
       } else if (COMPLEX_FIELD_MAP[key]) {
         elemMap.set(COMPLEX_FIELD_MAP[key], JSON.stringify(value));
@@ -230,7 +400,9 @@ var PptxCodec = class {
   _yMapToElement(elemMap) {
     const element = {};
     elemMap.forEach((value, key) => {
-      if (REVERSE_COMPLEX_MAP[key]) {
+      if (key === "textBody" && value instanceof yjs.Text) {
+        element.textSegments = decodeTextBodyFromYText(value);
+      } else if (REVERSE_COMPLEX_MAP[key]) {
         try {
           element[REVERSE_COMPLEX_MAP[key]] = JSON.parse(value);
         } catch {

package/dist/codec/index.mjs

@@ -1,5 +1,176 @@
 import { PptxHandler } from 'pptx-viewer-core';
-import { Array as Array$1, Map } from 'yjs';
+import { Array as Array$1, Map, Text } from 'yjs';
+
+// src/codec/pptx-codec.ts
+
+// src/codec/text-body-codec.ts
+var EMPTY_PLACEHOLDER = "\u200B";
+function buildAttrs(seg) {
+  const a = {};
+  const style = seg.style;
+  if (style && typeof style === "object" && Object.keys(style).length > 0) {
+    a.s = JSON.stringify(style);
+  }
+  if (seg.isParagraphBreak) {
+    a.pb = "1";
+  }
+  if (seg.isLineBreak) {
+    a.lb = "1";
+  }
+  if (seg.ep === true) {
+    a.ep = "1";
+  }
+  if (seg.bulletInfo) {
+    a.bi = JSON.stringify(seg.bulletInfo);
+  }
+  if (seg.paragraphLevel !== void 0) {
+    a.pl = String(seg.paragraphLevel);
+  }
+  if (seg.endParaRunProperties) {
+    a.pr = JSON.stringify(seg.endParaRunProperties);
+  }
+  if (typeof seg.fieldType === "string") {
+    a.ft = seg.fieldType;
+  }
+  if (typeof seg.fieldGuid === "string") {
+    a.fg = seg.fieldGuid;
+  }
+  if (seg.fieldGuidAttr === "uuid" || seg.fieldGuidAttr === "id") {
+    a.fga = seg.fieldGuidAttr;
+  }
+  if (seg.fieldParagraphPropertiesXml) {
+    a.fp = JSON.stringify(seg.fieldParagraphPropertiesXml);
+  }
+  if (seg.equationXml) {
+    a.eq = JSON.stringify(seg.equationXml);
+  }
+  if (typeof seg.equationNumber === "string") {
+    a.en = seg.equationNumber;
+  }
+  if (seg.breakRunProperties) {
+    a.br = JSON.stringify(seg.breakRunProperties);
+  }
+  if (typeof seg.rubyText === "string") {
+    a.rt = seg.rubyText;
+  }
+  if (typeof seg.rubyAlignment === "string") {
+    a.ra = seg.rubyAlignment;
+  }
+  if (seg.rubyFontSize !== void 0) {
+    a.rfs = String(seg.rubyFontSize);
+  }
+  if (seg.rubyStyle) {
+    a.rs = JSON.stringify(seg.rubyStyle);
+  }
+  return Object.keys(a).length > 0 ? a : void 0;
+}
+function encodeTextBodyToYText(segments, ytext) {
+  let offset = 0;
+  for (const raw of segments) {
+    const seg = raw;
+    const attrs = buildAttrs(seg);
+    if (seg.isParagraphBreak === true || seg.isLineBreak === true) {
+      ytext.insert(offset, "\n", attrs);
+      offset += 1;
+    } else if (typeof seg.text === "string" && seg.text.length > 0) {
+      ytext.insert(offset, seg.text, attrs);
+      offset += seg.text.length;
+    } else {
+      const epAttrs = { ep: "1", ...attrs ?? {} };
+      ytext.insert(offset, EMPTY_PLACEHOLDER, epAttrs);
+      offset += 1;
+    }
+  }
+}
+function decodeTextBodyFromYText(ytext) {
+  const delta = ytext.toDelta();
+  const segments = [];
+  for (const op of delta) {
+    if (typeof op.insert !== "string" || op.insert === "") {
+      continue;
+    }
+    const a = op.attributes ?? {};
+    const seg = { text: "", style: {} };
+    if (a.s) {
+      try {
+        seg.style = JSON.parse(a.s);
+      } catch {
+        seg.style = {};
+      }
+    }
+    if (a.pb === "1") {
+      seg.isParagraphBreak = true;
+    }
+    if (a.lb === "1") {
+      seg.isLineBreak = true;
+    }
+    if (a.bi) {
+      try {
+        seg.bulletInfo = JSON.parse(a.bi);
+      } catch {
+      }
+    }
+    if (a.pl !== void 0) {
+      seg.paragraphLevel = Number(a.pl);
+    }
+    if (a.pr) {
+      try {
+        seg.endParaRunProperties = JSON.parse(a.pr);
+      } catch {
+      }
+    }
+    if (a.ft) {
+      seg.fieldType = a.ft;
+    }
+    if (a.fg) {
+      seg.fieldGuid = a.fg;
+    }
+    if (a.fga === "uuid" || a.fga === "id") {
+      seg.fieldGuidAttr = a.fga;
+    }
+    if (a.fp) {
+      try {
+        seg.fieldParagraphPropertiesXml = JSON.parse(a.fp);
+      } catch {
+      }
+    }
+    if (a.eq) {
+      try {
+        seg.equationXml = JSON.parse(a.eq);
+      } catch {
+      }
+    }
+    if (a.en) {
+      seg.equationNumber = a.en;
+    }
+    if (a.br) {
+      try {
+        seg.breakRunProperties = JSON.parse(a.br);
+      } catch {
+      }
+    }
+    if (a.rt) {
+      seg.rubyText = a.rt;
+    }
+    if (a.ra) {
+      seg.rubyAlignment = a.ra;
+    }
+    if (a.rfs !== void 0) {
+      seg.rubyFontSize = Number(a.rfs);
+    }
+    if (a.rs) {
+      try {
+        seg.rubyStyle = JSON.parse(a.rs);
+      } catch {
+      }
+    }
+    if (op.insert !== "\n" && op.insert !== EMPTY_PLACEHOLDER) {
+      seg.text = op.insert;
+    }
+    segments.push(seg);
+  }
+  return segments;
+}
 
 // src/codec/pptx-codec.ts
 var ORIGIN_FILE_LOAD = "file-load";
@@ -32,7 +203,6 @@ var SCALAR_ELEMENT_KEYS = /* @__PURE__ */ new Set([
   "promptText"
 ]);
 var COMPLEX_FIELD_MAP = {
-  textSegments: "_textSegments",
   textStyle: "_textStyle",
   shapeStyle: "_shapeStyle",
   shapeAdjustments: "_shapeAdjustments",
@@ -120,8 +290,7 @@ var PptxCodec = class {
         slidesArray.delete(0, slidesArray.length);
       }
       for (const slide of pptxData.slides) {
-        const slideMap = this._slideToYMap(slide);
-        slidesArray.push([slideMap]);
+        slidesArray.push([this._slideToYMap(slide)]);
       }
     }, effectiveOrigin);
   }
@@ -130,8 +299,7 @@ var PptxCodec = class {
     const slidesArray = ydoc.getArray("pptx:slides");
     const slides = [];
     for (let i = 0; i < slidesArray.length; i++) {
-      const slideMap = slidesArray.get(i);
-      slides.push(this._yMapToSlide(slideMap));
+      slides.push(this._yMapToSlide(slidesArray.get(i)));
     }
     const sourceBytesArr = meta.get("sourceBytes");
     try {
@@ -152,27 +320,24 @@ var PptxCodec = class {
   observe(ydoc, onChange) {
     const slidesArray = ydoc.getArray("pptx:slides");
     const meta = ydoc.getMap("pptx:meta");
-    const handler = () => onChange();
-    slidesArray.observeDeep(handler);
-    meta.observeDeep(handler);
+    slidesArray.observeDeep(onChange);
+    meta.observeDeep(onChange);
     return () => {
-      slidesArray.unobserveDeep(handler);
-      meta.unobserveDeep(handler);
+      slidesArray.unobserveDeep(onChange);
+      meta.unobserveDeep(onChange);
     };
   }
   _slideToYMap(slide) {
     const slideMap = new Map();
-    const slideRecord = slide;
+    const rec = slide;
     for (const key of SCALAR_SLIDE_KEYS) {
-      const value = slideRecord[key];
-      if (value !== void 0) {
-        slideMap.set(key, value);
+      if (rec[key] !== void 0) {
+        slideMap.set(key, rec[key]);
       }
     }
     for (const [original, prefixed] of Object.entries(COMPLEX_SLIDE_FIELD_MAP)) {
-      const value = slideRecord[original];
-      if (value !== void 0) {
-        slideMap.set(prefixed, JSON.stringify(value));
+      if (rec[original] !== void 0) {
+        slideMap.set(prefixed, JSON.stringify(rec[original]));
       }
     }
     const elementsArray = new Array$1();
@@ -203,11 +368,10 @@ var PptxCodec = class {
     const elements = [];
     if (elementsArray) {
       for (let i = 0; i < elementsArray.length; i++) {
-        const elemMap = elementsArray.get(i);
-        elements.push(this._yMapToElement(elemMap));
+        elements.push(this._yMapToElement(elementsArray.get(i)));
       }
     }
-    slide["elements"] = elements;
+    slide.elements = elements;
     return slide;
   }
   _elementToYMap(element) {
@@ -217,7 +381,13 @@ var PptxCodec = class {
       if (value === void 0) {
         continue;
       }
-      if (SCALAR_ELEMENT_KEYS.has(key)) {
+      if (key === "textSegments") {
+        if (Array.isArray(value)) {
+          const ytext = new Text();
+          encodeTextBodyToYText(value, ytext);
+          elemMap.set("textBody", ytext);
+        }
+      } else if (SCALAR_ELEMENT_KEYS.has(key)) {
         elemMap.set(key, value);
       } else if (COMPLEX_FIELD_MAP[key]) {
         elemMap.set(COMPLEX_FIELD_MAP[key], JSON.stringify(value));
@@ -228,7 +398,9 @@ var PptxCodec = class {
   _yMapToElement(elemMap) {
     const element = {};
     elemMap.forEach((value, key) => {
-      if (REVERSE_COMPLEX_MAP[key]) {
+      if (key === "textBody" && value instanceof Text) {
+        element.textSegments = decodeTextBodyFromYText(value);
+      } else if (REVERSE_COMPLEX_MAP[key]) {
         try {
           element[REVERSE_COMPLEX_MAP[key]] = JSON.parse(value);
         } catch {

package/dist/index.d.mts

@@ -1,4 +1,5 @@
 import { PptxData, PptxElement, PptxSlide, ShapeStyle } from 'pptx-viewer-core';
+export { PptxData, PptxElement, PptxHandler, PptxSlide } from 'pptx-viewer-core';
 import { Doc } from 'yjs';
 
 /**
@@ -87,7 +88,7 @@ declare function loadPresentation(filePath: string, execCtx: ExecutionContext):
     rawBytes: Uint8Array;
 }>;
 /**
- * Save mutated PptxData back — routes through collaboration Y.Doc or disk.
+ * Save mutated PptxData back: routes through collaboration Y.Doc or disk.
  */
 declare function savePresentation(filePath: string, pptxData: PptxData, rawBytes: Uint8Array, execCtx: ExecutionContext): Promise<{
     savedToDisk: boolean;

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import { PptxData, PptxElement, PptxSlide, ShapeStyle } from 'pptx-viewer-core';
+export { PptxData, PptxElement, PptxHandler, PptxSlide } from 'pptx-viewer-core';
 import { Doc } from 'yjs';
 
 /**
@@ -87,7 +88,7 @@ declare function loadPresentation(filePath: string, execCtx: ExecutionContext):
     rawBytes: Uint8Array;
 }>;
 /**
- * Save mutated PptxData back — routes through collaboration Y.Doc or disk.
+ * Save mutated PptxData back: routes through collaboration Y.Doc or disk.
  */
 declare function savePresentation(filePath: string, pptxData: PptxData, rawBytes: Uint8Array, execCtx: ExecutionContext): Promise<{
     savedToDisk: boolean;

package/dist/index.js

@@ -1254,7 +1254,7 @@ function runAccessibilityCheck(ctx) {
 }
 var MAX_REGEX_LEN = 200;
 function hasNestedUnboundedQuantifier(pattern) {
-  return /\([^)]*[+*]\)[+*]/.test(pattern);
+  return /\([^)]*[+*]\)[+*]/u.test(pattern);
 }
 function buildSearchRegex(query, useRegex, caseSensitive) {
   if (useRegex) {
@@ -1265,7 +1265,7 @@ function buildSearchRegex(query, useRegex, caseSensitive) {
       return null;
     }
   }
-  const pattern = useRegex ? query : query.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const pattern = useRegex ? query : query.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&");
   const flags = caseSensitive ? "g" : "gi";
   try {
     return new RegExp(pattern, flags);
@@ -1589,6 +1589,10 @@ async function convertToMarkdown(ctx, params) {
   };
 }
 
+Object.defineProperty(exports, "PptxHandler", {
+  enumerable: true,
+  get: function () { return pptxViewerCore.PptxHandler; }
+});
 exports.addElement = addElement;
 exports.addSlide = addSlide;
 exports.arrangeElements = arrangeElements;

package/dist/index.mjs

@@ -1,4 +1,5 @@
 import { PptxHandler, hasTextProperties, PptxMarkdownConverter } from 'pptx-viewer-core';
+export { PptxHandler } from 'pptx-viewer-core';
 import { resolve, isAbsolute, sep } from 'path';
 
 // src/execution.ts
@@ -1252,7 +1253,7 @@ function runAccessibilityCheck(ctx) {
 }
 var MAX_REGEX_LEN = 200;
 function hasNestedUnboundedQuantifier(pattern) {
-  return /\([^)]*[+*]\)[+*]/.test(pattern);
+  return /\([^)]*[+*]\)[+*]/u.test(pattern);
 }
 function buildSearchRegex(query, useRegex, caseSensitive) {
   if (useRegex) {
@@ -1263,7 +1264,7 @@ function buildSearchRegex(query, useRegex, caseSensitive) {
       return null;
     }
   }
-  const pattern = useRegex ? query : query.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const pattern = useRegex ? query : query.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&");
   const flags = caseSensitive ? "g" : "gi";
   try {
     return new RegExp(pattern, flags);

package/dist/mcp/index.js

@@ -372,7 +372,7 @@ function validateSlideIndex(slideIndex, slideCount) {
 // src/tools/content-tools.ts
 var MAX_REGEX_LEN = 200;
 function hasNestedUnboundedQuantifier(pattern) {
-  return /\([^)]*[+*]\)[+*]/.test(pattern);
+  return /\([^)]*[+*]\)[+*]/u.test(pattern);
 }
 function buildSearchRegex(query, useRegex, caseSensitive) {
   if (useRegex) {
@@ -383,7 +383,7 @@ function buildSearchRegex(query, useRegex, caseSensitive) {
       return null;
     }
   }
-  const pattern = useRegex ? query : query.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const pattern = useRegex ? query : query.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&");
   const flags = caseSensitive ? "g" : "gi";
   try {
     return new RegExp(pattern, flags);
@@ -1876,7 +1876,7 @@ function createServer() {
   server2.registerTool(
     "get_slide",
     {
-      description: "Inspect a single slide \u2014 returns layout, notes, elements",
+      description: "Inspect a single slide: returns layout, notes, elements",
       inputSchema: GetSlideSchema.shape
     },
     async (params) => {

package/dist/mcp/index.mjs

@@ -370,7 +370,7 @@ function validateSlideIndex(slideIndex, slideCount) {
 // src/tools/content-tools.ts
 var MAX_REGEX_LEN = 200;
 function hasNestedUnboundedQuantifier(pattern) {
-  return /\([^)]*[+*]\)[+*]/.test(pattern);
+  return /\([^)]*[+*]\)[+*]/u.test(pattern);
 }
 function buildSearchRegex(query, useRegex, caseSensitive) {
   if (useRegex) {
@@ -381,7 +381,7 @@ function buildSearchRegex(query, useRegex, caseSensitive) {
       return null;
     }
   }
-  const pattern = useRegex ? query : query.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const pattern = useRegex ? query : query.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&");
   const flags = caseSensitive ? "g" : "gi";
   try {
     return new RegExp(pattern, flags);
@@ -1874,7 +1874,7 @@ function createServer() {
   server2.registerTool(
     "get_slide",
     {
-      description: "Inspect a single slide \u2014 returns layout, notes, elements",
+      description: "Inspect a single slide: returns layout, notes, elements",
       inputSchema: GetSlideSchema.shape
     },
     async (params) => {

package/package.json

@@ -1,12 +1,18 @@
 {
 	"name": "pptx-viewer-mcp",
-	"version": "1.1.23",
-	"description": "PPTX manipulation tools, MCP server, and collaboration codec for pptx-viewer-core.",
+	"version": "1.1.26",
+	"description": "PowerPoint PPTX tools and MCP server: manipulate, convert, and collaborate on .pptx files from AI agents.",
 	"keywords": [
 		"ai",
+		"collaboration",
+		"converter",
 		"mcp",
+		"office",
+		"openxml",
 		"powerpoint",
+		"ppt",
 		"pptx",
+		"presentation",
 		"tools"
 	],
 	"homepage": "https://github.com/ChristopherVR/pptx-viewer",
@@ -25,6 +31,7 @@
 	},
 	"files": [
 		"dist/",
+		"CHANGELOG.md",
 		"LICENSE",
 		"README.md"
 	],
@@ -63,21 +70,19 @@
 	},
 	"dependencies": {
 		"@modelcontextprotocol/sdk": "^1.29.0",
+		"fast-xml-parser": "^5.9.2",
+		"jszip": "^3.10.1",
+		"pptx-viewer-core": "^1.1.0",
 		"zod": "^4.4.3"
 	},
 	"devDependencies": {
-		"fast-xml-parser": "^5.9.0",
-		"jszip": "^3.10.1",
-		"pptx-viewer-core": "^1.1.7",
 		"tsup": "^8.5.1",
 		"typescript": "^6.0.3",
-		"vitest": "^4.1.8",
+		"vitest": "^4.1.9",
 		"yjs": "^13.6.31"
 	},
 	"peerDependencies": {
-		"fast-xml-parser": "^5.5.0",
-		"jszip": "^3.10.0",
-		"pptx-viewer-core": "latest"
+		"yjs": "^13.6.31"
 	},
 	"peerDependenciesMeta": {
 		"yjs": {