pptx-angular-viewer 4.24.3 → 4.26.0

package/CHANGELOG.md

@@ -1,5 +1,64 @@
 # 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.
+A release listed with no entries carried no Conventional Commit in this package's
+scope: scripts/release-plan.mjs releases whenever any published file changes, not only on
+conventional commits.
+
+## [4.26.0](https://github.com/ChristopherVR/ooxml/releases/tag/pptx-angular-viewer@4.26.0) - 2026-10-07
+
+### Features
+
+- **pptx:** Add PowerPoint's built-in SmartArt layout definitions ([9c6cd97](https://github.com/ChristopherVR/ooxml/commit/9c6cd97ba6276a441aadf0d527d3bdc81fabce5e))
+- **pptx:** Apply built-in SmartArt layouts synchronously and save them ([4ddf31c](https://github.com/ChristopherVR/ooxml/commit/4ddf31c5f2f2a1b17e8af411ecd42bee7deaa491))
+- **shared:** Offer PowerPoint's built-in SmartArt layouts in every binding ([29100c4](https://github.com/ChristopherVR/ooxml/commit/29100c431c61983400e5af19ffd7d85ec2653463))
+
+### Bug Fixes
+
+- **shared:** Size SmartArt 3D labels to their text and sharpen them ([79318b6](https://github.com/ChristopherVR/ooxml/commit/79318b60fe12b81612c16de58e1c47584a2af008))
+- **shared:** Draw SmartArt connectors in the 3D view ([5795dcf](https://github.com/ChristopherVR/ooxml/commit/5795dcff0b489e9e79722781d000bba6d9b2f7a7))
+
+## [4.25.0](https://github.com/ChristopherVR/ooxml/releases/tag/pptx-angular-viewer@4.25.0) - 2026-10-06
+
+### Features
+
+- **pptx:** Parse chart legend overlay from c:overlay ([dce36c6](https://github.com/ChristopherVR/ooxml/commit/dce36c6134cdaded271b73f541091b37223b6da2))
+- **chart:** Move pie, radar, treemap and trendline helpers from pptx viewer ([c08a02b](https://github.com/ChristopherVR/ooxml/commit/c08a02b91b210c0f99c8c2dfbde02c2e1329fc57))
+- **color:** Move text contrast and unit rgb helpers from pptx viewer ([2dcc341](https://github.com/ChristopherVR/ooxml/commit/2dcc341bd931610a9e9a8f4e8d53483cffbed8ec))
+- **text:** Move tab leader and decimal tab helpers from pptx viewer ([3a5bcf0](https://github.com/ChristopherVR/ooxml/commit/3a5bcf0f4675db3d6831430c37db0c66c6814ef3))
+- **geometry:** Move snap guides and align/distribute from pptx viewer ([3400e87](https://github.com/ChristopherVR/ooxml/commit/3400e8776661df9e2148e1be78819b1c12564b79))
+- **pptx:** Forward the viewer's duplicated chart and theme helpers ([c22b276](https://github.com/ChristopherVR/ooxml/commit/c22b2766272ec08218ea14fadfc3cafd3c2b9ff6))
+
+### Bug Fixes
+
+- **pptx:** Clear the old layout definition on a SmartArt layout switch ([086e06c](https://github.com/ChristopherVR/ooxml/commit/086e06cc28b0389da820f35b5fd4f482f2312de8))
+- **shared:** Make 3D SmartArt editing and layout switching reliable in every binding ([43e3e07](https://github.com/ChristopherVR/ooxml/commit/43e3e07e6f4996c9777d175ffd3536a341dadc86))
+- **shared:** Hide the fill swatches when the pointer leaves a 3D SmartArt node ([c718e77](https://github.com/ChristopherVR/ooxml/commit/c718e77bb15f7d74721c252189bf99b1f77a9d0d))
+- **xlsx:** Harden code-scanning findings across areas ([90ee4b3](https://github.com/ChristopherVR/ooxml/commit/90ee4b33e1253f21cd0df299af468d550f85eddc))
+- **xlsx:** Use Reflect for dynamic property writes and tighten sanitizers ([b663413](https://github.com/ChristopherVR/ooxml/commit/b66341384d972d73182b06c6b4c706c0462f9364))
+
+### Refactor
+
+- Move the library into src/core, next to src/ui ([3933a88](https://github.com/ChristopherVR/ooxml/commit/3933a88e36784ce5f4bfab0af1ca12eb65d3cd0c))
+
+### Documentation
+
+- Bring the pptx docs and agent guide up to date with the move ([8cc3f5e](https://github.com/ChristopherVR/ooxml/commit/8cc3f5e364232d39d2a2286e25056fd67b594108))
+
+### Build & CI
+
+- **deps:** Adopt ooxml-ui 0.29.1 and ooxml-core 0.21.1 ([56e1979](https://github.com/ChristopherVR/ooxml/commit/56e197912df02e3d6ce674025115dab206338138))
+- **pptx:** Move the pptx demos and browser tests to the repository root ([a23994d](https://github.com/ChristopherVR/ooxml/commit/a23994d534fc34721f182d5eba9cd4abb97e44f8))
+- **release:** Publish the pptx viewer packages from this repository ([21e790f](https://github.com/ChristopherVR/ooxml/commit/21e790f582b3d7072f3770d7a1bd9fc2ad035e53))
+
+### Chores
+
+- **viewers:** Import the pptx-viewer repository with its history ([dde62be](https://github.com/ChristopherVR/ooxml/commit/dde62beb12d38f53fcddf016a4de243fe7151712))
+
+# 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.
@@ -7,6 +66,12 @@ 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.
 
+## [4.24.3](https://github.com/ChristopherVR/pptx-viewer/releases/tag/pptx-angular-viewer@4.24.3) - 2026-10-06
+
+### Bug Fixes
+
+- **shared:** Make 3D SmartArt rotate, edit and recolour like the 2D diagram (by @ChristopherVR) ([29473d4](https://github.com/ChristopherVR/pptx-viewer/commit/29473d42fdfd8a1b5dff4f2259ecad68ecbd57bc))
+
 ## [4.24.2](https://github.com/ChristopherVR/pptx-viewer/releases/tag/pptx-angular-viewer@4.24.2) - 2026-10-05
 
 ### Bug Fixes

package/README.md

@@ -1,18 +1,18 @@
 # pptx-angular-viewer
 
 [![npm version](https://img.shields.io/npm/v/pptx-angular-viewer.svg)](https://www.npmjs.com/package/pptx-angular-viewer)
-[![license](https://img.shields.io/npm/l/pptx-angular-viewer.svg)](https://github.com/ChristopherVR/pptx-viewer/blob/main/LICENSE)
+[![license](https://img.shields.io/npm/l/pptx-angular-viewer.svg)](https://github.com/ChristopherVR/ooxml/blob/main/viewers/pptx/LICENSE)
 
 Show, edit, and present Microsoft PowerPoint (`.pptx`) files directly in an
 Angular app: no server, no conversion step, no PowerPoint install required. Drop
 in a `<pptx-viewer>` component, hand it the file's bytes, and it renders slides
 as real HTML and CSS with full editing and export support.
 
-![Exploring the Insert and View ribbon tabs in the Angular demo](https://raw.githubusercontent.com/ChristopherVR/pptx-viewer/main/.github/assets/packages/angular-demo.gif)
+![Exploring the Insert and View ribbon tabs in the Angular demo](https://raw.githubusercontent.com/ChristopherVR/ooxml/main/viewers/pptx/.github/assets/packages/angular-demo.gif)
 
 The rendering is done by the framework-agnostic [`pptx-viewer-core`](https://www.npmjs.com/package/pptx-viewer-core) engine, which turns a `.pptx` file into a structured slide model. This package is the Angular layer that draws that model on screen, and the engine is **bundled in**, so you install just one package.
 
-<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>
+<samp>**[▶️ Try the live demo](https://christophervr.github.io/ooxml/pptx/demo-angular/)** · **[📦 npm](https://www.npmjs.com/package/pptx-angular-viewer)** · **[📖 Full docs](https://christophervr.github.io/ooxml/pptx/)** · **[🧩 Core SDK](https://www.npmjs.com/package/pptx-viewer-core)**</samp>
 
 ## Features
 
@@ -126,7 +126,7 @@ bootstrapApplication(AppComponent, {
 
 Two ready-made presets ship with the package: `vermilionLightTheme` (warm paper
 canvas) and `vermilionDarkTheme` (dimmed presenter room), the same vermilion
-brand look as the [documentation site](https://christophervr.github.io/pptx-viewer/):
+brand look as the [documentation site](https://christophervr.github.io/ooxml/pptx/):
 
 ```ts
 import { vermilionLightTheme } from 'pptx-angular-viewer';
@@ -244,7 +244,7 @@ geometry or user zoom. See the [cross-binding defaults](../../docs/guide/viewpor
 | `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 peer loads only when its panel is opened.                                                                                                                                                                                                                                                                                |
 | `hiddenActions`                                                            | `ToolbarActionId[]`                  | `[]`    | Toolbar buttons/ribbon tabs to hide individually (e.g. `['share', 'broadcast']`), instead of hiding the whole toolbar.                                                                                                                                                                                                                                                |
-| `customization`                                                            | `ViewerCustomization`                | -       | Hide, lock or remap any part of the UI (ribbon tabs/buttons, File > Options pages/sections/settings, File tab, context menus, shortcuts, panels, AI/collaboration, dialogs); the same helpers (`hideRibbonTab`, `lockSetting`, ...) are on the component instance. See the [UI Customization guide](https://christophervr.github.io/pptx-viewer/guide/customization). |
+| `customization`                                                            | `ViewerCustomization`                | -       | Hide, lock or remap any part of the UI (ribbon tabs/buttons, File > Options pages/sections/settings, File tab, context menus, shortcuts, panels, AI/collaboration, dialogs); the same helpers (`hideRibbonTab`, `lockSetting`, ...) are on the component instance. See the [UI Customization guide](https://christophervr.github.io/ooxml/pptx/guide/customization). |
 | `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.                                                                                                                                                                                                                                                                                   |
@@ -303,7 +303,7 @@ following slide/element manipulation methods are also available:
 `addElement(element)`, `updateElement(id, patch)`, `deleteElements(ids)`, and
 `duplicateElement(id)`.
 
-See [element insertion](https://christophervr.github.io/pptx-viewer/angular/api#add-element)
+See [element insertion](https://christophervr.github.io/ooxml/pptx/angular/api#add-element)
 for the `addElement` contract and a core-factory example.
 
 ### Exported components & helpers
@@ -333,7 +333,7 @@ import {
 } from 'pptx-angular-viewer/internals';
 ```
 
-See the [services reference](https://christophervr.github.io/pptx-viewer/angular/services-reference)
+See the [services reference](https://christophervr.github.io/ooxml/pptx/angular/services-reference)
 for the full list.
 
 ## Localization (i18n)
@@ -351,7 +351,7 @@ inject(TranslateService).setTranslation('en', translationsEn);
 inject(TranslateService).use('fr');
 ```
 
-Unlike React/Vue, `translationsEn`, `keyToLabel`, and the `TranslationKey` type (for type-checking a new locale dictionary as `Record<TranslationKey, string>`) are exported from the package **root**, not an `/i18n` subpath. See the [Localization guide](https://christophervr.github.io/pptx-viewer/guide/localization) for the full picture across all five viewer bindings and how to contribute a translation upstream; the live demo's language picker is a working reference.
+Unlike React/Vue, `translationsEn`, `keyToLabel`, and the `TranslationKey` type (for type-checking a new locale dictionary as `Record<TranslationKey, string>`) are exported from the package **root**, not an `/i18n` subpath. See the [Localization guide](https://christophervr.github.io/ooxml/pptx/guide/localization) for the full picture across all five viewer bindings and how to contribute a translation upstream; the live demo's language picker is a working reference.
 
 ## Limitations
 
@@ -384,7 +384,7 @@ import { translationsZhCN } from 'pptx-angular-viewer/i18n/zh-CN';
 
 The other subpaths are `i18n/fr` (`translationsFr`), `i18n/es`
 (`translationsEs`), and `i18n/de` (`translationsDe`). See the
-[localization guide](https://christophervr.github.io/pptx-viewer/guide/localization)
+[localization guide](https://christophervr.github.io/ooxml/pptx/guide/localization)
 for registration and runtime switching. Existing English imports are unchanged.
 
 ## License

package/ng-package.json

@@ -0,0 +1,25 @@
+{
+	"$schema": "../../node_modules/ng-packagr/ng-package.schema.json",
+	"dest": "dist",
+	"allowedNonPeerDependencies": [
+		"@lucide/angular",
+		"html2canvas-pro",
+		"jspdf",
+		"jszip",
+		"fast-xml-parser",
+		"dompurify",
+		"ooxml-ui",
+		"opentype.js",
+		"pptx-viewer-core",
+		"pptx-viewer-mcp",
+		"zod"
+	],
+	"assets": [
+		"NOTICE",
+		"README.md",
+		{ "glob": "pptx-angular-viewer.css", "input": "src/styles", "output": "." }
+	],
+	"lib": {
+		"entryFile": "src/public-api.ts"
+	}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pptx-angular-viewer",
-	"version": "4.24.3",
+	"version": "4.26.0",
 	"description": "pptx-viewer for Angular: a PowerPoint viewer and editor component to render, edit, and export PPTX slides in the browser.",
 	"keywords": [
 		"angular",
@@ -18,16 +18,16 @@
 		"slideshow",
 		"viewer"
 	],
-	"homepage": "https://github.com/ChristopherVR/pptx-viewer",
+	"homepage": "https://christophervr.github.io/ooxml/pptx/",
 	"bugs": {
-		"url": "https://github.com/ChristopherVR/pptx-viewer/issues"
+		"url": "https://github.com/ChristopherVR/ooxml/issues"
 	},
 	"license": "Apache-2.0",
 	"author": "ChristopherVR",
 	"repository": {
 		"type": "git",
-		"url": "https://github.com/ChristopherVR/pptx-viewer.git",
-		"directory": "packages/angular"
+		"url": "git+https://github.com/ChristopherVR/ooxml.git",
+		"directory": "viewers/pptx/packages/angular"
 	},
 	"exports": {
 		"./styles": "./pptx-angular-viewer.css",
@@ -75,15 +75,19 @@
 				"types": "./i18n/zh-CN.d.cts",
 				"default": "./i18n/zh-CN.cjs"
 			}
-		},
-		"./package.json": {
-			"default": "./package.json"
-		},
-		".": {
-			"types": "./types/pptx-angular-viewer.d.ts",
-			"default": "./fesm2022/pptx-angular-viewer.mjs"
 		}
 	},
+	"scripts": {
+		"inline-shared": "node ./scripts/inline-shared.mjs",
+		"finalize-dist": "node ./scripts/finalize-dist.mjs",
+		"build": "bun run inline-shared && ng-packagr -p ng-package.json -c tsconfig.lib.json && bun run finalize-dist && bun run build:css && node ../locales/scripts/copy-subpaths.mjs",
+		"build:css": "tailwindcss -i src/styles/pptx-angular-viewer.css -o dist/pptx-angular-viewer.css --minify",
+		"dev": "bun run inline-shared && ng-packagr -p ng-package.json -c tsconfig.lib.json --watch",
+		"typecheck": "bun run inline-shared && tsc --noEmit -p tsconfig.lib.json",
+		"test": "bun run inline-shared && vitest run",
+		"test:watch": "bun run inline-shared && vitest",
+		"pack": "bun run build && cd dist && bun pm pack"
+	},
 	"dependencies": {
 		"@lucide/angular": "^1.52.0",
 		"dompurify": "^3.4.16",
@@ -91,13 +95,38 @@
 		"html2canvas-pro": "^2.5.1",
 		"jspdf": "^4.2.1",
 		"jszip": "^3.10.2",
-		"ooxml-ui": "^0.28.0",
+		"ooxml-ui": "^0.30.1",
 		"opentype.js": "^2.0.0",
-		"pptx-viewer-core": "^4.11.2",
-		"pptx-viewer-mcp": "^2.7.1",
+		"pptx-viewer-core": "^4.13.0",
+		"pptx-viewer-mcp": "^2.7.2",
 		"tslib": "^2.8.1",
 		"zod": "^4.6.5"
 	},
+	"devDependencies": {
+		"@analogjs/vite-plugin-angular": "^2.8.0",
+		"@angular/common": "^22.2.1",
+		"@angular/compiler": "^22.2.1",
+		"@angular/compiler-cli": "^22.2.1",
+		"@angular/core": "^22.2.1",
+		"@angular/platform-browser": "^22.2.1",
+		"@tailwindcss/cli": "^4.3.3",
+		"@types/opentype.js": "^1.3.10",
+		"@types/three": "^0.186.0",
+		"ai": "^7.0.127",
+		"happy-dom": "^20.14.5",
+		"jsdom": "^30.1.2",
+		"ng-packagr": "^22.2.4",
+		"pptx-viewer-core": "^4.13.0",
+		"rxjs": "^7.8.2",
+		"tailwindcss": "^4.3.3",
+		"three": "^0.186.1",
+		"typescript": "6.0.3",
+		"vitest": "^5.0.3",
+		"y-webrtc": "^10.3.0",
+		"y-websocket": "^3.1.0",
+		"yjs": "^13.6.33",
+		"zone.js": "^0.16.3"
+	},
 	"peerDependencies": {
 		"@angular/common": "^19.0.0 || ^20.0.0 || ^21.0.0 || ^22.0.0",
 		"@angular/core": "^19.0.0 || ^20.0.0 || ^21.0.0 || ^22.0.0",
@@ -126,9 +155,5 @@
 		"yjs": {
 			"optional": true
 		}
-	},
-	"module": "fesm2022/pptx-angular-viewer.mjs",
-	"typings": "types/pptx-angular-viewer.d.ts",
-	"sideEffects": false,
-	"type": "module"
+	}
 }

package/scripts/finalize-dist.mjs

@@ -0,0 +1,24 @@
+/**
+ * Resolve `workspace:*` ranges in the built `dist/package.json` to concrete
+ * versions, after ng-packagr has generated it.
+ *
+ * An ng-packagr library is published from `dist/`, which is NOT a workspace
+ * member, so nothing downstream can resolve `workspace:*` there. Doing it here
+ * means `bun pm pack` from `dist/` (and any local tarball smoke test) already
+ * sees real ranges, rather than only the release pipeline.
+ *
+ * The rewrite itself lives in `scripts/publish-manifest.mjs` at the repo root:
+ * `npm publish` ships a manifest verbatim, so EVERY publish path has to run the
+ * same resolution or the package becomes uninstallable (issue #129). One
+ * implementation, used by both this build step and the release workflow.
+ */
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+import { writePublishManifest } from '../../../scripts/publish-manifest.mjs';
+
+const here = dirname(fileURLToPath(import.meta.url));
+const distPkgPath = resolve(here, '../dist/package.json');
+
+const resolved = writePublishManifest(distPkgPath);
+console.log(`[finalize-dist] resolved workspace ranges in dist/package.json (${resolved.name})`);

package/scripts/inline-shared.mjs

@@ -0,0 +1,43 @@
+/**
+ * Inline the internal, non-published `pptx-viewer-shared` package into this
+ * Angular library before compilation.
+ *
+ * ng-packagr externalizes bare-specifier dependencies and cannot reliably
+ * compile source from outside the package directory. So we copy
+ * `packages/shared/src` into `packages/angular/src/internal/shared-src` (a
+ * generated, git-ignored directory) and import it locally. The result is that
+ * the shared code ships **inlined** in the FESM and `pptx-viewer-shared` never
+ * appears in the published `package.json`; it stays a private workspace
+ * package.
+ *
+ * Runs before `build`, `typecheck`, and `test`. Test files are excluded.
+ */
+import { cpSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const here = dirname(fileURLToPath(import.meta.url));
+const src = resolve(here, '../../shared/src');
+const dest = resolve(here, '../src/internal/shared-src');
+
+rmSync(dest, { recursive: true, force: true });
+cpSync(src, dest, {
+	recursive: true,
+	filter: (path) => !path.endsWith('.test.ts'),
+});
+
+console.log(`[inline-shared] copied ${src} -> ${dest}`);
+
+// Also stamp this package's own `package.json` version into a tiny generated
+// module (`internal/version.ts`), so File > Account's About panel can show a
+// real version without ng-packagr trying to compile source from outside
+// `src/` (importing `../package.json` directly would sit outside `rootDir`).
+const pkgPath = resolve(here, '../package.json');
+const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+const versionFile = resolve(here, '../src/internal/version.ts');
+writeFileSync(
+	versionFile,
+	`// Generated by scripts/inline-shared.mjs from package.json. Do not edit.\nexport const PPTX_ANGULAR_VIEWER_VERSION = ${JSON.stringify(pkg.version)};\n`,
+);
+
+console.log(`[inline-shared] wrote ${versionFile} (v${pkg.version})`);

package/tsconfig.lib.json

@@ -0,0 +1,13 @@
+{
+	"extends": "./tsconfig.json",
+	"compilerOptions": {
+		"declaration": true,
+		"declarationMap": true,
+		"outDir": "dist"
+	},
+	"angularCompilerOptions": {
+		"compilationMode": "partial"
+	},
+	"include": ["src/**/*.ts"],
+	"exclude": ["**/*.test.ts", "**/*.spec.ts"]
+}

package/vitest-setup.ts

@@ -0,0 +1,12 @@
+/**
+ * vitest-setup.ts: loads the Angular JIT compiler before any test module runs.
+ *
+ * Our `.component.ts` files are transpiled by plain `esbuild`/TypeScript
+ * decorators here (no Angular AOT), so their `@Component`/`@Injectable`
+ * classes have no `ɵcmp`/`ɵprov` factory baked in and Angular falls back to
+ * JIT at runtime. `@ngx-translate/core`'s `DefaultMissingTranslationHandler`
+ * hits this exact fallback in its own module-level static initializer, so
+ * merely importing a `.component.ts` file (even just for a co-located pure
+ * helper export) throws unless `@angular/compiler` has already been loaded.
+ */
+import '@angular/compiler';