pptx-react-viewer 1.0.0 → 1.0.8

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.8",
 	"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",