pptx-react-viewer 1.0.0 → 1.0.7

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-present pptx-viewer contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NOTICE

@@ -0,0 +1,16 @@
+pptx-viewer
+Copyright (c) 2025-present pptx-viewer contributors
+
+This package is licensed under the MIT License. See the LICENSE file for details.
+
+This package bundles the following component under a different license:
+
+  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)
+           by Brennan T. Vincent, licensed under MPL-2.0.
+
+Under MPL-2.0, the source code of the mtx-decompressor component remains
+available under the terms of the Mozilla Public License 2.0. The full text
+of the MPL-2.0 can be found at: https://mozilla.org/MPL/2.0/

package/README.md

@@ -296,123 +296,17 @@ import {
 
 ### High-Level Component Tree
 
-```mermaid
-flowchart TB
-    PPV["PowerPointViewer<br/>(root orchestrator)"]
-
-    PPV --> VTS["ViewerToolbarSection<br/>Toolbar + ModeSwitcher"]
-    PPV --> VMC["ViewerMainContent<br/>Canvas + sidebars + inspector"]
-    PPV --> VBP["ViewerBottomPanels<br/>Notes + status bar"]
-    PPV --> VDG["ViewerDialogGroup<br/>All modal dialogs"]
-    PPV --> VO["ViewerOverlays<br/>Shortcuts, accessibility, slide sorter"]
-    PPV --> VPL["ViewerPresentationLayer<br/>Fullscreen slideshow"]
-
-    VMC --> VSP["ViewerSidePanels<br/>Slides pane + master pane"]
-    VMC --> VCA["ViewerCanvasArea<br/>SlideCanvas + overlays"]
-    VMC --> VI["ViewerInspector<br/>Properties panel"]
-
-    VCA --> SC["SlideCanvas<br/>Main slide rendering"]
-    SC --> ER["ElementRenderer<br/>Per-element dispatch"]
-    ER --> SH["Shape / Text"]
-    ER --> IM["Image"]
-    ER --> TB["Table"]
-    ER --> CH["Chart (SVG)"]
-    ER --> CN["Connector"]
-    ER --> SA["SmartArt"]
-    ER --> M3["3D Model"]
-    ER --> MD["Media (audio/video)"]
-    ER --> IK["Ink"]
-```
+_See the [architecture diagrams on GitHub](https://github.com/ChristopherVR/pptx-viewer/blob/main/packages/react/README.md) for visual representations._
 
 ### Hook Composition
 
 The viewer's logic is decomposed into 67+ custom hooks, composed in `PowerPointViewer.tsx`:
 
-```mermaid
-flowchart TD
-    subgraph "Core State"
-        VS["useViewerState<br/>All mutable state"]
-        VCS["useViewerCoreState<br/>Slides, selection, canvas"]
-        VUI["useViewerUIState<br/>Panels, dialogs, UI flags"]
-    end
-
-    subgraph "Derived State"
-        DSS["useDerivedSlideState<br/>Visible indexes, sections"]
-        DES["useDerivedElementState<br/>Selected element computed props"]
-    end
-
-    subgraph "Core Operations"
-        EH["useEditorHistory<br/>Undo/redo snapshot stack"]
-        ZV["useZoomViewport<br/>Zoom level + viewport"]
-        EO["useEditorOperations<br/>Compose all editor ops"]
-    end
-
-    subgraph "Feature Hooks"
-        LC["useLoadContent<br/>Parse PPTX on mount"]
-        PM["usePresentationMode<br/>Slideshow navigation"]
-        PA["usePresentationAnnotations<br/>Pen/highlighter tools"]
-        IE["useInsertElements<br/>Shape/image/table insertion"]
-        EM["useElementManipulation<br/>Move/resize/delete"]
-        PH["usePointerHandlers<br/>Mouse/touch events"]
-        KS["useKeyboardShortcuts<br/>Hotkey bindings"]
-        EX["useExportHandlers<br/>PNG/SVG/PDF/video export"]
-        PR["usePrintHandlers<br/>Print dialog"]
-        SM["useSlideManagement<br/>Add/delete/reorder slides"]
-        TO["useTableOperations<br/>Row/column/cell ops"]
-        FR["useFindReplace<br/>Text search"]
-        CM["useComments<br/>Comment management"]
-    end
-
-    subgraph "Collaboration"
-        YJS["useYjsProvider<br/>WebSocket lifecycle"]
-        PT["usePresenceTracking<br/>Remote cursors"]
-        CS["useCollaborativeState<br/>CRDT shared state"]
-        CH2["useCollaborativeHistory<br/>Collab undo/redo"]
-    end
-
-    VS --> VCS
-    VS --> VUI
-    VCS --> DSS
-    VS --> EH
-    VS --> ZV
-    EH --> EO
-    ZV --> EO
-    EO --> IE
-    EO --> EM
-    EO --> PH
-    EO --> SM
-    EO --> TO
-    EO --> FR
-    EO --> CM
-```
+_See the [architecture diagrams on GitHub](https://github.com/ChristopherVR/pptx-viewer/blob/main/packages/react/README.md) for visual representations._
 
 ### Data Flow
 
-```mermaid
-sequenceDiagram
-    participant P as Parent App
-    participant V as PowerPointViewer
-    participant H as PptxHandler (core)
-    participant S as State (hooks)
-    participant C as SlideCanvas
-
-    P->>V: content={arrayBuffer}
-    V->>S: useViewerState({ content })
-    S->>H: handler.load(buffer)
-    H-->>S: PptxData { slides, theme, ... }
-    S-->>V: { slides, activeSlide, canvasSize, ... }
-    V->>C: Render active slide
-    C->>C: Map elements -> React components
-
-    Note over C: User edits element
-    C->>S: setState(updatedSlides)
-    S->>S: Push undo snapshot
-    S-->>V: Re-render with updated state
-
-    Note over V: User saves
-    V->>H: handler.save(slides)
-    H-->>P: Uint8Array via onContentChange
-```
+_See the [architecture diagrams on GitHub](https://github.com/ChristopherVR/pptx-viewer/blob/main/packages/react/README.md) for visual representations._
 
 ### Rendering Pipeline
 
@@ -423,37 +317,7 @@ Slides are rendered using **CSS positioning and transforms**, not HTML Canvas. T
 - DOM-based interaction (click, drag, resize)
 - Standard CSS effects (shadows, gradients, borders)
 
-```mermaid
-flowchart LR
-    subgraph "Data Model"
-        E["PptxElement<br/>(from core)"]
-    end
-
-    subgraph "React Components"
-        ER["ElementRenderer<br/>Type dispatch"]
-        EB["ElementBody<br/>Visual rendering"]
-        RH["ResizeHandles<br/>Selection UI"]
-    end
-
-    subgraph "CSS Output"
-        POS["position: absolute<br/>left/top/width/height"]
-        ROT["transform: rotate()"]
-        FIL["background: fill style"]
-        BOR["border: stroke style"]
-        SHD["box-shadow: effects"]
-        TXT["text styling (font, color, align)"]
-    end
-
-    E --> ER
-    ER --> EB
-    ER --> RH
-    EB --> POS
-    EB --> ROT
-    EB --> FIL
-    EB --> BOR
-    EB --> SHD
-    EB --> TXT
-```
+_See the [architecture diagrams on GitHub](https://github.com/ChristopherVR/pptx-viewer/blob/main/packages/react/README.md) for visual representations._
 
 ---
 
@@ -601,27 +465,7 @@ The right-side inspector (`InspectorPane`) displays contextual property editors:
 
 Activated by setting `mode` to `"present"`. The `ViewerPresentationLayer` takes over with:
 
-```mermaid
-flowchart TD
-    PM["usePresentationMode"] --> SN["useSlideNavigation<br/>Next/prev/goto slide"]
-    PM --> AP["useAnimationPlayback<br/>Trigger animations in sequence"]
-    PM --> PK["usePresentationKeyboard<br/>Arrow keys, Esc, N-key toggle"]
-    PM --> RT["useRehearsalTimings<br/>Practice mode with timer"]
-
-    subgraph "Rendering"
-        ST["Slide Transition<br/>(CSS + framer-motion)"]
-        AN["Animation Overlays<br/>(keyframe sequences)"]
-        AO["Annotation Overlay<br/>(pen/highlighter SVG)"]
-        PV["Presenter View<br/>(dual-screen notes + preview + timer)"]
-        TB2["Slideshow Toolbar<br/>(auto-hide on mouse idle)"]
-    end
-
-    SN --> ST
-    AP --> AN
-    PM --> AO
-    PM --> PV
-    PM --> TB2
-```
+_See the [architecture diagrams on GitHub](https://github.com/ChristopherVR/pptx-viewer/blob/main/packages/react/README.md) for visual representations._
 
 **Slide transitions** (`slide-transitions.ts`, `transition-keyframes.ts`):
 
@@ -636,25 +480,7 @@ flowchart TD
 
 The animation system (`viewer/utils/animation*.ts`, ~14 files) processes OOXML timing trees:
 
-```mermaid
-flowchart LR
-    A["PptxElementAnimation<br/>(from core)"] --> B["animation-timeline.ts<br/>Build timeline"]
-    B --> C["animation-sequencer.ts<br/>Resolve triggers:<br/>onClick, afterPrevious,<br/>withPrevious"]
-    C --> D["animation-keyframes.ts<br/>Generate CSS @keyframes"]
-    D --> E["animation-effects.ts<br/>Apply to DOM elements"]
-
-    subgraph "Effect Types"
-        F["Entrance<br/>(appear, fly in, fade, zoom)"]
-        G["Emphasis<br/>(pulse, spin, grow/shrink, color)"]
-        H["Exit<br/>(disappear, fly out, fade)"]
-        I["Motion Path<br/>(custom path with auto-rotation)"]
-    end
-
-    D --> F
-    D --> G
-    D --> H
-    D --> I
-```
+_See the [architecture diagrams on GitHub](https://github.com/ChristopherVR/pptx-viewer/blob/main/packages/react/README.md) for visual representations._
 
 Supports 40+ animation presets with configurable duration, delay, repeat, color animations, motion path auto-rotation, and text-build options (by word, by letter, by paragraph).
 
@@ -685,26 +511,7 @@ Chart chrome (axes, legends, titles, gridlines, data labels, data tables, displa
 
 The export pipeline (`viewer/utils/export*.ts`, `viewer/hooks/useExportHandlers.ts`):
 
-```mermaid
-flowchart TD
-    A["Export Request"] --> B{Format?}
-
-    B -->|PNG/JPEG| C["renderToCanvas (html2canvas)<br/>-> canvas.toDataURL()"]
-    B -->|SVG| D["DOM -> SVG serialisation<br/>(export-svg.ts)"]
-    B -->|PDF| E["jspdf + renderToCanvas<br/>-> multi-page PDF<br/>(with notes pages + overflow)"]
-    B -->|GIF| F["export-gif-encoder.ts<br/>-> animated GIF frames"]
-    B -->|Video| G["export-video.ts<br/>-> MediaRecorder API"]
-    B -->|PPTX| H["PptxHandler.save()<br/>-> Uint8Array download"]
-    B -->|Slides| I["PptxHandler.exportSlides()<br/>-> per-slide PPTX files"]
-
-    C --> J["Download / Blob URL"]
-    D --> J
-    E --> J
-    F --> J
-    G --> J
-    H --> J
-    I --> J
-```
+_See the [architecture diagrams on GitHub](https://github.com/ChristopherVR/pptx-viewer/blob/main/packages/react/README.md) for visual representations._
 
 The `renderToCanvas` wrapper (`lib/canvas-export.ts`) patches `html2canvas` to work around oklch colour space parsing issues in browsers that don't fully support it.
 
@@ -712,14 +519,7 @@ The `renderToCanvas` wrapper (`lib/canvas-export.ts`) patches `html2canvas` to w
 
 Connectors between shapes use a graph-based routing algorithm:
 
-```mermaid
-flowchart LR
-    A["Start Shape<br/>(connection point)"] --> B["connector-router.ts<br/>A* pathfinding"]
-    B --> C["connector-router-graph.ts<br/>Build obstacle grid"]
-    C --> D["connector-router-astar.ts<br/>Find shortest path"]
-    D --> E["connector-path.tsx<br/>SVG path rendering"]
-    E --> F["Arrow markers<br/>(start/end heads)"]
-```
+_See the [architecture diagrams on GitHub](https://github.com/ChristopherVR/pptx-viewer/blob/main/packages/react/README.md) for visual representations._
 
 The router avoids overlapping shapes by building an obstacle grid and using A\* pathfinding with Manhattan distance heuristics. Supports straight, elbow (bent), and curved connector types.
 

package/node_modules/emf-converter/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-present pptx-viewer contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/node_modules/emf-converter/README.md

@@ -104,169 +104,25 @@ Converts a WMF binary buffer to a PNG data URL.
 
 The converter follows a three-phase pipeline: **Parse → Replay → Export**.
 
-```mermaid
-flowchart LR
-    A[/"Binary Buffer<br/>(ArrayBuffer)"/] --> B{Format?}
-    B -->|EMF| C[Parse EMF Header]
-    B -->|WMF| D[Parse WMF Header]
-    C --> E[Create Canvas]
-    D --> E
-    E --> F{Replay Records}
-    F -->|GDI Records| G[GDI Record Handlers]
-    F -->|EMF+ Comments| H[EMF+ Record Handlers]
-    F -->|WMF Records| I[WMF Record Handlers]
-    G --> J[Canvas 2D Context]
-    H --> J
-    I --> J
-    J --> K[Process Deferred Images]
-    K --> L[Export to PNG Data URL]
-    L --> M[/"data:image/png;base64,..."/]
-```
+_See the [architecture diagrams on GitHub](https://github.com/ChristopherVR/pptx-viewer/blob/main/packages/emf-converter/README.md) for visual representations._
 
 ### Module Map
 
 Every source file has a specific responsibility. Here's how they connect:
 
-```mermaid
-graph TB
-    subgraph "Public API"
-        A[emf-converter.ts]
-        B[index.ts]
-    end
-
-    subgraph "Header & Setup"
-        C[emf-header-parser.ts]
-        D[emf-canvas-helpers.ts]
-        E[emf-constants.ts]
-        F[emf-types.ts]
-        G[emf-logging.ts]
-    end
-
-    subgraph "EMF GDI Replay"
-        H[emf-record-replay.ts]
-        I[emf-gdi-state-handlers.ts]
-        J[emf-gdi-draw-handlers.ts]
-        K[emf-gdi-poly-path-handlers.ts]
-        L[emf-gdi-transform-handlers.ts]
-        M[emf-gdi-object-handlers.ts]
-        N[emf-gdi-draw-shapes.ts]
-        O[emf-gdi-draw-text-bitmap.ts]
-        P[emf-gdi-coord.ts]
-        Q[emf-gdi-polypolygon-helpers.ts]
-    end
-
-    subgraph "EMF+ GDI+ Replay"
-        R[emf-plus-replay.ts]
-        S[emf-plus-object-parser.ts]
-        T[emf-plus-draw-handlers.ts]
-        U[emf-plus-text-image-handlers.ts]
-        V[emf-plus-state-handlers.ts]
-        W[emf-plus-path.ts]
-        X[emf-plus-read-helpers.ts]
-        Y[emf-plus-object-complex.ts]
-        Z[emf-plus-bitmap-decoder.ts]
-    end
-
-    subgraph "WMF Replay"
-        AA[wmf-replay.ts]
-        AB[wmf-draw-handlers.ts]
-    end
-
-    subgraph "Bitmap Decoding"
-        AC[emf-dib-decoder.ts]
-        AD[emf-dib-rle-decoder.ts]
-        AE[emf-dib-uncompressed.ts]
-    end
-
-    subgraph "Color Helpers"
-        AF[emf-color-helpers.ts]
-    end
-
-    B --> A
-    A --> C
-    A --> D
-    A --> H
-    A --> AA
-
-    H --> I
-    H --> J
-    H --> K
-    H --> R
-
-    I --> L
-    I --> M
-    J --> N
-    J --> O
-
-    AA --> AB
-```
+_See the [architecture diagrams on GitHub](https://github.com/ChristopherVR/pptx-viewer/blob/main/packages/emf-converter/README.md) for visual representations._
 
 ### EMF Record Replay Loop
 
 The core of the EMF converter is a sequential record-scanning loop that dispatches each record to the appropriate handler:
 
-```mermaid
-flowchart TD
-    Start([Start Replay]) --> Read["Read record at offset:<br/>type = uint32, size = uint32"]
-    Read --> Check{Record Type?}
-
-    Check -->|EMR_COMMENT| Plus["Check for EMF+ signature<br/>(0x2B464D45 = 'EMF+')"]
-    Plus -->|EMF+ found| PlusReplay["replayEmfPlusRecords()<br/>Returns deferred images"]
-    Plus -->|Not EMF+| Skip1[Skip record]
-
-    Check -->|EMR_EOF| Done([End — return deferred images])
-
-    Check -->|State records| State["handleEmfGdiStateRecord()<br/>SaveDC, RestoreDC, SetTextColor,<br/>SetBkMode, transforms, objects"]
-
-    Check -->|Draw records| Draw["handleEmfGdiDrawRecord()<br/>Shapes → emf-gdi-draw-shapes<br/>Text/Bitmap → emf-gdi-draw-text-bitmap"]
-
-    Check -->|Poly/Path records| Poly["handleEmfGdiPolyPathRecord()<br/>Polygon, Polyline, Bezier,<br/>BeginPath, FillPath, StrokePath"]
-
-    Check -->|Ignored| Skip2["Skip: EMR_HEADER,<br/>EMR_SETBRUSHORGEX, etc."]
-
-    PlusReplay --> Next
-    Skip1 --> Next
-    State --> Next
-    Draw --> Next
-    Poly --> Next
-    Skip2 --> Next
-
-    Next["offset += recSize"] --> Guard{"offset + 8 ≤ bufferLen<br/>AND recordCount < 50,000?"}
-    Guard -->|Yes| Read
-    Guard -->|No| Done
-```
+_See the [architecture diagrams on GitHub](https://github.com/ChristopherVR/pptx-viewer/blob/main/packages/emf-converter/README.md) for visual representations._
 
 ### EMF+ Dual-Mode Processing
 
 EMF files can contain embedded EMF+ records inside `EMR_COMMENT` records. When detected, these are processed by a parallel GDI+ replay engine:
 
-```mermaid
-flowchart LR
-    subgraph "EMF Record Stream"
-        E1[EMR_HEADER]
-        E2[EMR_SELECTOBJECT]
-        E3["EMR_COMMENT<br/>(EMF+ signature)"]
-        E4[EMR_RECTANGLE]
-        E5["EMR_COMMENT<br/>(EMF+ signature)"]
-        E6[EMR_EOF]
-    end
-
-    subgraph "EMF+ Record Stream (inside comments)"
-        P1[EMFPLUS_HEADER]
-        P2[EMFPLUS_OBJECT ×N]
-        P3[EMFPLUS_FillRects]
-        P4[EMFPLUS_DrawPath]
-        P5[EMFPLUS_DrawString]
-        P6[EMFPLUS_DrawImage]
-    end
-
-    E3 --> P1
-    E3 --> P2
-    E3 --> P3
-    E5 --> P4
-    E5 --> P5
-    E5 --> P6
-```
+_See the [architecture diagrams on GitHub](https://github.com/ChristopherVR/pptx-viewer/blob/main/packages/emf-converter/README.md) for visual representations._
 
 The EMF+ state (object table, world transform, save stack) **persists across multiple `EMR_COMMENT` records** within the same file, allowing complex drawings to span several comment blocks.
 
@@ -274,24 +130,7 @@ The EMF+ state (object table, world transform, save stack) **persists across mul
 
 WMF uses a simpler 16-bit record format with word-aligned record sizes:
 
-```mermaid
-flowchart TD
-    Start([Parse WMF Header]) --> Magic{"Magic bytes?"}
-    Magic -->|0x9AC6CDD7<br/>Aldus Placeable| APM["Read bounds & DPI<br/>from APM header"]
-    Magic -->|Standard| Std["Use default bounds<br/>(800×600)"]
-
-    APM --> Main
-    Std --> Main
-
-    Main["Sequential Record Loop"] --> RecType{"Record Type?"}
-    RecType -->|Drawing| WDraw["handleWmfDrawRecord()<br/>MoveTo, LineTo, Rectangle,<br/>Ellipse, Polygon, Text, etc."]
-    RecType -->|State| WState["Inline handlers:<br/>SetWindowOrg, SetWindowExt,<br/>SaveDC, RestoreDC, CreatePen,<br/>CreateBrush, CreateFont,<br/>SelectObject, DeleteObject"]
-    RecType -->|META_EOF| WDone([Done])
-
-    WDraw --> Next2[offset += recSize]
-    WState --> Next2
-    Next2 --> Main
-```
+_See the [architecture diagrams on GitHub](https://github.com/ChristopherVR/pptx-viewer/blob/main/packages/emf-converter/README.md) for visual representations._
 
 ---
 
@@ -368,21 +207,7 @@ The EMF+ replay engine (`emf-plus-replay.ts`) dispatches to:
 
 The converter manages multiple coordinate mapping systems:
 
-```mermaid
-graph TD
-    subgraph "EMF GDI Coordinates"
-        A["Logical Coordinates<br/>(from metafile)"] -->|"Simple Scale"| B["Canvas Pixels<br/>x = (logX - bounds.left) × sx<br/>y = (logY - bounds.top) × sy"]
-        A -->|"Mapping Mode"| C["Window/Viewport Transform<br/>x = ((logX - winOrg.x) / winExt.cx) × vpExt.cx + vpOrg.x"]
-    end
-
-    subgraph "EMF+ GDI+ Coordinates"
-        D["GDI+ Logical Units"] -->|"World Transform"| E["Canvas via 6-element<br/>affine matrix [a,b,c,d,e,f]"]
-    end
-
-    subgraph "WMF Coordinates"
-        F["WMF Logical Units"] -->|"Window → Canvas"| G["mx(x) = ((x - winOrg.x) / winExt.cx) × canvasW"]
-    end
-```
+_See the [architecture diagrams on GitHub](https://github.com/ChristopherVR/pptx-viewer/blob/main/packages/emf-converter/README.md) for visual representations._
 
 **GDI coordinates** (`emf-gdi-coord.ts`) use either simple bounds-based scaling or full window/viewport mapping mode, activated when the metafile sets `SetWindowExtEx`/`SetViewportExtEx`.
 
@@ -394,34 +219,7 @@ graph TD
 
 Both GDI and GDI+ maintain their own object tables — essentially registries of reusable drawing resources:
 
-```mermaid
-graph LR
-    subgraph "GDI Object Table (Map<number, GdiObject>)"
-        P1["Slot 0: Pen<br/>style=0 (solid), width=2, color=#000"]
-        B1["Slot 1: Brush<br/>style=0 (solid), color=#ff0000"]
-        F1["Slot 2: Font<br/>height=12, weight=700, family=Arial"]
-    end
-
-    subgraph "EMF+ Object Table (Map<number, EmfPlusObject>)"
-        PB["Slot 0: plus-brush<br/>color=rgba(0,0,255,1)"]
-        PP["Slot 1: plus-pen<br/>color=#000, width=1.5"]
-        PH["Slot 3: plus-path<br/>points=[...], types=[...]"]
-        PI["Slot 5: plus-image<br/>data=ArrayBuffer, type=Bitmap"]
-        PF["Slot 6: plus-font<br/>emSize=14, family=Calibri"]
-    end
-
-    CR["CreatePen / CreateBrushIndirect /<br/>ExtCreateFontIndirectW"] --> P1
-    CR --> B1
-    CR --> F1
-    SO["SelectObject(slot)"] -.->|"Applies to state"| Canvas["Canvas Context"]
-
-    OBJ["EMFPLUS_OBJECT"] --> PB
-    OBJ --> PP
-    OBJ --> PH
-    OBJ --> PI
-    OBJ --> PF
-    DRAW["FillPath(pathId) /<br/>DrawString(fontId)"] -.->|"References by ID"| Canvas
-```
+_See the [architecture diagrams on GitHub](https://github.com/ChristopherVR/pptx-viewer/blob/main/packages/emf-converter/README.md) for visual representations._
 
 **GDI objects** are created via `EMR_CREATEPEN`, `EMR_CREATEBRUSHINDIRECT`, `EMR_EXTCREATEFONTINDIRECTW`, etc., and selected into the drawing context with `EMR_SELECTOBJECT`. Stock objects (base index `0x80000000`) provide system defaults like `WHITE_BRUSH`, `BLACK_PEN`, etc.
 
@@ -431,33 +229,7 @@ graph LR
 
 Metafiles can contain embedded bitmaps as Device-Independent Bitmaps (DIBs). The decoder pipeline handles:
 
-```mermaid
-flowchart TD
-    A["DIB Header<br/>(40+ bytes BITMAPINFOHEADER)"] --> B{Compression?}
-    B -->|BI_RGB| C["emf-dib-uncompressed.ts<br/>Decode raw pixel rows"]
-    B -->|BI_RLE8| D["emf-dib-rle-decoder.ts<br/>Run-length decode 8bpp"]
-    B -->|BI_RLE4| E["emf-dib-rle-decoder.ts<br/>Run-length decode 4bpp"]
-    B -->|BI_BITFIELDS| F["emf-dib-uncompressed.ts<br/>Custom R/G/B channel masks"]
-
-    C --> G{Bit Depth}
-    F --> G
-    G -->|1 bpp| H["Monochrome with colour table"]
-    G -->|4 bpp| I["16-colour indexed"]
-    G -->|8 bpp| J["256-colour indexed"]
-    G -->|16 bpp| K["5-5-5 or bitfield masks"]
-    G -->|24 bpp| L["B-G-R byte triplets"]
-    G -->|32 bpp| M["B-G-R-A quadruplets"]
-
-    H --> N["ImageData (RGBA pixels)"]
-    I --> N
-    J --> N
-    K --> N
-    L --> N
-    M --> N
-
-    D --> N
-    E --> N
-```
+_See the [architecture diagrams on GitHub](https://github.com/ChristopherVR/pptx-viewer/blob/main/packages/emf-converter/README.md) for visual representations._
 
 EMF+ also has its own bitmap format (`emf-plus-bitmap-decoder.ts`) supporting GDI+ pixel formats:
 
@@ -470,30 +242,7 @@ EMF+ also has its own bitmap format (`emf-plus-bitmap-decoder.ts`) supporting GD
 
 Image draws (both GDI `StretchDIBits`/`BitBlt` and EMF+ `DrawImage`/`DrawImagePoints`) that reference bitmaps or embedded metafiles are collected as **deferred images** during the synchronous replay phase. After all records are processed, these are resolved asynchronously:
 
-```mermaid
-sequenceDiagram
-    participant R as Record Replay (sync)
-    participant D as Deferred Queue
-    participant P as Post-Processor (async)
-    participant C as Canvas Context
-
-    R->>D: Push image draw {data, position, transform, isMetafile}
-    R->>D: Push image draw ...
-    R->>D: Push image draw ...
-    Note over R: EMR_EOF — replay complete
-
-    P->>D: Iterate deferred images
-    loop For each deferred image
-        alt Is embedded metafile
-            P->>P: Recursively call convertEmfToDataUrl() / convertWmfToDataUrl()
-            P->>C: drawImage(bitmap, dx, dy, dw, dh)
-        else Is raster bitmap
-            P->>P: createImageBitmap(blob)
-            P->>C: drawImage(bitmap, dx, dy, dw, dh)
-        end
-    end
-    Note over C: Canvas now has all images composited
-```
+_See the [architecture diagrams on GitHub](https://github.com/ChristopherVR/pptx-viewer/blob/main/packages/emf-converter/README.md) for visual representations._
 
 This two-phase approach is necessary because `createImageBitmap()` is asynchronous, while the GDI record replay loop is synchronous for performance.
 

package/node_modules/emf-converter/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "emf-converter",
-	"version": "1.0.0",
+	"version": "1.0.7",
 	"description": "Convert EMF/WMF metafile binaries to PNG data URLs using Canvas",
 	"keywords": [
 		"canvas",
@@ -11,9 +11,20 @@
 		"windows-metafile",
 		"wmf"
 	],
+	"homepage": "https://github.com/ChristopherVR/pptx-viewer",
+	"bugs": {
+		"url": "https://github.com/ChristopherVR/pptx-viewer/issues"
+	},
 	"license": "MIT",
+	"author": "ChristopherVR",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/ChristopherVR/pptx-viewer.git",
+		"directory": "packages/emf-converter"
+	},
 	"files": [
 		"dist/",
+		"LICENSE",
 		"README.md"
 	],
 	"main": "dist/index.js",