pptx-react-viewer 1.0.0 → 1.0.7

package/node_modules/pptx-viewer-core/README.md

@@ -194,208 +194,29 @@ const builder = handler.Builder(data);
 
 The package follows a layered architecture with clear separation of concerns:
 
-```mermaid
-flowchart TB
-    subgraph "Public API"
-        A[PptxHandler]
-        B[PptxMarkdownConverter]
-    end
-
-    subgraph "Facade Layer"
-        C[PptxHandlerCore]
-    end
-
-    subgraph "Runtime Engine"
-        D["IPptxHandlerRuntime<br/>(interface)"]
-        E["PptxHandlerRuntime<br/>(50+ mixin modules)"]
-    end
-
-    subgraph "Supporting Modules"
-        F[Types -- 22 modules]
-        G[Geometry -- 17 modules]
-        H[Colour -- 4 modules]
-        I[Services -- 21 modules]
-        J[Builders -- 11 modules]
-        K[Utils -- 32 modules]
-    end
-
-    subgraph "Converter System"
-        L[DocumentConverter base]
-        M[SlideProcessor]
-        N["Element Processors<br/>(11 types)"]
-        O[MediaContext]
-    end
-
-    A --> C
-    C --> D
-    D -.->|implemented by| E
-    E --> F
-    E --> G
-    E --> H
-    E --> I
-    E --> J
-    E --> K
-
-    B --> L
-    L --> M
-    M --> N
-    M --> O
-```
+_See the [architecture diagrams on GitHub](https://github.com/ChristopherVR/pptx-viewer/blob/main/packages/core/README.md) for visual representations._
 
 ### Module Map
 
-```mermaid
-graph TB
-    subgraph "Entry Points"
-        IDX["src/index.ts<br/>Package entry"]
-        CIDX["src/core/index.ts<br/>Core barrel"]
-        VIDX["src/converter/index.ts<br/>Converter barrel"]
-    end
-
-    subgraph "Handler Facade"
-        PH["PptxHandler.ts<br/>Public class"]
-        PHC["PptxHandlerCore.ts<br/>Facade over runtime"]
-    end
-
-    subgraph "Runtime (core/core/)"
-        RT["PptxHandlerRuntime.ts<br/>Sealed final class"]
-        RTF["PptxHandlerRuntimeFactory.ts<br/>DI factory"]
-        RTI["PptxHandlerRuntimeImplementation.ts<br/>Top of mixin chain"]
-        RTLP["...LoadPipeline.ts"]
-        RTSP["...SavePipeline.ts"]
-        RTMS["...50+ mixin modules"]
-    end
-
-    subgraph "Types (core/types/)"
-        TE["elements.ts -- PptxElement union"]
-        TT["text.ts -- TextStyle, Paragraph"]
-        TS["shape-style.ts -- ShapeStyle"]
-        TC["chart.ts -- PptxChartData"]
-        TH["theme.ts -- PptxTheme"]
-        TMORE["...17 more type modules"]
-    end
-
-    subgraph "Geometry (core/geometry/)"
-        SG["shape-geometry.ts"]
-        CG["connector-geometry.ts"]
-        GF["guide-formula.ts"]
-        PS["preset-shape-definitions.ts"]
-    end
-
-    subgraph "Services (core/services/)"
-        SL["PptxSlideLoaderService"]
-        AN["PptxNativeAnimationService"]
-        AW["PptxAnimationWriteService"]
-        TR["PptxSlideTransitionService"]
-        CP["PptxCompatibilityService"]
-    end
-
-    IDX --> CIDX
-    IDX --> VIDX
-    CIDX --> PH
-    PH --> PHC
-    PHC --> RT
-    RT --> RTI
-    RTI --> RTLP
-    RTLP --> RTSP
-    RTSP --> RTMS
-```
+_See the [architecture diagrams on GitHub](https://github.com/ChristopherVR/pptx-viewer/blob/main/packages/core/README.md) for visual representations._
 
 ### Load Pipeline
 
 When `handler.load(buffer)` is called, the following sequence occurs:
 
-```mermaid
-sequenceDiagram
-    participant C as Caller
-    participant H as PptxHandler
-    participant R as Runtime
-    participant Z as JSZip
-    participant X as fast-xml-parser
-
-    C->>H: load(arrayBuffer)
-    H->>H: detectFileFormat(buffer)
-    alt Encrypted
-        H->>H: decryptOoxml(buffer, password)
-    end
-    H->>R: load(buffer, options)
-    R->>Z: loadAsync(buffer)
-    Note over R: ZIP opened in memory
-
-    R->>R: Parse [Content_Types].xml
-    R->>R: Parse ppt/presentation.xml
-    R->>X: Parse XML -> JS objects
-
-    loop For each slide master
-        R->>R: Parse theme, colour map, layouts
-    end
-
-    loop For each slide
-        R->>R: Parse slide XML
-        R->>R: Resolve layout -> master -> theme chain
-        R->>R: Parse elements (shapes, images, charts, tables, SmartArt, OLE, 3D models, zoom)
-        R->>R: Parse text with style inheritance
-        R->>R: Parse animations & transitions
-        R->>R: Extract media relationships
-    end
-
-    R->>R: Parse comments, doc properties, embedded fonts
-    R-->>C: PptxData { slides, canvasSize, theme, masters, ... }
-```
+_See the [architecture diagrams on GitHub](https://github.com/ChristopherVR/pptx-viewer/blob/main/packages/core/README.md) for visual representations._
 
 ### Save Pipeline
 
 When `handler.save(slides)` is called:
 
-```mermaid
-sequenceDiagram
-    participant C as Caller
-    participant H as PptxHandler
-    participant R as Runtime
-    participant Z as JSZip
-
-    C->>H: save(slides, options)
-    H->>R: save(slides, options)
-
-    R->>R: Reconcile slide list (added/removed/reordered)
-    R->>R: Update ppt/presentation.xml
-
-    loop For each slide
-        R->>R: Build slide XML from element data
-        R->>R: Serialise text paragraphs + run properties
-        R->>R: Write shape styles, effects, transforms
-        R->>R: Update relationships (images, charts, media)
-        R->>R: Write animation timing trees
-        R->>R: Update slide notes
-    end
-
-    R->>R: Update [Content_Types].xml
-    R->>R: Write doc properties, comments
-    R->>R: Preserve VBA macros, custom XML parts
-    R->>Z: Generate ZIP (compression: DEFLATE)
-    R-->>C: Uint8Array (.pptx bytes)
-```
+_See the [architecture diagrams on GitHub](https://github.com/ChristopherVR/pptx-viewer/blob/main/packages/core/README.md) for visual representations._
 
 ### Runtime Mixin Composition
 
 The runtime is assembled from 50+ mixin modules using a linear inheritance chain. Each module adds a focused set of capabilities:
 
-```mermaid
-graph LR
-    A["State<br/>(base fields)"] --> B["ThemeLoading"]
-    B --> C["ThemeProcessing"]
-    C --> D["ThemeOverrides"]
-    D --> E["SlideMasters"]
-    E --> F["BackgroundParsing"]
-    F --> G["ElementParsing"]
-    G --> H["ShapeParsing"]
-    H --> I["TextParsing"]
-    I --> J["ChartParsing"]
-    J --> K["...30+ more"]
-    K --> L["SavePipeline"]
-    L --> M["LoadPipeline"]
-    M --> N["Implementation<br/>(top of chain)"]
-```
+_See the [architecture diagrams on GitHub](https://github.com/ChristopherVR/pptx-viewer/blob/main/packages/core/README.md) for visual representations._
 
 Each file exports a class named `PptxHandlerRuntime` that extends the previous module's export, adding its own methods. The final `PptxHandlerRuntimeImplementation` aggregates all functionality into the complete runtime.
 
@@ -450,43 +271,7 @@ The runtime uses **jszip** to read/write this archive and **fast-xml-parser** to
 
 The type system is organised into 22 domain-specific modules with a discriminated union pattern for elements:
 
-```mermaid
-graph TB
-    subgraph "PptxElement (discriminated union -- 16 types)"
-        direction LR
-        TX["type: 'text'"]
-        SH["type: 'shape'"]
-        CN["type: 'connector'"]
-        IM["type: 'image'"]
-        PC["type: 'picture'"]
-        TB["type: 'table'"]
-        CH["type: 'chart'"]
-        SA["type: 'smartArt'"]
-        OL["type: 'ole'"]
-        MD["type: 'media'"]
-        GR["type: 'group'"]
-        IK["type: 'ink'"]
-        CP["type: 'contentPart'"]
-        ZM["type: 'zoom'"]
-        M3["type: 'model3d'"]
-        UK["type: 'unknown'"]
-    end
-
-    subgraph "Shared Properties (PptxElementBase)"
-        ID["id, name, type"]
-        POS["x, y, width, height, rotation"]
-        STY["shapeStyle?: ShapeStyle"]
-        ACT["action?: ElementAction"]
-        ANI["animations?: PptxElementAnimation[]"]
-    end
-
-    SH --> SHARED["+ text, paragraphs, textBody, geometry"]
-    IM --> IPROPS["+ imagePath, imageData, imageEffects, crop"]
-    TB --> TPROPS["+ tableData (rows, columns, cells, styles)"]
-    CH --> CPROPS["+ chartData (type, series, axes, legend)"]
-    CN --> CNPROPS["+ connectorType, startConnection, endConnection"]
-    M3 --> MPROPS["+ modelPath, modelData, modelMimeType"]
-```
+_See the [architecture diagrams on GitHub](https://github.com/ChristopherVR/pptx-viewer/blob/main/packages/core/README.md) for visual representations._
 
 **Key type modules:**
 
@@ -515,22 +300,7 @@ graph TB
 
 PowerPoint elements inherit visual styles through a multi-level chain. The runtime resolves styles in this order:
 
-```mermaid
-flowchart TD
-    A["Element Direct Formatting<br/>(inline styles in shape XML)"] --> B{"Has property?"}
-    B -->|Yes| Z["Use element value"]
-    B -->|No| C["Placeholder on Layout<br/>(matching idx + type)"]
-    C --> D{"Has property?"}
-    D -->|Yes| Z
-    D -->|No| E["Placeholder on Master<br/>(matching idx + type)"]
-    E --> F{"Has property?"}
-    F -->|Yes| Z
-    F -->|No| G["Theme Defaults<br/>(a:objectDefaults / lstStyle)"]
-    G --> H{"Has property?"}
-    H -->|Yes| Z
-    H -->|No| I["Hardcoded Fallback<br/>(black text, no fill)"]
-    I --> Z
-```
+_See the [architecture diagrams on GitHub](https://github.com/ChristopherVR/pptx-viewer/blob/main/packages/core/README.md) for visual representations._
 
 **Theme colour references** (e.g. `accent1`, `dk1`, `lt2`) are resolved through the theme's `a:clrScheme`, optionally overridden by the slide master's `p:clrMap` and the layout's `p:clrMapOvr`.
 
@@ -576,15 +346,7 @@ The geometry module (17 files) handles shape path generation and coordinate tran
 
 The colour module (4 files) handles OOXML colour parsing and transforms:
 
-```mermaid
-flowchart LR
-    A["OOXML Colour Node<br/>(srgbClr / schemeClr /<br/>sysClr / prstClr)"] --> B["parseDrawingColor()"]
-    B --> C["Resolve base hex"]
-    C --> D{"Has transforms?"}
-    D -->|Yes| E["applyDrawingColorTransforms()<br/>lumMod, lumOff, tint, shade,<br/>satMod, alpha, hueMod, etc."]
-    D -->|No| F["Return #RRGGBB"]
-    E --> F
-```
+_See the [architecture diagrams on GitHub](https://github.com/ChristopherVR/pptx-viewer/blob/main/packages/core/README.md) for visual representations._
 
 Supported colour transform operations:
 | Transform | Effect |
@@ -602,27 +364,7 @@ Supported colour transform operations:
 
 The PPTX-to-Markdown converter uses a registry pattern for element processing:
 
-```mermaid
-flowchart TD
-    A["PptxMarkdownConverter<br/>(extends DocumentConverter)"] --> B["Parse PPTX via PptxHandler"]
-    B --> C["SlideProcessor<br/>(per-slide orchestration)"]
-    C --> D{"Element Type?"}
-
-    D -->|shape| E["TextElementProcessor"]
-    D -->|image| F["ImageElementProcessor"]
-    D -->|table| G["TableElementProcessor"]
-    D -->|chart| H["ChartElementProcessor"]
-    D -->|smartArt| I["SmartArtElementProcessor"]
-    D -->|group| J["GroupElementProcessor"]
-    D -->|media| K["MediaElementProcessor"]
-    D -->|ole| L["OleElementProcessor"]
-    D -->|ink| M["InkElementProcessor"]
-    D -->|unknown| N["FallbackElementProcessor"]
-
-    E --> O["Markdown Output"]
-    F --> O
-    G --> O
-```
+_See the [architecture diagrams on GitHub](https://github.com/ChristopherVR/pptx-viewer/blob/main/packages/core/README.md) for visual representations._
 
 The converter supports two output modes:
 

package/node_modules/pptx-viewer-core/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pptx-viewer-core",
-	"version": "1.0.0",
+	"version": "1.0.7",
 	"description": "Core PPTX engine — parse, edit, serialize, and convert PowerPoint files.",
 	"keywords": [
 		"converter",
@@ -11,12 +11,24 @@
 		"pptx",
 		"sdk"
 	],
+	"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/core"
+	},
 	"bin": {
 		"pptx": "./dist/cli/index.mjs"
 	},
 	"files": [
 		"dist/",
+		"LICENSE",
+		"NOTICE",
 		"README.md"
 	],
 	"main": "dist/index.mjs",

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pptx-react-viewer",
-	"version": "1.0.0",
+	"version": "1.0.7",
 	"description": "React-based PowerPoint viewer, editor, and canvas export — depends on pptx-viewer-core",
 	"keywords": [
 		"editor",
@@ -11,9 +11,21 @@
 		"react",
 		"viewer"
 	],
+	"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/react"
+	},
 	"files": [
 		"dist/",
+		"LICENSE",
+		"NOTICE",
 		"README.md"
 	],
 	"main": "dist/index.mjs",
@@ -45,10 +57,10 @@
 	},
 	"dependencies": {
 		"clsx": "^2.1.1",
-		"emf-converter": "^1.0.0",
+		"emf-converter": "^1.0.7",
 		"html2canvas-pro": "^2.0.2",
-		"mtx-decompressor": "^1.0.0",
-		"pptx-viewer-core": "^1.0.0",
+		"mtx-decompressor": "^1.0.7",
+		"pptx-viewer-core": "^1.0.7",
 		"tailwind-merge": "^3.5.0"
 	},
 	"devDependencies": {