pptx-angular-viewer 1.1.22 → 1.1.29

package/CHANGELOG.md

@@ -0,0 +1,86 @@
+# 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.29](https://github.com/ChristopherVR/pptx-viewer/releases/tag/pptx-angular-viewer@1.1.29) - 2026-06-21
+
+### Features
+
+- **shared:** Add Three.js SmartArt 3D model + scene runtime (by @ChristopherVR) ([f949213](https://github.com/ChristopherVR/pptx-viewer/commit/f949213b33ed0dca4c52d5d1ab414c3dba67efe7))
+- **angular:** Opt-in Three.js SmartArt renderer (by @ChristopherVR) ([be6d858](https://github.com/ChristopherVR/pptx-viewer/commit/be6d85818b4a2f70cf644ee91467fd44dc4506de))
+
+### Documentation
+
+- Sharpen npm descriptions and keywords for discoverability (by @ChristopherVR) ([8fea56d](https://github.com/ChristopherVR/pptx-viewer/commit/8fea56d7650f7dc2f3167dea97b94b612a03a4e7))
+- **angular:** Reword README in plain language (by @ChristopherVR) ([ba72266](https://github.com/ChristopherVR/pptx-viewer/commit/ba722668b0c4846e86837b2cf255198231ab2631))
+
+## [1.1.24](https://github.com/ChristopherVR/pptx-viewer/releases/tag/pptx-angular-viewer@1.1.24) - 2026-06-20
+
+### Features
+
+- **vue:** Add pptx-vue-viewer package + bundled pptx-viewer-shared (by @ChristopherVR) ([1b7a958](https://github.com/ChristopherVR/pptx-viewer/commit/1b7a958ce91792a6d174f174932800bc8ff40ef9))
+- **angular:** Add pptx-angular-viewer package + demo (by @ChristopherVR) ([81255a9](https://github.com/ChristopherVR/pptx-viewer/commit/81255a9251e855bc51b97c8dc68b55e71e206882))
+- **angular:** Image & gradient fills in element-style (by @ChristopherVR) ([2457aa2](https://github.com/ChristopherVR/pptx-viewer/commit/2457aa2163e6e6504aa36d464d3686d58f625338))
+- **angular:** Connector, table & clip-path renderers (by @ChristopherVR) ([12bb060](https://github.com/ChristopherVR/pptx-viewer/commit/12bb060841d9cdc2d473c5d3794f37502b6047eb))
+- **angular:** PNG + PDF export (html2canvas-pro + jspdf) (by @ChristopherVR) ([e5aec3d](https://github.com/ChristopherVR/pptx-viewer/commit/e5aec3d58b84407629ca84292fe7c3407bd9d87e))
+- **angular:** Wire signatures panel (parts-reading) into the viewer (by @ChristopherVR) ([d11afb9](https://github.com/ChristopherVR/pptx-viewer/commit/d11afb96195c998f9a56a218fa641b8adbf62fb6))
+
+### Bug Fixes
+
+- **build:** Make all packages build + publish cleanly; align Vue README (by @ChristopherVR) ([7db5de6](https://github.com/ChristopherVR/pptx-viewer/commit/7db5de6a343887fc1a32dd526ae1ab68e1e3e6e0))
+
+### Other
+
+- **angular:** Tailwind 4 Office ribbon + pt→px font fix (by @ChristopherVR) ([ad5da60](https://github.com/ChristopherVR/pptx-viewer/commit/ad5da60e73c4a6ea780cda94773b4a74dcea9786))
+
+### Refactor
+
+- **react:** Consume theme + loader from pptx-viewer-shared (by @ChristopherVR) ([1b93d1f](https://github.com/ChristopherVR/pptx-viewer/commit/1b93d1fccff378b0ac402810a0cbddea46add29c))
+- **angular:** Keep core peer as workspace:\*, resolve at build time (by @ChristopherVR) ([b123ac9](https://github.com/ChristopherVR/pptx-viewer/commit/b123ac99e9611b7f585197d827ba2ac35217997e))
+- **angular:** Remove em-dashes from code comments and prose (by @ChristopherVR) ([0166321](https://github.com/ChristopherVR/pptx-viewer/commit/01663210fd84f60b29c7c6176def02951e3903f3))
+
+### Documentation
+
+- **angular:** Update PORTING for charts, table rich text, connector routing (by @ChristopherVR) ([3baddb5](https://github.com/ChristopherVR/pptx-viewer/commit/3baddb5363294aa2bcbe08c18f51a7b8a0be4f1d))
+- **angular:** Update PORTING for SmartArt/ink/OLE/3D/zoom + effects (by @ChristopherVR) ([d5393c6](https://github.com/ChristopherVR/pptx-viewer/commit/d5393c6269812941f2314f03e33432c076f39c79))
+- **angular:** Record slide background + hyperlink rendering (by @ChristopherVR) ([0c21fe3](https://github.com/ChristopherVR/pptx-viewer/commit/0c21fe31ad18006c97807b0ea3c3e39bb950d163))
+- **angular:** Update PORTING for parity waves 1-3 (by @ChristopherVR) ([e51e7b9](https://github.com/ChristopherVR/pptx-viewer/commit/e51e7b98e4ee833a28f4f2e2ba1cc0e8b8af881b))
+- **angular:** Record export + editor foundation in PORTING (by @ChristopherVR) ([d6f494d](https://github.com/ChristopherVR/pptx-viewer/commit/d6f494df7c59b0f88c9b4a66bce5705c43c4603c))
+- **angular:** Mark editor interaction UI + save-back done (by @ChristopherVR) ([ce0fddf](https://github.com/ChristopherVR/pptx-viewer/commit/ce0fddff33728155cee86930c5f530c66ed400d3))
+- **angular:** Record drag/resize + inspector panel (by @ChristopherVR) ([04dd906](https://github.com/ChristopherVR/pptx-viewer/commit/04dd9069dec0a384bda83d7d1a8262eb39fb5eba))
+- **angular:** Record editor chrome (panels, toolbar, clipboard, align) (by @ChristopherVR) ([69ba935](https://github.com/ChristopherVR/pptx-viewer/commit/69ba9354218ea9ce3066ea84fa4fa60659ff85d8))
+- **angular:** Record rotation/marquee/group + direct-manipulation complete (by @ChristopherVR) ([bb45ccd](https://github.com/ChristopherVR/pptx-viewer/commit/bb45ccd938b83881d735f205a245c1eb1df3d8c3))
+- **angular:** Record snap guides + slide props; parity summary (by @ChristopherVR) ([f748b18](https://github.com/ChristopherVR/pptx-viewer/commit/f748b1871307c97e2c81b2fa64cc9611f2b559d1))
+- **angular:** Record advanced-subsystem waves 1-2 in PORTING.md (by @ChristopherVR) ([63c78ff](https://github.com/ChristopherVR/pptx-viewer/commit/63c78ff996efe208540a1825d9c301feebb36956))
+- **angular:** Record advanced-subsystem wiring in PORTING.md (by @ChristopherVR) ([ebc72a7](https://github.com/ChristopherVR/pptx-viewer/commit/ebc72a79bf5edb1c13d58a70b7b96a3cecc8a810))
+- **angular:** Record bubble & radar chart kinds in PORTING.md (by @ChristopherVR) ([ea8dd22](https://github.com/ChristopherVR/pptx-viewer/commit/ea8dd226cca868fec18e1c6a2375d25ad942a03f))
+- **angular:** Record parity push (charts, connectors, duotone, editor, export, subsystem wiring) (by @ChristopherVR) ([127a233](https://github.com/ChristopherVR/pptx-viewer/commit/127a2333f84eeb0ffb0956dd2a2d15518f18269e))
+- **angular:** Record full feature parity (animation playback/authoring, mobile chrome) (by @ChristopherVR) ([e48a258](https://github.com/ChristopherVR/pptx-viewer/commit/e48a258e0e2a873f75121aaeff906d56de5b43c6))
+- **angular:** Record depth batch (chart overlays, text warp, annotations, transitions) (by @ChristopherVR) ([e68f07e](https://github.com/ChristopherVR/pptx-viewer/commit/e68f07e3a56ba881bbd0f178e518695baf34d139))
+- **angular:** Record framework-neutral e2e contract parity (by @ChristopherVR) ([6200fc9](https://github.com/ChristopherVR/pptx-viewer/commit/6200fc9cdf38f2c1623b3b519d1499cdc98515b3))
+- **angular:** Record visual-parity audit vs React + remaining chrome gap (by @ChristopherVR) ([f3ae199](https://github.com/ChristopherVR/pptx-viewer/commit/f3ae19991d6208a2654a7137aff08dd3ee43b22e))
+- Streamline npm READMEs and add badges, screenshots, demo links (by @ChristopherVR) ([92e980d](https://github.com/ChristopherVR/pptx-viewer/commit/92e980d434900abd223c4d70c6cae19a623f9ca8))
+- **vue,angular:** Point Try-demo links at per-framework demos (by @ChristopherVR) ([b5e6915](https://github.com/ChristopherVR/pptx-viewer/commit/b5e6915c416075f4f50630d76dfedbc324cde03e))
+- **angular:** Log ribbon-port kickoff + Tailwind foundation status (by @ChristopherVR) ([40e0408](https://github.com/ChristopherVR/pptx-viewer/commit/40e04083c02b2f59f77253743df74218c4bca5b3))
+- **angular:** Log ribbon shell + status bar landed, preflight verified (by @ChristopherVR) ([2b10e74](https://github.com/ChristopherVR/pptx-viewer/commit/2b10e74db1ae065785c8ac8ec50d4f46d3635ad7))
+- **angular:** Log ribbon e2e status (8/10) + known mobile gaps + pt→px note (by @ChristopherVR) ([e0cb539](https://github.com/ChristopherVR/pptx-viewer/commit/e0cb5394473b96c453fce71e9b83205976ebd803))
+- **angular:** Mark ribbon merged to main (by @ChristopherVR) ([9226bdc](https://github.com/ChristopherVR/pptx-viewer/commit/9226bdc08a3e87dc2d2322fbe06c3491d6476c35))
+- **angular:** Log advanced ribbon tabs landed (Transitions/Animations wired, Design partial, Draw UI-only) (by @ChristopherVR) ([deeb6c1](https://github.com/ChristopherVR/pptx-viewer/commit/deeb6c1adfd25516b3d3effe19b136721c9ee8a1))
+- **angular:** Mobile e2e now 10/10 (notes-sheet flow fix); log trunk spec fix (by @ChristopherVR) ([92f4c44](https://github.com/ChristopherVR/pptx-viewer/commit/92f4c44a931233258981e452ecaccd5fe25f1a39))
+- **angular:** Log Insert/View/Design/Draw depth landed (2148 tests, e2e 10/10) (by @ChristopherVR) ([cbe9dc7](https://github.com/ChristopherVR/pptx-viewer/commit/cbe9dc7cb1998d766def97fbb20db4169c869680))
+- **angular:** Log niche wave (snap-to-grid/guides/eyedropper/selection-pane/custom-shows); 2161 tests, e2e 10/10 (by @ChristopherVR) ([fa77b49](https://github.com/ChristopherVR/pptx-viewer/commit/fa77b497938ea9bae60aa3794902f16f710efe54))
+- **angular:** Niche list complete — custom-show present + equation OMML; functional parity reached (by @ChristopherVR) ([ac719c7](https://github.com/ChristopherVR/pptx-viewer/commit/ac719c79af0a78d3d98902577c7c35a38c42423e))
+- **angular:** Trim PORTING.md to status + what's-missing (drop session log) (by @ChristopherVR) ([393d5e2](https://github.com/ChristopherVR/pptx-viewer/commit/393d5e2e10361cd9158cf502c2f15e67bbe9e09c))
+- **angular:** E2e now 28/0 (no skips); remaining = refactor/cosmetic debts only (by @ChristopherVR) ([7817092](https://github.com/ChristopherVR/pptx-viewer/commit/7817092780173c1a288029addfadc6c6e571e871))
+- Remove em-dashes and clarify demo link in viewer packages (by @ChristopherVR) ([f52afff](https://github.com/ChristopherVR/pptx-viewer/commit/f52afffd935016b747116a9909c523021b492225))
+
+### Build & CI
+
+- **angular:** Adopt Tailwind 4 pipeline for ribbon chrome parity (by @ChristopherVR) ([65cf58f](https://github.com/ChristopherVR/pptx-viewer/commit/65cf58fbcce1fbf3ac0c3ce0f3b49b3c9604d1b1))
+
+### Dependencies
+
+- **deps:** Update dependencies and CI actions to latest (by @ChristopherVR) ([b1a84a2](https://github.com/ChristopherVR/pptx-viewer/commit/b1a84a26814bfdb9b5d5ef7dd87aeabc4fa82c04))
+- **deps:** Bump all workspace manifest floors to latest (by @ChristopherVR) ([890c33d](https://github.com/ChristopherVR/pptx-viewer/commit/890c33d667a39480a69e6a3da893964382993b29))

package/NOTICE

@@ -7,7 +7,7 @@ attribution it contains) in any derivative works you distribute.
 
 This package bundles the following component under a different license:
 
-  mtx-decompressor — MicroType Express (MTX) font decompressor
+  mtx-decompressor - MicroType Express (MTX) font decompressor
   License: Mozilla Public License 2.0 (MPL-2.0)
   Source:  https://github.com/ChristopherVR/pptx-viewer/tree/main/packages/mtx-decompressor
   Origin:  Ported from libeot (https://github.com/nicowilliams/libeot)

package/README.md

@@ -1,26 +1,37 @@
 # pptx-angular-viewer
 
-Render Microsoft PowerPoint (`.pptx`) presentations directly in an Angular app —
-no server, no conversion step, no PowerPoint install. Drop in a `<pptx-viewer>`
-component, hand it the file bytes, and it parses and displays the slides as
-scalable HTML/CSS with slide navigation and zoom.
+[![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)
 
-Parsing is powered by the framework-agnostic `pptx-viewer-core` engine
-(OpenXML → a structured slide model); this package is the Angular rendering
-layer on top of it.
+Show Microsoft PowerPoint (`.pptx`) presentations 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 reads and displays
+the slides as real HTML and CSS, with slide navigation and zoom.
+
+![PowerPoint editor UI rendered in the browser](https://raw.githubusercontent.com/ChristopherVR/pptx-viewer/main/.github/assets/editor.png)
+
+> The screenshot shows the full-featured **React** editor. This Angular package
+> is at a **read-only viewer** milestone today; see [Limitations](#limitations).
+
+The reading is done by the framework-agnostic `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.
+
+<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/)**</samp>
+
+> **[▶️ Try the live demo](https://christophervr.github.io/pptx-viewer/demo-angular/)**: open a `.pptx` and render it in your browser, no install required.
 
 ## Features
 
-- **Standalone component** — `<pptx-viewer>`, no NgModule required.
-- **Signals-based & zoneless-friendly** — `OnPush` everywhere, built on the
-  Angular signals API.
-- **CSS rendering** — slides are real DOM (scaled HTML/SVG), so text stays sharp
-  at any zoom and is selectable/accessible.
-- **Slide navigation** — thumbnail rail, prev/next, slide counter.
-- **Zoom** — in/out/reset.
-- **Themeable** — semantic color tokens via CSS custom properties.
-- **Loads from anywhere** — `ArrayBuffer` / `Uint8Array` from a file input,
-  `fetch`, drag-and-drop, etc.
+- **Standalone component**: `<pptx-viewer>`, no NgModule needed.
+- **Modern Angular**: built on signals and `OnPush`, and works without Zone.js.
+- **Real HTML rendering**: slides are drawn as ordinary HTML and SVG, not as a
+  picture, so text stays sharp at any zoom and is selectable and accessible.
+- **Slide navigation**: a thumbnail rail, previous/next, and a slide counter.
+- **Zoom**: in, out, and reset.
+- **Themeable**: change colours through CSS custom properties.
+- **Loads from anywhere**: an `ArrayBuffer` or `Uint8Array` from a file input,
+  a `fetch`, drag-and-drop, and so on.
 
 ## Installation
 
@@ -28,7 +39,7 @@ layer on top of it.
 npm install pptx-angular-viewer pptx-viewer-core
 ```
 
-**Peer requirements:** Angular 20+ (`@angular/core`, `@angular/common`),
+**Peer requirements:** Angular 22+ (`@angular/core`, `@angular/common`),
 `rxjs`, and `pptx-viewer-core`.
 
 ## Usage
@@ -98,7 +109,7 @@ bootstrapApplication(AppComponent, {
 
 ### Reading the current presentation back
 
-`getContent()` serialises the in-memory presentation to `.pptx` bytes. Reach it
+`getContent()` turns the current presentation back into `.pptx` bytes. Reach it
 via a template reference or `viewChild`:
 
 ```ts
@@ -117,10 +128,10 @@ async save() {
 | Input           | Type                                | Default | Description                                                 |
 | --------------- | ----------------------------------- | ------- | ----------------------------------------------------------- |
 | `content`       | `Uint8Array \| ArrayBuffer \| null` | `null`  | The `.pptx` bytes to render.                                |
-| `theme`         | `ViewerTheme`                       | —       | Color/radius overrides applied as CSS custom properties.    |
+| `theme`         | `ViewerTheme`                       | n/a     | Color/radius overrides applied as CSS custom properties.    |
 | `class`         | `string`                            | `''`    | Class applied to the root element.                          |
 | `canEdit`       | `boolean`                           | `false` | Reserved for the editor (not yet implemented).              |
-| `collaboration` | `CollaborationConfig`               | —       | Reserved for real-time collaboration (not yet implemented). |
+| `collaboration` | `CollaborationConfig`               | n/a     | Reserved for real-time collaboration (not yet implemented). |
 
 ### Outputs
 
@@ -144,59 +155,22 @@ async save() {
 
 ## Limitations
 
-This package is at a **read-only viewer** milestone. Today it renders the
-structural content of a slide; rich visual effects and editing are not yet wired
-up.
-
-**Element coverage**
-
-- ✅ Rendered: text (rich runs — bold/italic/underline/strike/color/size),
-  shapes (solid fill, stroke, basic preset corners), pictures/images, media
-  poster frames, and nested groups.
-- ⚠️ Shown as labelled placeholders: tables, charts, SmartArt, connectors, ink,
-  OLE objects, 3D models, and zoom links.
-
-**Rendering fidelity (current gaps)**
-
-- Shape fills are solid-color only — gradients, pattern, and picture fills are
-  not yet applied.
-- No custom-geometry clip-paths; only a few common preset shapes get rounded/
-  elliptical corners.
-- No shadows, glow, reflection, soft-edge, 3D bevels, or image effects.
-- No text warp / WordArt, and equations (OMML) are not rendered.
-- Slide background images render; advanced background fills are simplified.
-- Fonts use whatever is available in the browser; embedded-font injection is not
-  yet wired up, which can affect text metrics.
-
-**Playback & interaction**
-
-- Media shows the poster frame only — audio/video playback is not implemented.
-- No animations, slide transitions, or presentation mode yet.
-- The viewer is read-only: no selection, editing, toolbar, or inspector.
-
-**Export**
-
-- No image/PDF/GIF/video export yet.
-
-If you need any of the above today, the underlying `pptx-viewer-core` engine
-already parses most of this data — you can read it from the parsed model even
-where this UI layer doesn't render it yet.
-
-## Roadmap
-
-Actively being worked on, roughly in priority order:
-
-1. **Richer rendering** — gradient/pattern fills, preset-geometry clip-paths,
-   then tables, connectors, and charts.
-2. **Effects** — shadows, glow, image effects, and 3D styling.
-3. **Editing** — selection, transform, and an editor chrome (toolbar/inspector),
-   unlocking `canEdit`, `dirtyChange`, and `contentChange`.
-4. **Animations, transitions, and presentation mode.**
-5. **Export** — PNG/PDF/GIF/video.
-6. **Real-time collaboration** (the `collaboration` input).
-7. **Font embedding/injection** for higher text fidelity.
-
-Progress and design notes live in [`PORTING.md`](./PORTING.md).
+This package is at a **read-only viewer** milestone: it shows the content of a
+slide, but richer visual effects and editing are not built yet.
+
+- **Shown today:** text (with mixed formatting), shapes (solid fill, outline, and
+  basic rounded corners), pictures and images, the still frame of a video, and
+  nested groups.
+- **Shown as placeholders:** tables, charts, SmartArt, connectors, ink, OLE
+  objects, 3D models, and zoom links appear as labelled boxes for now.
+- **Not built yet:** gradient, pattern, and image fills; custom shape outlines;
+  effects (shadows, glow, 3D, image filters); warped text and equations;
+  embedded fonts; video and audio playback; animations, transitions, and
+  presentation mode; editing (selecting, the toolbar, the inspector); and export.
+
+The `pptx-viewer-core` engine already reads most of this data, so you can get it
+from the parsed model even where this UI does not draw it yet. Progress, the
+roadmap, and design notes live in [`PORTING.md`](./PORTING.md).
 
 ## Build (contributing)
 

package/fesm2022/pptx-angular-viewer-index-BfKeZbQy.mjs

@@ -0,0 +1,358 @@
+import { CanvasTexture, SRGBColorSpace, LinearFilter, Shape, ExtrudeGeometry, MeshStandardMaterial, Color, Mesh, EdgesGeometry, LineBasicMaterial, LineSegments, PlaneGeometry, MeshBasicMaterial, Euler, Vector3, BufferGeometry, Line, Group, WebGLRenderer, Scene, PerspectiveCamera, AmbientLight, DirectionalLight } from 'three';
+import { OrbitControls } from 'three/examples/jsm/controls/OrbitControls.js';
+
+/**
+ * Three.js SmartArt renderer - front-face text textures.
+ *
+ * Renders a node label onto an offscreen 2D canvas and wraps it as a
+ * `THREE.CanvasTexture`, sized to sit on the extruded block's front face. Text
+ * is word-wrapped and auto-shrunk to fit the node footprint. Returns `null` in
+ * non-DOM environments (SSR / unit tests).
+ */
+/** Supersampling factor for crisp text at oblique camera angles. */
+const SUPERSAMPLE = 4;
+/** Fraction of the footprint the text plane occupies (inset padding). */
+const FILL = 0.86;
+/** Greedily word-wrap `text` to lines that fit `maxWidth` at the given font. */
+function wrapLines(ctx, text, maxWidth) {
+    const words = text.split(/\s+/u).filter(Boolean);
+    if (words.length === 0) {
+        return [];
+    }
+    const lines = [];
+    let line = words[0];
+    for (let i = 1; i < words.length; i++) {
+        const candidate = `${line} ${words[i]}`;
+        if (ctx.measureText(candidate).width <= maxWidth) {
+            line = candidate;
+        }
+        else {
+            lines.push(line);
+            line = words[i];
+        }
+    }
+    lines.push(line);
+    return lines;
+}
+/**
+ * Build a label texture for a node's front face.
+ *
+ * @param text      Label text.
+ * @param color     CSS colour for the text.
+ * @param fontSize  Requested font size in layout pixels.
+ * @param footW     Node footprint width (layout pixels).
+ * @param footH     Node footprint height (layout pixels).
+ * @returns The texture + plane size, or `null` when no DOM / empty text.
+ */
+function makeTextTexture(text, color, fontSize, footW, footH) {
+    if (typeof document === 'undefined' || !text.trim() || footW <= 0 || footH <= 0) {
+        return null;
+    }
+    const worldWidth = footW * FILL;
+    const worldHeight = footH * FILL;
+    const canvas = document.createElement('canvas');
+    canvas.width = Math.max(8, Math.round(worldWidth * SUPERSAMPLE));
+    canvas.height = Math.max(8, Math.round(worldHeight * SUPERSAMPLE));
+    const ctx = canvas.getContext('2d');
+    if (!ctx) {
+        return null;
+    }
+    const family = 'system-ui, -apple-system, Segoe UI, Roboto, sans-serif';
+    const maxTextWidth = canvas.width * 0.94;
+    // Shrink the font until the wrapped block fits the canvas height.
+    let px = Math.max(6, fontSize) * SUPERSAMPLE;
+    let lines = [];
+    for (let attempt = 0; attempt < 12; attempt++) {
+        ctx.font = `600 ${px}px ${family}`;
+        lines = wrapLines(ctx, text, maxTextWidth);
+        const lineHeight = px * 1.2;
+        if (lines.length * lineHeight <= canvas.height * 0.96 || px <= 6 * SUPERSAMPLE) {
+            break;
+        }
+        px *= 0.88;
+    }
+    ctx.clearRect(0, 0, canvas.width, canvas.height);
+    ctx.fillStyle = color;
+    ctx.textAlign = 'center';
+    ctx.textBaseline = 'middle';
+    ctx.font = `600 ${px}px ${family}`;
+    const lineHeight = px * 1.2;
+    const blockHeight = lines.length * lineHeight;
+    const startY = canvas.height / 2 - blockHeight / 2 + lineHeight / 2;
+    for (let i = 0; i < lines.length; i++) {
+        ctx.fillText(lines[i], canvas.width / 2, startY + i * lineHeight);
+    }
+    const texture = new CanvasTexture(canvas);
+    texture.colorSpace = SRGBColorSpace;
+    texture.minFilter = LinearFilter;
+    texture.magFilter = LinearFilter;
+    texture.needsUpdate = true;
+    return { texture, worldWidth, worldHeight };
+}
+
+/**
+ * Three.js SmartArt renderer - mesh-group construction.
+ *
+ * Turns a pure {@link SmartArt3DModel} into a `THREE.Group` of extruded blocks
+ * (with bevels, edge outlines, and front-face text planes) plus connector
+ * lines. All allocated GPU resources are tracked so the caller can dispose them
+ * deterministically.
+ */
+/** Build the extruded geometry for one node. */
+function extrudeGeometry(m) {
+    const shape = new Shape();
+    m.outline.forEach((p, i) => {
+        if (i === 0) {
+            shape.moveTo(p.x, p.y);
+        }
+        else {
+            shape.lineTo(p.x, p.y);
+        }
+    });
+    shape.closePath();
+    const bevelEnabled = m.bevel > 0;
+    return new ExtrudeGeometry(shape, {
+        depth: m.depth,
+        bevelEnabled,
+        bevelThickness: m.bevel,
+        bevelSize: m.bevel,
+        bevelSegments: 2,
+        curveSegments: m.rounded ? 24 : 1,
+        steps: 1,
+    });
+}
+/** Add the extruded block + edge outline for one node to the group. */
+function addBlock(group, disposables, m) {
+    const geo = extrudeGeometry(m);
+    const material = new MeshStandardMaterial({
+        color: new Color(m.fill),
+        metalness: 0.12,
+        roughness: 0.52,
+        transparent: m.opacity < 1,
+        opacity: m.opacity,
+    });
+    const mesh = new Mesh(geo, material);
+    mesh.position.set(m.position.x, m.position.y, m.position.z);
+    mesh.rotation.set(m.rotation.x, m.rotation.y, m.rotation.z);
+    group.add(mesh);
+    disposables.push(geo, material);
+    if (m.strokeWidth > 0) {
+        const edges = new EdgesGeometry(geo, 30);
+        const lineMaterial = new LineBasicMaterial({ color: new Color(m.stroke) });
+        const line = new LineSegments(edges, lineMaterial);
+        line.position.copy(mesh.position);
+        line.rotation.copy(mesh.rotation);
+        group.add(line);
+        disposables.push(edges, lineMaterial);
+    }
+    return geo;
+}
+/** Add a front-face text plane for one node, if it has a label. */
+function addLabel(group, disposables, m) {
+    if (!m.text) {
+        return;
+    }
+    const tex = makeTextTexture(m.text, m.textColor, m.fontSize, m.halfWidth * 2, m.halfHeight * 2);
+    if (!tex) {
+        return;
+    }
+    const planeGeo = new PlaneGeometry(tex.worldWidth, tex.worldHeight);
+    const planeMaterial = new MeshBasicMaterial({
+        map: tex.texture,
+        transparent: true,
+        depthWrite: false,
+    });
+    const plane = new Mesh(planeGeo, planeMaterial);
+    // Float just past the front (+z) face, clearing any bevel, following the
+    // mesh's rotation so the label sits flat on the (possibly rotated) face.
+    const euler = new Euler(m.rotation.x, m.rotation.y, m.rotation.z);
+    const offset = new Vector3(0, 0, m.depth + m.bevel + 0.4).applyEuler(euler);
+    plane.position.set(m.position.x + offset.x, m.position.y + offset.y, m.position.z + offset.z);
+    plane.rotation.copy(euler);
+    group.add(plane);
+    disposables.push(planeGeo, planeMaterial, tex.texture);
+}
+/** Add a connector poly-line on the base plane. */
+function addConnectors(group, disposables, model) {
+    for (const c of model.connectors) {
+        if (c.points.length < 2) {
+            continue;
+        }
+        const geo = new BufferGeometry().setFromPoints(c.points.map((p) => new Vector3(p.x, p.y, p.z)));
+        const material = new LineBasicMaterial({
+            color: new Color(c.color),
+            transparent: true,
+            opacity: 0.7,
+        });
+        group.add(new Line(geo, material));
+        disposables.push(geo, material);
+    }
+}
+/**
+ * Build a `THREE.Group` for a SmartArt 3D model. The group is centred on the
+ * origin (the model positions already are); callers add it to the scene.
+ */
+function buildMeshGroup(model) {
+    const group = new Group();
+    const disposables = [];
+    for (const m of model.meshes) {
+        addBlock(group, disposables, m);
+        addLabel(group, disposables, m);
+    }
+    addConnectors(group, disposables, model);
+    return {
+        group,
+        dispose() {
+            for (const d of disposables) {
+                d.dispose();
+            }
+        },
+    };
+}
+
+/**
+ * Three.js SmartArt renderer - vanilla scene runtime.
+ *
+ * Frames a {@link SmartArt3DModel} in a WebGL scene (lights, perspective
+ * camera, optional OrbitControls, render loop) on a caller-provided canvas.
+ * Pure vanilla three.js - no framework code - so the React, Vue, and Angular
+ * bindings all mount it through a thin canvas wrapper. `three` is imported here
+ * only; this module lives behind the `pptx-viewer-shared/smartart-3d` subpath so
+ * it is lazily loaded and `three` stays an optional dependency.
+ */
+const FOV = 42;
+/** Bounding sphere of all meshes (expanded by footprint/depth) + connectors. */
+function contentSphere(model) {
+    let minX = Infinity;
+    let minY = Infinity;
+    let minZ = Infinity;
+    let maxX = -Infinity;
+    let maxY = -Infinity;
+    let maxZ = -Infinity;
+    const expand = (x, y, z, r) => {
+        minX = Math.min(minX, x - r);
+        minY = Math.min(minY, y - r);
+        minZ = Math.min(minZ, z - r);
+        maxX = Math.max(maxX, x + r);
+        maxY = Math.max(maxY, y + r);
+        maxZ = Math.max(maxZ, z + r);
+    };
+    for (const m of model.meshes) {
+        const r = Math.max(m.halfWidth, m.halfHeight) + m.depth + m.bevel;
+        expand(m.position.x, m.position.y, m.position.z, r);
+    }
+    for (const c of model.connectors) {
+        for (const p of c.points) {
+            expand(p.x, p.y, p.z, 1);
+        }
+    }
+    if (!Number.isFinite(minX)) {
+        const fallback = Math.max(model.bounds.width, model.bounds.height) / 2 || 1;
+        return { cx: 0, cy: 0, cz: 0, radius: fallback };
+    }
+    return {
+        cx: (minX + maxX) / 2,
+        cy: (minY + maxY) / 2,
+        cz: (minZ + maxZ) / 2,
+        radius: 0.5 * Math.hypot(maxX - minX, maxY - minY, maxZ - minZ) || 1,
+    };
+}
+/** Camera distance that frames a bounding sphere of `radius` at the given FOV. */
+function frameDistance(radius, aspect) {
+    const vFov = (FOV * Math.PI) / 180;
+    const hFov = 2 * Math.atan(Math.tan(vFov / 2) * aspect);
+    const minFov = Math.min(vFov, hFov);
+    return (radius / Math.sin(minFov / 2)) * 1.1;
+}
+/**
+ * Mount a SmartArt 3D model onto a canvas and start rendering.
+ *
+ * @returns a handle for resizing, toggling interactivity, and disposal.
+ */
+function mountSmartArt3D(canvas, model, width, height, options = {}) {
+    const renderer = new WebGLRenderer({ canvas, antialias: true, alpha: !options.background });
+    renderer.setPixelRatio(Math.min(typeof window === 'undefined' ? 1 : window.devicePixelRatio || 1, options.maxPixelRatio ?? 2));
+    renderer.setSize(width, height, false);
+    const scene = new Scene();
+    if (options.background) {
+        scene.background = new Color(options.background);
+    }
+    const { cx, cy, cz, radius } = contentSphere(model);
+    const aspect = width / Math.max(1, height);
+    const dist = frameDistance(radius, aspect);
+    const camera = new PerspectiveCamera(FOV, aspect, 0.1, dist * 8 + radius * 4);
+    // A slight elevation + offset gives the extrusion/spatial depth a readable
+    // three-quarter presence, framing the content's own centroid.
+    camera.position.set(cx + radius * 0.25, cy + radius * 0.3, cz + dist);
+    camera.lookAt(cx, cy, cz);
+    scene.add(new AmbientLight(0xffffff, 0.62));
+    const key = new DirectionalLight(0xffffff, 0.95);
+    key.position.set(cx + radius, cy + radius * 1.4, cz + dist);
+    scene.add(key);
+    const fill = new DirectionalLight(0xffffff, 0.3);
+    fill.position.set(cx - radius, cy - radius * 0.6, cz + dist * 0.6);
+    scene.add(fill);
+    const built = buildMeshGroup(model);
+    scene.add(built.group);
+    let controls = null;
+    const enableControls = (on) => {
+        if (on && !controls) {
+            controls = new OrbitControls(camera, canvas);
+            controls.enablePan = false;
+            controls.target.set(cx, cy, cz);
+            controls.minDistance = dist * 0.4;
+            controls.maxDistance = dist * 3;
+            controls.update();
+        }
+        else if (!on && controls) {
+            controls.dispose();
+            controls = null;
+        }
+        if (controls) {
+            controls.autoRotate = Boolean(options.autoRotate);
+            controls.autoRotateSpeed = 1.2;
+        }
+    };
+    enableControls(Boolean(options.interactive));
+    let frame = 0;
+    let disposed = false;
+    const renderLoop = () => {
+        if (disposed) {
+            return;
+        }
+        frame = requestAnimationFrame(renderLoop);
+        controls?.update();
+        renderer.render(scene, camera);
+    };
+    frame = requestAnimationFrame(renderLoop);
+    return {
+        resize(w, h) {
+            camera.aspect = w / Math.max(1, h);
+            camera.updateProjectionMatrix();
+            renderer.setSize(w, h, false);
+        },
+        setInteractive(on) {
+            enableControls(on);
+        },
+        dispose() {
+            disposed = true;
+            cancelAnimationFrame(frame);
+            controls?.dispose();
+            built.dispose();
+            renderer.dispose();
+        },
+    };
+}
+
+/**
+ * `pptx-viewer-shared/smartart-3d` - vanilla three.js SmartArt scene runtime.
+ *
+ * Lazily imported by each binding's SmartArt 3D wrapper so `three` stays an
+ * optional dependency: when it is not installed the dynamic import rejects and
+ * the binding falls back to the SVG `SmartArtRenderer`. The pure model builder
+ * (`buildSmartArt3DModel`) and its types live in the main barrel
+ * (`pptx-viewer-shared`) and should be imported from there directly.
+ */
+
+export { mountSmartArt3D };
+//# sourceMappingURL=pptx-angular-viewer-index-BfKeZbQy.mjs.map